Carregar dados em um índice de pesquisa no Azure AI Search

Este artigo explica como importar, atualizar e gerenciar conteúdo em um índice de pesquisa predefinido. No Azure AI Search, um índice de pesquisa é criado primeiro, com a importação de dados seguindo como uma segunda etapa. A exceção são o assistente de importação de dados e os pipelines de indexador, que criam e carregam um índice em um fluxo de trabalho.

Um serviço de pesquisa importa e indexa texto e vetores em JSON, usados em cenários de pesquisa de texto completo, pesquisa vetorial, pesquisa híbrida e mineração de conhecimento. O conteúdo de texto pode ser obtido a partir de campos alfanuméricos na fonte de dados externa, metadados úteis em cenários de pesquisa ou conteúdo enriquecido criado por um conjunto de habilidades (as habilidades podem extrair ou inferir descrições textuais de imagens e conteúdo não estruturado). O conteúdo vetorial é vetorizado usando um modelo de incorporação externo ou vetorização integrada (visualização).

Uma vez que os dados são indexados, as estruturas de dados físicas do índice são bloqueadas. Para obter orientação sobre o que pode e o que não pode ser alterado, consulte Soltar e reconstruir um índice.

A indexação não é um processo em segundo plano. Um serviço de pesquisa equilibrará as cargas de trabalho de indexação e consulta, mas se a latência da consulta for muito alta, você poderá adicionar capacidade ou identificar períodos de baixa atividade de consulta para carregar um índice.

Carregar documentos

Um serviço de pesquisa aceita documentos JSON que estão em conformidade com o esquema de índice.

Você mesmo pode preparar esses documentos, mas se o conteúdo residir em uma fonte de dados suportada, a execução de um indexador ou do assistente Importar dados pode automatizar a recuperação de documentos, a serialização JSON e a indexação.

Portal do Azure

No portal do Azure, use os assistentes de Importação de Dados para criar e carregar índices em um fluxo de trabalho contínuo. Se quiser carregar um índice existente, escolha uma abordagem alternativa.

1. Inicie sessão no portal do Azure com a sua conta do Azure.

2. Encontre seu serviço de pesquisa e, na página Visão geral, selecione Importar dados ou Importar e vetorizar dados na barra de comandos para criar e preencher um índice de pesquisa. Você pode seguir estes links para revisar o fluxo de trabalho: Guia de início rápido: criar um índice de pesquisa do Azure AI e Guia de início rápido: vetorização integrada (visualização).

   

Se os indexadores já estiverem definidos, você poderá redefinir e executar um indexador no portal do Azure, o que será útil se você estiver adicionando campos incrementalmente. A redefinição força o indexador a começar de novo, pegando todos os campos de todos os documentos de origem.

REST

Documentos - Índice (REST) é o meio pelo qual você pode importar dados para um índice de pesquisa. O @search.action parâmetro determina se os documentos são adicionados na íntegra ou parcialmente em termos de valores novos ou de substituição para campos específicos.

Guia de início rápido: a pesquisa de texto usando REST explica as etapas. O exemplo a seguir é uma versão modificada do exemplo. Foi cortado para maior brevidade e o primeiro valor HotelId foi alterado para evitar a substituição de um documento existente.

1. Formule uma chamada POST especificando o nome do índice, o ponto de extremidade "docs/index" e um corpo de solicitação que inclua o @search.action parâmetro.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=2023-11-01
   Content-Type: application/json   
   api-key: [admin key] 
   {
       "value": [
       {
       "@search.action": "upload",
       "HotelId": "1111",
       "HotelName": "Secret Point Motel",
       "Description": "The hotel is ideally located on the main commercial artery of the city in the heart of New York. A few minutes away is Time's Square and the historic centre of the city, as well as other places of interest that make New York one of America's most attractive and cosmopolitan cities.",
       "Category": "Boutique",
       "Tags": [ "pool", "air conditioning", "concierge" ]
       },
       {
       "@search.action": "mergeOrUpload",
       "HotelId": "2",
       "HotelName": "Twin Dome Motel",
       "Description": "This is description is replacing the original one for this hotel. New and changed values overwrite the previous ones. In a comma-delimited list like Tags, be sure to provide the full list because there is no merging of values within the field itself.",
       "Category": "Boutique",
       "Tags": [ "pool", "free wifi", "concierge", "my first new tag", "my second new tag" ]
       }
     ]
   }
   

2. Procure os documentos que acabou de adicionar como passo de validação:

   GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=2023-11-01
   

Quando a chave do documento ou ID é novo, null torna-se o valor para qualquer campo que não é especificado no documento. Para ações em um documento existente, os valores atualizados substituem os valores anteriores. Todos os campos que não foram especificados em "merge" ou "mergeUpload" são deixados intactos no índice de pesquisa.

SDK .NET (C#)

O Azure AI Search dá suporte às seguintes APIs para carregamentos de documentos simples e em massa em um índice:

• IndexDocumentsAsync (SDK do Azure para .NET)
• SearchIndexingBufferedSender

Existem vários exemplos que ilustram a indexação no contexto da indexação simples e em grande escala:

• "Carregar um índice" explica as etapas básicas.

• Azure.Search.Documents Samples - A indexação de documentos da equipe do SDK do Azure adiciona SearchIndexingBufferedSender.

• Tutorial: Indexe todos os dados que combinam a indexação em lote com estratégias de teste para determinar um tamanho ideal.

Eliminar documentos órfãos

O Azure AI Search dá suporte a operações no nível do documento para que você possa pesquisar, atualizar e excluir um documento específico isoladamente. O exemplo a seguir mostra como excluir um documento. Num serviço de pesquisa, os documentos não estão relacionados, pelo que a eliminação de um não terá impacto no resto do índice.

1. Identifique qual campo é a chave do documento. No portal, é possível visualizar os campos de cada índice. As chaves de documento são campos de cadeia de caracteres e são indicadas com um ícone de chave para facilitar a sua localização.

2. Verifique os valores do campo chave do documento: search=*&$select=HotelId. Uma cadeia de caracteres simples é simples, mas se o índice usa um campo codificado em base 64 ou se os documentos de pesquisa foram gerados a partir de uma parsingMode configuração, você pode estar trabalhando com valores com os quais não está familiarizado.

3. Procure o documento para verificar o valor do ID do documento e para rever o seu conteúdo antes de o eliminar. Especifique a chave ou ID do documento na solicitação. Os exemplos a seguir ilustram uma cadeia de caracteres simples para o índice de exemplo Hotels e uma cadeia de caracteres codificada em base 64 para a chave metadata_storage_path do índice cog-search-demo.

   GET https://[service name].search.windows.net/indexes/hotel-sample-index/docs/1111?api-version=2023-11-01
   

   GET https://[service name].search.windows.net/indexes/cog-search-demo/docs/aHR0cHM6Ly9oZWlkaWJsb2JzdG9yYWdlMi5ibG9iLmNvcmUud2luZG93cy5uZXQvY29nLXNlYXJjaC1kZW1vL2d1dGhyaWUuanBn0?api-version=2023-11-01
   

4. Exclua o documento para removê-lo do índice de pesquisa.

   POST https://[service name].search.windows.net/indexes/hotels-sample-index/docs/index?api-version=2023-11-01
   Content-Type: application/json   
   api-key: [admin key] 
   {  
     "value": [  
       {  
         "@search.action": "delete",  
         "id": "1111"  
       }  
     ]  
   }
   

Consulte também

• Visão geral dos índices de pesquisa
• Descrição geral da importação de dados
• Visão geral do assistente de importação de dados
• Descrição geral dos indexadores