Adobe Experience Manager as a Cloud Service中自訂Oak索引的「未偵測到索引的查詢」警報

本文說明如何透過驗證和更新自訂Adobe Experience Manager as a Cloud Service索引定義來解析Oak中的「未偵測到索引的查詢」警報,以確保查詢使用預期的索引,而不是遞補為周遊。

說明 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. 執行受影響的查詢,或選取 說明 以檢視選取的索引。

  3. 如果查詢未使用預期的自訂索引或計畫顯示周遊,請檢閱自訂索引定義。 請確定它支援查詢的需求:

    • 節點型別: cq:Page
    • 屬性限制: jcr:content/cq:tags
    • Ordered屬性: jcr:content/publishedDate,遞減排序
    • 路徑限制:相關的內容路徑,例如/content/.../news
    • 索引標籤: customNewsLucene,符合查詢的明確索引標籤
  4. 透過Cloud Manager部署更新的索引定義。 在驗證查詢之前,請等待索引更新完成。

  5. 使用查詢效能工具來確認執行計畫使用預期的自訂索引、處理查詢限制和排序,並且不顯示周遊。

  6. 選擇性地在動作中心監視查詢數天,以檢查是否顯示新的 未偵測到索引的查詢 警示。

  7. 針對未來的索引變更,請在生產部署之前在生產環境較低層級環境中驗證這些變更。 使用查詢效能工具的 Explain 功能來確認選取索引。

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