Perintah pemetaan penyerapan .create-or-alter

Beralih layanan menggunakan daftar drop-down Versi . Pelajari selengkapnya tentang navigasi.
Berlaku untuk: ✅ Microsoft Fabric ✅ Azure Data Explorer

Membuat atau mengubah pemetaan penyerapan yang dapat dikaitkan dengan format tertentu dan tabel atau database tertentu.

Jika pemetaan penyerapan tidak ada, perintah akan membuatnya. Jika pemetaan penyerapan sudah ada, perintah akan mengubahnya.

Catatan

Kolom baru yang diperkenalkan dalam pemetaan penyerapan, yang tidak ada dalam tabel sumber, akan ditambahkan ke tabel selama penyerapan data awal untuk kolom tersebut. Perilaku ini hanya didukung untuk penyerapan antrean dan merupakan kontingen dalam menentukan jenis data yang valid untuk kolom.

Izin

Setidaknya izin Database Ingestor diperlukan untuk membuat pemetaan penyerapan database, dan setidaknya izin Ingestor Tabel diperlukan untuk membuat pemetaan penyerapan tabel.

Sintaks

.create-or-alter table TableNameingestion MappingKindmappingMappingNameMappingFormattedAsJson

.create-or-alter database DatabaseNameingestion MappingKindmappingMappingNameMappingFormattedAsJson

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama	Tipe	Wajib	Deskripsi
TableName	string	✔️	Nama tabel.
DatabaseName	string	✔️	Nama database.
MappingKind	string	✔️	Jenis pemetaan. Nilai yang valid adalah CSV, JSON, avro, parquet, dan orc.
MappingName	string	✔️	Nama pemetaan.
PemetaanFormattedAsJson	string	✔️	Definisi pemetaan penyerapan yang diformat sebagai nilai JSON.

Catatan

• Begitu dibuat, pemetaan tersebut dapat direferensikan berdasarkan namanya di perintah penyerapan, bukan menentukan pemetaan lengkap sebagai bagian dari perintah tersebut.
• Jika pemetaan dengan nama yang sama dibuat di cakupan tabel dan cakupan database, pemetaan dalam cakupan tabel akan memiliki prioritas yang lebih tinggi.
• Saat menyerap ke dalam tabel dan mereferensikan pemetaan yang skemanya tidak cocok dengan skema tabel yang diserap, operasi penyerapan akan gagal.

Contoh

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

Hasil

Nama	Kind	Pemetaan	Database	Tabel
mapping1	JSON	[{"Properties":{"Path":"$.rownumber"},"column":"rownumber","datatype":"int"},{"Properties":{"Path":"$.rowguid"},"column":"rowguid","datatype":""}]	MyDatabase	MyTable

Konten terkait

• Untuk penjelasan detail mengenai berbagai format pemetaan penyerapan seperti CSV, JSON, Avro, Parquet, dan Orc, lihat Pemetaan data.