.create ingestion mapping command

Létrehoz egy betöltési leképezést, amely egy adott formátumhoz és egy adott táblához vagy adatbázishoz társítható.

Ha az adott hatókörben már létezik egy azonos nevű leképezés, .create a művelet sikertelen lesz. A .create-or-alter használható helyette.

Engedélyek

Az adatbázis-betöltési leképezés létrehozásához legalább adatbázis-betöltési engedélyekre van szükség, és legalább Táblabetöltési engedélyekre van szükség a táblabetöltési leképezés létrehozásához.

Syntax

.createtableTableNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabaseNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

További információ a szintaxis konvenciókról.

Paraméterek

Név	Típus	Kötelező	Leírás
TableName	string	✔️	A tábla neve.
DatabaseName	string	✔️	Az adatbázis neve.
MappingKind	string	✔️	A leképezés típusa. Az érvényes értékek a következők: csv, json, avro, parquetés orc.
MappingName	string	✔️	A leképezés neve.
MappingFormattedAsJson	string	✔️	A betöltési leképezés definíciója JSON-értékként van formázva.

Megjegyzés

• A létrehozás után a leképezés a neve alapján hivatkozhat a betöltési parancsokban, ahelyett, hogy a teljes leképezést a parancs részeként adja meg.
• Ha a tábla hatókörében és az adatbázis-hatókörben is létrejön egy azonos nevű leképezés, a tábla hatókörében lévő leképezés magasabb prioritással fog rendelkezni.
• Ha egy táblába való betöltéskor olyan leképezésre hivatkozik, amelynek sémája nem egyezik meg az betöltött táblasémával, a betöltési művelet sikertelen lesz.

Példák

.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"}}'
']'

Kimenet

Name	Altípus	Társítás	Adatbázis	Tábla
leképezés1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase	MyTable
leképezés2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase

Példa: .create ingestion mapping with escape characters

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

Kapcsolódó tartalom

• A különböző betöltési leképezési formátumok, például CSV, JSON, Avro, Parquet és Orc részletes leírását lásd: Adatleképezések.