Nama entitas

  • Artikel

Entitas Kusto dirujuk dalam kueri berdasarkan nama. Entitas yang dapat dirujuk oleh namanya termasuk database, tabel, kolom, dan fungsi yang disimpan, tetapi bukan kluster. Nama yang Anda tetapkan entitas disebut pengidentifikasi. Selain entitas, Anda juga dapat menetapkan pengidentifikasi untuk parameter kueri, atau variabel yang diatur melalui pernyataan let.

Nama entitas unik untuk jenis entitas dalam konteks kontainernya. Misalnya, dua tabel dalam database yang sama tidak boleh memiliki nama yang sama, tetapi database dan tabel dapat memiliki nama yang sama karena merupakan jenis entitas yang berbeda. Demikian pula, tabel dan fungsi yang disimpan mungkin memiliki nama yang sama.

Catatan

Nama entitas, yang juga tercermin sebagai sumber daya Azure, ikuti aturan kata cadangan ARM.

Nama cantik

Selain nama entitas, beberapa entitas mungkin memiliki nama yang cantik. Mirip dengan penggunaan nama entitas, nama cantik dapat digunakan untuk mereferensikan entitas dalam kueri. Tetapi tidak seperti nama entitas, nama cantik tidak selalu unik dalam konteks kontainer mereka. Ketika kontainer memiliki beberapa entitas dengan nama cantik yang sama, nama cantik tidak dapat digunakan untuk mereferensikan entitas.

Nama cantik memungkinkan aplikasi tingkat menengah untuk memetakan nama entitas yang dibuat secara otomatis (seperti UUID) ke nama yang dapat dibaca manusia untuk tujuan tampilan dan referensi.

Untuk contoh tentang cara menetapkan nama cantik, lihat perintah .alter database prettyname.

Aturan penamaan pengidentifikasi

Pengidentifikasi adalah nama yang Anda tetapkan ke entitas, parameter kueri, atau variabel yang diatur melalui pernyataan let. Pengidentifikasi yang valid harus mengikuti aturan ini:

  • Pengidentifikasi peka huruf besar/kecil. Nama database tidak peka huruf besar/kecil, dan oleh karena itu pengecualian untuk aturan ini.
  • Panjang pengidentifikasi harus antara 1 dan 1024 karakter.
  • Pengidentifikasi mungkin berisi huruf, digit, dan garis bawah (_).
  • Pengidentifikasi mungkin berisi karakter khusus tertentu: spasi, titik (.), dan garis putus-putus (-). Untuk informasi tentang cara mereferensikan pengidentifikasi dengan karakter khusus, lihat Pengidentifikasi referensi dalam kueri.

Catatan

  • Hanya karakter huruf, digit, garis bawah, titik, dan tanda hubung UTF-8 yang ditentukan yang didukung. Misalnya, titik koma dan titik dua tidak didukung.
  • Karakter $ diizinkan dalam nama entitas saat dihasilkan oleh operator KQL.

Hindari penamaan pengidentifikasi sebagai kata kunci bahasa atau harfiah

Di KQL, ada kata kunci dan harfiah yang memiliki aturan penamaan serupa sebagai pengidentifikasi. Anda dapat memiliki pengidentifikasi dengan nama yang sama dengan kata kunci atau harfiah. Namun, kami sarankan Anda menghindari melakukannya karena merujuknya dalam kueri memerlukan kutipan khusus.

Untuk menghindari penggunaan pengidentifikasi yang mungkin juga merupakan kata kunci bahasa atau harfiah, seperti where, , summarizedan 1day, Anda dapat memilih nama entitas Anda sesuai dengan konvensi berikut, yang tidak berlaku untuk kata kunci bahasa:

  • Gunakan nama yang dimulai dengan huruf kapital (A hingga Z).

  • Gunakan nama yang dimulai atau diakhir dengan satu garis bawah (_).

    Catatan

    KQL mencadangkan semua pengidentifikasi yang dimulai atau diakhir dengan urutan dua karakter garis bawah (__); pengguna tidak dapat menentukan nama tersebut untuk penggunaan mereka sendiri.

Untuk informasi tentang cara mereferensikan pengidentifikasi ini, lihat Pengidentifikasi referensi dalam kueri.

Pengidentifikasi referensi dalam kueri

Tabel berikut ini memberikan penjelasan tentang cara mereferensikan pengidentifikasi dalam kueri.

Jenis pengidentifikasi Pengidentifikasi Referensi Penjelasan
Normal entity entity Pengidentifikasi (entity) yang tidak menyertakan karakter khusus atau peta ke beberapa kata kunci bahasa tidak perlu diapit dalam tanda kutip.
Karakter khusus entity-name ['entity-name'] Nama pengidentifikasi yang menyertakan karakter khusus (seperti -) harus diapit menggunakan [' dan '] atau menggunakan [" dan "].
kata kunci bahasa where ["where"] Nama pengidentifikasi yang merupakan kata kunci bahasa harus diapit menggunakan [' dan '] atau atau [" dan "].
harfiah 1day ["1day"] Nama pengidentifikasi yang harfiah harus diapit menggunakan [' dan '] atau atau [" dan "].

Catatan

Pengidentifikasi peka huruf besar/kecil. Misalnya, Anda tidak dapat merujuk ke tabel yang disebut ThisTable sebagai thisTABLE.

Konten terkait