.create-or-alter betöltési leképezési parancs

Létrehoz vagy módosít 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 a betöltési leképezés nem létezik, a parancs létrehozza. Ha a betöltési leképezés már létezik, a parancs módosítja.

Megjegyzés

A forrástáblában nem található betöltési leképezésben bevezetett új oszlopok az adott oszlop kezdeti adatbetöltése során lesznek hozzáadva a táblához. Ez a viselkedés csak az üzenetsoros betöltéshez támogatott, és az oszlop érvényes adattípusának megadásától függ.

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

.create-or-altertableTableNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.create-or-alterdatabaseDatabaseNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

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élda

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

.create-or-alter table MyTable ingestion json mapping "Mapping1"
'['
'    { "column" : "rownumber", "datatype" : "int", "Properties":{"Path":"$.rownumber"}},'
'    { "column" : "rowguid", "Properties":{"Path":"$.rowguid"}}'
']'

Kimenet

Name	Altípus	Társítás	Adatbázis	Tábla
leképezés1	JSON	[{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}]	MyDatabase	MyTable

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.