Nombres de entidad

  • Artículo

Se hace referencia a las entidades de Kusto en una consulta por nombre. Las entidades a las que se puede hacer referencia por su nombre incluyen bases de datos, tablas, columnas y funciones almacenadas, pero no clústeres. El nombre que asigna una entidad se denomina identificador. Además de las entidades, también puede asignar un identificador a parámetros de consulta o variables establecidas a través de una instrucción let.

El nombre de una entidad es único para el tipo de entidad en el contexto de su contenedor. Por ejemplo, dos tablas de la misma base de datos no pueden tener el mismo nombre, pero una base de datos y una tabla pueden tener el mismo nombre porque son diferentes tipos de entidad. De forma similar, una tabla y una función almacenada pueden tener el mismo nombre.

Nota

Los nombres de entidad, que también se reflejan como un recurso de Azure, siguen las reglas de palabras reservadas de ARM.

Nombres bonitos

Además del nombre de la entidad, algunas entidades pueden tener un nombre bonito. De forma similar al uso de nombres de entidad, se pueden usar nombres bonitos para hacer referencia a una entidad en las consultas. Pero a diferencia de los nombres de entidad, los nombres bonitos no son necesariamente únicos en el contexto de su contenedor. Cuando un contenedor tiene varias entidades con el mismo nombre bonito, no se puede usar el nombre bonito para hacer referencia a la entidad.

Los nombres bonitos permiten a las aplicaciones de nivel intermedio asignar nombres de entidad creados automáticamente (como UUID) a nombres que son legibles para mostrar y hacer referencia a ellas.

Para obtener un ejemplo sobre cómo asignar un nombre bonito, consulte el comando .alter database prettyname.

Reglas de nomenclatura de identificadores

Un identificador es el nombre que se asigna a entidades, parámetros de consulta o variable establecidos a través de una instrucción let. Los identificadores válidos deben seguir estas reglas:

  • Los identificadores distinguen mayúsculas de minúsculas. Los nombres de base de datos no distinguen mayúsculas de minúsculas y, por tanto, una excepción a esta regla.
  • Los identificadores deben tener entre 1 y 1024 caracteres.
  • Los identificadores pueden contener letras, dígitos y caracteres de subrayado (_).
  • Los identificadores pueden contener determinados caracteres especiales: espacios, puntos (.) y guiones (-). Para obtener información sobre cómo hacer referencia a identificadores con caracteres especiales, consulte Identificadores de referencia en consultas.

Nota

  • Solo se admiten los caracteres UTF-8 especificados de letras, dígitos, caracteres de subrayado, puntos y guiones especificados. Por ejemplo, no se admiten puntos y comas ni dos puntos.
  • El $ carácter se permite en los nombres de entidad cuando los genera un operador KQL.

Evite asignar nombres a identificadores como palabras clave de lenguaje o literales

En KQL, hay palabras clave y literales que tienen reglas de nomenclatura similares como identificadores. Puede tener identificadores con el mismo nombre que palabras clave o literales. Sin embargo, se recomienda evitar hacerlo, ya que hacer referencia a ellos en las consultas requiere comillas especiales.

Para evitar el uso de un identificador que también puede ser una palabra clave de lenguaje o literal, como where, summarizey 1day, puede elegir el nombre de la entidad según las siguientes convenciones, que no son aplicables a las palabras clave del lenguaje:

  • Use un nombre que comience con una letra mayúscula (A a Z).

  • Use un nombre que inicie o termine con un único carácter de subrayado (_).

    Nota

    KQL reserva todos los identificadores que comienzan o terminan con una secuencia de dos caracteres de subrayado (__); los usuarios no pueden definir estos nombres para su propio uso.

Para obtener información sobre cómo hacer referencia a estos identificadores, consulte Identificadores de referencia en consultas.

Identificadores de referencia en consultas

En la tabla siguiente se proporciona una explicación sobre cómo hacer referencia a identificadores en consultas.

Tipo de identificador Identificador Referencia Explicación
Normal entity entity Los identificadores (entity) que no incluyen caracteres especiales ni se asignan a alguna palabra clave de lenguaje no necesitan incluirse entre comillas.
Carácter especial entity-name ['entity-name'] Los nombres de identificadores que incluyen caracteres especiales (como -) se deben incluir mediante [' y '] o mediante [" y ."]
palabra clave language where ["where"] Los nombres de identificador que son palabras clave de lenguaje deben incluirse mediante [' y o '][" y "].
Literal 1day ["1day"] Los nombres de identificador que son literales deben incluirse mediante [' y o '][" y "].

Nota

Los identificadores distinguen mayúsculas de minúsculas. Por ejemplo, no puede hacer referencia a una tabla denominada ThisTable como thisTABLE.

Contenido relacionado