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.
Note
O Pesquisa de IA do Azure está disponível através do portal Azure, APIs REST e SDKs do Azure. Também sustenta o Foundry IQ, a camada de conhecimento gerida que transforma conteúdos empresariais em bases de conhecimento reutilizáveis e conscientes de permissões para agentes no portal Microsoft Foundry.
Importante
Funcionalidades, capacidades ou propriedades assinaladas (pré-visualização) não são abrangidas por um acordo de nível de serviço, não são recomendadas para cargas de trabalho em produção e podem mudar ou ser limitadas antes de se tornarem geralmente disponíveis. Os termos de pré-visualização do Pesquisa de IA do Azure aplicam-se a todas as funcionalidades de pré-visualização, sejam independentes ou parte de uma funcionalidade geralmente disponível.
Este artigo explica como adicionar armazenamento em cache a um pipeline de conjuntos de habilidades para que possa modificar as etapas de enriquecimento subsequentes sem ter de reconstruir tudo a cada vez. O armazenamento em cache do enriquecimento (versão prévia) requer uma API REST de versão prévia. Por defeito, um conjunto de habilidades tem estado ausente e, ao alterar qualquer parte da sua composição, é necessário reiniciar completamente o indexador. Com uma cache de enriquecimento, o indexador determina quais as partes da árvore de documentos que devem ser atualizadas com base nas alterações no conjunto de competências ou nas definições do indexador. O indexador preserva e reutiliza a saída processada existente sempre que possível.
Colocas conteúdo em cache no Armazenamento do Azure usando uma cadeia de ligação que forneces. O indexador cria estes objetos durante a execução. Considere a cache de enriquecimento como um componente interno gerido pelo seu serviço de pesquisa que não deve modificar.
Importante
Uma memória cache de enriquecimento não é uma cópia de segurança dos resultados do conjunto de competências, do estado do indexador nem dos documentos indexados. Não regista quais os documentos que completam o processamento. Para fontes de dados grandes, consulte a secção de Limitações antes de ativar o cache.
- Um contentor chamado
ms-az-search-indexercache-<alpha-numeric-string> - Tabelas nomeadas
MsAzSearchIndexerCacheIndex<alpha-numeric-string>
Pré-requisitos
Armazenamento do Azure para armazenar enriquecimentos em cache. A conta de armazenamento deve ser de uso geral v2.
Para indexação de blobs apenas, se precisar de remoção sincronizada de documentos tanto da cache como do índice quando os blobs são eliminados da sua fonte de dados, ative uma política de eliminação no indexador. Sem esta política, a eliminação de documentos da cache não é suportada.
Deves estar familiarizado com a configuração de indexadores e conjuntos de competências. Comece com uma visão geral do indexador e depois prossiga para os conjuntos de competências para aprender sobre pipelines de enriquecimento.
Limitações
Cautela
Se estiver a usar o indexador SharePoint (pré-visualização), evite o enriquecimento incremental. Em certas circunstâncias, a cache torna-se inválida. Para o recarregar, faz um reset do indexador e uma reconstrução completa.
Grandes fontes de dados têm uma limitação adicional de cache.
Cautela
Para grandes fontes de dados, um cache de enriquecimento pode aumentar o reprocessamento total quando ocorrem competências de longa duração, interrupções repetidas ou falhas frequentes de competência. O indexador dá prioridade à correção em vez de minimizar o reprocessamento, pelo que uma acumulação na cache causada por interrupções repetidas intensifica o comportamento de repetição de tentativas. Este comportamento é esperado, não é um bug.
Para recuperar de um acúmulo crescente de cache, particione a fonte de dados em contentores mais pequenos ou pastas virtuais. Depois usa indexadores paralelos que apontam para o mesmo índice. Para dissociar a cache, defina a cache propriedade como nula no indexador. Consulte Indexar conjuntos de dados grandes para orientações sobre o padrão de particionamento.
Permissões
Uma identidade do Pesquisa de IA do Azure precisa de ter acesso de escrita ao Armazenamento do Azure:
- Contribuidor de Dados do Armazenamento Blob
- Colaborador de Tabelas de Dados de Armazenamento
A sintaxe cadeia de ligação determina se é usada uma identidade atribuída pelo sistema ou pelo utilizador. Para mais informações, veja Connect to Armazenamento do Azure usando uma identidade gerida.
Definir a propriedade cache
Use este procedimento tanto para indexadores novos como existentes.
Na definição do indexador, defina cache com:
- (Obrigatório)
storageConnectionStringdefinido para uma cadeia de conexão do Armazenamento do Azure. - (Opcional)
enableReprocessing(truepor predefinição). Defina parafalsesuspender temporariamente o enriquecimento incremental e volte paratruemais tarde.
À esquerda, selecione Indexadores.
Selecione Adicionar indexador para criar um novo indexador, ou abrir um existente em modo de edição JSON.
Ativa o enriquecimento incremental, define a conta de armazenamento da cache de enriquecimento e guarda o indexador.
Reinicia o indexador se ele já existir.
Executa o indexador. Esta reconstrução única e completa inicia o cache. Depois de carregado, aplica-se a reutilização incremental nas execuções seguintes.