Partilhar via


Usar o editor de KQL para criar consultas de pesquisas

Dica

A Deteção de Dados Eletrónicos (pré-visualização) está agora disponível no novo portal do Microsoft Purview. Para saber mais sobre como utilizar a nova experiência de Deteção de Dados Eletrónicos, veja Saiba mais sobre a Deteção de Dados Eletrónicos (pré-visualização).

A opção de consulta linguagem KQL (Keyword Query Language) na pesquisa de ferramentas Descoberta Eletrônica do Microsoft Purview fornece feedback e orientação quando cria consultas de pesquisa na Pesquisa de conteúdos, Descoberta Eletrônica do Microsoft Purview (Standard) e Deteção de Dados Eletrónicos (Premium). Quando introduz consultas no editor, esta fornece a conclusão automática para as propriedades e condições pesquisáveis suportadas e fornece listas de valores suportados para propriedades e condições padrão. Por exemplo, se especificar a kind propriedade de e-mail na sua consulta, o editor apresentará uma lista dos valores suportados que pode selecionar. O editor de KQL também apresenta potenciais erros de consulta em tempo real que pode corrigir antes de executar a pesquisa. O melhor de tudo é que pode colar consultas complexas diretamente no editor sem ter de criar manualmente consultas com os cartões de palavras-chave e condições no construtor de condições padrão.

Eis as principais vantagens da utilização do editor de KQL:

  • Fornece orientações e ajuda-o a criar consultas de pesquisa do zero.
  • Permite-lhe colar rapidamente consultas longas e complexas diretamente no editor. Por exemplo, se receber uma consulta complexa do advogado opositor, pode colá-la no editor de KQL em vez de ter de utilizar o construtor de condições.
  • Identifica rapidamente potenciais erros e apresenta sugestões sobre como resolve problemas.

O editor de KQL também está disponível quando cria suspensões baseadas em consultas na Deteção de Dados Eletrónicos (Standard) e na Deteção de Dados Eletrónicos (Premium).

Dica

Se você não é um cliente E5, use a avaliação das soluções do Microsoft Purview de 90 dias para explorar como os recursos adicionais do Purview podem ajudar sua organização a gerenciar as necessidades de segurança e conformidade de dados. Comece agora no hub de avaliações do Microsoft Purview. Saiba mais detalhes sobre os termos de inscrição e avaliação.

Apresentar o editor de KQL

Quando cria ou edita uma pesquisa de Deteção de Dados Eletrónicos, a opção para apresentar e utilizar o editor de KQL está localizada na página Condições no fluxo de trabalho de pesquisa ou coleções.

Editor de KQL na Pesquisa de conteúdos e Deteção de Dados Eletrónicos (Standard)

Editor de KQL na Pesquisa de conteúdos e Deteção de Dados Eletrónicos (Standard)

Editor de KQL na Deteção de Dados Eletrónicos (Premium)

Editor de KQL na Deteção de Dados Eletrónicos (Premium)

Utilizar o editor de KQL

As secções seguintes mostram exemplos de como o editor de KQL fornece sugestões e deteta potenciais erros.

Conclusão automática de propriedades e operadores de pesquisa

Quando começa a introduzir uma consulta de pesquisa no editor KQL, o editor apresenta a conclusão automática sugerida das propriedades de pesquisa suportadas (também denominadas restrições de propriedades) que pode selecionar. Tem de escrever um mínimo de dois carateres para apresentar uma lista de propriedades suportadas que começam com esses dois carateres. Por exemplo, a seguinte captura de ecrã mostra as propriedades de pesquisa sugeridas que começam com Se.

O editor de KQL sugere propriedades suportadas

Além disso, o editor também sugere que forneça uma lista de operadores suportados (como :, = e <>) quando escreve um nome de propriedade completo. Por exemplo, a seguinte captura de ecrã mostra os operadores sugeridos para a Date propriedade .

Editor de KQL sugere operadores

Para obter mais informações sobre as propriedades e operadores de pesquisa suportados, veja Consultas de palavras-chave e condições de pesquisa para Deteção de Dados Eletrónicos.

Sugestões de valor de propriedade

O editor de KQL fornece sugestões para valores possíveis de algumas propriedades. Por exemplo, a seguinte captura de ecrã mostra os valores sugeridos para a Kind propriedade.

O editor de KQL sugere valores para algumas propriedades

O editor também sugere uma lista de utilizadores (no formato UPN) quando escreve as propriedades do destinatário do e-mail, como From, ToRecipients e Participants.

O editor de KQL sugere aos utilizadores as propriedades de e-mail dos destinatários

Deteção de potenciais erros

O editor de KQL deteta potenciais erros nas consultas de pesquisa e fornece uma sugestão do que está a causar o erro para ajudá-lo a resolve o erro. O editor também indica um potencial erro quando uma propriedade não tem uma operação ou valor correspondente. Os potenciais erros na consulta são realçados em texto vermelho e as explicações e possíveis correções do erro são apresentadas na secção pendente Potenciais erros .

Importante

As aspas aninhadas não são suportadas no editor de KQL.

Por exemplo, se colou a seguinte consulta no editor de KQL, serão detetados quatro potenciais erros.

Deteção de erros do editor de KQL

Neste caso, pode utilizar as potenciais sugestões de erro para resolver problemas e corrigir a consulta.

Mais informações

  • Pode alternar entre o construtor de condições e o editor de KQL. Por exemplo, se utilizar o construtor de condições para configurar uma consulta com a caixa Palavras-chave e vários cartões de condição, pode apresentar a consulta resultante no editor de KQL. No entanto, se criar uma consulta complexa (com palavras-chave e condições) no editor de KQL, a consulta resultante só será apresentada na caixa Palavras-chave quando a visualizar no construtor de condições.

  • Se colar uma consulta complexa no editor de KQL, o editor deteta potenciais erros e sugere possíveis soluções para resolve erros.