Nama entitas
Entitas Kusto (database, tabel, kolom, dan fungsi tersimpan; kluster adalah pengecualian) diberi nama. Nama entitas mengidentifikasi entitas, dan dijamin unik dalam cakupan kontainernya sesuai jenisnya. (Jadi, misalnya, dua tabel dalam database yang sama tidak dapat memiliki nama yang sama, tetapi tabel dan database mungkin memiliki nama yang sama karena mereka tidak dalam cakupan yang sama, dan tabel dan fungsi tersimpan mungkin memiliki nama yang sama karena mereka bukan dari jenis entitas yang sama.)
Nama entitas peka huruf besar/kecil untuk menyelesaikan tujuan (jadi, misalnya, Anda tidak dapat merujuk ke tabel yang disebut ThisTable sebagai thisTABLE).
Nama entitas adalah salah satu contoh pengidentifikasi. Pengidentifikasi lain termasuk nama parameter ke fungsi dan pengikatan nama melalui pernyataan let.
Nama cantik entitas
Beberapa entitas (seperti database) mungkin memiliki, selain nama entitas mereka, nama cantik. Nama cantik dapat digunakan untuk mereferensikan entitas dalam kueri (seperti nama entitas), 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) menjadi nama yang dapat dibaca manusia untuk tujuan tampilan dan referensi.
Aturan penamaan pengidentifikasi
Pengidentifikasi digunakan untuk menamai berbagai entitas (entitas atau sebaliknya). Nama pengidentifikasi yang valid mengikuti aturan berikut:
- Panjangnya harus antara 1 hingga 1024 karakter.
- Mereka dapat berisi huruf, digit, garis bawah (
_), spasi, titik (.), dan tanda hubung (-).- Pengidentifikasi yang hanya terdiri dari huruf, digit, dan garis bawah tidak memerlukan kuotasi saat pengidentifikasi sedang direferensikan.
- Pengidentifikasi yang berisi setidaknya satu dari (spasi, titik, atau tanda hubung) memerlukan kuotasi (lihat di bawah).
- Mereka peka huruf besar/kecil.
Kuotasi pengidentifikasi
Pengidentifikasi yang identik dengan beberapa kata kunci bahasa kueri, atau memiliki salah satu karakter khusus yang disebutkan di atas, memerlukan kuotasi ketika direferensikan langsung oleh kueri:
| Teks kueri | Komentar |
|---|---|
entity |
Nama entitas (entity) yang tidak menyertakan karakter atau peta khusus ke beberapa kata kunci bahasa tidak memerlukan kuotasi |
['entity-name'] |
Nama entitas yang menyertakan karakter khusus (di sini: -) harus dikutip menggunakan [' dan '] atau menggunakan [" dan "] |
["where"] |
Nama entitas yang merupakan kata kunci bahasa harus dikutip menggunakan [' dan '] atau menggunakan [" dan "] |
Menamai entitas Anda untuk menghindari tabrakan dengan kata kunci bahasa Kusto
Karena bahasa kueri Kusto mencakup sejumlah kata kunci yang memiliki aturan penamaan yang sama dengan pengidentifikasi, dimungkinkan untuk memiliki nama entitas yang sebenarnya adalah kata kunci, tetapi kemudian merujuk ke nama-nama ini menjadi sulit (seseorang harus mengutipnya).
Atau, seseorang mungkin ingin memilih nama entitas yang dijamin tidak akan pernah "bertabrakan" dengan kata kunci Kusto. Jaminan berikut dibuat:
- Bahasa kueri Kusto tidak akan menentukan kata kunci yang dimulai dengan huruf kapital (
AtoZ). - Bahasa kueri Kusto tidak akan menentukan kata kunci yang dimulai dengan satu garis bawah (
_). - Bahasa kueri Kusto tidak akan menentukan kata kunci yang diakhiri dengan satu garis bawah (
_).
Bahasa kueri Kusto menyimpan semua pengidentifikasi yang dimulai atau diakhiri dengan urutan dua karakter garis bawah (__); pengguna tidak dapat menentukan nama tersebut untuk penggunaannya sendiri.