Início Rápido: Usar o Gerenciador de pesquisa para executar consultas no portal do Azure

Neste início rápido, você aprenderá a usar o Search Explorer, uma ferramenta de consulta interna no portal do Azure para executar consultas em um índice do Azure AI Search. Use essa ferramenta para testar uma expressão de consulta ou filtro ou para confirmar se o conteúdo existe no índice.

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

Pré-requisitos

• Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.

• Um serviço da Pesquisa de IA do Azure. Crie um serviço ou localize um serviço existente em sua assinatura atual. Para este início rápido, você pode usar um serviço gratuito.

• Este início rápido usa o índice realestate-us-sample. Para criar o índice, execute o Assistente de Importação de Dados, selecione os dados de exemplo incorporados e avance no assistente usando todos os valores padrão.

  

Iniciar o Gerenciador de pesquisa

1. Entre no portal do Azure e selecione seu serviço de pesquisa.

2. No painel esquerdo, selecione Visão geral.

3. Na barra de comandos, selecione Gerenciador de Pesquisa.

   

   Como alternativa, selecione a guia Gerenciador de Pesquisa na página de índice.

   

Consultar três maneiras

Há três abordagens para consultar no Gerenciador de Pesquisa:

• O modo de exibição de consulta fornece uma barra de pesquisa padrão. Ele aceita uma consulta vazia ou uma consulta de texto livre com boolianos, como seattle condo + parking.

• O modo de exibição de imagem fornece uma janela para navegar ou arrastar e soltar arquivos PNG, JPG ou JPEG. A menos que seu índice tenha um vetorizador de imagem e uma habilidade equivalente, essa exibição não estará disponível.

• A exibição JSON dá suporte a consultas parametrizadas. Filtros, orderby, select, count, searchFields e todos os outros parâmetros devem ser definidos na exibição JSON.

  

Exemplo: Consulta de imagem

Explorador de Pesquisa aceita imagens como entradas de consulta por meio da Visualização de imagem, o que exige a utilização de um par vetorizador–habilidade compatível. Para obter mais informações, consulte Configurar um vetorizador em um índice de pesquisa.

O índice realestate-us-sample não está configurado para vetorização de imagem. Se você quiser executar consultas de imagem, crie um índice conforme descrito no Início Rápido: Pesquisa de vetor no portal do Azure. O início rápido depende de dados de exemplo baseados em texto, portanto, você deve usar documentos que contenham imagens.

Para executar uma consulta de imagem, selecione ou arraste uma imagem para a área de pesquisa e selecione Pesquisar. O Gerenciador de Pesquisa vetoriza a imagem e envia o vetor para o mecanismo de pesquisa para execução de consulta. O mecanismo de pesquisa retorna documentos suficientemente semelhantes à imagem de entrada, até o número especificado k de resultados.

Exemplos: consultas JSON

Veja a seguir exemplos de consultas JSON que você pode executar usando o Gerenciador de Pesquisa. Para seguir esses exemplos, alterne para o modo de exibição JSON. Você pode colar cada exemplo JSON na área de texto.

Realize uma consulta não especificada

No Explorador de Pesquisa, as solicitações POST são formuladas internamente usando Documentos – Postagem de Pesquisa (API REST), com as respostas retornadas como documentos JSON detalhados.

Para obter uma primeira olhada no conteúdo, execute uma pesquisa vazia selecionando Pesquisar sem termos fornecidos. Uma pesquisa vazia é útil como uma primeira consulta porque ela retorna documentos inteiros para que você possa examinar a composição do documento. Em uma pesquisa vazia, não há nenhuma 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 por solicitação de pesquisa.

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

{
   "search": "*",
   "count": true
}

Resultados

Executar uma consulta de texto livre

A pesquisa de formulário livre, com ou sem operadores, é útil para simular consultas definidas pelo usuário enviadas de um aplicativo personalizado para o Azure AI Search. Somente os campos atribuídos como pesquisáveis no índice são verificados quanto às correspondências.

Você não precisa da exibição JSON para uma consulta de texto livre, mas fornecemos no JSON para consistência com outros exemplos neste artigo.

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

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

Resultados

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

Contar documentos correspondentes

Adicione "count": true para obter o número de correspondências encontradas em um índice. Em uma pesquisa vazia, a 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 as retornadas nos resultados.

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

Resultados

Limitar campos nos resultados da pesquisa

Adicione "select" para limitar os resultados aos campos explicitamente nomeados para uma saída mais legível no Gerenciador de Pesquisa. Somente os campos atribuídos como recuperáveis no índice podem aparecer em resultados.

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

Resultados

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, acrescente "top": 100 e "skip": 50 para aumentar 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 os resultados classificados. As pontuações de pesquisa diminuem quanto mais você avança nos resultados da pesquisa.

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

Resultados

Expressões de filtro (maior que, menor que, igual a)

Use o parâmetro filter para especificar critérios de inclusão ou exclusão. O campo deve ser definido como filtrável no índice. Este exemplo procura por quartos maiores que três:

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

Resultados

Classificar resultados

Adicione 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, o mesmo preço), a ordem é arbitrária, mas você pode adicionar mais critérios para uma classificação mais profunda. Aqui está uma expressão de exemplo 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

Observações

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

• Os resultados são retornados como documentos JSON detalhados para que você possa exibir a construção e o conteúdo de cada documento em sua totalidade. O select parâmetro em uma expressão de consulta limita quais campos são retornados.

• Os resultados da pesquisa são compostos por todos os campos atribuídos como recuperáveis no índice. Selecione a guia Campos para examinar atributos.

• A pesquisa de palavra-chave, semelhante ao que você pode inserir em um navegador da Web comercial, é útil para testar uma experiência do usuário final. Por exemplo, supondo o índice interno realestate-us-sample, você pode inserir "Seattle apartments lake washington", e, em seguida, pode usar Ctrl-F para encontrar termos dentro dos resultados da pesquisa.

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

Limpar os recursos

Quando você trabalha em sua própria assinatura, é uma boa ideia, ao final de um projeto, identificar se ainda precisa dos recursos que criou. Recursos deixados em execução podem custar dinheiro. Você pode excluir os recursos individualmente ou excluir o grupo de recursos para excluir todo o conjunto de recursos.

No portal do Azure, você pode encontrar e gerenciar recursos selecionando Todos os recursos ou grupos de recursos no painel esquerdo.

Lembre-se de que um serviço de pesquisa gratuito é limitado a três índices, três indexadores e três fontes de dados. Para ficar abaixo do limite, você pode excluir esses itens individualmente no portal do Azure.

Próxima etapa

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 REST. Documentos – A API REST (Search Post) é especialmente útil para aprendizado e exploração.