文件AEM 6.4Deploying 指南

Oak查詢和索引 oak-queries-and-indexing

Last update: Thu May 04 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

建立對象：

  • Developer
CAUTION
AEM 6.4已結束延伸支援，本檔案不再更新。 如需詳細資訊，請參閱 技術支援期. 尋找支援的版本 此處.
NOTE
本文主要探討如何在AEM 6中設定索引。 有關優化查詢和索引效能的最佳實踐，請參見 查詢和建立索引的最佳實務.

簡介 introduction

與Jackrabbit 2不同，Oak預設不會為內容建立索引。 必要時需要建立自定義索引，與傳統關係資料庫類似。 如果沒有特定查詢的索引，則可能會遍歷許多節點。 查詢可能仍然有效，但可能非常慢。

如果Oak遇到沒有索引的查詢，則會列印WARN層級記錄訊息：

*WARN* Traversed 1000 nodes with filter Filter(query=select ...) consider creating an index or changing the query

支援的查詢語言 supported-query-languages

Oak查詢引擎支援下列語言：

  • XPath（推薦）
  • SQL-2
  • SQL（已廢止）
  • JQOM

索引器類型和成本計算 indexer-types-and-cost-calculation

Apache Oak後端可讓不同的索引器插入存放庫。

一個索引器是 屬性索引，索引定義會儲存在存放庫本身中。

適用於 阿帕奇盧塞內 和 索爾 預設也可用，兩者皆支援全文索引。

此 遍歷索引 如果沒有其他索引器可用，則會使用。 這表示內容沒有編列索引，內容節點會經過各處以尋找與查詢的相符項目。

如果一個查詢有多個索引器，則每個可用索引器估計執行該查詢的成本。 然後Oak以最低的估計成本選擇索引器。

chlimage_1-148

上圖為Apache Oak查詢執行機制的高階表示法。

首先，將查詢剖析為抽象語法樹。 接著，會檢查查詢並轉換為SQL-2（Oak查詢的原生語言）。

接下來，咨詢每個索引以估計查詢的成本。 完成後，將檢索最便宜的索引的結果。 最後，篩選結果，以確保當前用戶對結果具有讀取訪問權，並且結果與完整查詢匹配。

配置索引 configuring-the-indexes

NOTE
對於大型儲存庫，建立索引是一項耗時的操作。 對於初始建立索引和重新索引（在更改定義後重建索引），都是如此。 另請參閱 疑難排解Oak索引 和 防止慢速重新索引.

如果在非常大型的存放庫中需要重新索引，尤其是使用MongoDB和進行全文索引時，請考慮文字預先擷取，並使用oak-run來建立初始索引和重新索引。

索引在存放庫的 oak:index 節點。

索引節點的類型必須是 oak:QueryIndexDefinition。 每個索引器有幾個配置選項可用作節點屬性。 有關詳細資訊，請參見下面每個索引器類型的配置詳細資訊。

屬性索引 the-property-index

對於具有屬性約束但不是全文的查詢，屬性索引通常很有用。 您可以依照下列程式進行設定：

  1. 開啟CRXDE，方法是前往 http://localhost:4502/crx/de/index.jsp

  2. 在下建立新節點 oak:index

  3. 為節點命名 PropertyIndex，並將節點類型設定為 oak:QueryIndexDefinition

  4. 為新節點設定以下屬性：

    • 類型： property （類型為字串）
    • propertyNames: jcr:uuid （類型名稱）

    此特定範例將為 jcr:uuid 屬性，其工作是公開其所附加節點的通用唯一識別碼(UUID)。

  5. 儲存變更。

「屬性索引」具有以下配置選項：

  • 此 type 屬性將指定索引的類型，在此情況下，必須將其設定為 屬性

  • 此 propertyNames 屬性指示將儲存在索引中的屬性清單。 如果缺少，則節點名稱將用作屬性名稱引用值。 在此範例中， jcr:uuid 其作業要公開其節點的唯一識別碼(UUID)的屬性會新增至索引。

  • 此 唯一 標幟，若設為 true 在屬性索引上添加唯一性約束。

  • 此 聲明NodeTypes 屬性可讓您指定索引將僅應用於的特定節點類型。

  • 此 重新索引 標幟若設為 true，會觸發完整內容重新索引。

有序索引 the-ordered-index

Ordered索引是屬性索引的擴展。 不過，已遭取代。 此類型的索引需要替換為 Lucene屬性索引.

盧塞內全文索引 the-lucene-full-text-index

AEM 6提供以Apache Lucene為基礎的全文索引器。

如果配置了全文索引，則具有全文條件的所有查詢都使用全文索引，無論是否有其他條件已編列索引，也無論是否有路徑限制。

