İngilizce dilinde oku

Aracılığıyla paylaş

.create ingestion mapping command

  • Makale

Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure Veri Gezgini

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 alımı eşlemesi oluşturmak için en azından Tablo Alma izni gerekir.

Sözdizimi

.createtable TableName ingestion MappingKind mapping MappingName MappingFormattedAsJson

.createdatabase DatabaseName ingestion MappingKind mapping MappingName MappingFormattedAsJson

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

Parametreler

Ad Tür Zorunlu Açıklama
TableName string ✔️ Tablonun adı.
DatabaseName string ✔️ Veritabanının adı.
MappingKind string ✔️ Eşleme türü. Geçerli değerler : csv, json, avro, parquetve orc.
MappingName string ✔️ Eşlemenin adı.
MappingFormattedAsJson string ✔️ JSON değeri olarak biçimlendirilmiş alma eşleme tanımı.

Not

  • Oluşturulduktan sonra, eşlemeye komutun bir parçası olarak eşlemenin tamamını 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 alınırken ve şeması alınan tablo şemasıyla eşleşmeyen bir eşlemeye başvururken alma işlemi başarısız olur.

Örnekler

CSV alımı eşlemesi ile tablo ve veritabanı oluşturma

Aşağıdaki örnek, MyTable CSV alma eşlemesi ve CSV alma eşlemesi Mapping1 olan bir veritabanı MyDatabase içeren Mapping2bir tablo oluşturur.

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

Çıktı

Veri Akışı Adı 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}] MyDatabase Tablom
eşleme2 CSV [{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}] MyDatabase

Kaçış karakterleriyle alma eşlemesi oluşturma

Aşağıdaki örnek, test_table JSON alımı eşlemesi test_mapping_nameile bir tablo oluşturur. Hataları önlemek için JSON yol dizelerindeki tek tırnak işaretinden kaçınmak için ters eğik çizgi kullanılır.

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

İ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.
  • Alma kaynağı olarak JSON eşlemesi hakkında daha fazla bilgi edinmek için bkz. JSON eşlemesi