Oak-Abfragen und Indizierung

Letzte Aktualisierung: 16. Juni 2025
  • Gilt für:
  • Experience Manager 6.5

Erstellt für:

  • Admin
HINWEIS
In diesem Artikel geht es um die Konfiguration von Indizes in AEM 6. Informationen zur besten Vorgehensweise beim Optimieren von Abfragen- und Indizierungsleistung finden Sie unter Best Practices für Abfragen und Indizierung.

Einführung

Im Gegensatz zu Jackrabbit 2 indiziert Oak Inhalte nicht standardmäßig. Benutzerdefinierte Indizes müssen daher bei Bedarf erstellt werden, ähnlich wie bei herkömmlichen relationalen Datenbanken. Wenn für eine bestimmte Abfrage kein Index vorhanden ist, kann es sein, dass viele Knoten durchlaufen werden. Die Abfrage funktioniert möglicherweise immer noch, ist aber wahrscheinlich langsam.

Wenn Oak auf eine Abfrage ohne Index stößt, wird eine Protokollmeldung der Stufe WARNUNG ausgegeben:

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

Unterstützte Abfragesprachen

Die Oak-Abfrage-Engine unterstützt die folgenden Sprachen:

  • XPath (empfohlen)
  • SQL-2
  • SQL (veraltet)
  • JQOM

Indextypen und Kostenberechnung

Das auf Apache Oak basierende Backend ermöglicht die Einbindung verschiedener Indexer in das Repository.

Ein Indexer ist der Eigenschaftenindex, für den die Indexdefinition im Repository selbst gespeichert wird.

Implementierungen für Apache Lucene und Solr sind ebenfalls standardmäßig verfügbar und unterstützen die Volltextindizierung.

Der Traversalindex  wird verwendet, wenn kein anderer Indexer verfügbar ist. Das bedeutet, dass der Inhalt nicht indiziert ist und Inhaltsknoten durchlaufen werden, um Übereinstimmungen mit der Abfrage zu finden.

Wenn für eine Abfrage mehrere Indexer verfügbar sind, schätzt jeder verfügbare Indexer die Kosten für die Ausführung der Abfrage. Oak wählt dann den Indexer mit den niedrigsten geschätzten Kosten aus.

chlimage_1-148

Die obige Abbildung ist eine allgemeine Darstellung des Abfrageausführungsmechanismus von Apache Oak.

Zunächst wird die Abfrage in eine abstrakte Syntaxstruktur geparst. Anschließend wird die Abfrage überprüft und in SQL-2 (die native Sprache für Oak-Abfragen) umgewandelt.

Anschließend wird jeder Index zur Schätzung der Kosten für die Abfrage herangezogen. Danach werden die Ergebnisse aus dem günstigsten Index abgerufen. Schließlich werden die Ergebnisse gefiltert, um sicherzustellen, dass die aktuelle Benutzerin bzw. der aktuelle Benutzer Lesezugriff auf das Ergebnis hat und dass das Ergebnis mit der vollständigen Abfrage übereinstimmt.

Konfigurieren der Indizes

HINWEIS
Bei großen Repositorys ist das Erstellen eines Index ein zeitaufwendiger Vorgang. Dies gilt sowohl für die erstmalige Indexerstellung als auch für eine Neuindizierung (Neuerstellung des Index nach Änderung der Definition). Weitere Informationen finden Sie unter Fehlerbehebung bei Oak-Indizes und Verhindern einer langsamen Neuindizierung.

Wenn große Repositorys neu indiziert werden müssen, insbesondere wenn MongoDB verwendet wird und eine Volltextindizierung erforderlich ist, empfiehlt es sich gegebenenfalls, eine Textvorextraktion durchzuführen, den Ausgangsindex mit „oak-run“ zu erstellen und anschließend eine Neuindizierung durchzuführen.

Indizes werden im Repository unter dem Knoten Oak:index als Knoten konfiguriert.

Der Typ des Indexknotens muss wie folgt lauten: oak:QueryIndexDefinition. Für jeden Indexer sind mehrere Konfigurationsoptionen als Knoteneigenschaften verfügbar. Weitere Informationen finden Sie unten in den Konfigurationsdetails für jeden Indexertyp.

Der Eigenschaftenindex

