Nombres de entidad

Se aplica a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

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. El nombre que asigna una entidad se denomina identificador. Además de las entidades, también puede asignar un identificador a los parámetros de consulta o a las 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, no se puede usar el nombre bonito para hacer referencia a la entidad.

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

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 se genera mediante un operador KQL.

Evitar nombres de 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 las 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 entidad según las siguientes convenciones, que no son aplicables a las palabras clave del lenguaje:

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

• Use un nombre que comience 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 dichos 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

• Tipos de entidad.
• Convenciones de sintaxis para la documentación de referencia.