commande .create ingestion mapping
S’applique à : ✅Microsoft Fabric✅Azure Data Explorer
Crée un mappage d’ingestion qui peut être associé à un format spécifique et à une table ou une base de données spécifique.
Si un mappage portant le même nom dans l’étendue donnée existe déjà, .create échoue. Utilisez .create-or-alter à la place.
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
.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson
.createdatabase 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.
Exemples
Créer une table et une base de données avec un mappage d’ingestion CSV
L’exemple suivant crée une table, MyTable avec le mappage Mapping1 d’ingestion CSV et une base de données, MyDatabase avec le mappage Mapping2d’ingestion CSV.
.create table MyTable ingestion csv mapping "Mapping1"
'['
' { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
' { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'
.create database MyDatabase ingestion csv mapping "Mapping2"
'['
' { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
' { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'
Sortie
| Nom | Genre | Mappage | Base de données | Table |
|---|---|---|---|---|
| mappage1 | CSV | [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] |
MyDatabase | MyTable |
| mappage2 | CSV | [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] |
MyDatabase |
Créer un mappage d’ingestion avec des caractères d’échappement
L’exemple suivant crée une table, test_table avec le mappage test_mapping_named’ingestion JSON. Pour éviter les erreurs, les barres obliques inverses sont utilisées pour échapper des guillemets simples dans les chaînes de chemin JSON.
.create table test_table ingestion json mapping "test_mapping_name"
'['
'{"column":"timeStamp","path":"$[\'timeStamp\']","datatype":"","transform":null},{"column":"name","path":"$[\'name\']","datatype":"","transform":null},{"column":"x-opt-partition-key","path":"$[\'x-opt-partition-key\']","datatype":"","transform":null}'
']'
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.
- Pour en savoir plus sur le mappage JSON en tant que source d’ingestion, consultez mappage JSON