Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Neste início rápido, você cria seu primeiro índice do Azure AI Search usando o assistente Importar dados e uma amostra interna de dados fictícios de hotéis hospedados pela Microsoft. O assistente não requer 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 automatizada de dados. No final deste início rápido, analisamos cada objeto.
Nota
O assistente Importar 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 Guia de início rápido: criar um conjunto de habilidades no portal do Azure.
Pré-requisitos
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.
Familiaridade com o assistente. Consulte Importar assistentes de dados no portal do Azure.
Verificar o acesso à rede
Para este início rápido, que usa dados de exemplo internos, verifique se o serviço de pesquisa não tem 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 guia de início rápido cria um de cada um, portanto, antes de começar, certifique-se de ter 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
Inicie sessão no portal Azure.
Aceda ao seu 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ê cria e carrega um índice em quatro etapas:
- Conectar-se a uma fonte de dados
- Omitir configurações para habilidades cognitivas
- Configurar o índice
- Configurar e executar o indexador
Ligar a uma origem de dados
O assistente cria uma ligação de origem de dados a dados de exemplo que a Microsoft mantém no Azure Cosmos DB. Os dados de exemplo são acedidos através de um ponto de extremidade público, pelo que não precisas de uma conta do Azure Cosmos DB ou de ficheiros de origem para este passo.
Para se conectar aos dados de exemplo:
Em Conectar aos seus dados, expanda a lista suspensa Fonte de Dados e selecione Exemplos.
Selecione hotels-sample na lista de amostras integradas.
Selecione Next: Add cognitive skills (Optional) para continuar.
Pular configuração para habilidades cognitivas
Embora o assistente suporte a criação de conjuntos de habilidades e o enriquecimento da IA durante a indexação, as habilidades cognitivas estão além do escopo deste início rápido.
Para pular esta etapa no assistente de configuração:
Em Adicionar habilidades cognitivas, ignore as opções de configuração de enriquecimento de IA.
Selecione Next: Personalizar índice de destino para continuar.
Gorjeta
Para começar a usar o enriquecimento de IA, consulte Guia de início rápido: criar um conjunto de habilidades no portal do Azure.
Configurar o índice
O assistente deduz 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 Avançar: 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 numa resposta de consulta. | Strings e inteiros |
| Filtrável | Campos que aceitam uma expressão de filtro. | Números inteiros |
| Ordenável | Campos que aceitam uma expressão orderby. | Números inteiros |
| Facetável | Campos utilizados numa estrutura de navegação facetada. | Números inteiros |
| Pesquisável | Campos utilizados na pesquisa de texto completo. As cadeias de caracteres são pesquisáveis, mas os campos numéricos e booleanos são frequentemente marcados como não pesquisáveis. | Cordas |
Os atributos afetam o armazenamento de maneiras diferentes. Por exemplo, os campos filtráveis 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 preencher automaticamente ou sugerir consultas, especifique Analisadores ou Sugestões de idioma.
Configurar e executar o indexador
Finalmente, 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:
Vá para o 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 Sucesso. A lista também mostra o número de documentos indexados.
Verificar os resultados do índice de pesquisa
Vá para o 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 saber 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 suportado e atributos.
Mudar os campos existentes é mais difícil. Os campos existentes têm uma representação física no índice de pesquisa, por isso 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 outras construções, como perfis de pontuação e opções de CORS, a um índice a qualquer momento.
Revise 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, não será possível modificá-la ou excluí-la.
Consultar com o Explorador de procura
Agora você tem um índice de pesquisa que pode ser consultado usando o explorador de pesquisa, que envia chamadas REST em conformidade com a API REST de pesquisa POST. Esta ferramenta suporta sintaxe de consulta simples e sintaxe de consulta Lucene completa.
Para consultar o índice de pesquisa:
No separador Explorador de pesquisa, introduza texto para pesquisar.
Para saltar para áreas não visíveis da saída, use o mini mapa.
Para especificar a sintaxe, alterne para o modo de exibição JSON.
Exemplos de consultas para índice de amostra de hotéis
Os exemplos a seguir assumem a exibição JSON e a versão 2024-05-01-preview REST API.
Gorjeta
A visualização JSON suporta o Intellisense para conclusão de nome de parâmetro. Coloque o cursor dentro da visualizaçã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, por isso utilize o seu melhor julgamento.
Exemplos de filtros
Estacionamento, tags, data de renovação, classificaçã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 booleanos 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 filtros. A geo.distance função filtra todos os resultados para dados posicionais com base no especificado Location e geography'POINT coordenadas. A consulta procura hotéis a menos 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 dos hotéis 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 Lucene
A sintaxe padrão é 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
}
Termos de consulta com erros ortográficos, como seatle em vez de Seattle, não retornam correspondências em uma pesquisa típica. O queryType=full parâmetro invoca o analisador de consulta Lucene completo, que suporta o operando til (~). Ao utilizar estes parâmetros, a consulta executa uma busca aproximada para a palavra-chave especificada e encontra termos semelhantes, mas não exatamente iguais.
Reserve um minuto para experimentar estas consultas de exemplo no seu índice. Para saber mais sobre consultas, consulte Consultando no Azure AI Search.
Clean up resources (Limpar recursos)
Quando você trabalha em sua própria assinatura, é uma boa ideia no final de um projeto identificar 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.
No portal do Azure, você pode localizar e gerenciar recursos para seu serviço em Todos os recursos ou Grupos de recursos no painel esquerdo.
Nota
Se você estiver usando um serviço de pesquisa gratuito, lembre-se de que o limite é de 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óximo passo
Experimente um assistente do portal do Azure para gerar um aplicativo Web pronto para uso que seja executado em um navegador. Use este assistente no pequeno índice que criou neste guia rápido ou utilize um dos conjuntos de dados de amostra integrados para uma experiência de pesquisa mais rica.