Quickstart: Use o explorador de pesquisa para executar consultas no portal do Azure

Neste início rápido, irá aprender a usar o Explorador de Pesquisa Search Explorer, uma ferramenta de consulta integrada no portal Azure para executar consultas contra um índice Pesquisa de IA do Azure. Use esta ferramenta para testar uma expressão de consulta ou filtro ou para confirmar se existe conteúdo no índice.

Este quickstart utiliza um índice existente para demonstrar o explorador de pesquisa.

Pré-requisitos

• Uma conta no Azure com uma subscrição ativa. Cria uma conta gratuitamente.

• Um serviço Pesquisa de IA do Azure. Criar um serviço ou encontre um serviço existente na sua subscrição atual. Para este início rápido, pode usar um serviço gratuito.

• Este início rápido utiliza o índice de exemplo de hotéis. Siga as instruções deste guia de início rápido para criar o índice.

Iniciar explorador de pesquisa

1. Vá ao seu serviço de pesquisa no portal Azure.

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

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

   

   Alternativamente, selecione a guia do explorador da pesquisa na página de índice.

Consulta em três formas

Existem três abordagens para consultar no explorador de pesquisa:

• A vista de consulta fornece uma barra de pesquisa predefinida. Aceita uma consulta vazia ou consulta de texto livre com booleanos, como ocean view + parking.

• A vista de imagem oferece uma janela para navegar ou arrastar e largar ficheiros PNG, JPG ou JPEG. A menos que o seu índice tenha um vetorizador de imagem e uma competência equivalente, esta vista não está disponível.

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

  

Exemplo: Consulta de imagem

O explorador de pesquisa aceita imagens como entradas de consulta através da Vista de Imagem, que exige que utilize um par vetor–competência suportado. Para mais informações, veja Configurar um vetorizador num índice de pesquisa.

O índice de amostras de hotéis não está configurado para vetorização de imagem. Se quiser fazer consultas de imagem, crie um índice conforme descrito em Quickstart: Pesquisa vetorial no portal Azure. O quickstart baseia-se em dados de exemplo baseados em texto, por isso deve usar documentos que contenham imagens.

Para executar uma consulta de imagem, selecione ou arraste uma imagem para a área de pesquisa e depois selecione Pesquisar. O explorador de pesquisa vetoriza a imagem e envia o vetor para o motor de busca para execução de consultas. O motor de busca devolve documentos suficientemente semelhantes à imagem de entrada, até ao k número especificado de resultados.

Exemplos: consultas JSON

A seguir estão exemplos de consultas JSON que pode executar usando o explorador de pesquisa. Para seguir estes exemplos, mude para a visualização JSON. Podes colar cada exemplo JSON na área de texto.

Dica

A vista JSON suporta intellisense para completamento de nomes de parâmetros. Coloque o cursor dentro da vista JSON e introduza um carácter de espaço para ver uma lista de todos os parâmetros da consulta. Também pode inserir uma letra, como s, para ver apenas os parâmetros da consulta que começam com essa letra.

O Intellisense não exclui parâmetros inválidos, por isso usa o teu melhor juízo.

Executar uma consulta não especificada

No explorador de pesquisa, os pedidos POST são formulados internamente usando Documents - Search Post (API REST), com respostas devolvidas como documentos JSON detalhados.

Para uma primeira visão do conteúdo, execute uma pesquisa vazia selecionando Pesquisar sem termos fornecidos. Uma pesquisa vazia é útil como primeira consulta porque devolve documentos completos para que possa rever a composição do documento. Numa pesquisa vazia, não há pontuação de pesquisa, e os documentos são devolvidos por ordem arbitrária ("@search.score": 1 para todos os documentos). Por padrão, 50 documentos são devolvidos por consulta de pesquisa.

Soma "count": true para obter o número de correspondências encontradas num índice. Numa pesquisa vazia, a contagem é o número total de documentos no índice. Numa pesquisa qualificada, é o número de documentos que correspondem à entrada da consulta. Lembre-se que o serviço devolve as 50 melhores correspondências por padrão, por isso a contagem pode indicar mais correspondências no índice do que as que são apresentadas nos resultados.

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

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

Resultados

Execute uma consulta em texto livre

A pesquisa livre, com ou sem operadores, é útil para simular consultas definidas pelo utilizador enviadas de uma aplicação personalizada para o Pesquisa de IA do Azure. Apenas os campos atribuídos como pesquisáveis no índice são analisados para correspondências.

