Aracılığıyla paylaş

Varlık adları

  • Makale

Kusto varlıklarına bir sorguda ada göre başvurulur. Adları ile başvurulabilen varlıklar veritabanlarını, tabloları, sütunları ve depolanan işlevleri içerir, ancak kümeler içermez. Bir varlığa atadığınız ad tanımlayıcı olarak adlandırılır. Varlıklara ek olarak, sorgu parametrelerine veya let deyimi aracılığıyla ayarlanan değişkenlere de tanımlayıcı atayabilirsiniz.

Bir varlığın adı, kapsayıcı bağlamında varlık türü için benzersizdir. Örneğin, aynı veritabanındaki iki tablo aynı ada sahip olamaz, ancak veritabanı ve tablo farklı varlık türleri olduğundan aynı ada sahip olabilir. Benzer şekilde, bir tablo ve depolanan işlev aynı ada sahip olabilir.

Not

Azure kaynağı olarak da yansıtılan varlık adları, ARM ayrılmış sözcük kurallarını izler.

Güzel adlar

Varlığın adına ek olarak, bazı varlıkların da güzel bir adı olabilir. Varlık adlarının kullanımına benzer şekilde, sorgulardaki bir varlığa başvurmak için de güzel adlar kullanılabilir. Ancak varlık adlarından farklı olarak, güzel adların kapsayıcıları bağlamında benzersiz olması gerekmez. Bir kapsayıcı aynı güzel ada sahip birden çok varlığa sahipse, güzel ad varlığa başvurmak için kullanılamaz.

Güzel adlar, orta katman uygulamalarının otomatik olarak oluşturulan varlık adlarını (UUID'ler gibi) görüntüleme ve başvuru amacıyla insanlar tarafından okunabilir adlarla eşlemesine olanak tanır.

Güzel bir ad atama örneği için bkz. .alter database prettyname komutu.

Tanımlayıcı adlandırma kuralları

Tanımlayıcı, varlıklara, sorgu parametrelerine veya let deyimi aracılığıyla ayarlanan değişkene atadığınız addır. Geçerli tanımlayıcılar şu kurallara uymalıdır:

  • Tanımlayıcılar büyük/küçük harfe duyarlıdır. Veritabanı adları büyük/küçük harfe duyarlı değildir ve bu nedenle bu kural için özel durum oluşturur.
  • Tanımlayıcılar 1 ile 1024 karakter uzunluğunda olmalıdır.
  • Tanımlayıcılar harf, rakam ve alt çizgi (_) içerebilir.
  • Tanımlayıcılar belirli özel karakterler içerebilir: boşluklar, noktalar (.) ve tireler (-). Tanımlayıcılara özel karakterlerle başvurma hakkında bilgi için bkz. Sorgularda tanımlayıcılara başvurma.

Not

  • Yalnızca belirtilen UTF-8 harf, rakam, alt çizgi, nokta ve tire karakteri desteklenir. Örneğin noktalı virgüller ve iki nokta üst üsteler desteklenmez.
  • KQL $ işleci tarafından oluşturulduğunda varlık adlarında karaktere izin verilir.

Tanımlayıcıları dil anahtar sözcükleri veya değişmez değerleri olarak adlandırmaktan kaçının

KQL'de tanımlayıcılarla benzer adlandırma kurallarına sahip anahtar sözcükler ve değişmez değerler vardır. Anahtar sözcükler veya değişmez değerlerle aynı ada sahip tanımlayıcılarınız olabilir. Ancak, sorgularda bunlara başvurmak özel bir alıntı gerektirdiğinden bunu yapmaktan kaçınmanızı öneririz.

, summarizeve 1daygibi wherebir dil anahtar sözcüğü veya değişmez değer de olabilecek bir tanımlayıcı kullanmaktan kaçınmak için, varlık adınızı dil anahtar sözcükleri için geçerli olmayan aşağıdaki kurallar doğrultusunda seçebilirsiniz:

  • Büyük harfle başlayan bir ad kullanın (A için Z).

  • Tek bir alt çizgiyle (_ ) başlayan veya biten bir ad kullanın.

    Not

    KQL, iki alt çizgi karakteriyle (__) başlayan veya biten tüm tanımlayıcıları ayırır; kullanıcılar bu adları kendi kullanımları için tanımlayamaz.

Bu tanımlayıcılara başvurma hakkında bilgi için bkz. Sorgularda başvuru tanımlayıcıları.

Sorgulardaki başvuru tanımlayıcıları

Aşağıdaki tabloda sorgulardaki tanımlayıcılara başvurma hakkında bir açıklama sağlanmaktadır.

Tanımlayıcı türü Tanımlayıcı Başvuru Açıklama
Normal entity entity Özel karakterler içermeyen veya bazı dil anahtar sözcükleriyle eşlenen tanımlayıcıların (entity) tırnak içine alınması gerekmez.
Özel karakter entity-name ['entity-name'] Özel karakterler (örneğin-) içeren tanımlayıcı adları ve '] veya kullanılarak [""]ve [' içine alınmalıdır.
language anahtar sözcüğü where ["where"] Dil anahtar sözcükleri olan tanımlayıcı adları ve veya [" ile ']"]birlikte [' eklenmelidir.
değişmez değer 1day ["1day"] Değişmez değer olan tanımlayıcı adları ve veya [" ve ']"]kullanılarak [' kapatılmalıdır.

Not

Tanımlayıcılar büyük/küçük harfe duyarlıdır. Örneğin, adlı ThisTablethisTABLEbir tabloya başvuramazsınız.

İlgili içerik