.create-or-alter alma eşleme komutu

Belirli bir biçim ve belirli bir tablo veya veritabanıyla ilişkilendirilebilen bir alma eşlemesi oluşturur veya değiştirir.

Alma eşlemesi yoksa, komut bunu oluşturur. Alma eşlemesi zaten varsa, komut bunu değiştirir.

Not

Bir alma eşlemesinde kullanıma sunulan ve kaynak tabloda bulunmayan yeni sütunlar, bu sütunun ilk veri alımı sırasında tabloya eklenir. Bu davranış yalnızca kuyruğa alınmış alım için desteklenir ve sütun için geçerli bir veri türü belirtmeye bağlıdır.

İzinler

Veritabanı alma eşlemesi oluşturmak için en azından Veritabanı Alma izni gerekir ve tablo alma eşlemesi oluşturmak için en azından Tablo Alma izni gerekir.

Syntax

.create-or-altertableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.create-or-alterdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

Söz dizimi kuralları hakkında daha fazla bilgi edinin.

Parametreler

Ad	Tür	Gerekli	Açıklama
TableName	string	✔️	Tablonun adı.
Databasename	string	✔️	Veritabanının adı.
MappingKind	string	✔️	Eşleme türü. Geçerli değerler , , JSONavro, parquetve orcdeğerleridirCSV.
Mappingname	string	✔️	Eşlemenin adı.
MappingFormattedAsJson	string	✔️	JSON değeri olarak biçimlendirilmiş alma eşlemesi tanımı.

Not

• Oluşturulduktan sonra, eşlemeye komutun bir parçası olarak tam eşleme belirtmek yerine alma komutlarında adıyla başvurulabilir.
• Hem tablo kapsamında hem de veritabanı kapsamında aynı ada sahip bir eşleme oluşturulursa, tablo kapsamındaki eşleme daha yüksek önceliğe sahip olur.
• Bir tabloya alma ve şeması alınan tablo şemasıyla eşleşmeyen bir eşlemeye başvururken alma işlemi başarısız olur.

Örnek

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

Çıkış

Name	Tip	Eşleme	Veritabanı	Tablo
eşleme1	JSON	[{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}]	Veritabanım	Mytable

İlgili içerik

• CSV, JSON, Avro, Parquet ve Orc gibi çeşitli alım eşleme biçimlerinin ayrıntılı açıklamaları için bkz. Veri eşlemeleri.