Der Eigenschaftenindex ist für Abfragen nützlich, die Eigenschaftseinschränkungen aufweisen, aber keine Volltextelemente sind. Der Index kann wie folgt konfiguriert werden:

  1. Öffnen Sie CRXDE, indem Sie zu http://localhost:4502/crx/de/index.jsp gehen.

  2. Erstellen Sie einen Knoten unter oak:index

  3. Nennen Sie den Knoten PropertyIndex und legen Sie den Knotentyp auf oak:QueryIndexDefinition fest

  4. Legen Sie die folgenden Eigenschaften für den neuen Knoten fest:

    • type: property (vom Typ Zeichenfolge)
    • propertyNames: jcr:uuid (vom Typ „Name“)

    Bei diesem Beispiel wird die Eigenschaft jcr:uuid indiziert, die dazu dient, den UUID (Universally Unique Identifier) des verknüpften Knotens anzuzeigen.

  5. Speichern Sie die Änderungen.

Der Eigenschaftenindex verfügt über die folgenden Konfigurationsoptionen:

  • Die Eigenschaft type gibt den Indextyp an und muss in diesem Fall property lauten.

  • Die Eigenschaft propertyNames gibt die Liste der Eigenschaften an, die im Index gespeichert werden. Wenn sie fehlt, wird der Knotenname als Referenzwert für den Eigenschaftsnamen verwendet. In diesem Beispiel wird die Eigenschaft jcr:uuid, deren Aufgabe darin besteht, die eindeutige Kennung (UUID) ihres Knotens anzuzeigen, zum Index hinzugefügt.

  • Falls für die Kennzeichnung unique der Wert true festgelegt ist, wird dadurch eine Eindeutigkeitsbeschränkung auf den Eigenschaften-Index angewendet.

  • Mit der Eigenschaft declaringNodeTypes können Sie einen bestimmten Knotentyp angeben, für den der Index ausschließlich gilt.

  • Falls für das Flag reindex der Wert auf true festgelegt ist, wird eine vollständige Neuindizierung des Inhalts ausgelöst.

Der Index „Geordnet“

Der Index „Geordnet“ ist eine Erweiterung des Eigenschaftenindex. Er wird jedoch nicht mehr unterstützt. Indizes dieses Typs müssen durch den Lucene-Eigenschaften-Index ersetzt werden.

Der Lucene-Volltext-Index

AEM 6 beinhaltet einen auf Apache Lucene basierten Indexer.

Wenn ein Volltextindex konfiguriert ist, verwenden alle Abfragen mit einer Volltextbedingung den Volltextindex, unabhängig davon, ob andere Bedingungen indiziert sind oder ob eine Pfadbeschränkung vorliegt.

Wenn kein Volltextindex konfiguriert ist, funktionieren Abfragen mit Volltextbedingungen nicht erwartungsgemäß.

Da der Index über einen asynchronen Hintergrund-Thread aktualisiert wird, sind bestimmte Volltextsuchen für einen kurzen Zeitraum nicht verfügbar, bis die Prozesse im Hintergrund beendet sind.

Sie können einen Lucene-Volltextindex wie folgt konfigurieren:

  1. Öffnen Sie CRXDE und erstellen Sie einen Knoten unter oak:index.

  2. Nennen Sie den Knoten LuceneIndex und legen Sie den Knotentyp auf oak:QueryIndexDefinition fest

  3. Fügen Sie dem Knoten folgende Eigenschaften hinzu:

    • type: lucene (vom Typ Zeichenfolge)
    • async: async (vom Typ Zeichenfolge)

  4. Speichern Sie die Änderungen.

Der Lucene-Index verfügt über die folgenden Konfigurationsoptionen:

  • Die Eigenschaft type, die den Indextyp angibt, muss auf lucene festgelegt sein
  • Die Eigenschaft async, die auf async festgelegt sein muss. Dadurch wird der Indexaktualisierungsprozess an einen Hintergrund-Thread gesendet.
  • Die Eigenschaft includePropertyTypes, die definiert, welche Untergruppe von Eigenschaftstypen im Index enthalten sind.
  • Die Eigenschaft excludePropertyNames, die eine Liste mit Eigenschaftennamen definiert, nämlich Eigenschaften, die vom Index ausgeschlossen sein sollen.
  • Das Flag reindex, das bei Festlegung auf true eine vollständige Neuindizierung des Inhalts auslöst.