Nomes de entidades

  • Artigo

Aplica-se a: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel

As entidades Kusto são referenciadas em uma consulta por nome. As entidades que podem ser referenciadas por seu nome incluem bancos de dados, tabelas, colunas e funções armazenadas, mas não clusters. O nome que você atribui a uma entidade é chamado de identificador. Além das entidades, você também pode atribuir um identificador a parâmetros de consulta ou variáveis definidas por meio de uma instrução let.

As entidades Kusto são referenciadas em uma consulta por nome. As entidades que podem ser referenciadas por seu nome incluem bancos de dados, tabelas, colunas e funções armazenadas. O nome que você atribui a uma entidade é chamado de identificador. Além das entidades, você também pode atribuir um identificador a parâmetros de consulta ou variáveis definidas por meio de uma instrução let.

O nome de uma entidade é exclusivo para o tipo de entidade no contexto de seu contêiner. Por exemplo, duas tabelas no mesmo banco de dados não podem ter o mesmo nome, mas um banco 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.

Observação

Os nomes de entidade, 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 ao uso de nomes de entidade, nomes bonitos podem ser usados para fazer referência a uma entidade em consultas. Mas, ao contrário dos nomes de entidade, os nomes bonitos não são necessariamente exclusivos no contexto de seu contêiner. Quando um contêiner tem várias entidades com o mesmo nome bonito, o nome bonito não pode ser usado para fazer referência à entidade.

Nomes bonitos permitem que aplicativos de camada intermediária mapeiem nomes de entidade criados automaticamente (como UUIDs) para nomes legíveis para fins de exibição e referência.

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

Regras de nomenclatura de identificador

Um identificador é o nome que você atribui a entidades, parâmetros de consulta ou variável definida por meio de uma instrução let. Os identificadores válidos devem seguir estas regras:

  • Os identificadores diferenciam maiúsculas de minúsculas. Os nomes de banco de dados não diferenciam maiúsculas de minúsculas e, portanto, uma exceção a essa regra.
  • Os identificadores devem ter entre 1 e 1024 caracteres.
  • Os identificadores podem conter letras, dígitos e sublinhados (_).
  • Os identificadores podem conter certos caracteres especiais: espaços, pontos (.) e traços (-). Para obter informações sobre como fazer referência a identificadores com caracteres especiais, consulte Referenciar identificadores em consultas.

Observação

  • Somente os caracteres UTF-8 especificados de letras, dígitos, sublinhados, pontos e traços são suportados. Por exemplo, ponto e vírgula e dois pontos não são suportados.
  • O $ caractere é permitido em nomes de entidade quando gerado por um operador KQL.

Evite nomear identificadores como palavras-chave ou literais de idioma

No KQL, há palavras-chave e literais que têm regras de nomenclatura semelhantes às dos identificadores. Você pode ter identificadores com o mesmo nome de palavras-chave ou literais. No entanto, recomendamos que você evite fazer isso, pois referenciá-los em consultas requer aspas especiais.

Para evitar o uso de um identificador que também pode ser uma palavra-chave de idioma ou literal, como where, summarizee 1day, você 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:

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

  • Use um nome que comece ou termine com um único sublinhado (_).

    Observação

    O KQL reserva todos os identificadores que começam ou terminam com uma sequência de dois caracteres sublinhados (__); os usuários não podem definir esses nomes para seu próprio uso.

Para obter informações sobre como fazer referência a esses identificadores, consulte Identificadores de referência em consultas.

Identificadores de referência em consultas

A tabela a seguir fornece uma explicação sobre como fazer referência a identificadores em consultas.

Tipo de identificador Identificador Referência Explicação
Normal entity entity Os identificadores (entity) que não incluem caracteres especiais ou mapeiam para alguma palavra-chave de idioma não precisam ser colocados entre aspas.
Caractere especial entity-name ['entity-name'] Os nomes de identificadores que incluem caracteres especiais (como -) devem ser colocados entre os seguintes caracteres usando [' e '] /ou usando [" e "].
palavra-chave language where ["where"] Os nomes de identificadores que são palavras-chave de idioma devem ser colocados entre links e [' ou '] [" e ."]
literal 1day ["1day"] Os nomes de identificadores que são literais devem ser colocados entre eles usando [' e '] ou e [" ."]

Observação

Os identificadores diferenciam maiúsculas de minúsculas. Por exemplo, você não pode se referir a uma tabela chamada ThisTable thisTABLE.

Conteúdo relacionado