Compartilhar via


Início Rápido: Criar um índice de pesquisa no portal do Azure

Neste início rápido, você criará seu primeiro índice do Azure AI Search usando o assistente de importação de dados e uma amostra interna de dados de hotéis fictícios hospedados pela Microsoft. O assistente não requer nenhum código para criar um índice, ajudando você a escrever consultas interessantes em poucos minutos.

O assistente cria vários objetos em seu serviço de pesquisa, incluindo um índice pesquisável, um indexador e uma conexão de fonte de dados para recuperação de dados automatizada. No final deste início rápido, analisamos cada objeto.

Observação

O assistente de Importação de dados inclui opções para OCR, tradução de texto e outros enriquecimentos de IA que não são abordados neste início rápido. Para obter um passo a passo semelhante que se concentra na IA aplicada, consulte Início Rápido: Criar um conjunto de habilidades no portal do Azure.

Pré-requisitos

Verificar se há acesso à rede

Para este início rápido, que usa dados de exemplo internos, verifique se o serviço de pesquisa não possui controles de acesso à rede. O controlador do portal do Azure usa um ponto de extremidade público para recuperar dados e metadados da fonte de dados hospedada pela Microsoft. Para obter mais informações, consulte Conexões seguras nos assistentes de importação.

Verificar o espaço

Muitos clientes começam com um serviço de pesquisa gratuito, que é limitado a três índices, três indexadores e três fontes de dados. Este início rápido cria um de cada, portanto, antes de começar, verifique se você tem espaço para objetos extras.

Na guia Visão Geral , selecione Uso para ver quantos índices, indexadores e fontes de dados você tem atualmente.

Captura de tela da página Visão geral de uma instância do serviço Azure AI Search no portal do Azure, mostrando o número de índices, indexadores e fontes de dados.

Iniciar o assistente

  1. Entre no portal do Azure.

  2. Vá para o serviço de pesquisa.

  3. Na guia Visão Geral , selecione Importar dados para iniciar o assistente.

    Captura de tela que mostra como abrir o assistente Importar dados no portal do Azure.

Criar e carregar um índice de pesquisa

Nesta seção, você criará e carregará um índice em quatro etapas:

  1. Conectar-se a uma fonte de dados
  2. Ignorar configuração para habilidades cognitivas
  3. Configurar o índice
  4. Configurar e executar o indexador

Conectar-se a uma fonte de dados

O assistente cria uma conexão de fonte de dados com os dados de exemplo que a Microsoft hospeda no Azure Cosmos DB. Os dados de exemplo são acessados por meio de um ponto de extremidade público, portanto, você não precisa de uma conta do Azure Cosmos DB ou arquivos de origem para esta etapa.

Para se conectar aos dados de exemplo:

  1. Em Conecte-se aos seus dados, expanda a lista suspensa Fonte de dados e selecione Exemplos.

  2. Selecione hotels-sample na lista de exemplos embutidos.

  3. Selecione Avançar: Adicionar habilidades cognitivas (opcional) para continuar.

    Captura de tela que mostra como selecionar a fonte de dados hotels-sample no assistente Importar dados.

Ignorar configuração para habilidades cognitivas

Embora o assistente dê suporte à criação do conjunto de habilidades e ao enriquecimento de IA durante a indexação, as habilidades cognitivas estão além do escopo deste início rápido.

Para ignorar esta etapa no assistente:

  1. Ao adicionar habilidades cognitivas, ignore as opções de configuração de enriquecimento de IA.

  2. Selecione Avançar: Personalizar o índice de destino para continuar.

    Captura de tela que mostra como pular para a guia Personalizar índice de destino no assistente Importar dados.

Dica

Para começar a usar o enriquecimento de IA, consulte Início Rápido: Criar um conjunto de habilidades no portal do Azure.

Configurar o índice

O assistente infere um esquema para o índice de exemplo de hotéis. Para configurar o índice:

  1. Aceite os valores gerados pelo sistema para o nome do índice (hotels-sample-index) e Key (HotelId).

  2. Aceite os valores gerados pelo sistema para todos os atributos de campo.

  3. Selecione Próximo: criar um indexador para continuar.

    Captura de tela que mostra a definição de índice gerada para a fonte de dados de exemplo de hotéis no assistente Importar dados.

