DocumentaçãoKCS da Experience Cloud

O índice Oak personalizado não está selecionado para consultas no Adobe Experience Manager

Última atualização: 10 de agosto de 2026

Este artigo explica por que um índice Oak personalizado no Adobe Experience Manager (AEM) pode não ser selecionado para determinadas consultas e fornece etapas para resolver o problema.

Descrição description

Ambientes

  • Adobe Experience Manager (no local)
  • AEM as a Cloud Service (AEMaaCS)

Sintomas

Um índice Oak personalizado geralmente é criado no AEM para melhorar o desempenho de consultas específicas, como aquelas filtradas por tags e ordenadas por data de publicação. No entanto, após implantar o índice personalizado, você percebe que sua consulta continua a usar o índice ntBaseLucene-2 padrão em vez do índice personalizado, resultando em um desempenho de consulta mais lento. Esse problema pode ocorrer em implantações do AEM as a Cloud Service (AEMaaCS) e em implantações locais do AEM.

Resolução resolution

Siga as etapas abaixo para resolver o problema:

  1. Revise sua definição de índice Oak personalizado e verifique a presença da propriedade selectionPolicy definida como tag.

  2. Se selectionPolicy="tag" estiver presente, remova esta propriedade da definição de índice. Não altere outros elementos de configuração, como includedPaths, type ou propriedades indexadas.

  3. Reimplante a definição de índice atualizada:

    • Para AEM as a Cloud Service (AEMaaCS): implante o pacote de índice atualizado usando o Cloud Manager.

    • Para AEM no local: implante o pacote de índice atualizado usando seu método de implantação padrão (como gerenciador de pacotes ou implantação de sistema de arquivos).

  4. Permitir que o AEM reindexe e ative a nova definição de índice.

  5. Use a ferramenta Desempenho da consulta ou o recurso Explicar para verificar se sua consulta agora usa o índice personalizado em vez de ntBaseLucene-2.

  6. Confirme se o tempo de resposta da consulta melhora e atende ao desempenho esperado.

recommendation-more-help
experience-cloud-kcs-help-kbarticles