Noms d’entité

  • Article

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

Le nom d’une entité est propre 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 il s’agit de types d’entités différents. De même, une table et une fonction stockée peuvent avoir le même nom.

Notes

Les noms d’entité, qui sont également répercutés en tant que ressource Azure, suivent les règles des 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 jolis noms peuvent être utilisés pour référencer une entité dans des requêtes. Mais contrairement aux noms d’entité, 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 joli 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 des noms d’entité créés automatiquement (tels que des UUID) à des noms lisibles par l’utilisateur à des fins d’affichage et de référencement.

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

Règles de nommage de l’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 constituent donc une exception à cette règle.
  • Les identificateurs doivent comporter 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.

Notes

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

Éviter de nommer des identificateurs en tant que mots clés ou littéraux de langue

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 des mots clés ou des littéraux. Toutefois, nous vous recommandons d’éviter de le faire, car les référencer dans les requêtes nécessite un guillemet spécial.

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

  • Utilisez un nom qui commence par une lettre majuscule (A à Z).

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

    Notes

    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 ces 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 des requêtes.

Type d’identificateur Identificateur Référence Explication
Normal entity entity Les identificateurs (entity) qui n’incluent pas de caractères spéciaux ou ne correspondent pas à certaines langues mot clé 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 en utilisant [' et '] ou en utilisant [" et "].
langue mot clé where ["where"] Les noms d’identificateurs qui sont des mots clés de langue doivent être inclus à l’aide de [' et '] ou [" et "].
littéral 1day ["1day"] Les noms d’identificateurs qui sont des littéraux doivent être inclus à l’aide de [' et '] ou [" et "].

Notes

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

Contenu connexe