Linguagem de consulta Kusto para o Azure Resource Graph: um guia para iniciantes

By Mirko Peters · 2026-10-21

Domine a Kusto Query Language (KQL) para o Azure Resource Graph. Aprenda uma sintaxe simples, filtros em pipeline, pipes e consultas para gerenciar o seu ambiente em nuvem.

Automatically translated with AI from the original post. Read the English original

Dominar a Kusto Query Language (KQL) para o Azure Resource Graph permite que administradores de nuvem escrevam consultas limpas e extremamente rápidas, que apresentam com facilidade o inventário de nuvem, os riscos de segurança e a conformidade de governança em várias assinaturas, sem depender de cliques manuais no portal.

Principais conclusões

• Consultas KQL se parecem com uma receita, usando o caractere pipe (|) para encadear etapas sequenciais de processamento de dados.
• A tabela padrão 'resources' contém a maior parte do que você precisa consultar em várias assinaturas do Azure ao mesmo tempo.
• Usar os operadores project e extend ajuda a limpar resultados desorganizados e extrair valores de propriedades aninhadas sem excesso de código.
• O Resource Graph limita os resultados a 1.000 registros por padrão, como uma proteção, exigindo tokens de paginação para ambientes muito grandes.
• As habilidades em KQL aprendidas no Azure Resource Graph se aplicam diretamente ao Log Analytics e ao Azure Data Explorer.

Desmistificando o KQL no Azure Resource Graph

Quando você encontra a Kusto Query Language (KQL) pela primeira vez, a sigla pode parecer intimidadora. No entanto, ao deixar de lado o jargão técnico, surge uma sintaxe surpreendentemente acessível e parecida com o inglês, projetada para tornar a consulta à infraestrutura de nuvem intuitiva. Diferentemente de escrever aplicações complexas ou scripts pesados, a KQL se concentra em fazer perguntas e recuperar dados estruturados.

Toda pergunta que você faz no Azure Resource Graph é construída com KQL. Se você já usou o Azure Data Explorer ou o Log Analytics, essa sintaxe vai parecer imediatamente familiar. Mas mesmo que você esteja começando do zero, a curva de aprendizado é surpreendentemente suave. Você pode aprender o conjunto essencial de KQL necessário para o gerenciamento diário da nuvem em uma única sessão.

A anatomia de uma consulta KQL

Uma consulta KQL se lê como uma receita passo a passo. O segredo dessa legibilidade é o caractere pipe (|), que separa cada instrução individual. Você começa com uma tabela base de dados e a encaminha por meio de comandos subsequentes que restringem, filtram ou reestruturam a saída.

Leia uma consulta KQL de cima para baixo e ela soa quase como inglês simples. Por exemplo, considere a consulta mais simples e útil que você pode escrever:

resources | summarize count

Lida em voz alta, esse comando significa: pegue tudo na tabela padrão resources e me dê uma contagem. O sistema responde com um único número muito valioso, que representa a escala total do seu patrimônio em nuvem.

Operadores essenciais para administradores de nuvem

Depois de dominar a contagem dos seus ativos, você vai querer filtrar e formatar os dados. Alguns operadores fundamentais fazem o trabalho pesado em quase toda consulta administrativa:

• where: Filtra o seu conjunto de dados com base em condições específicas. Por exemplo, alterar a sua consulta para resources | where type == "Microsoft.Compute/virtualMachines" restringe a contagem estritamente às máquinas virtuais.
• project: Escolhe quais colunas específicas aparecem na saída final, permitindo exibir apenas o nome do recurso, a localização e o ID da assinatura, em vez de um enorme volume de JSON bruto.
• order by: Ordena os resultados alfabética ou numericamente, transformando um despejo de dados aleatório em uma tabela organizada e fácil de examinar.
• extend: Cria uma coluna personalizada temporária, permitindo extrair valores de configuração profundamente aninhados e atribuir a eles rótulos curtos e reutilizáveis.

Evitando armadilhas comuns do KQL

Embora o KQL seja tolerante em alguns aspectos, ele tem regras rígidas em relação a maiúsculas e minúsculas. O operador de correspondência que não diferencia maiúsculas de minúsculas (escrito como um sinal de igual seguido de til, como =~) ignora essa diferença sem problemas quando você pesquisa valores de texto, como tipos de recurso. No entanto, os nomes de propriedades são outra história. Se você escrever errado um nome de propriedade ou usar maiúsculas e minúsculas incorretas, o KQL não exibirá um erro de sintaxe evidente; em vez disso, ele retornará silenciosamente valores em branco, deixando você procurando um bug que não existe na sua lógica.

Explorando tabelas além do básico

Embora a tabela resources atenda à grande maioria das verificações administrativas do dia a dia, existem tabelas especializadas para trabalhos de governança mais profundos. Quando você precisar auditar posturas de segurança, revisar atribuições de política ou inspecionar seus contêineres organizacionais, como grupos de gerenciamento, assinaturas e grupos de recursos, você pode direcionar suas consultas KQL diretamente para essas tabelas dedicadas.

Como o KQL é um padrão transversal no ecossistema Microsoft, dominar esses padrões representa um multiplicador de carreira imediato. As consultas que você escreve hoje para limpar grupos de segurança de rede órfãos ou identificar máquinas virtuais sem tags serão igualmente úteis ao criar alertas de segurança no Microsoft Defender ou ao montar painéis operacionais no Log Analytics.

Conclusão e próximos passos

Aprender a Kusto Query Language transforma o Azure Resource Graph de um mecanismo misterioso em segundo plano na sua ferramenta favorita de gerenciamento de nuvem no dia a dia. Ao substituir cliques tediosos no portal e scripts frágeis por consultas concisas e legíveis, você ganha visibilidade total sobre seu ambiente com várias assinaturas.

Para se aprofundar em como simplificar seus fluxos de administração da nuvem, ouça o episódio completo para mais insights de especialistas, exemplos práticos e orientações hands-on sobre como fazer o Azure Resource Graph funcionar para a sua organização.

Perguntas frequentes

O que é KQL e por que ele é usado no Azure Resource Graph?

KQL significa Kusto Query Language. É uma linguagem de consulta leve e intuitiva usada para fazer perguntas sobre o seu ambiente Azure no Resource Graph. Ela permite filtrar, ordenar e agrupar milhares de recursos da nuvem instantaneamente, usando uma sintaxe legível baseada em pipes.

Como filtro recursos por tipo usando KQL?

Você pode filtrar recursos adicionando uma cláusula 'where' após a declaração inicial da tabela. Por exemplo, escrever 'resources | where type =~ "microsoft.keyvault/vaults"' retornará apenas os seus Azure Key Vaults.

Por que minha consulta KQL retorna valores em branco em vez de um erro?

Nomes de propriedades no KQL diferenciam maiúsculas de minúsculas. Se você escrever um nome de propriedade com maiúsculas e minúsculas incorretas, o Azure Resource Graph não exibirá um erro de sintaxe; em vez disso, retornará silenciosamente valores em branco, o que torna a depuração complicada.

O que é o limite de 1.000 registros no Azure Resource Graph?

Por padrão, uma consulta ao resource graph retorna no máximo 1.000 registros, para evitar que usuários baixem conjuntos de dados muito grandes por acidente. Você pode ignorar esse limite ou paginar os resultados usando tokens de continuação, caso seu ambiente contenha milhares de recursos.