Não precisa da visualização JSON para uma consulta em texto livre, mas fornecemo-la em JSON para consistência com outros exemplos deste artigo.

Note que, quando fornece critérios de pesquisa, como termos de consulta ou expressões, o ranking de pesquisa entra em jogo. O exemplo seguinte ilustra uma pesquisa em texto livre. É @search.score uma pontuação de relevância calculada para o jogo usando o algoritmo de pontuação padrão.

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast"
}

Resultados

Pode usar Ctrl-F para pesquisar nos resultados termos de interesse específicos.

Limitar campos nos resultados de pesquisa

Adicione "select" para limitar os resultados aos campos explicitamente nomeados para obter resultados mais legíveis no explorador de pesquisa. Apenas os campos atribuídos como recuperáveis no índice podem aparecer nos resultados.

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description"
}

Resultados

Devolver o próximo lote de resultados

O Pesquisa de IA do Azure devolve as 50 melhores correspondências com base no ranking de pesquisa. O índice de amostragem de hotéis tem apenas 50 hotéis, por isso usamos um número menor para ilustrar a paginação. Para obter o próximo conjunto de documentos correspondentes, adicione "top": 20 e "skip": 10 aumente o conjunto de resultados para 20 documentos (padrão é 50, máximo é 1000), saltando os primeiros 10 documentos. Pode verificar a chave do documento (HotelId) para identificar um documento.

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

{
   "search": "activities `outdoor pool` restaurant OR continental breakfast",
   "count": true,
   "select": "HotelId, HotelName, Tags, Description",
   "top": 20,
   "skip": 10
}

Resultados

Expressões de filtro (maiores que, menores que, iguais a)

Use o filter parâmetro para especificar critérios de inclusão ou exclusão. O campo deve ser atribuído como filtrável no índice. Este exemplo procura classificações superiores a quatro:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating",
    "filter": "Rating gt 4"
}

Resultados

Ordenar resultados

Adicione orderby a ordenar resultados por outro campo além da pontuação de pesquisa. O campo deve ser atribuído como ordenável no índice. Em situações em que o valor filtrado é idêntico (por exemplo, mesmo preço), a ordem é arbitrária, mas pode adicionar mais critérios para uma ordenação mais profunda. Aqui está uma expressão de exemplo que pode usar para testar isto:

{
    "search": "activities `outdoor pool` restaurant OR continental breakfast",
    "count": true,
    "select": "HotelId, HotelName, Tags, Description, Rating, LastRenovationDate",
    "filter": "Rating gt 4",
    "orderby": "LastRenovationDate desc"
}

Resultados

Concluições

Neste quickstart, usaste o explorador de pesquisa para consultar um índice usando a API REST.

• Os resultados são devolvidos como documentos JSON detalhados para que possa visualizar a construção e o conteúdo de cada documento na sua totalidade. O select parâmetro numa expressão de consulta limita quais os campos que são devolvidos.

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

• A pesquisa por palavras-chave, semelhante à que poderia introduzir num navegador web comercial, é útil para testar a experiência do utilizador final. Por exemplo, assumindo o índice de amostra de hotéis, pode inserir "activities 'outdoor pool' restaurant OR continental breakfast", e depois pode usar Ctrl-F para encontrar termos nos resultados de pesquisa.

• Expressões de consulta e filtro são articuladas numa sintaxe implementada pelo Pesquisa de IA do Azure. O padrão é uma sintaxe simples, mas podes opcionalmente usar o Lucene completo para consultas mais poderosas. As expressões de filtro são articuladas numa sintaxe OData.

Liberar recursos

Quando trabalha com a sua própria subscrição, é boa ideia terminar um projeto removendo os recursos de que já não precisa. Os recursos que continuam a funcionar podem custar-lhe dinheiro.

No portal Azure, selecione Todos os recursos ou Resource groups no painel esquerdo para encontrar e gerir recursos. Podes eliminar recursos individualmente ou eliminar o grupo de recursos para remover todos os recursos de uma só vez.

Se estiver a usar um serviço de pesquisa gratuito, lembre-se de que está limitado a três índices, indexadores e fontes de dados. Podes eliminar itens individuais no portal para ficares abaixo do limite.

Próximo passo

Para aprender mais sobre estruturas de consulta e sintaxe, utilize um cliente REST para criar expressões de consulta que utilizem mais partes da API REST. Documentos - Search Post (API REST) é especialmente útil para aprendizagem e exploração.

Quickstart: Pesquisa em texto completo