Guia de início rápido: usar o Gerenciador de Pesquisa para executar consultas no portal do Azure

  • Artigo

Neste guia de início rápido, saiba como usar o Gerenciador de Pesquisa, uma ferramenta de consulta interna no portal do Azure usada para executar consultas em um índice de pesquisa no Azure AI Search. Use-o para testar uma consulta ou expressão de filtro ou confirmar se o conteúdo existe no índice.

Este guia de início rápido usa um índice existente para demonstrar o explorador de pesquisa.

Pré-requisitos

Antes de começar, tenha os seguintes pré-requisitos em vigor:

  • Uma conta do Azure com uma subscrição ativa. Crie uma conta gratuitamente.

  • Um serviço Azure AI Search. Crie um serviço ou encontre um serviço existente na sua subscrição atual. Você pode usar um serviço gratuito para este início rápido.

  • O realestate-us-sample-index é usado para este início rápido. Para criar o índice, use o assistente Importar dados, escolha os dados de exemplo internos e percorra o assistente usando todos os valores padrão.

    Screenshot of the sample data sets available in the Import data wizard.

Iniciar explorador de pesquisa

  1. No portal do Azure, abra a página de visão geral da pesquisa no painel ou localize seu serviço.

  2. Abra o explorador de Pesquisa a partir da barra de comandos:

    Screenshot of the Search explorer command in portal.

    Ou use a guia Explorador de pesquisa incorporado em um índice aberto:

    Screenshot of the Search explorer tab.

Consultar de duas maneiras

Há duas abordagens para consulta no Gerenciador de pesquisa.

  • A barra de pesquisa padrão aceita uma consulta vazia ou uma consulta de texto livre com booleanos. Por exemplo, seattle condo +parking.

  • A visualização JSON suporta consultas parametrizadas. Filtros, orderby, select, count, searchFields e todos os outros parâmetros devem ser definidos na visualização JSON.

    Alterne para o modo de exibição JSON para consultas parametrizadas. Os exemplos neste artigo assumem a exibição JSON por toda parte. Você pode colar exemplos JSON deste artigo na área de texto.

    Screenshot of the JSON view selector.

Executar uma consulta não especificada

No explorador de pesquisa, as solicitações POST são formuladas internamente usando a API REST POST de pesquisa, com respostas retornadas como documentos JSON detalhados.

Para uma primeira olhada no conteúdo, execute uma pesquisa vazia clicando em Pesquisar sem termos fornecidos. Uma pesquisa vazia é útil como uma primeira consulta porque retorna documentos inteiros para que você possa revisar a composição do documento. Em uma pesquisa vazia, não há pontuação de pesquisa e os documentos são retornados em ordem arbitrária ("@search.score": 1 para todos os documentos). Por padrão, 50 documentos são retornados em uma solicitação de pesquisa.

A sintaxe equivalente para uma pesquisa vazia é * ou "search": "*".

{
   "search": "*"
}

Resultados

Unqualified or empty query example

Pesquisa de texto livre

As consultas de forma livre, com ou sem operadores, são úteis para simular consultas definidas pelo usuário enviadas de um aplicativo personalizado para o Azure AI Search. Apenas os campos atribuídos como "pesquisáveis" na definição do índice são verificados em busca de correspondências.

Você não precisa da visualização JSON para uma consulta de texto livre, mas nós a fornecemos em JSON para consistência com outros exemplos neste artigo.

Observe que quando você fornece critérios de pesquisa, como termos de consulta ou expressões, a classificação de pesquisa entra em jogo. O exemplo a seguir ilustra uma pesquisa de texto livre. O "@search.score" é uma pontuação de relevância calculada para a partida usando o algoritmo de pontuação padrão.

{
    "search": "Seattle townhouse `Lake Washington` miele OR thermador appliance"
}

Resultados

Você pode usar Ctrl-F para pesquisar termos de interesse específicos nos resultados.

Screenshot of a free text query example.

Contagem de documentos correspondentes

Adicionar "count": true para obter o número de correspondências encontradas em um índice. Numa pesquisa vazia, contagem é o número total de documentos no índice. Em uma pesquisa qualificada, é o número de documentos que correspondem à entrada da consulta. Lembre-se de que o serviço retorna as 50 principais correspondências por padrão, portanto, a contagem pode indicar mais correspondências no índice do que o que é retornado nos resultados.

{
    "search": "Seattle townhouse `Lake Washington` miele OR thermador appliance",
    "count": true
}