如果未配置全文索引，則具有全文條件的查詢將無法如預期運作。

由於索引是通過非同步的後台線程更新的，因此在完成後台進程之前，某些全文搜索將在一小段時間內不可用。

您可以依照下列程式來設定Lucene全文索引：

  1. 開啟CRXDE，並在下建立新節點 oak:index.

  2. 為節點命名 LuceneIndex 並將節點類型設定為 oak:QueryIndexDefinition

  3. 將下列屬性新增至節點：

    • 類型： lucene （類型為字串）
    • async: async （類型為字串）

  4. 儲存變更。

Lucene索引具有以下配置選項：

  • 此 type 將指定索引類型的屬性必須設定為 lucene
  • 此 async 必須設定為的屬性 async. 這會將索引更新程式傳送至背景執行緒。
  • 此 includePropertyTypes 屬性，定義將包含在索引中的屬性類型子集。
  • 此 excludePropertyNames 屬性，定義屬性名稱清單 — 應從索引中排除的屬性。
  • 此 重新索引 將設為時標幟 true，會觸發完整內容重新索引。

Lucene屬性索引 the-lucene-property-index

自 Oak 1.0.8, Lucene可用來建立涉及非全文屬性限制的索引。

為了實現Lucene屬性索引，請 fulltextEnabled 屬性必須一律設為false。

以下列範例查詢為例：

select * from [nt:base] where [alias] = '/admin'

為了為上述查詢定義Lucene屬性索引，可以通過在下建立新節點來添加以下定義 oak

  • 名稱: LucenePropertyIndex
  • 類型： oak:QueryIndexDefinition

建立節點後，新增下列屬性：

  • 類型:

    code language-none 
    lucene (of type String)

  • 非同步處理:

    code language-none 
    async (of type String)

  • fulltextEnabled:

    code language-none 
    false (of type Boolean)

  • includePropertyNames: [alias] （類型為字串）

NOTE
與常規屬性索引相比， Lucene屬性索引始終以非同步模式配置。 因此，索引返回的結果可能並不總是反映儲存庫的最新狀態。
NOTE
有關Lucene屬性索引的更多具體資訊，請參見 Apache Jackrabbit Oak Lucene檔案頁面.

盧塞內分析器 lucene-analyzers

自1.2.0版起，Oak支援Lucene分析器。

在對文檔編製索引時和在查詢時都使用分析器。 分析器檢查欄位文本並生成令牌流。 Lucene分析器由一系列標籤器和過濾器類組成。

分析器可透過 analyzers 節點（類型） nt:unstructured)內 oak:index 定義。

索引的預設分析器配置在 default 分析器節點的子項。

chlimage_1-149

NOTE
如需可用分析器的清單，請參閱您所使用Lucene版本的API檔案。

直接指定分析器類 specifying-the-analyzer-class-directly

如果要使用任何現成分析器，可以按照以下過程進行配置：

  1. 找到要使用分析器的索引，其位於 oak:index 節點。

  2. 在索引下，建立名為的子節點 default 類型 nt:unstructured.

  3. 將屬性新增至預設節點，並具有下列屬性：

    • 名稱: class
    • 類型： String
    • 值: org.apache.lucene.analysis.standard.StandardAnalyzer

    值是要使用的分析器類的名稱。

    您也可以使用可選 luceneMatchVersion 字串屬性。 與Lucene 4.7一起使用的有效合成酶是：

    • 名稱: luceneMatchVersion
    • 類型： String
    • 值: LUCENE_47

    若 luceneMatchVersion 未提供，則Oak會使用隨附的Lucene版本。

  4. 如果要向分析器配置中添加秒數檔案，可以在 default 其中一個具有以下屬性：

    • 名稱: stopwords
    • 類型： nt:file

透過合成建立分析器 creating-analyzers-via-composition

分析器也可依據 Tokenizers, TokenFilters 和 CharFilters. 您可以通過指定分析器並建立其可選標籤和篩選器的子節點來執行此操作，這些節點將按列出順序應用。 另請參閱 https://wiki.apache.org/solr/AnalyzersTokenizersTokenFilters#Specifying_an_Analyzer_in_the_schema

以此節點結構為例：

  • 名稱: analyzers

    • 名稱: default

      • 名稱: charFilters

      • 類型： nt:unstructured

        • 名稱: HTMLStrip
        • 名稱: Mapping

      • 名稱: tokenizer

        • 屬性名稱: name

          • 類型： String
          • 值: Standard

      • 名稱: filters

      • 類型： nt:unstructured

        • 名稱: LowerCase

        • 名稱: Stop

          • 屬性名稱: words

            • 類型： String
            • 值: stop1.txt, stop2.txt

          • 名稱: stop1.txt

            • 類型： nt:file

          • 名稱: stop2.txt

            • 類型： nt:file