No mínimo, o índice de pesquisa requer um nome e uma coleção de campos. O assistente verifica campos de cadeia de caracteres exclusivos e marca um como a chave do documento, que identifica exclusivamente cada documento no índice.

Cada campo tem um nome, um tipo de dados e atributos que controlam como o campo é usado no índice. Use as caixas de seleção para habilitar ou desabilitar os seguintes atributos:

Atributo Descrição Tipos de dados aplicáveis
Recuperável Campos retornados em uma resposta de consulta. Cadeias de caracteres e inteiros
Filtrável Campos que aceitam uma expressão de filtro. Inteiros
Ordenável Campos que aceitam uma expressão orderby. Inteiros
Com faceta Campos usados em uma estrutura de navegação facetada. Inteiros
Pesquisável Campos usados na pesquisa de texto completo. Cadeias de caracteres são pesquisáveis, mas campos numéricos e boolianos geralmente são marcados como não pesquisáveis. Cordas

Os atributos afetam o armazenamento de diferentes maneiras. Por exemplo, campos filtrados consomem armazenamento extra, enquanto os campos recuperáveis não. Para obter mais informações, consulte Exemplo demonstrando as implicações de armazenamento de atributos e sugestões.

Se desejar preenchimento automático ou consultas sugeridas, especifique o idioma Analisadores ou Sugestores.

Configurar e executar o indexador

Por fim, você configura e executa o indexador, que define um processo executável. A fonte de dados e o índice também são criados nesta etapa.

Para configurar e executar o indexador:

  1. Aceite o valor gerado pelo sistema para o Nome do indexador (hotels-sample-indexer).

  2. Para este início rápido, use a opção padrão para executar o indexador imediatamente e apenas uma vez. Os dados de exemplo são estáticos, portanto, você não pode habilitar o controle de alterações.

  3. Selecione Enviar para criar e executar simultaneamente o indexador.

    Captura de tela que mostra como configurar o indexador para a fonte de dados hotels-sample no assistente Importar dados.

Monitorar o progresso do indexador

Você pode monitorar a criação do indexador e do índice no portal do Azure. A guia Visão geral fornece links para os recursos criados em seu serviço de pesquisa.

Para monitorar o progresso do indexador:

  1. Acesse seu serviço de pesquisa no portal do Azure.

  2. No painel esquerdo, selecione Indexadores.

    Captura de tela que mostra a criação do indexador em andamento no portal do Azure.

    Pode levar alguns minutos para que os resultados sejam atualizados. Você deve ver o indexador recém-criado com um status de Em andamento ou Êxito. A lista também mostra o número de documentos indexados.

Verificar os resultados do índice de pesquisa

  1. Acesse seu serviço de pesquisa no portal do Azure.

  2. No painel esquerdo, selecione Índices.

  3. Selecione hotels-sample-index. Se o índice tiver zero documentos ou armazenamento, aguarde até que o portal do Azure seja atualizado.

    Captura de tela da lista Índices no painel do serviço Azure AI Search no portal do Azure.

  4. Selecione a guia Campos para exibir o esquema de índice.

  5. Verifique quais campos são filtráveis ou classificáveis para que você saiba quais consultas escrever.

    Captura de tela que mostra a definição de esquema para um índice no serviço Azure AI Search no portal do Azure.

Adicionar ou alterar campos

Na guia Campos , você pode criar um campo selecionando Adicionar campo e especificando um nome, tipo de dados com suporte e atributos.

A alteração de campos existentes é mais difícil. Os campos existentes têm uma representação física no índice de pesquisa, portanto, eles não são modificáveis, nem mesmo no código. Para alterar fundamentalmente um campo existente, você deve criar um novo campo para substituir o original. Você pode adicionar outros constructos, como perfis de pontuação e opções CORS, a um índice a qualquer momento.

Examine as opções de definição de índice para entender o que você pode ou não editar durante o design do índice. Se uma opção aparecer esmaecida, você não poderá modificá-la ou excluí-la.

