Entitásnevek

Szolgáltatások váltása a Verzió legördülő listával. További információ a navigációról.
A következőkre vonatkozik: ✅ Microsoft Fabric ✅ Azure Data Explorer ✅ Azure Monitor ✅ Microsoft Sentinel

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. Az entitáshoz rendelt nevet azonosítónak nevezzük. Az entitásokon kívül egy azonosítót is hozzárendelhet a lekérdezési paraméterekhez vagy a let utasítással beállított változókhoz.

Az entitás neve egyedi az entitástípushoz a tároló kontextusában. Egy adatbázis két táblájának például nem lehet ugyanaz a neve, de egy adatbázisnak és egy táblának ugyanaz a neve, mert különböző entitástípusok. Hasonlóképpen előfordulhat, hogy egy tábla és egy tárolt függvény neve megegyezik.

Megjegyzés:

Az Azure-erőforrásként is megjelenő entitásnevek az ARM tartalékszavainak szabályait követik.

Szép nevek

Az entitás neve mellett egyes entitásoknak is lehet szép neve. Az entitásnevekhez hasonlóan a szép nevek segítségével is hivatkozhat egy entitásra a lekérdezésekben. Az entitásnevektől eltérően azonban a szép nevek nem feltétlenül egyediek a tárolójuk kontextusában. Ha egy tároló több azonos szép 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ő szintű 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őségi és hivatkozási célokra olvashatók.

Azonosító elnevezési szabályai

Az azonosító az entitásokhoz, lekérdezési paraméterekhez vagy egy let utasításon keresztül beállított változóhoz hozzá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 érzéketlenek, ezért kivételt képeznek a szabály aló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, kötőjeleket (.) é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 referencia-azonosítói 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.

Az azonosítók elnevezésének elkerülése nyelvi kulcsszavakként vagy literálként

A KQL-ben vannak olyan kulcsszavak és literálok, amelyek az azonosítókhoz hasonló elnevezési szabályokkal rendelkeznek. A kulcsszavakkal és a literálokkal azonos 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 szeretné elkerülni, hogy olyan azonosítót használjon, amely lehet nyelvi kulcsszó vagy konstans is, például where, summarizeés 1dayaz 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 a következőhöz Z).

• Olyan nevet használjon, 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ásról további információt a lekérdezések referenciaazonosítói című témakörben talál.

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

Az alábbi táblázat bemutatja, hogyan hivatkozhat a lekérdezések azonosítóira.

Azonosító típusa	Azonosító	Reference	Explanation
Normal	entity	entity	Az olyan azonosítókat (entity) nem kell idézőjelek közé helyezni, amelyek nem tartalmaznak speciális karaktereket vagy nem képeznek le valamilyen nyelvi kulcsszóra.
Speciális karakter	entity-name	['entity-name']	A speciális karaktereket (például -) tartalmazó azonosítóneveket a következővel [''][""]kell befoglalni:
nyelvi kulcsszó	where	["where"]	A nyelvi kulcsszavakat tartalmazó azonosítóneveket az és és ['']["azokkal együtt kell megadni."]
konstansérték	1day	["1day"]	A konstans azonosítóneveket az és és ['']["a használatával kell megadni."]

Megjegyzés:

Az azonosítók megkülönböztetik a kis- és nagybetűket. Nem hivatkozhat például a következőnek ThisTablenevezett thisTABLE táblára: .

Kapcsolódó tartalom

• Entitástípusok.
• Szintaxiskonvenciák a referenciadokumentációhoz.