篩選器、charFilters和標籤器的名稱是通過刪除工廠尾碼而形成的。 因此：

  • org.apache.lucene.analysis.standard.StandardTokenizerFactory com standard

  • org.apache.lucene.analysis.charfilter.MappingCharFilterFactory com Mapping

  • org.apache.lucene.analysis.core.StopFilterFactory com Stop

工廠所需的任何配置參數都指定為有關節點的屬性。

若是載入需要載入來自外部檔案的內容的停止字詞，則可透過建立的子節點來提供內容 nt:file 輸入相關檔案的。

索爾指數 the-solr-index

Solr索引的目的主要是全文搜索，但它也可以用於按路徑、屬性限制和主類型限制進行索引搜索。 這表示Oak中的Solr索引可用於任何類型的JCR查詢。

AEM中的整合會在存放庫層級進行，因此Solr是可用於Oak(AEM隨附的新存放庫實作)的其中一個可能索引。

AEM也可設定為與遠端Solr伺服器例項搭配使用：

  1. 下載並解壓最新版本的Solr。 如需如何執行此作業的詳細資訊，請參閱 Apache Solr安裝檔案.

  2. 現在，建立兩個索爾碎片。 您可以為Solr被封鎖的資料夾中的每個共用建立資料夾，以執行此操作：

    • 對於第一個共用，建立資料夾：

    <solrunpackdirectory>\aemsolr1\node1

    • 對於第二個共用，建立資料夾：

    <solrunpackdirectory>\aemsolr2\node2

  3. 在Solr包中找到示例實例。 它通常位於名為「 example」（位於包的根目錄中）。

  4. 將下列資料夾從範例例項複製到兩個共用資料夾( aemsolr1\node1 和 aemsolr2\node2):

    • contexts
    • etc
    • lib
    • resources
    • scripts
    • solr-webapp
    • webapps
    • start.jar

  5. 建立名為「 cfg」（在兩個共用資料夾中的每一個）。

  6. 將Solr和Zookeeper組態檔放置在新建立的 cfg 資料夾。

    note note
    NOTE
    有關Solr和ZooKeeper配置的詳細資訊，請參閱 Solr配置文檔 和 《 ZooKeeper入門手冊》.

  7. 前往，以ZooKeeper支援啟動第一個共用區 aemsolr1\node1 並運行以下命令：

    code language-xml 
    java -Xmx2g -Dbootstrap_confdir=./cfg/oak/conf -Dcollection.configName=myconf -DzkRun -DnumShards=2 -jar start.jar

  8. 開始第二個分片，前往 aemsolr2\node2 並運行以下命令：

    code language-xml 
    java -Xmx2g -Djetty.port=7574 -DzkHost=localhost:9983 -jar start.jar

  9. 啟動兩個分片後，通過連接到Solr介面(位於 http://localhost:8983/solr/#/

  10. 啟動AEM並前往Web主控台： http://localhost:4502/system/console/configMgr

  11. 在 Oak Solr遠程伺服器配置:

    • Sol HTTP URL: http://localhost:8983/solr/

  12. 選擇 遠程解決方案 下拉式清單中 奧克索爾 伺服器提供者。

  13. 前往CRXDE並以管理員身分登入。

  14. 建立名為 solrIndex 在 oak:index，並設定下列屬性：

    • 類型： ​solr（類型為字串）
    • async: ​async（類型為字串）
    • reindex: ​true（類型為布林值）

  15. 儲存變更。

Solr的建議配置 recommended-configuration-for-solr

下面是基本配置的示例，可用於本文中描述的所有三個Solr部署。 它可容納AEM中已存在且不應與其他應用程式搭配使用的專用屬性索引。

為了正確使用它，您需要將存檔的內容直接放在Solr Home Directory中。 若是多節點部署，則應直接前往每個節點的根資料夾底下。

建議的Solr配置檔案

取得檔案

AEM索引工具 aem-indexing-tools

AEM 6.1也整合了AEM 6.0中提供的兩種索引工具，作為Adobe諮詢服務公域工具集的一部分：

  1. 說明查詢，此工具旨在協助管理員了解查詢的執行方式；
  2. Oak Index Manager，此介面用於維護現有索引。

您現在可以前往 工具 — 操作 — 儀表板 — 診斷 從AEM歡迎畫面。

如需如何使用它們的詳細資訊，請參閱 Operations Dashboard檔案.

通過OSGi建立屬性索引 creating-property-indexes-via-osgi

ACS Commons包還公開可用於建立屬性索引的OSGi配置。

您可以搜尋「確保Oak屬性索引」。

chlimage_1-150

疑難排解索引問題 troubleshooting-indexing-issues

查詢執行時間較長，且一般系統回應時間較慢的情況可能會出現。

本節提供一套建議，說明需要採取哪些措施來追蹤這些問題的原因，並就如何解決這些問題提供建議。

準備分析的除錯資訊 preparing-debugging-info-for-analysis

要取得要執行之查詢的必要資訊，最簡單的方式是透過 說明查詢工具. 這可讓您收集對慢速查詢進行偵錯所需的精確資訊，而無須查詢記錄層級資訊。 如果您知道要除錯的查詢，則這是理想的作法。

如果由於任何原因不可能，您可以在單一檔案中收集索引記錄，並使用它來疑難排解您的特定問題。

啟用記錄 enable-logging

若要啟用記錄功能，您必須啟用 除錯 與Oak索引和查詢相關的類別的層級記錄。 這些類別包括：

  • org.apache.jackrabbit.oak.plugins.index
  • org.apache.jackrabbit.oak.query
  • com.day.cq.search

此 com.day.cq.search 類別僅適用於使用AEM提供的QueryBuilder公用程式時。

NOTE
請務必在您要疑難排解的查詢執行期間，將記錄檔設為DEBUG，否則隨著時間推移，記錄檔中將會產生大量事件。 因此，收集到所需記錄後，系統會針對上述類別切換回資訊層級記錄。

您可以依照以下程式啟用記錄：

  1. 將瀏覽器指向 https://serveraddress:port/system/console/slinglog

  2. 按一下 添加新記錄器 按鈕。

  3. 在新建立的列中，新增上述類別。 您可以使用 + 登入以新增多個類別至單一記錄器。

  4. 選擇 除錯 從 記錄層級 下拉式清單。

  5. 將輸出檔案設定為 logs/queryDebug.log. 這會將所有除錯事件關聯至單一記錄檔。

  6. 執行查詢或呈現使用您要除錯的查詢的頁面。

  7. 執行查詢後，返回記錄控制台，並將新建立記錄器的記錄層級變更為 資訊.

索引配置 index-configuration

查詢的評估方式在很大程度上受索引配置的影響。 必須獲取索引配置，以便分析或發送給支援。 您可以以內容套件形式取得設定，或取得JSON轉譯。

由於在大多數情況下，索引設定會儲存在 /oak:index 節點，您可以在取得JSON版本：

https://serveraddress:port/oak:index.tidy.-1.json

如果索引配置在不同的位置，請相應地更改路徑。

MBean輸出 mbean-output

在某些情況下，提供索引相關MBean的輸出以進行偵錯是很有幫助的。 您可以透過以下方式進行：

  1. 前往JMX控制台：
    https://serveraddress:port/system/console/jmx

  2. 搜索以下MBean:

    • 盧塞內索引統計資訊
    • CopyOnRead支援統計資訊
    • Oak查詢統計資料
    • IndexStats

  3. 按一下每個MBean以獲取效能統計資訊。 建立螢幕截圖或記下來，以備需要提交支援時使用。

您也可以在下列URL取得這些統計資料的JSON變體：

  • https://serveraddress:port/system/sling/monitoring/mbeans/org/apache/jackrabbit/oak/%2522LuceneIndex%2522.tidy.-1.json
  • https://serveraddress:port/system/sling/monitoring/mbeans/org/apache/jackrabbit/oak/%2522LuceneIndex%2522.tidy.-1.json
  • https://serveraddress:port/system/sling/monitoring/mbeans/org/apache/jackrabbit/oak/%2522LuceneIndex%2522.tidy.-1.json
  • https://serveraddress:port/system/sling/monitoring/mbeans/org/apache/jackrabbit/oak/%2522LuceneIndex%2522.tidy.-1.json

您也可以通過 https://serveraddress:port/system/sling/monitoring/mbeans/org/apache/jackrabbit/oak.tidy.3.json. 這會包含JSON格式的所有Oak相關MBean詳細資訊。

其他詳細資訊 other-details

您可以收集其他詳細資訊，以協助疑難排解問題，例如：

  1. 您執行個體執行的Oak版本。 您可以開啟CRXDE並查看歡迎頁面右下角的版本，或檢查的版本，即可看到此內容 org.apache.jackrabbit.oak-core 捆綁。
  2. 麻煩查詢的QueryBuilder Debugger輸出。 除錯工具的存取位置： https://serveraddress:port/libs/cq/search/content/querydebug.html
recommendation-more-help
6a71a83d-c2e0-4ce7-a6aa-899aa3885b56