DocumentaciónKCS de Experience Cloud

El índice administrado por SIM no está seleccionado para consultas en AEM as a Cloud Service

Última actualización: 11 de agosto de 2026

En Adobe Experience Manager as a Cloud Service, se puede implementar correctamente una definición de administración simplificada de índices (SIM) mientras las consultas siguen utilizando un índice anterior. El planificador de consultas evalúa los índices elegibles en función de las restricciones de la consulta, las propiedades indexadas y el coste estimado. Para solucionarlo, compruebe la implementación y el plan de consultas, alinee includedPaths, queryPaths y las reglas de índice con los requisitos de consultas, implemente los cambios a través de Cloud Manager y valide las consultas una vez completada la indexación.

Descripción description

Entorno

Adobe Experience Manager as a Cloud Service con administración simplificada de índices

Problema/Síntomas

Después de implementar una definición de administración de índices simplificada, las consultas siguen usando un índice anterior en lugar del índice administrado por SIM deseado.

  • Las consultas siguen utilizando un índice anterior como cqPageLucene en lugar del índice deseado como cqPageContent.
  • El índice administrado por SIM aparece en el repositorio, pero la Herramienta de rendimiento de consultas no lo selecciona para las consultas relevantes.
  • La definición de índice contiene includedPaths y queryPaths, pero la consulta sigue utilizando el índice anterior.
  • Las propiedades de consulta requeridas no se incluyen en las reglas de índice administradas por SIM.
  • No aparece ningún mensaje de error específico en los registros.

Causa

El planificador de consultas selecciona el índice apto con el coste estimado más bajo. Si el índice administrado por SIM no cubre la ruta de la consulta o las propiedades requeridas, o si su costo estimado es mayor que el índice anterior, la consulta continúa usando el índice anterior.

Resolución resolution

Para solucionar los problemas de selección de índice, siga estos pasos:

  1. Ejecute la consulta afectada en Query Performance Tooly revise el resultado de Explicar consulta.

    • Confirme qué índice utiliza la consulta.
    • Confirme si el plan de consultas considera el índice administrado por SIM deseado.
    • Registre el plan de consulta y los costes estimados para la comparación después de actualizar la definición del índice.

  2. Confirme que la definición de SIM se implementa correctamente.

    • Compruebe que la definición de SIM esté incluida en la base de código del proyecto.
    • Confirme que la canalización Cloud Manager se ha completado correctamente.
    • Use Explorador del repositorio para comprobar que la definición de índice generada, como /oak:index/<sim-index-name>, existe con la configuración esperada.

  3. Revise la configuración de ruta en la definición del índice.

    • Confirme que includedPaths cubre el contenido que debe contener el índice.
    • Confirme que queryPaths cubre las restricciones de ruta utilizadas por la consulta.
    • Use valores coincidentes para includedPaths y queryPaths cuando el índice deba contener y servir consultas para el mismo ámbito de contenido.
    • Nota: includedPaths controla el ámbito de contenido indizado, mientras que queryPaths afecta a si el índice es apto para una consulta con una restricción de ruta coincidente.

  4. Revise las reglas de índice y las propiedades requeridas por la consulta.

    • Confirme que cada propiedad utilizada por la consulta está indizada en la regla de índice adecuada.
    • Compruebe propiedades como jcr:content/cq:lastModified, excludeSearch y hideFromExternalUser cuando la consulta las utilice.
    • Si falta una propiedad necesaria, agrega la regla de índice adecuada a la definición de SIM y vuelve a implementarla a través de la canalización Cloud Manager.

  5. Implemente la definición de índice actualizada a través de la canalización estándar Cloud Manager.

    • Empaquete la definición de índice actualizada como parte del código base del proyecto.
    • Ejecute la canalización y permita que se complete el proceso de generación o reindexación de índices.
    • Compruebe el estado de indexación en la página de compilación de Cloud Manager antes de volver a validar la consulta.

  6. Valide el comportamiento de la consulta una vez completada la indexación.

    • Vuelva a ejecutar la consulta afectada en la Herramienta de rendimiento de consultas.
    • Confirme que el índice administrado por SIM se seleccionó en la salida Explicar consulta.
    • Pruebe un conjunto representativo de consultas de alto impacto.
    • Compare resultados y clasificación antes y después de la migración, especialmente para consultas con campos mejorados como título, descripción y contenido.
    • Use la Herramienta de rendimiento de consultas para comprobar regresiones de rendimiento.

  7. Elimine las definiciones de índice obsoletas de la base de código del proyecto después de validar el nuevo índice administrado por SIM.

    • No elimine manualmente nodos de índice del repositorio.
    • Nota: Las versiones de índice antiguas y nuevas pueden coexistir temporalmente durante una implementación móvil mientras AEM as a Cloud Service prepara la nueva versión.

Notas:

  • Se recomienda utilizar SIM para los índices Page, DAM y Audit. La migración no es obligatoria cuando un índice existente cumple con sus requisitos y sigue siendo compatible.
  • Para los índices sin rutas de consulta personalizadas, como Audit Event o un Email Index personalizado, inclúyalos en la configuración de migración solo cuando pretenda migrar sus consultas a SIM.
  • Migre índices personalizados a SIM cuando la compatibilidad continua y futura sean requisitos.

Lectura relacionada

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