排除查询速度较慢的问题 troubleshooting-slow-queries

无索引查询

• 不 ​的查询解析为索引并遍历JCR的内容以收集结果

限制不当（或范围极小）的查询

• 解析为索引，但必须遍历所有索引项以收集结果的查询

大型结果集查询

• 返回大量结果的查询

此调整特定于查询生成器，不适用于JCR-SQL2或XPath。

当完整结果集​ 不是 ​立即需要时，使用Query Builder' guessTotal。

• 未优化的查询

  code language-js
  type=cq:Page path=/content

• 优化查询

  code language-js
  type=cq:Page path=/content p.guessTotal=100

对于查询执行速度较快但结果数量较大的情况，p. guessTotal是查询生成器查询的关键优化。

p.guessTotal=100告知Query Builder仅收集前100个结果。 并且，设置一个布尔标志来指示是否至少还有一个结果（但不指示还有多少个结果，因为计数此数字会导致速度变慢）。 此优化优于分页或无限加载用例，在这些用例中，仅增量显示结果子集。

如果最佳查询解析为属性索引，则由于属性索引最低可微调，因此没有任何可执行的操作。

否则，查询应解析为Lucene属性索引。 如果无法解析索引，请跳到创建索引。

根据需要，将查询转换为XPath或JCR-SQL2。

• 查询生成器查询

  code language-js
  query type=cq:Page path=/content/my-site/us/en property=jcr:content/contentType property.value=article-page orderby=@jcr:content/publishDate orderby.sort=desc

• 从Query Builder查询生成的​ XPath

  code language-js
  /jcr:root/content/my-site/us/en//element(*, cq:Page)[jcr:content/@contentType = 'article-page'] order by jcr:content/@publishDate descending

在https://oakutils.appspot.com/generate/index处将XPath（或JCR-SQL2）提供给Oak索引定义生成器，以便生成优化的Lucene属性索引定义。

生成的Lucene属性索引定义

- evaluatePathRestrictions = true
- compatVersion = 2
- type = "lucene"
- async = "async"
- jcr:primaryType = oak:QueryIndexDefinition
    + indexRules
    + cq:Page
        + properties
        + contentType
            - name = "jcr:content/contentType"
            - propertyIndex = true
        + publishDate
            - ordered = true
            - name = "jcr:content/publishDate"

以累加方式手动将生成的定义合并到现有Lucene属性索引中。 请注意不要删除现有配置，因为它们可用于满足其他查询。

1. 找到覆盖cq：Page的现有Lucene属性索引（使用索引管理器）。 在这种情况下，/oak:index/cqPageLucene。
2. 识别优化索引定义(步骤#4)和现有索引(https://experienceleague.adobe.com/oak%EF%BC%9Aindex/cqPageLucene?lang=zh-Hans)之间的配置增量，并将优化索引中缺少的配置添加到现有索引定义中。
3. 根据AEM重新索引最佳实践，刷新或重新索引将按顺序进行，具体取决于现有内容是否可能受此索引配置更改的影响。

验证查询是否未解析为现有的Lucene属性索引。 如果出现这种情况，请参阅上面关于优化和现有索引的部分。

根据需要，将查询转换为XPath或JCR-SQL2。

• 查询生成器查询

  code language-js
  type=myApp:Author property=firstName property.value=ira

• 从Query Builder查询生成的​ XPath

  code language-js
  //element(*, myApp:Page)[@firstName = 'ira']

在https://oakutils.appspot.com/generate/index处将XPath（或JCR-SQL2）提供给Oak索引定义生成器，以便生成优化的Lucene属性索引定义。

生成的Lucene属性索引定义

- compatVersion = 2
- type = "lucene"
- async = "async"
- jcr:primaryType = oak:QueryIndexDefinition
    + indexRules
    + myApp:AuthorModel
        + properties
        + firstName
            - name = "firstName"
            - propertyIndex = true

部署生成的Lucene属性索引定义。

将由Oak索引定义生成器为新索引提供的XML定义添加到管理Oak索引定义的AEM项目中(请记住，将Oak索引定义视为代码，因为代码依赖于它们)。

在通常的AEM软件开发生命周期内部署和测试新索引，并验证查询是否解析为索引以及查询是否有效。

初始部署此索引时，AEM会使用所需数据填充该索引。