Partager via

commande .alter ingestion mapping

  • Article

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}]