Partager via


Noms d’entité

S’applique à : ✅Microsoft Fabric✅Azure Data ExplorerAzure MonitorMicrosoft Sentinel

Les entités Kusto sont référencées dans une requête par nom. Les entités qui peuvent être référencées par leur nom incluent des bases de données, des tables, des colonnes et des fonctions stockées, mais pas des clusters. Le nom que vous affectez à une entité est appelé identificateur. En plus des entités, vous pouvez également affecter un identificateur aux paramètres de requête ou aux variables définies par le biais d’une instruction let.

Les entités Kusto sont référencées dans une requête par nom. Les entités qui peuvent être référencées par leur nom incluent des bases de données, des tables, des colonnes et des fonctions stockées. Le nom que vous affectez à une entité est appelé identificateur. En plus des entités, vous pouvez également affecter un identificateur aux paramètres de requête ou aux variables définies par le biais d’une instruction let.

Le nom d’une entité est unique au type d’entité dans le contexte de son conteneur. Par exemple, deux tables de la même base de données ne peuvent pas avoir le même nom, mais une base de données et une table peuvent avoir le même nom, car elles sont des types d’entités différents. De même, une table et une fonction stockée peuvent avoir le même nom.

Remarque

Les noms d’entités, qui sont également reflétés en tant que ressource Azure, suivent les règles de mots de réserve ARM.

Jolis noms

En plus du nom de l’entité, certaines entités peuvent avoir un joli nom. À l’instar de l’utilisation de noms d’entités, de jolies noms peuvent être utilisés pour référencer une entité dans les requêtes. Mais contrairement aux noms d’entités, les jolis noms ne sont pas nécessairement uniques dans le contexte de leur conteneur. Lorsqu’un conteneur a plusieurs entités portant le même nom, le joli nom ne peut pas être utilisé pour référencer l’entité.

Les jolis noms permettent aux applications de niveau intermédiaire de mapper automatiquement les noms d’entités créés (tels que les UUID) aux noms lisibles par l’homme à des fins d’affichage et de référencement.

Pour obtenir un exemple sur l’affectation d’un joli nom, consultez la commande .alter database prettyname.

Règles de nommage d’identificateur

Un identificateur est le nom que vous affectez aux entités, aux paramètres de requête ou à la variable définie par le biais d’une instruction let. Les identificateurs valides doivent suivre les règles suivantes :

  • Les identificateurs respectent la casse. Les noms de base de données ne respectent pas la casse et, par conséquent, une exception à cette règle.
  • Les identificateurs doivent être compris entre 1 et 1 024 caractères.
  • Les identificateurs peuvent contenir des lettres, des chiffres et des traits de soulignement (_).
  • Les identificateurs peuvent contenir certains caractères spéciaux : espaces, points (.) et tirets (-). Pour plus d’informations sur la façon de référencer des identificateurs avec des caractères spéciaux, consultez identificateurs de référence dans les requêtes.

Remarque

  • Seuls les caractères UTF-8 spécifiés de lettres, de chiffres, de traits de soulignement, de points et de tirets sont pris en charge. Par exemple, les points-virgules et les points-virgules ne sont pas pris en charge.
  • Le caractère est autorisé dans les $ noms d’entités lorsqu’il est généré par un opérateur KQL.

Évitez d’nommer des identificateurs en tant que mots clés de langage ou littéraux

Dans KQL, il existe des mots clés et des littéraux qui ont des règles de nommage similaires en tant qu’identificateurs. Vous pouvez avoir des identificateurs portant le même nom que les mots clés ou les littéraux. Toutefois, nous vous recommandons d’éviter de le faire, car le référencement dans les requêtes nécessite un guillemet spécial.

Pour éviter d’utiliser un identificateur qui peut également être un mot clé de langage ou un littéral, tel que where, summarizeet 1day, vous pouvez choisir votre nom d’entité en fonction des conventions suivantes, qui ne s’appliquent pas aux mots clés de langue :

  • Utilisez un nom commençant par une lettre majuscule (A à Z).

  • Utilisez un nom qui commence ou se termine par un trait de soulignement unique (_).

    Remarque

    KQL réserve tous les identificateurs qui commencent ou se terminent par une séquence de deux caractères de soulignement (__) ; les utilisateurs ne peuvent pas définir de tels noms pour leur propre utilisation.

Pour plus d’informations sur la façon de référencer ces identificateurs, consultez Identificateurs de référence dans les requêtes.

Identificateurs de référence dans les requêtes

Le tableau suivant fournit une explication sur la façon de référencer des identificateurs dans les requêtes.

Type d’identificateur Identificateur Référence Explication
Normale entity entity Les identificateurs (entity) qui n’incluent pas de caractères spéciaux ou mappés à un mot clé de langue n’ont pas besoin d’être placés entre guillemets.
Caractère spécial entity-name ['entity-name'] Les noms d’identificateurs qui incluent des caractères spéciaux (tels que-) doivent être placés entre des caractères spéciaux à l’aide [' et '] ou à l’aide [" et ."]
mot clé language where ["where"] Les noms d’identificateurs qui sont des mots clés de langue doivent être placés entre des mots clés à l’aide [' et '] ou [" ."]
literal 1day ["1day"] Les noms d’identificateurs qui sont des littéraux doivent être placés entre guillemets à l’aide [' et '] ou [" ."]

Remarque

Les identificateurs respectent la casse. Par exemple, vous ne pouvez pas faire référence à une table appelée ThisTable thisTABLE.