Bagikan melalui

Properti penyerapan data

  • Artikel

Berlaku untuk: ✅Microsoft Fabric✅Azure Data Explorer

Penyerapan data adalah proses di mana data ditambahkan ke tabel dan tersedia untuk kueri. Anda menambahkan properti ke perintah penyerapan setelah kata kunci with.

Properti penyerapan

Penting

Dalam data penyerapan antrean di-batch menggunakan properti Penyerapan. Semakin berbeda properti pemetaan penyerapan yang digunakan, seperti nilai ConstValue yang berbeda, semakin terfragmentasi penyerapannya, yang dapat menyebabkan penurunan performa.

Tabel berikut ini mencantumkan dan menjelaskan properti yang didukung, dan menyediakan contoh:

Properti Deskripsi Contoh
ingestionMapping Nilai string yang menunjukkan cara memetakan data dari file sumber ke kolom aktual dalam tabel. Tentukan nilai format dengan jenis pemetaan yang relevan. Lihat pemetaan data. with (format="json", ingestionMapping = "[{\"column\":\"rownumber\", \"Properties\":{\"Path\":\"$.RowNumber\"}}, {\"column\":\"rowguid\", \"Properties\":{\"Path\":\"$.RowGuid\"}}]")
(tidak digunakan lagi: avroMapping, csvMapping, jsonMapping)
ingestionMappingReference Nilai string yang menunjukkan cara memetakan data dari file sumber ke kolom aktual dalam tabel menggunakan objek kebijakan pemetaan yang diberi nama. Tentukan nilai format dengan jenis pemetaan yang relevan. Lihat pemetaan data. with (format="csv", ingestionMappingReference = "Mapping1")
(tidak digunakan lagi: avroMappingReference, csvMappingReference, jsonMappingReference)
creationTime Nilai tanggalwaktu (diformat sebagai string ISO8601) untuk digunakan pada saat pembuatan jangkauan data yang diserap. Jika tidak ditentukan, nilai saat ini (now()) digunakan. Mengambil alih default berguna saat menyerap data yang lebih lama, sehingga kebijakan penyimpanan diterapkan dengan benar. Ketika ditentukan, pastikan properti Lookback dalam Kebijakan penggabungan jangkauan efektif milik tabel target selaras dengan nilai yang ditentukan. with (creationTime="2017-02-13")
extend_schema Nilai Boolean yang, jika ditentukan, menginstruksikan perintah untuk memperpanjang skema tabel (defaults ke false). Opsi ini hanya berlaku untuk perintah .append dan .set-or-append. Satu-satunya ekstensi skema yang diizinkan memiliki lebih banyak kolom yang ditambahkan ke tabel di akhir. Jika skema tabel asli adalah (a:string, b:int), ekstensi skema yang valid akan menjadi (a:string, b:int, c:datetime, d:string), tetapi (a:string, c:datetime) tidak akan valid
folder Untuk perintah ingest-from-query, folder ditetapkan ke tabel. Jika tabel sudah ada, properti ini akan mengambil alih folder tabel. with (folder="Tables/Temporary")
format Format data (lihat format data yang didukung). with (format="csv")
ingestIfNotExists Nilai string yang, jika ditentukan, mencegah penyerapan berhasil jika tabel sudah memiliki data yang ditandai dengan tag ingest-by: dengan nilai yang sama. Ini memastikan penyerapan data tidak dapat diubah. Untuk informasi selengkapnya, lihat ingest-by: tag. Properti with (ingestIfNotExists='["Part0001"]', tags='["ingest-by:Part0001"]') menunjukkan bahwa jika data dengan tag ingest-by:Part0001 telah ada, maka jangan menyelesaikan penyerapan saat ini. Jika belum ada, penyerapan baru ini harus memiliki set tag ini (jika penyerapan di masa depan mencoba untuk menyerap data yang sama lagi.)
ignoreFirstRecord Nilai Boolean yang, jika diatur ke true, menunjukkan bahwa penyerapan harus mengabaikan baris pertama setiap file. Properti ini berguna untuk file dalam CSV dan format serupa, jika baris pertama dalam file adalah nama kolom. Secara default, false diasumsikan. with (ignoreFirstRecord=false)
policy_ingestiontime Nilai Boolean yang, jika ditentukan, menjelaskan apakah akan mengaktifkan Kebijakan Waktu Penyerapan pada tabel yang dibuat oleh perintah ini. Default adalah true. with (policy_ingestiontime=false)
recreate_schema Nilai Boolean yang, jika ditentukan, menjelaskan apakah perintah dapat membuat ulang skema tabel. Properti ini hanya berlaku untuk perintah .set-or-replace. Properti ini lebih diutamakan daripada properti extend_schema jika keduanya ditetapkan. with (recreate_schema=true)
tags Daftar tag untuk dikaitkan dengan data yang terserap, diformat sebagai string JSON with (tags="['Tag1', 'Tag2']")
TreatGzAsUncompressed Nilai Boolean yang, jika diatur ke true, menunjukkan bahwa file dengan ekstensi .gz tidak dikompresi. Bendera ini terkadang diperlukan saat menyerap dari Amazon AWS S3. with (treatGzAsUncompressed=true)
validationPolicy String JSON yang menunjukkan validasi mana yang akan dijalankan selama penyerapan data yang diwakili menggunakan format CSV. Lihat Penyerapan data untuk penjelasan tentang berbagai opsi. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (ini adalah kebijakan default)
zipPattern Gunakan properti ini saat menyerap data dari penyimpanan yang memiliki arsip ZIP. Ini adalah nilai string yang menunjukkan ekspresi reguler untuk digunakan saat memilih file mana dalam arsip ZIP yang akan diserap. Semua file lain dalam arsip diabaikan. with (zipPattern="*.csv")

Konten terkait