.create ingestion mapping command

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 akan 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

.createtableTableNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

.createdatabaseDatabaseNameingestionMappingKindmappingMappingNameMappingFormattedAsJson

Pelajari selengkapnya tentang konvensi sintaksis.

Parameter

Nama	Jenis	Diperlukan	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.
MappingFormattedAsJson	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 database MyDatabase ingestion csv mapping "Mapping2"
'['
'   { "column" : "rownumber", "DataType":"int", "Properties":{"Ordinal":"0"}},'
'   { "column" : "rowguid", "DataType":"string", "Properties":{"Ordinal":"1"}}'
']'

Output

Nama	Jenis	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

Contoh: .buat pemetaan penyerapan dengan karakter escape

.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 penjelasan detail mengenai berbagai format pemetaan penyerapan seperti CSV, JSON, Avro, Parquet, dan Orc, lihat Pemetaan data.