Entiteitsnamen

  • Artikel

Naar Kusto-entiteiten wordt in een query op naam verwezen. Entiteiten waarnaar kan worden verwezen door hun naam zijn databases, tabellen, kolommen en opgeslagen functies, maar geen clusters. De naam die u aan een entiteit toewijst, wordt een id genoemd. Naast entiteiten kunt u ook een id toewijzen aan queryparameters of variabelen die zijn ingesteld via een let-instructie.

De naam van een entiteit is uniek voor het entiteitstype in de context van de container. Twee tabellen in dezelfde database kunnen bijvoorbeeld niet dezelfde naam hebben, maar een database en een tabel kunnen dezelfde naam hebben omdat het verschillende entiteitstypen zijn. Op dezelfde manier kunnen een tabel en een opgeslagen functie dezelfde naam hebben.

Notitie

Entiteitsnamen, die ook worden weergegeven als een Azure-resource, volgen de ARM-gereserveerde woorden regels.

Mooie namen

Naast de naam van de entiteit kunnen sommige entiteiten een mooie naam hebben. Net als bij het gebruik van entiteitsnamen kunnen mooie namen worden gebruikt om te verwijzen naar een entiteit in query's. Maar in tegenstelling tot entiteitsnamen zijn mooie namen niet noodzakelijkerwijs uniek in de context van hun container. Wanneer een container meerdere entiteiten met dezelfde pretty-naam heeft, kan de mooie naam niet worden gebruikt om naar de entiteit te verwijzen.

Met mooie namen kunnen toepassingen in de middelste laag automatisch gemaakte entiteitsnamen (zoals UUID's) toewijzen aan namen die door mensen kunnen worden gelezen voor weergave- en verwijzingsdoeleinden.

Zie de opdracht .alter database prettyname voor een voorbeeld van het toewijzen van een mooie naam.

Naamgevingsregels voor id's

Een id is de naam die u toewijst aan entiteiten, queryparameters of variabelen die zijn ingesteld via een let-instructie. Geldige id's moeten aan deze regels voldoen:

  • Id's zijn hoofdlettergevoelig. Databasenamen zijn niet hoofdlettergevoelig en vormen daarom een uitzondering op deze regel.
  • Id's moeten tussen 1 en 1024 tekens lang zijn.
  • Id's kunnen letters, cijfers en onderstrepingstekens () bevatten._
  • Id's kunnen bepaalde speciale tekens bevatten: spaties, punten (.) en streepjes (-). Zie Referentie-id's in query's voor meer informatie over het verwijzen naar id's met speciale tekens.

Notitie

  • Alleen de opgegeven UTF-8-tekens van letters, cijfers, onderstrepingstekens, puntjes en streepjes worden ondersteund. Puntkomma's en dubbele punten worden bijvoorbeeld niet ondersteund.
  • Het $ teken is toegestaan in entiteitsnamen wanneer deze worden gegenereerd door een KQL-operator.

Naamgeving van id's als taaltrefwoorden of letterlijke waarden voorkomen

In KQL zijn er trefwoorden en letterlijke waarden met vergelijkbare naamgevingsregels als id's. U kunt id's hebben met dezelfde naam als trefwoorden of letterlijke waarden. We raden u echter aan dit niet te doen, omdat voor het verwijzen naar deze query's speciale aanhalingstekens vereist zijn.

Als u wilt voorkomen dat een id wordt gebruikt die ook een taaltrefwoord of letterlijke waarde kan zijn, zoals where, summarizeen 1day, kunt u de naam van uw entiteit kiezen volgens de volgende conventies, die niet van toepassing zijn op taaltrefwoorden:

  • Gebruik een naam die begint met een hoofdletter (A tot Z).

  • Gebruik een naam die begint of eindigt met één onderstrepingsteken (_).

    Notitie

    KQL reserveert alle id's die beginnen of eindigen met een reeks van twee onderstrepingstekens (__); gebruikers kunnen dergelijke namen niet definiëren voor hun eigen gebruik.

Zie Referentie-id's in query's voor meer informatie over het verwijzen naar deze id's.

Referentie-id's in query's

De volgende tabel bevat een uitleg over het verwijzen naar id's in query's.

Id-type Id Referentie Uitleg
Normaal entity entity Id's (entity) die geen speciale tekens bevatten of niet zijn toegewezen aan een taalwoord, hoeven niet tussen aanhalingstekens te staan.
Speciaal teken entity-name ['entity-name'] Id-namen die speciale tekens bevatten (zoals -) moeten worden ingesloten met en [''] of met behulp van [" en ."]
trefwoord taal where ["where"] Id-namen die taaltrefwoorden zijn, moeten worden ingesloten met en [''] of [" en "].
Letterlijke 1day ["1day"] Id-namen die letterlijke waarden zijn, moeten worden ingesloten met behulp van [' en '] of [" en "].

Notitie

Id's zijn hoofdlettergevoelig. U kunt bijvoorbeeld niet verwijzen naar een tabel met thisTABLEde naam ThisTable .

Gerelateerde inhoud