Nomi delle entità

  • Articolo

Le entità Kusto vengono a cui si fa riferimento in una query in base al nome. Le entità a cui è possibile fare riferimento il nome includono database, tabelle, colonne e funzioni archiviate, ma non cluster. Il nome assegnato a un'entità viene chiamato identificatore. Oltre alle entità, è anche possibile assegnare un identificatore ai parametri di query o alle variabili impostate tramite un'istruzione let.

Il nome di un'entità è univoco per il tipo di entità nel contesto del contenitore. Ad esempio, due tabelle nello stesso database non possono avere lo stesso nome, ma un database e una tabella possono avere lo stesso nome perché sono tipi di entità diversi. Analogamente, una tabella e una funzione archiviata possono avere lo stesso nome.

Nota

I nomi di entità, che vengono anche riflessi come risorsa di Azure, seguono le regole delle parole di riserva arm.

Nomi piuttosto belli

Oltre al nome dell'entità, alcune entità potrebbero avere un nome piuttosto semplice. Analogamente all'uso di nomi di entità, è possibile usare i nomi piuttosto per fare riferimento a un'entità nelle query. Ma a differenza dei nomi di entità, i nomi piuttosto non sono necessariamente univoci nel contesto del contenitore. Quando un contenitore ha più entità con lo stesso nome, il nome piuttosto non può essere usato per fare riferimento all'entità.

I nomi piuttosto appropriati consentono alle applicazioni di livello intermedio di eseguire il mapping automatico dei nomi di entità (ad esempio UUID) ai nomi leggibili per la visualizzazione e il riferimento.

Per un esempio su come assegnare un nome piuttosto semplice, vedere comando .alter database prettyname.

Regole di denominazione degli identificatori

Un identificatore è il nome assegnato a entità, parametri di query o variabile impostati tramite un'istruzione let. Per essere validi gli identificatori devono rispettare le regole seguenti:

  • Gli identificatori sono distinzione tra maiuscole e minuscole. I nomi di database sono senza distinzione tra maiuscole e minuscole e quindi un'eccezione a questa regola.
  • Gli identificatori devono essere compresi tra 1 e 1024 caratteri.
  • Gli identificatori possono contenere lettere, cifre e caratteri di sottolineatura (_).
  • Gli identificatori possono contenere determinati caratteri speciali: spazi, punti () e trattini (.-). Per informazioni su come fare riferimento agli identificatori con caratteri speciali, vedere Identificatori di riferimento nelle query.

Nota

  • Sono supportati solo i caratteri UTF-8 specificati di lettere, cifre, caratteri di sottolineatura, punti e trattini specificati. Ad esempio, i punti e i punti e i punti non sono supportati.
  • Il $ carattere è consentito nei nomi di entità quando generato da un operatore KQL.

Evitare identificatori di denominazione come parole chiave del linguaggio o valori letterali

In KQL sono presenti parole chiave e valori letterali che dispongono di regole di denominazione simili come identificatori. È possibile avere identificatori con lo stesso nome delle parole chiave o valori letterali. È tuttavia consigliabile evitare di farlo facendo riferimento alle query che richiedono una citazione speciale.

Per evitare di usare un identificatore che potrebbe anche essere una parola chiave del linguaggio o un valore letterale, ad esempio where, summarizee 1day, è possibile scegliere il nome dell'entità in base alle convenzioni seguenti, che non sono applicabili alle parole chiave del linguaggio:

  • Usare un nome che inizia con una lettera maiuscola (A a Z).

  • Usare un nome che inizia o termina con un singolo carattere di sottolineatura (_).

    Nota

    KQL riserva tutti gli identificatori che iniziano o terminano con una sequenza di due caratteri di sottolineatura (__); gli utenti non possono definire tali nomi per il proprio uso.

Per informazioni su come fare riferimento a questi identificatori, vedere Identificatori di riferimento nelle query.

Identificatori di riferimento nelle query

La tabella seguente fornisce una spiegazione su come fare riferimento agli identificatori nelle query.

Tipo di identificatore Identificatore Riferimento Spiegazione
Normale entity entity Gli identificatori (entity) che non includono caratteri speciali o mappano a una parola chiave della lingua non devono essere racchiusi tra virgolette.
Carattere speciale entity-name ['entity-name'] I nomi degli identificatori che includono caratteri speciali (ad esempio -) devono essere racchiusi usando e o usando ['[" e ']"].
parola chiave del linguaggio where ["where"] I nomi di identificatore che sono parole chiave del linguaggio devono essere racchiusi usando [' e o [" e ']"].
valore letterale 1day ["1day"] I nomi di identificatore che sono valori letterali devono essere racchiusi usando [' e '] o [" e "].

Nota

Gli identificatori sono distinzione tra maiuscole e minuscole. Ad esempio, non è possibile fare riferimento a una tabella denominata ThisTable .thisTABLE

Contenuti correlati