Adobe Experience Manager as a Cloud Service中针对自定义Oak索引的“检测到无索引的查询”警报

本文介绍如何通过验证和更新自定义Oak索引定义来解决Adobe Experience Manager as a Cloud Service中的“检测到没有索引的查询”警报,以确保查询使用预期的索引,而不是回退到遍历。

描述 description

环境

Adobe Experience Manager as a Cloud Service(所有版本)

问题/症状

  • 在部署新的自定义Oak索引期间,AEM中的自定义SQL-2查询会触发未检测到索引的查询。

  • 该查询包括:

    • 节点类型: cq:Page
    • 特定内容路径(如/content/.../news)下的路径限制
    • 筛选器: jcr:content/cq:tags
    • 排序:jcr:content/publishedDate降序
    • 显式索引标记: customNewsLucene
  • 该查询类似于:

select [ jcr:path] , [ jcr:score] , * from [ cq:Page]  as a
where [ jcr:content/cq:tags]  = '/news'
order by [ jcr:content/publishedDate]  desc
option(index tag [ customNewsLucene] )
  • 警报表示任何Oak/Lucene索引都不能同时满足查询中定义的属性限制和排序顺序。
  • 因此,Oak回退到遍历,这可能会对查询性能产生负面影响。

原因

当任何可用的Oak/Lucene索引不完全满足查询的过滤器和排序条件时,会出现“检测到没有索引的查询”警报。 如果自定义索引尚未部署、不完全可用或与查询要求不匹配,则可能发生这种情况。

解决方法 resolution

请按照以下步骤解决问题:

  1. 打开AEM as a Cloud Service Developer Console并使用查询性能工具。

  2. 运行受影响的查询或选择 Explain 以查看选择的索引。

  3. 如果查询不使用预期的自定义索引或计划显示遍历,请查看自定义索引定义。 请确保它支持查询的要求:

    • 节点类型: cq:Page
    • 属性限制: jcr:content/cq:tags
    • 排序属性: jcr:content/publishedDate,用于降序排序
    • 路径限制:相关内容路径,如/content/.../news
    • 索引标记: customNewsLucene,与查询的显式索引标记匹配
  4. 通过Cloud Manager部署更新的索引定义。 在验证查询之前,请等待索引更新完成。

  5. 使用查询性能工具确认执行计划使用预期的自定义索引,处理查询限制和排序,并且不显示遍历。

  6. (可选)在操作中心监视查询数天,以检查是否为其显示新的 未检测到索引的查询 警报。

  7. 对于未来的索引更改,请在生产部署之前在较低的环境中验证这些更改。 使用查询性能工具的 Explain 功能确认索引选择。

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