.create ingestion mapping command

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

Verilen kapsamda aynı ada sahip bir eşleme zaten varsa, .create başarısız olur. Bunun yerine .create-or-alter kullanın.

İ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

.createtableTablenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabasenameingestionMappingKindmappingMappingNameMappingFormattedAsJson

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.

Örnekler

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

Çıkış

Name Tip Eşleme Veritabanı Tablo
eşleme1 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] Veritabanım Mytable
eşleme2 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] Veritabanım

Örnek: Kaçış karakterleriyle .create alma eşlemesi

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