Share via

Nomes de entidades

  • Artigo

As entidades kusto são referenciadas numa consulta por nome. As entidades que podem ser referenciadas pelo respetivo nome incluem bases de dados, tabelas, colunas e funções armazenadas, mas não clusters. O nome que atribui a uma entidade chama-se identificador. Além das entidades, também pode atribuir um identificador a parâmetros de consulta ou variáveis definidas através de uma instrução let.

O nome de uma entidade é exclusivo do tipo de entidade no contexto do respetivo contentor. Por exemplo, duas tabelas na mesma base de dados não podem ter o mesmo nome, mas uma base de dados e uma tabela podem ter o mesmo nome porque são tipos de entidade diferentes. Da mesma forma, uma tabela e uma função armazenada podem ter o mesmo nome.

Nota

Os nomes de entidades, que também são refletidos como um recurso do Azure, seguem as regras de palavras de reserva do ARM.

Nomes bonitos

Além do nome da entidade, algumas entidades podem ter um nome bonito. Semelhante à utilização de nomes de entidades, os nomes bonitos podem ser utilizados para referenciar uma entidade em consultas. Mas, ao contrário dos nomes de entidades, os nomes bonitos não são necessariamente exclusivos no contexto do contentor. Quando um contentor tem múltiplas entidades com o mesmo nome bonito, o nome bonito não pode ser utilizado para referenciar a entidade.

Os nomes bonitos permitem que as aplicações de camada média mapeiem nomes de entidades criados automaticamente (como UUIDs) para nomes legíveis por humanos para fins de apresentação e referência.

Para obter um exemplo sobre como atribuir um nome bonito, consulte o comando .alter database prettyname.

Regras de nomenclatura de identificador

Um identificador é o nome que atribui a entidades, parâmetros de consulta ou variável definidos através de uma instrução let. Os identificadores válidos têm de seguir estas regras:

  • Os identificadores são sensíveis às maiúsculas e minúsculas. Os nomes das bases de dados não são sensíveis a maiúsculas e minúsculas e, por conseguinte, uma exceção a esta regra.
  • Os identificadores têm de ter entre 1 e 1024 carateres de comprimento.
  • Os identificadores podem conter letras, dígitos e carateres de sublinhado (_).
  • Os identificadores podem conter determinados carateres especiais: espaços, pontos (.) e travessões (-). Para obter informações sobre como referenciar identificadores com carateres especiais, veja Reference identifiers in queries (Identificadores de referência em consultas).

Nota

  • Apenas são suportados os carateres UTF-8 especificados de letras, dígitos, carateres de sublinhado, pontos e travessões. Por exemplo, os pontos e vírgulas não são suportados.
  • O $ caráter é permitido em nomes de entidades quando gerado por um operador KQL.

Evite atribuir nomes a identificadores como palavras-chave de idioma ou literais

Na KQL, existem palavras-chave e literais que têm regras de nomenclatura semelhantes às dos identificadores. Pode ter identificadores com o mesmo nome que palavras-chave ou literais. No entanto, recomendamos que evite fazê-lo, uma vez que referenciá-los em consultas requer uma citação especial.

Para evitar utilizar um identificador que também pode ser uma palavra-chave de idioma ou literal, como where, summarizee 1day, pode escolher o nome da entidade de acordo com as seguintes convenções, que não são aplicáveis a palavras-chave de idioma:

  • Utilize um nome que comece com uma letra maiúscula (A para Z).

  • Utilize um nome que comece ou termine com um único caráter de sublinhado (_).

    Nota

    A KQL reserva todos os identificadores que começam ou terminam com uma sequência de dois carateres de sublinhado (__); os utilizadores não podem definir esses nomes para utilização própria.

Para obter informações sobre como referenciar estes identificadores, veja Reference identifiers in queries (Identificadores de referência em consultas).

Identificadores de referência em consultas

A tabela seguinte fornece uma explicação sobre como referenciar identificadores em consultas.

Tipo de identificador Identificador Referência Explicação
Normal entity entity Os identificadores (entity) que não incluem carateres especiais ou mapeiam para uma palavra-chave de idioma não precisam de estar entre aspas.
Caráter especial entity-name ['entity-name'] Os nomes dos identificadores que incluem carateres especiais (como -) têm de estar incluídos com [' e ou '] com [" e "].
palavra-chave do idioma where ["where"] Os nomes dos identificadores que são palavras-chave de idioma têm de estar incluídos com [' e ou '][" e "].
literal 1day ["1day"] Os nomes dos identificadores que são literais têm de estar incluídos com [' e ou '][" e "].

Nota

Os identificadores são sensíveis às maiúsculas e minúsculas. Por exemplo, não pode referir-se a uma tabela chamada ThisTablethisTABLE.

Conteúdo relacionado