Tag tingkat

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

Tag ekstensi adalah string yang menjelaskan properti umum untuk semua data dalam jangkauan. Misalnya, selama penyerapan data, Anda dapat menambahkan tag ekstensi untuk menandakan sumber data yang diserap. Kemudian, Anda dapat menggunakan tag ini untuk analisis.

Jangkauan dapat menyimpan beberapa tag sebagai bagian dari metadatanya. Saat jangkauan digabungkan, tag mereka juga bergabung, memastikan representasi metadata yang konsisten.

Untuk melihat tag yang terkait dengan jangkauan, gunakan perintah .show extents . Untuk tampilan terperinci tag yang terkait dengan rekaman dalam jangkauan, gunakan fungsi extent-tags().

Penting

Tag dimulai dengan drop-by: atau ingest-by: membawa arti tertentu. Untuk informasi selengkapnya, lihat tag drop-by extent dan tag ingest-by extent.

drop-by tag tingkat

Tag yang dimulai dengan prefiks drop-by: dapat digunakan untuk mengontrol jangkauan lain yang akan digabungkan. Tingkatan yang memiliki set drop-by: tag yang sama dapat digabungkan bersama-sama, tetapi tidak akan digabungkan dengan tingkat lain jika memiliki sekumpulan drop-by: tag yang berbeda.

Catatan

  • Hindari penggunaan tag yang drop-by berlebihan.
  • Tag ini tidak boleh digunakan untuk mengganti data tingkat rekaman individual, dan paling efektif saat diterapkan ke data dalam jumlah besar.
  • Menetapkan tag unik drop-by ke rekaman atau file individual dapat berdampak signifikan pada performa.

Contoh

Menentukan tingkat mana yang dapat digabungkan bersama-sama

Jika:

  • Jangkauan 1 memiliki tag berikut: drop-by:blue, drop-by:red, green.
  • Jangkauan 2 memiliki tag berikut: drop-by:red, yellow.
  • Jangkauan 3 memiliki tag berikut: purple, drop-by:red, drop-by:blue.

lalu:

  • Jangkauan 1 dan 2 tidak akan digabungkan, karena memiliki kumpulan tag drop-by yang berbeda.
  • Jangkauan 2 dan 3 tidak akan digabungkan, karena memiliki kumpulan tag drop-by yang berbeda.
  • Jangkauan 1 dan 3 dapat digabungkan, karena memiliki kumpulan tag drop-by yang sama.

Menggunakan drop-by tag sebagai bagian dari operasi tingkat luas

Kueri berikut mengeluarkan perintah untuk menghilangkan tingkat sesuai dengan tag mereka drop-by: .

.ingest ... with @'{"tags":"[\"drop-by:2016-02-17\"]"}'

.drop extents <| .show table MyTable extents where tags has "drop-by:2016-02-17"

ingest-by tag tingkat

Tag dengan awalan ingest-by: dapat digunakan bersama dengan ingestIfNotExists properti untuk memastikan bahwa data hanya diserap sekali.

Properti ingestIfNotExists mencegah penyerapan duplikat dengan memeriksa apakah jangkauan dengan tag yang ditentukan ingest-by: sudah ada. Biasanya, perintah penyerapan berisi ingest-by: tag dan ingestIfNotExists properti dengan nilai yang sama.

Catatan

  • Hindari penggunaan tag yang ingest-by berlebihan.
  • Menetapkan tag unik ingest-by untuk setiap panggilan penyerapan dapat berdampak signifikan pada performa.
  • Jika alur diketahui memiliki duplikasi data, kami sarankan Anda menyelesaikan duplikasi ini sebelum menyerap data.

Contoh

Menambahkan tag pada penyerapan

Perintah berikut menyerap data dan menambahkan tag ingest-by:2016-02-17.

.ingest ... with (tags = '["ingest-by:2016-02-17"]')

Mencegah penyerapan duplikat

Perintah berikut ini menyerap data selama tidak ada batasan dalam tabel yang ingest-by:2016-02-17 memiliki tag .

.ingest ... with (ingestIfNotExists = '["2016-02-17"]')

Mencegah penyerapan duplikat dan menambahkan tag ke data baru apa pun

Perintah berikut ini menyerap data selama tidak ada batasan dalam tabel yang ingest-by:2016-02-17 memiliki tag . Setiap data yang baru diserap akan mendapatkan ingest-by:2016-02-17 tag.

.ingest ... with (ingestIfNotExists = '["2016-02-17"]', tags = '["ingest-by:2016-02-17"]')

Batasan

  • Tag tingkat hanya dapat diterapkan ke rekaman dalam jangkauan. Akibatnya, tag tidak dapat diatur pada data penyerapan streaming sebelum disimpan dalam jangkauan.
  • Tag tingkat tidak dapat disimpan pada data dalam tabel eksternal atau tampilan materialisasi.

Konten terkait

  • Last updated on