Consultar dados em um índice da Pesquisa de IA do Azure

Concluído

Os designs de índice e de consulta estão intimamente relacionados. Depois de criarmos o índice, poderemos executar consultas. É importante entender que o esquema de índice determina quais consultas podem ser respondidas.

As consultas da Pesquisa de IA do Azure podem ser enviadas como uma solicitação de API REST ou HTTP, com a resposta fornecida como JSON. As consultas podem especificar quais campos são pesquisados e retornados, como os resultados da pesquisa são formatados e como os resultados devem ser filtrados ou classificados. Uma consulta que não especifica o campo a ser pesquisado será executada em todos os campos pesquisáveis no índice.

A Pesquisa de IA do Azure dá suporte a dois tipos de sintaxe: simples e Lucene completa. A sintaxe simples abrange todos os cenários comuns de consulta, enquanto o Lucene completo é útil para cenários avançados.

Solicitações de consulta simples

Uma solicitação de consulta é uma lista ou palavras (termos de pesquisa) e operadores de consulta (simples ou completos) daquilo que você gostaria que fosse retornado em um conjunto de resultados. Vamos examinar quais componentes formam uma consulta de pesquisa. Considere este exemplo de pesquisa simples:

coffee (-"busy" + "wifi")

Essa consulta está tentando encontrar um conteúdo sobre café, excluindo "movimentado" e incluindo "Wi-Fi".

Dividindo a consulta em componentes, ela é composta por termos de pesquisa (coffee), por duas frases textuais, "busy" e "wifi", e por operadores (-, +, e ( )). É possível encontrar uma correspondência para os termos de pesquisa no índice de pesquisa em qualquer ordem ou localização no conteúdo. As duas frases corresponderão exatamente ao que for especificado. Portanto, wi-fi não será uma correspondência. Por fim, uma consulta pode conter vários operadores. Nesse exemplo, o operador - informa ao mecanismo de pesquisa que essas frases NÃO devem estar nos resultados. Os parênteses agrupam os termos e definem a precedência deles.

Por padrão, o mecanismo de pesquisa corresponderá a qualquer um dos termos na consulta. Um conteúdo que tenha apenas coffee será uma correspondência. Neste exemplo, o uso de -"busy" levará a resultados da pesquisa, incluindo todo o conteúdo que não tenha a cadeia de caracteres exata "movimentado".

A sintaxe de consulta simples na Pesquisa de IA do Azure exclui alguns dos recursos mais complexos da sintaxe de consulta Lucene completa e é a sintaxe de pesquisa padrão para consultas.

Saiba mais sobre a sintaxe de consulta na documentação.