Resultados

Screenshot of a count example.

Limitar campos nos resultados da pesquisa

Adicione "select"' para limitar os resultados aos campos explicitamente nomeados para uma saída mais legível no explorador de pesquisa. Apenas os campos marcados como "recuperáveis" no índice de pesquisa podem aparecer nos resultados.

{
   "search": "seattle condo",
   "count": true,
   "select": "listingId, beds, baths, description, street, city, price"
}

Resultados

Screenshot of restrict fields in search results example.

Retornar o próximo lote de resultados

O Azure AI Search retorna as 50 principais correspondências com base na classificação de pesquisa. Para obter o próximo conjunto de documentos correspondentes, anexe "top": 100 e "skip": 50 aumente o conjunto de resultados para 100 documentos (o padrão é 50, o máximo é 1000), ignorando os primeiros 50 documentos. Você pode verificar a chave do documento (listingID) para identificar um documento.

Lembre-se de que você precisa fornecer critérios de pesquisa, como um termo ou expressão de consulta, para obter resultados classificados. Observe que as pontuações de pesquisa diminuem quanto mais você se aprofunda nos resultados da pesquisa.

{
   "search": "seattle condo",
   "count": true,
   "select": "listingId, beds, baths, description, street, city, price",
   "top": 100,
   "skip": 50
}

Resultados

Screenshot of returning next batch of search results example.

Filtrar expressões (maior que, menor que, igual a)

Use o parâmetro para especificar critérios filter de inclusão ou exclusão. O campo deve ser atribuído como "filtrável" no índice. Este exemplo procura quartos maiores que 3:

{
    "search": "seattle condo",
    "count": true,
    "select": "listingId, beds, baths, description",
    "filter": "beds gt 3"
}

Resultados

Screenshot of a filter example.

Ordenar resultados

Adicionar orderby para classificar os resultados por outro campo além da pontuação de pesquisa. O campo deve ser atribuído como "classificável" no índice. Em situações em que o valor filtrado é idêntico (por exemplo, mesmo preço), a ordem é arbitrária, mas você pode adicionar mais critérios para uma classificação mais profunda. Um exemplo de expressão que você pode usar para testar isso é:

{
    "search": "seattle condo",
    "count": true,
    "select": "listingId, price, beds, baths, description",
    "filter": "beds gt 3",
    "orderby": "price asc"
}

Resultados

Screenshot of a sorting example.

Conclusões

Neste início rápido, você usou o explorador de pesquisa para consultar um índice usando a API REST.

  • Os resultados são retornados como documentos JSON detalhados para que você possa visualizar a construção e o conteúdo do documento, na íntegra. O select parâmetro em uma expressão de consulta pode limitar quais campos são retornados.

  • Os resultados da pesquisa são compostos por todos os campos marcados como "recuperáveis" no índice. Selecione a guia Campos adjacente para revisar os atributos.

  • A pesquisa por palavras-chave, semelhante ao que você pode inserir em um navegador da Web comercial, é útil para testar a experiência do usuário final. Por exemplo, supondo o índice de amostra de imóveis incorporado, você pode digitar "Seattle apartments lake washington" e, em seguida, usar Ctrl-F para encontrar termos nos resultados da pesquisa.

  • As expressões de consulta e filtro são articuladas em uma sintaxe implementada pelo Azure AI Search. O padrão é uma sintaxe simples, mas você pode, opcionalmente, usar o Lucene completo para consultas mais poderosas. As expressões de filtro são articuladas em uma sintaxe OData.

Clean up resources (Limpar recursos)

Quando você está trabalhando em sua própria assinatura, é uma boa ideia no final de um projeto decidir se você ainda precisa dos recursos que criou. Os recursos que deixar em execução podem custar dinheiro. Pode eliminar recursos individualmente ou eliminar o grupo de recursos para eliminar todo o conjunto de recursos.

Você pode encontrar e gerenciar recursos no portal, usando o link Todos os recursos ou Grupos de recursos no painel de navegação esquerdo.

Se você estiver usando um serviço gratuito, lembre-se de que está limitado a três índices, indexadores e fontes de dados. Você pode excluir itens individuais no portal para ficar abaixo do limite.

Próximos passos

Para saber mais sobre estruturas de consulta e sintaxe, use um cliente REST para criar expressões de consulta que usam mais partes da API. A Search POST REST API é especialmente útil para aprendizagem e exploração.

Criar uma consulta básica em REST