Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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
Uma conta do Azure com uma assinatura ativa. Crie uma conta gratuitamente.
Um serviço do Azure AI Search. Crie um serviço ou localize um serviço existente em sua assinatura atual. É possível usar um serviço gratuito para este início rápido.
Familiaridade com o assistente. Veja Assistentes de importação de dados no portal do Azure.
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.
Iniciar o assistente
Entre no portal do Azure.
Vá para o serviço de pesquisa.
Na guia Visão Geral , selecione Importar dados para iniciar o assistente.
Criar e carregar um índice de pesquisa
Nesta seção, você criará e carregará um índice em quatro etapas:
- Conectar-se a uma fonte de dados
- Ignorar configuração para habilidades cognitivas
- Configurar o índice
- 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:
Em Conecte-se aos seus dados, expanda a lista suspensa Fonte de dados e selecione Exemplos.
Selecione hotels-sample na lista de exemplos embutidos.
Selecione Avançar: Adicionar habilidades cognitivas (opcional) para continuar.
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:
Ao adicionar habilidades cognitivas, ignore as opções de configuração de enriquecimento de IA.
Selecione Avançar: Personalizar o índice de destino para continuar.
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:
Aceite os valores gerados pelo sistema para o nome do índice (hotels-sample-index) e Key (HotelId).
Aceite os valores gerados pelo sistema para todos os atributos de campo.
Selecione Próximo: criar um indexador para continuar.
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:
Aceite o valor gerado pelo sistema para o Nome do indexador (hotels-sample-indexer).
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.
Selecione Enviar para criar e executar simultaneamente o indexador.
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:
Acesse seu serviço de pesquisa no portal do Azure.
No painel esquerdo, selecione Indexadores.
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
Acesse seu serviço de pesquisa no portal do Azure.
No painel esquerdo, selecione Índices.
Selecione hotels-sample-index. Se o índice tiver zero documentos ou armazenamento, aguarde até que o portal do Azure seja atualizado.
Selecione a guia Campos para exibir o esquema de índice.
Verifique quais campos são filtráveis ou classificáveis para que você saiba quais consultas escrever.
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:
Na guia Gerenciador de Pesquisa, insira o texto para pesquisar.
Para ir para áreas não visível da saída, use o mini mapa.
Para especificar a sintaxe, alterne para o modo 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.67
de 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.