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
请按照以下步骤解决问题:
-
打开AEM as a Cloud Service Developer Console并使用查询性能工具。
-
运行受影响的查询或选择 Explain 以查看选择的索引。
-
如果查询不使用预期的自定义索引或计划显示遍历,请查看自定义索引定义。 请确保它支持查询的要求:
- 节点类型:
cq:Page - 属性限制:
jcr:content/cq:tags - 排序属性:
jcr:content/publishedDate,用于降序排序 - 路径限制:相关内容路径,如
/content/.../news - 索引标记:
customNewsLucene,与查询的显式索引标记匹配
- 节点类型:
-
通过Cloud Manager部署更新的索引定义。 在验证查询之前,请等待索引更新完成。
-
使用查询性能工具确认执行计划使用预期的自定义索引,处理查询限制和排序,并且不显示遍历。
-
(可选)在操作中心监视查询数天,以检查是否为其显示新的 未检测到索引的查询 警报。
-
对于未来的索引更改,请在生产部署之前在较低的环境中验证这些更改。 使用查询性能工具的 Explain 功能确认索引选择。
recommendation-more-help
experience-cloud-kcs-help-kbarticles