Aracılığıyla paylaş

Varlık adları

  • Makale

Şunlar için geçerlidir: ✅Microsoft Fabric✅Azure Veri Gezgini✅ Azure İzleyici✅Microsoft Sentinel

Kusto varlıklarına bir sorguda ada göre başvurulur. Adları tarafından 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.

Kusto varlıklarına bir sorguda ada göre başvurulur. Adları tarafından başvurulabilen varlıklar veritabanları, tablolar, sütunlar ve depolanan işlevlerdir. 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ısı 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 saklı işlev de 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 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 sahip olduğunda, 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 insan tarafından okunabilen 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 (-). Özel karakterler içeren tanımlayıcılara başvurma hakkında bilgi için bkz . Sorgulardaki başvuru tanımlayıcıları.

Not

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

Tanımlayıcıları dil anahtar sözcükleri veya değişmez değer 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 alıntılar gerektirdiğinden bunu yapmaktan kaçınmanızı öneririz.

, ve 1daygibi wheresummarizebir 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 karakteri (__) dizisiyle 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 tanımlayıcılara başvurma.

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 (gibi-) içeren tanımlayıcı adları ve '] veya kullanılarak [" "]ve kullanılarak kapatılmalıdır['.
language anahtar sözcüğü where ["where"] Dil anahtar sözcükleri olan tanımlayıcı adları ve '] veya [" "]kullanılarak [' kapatılmalıdır.
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ı ThisTable thisTABLEbir tabloya başvuramazsınız.

İlgili içerik