commande .create ingestion mapping

Crée un mappage d’ingestion qui peut être associé à un format spécifique et à une table ou 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 des 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 des autorisations d’ingestion de table sont requises pour créer un mappage d’ingestion de table.

Syntax

.createtableTablenameingestionMappingKindmappingMappageNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappageNameMappingFormattedAsJson

Découvrez les conventions de syntaxe.

Paramètres

Nom	Type	Obligatoire	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.
MappageName	string	✔️	Nom du mappage.
MappingFormattedAsJson	string	✔️	Définition de mappage d’ingestion mise en forme sous forme de valeur JSON.

Notes

• Une fois créé, le mappage peut être référencé par son nom dans les commandes d’ingestion, 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

.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 de charge de travail
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

Exemple : mappage d’ingestion .create avec des caractères d’échappement

.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 des différents formats de mappage d’ingestion tels que CSV, JSON, Avro, Parquet et Orc, consultez Mappages de données.