Az entitások neve

  • Cikk

A Kusto-entitásokra név alapján hivatkozik egy lekérdezés. A nevük alapján hivatkozható entitások közé tartoznak az adatbázisok, táblák, oszlopok és tárolt függvények, fürtök azonban nem. Az entitáshoz hozzárendelt nevet azonosítónak nevezzük. Az entitásokon kívül egy azonosítót is hozzárendelhet a let utasítással beállított lekérdezési paraméterekhez vagy változókhoz.

Az entitás neve a tároló kontextusában egyedi az entitástípusra vonatkozóan. Egy adatbázis két táblája például nem rendelkezhet ugyanazzal a névvel, de egy adatbázisnak és egy táblának ugyanaz a neve, mert különböző entitástípusok. Hasonlóképpen, egy tábla és egy tárolt függvény neve is ugyanaz lehet.

Megjegyzés

Az Azure-erőforrásként is megjelenő entitásnevek az ARM-tartalékszavakra vonatkozó szabályokat követik.

Szép nevek

Az entitás neve mellett egyes entitások neve is meglehetősen szép lehet. Az entitásnevekhez hasonlóan a szép nevek is használhatók egy entitásra való hivatkozáshoz a lekérdezésekben. Az entitásnevekkel ellentétben azonban a szép nevek nem feltétlenül egyediek a tárolójuk kontextusában. Ha egy tároló több azonos nevű entitással rendelkezik, a szép név nem használható az entitásra való hivatkozáshoz.

A szép nevek lehetővé teszik a középső rétegbeli alkalmazások számára az automatikusan létrehozott entitásnevek (például UUID-k) leképezését olyan nevekre, amelyek megjeleníthetőek és hivatkozhatók emberi olvasásra.

Egy szép név hozzárendelésére vonatkozó példát az .alter database prettyname parancsban talál.

Azonosító elnevezési szabályai

Az azonosító az entitásokhoz, lekérdezési paraméterekhez vagy let utasítással beállított változókhoz rendelt név. Az érvényes azonosítóknak az alábbi szabályokat kell követniük:

  • Az azonosítók megkülönböztetik a kis- és nagybetűket. Az adatbázisnevek nem különböztetik meg a kis- és nagybetűket, ezért kivételt képeznek ebből a szabályból.
  • Az azonosítóknak 1 és 1024 karakter közötti hosszúságúnak kell lenniük.
  • Az azonosítók betűket, számjegyeket és aláhúzásjeleket (_) tartalmazhatnak.
  • Az azonosítók tartalmazhatnak bizonyos speciális karaktereket: szóközöket, pontokat (.) és kötőjeleket (-). A speciális karaktereket tartalmazó azonosítókra való hivatkozásról további információt a Lekérdezések azonosítóinak hivatkozása című témakörben talál.

Megjegyzés

  • Csak a betűk, számjegyek, aláhúzásjelek, pontok és kötőjelek megadott UTF-8 karakterei támogatottak. A pontosvesszők és a kettőspont például nem támogatott.
  • A $ karakter egy KQL-operátor által létrehozott entitásnevekben engedélyezett.

Kerülje az azonosítók nyelvi kulcsszavakként vagy literálként való elnevezését

A KQL-ben vannak olyan kulcsszavak és literálok, amelyek az azonosítókhoz hasonló elnevezési szabályokkal rendelkeznek. A kulcsszavakkal vagy literálokkal megegyező nevű azonosítók is lehetnek. Javasoljuk azonban, hogy kerülje ezt, mivel a lekérdezésekben való hivatkozás speciális idézést igényel.

Ha nem szeretne olyan azonosítót használni, amely nyelvi kulcsszó vagy literál is lehet (például where, summarizeés 1day), az entitás nevét az alábbi konvenciók szerint választhatja ki, amelyek nem alkalmazhatók a nyelvi kulcsszavakra:

  • Használjon nagy kezdőbetűvel kezdődő nevet (A to Z).

  • Használjon olyan nevet, amely egyetlen aláhúzásjellel_ () kezdődik vagy végződik.

    Megjegyzés

    A KQL fenntartja az összes olyan azonosítót, amely két aláhúzásjelből álló sorozattal kezdődik vagy végződik (__); a felhasználók nem definiálhatnak ilyen neveket saját használatra.

Az azonosítókra való hivatkozással kapcsolatos információkért lásd: Azonosítók hivatkozása a lekérdezésekben.

Hivatkozásazonosítók a lekérdezésekben

Az alábbi táblázat ismerteti, hogyan hivatkozhat azonosítókra a lekérdezésekben.

Azonosító típusa Azonosító Referencia Magyarázat
Normál entity entity A speciális karaktereket nem tartalmazó azonosítókat (entity) nem kell idézőjelek közé tenni.
Speciális karakter entity-name ['entity-name'] A speciális karaktereket (például -) tartalmazó azonosítóneveket a és a és '] a használatával [""]kell befoglalni['.
nyelvi kulcsszó where ["where"] A nyelvi kulcsszavakat tartalmazó azonosítóneveket a és '][""]a használatával kell megadni.['
Szó 1day ["1day"] A konstansok azonosítóneveit a és '][""]a használatával kell megadni.['

Megjegyzés

Az azonosítók megkülönböztetik a kis- és nagybetűket. Például nem hivatkozhat a nevű ThisTablethisTABLEtáblára.

Kapcsolódó tartalom