Properti penyerapan data Azure Synapse Data Explorer (Pratinjau)

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

Properti penyerapan

Tabel berikut mencantumkan properti yang didukung oleh Data Explorer, menjelaskannya, dan memberikan 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()) akan digunakan. Mengesampingkan default berguna saat menyerap data yang lebih lama, sehingga kebijakan retensi akan 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 kolom tambahan 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 menimpa 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)
persistDetails Nilai Boolean yang, jika ditentukan, menunjukkan bahwa perintah harus mempertahankan hasil detail (bahkan jika berhasil) sehingga perintah detail operasi .show dapat mengambilnya. Default ke false. with (persistDetails=true)
policy_ingestiontime Nilai Boolean yang, jika ditentukan, menjelaskan apakah akan mengaktifkan Kebijakan Waktu Penyerapan pada tabel yang dibuat oleh perintah ini. Defaultnya 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']")
validationPolicy String JSON yang menunjukkan validasi mana yang akan dijalankan selama penyerapan. Lihat Penyerapan data untuk penjelasan tentang berbagai opsi. with (validationPolicy='{"ValidationOptions":1, "ValidationImplications":1}') (ini sebenarnya 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 akan diabaikan. with (zipPattern="*.csv")

Langkah berikutnya