DocumentaçãoKCS da Experience Cloud

O índice gerenciado pelo SIM não está selecionado para consultas no AEM as a Cloud Service

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

No Adobe Experience Manager as a Cloud Service, uma definição de SIM (Gerenciamento simplificado de índice) pode ser implantada com sucesso enquanto as consultas continuam a usar um índice anterior. O planejador de consultas avalia os índices elegíveis com base nas restrições de consulta, propriedades indexadas e custo estimado. Para corrigir isso, verifique a implantação e o plano de consulta, alinhe includedPaths, queryPaths e as regras de índice com os requisitos de consulta, implante as alterações por meio do Cloud Manager e valide as consultas após a conclusão da indexação.

Descrição description

Ambiente

Adobe Experience Manager as a Cloud Service com gerenciamento simplificado de índice

Problema/Sintomas

Depois de implantar uma definição de Gerenciamento de índice simplificado, as consultas continuam usando um índice anterior em vez do índice gerenciado pelo SIM desejado.

  • As consultas continuam usando um índice anterior, como cqPageLucene, em vez do índice pretendido, como cqPageContent.
  • O índice gerenciado pelo SIM aparece no repositório, mas a Ferramenta de Desempenho de Consulta não o seleciona para as consultas relevantes.
  • A definição do índice contém includedPaths e queryPaths, mas a consulta ainda usa o índice anterior.
  • As propriedades de consulta obrigatórias não estão incluídas nas regras de índice gerenciadas pelo SIM.
  • Nenhuma mensagem de erro específica é exibida nos logs.

Causa

O planejador de consulta seleciona o índice elegível com o menor custo estimado. Se o índice gerenciado pelo SIM não abranger o caminho da consulta ou as propriedades necessárias, ou se o custo estimado for maior que o índice anterior, a consulta continuará a usar o índice anterior.

Resolução resolution

Para solucionar problemas de seleção de índice, siga estas etapas:

  1. Execute a consulta afetada na Ferramenta de Desempenho de Consultae revise a saída de Explicar Consulta.

    • Confirme qual índice a consulta usa.
    • Confirme se o índice gerenciado pelo SIM pretendido é considerado pelo plano de consulta.
    • Registre o plano de consulta e os custos estimados para comparação depois de atualizar a definição do índice.

  2. Confirme se a definição do SIM está implementada corretamente.

    • Verifique se a definição SIM está incluída na base de código do projeto.
    • Confirme se o pipeline Cloud Manager foi concluído com êxito.
    • Use Navegador do Repositório para verificar se a definição de índice gerada, como /oak:index/<sim-index-name>, existe com a configuração esperada.

  3. Revise a configuração do caminho na definição do índice.

    • Confirme se includedPaths cobre o conteúdo que o índice deve conter.
    • Confirme se queryPaths cobre as restrições de caminho usadas pela consulta.
    • Use valores correspondentes para includedPaths e queryPaths quando o índice precisar conter e servir consultas para o mesmo escopo de conteúdo.
    • Observação: includedPaths controla o escopo do conteúdo indexado, enquanto queryPaths afeta se o índice está qualificado para uma consulta com uma restrição de caminho correspondente.

  4. Revise as regras e propriedades de índice exigidas pela consulta.

    • Confirme se cada propriedade usada pela consulta está indexada na regra de índice apropriada.
    • Verifique propriedades como jcr:content/cq:lastModified, excludeSearch e hideFromExternalUser quando a consulta as utilizar.
    • Se uma propriedade obrigatória estiver ausente, adicione a regra de índice apropriada à definição do SIM e reimplante-a pelo pipeline Cloud Manager.

  5. Implante a definição de índice atualizada por meio do pipeline Cloud Managerpadrão.

    • Criar pacote da definição de índice atualizada como parte da base de código do projeto.
    • Execute o pipeline e permita que o processo de compilação ou reindexação de índice seja concluído.
    • Verifique o status de indexação na página de build do Cloud Manager antes de validar a consulta novamente.

  6. Validar o comportamento da consulta após a conclusão da indexação.

    • Execute novamente a consulta afetada na Ferramenta de Desempenho de Consulta.
    • Confirme se o índice gerenciado pelo SIM desejado está selecionado na saída Explicar consulta.
    • Teste um conjunto representativo de consultas de alto impacto.
    • Compare os resultados e a classificação antes e depois da migração, especialmente para consultas com campos impulsionados, como título, descrição e conteúdo.
    • Use a Ferramenta de Desempenho de Consulta para verificar se há regressões de desempenho.

  7. Remova definições de índice obsoletas da base de código do projeto após validar o novo índice gerenciado pelo SIM.

    • Não exclua manualmente os nós de índice do repositório.
    • Observação: versões de índice antigas e novas podem coexistir temporariamente durante uma implantação em andamento enquanto o AEM as a Cloud Service prepara a nova versão.

Notas:

  • O SIM é recomendado para índices de Página, DAM e Auditoria. A migração não é obrigatória quando um índice existente atende aos seus requisitos e permanece compatível.
  • Para índices sem caminhos de consulta personalizados, como Audit Event ou um Email Index personalizado, inclua-os na configuração de migração somente quando pretender migrar suas consultas para o SIM.
  • Migre índices personalizados para o SIM quando o suporte contínuo e a compatibilidade futura forem requisitos.

Leitura relacionada

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