Freigeben über

Entitätsnamen

  • Artikel

Gilt für: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

Kusto-Entitäten werden in einer Abfrage anhand des Namens referenziert. Entitäten, auf die anhand ihres Namens verwiesen werden kann, umfassen Datenbanken, Tabellen, Spalten und gespeicherte Funktionen, jedoch keine Cluster. Der Name, den Sie einer Entität zuweisen, wird als Bezeichner bezeichnet. Zusätzlich zu Entitäten können Sie auch abfrageparametern einen Bezeichner oder Variablen zuweisen, die über eine Let-Anweisung festgelegt werden.

Kusto-Entitäten werden in einer Abfrage anhand des Namens referenziert. Entitäten, auf die anhand ihres Namens verwiesen werden kann, umfassen Datenbanken, Tabellen, Spalten und gespeicherte Funktionen. Der Name, den Sie einer Entität zuweisen, wird als Bezeichner bezeichnet. Zusätzlich zu Entitäten können Sie auch abfrageparametern einen Bezeichner oder Variablen zuweisen, die über eine Let-Anweisung festgelegt werden.

Der Name einer Entität ist für den Entitätstyp im Kontext des Containers eindeutig. Beispielsweise können zwei Tabellen in derselben Datenbank nicht denselben Namen haben, aber eine Datenbank und eine Tabelle können denselben Namen haben, da sie unterschiedliche Entitätstypen sind. Ebenso kann eine Tabelle und eine gespeicherte Funktion denselben Namen haben.

Hinweis

Entitätsnamen, die auch als Azure-Ressource widergespiegelt werden, folgen den REGELN für ARM-Reservewörter.

Hübsche Namen

Neben dem Namen der Entität haben einige Entitäten möglicherweise einen ziemlichen Namen. Ähnlich wie bei der Verwendung von Entitätsnamen können hübsche Namen verwendet werden, um in Abfragen auf eine Entität zu verweisen. Im Gegensatz zu Entitätsnamen sind hübsche Namen nicht unbedingt im Kontext ihres Containers eindeutig. Wenn ein Container mehrere Entitäten mit demselben hübschen Namen hat, kann der hübsche Name nicht verwendet werden, um auf die Entität zu verweisen.

Hübsche Namen ermöglichen es Anwendungen auf mittlerer Ebene, automatisch erstellte Entitätsnamen (z. B. UUIDs) Namen zuzuordnen, die für Anzeige- und Referenzzwecke lesbar sind.

Ein Beispiel zum Zuweisen eines hübschen Namens finden Sie unter ".alter database prettyname"-Befehl.For an example on how to assign a pretty name, see .alter database prettyname command.

Benennungsregeln für Bezeichner

Ein Bezeichner ist der Name, den Sie Entitäten, Abfrageparametern oder Variablen zuweisen, die über eine Let-Anweisung festgelegt werden. Gültige Bezeichner müssen folgende Regeln einhalten:

  • Bei Bezeichnern wird die Groß-/Kleinschreibung beachtet. Bei Datenbanknamen wird die Groß-/Kleinschreibung nicht beachtet und daher eine Ausnahme zu dieser Regel.
  • Bezeichner müssen zwischen 1 und 1024 Zeichen lang sein.
  • Bezeichner können Buchstaben, Ziffern und Unterstriche (_) enthalten.
  • Bezeichner können bestimmte Sonderzeichen enthalten: Leerzeichen, Punkte (.) und Striche (-). Informationen zum Verweisen auf Bezeichner mit Sonderzeichen finden Sie unter Referenzbezeichner in Abfragen.

Hinweis

  • Es werden nur die angegebenen UTF-8 Zeichen mit Buchstaben, Ziffern, Unterstrichen, Punkten und Gedankenstrichen unterstützt. Semikolons und Doppelpunkte werden z. B. nicht unterstützt.
  • Das $ Zeichen ist in Entitätsnamen zulässig, wenn es von einem KQL-Operator generiert wird.

Vermeiden von Benennungsbezeichnern als Sprachstichwörter oder Literale

In KQL gibt es Schlüsselwörter und Literale, die ähnliche Benennungsregeln wie Bezeichner aufweisen. Sie können Bezeichner mit demselben Namen wie Schlüsselwörter oder Literale haben. Es wird jedoch empfohlen, dies zu vermeiden, da sie in Abfragen referenziert werden müssen, eine spezielle Quotierung erforderlich ist.

Um die Verwendung eines Bezeichners zu vermeiden, der auch ein Sprachstichwort oder -literal sein kann, z where. B. , summarizeund 1day, können Sie Ihren Entitätsnamen gemäß den folgenden Konventionen auswählen, die nicht für Sprachstichwörter gelten:

  • Verwenden Sie einen Namen, der mit einem Großbuchstaben beginnt (A in Z).

  • Verwenden Sie einen Namen, der mit einem einzelnen Unterstrich (_) beginnt oder endet.

    Hinweis

    KQL reserviert alle Bezeichner, die mit einer Abfolge von zwei Unterstrichzeichen (__) beginnen oder enden. Benutzer können solche Namen nicht für ihre eigene Verwendung definieren.

Informationen zum Verweisen auf diese Bezeichner finden Sie unter Referenzbezeichner in Abfragen.

Referenzbezeichner in Abfragen

Die folgende Tabelle enthält eine Erläuterung zum Verweisen auf Bezeichner in Abfragen.

Bezeichnertyp Identifier Verweis Erklärung
Normal entity entity Bezeichner (entity) ohne Sonderzeichen oder Zuordnung zu einigen Sprachschlüsselworten müssen nicht in Anführungszeichen eingeschlossen werden.
Sonderzeichen entity-name ['entity-name'] Bezeichnernamen, die Sonderzeichen (z -. B. ) enthalten, müssen mit [' und '] oder mit und verwendet [" "]werden.
Schlüsselwort "language" where ["where"] Bezeichnernamen, die Sprachstichwörter sind, müssen mit [' und '] oder oder [" und eingeschlossen "]werden.
Literal 1day ["1day"] Bezeichnernamen, die Literale sind, müssen mit [' und '] oder oder [" und "]eingeschlossen werden.

Hinweis

Bei Bezeichnern wird die Groß-/Kleinschreibung beachtet. Sie können z. B. nicht auf eine Tabelle verweisen, die als thisTABLE.ThisTable

Zugehöriger Inhalt