commande .create-or-alter ingestion mapping
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Crée ou modifie un mappage d’ingestion qui peut être associé à un format spécifique et à une table ou une base de données spécifique.
Si le mappage d’ingestion n’existe pas, la commande la crée. Si le mappage d’ingestion existe déjà, la commande la modifie.
Remarque
Les nouvelles colonnes introduites dans un mappage d’ingestion, qui ne sont pas présentes dans la table source, seront ajoutées à la table pendant l’ingestion initiale des données pour cette colonne. Ce comportement est uniquement pris en charge pour l’ingestion en file d’attente et dépend de la spécification d’un type de données valide pour la colonne.
autorisations
Au moins les autorisations d’ingestion de base de données sont requises pour créer un mappage d’ingestion de base de données, et au moins les autorisations d’ingestion de table sont requises pour créer un mappage d’ingestion de table.
Syntaxe
.create-or-altertable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson
.create-or-alterdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson
En savoir plus sur les conventions de syntaxe.
Paramètres
| Nom | Type | Requise | Description |
|---|---|---|---|
| TableName | string |
✔️ | Nom de la table. |
| DatabaseName | string |
✔️ | Nom de la base de données. |
| MappingKind | string |
✔️ | Type de mappage. Les valeurs acceptables sont : CSV, JSON, avro, parquet et orc. |
| MappingName | string |
✔️ | Le nom du mappage. |
| MappingFormattedAsJson | string |
✔️ | Définition de mappage d’ingestion mise en forme sous forme de valeur JSON. |
Remarque
- Une fois créé, le mappage peut être référencé par ses commandes d’ingestion de nom, au lieu de spécifier le mappage complet dans le cadre de la commande.
- Si un mappage portant le même nom est créé à la fois dans l’étendue de la table et dans l’étendue de la base de données, le mappage dans l’étendue de la table aura une priorité plus élevée.
- Lors de l’ingestion dans une table et du référencement d’un mappage dont le schéma ne correspond pas au schéma de table ingéré, l’opération d’ingestion échoue.
Exemple
.create table MyTable ingestion csv mapping "Mapping1"
'['
' { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
' { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'
.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
' { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
' { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'
Sortie
| Nom | Genre | Mappage | Base de données | Table |
|---|---|---|---|---|
| mappage1 | JSON | [{"Properties » :{"Path » :"$.rownumber"},"column » :"rownumber »,"datatype » :"int"},{"Properties » :{"Path » :"$.rowguid"},"column » :"rowguid »,"datatype » :""}] | MyDatabase | MyTable |
Contenu connexe
- Pour obtenir des descriptions détaillées de différents formats de mappage d’ingestion tels que CSV, JSON, Avro, Parquet et Orc, consultez Mappages de données.