Partager via

Propriétés d’ingestion des données Azure Synapse Data Explorer (préversion)

Important

Azure Synapse Analytics Data Explorer (version préliminaire) sera retiré le 7 octobre 2025. Après cette date, les charges de travail exécutées sur Synapse Data Explorer seront supprimées et les données d’application associées seront perdues. Nous vous recommandons vivement de migrer vers Eventhouse dans Microsoft Fabric.

Le programme Microsoft Cloud Migration Factory (CMF) est conçu pour aider les clients à migrer vers Fabric. Le programme offre des ressources clavier pratiques sans coût pour le client. Ces ressources sont affectées pendant une période de 6 à 8 semaines, avec une étendue prédéfinie et acceptée. Les nominations des clients sont acceptées par l’équipe de compte Microsoft ou directement en envoyant une demande d’aide à l’équipe CMF.

L’ingestion des données est le processus par lequel les données sont ajoutées à une table et sont disponibles pour la requête dans l’Explorateur de données. Vous ajoutez des propriétés à la commande d’ingestion après le with mot clé.

Propriétés d’ingestion

Le tableau suivant répertorie les propriétés prises en charge par l’Explorateur de données, les décrit et fournit des exemples :

Propriété Descriptif Example
ingestionMapping Valeur de chaîne qui indique comment mapper les données du fichier source aux colonnes réelles de la table. Définissez la format valeur avec le type de mappage approprié. Consultez Mappages de données. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(déconseillé : avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Valeur de chaîne qui indique comment mapper les données du fichier source aux colonnes réelles de la table à l’aide d’un objet de stratégie de mappage nommé. Définissez la format valeur avec le type de mappage approprié. Consultez Mappages de données. with (format="csv", ingestionMappingReference = "Mapping1")
(déconseillé : avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Valeur datetime (mise en forme sous forme de chaîne ISO8601) à utiliser au moment de la création des étendues de données ingérées. Si elle n’est pas spécifiée, la valeur actuelle (now()) est utilisée. La substitution de la valeur par défaut est utile lors de l’ingestion de données plus anciennes, afin que la stratégie de rétention soit appliquée correctement. Lorsqu'elle est spécifiée, vérifiez que la propriété Lookback dans la stratégie effective de fusion Extents de la table cible soit alignée sur la valeur spécifiée. with (creationTime="2017-02-13")
extend_schema Valeur booléenne qui, si elle est spécifiée, indique à la commande d’étendre le schéma de la table (valeur par défaut false). Cette option s'applique uniquement aux commandes .append et .set-or-append. Les seules extensions de schéma autorisées ont des colonnes supplémentaires ajoutées à la table à la fin. Si le schéma de table d’origine est (a:string, b:int), une extension de schéma valide serait (a:string, b:int, c:datetime, d:string), mais (a:string, c:datetime) ne serait pas valide
folder Pour les commandes d’ingestion à partir de la requête , le dossier à affecter à la table. Si la table existe déjà, cette propriété remplace le dossier de la table. with (folder="Tables/Temporary")
format Format de données (voir formats de données pris en charge). with (format="csv")
ingestIfNotExists Une valeur de chaîne de caractères qui, si elle est spécifiée, empêche la réussite de l'ingestion si la table a déjà des données marquées avec un tag de valeur ingest-by: identique. Cela garantit que l'ingestion des données soit idempotente. Pour plus d’informations, consultez ingestion par : balises. Les propriétés with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') indiquent que si des données avec la balise ingest-by:Part0001 existent déjà, ne terminez pas l’ingestion actuelle. S'il n'existe pas encore, cette nouvelle ingestion doit avoir ce tag (au cas où une ingestion future tenterait de réingérer les mêmes données).
ignoreFirstRecord Valeur booléenne qui, si elle est définie sur true, indique que l’ingestion devrait ignorer le premier enregistrement de chaque fichier. Cette propriété est utile pour les fichiers dans CSVet les formats similaires, si le premier enregistrement du fichier est le nom des colonnes. Par défaut, false est supposé. with (ignoreFirstRecord=false)
persistDetails Valeur booléenne qui, si elle est spécifiée, indique que la commande doit conserver les résultats détaillés (même en cas de réussite) afin que la commande .show operation details puisse les récupérer. La valeur par défaut est false. with (persistDetails=true)
policy_ingestiontime Valeur booléenne qui, si elle est spécifiée, décrit s’il faut activer la stratégie de temps d’ingestion sur une table créée par cette commande. La valeur par défaut est true. with (policy_ingestiontime=false)
recreate_schema Valeur booléenne qui, si elle est spécifiée, décrit si la commande peut recréer le schéma de la table. Cette propriété s’applique uniquement à la .set-or-replace commande. Cette propriété est prioritaire sur la extend_schema propriété si les deux sont définies. with (recreate_schema=true)
tags Liste des balises à associer aux données ingérées, mises en forme sous forme de chaîne JSON with (tags="['Tag1', 'Tag2']")
validationPolicy Chaîne JSON qui indique les validations à exécuter pendant l’ingestion. Consultez l’ingestion des données pour obtenir une explication des différentes options. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (il s’agit en fait de la stratégie par défaut)
zipPattern Utilisez cette propriété lors de l’ingestion de données à partir du stockage qui a une archive ZIP. Il s’agit d’une valeur de chaîne indiquant l’expression régulière à utiliser lors de la sélection des fichiers dans l’archive ZIP à ingérer. Tous les autres fichiers de l’archive seront ignorés. with (zipPattern="*.csv")

Étapes suivantes

  • Last updated on