Entitätsnamen

  • Artikel

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

Der Name einer Entität ist für den Entitätstyp im Kontext ihres 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 es sich um unterschiedliche Entitätstypen handelt. Ebenso können eine Tabelle und eine gespeicherte Funktion denselben Namen haben.

Hinweis

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

Hübsche Namen

Zusätzlich zum Namen der Entität können einige Entitäten einen hübschen Namen haben. Ä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 jedoch nicht unbedingt eindeutig im Kontext ihres Containers. Wenn ein Container über mehrere Entitäten mit demselben hübschen Namen verfügt, kann der hübsche Name nicht verwendet werden, um auf die Entität zu verweisen.

Mit hübschen Namen können Anwendungen der mittleren Ebene automatisch erstellte Entitätsnamen (z. B. UUIDs) Namen zuordnen, die für Anzeige- und Verweiszwecke lesbar sind.

Ein Beispiel zum Zuweisen eines hübschen Namens finden Sie unter Befehl ".alter database prettyname".

Benennungsregeln für Bezeichner

Ein Bezeichner ist der Name, den Sie Entitäten, Abfrageparametern oder Variablensatz über eine let-Anweisung zuweisen. 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 von 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 Bindestriche (-). Informationen zum Verweisen auf Bezeichner mit Sonderzeichen finden Sie unter Referenzbezeichner in Abfragen.

Hinweis

  • Nur die angegebenen UTF-8-Zeichen von Buchstaben, Ziffern, Unterstrichen, Punkten und Bindestrichen werden unterstützt. Für instance werden Semikolons und Doppelpunkte nicht unterstützt.
  • Das $ Zeichen ist in Entitätsnamen zulässig, wenn es von einem KQL-Operator generiert wird.

Vermeiden der Benennung von Bezeichnern als Sprachschlüsselwö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 für den Verweis auf sie in Abfragen ein spezielles Zitat erforderlich ist.

Um die Verwendung eines Bezeichners zu vermeiden, der auch eine Sprache Schlüsselwort (keyword) oder Literal sein kann, zwhere. B. , summarizeund 1day, können Sie Ihren Entitätsnamen gemäß den folgenden Konventionen auswählen, die nicht auf Sprachschlüsselwörter anwendbar sind:

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

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

    Hinweis

    KQL reserviert alle Bezeichner, die mit einer Sequenz 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 Erklärung zum Verweisen auf Bezeichner in Abfragen.

Bezeichnertyp Bezeichner Referenz Erklärung
Normal entity entity Bezeichner (entity), die keine Sonderzeichen enthalten oder einer Sprache Schlüsselwort (keyword) zugeordnet sind, 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 "]eingeschlossen werden.
sprach Schlüsselwort (keyword) where ["where"] Bezeichnernamen, die Sprachschlüsselwörter sind, müssen mit [' und '] oder und [""]eingeschlossen werden.
literal 1day ["1day"] Bezeichnernamen, die Literale sind, müssen mit [' und '] oder [" und eingeschlossen "]werden.

Hinweis

Bei Bezeichnern wird die Groß-/Kleinschreibung beachtet. Beispielsweise können Sie nicht auf eine Tabelle namens ThisTablethisTABLEverweisen.

Verwandte Inhalte