Consultar com o Gerenciador de pesquisa

Agora você tem um índice de pesquisa que pode ser consultado usando o Gerenciador de Pesquisa, que envia chamadas REST que estão em conformidade com a API REST DE PESQUISA POST. Essa ferramenta dá suporte à sintaxe de consulta simples e à sintaxe completa da consulta Lucene.

Para consultar o índice de pesquisa:

  1. Na guia Gerenciador de Pesquisa, insira o texto para pesquisar.

    Captura de tela que mostra como inserir e executar uma consulta na ferramenta Search Explorer.

  2. Para ir para áreas não visível da saída, use o mini mapa.

    Captura de tela que mostra resultados longos para uma consulta na ferramenta Search Explorer e no minimapa.

  3. Para especificar a sintaxe, alterne para o modo de exibição JSON.

    Captura de tela do seletor de exibição JSON.

Exemplo de consultas para índice de exemplo de hotéis

Os exemplos a seguir pressupõem a exibição JSON e a versão da API REST 2024-05-01-preview.

Dica

A exibição JSON dá suporte ao intellisense para conclusão do nome do parâmetro. Coloque o cursor dentro da exibição JSON e digite um caractere de espaço para ver uma lista de todos os parâmetros de consulta. Você também pode digitar uma letra, como "s", para ver apenas os parâmetros de consulta que começam com essa letra. O Intellisense não exclui parâmetros inválidos, portanto, use seu melhor julgamento.

Exemplos de filtro

Estacionamento, tags, data da renovação, avaliação e localização são filtráveis.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "Rating gt 4"
}

Os filtros boolianos assumem "true" por padrão.

{
    "search": "beach OR spa",
    "select": "HotelId, HotelName, Description, Rating",
    "count": true,
    "top": 10,
    "filter": "ParkingIncluded"
}

A pesquisa geoespacial é baseada em filtro. A função geo.distance filtra todos os resultados para dados posicionais com base nas coordenadas Location e geography'POINT especificadas. A consulta busca hotéis dentro de cinco quilômetros das coordenadas -122.12 47.67de latitude e longitude, que é "Redmond, Washington, EUA". A consulta exibe o número total de correspondências &$count=true com os nomes do hotel e os locais de endereço.

{
    "search": "*",
    "select": "HotelName, Address/City, Address/StateProvince",
    "count": true,
    "top": 10,
    "filter": "geo.distance(Location, geography'POINT(-122.12 47.67)') le 5"
}

Exemplos completos de sintaxe do Lucene

A sintaxe padrão é uma sintaxe simples, mas se você quiser pesquisa difusa, aumento de termos ou expressões regulares, especifique a sintaxe completa.

{
    "queryType": "full",
    "search": "seatle~",
    "select": "HotelId, HotelName,Address/City, Address/StateProvince",
    "count": true
}

Os termos de consulta com ortografia incorreta, como seatle em vez de Seattle, não retornam correspondências em uma pesquisa típica. O parâmetro queryType=full invoca o analisador de consulta Lucene completo, que oferece suporte ao operando til (~). Quando você usa esses parâmetros, a consulta executa uma pesquisa difusa para a palavra-chave especificada e corresponde a termos semelhantes, mas não uma correspondência exata.

Reserve um minuto para experimentar essas consultas de exemplo em seu índice. Para saber mais sobre consultas, consulte Consulta no Azure AI Search.

Limpar os recursos

Quando você trabalha em sua própria assinatura, é uma boa ideia no final de um projeto identificar se você ainda precisa dos recursos criados. 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 para seu serviço em Todos os recursos ou grupos de recursos no painel esquerdo.

Observação

Se você estiver usando um serviço de pesquisa gratuito, lembre-se de que o limite é três índices, três indexadores e três fontes de dados. Você pode excluir objetos individuais no portal do Azure para permanecer abaixo do limite.

Próxima etapa

Experimente um assistente do portal do Azure para gerar um aplicativo Web pronto para uso executado em um navegador. Use este assistente no pequeno índice que você criou neste início rápido ou use um dos conjuntos de dados de exemplo internos para uma experiência de pesquisa mais avançada.