commande .alter ingestion mapping

S’applique à : ✅Microsoft Fabric✅Azure Data Explorer

Modifie un mappage d’ingestion existant associé à une table/base de données spécifique et un format spécifique (remplacement complet du mappage).

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

La commande permettant de modifier le mappage d’ingestion de base de données nécessite au moins des autorisations d’ingestion de base de données, et la commande permettant de modifier le mappage d’ingestion de table nécessite au moins des autorisations d’ingestion de table.

Syntaxe

.altertable TableName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

.alterdatabase DatabaseName MappingKind mapping MappingName ingestion ArrayOfMappingObjects

Remarque

Ce mappage peut être référencé par son nom par des commandes d’ingestion, au lieu de spécifier le mappage complet dans le cadre de la commande.

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.
ArrayOfMappingObjects	string	✔️	Tableau sérialisé avec un ou plusieurs objets de mappage définis.

Exemples

.alter table MyTable ingestion csv mapping "Mapping1"
```
[
    {"column" : "rownumber", "DataType" : "int", "Properties" : {"Ordinal":"0"} },
    { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"} }
]
```

.alter table MyTable ingestion json mapping "Mapping1"
```
[
    { "column" : "rownumber", "DataType" : "int", "Properties":{"Path":"$.rownumber"}},
    { "column" : "rowguid", "DataType":"string", "Properties":{"Path":"$.rowguid"}}
]
```

.alter database MyDatabase ingestion csv mapping "Mapping2"
```
[
    { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},
    { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"} }
]
```

Sortie

Nom	Genre	Mappage
mappage1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]
mappage2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]