Compartilhar via

Tipos de declaração de consulta

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

Uma consulta consiste em uma ou mais instruções de consulta, delimitadas por um ponto-e-vírgula (;). Pelo menos uma dessas instruções de consulta deve ser uma instrução de expressão tabular. A instrução de expressão tabular gera um ou mais resultados tabulares. Duas instruções devem ser sempre separadas por ponto e vírgula. Quando a consulta tem mais de uma instrução de expressão tabular, a consulta tem um lote de instruções de expressão tabular e os resultados tabulares gerados por essas instruções são todos retornados pela consulta.

Dois tipos de instruções de consulta:

Algumas instruções de consulta são úteis em ambos os cenários.

Observação

O "efeito" de uma instrução de consulta começa no ponto em que a instrução aparece na consulta e termina no final da consulta. Depois que a consulta é concluída, todos os seus recursos são liberados e ela não tem impacto em consultas futuras (exceto efeitos colaterais, como ter a consulta registrada em um log de todas as consultas executadas ou ter seus resultados armazenados em cache).

Instruções de consulta do usuário

A seguir está uma lista de instruções de consulta do usuário:

  • Uma instrução let define uma associação entre um nome e uma expressão. As instruções let podem ser usadas para dividir uma consulta longa em pequenas partes nomeadas que são mais fáceis de entender.

  • Uma instrução set define uma propriedade de solicitação que afeta como a consulta é processada e seus resultados retornados.

  • Uma instrução de expressão tabular, a instrução de consulta mais importante, retorna os dados "interessantes" de volta como resultados.

Instruções de consulta de aplicativo

Veja a seguir uma lista de instruções de consulta de aplicativo:

  • Uma instrução alias define um alias para outro banco de dados (no mesmo cluster ou em um cluster remoto).

  • Uma instrução de padrão, que pode ser usada por aplicativos criados com base no Kusto e expõem a linguagem de consulta a seus usuários para se injetarem no processo de resolução de nomes de consulta.

  • Uma instrução de parâmetros de consulta, que é usada por aplicativos criados com base no Kusto para se protegerem contra ataques de injeção (semelhante a como os parâmetros de comando protegem o SQL contra ataques de injeção de SQL).

  • Uma instrução restrict, que é usada por aplicativos criados com base no Kusto para restringir consultas a um subconjunto específico de dados no Kusto (incluindo a restrição de acesso a colunas e registros específicos).