Nomi delle entità

  • Articolo

Si applica a: ✅Microsoft Fabric✅Azure Esplora dati✅ Azure Monitor✅Microsoft Sentinel

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

Alle entità Kusto viene fatto riferimento in base al nome di una query. Le entità a cui è possibile fare riferimento in base al nome includono database, tabelle, colonne e funzioni archiviate. Il nome assegnato a un'entità è denominato 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 relativo 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 delle entità, che si riflettono anche come risorsa di Azure, seguono le regole relative alle parole riservate arm.

Nomi abbastanza belli

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

I nomi piuttosto comuni consentono alle applicazioni di livello intermedio di eseguire il mapping dei nomi di entità creati automaticamente (ad esempio gli UUID) ai nomi leggibili per scopi di visualizzazione e riferimento.

Per un esempio su come assegnare un nome piuttosto carino, 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 fanno distinzione tra maiuscole e minuscole. I nomi dei database non fanno distinzione tra maiuscole e minuscole e pertanto fanno eccezione a questa regola.
  • Gli identificatori devono avere una lunghezza compresa 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. Ad esempio, i punti e virgola e i due punti non sono supportati.
  • Il $ carattere è consentito nei nomi di entità quando generato da un operatore KQL.

Evitare di rinominare gli identificatori come parole chiave del linguaggio o valori letterali

In KQL sono presenti parole chiave e valori letterali con regole di denominazione simili a quella degli identificatori. È possibile avere identificatori con lo stesso nome delle parole chiave o dei valori letterali. Tuttavia, è consigliabile evitare di farlo facendo riferimento a tali elementi nelle query richiede un'virgolette speciali.

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 Identifier Riferimento Spiegazione
Normale entity entity Gli identificatori (entity) che non includono caratteri speciali o che eseguono il mapping a una parola chiave del linguaggio 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 language where ["where"] I nomi degli identificatori che sono parole chiave del linguaggio devono essere racchiusi tra [' e e '] [" ."]
literal 1day ["1day"] I nomi degli identificatori che sono valori letterali devono essere racchiusi tra e [' e '] [" ."]

Nota

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

Contenuto correlato