Perintah pemetaan penyerapan .create

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

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

Jika pemetaan dengan nama yang sama dalam cakupan yang diberikan sudah ada, .create gagal. Gunakan .create-or-alter sebagai gantinya.

Izin

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

Sintaks

.create table TableNameingestion MappingKindmappingMappingNameMappingFormattedAsJson

.create 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 dalam 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

Membuat tabel dan database dengan pemetaan penyerapan CSV

Contoh berikut membuat tabel, MyTable dengan pemetaan Mapping1 penyerapan CSV dan database, MyDatabase dengan pemetaan Mapping2penyerapan CSV .

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

Hasil

Nama	Kind	Pemetaan	Database	Tabel
mapping1	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase	MyTable
mapping2	CSV	[{"Name":"rownumber","DataType":"int","CsvDataType":null,"Ordinal":0,"ConstValue":null},{"Name":"rowguid","DataType":"string","CsvDataType":null,"Ordinal":1,"ConstValue":null}]	MyDatabase

Membuat pemetaan penyerapan dengan karakter escape

Contoh berikut membuat tabel, test_table dengan pemetaan test_mapping_namepenyerapan JSON . Untuk menghindari kesalahan, garis miring terbelakang digunakan untuk menghindari tanda kutip tunggal dalam string jalur JSON.

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

Konten terkait

• Untuk deskripsi terperinci tentang berbagai format pemetaan penyerapan, seperti CSV, JSON, Avro, Parquet, dan Orc, lihat Pemetaan data.
• Untuk mempelajari selengkapnya tentang pemetaan JSON sebagai sumber penyerapan, lihat Pemetaan JSON