疑難排解緩慢查詢 troubleshooting-slow-queries

無索引查詢

• 不 ​的查詢會解析成索引，並遍歷JCR的內容以收集結果

限制不良（或設定範圍）的查詢

• 解析成索引，但必須周遊所有索引專案以收集結果的查詢

大型結果集查詢

• 傳回大量結果的查詢

此調整是Query Builder專用，不適用於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是Query Builder查詢的重要最佳化。

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-Hant)之間的設定差異，並將最佳化索引中缺少的設定新增到現有索引定義。
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 Index Definition Generator為新索引提供的XML定義新增至管理Oak索引定義的AEM專案(記住，將Oak索引定義視為程式碼，因為程式碼視其而定)。

依照一般的AEM軟體開發生命週期，部署及測試新索引，並確認查詢解析至索引且查詢執行正常。

在此索引的初始部署中，AEM會使用必要資料填入索引。