DokumentationAEM as a Cloud ServiceBenutzerhandbuch

Inhaltssuche und -indizierung indexing

Last update: Wed Sep 04 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • Themen:

Erstellt für:

  • Admin

Änderungen in AEM as a Cloud Service changes-in-aem-as-a-cloud-service

Mit AEM as a Cloud Service stellt Adobe von einem AEM-Instanz-zentrierten Modell auf eine Service-basierte Ansicht mit n-x AEM-Containern um, unterstützt von CI/CD-Pipelines in Cloud Manager. Anstatt Indizes für einzelne AEM-Instanzen zu konfigurieren und zu verwalten, muss die Indexkonfiguration vor der Bereitstellung angegeben werden. Konfigurationsänderungen in der Produktion verstoßen eindeutig gegen CI/CD-Richtlinien. Dasselbe gilt für Indexänderungen, da sie sich auf die Systemstabilität und -leistung auswirken können, wenn sie nicht speziell getestet werden, bevor sie in die Produktion aufgenommen werden.

Nachstehend finden Sie eine Liste der wichtigsten Änderungen im Vergleich zu AEM 6.5 und früheren Versionen:

  1. Benutzende haben keinen Zugriff mehr auf den Index-Manager einer einzelnen AEM-Instanz, wenn sie die Indizierung debuggen, konfigurieren oder verwalten möchten. Er wird nur für lokale Entwicklungsumgebungen und On-Premise-Bereitstellungen verwendet.
  2. Benutzende ändern Indizes nicht in einer einzelnen AEM-Instanz und müssen sie sich keine Gedanken mehr über Konsistenzprüfungen oder Neuindizierungen machen.
  3. In der Regel werden Indexänderungen vor der Produktion eingeleitet, um Qualitäts-Gateways in den CI/CD-Pipelines von Cloud Manager nicht zu umgehen und geschäftliche KPIs in der Produktion nicht zu beeinträchtigen.
  4. Alle damit zusammenhängenden Metriken, einschließlich der Suchleistung in der Produktion, stehen Kundinnen und Kunden zur Laufzeit zur Verfügung, um eine ganzheitliche Ansicht der Themen „Suche“ und „Indizierung“ zu erhalten.
  5. Kundinnen und Kunden können entsprechend ihren Bedürfnissen Warnhinweise einrichten.
  6. SREs überwachen den Systemzustand rund um die Uhr, und Maßnahmen werden so früh wie möglich ergriffen.
  7. Die Indexkonfiguration wird über Bereitstellungen geändert. Änderungen an der Indexdefinition werden wie andere Inhaltsänderungen konfiguriert.
  8. Auf einer übergeordneten Ebene von AEM as a Cloud Service wird es mit der Einführung des rollierenden Bereitstellungsmodells zwei Indexsätze geben: einen Satz für die alte Version und einen Satz für die neue Version.
  9. Kundinnen und Kunden können überprüfen, ob der Indizierungsauftrag auf der Build-Seite von Cloud Manager abgeschlossen wurde, und erhalten eine Benachrichtigung, sobald die neue Version bereit ist, Traffic aufzunehmen.

Beschränkungen:

  • Derzeit wird die Indexverwaltung in AEM as a Cloud Service nur für Indizes des Typs lucene unterstützt.
  • Es werden nur Standard-Analyzer unterstützt (d. h. die Analyzer, die mit dem Produkt geliefert werden). Benutzerdefinierte Analyzer werden nicht unterstützt.
  • Intern können andere Indizes konfiguriert und für Abfragen verwendet werden. Zum Beispiel Abfragen, die gegen für den damAssetLucene-Index geschrieben wurden, können auf Skyline tatsächlich für eine Elasticsearch-Version dieses Index ausgeführt werden. Dieser Unterschied ist für die Anwendung und die Benutzenden normalerweise nicht sichtbar, jedoch melden bestimmte Tools wie die explain-Funktion einen anderen Index. Unterschiede zwischen Lucene-Indizes und Elastic-Indizes finden Sie in der Elastic-Dokumentation in Apache Jackrabbit Oak. Elasticsearch-Indizes müssen und können kundenseitig nicht direkt konfiguriert werden.
  • Die Suche nach ähnlichen Funktionsvektoren (useInSimilarity = true) wird nicht unterstützt.
TIP
Weitere Informationen zur Oak-Indizierung und zu Abfragen, einschließlich einer detaillierten Beschreibung der erweiterten Such- und Indizierungsfunktionen, finden Sie in der Dokumentation zu Apache Oak.

Verwendung how-to-use

Indexdefinitionen können wie folgt in drei primäre Anwendungsfälle kategorisiert werden:

  1. Hinzufügen einer neuen benutzerdefinierten Indexdefinition.
  2. Aktualisieren einer vorhandenen Indexdefinition durch Hinzufügen einer neuen Version.
  3. Entfernen einer Indexdefinition, die nicht mehr erforderlich ist.

Für die Punkte 1 und 2 müssen Sie als Teil Ihrer benutzerdefinierten Code-Basis im jeweiligen Release-Plan für Cloud Manager eine neue Indexdefinition erstellen. Weitere Informationen finden Sie in der Dokumentation Bereitstellen in AEM as a Cloud Service.

Indexnamen index-names

Eine Indexdefinition kann in eine der folgenden Kategorien unterteilt werden:

  1. Vorkonfigurierter Index. Beispiel: /oak:index/cqPageLucene-2 oder /oak:index/damAssetLucene-8.

  2. Anpassung eines vorkonfigurierten Index. Diese werden durch Anfügen von -custom-, gefolgt von einer numerischen Kennung zum ursprünglichen Indexnamen, angegeben. Beispiel: /oak:index/damAssetLucene-8-custom-1.

  3. Vollständig benutzerdefinierter Index: Es ist möglich, einen völlig neuen Index von Grund auf neu zu erstellen. Dessen Name muss über ein Präfix verfügen, um Namenskonflikte zu vermeiden. Beispiel: /oak:index/acme.product-1-custom-2, wobei das Präfix acme. ist.

NOTE
Von dem Einführen neuer Indizes für den Knotentyp dam:Asset (insbesondere Volltext-Indizes) wird dringend abgeraten, da diese mit OOTB-Produktfunktionen in Konflikt geraten können, was zu Funktions- und Leistungsproblemen führt. Im Allgemeinen stellt das Hinzufügen zusätzlicher Eigenschaften zur aktuellen Indexversion damAssetLucene-* die am besten geeignete Methode dar, um Abfragen für den Knotentyp dam:Asset zu indizieren (diese Änderungen werden automatisch zu einer neuen Produktversion des Index zusammengeführt, wenn er später veröffentlicht wird). Wenden Sie sich im Zweifelsfall an den Adobe Support.

Vorbereiten der neuen Indexdefinition preparing-the-new-index-definition

NOTE
Wenn Sie einen vorkonfigurierten Index anpassen, z. B. damAssetLucene-8, kopieren Sie die neueste vorkonfigurierte Indexdefinition aus einer Cloud Service-Umgebung mithilfe des CRX DE Package Manager (/crx/packmgr/). Benennen Sie sie in damAssetLucene-8-custom-1 (oder höher) um und fügen Sie Ihre Anpassungen in die XML-Datei ein. Dadurch wird sichergestellt, dass erforderliche Konfigurationen nicht versehentlich entfernt werden. Beispiel: der Knoten tika unter /oak:index/damAssetLucene-8/tika ist in dem angepassten Index erforderlich, der in einer AEM Cloud Service-Umgebung bereitgestellt wird, aber nicht im lokalen AEM SDK vorhanden ist.

Bereiten Sie für Anpassungen eines vorkonfigurierten Indexes ein neues Paket vor, das die tatsächliche Indexdefinition enthält und diesem Namensmuster folgt:

<indexName>-<productVersion>-custom-<customVersion>

Bereiten Sie für einen vollständig angepassten Index ein neues Indexdefinitionspaket vor, das die Indexdefinition enthält und diesem Namensmuster folgt:

<prefix>.<indexName>-<productVersion>-custom-<customVersion>

NOTE
Für jedes Inhaltspaket, das Indexdefinitionen enthält, sollten die folgenden Eigenschaften in der Datei properties.xml des Inhaltspakets festgelegt sein. properties.xml wird standardmäßig in einem neuen Paket erstellt und ist unter <package_name>/META-INF/vault/properties.xml abgelegt:

  • noIntermediateSaves=true

  • allowIndexDefinitions=true

Bereitstellen benutzerdefinierter Indexdefinitionen deploying-custom-index-definitions

Für die Veranschaulichung der Bereitstellung einer angepassten Version des vordefinierten Indexes damAssetLucene-8 erhalten Sie eine schrittweise Anleitung. In diesem Beispiel werden wir ihn in damAssetLucene-8-custom-1 umbenennen. Dann läuft der Prozess wie folgt ab:

  1. Erstellen Sie einen neuen Ordner mit dem aktualisierten Indexnamen im Verzeichnis ui.apps:

    • Beispiel: ui.apps/src/main/content/jcr_root/_oak_index/damAssetLucene-8-custom-1/

  2. Fügen Sie eine Konfigurationsdatei .content.xml mit den benutzerdefinierten Konfigurationen im erstellten Ordner hinzu. Nachfolgend finden Sie ein Beispiel für eine Anpassung:
    Dateiname: ui.apps/src/main/content/jcr_root/_oak_index/damAssetLucene-8-custom-1/.content.xml

    code language-xml 
    <?xml version="1.0" encoding="UTF-8"?>
<jcr:root xmlns:jcr="http://www.jcp.org/jcr/1.0" xmlns:dam="http://www.day.com/dam/1.0" xmlns:nt="http://www.jcp.org/jcr/nt/1.0" xmlns:oak="http://jackrabbit.apache.org/oak/ns/1.0" xmlns:rep="internal"
    jcr:mixinTypes="[rep:AccessControllable]"
    jcr:primaryType="oak:QueryIndexDefinition"
    async="[async,nrt]"
    compatVersion="{Long}2"
    evaluatePathRestrictions="{Boolean}true"
    includedPaths="[/content/dam]"
    maxFieldLength="{Long}100000"
    type="lucene">
    <facets
        jcr:primaryType="nt:unstructured"
        secure="statistical"
        topChildren="100"/>
    <indexRules jcr:primaryType="nt:unstructured">
        <dam:Asset jcr:primaryType="nt:unstructured">
            <properties jcr:primaryType="nt:unstructured">
                <cqTags
                    jcr:primaryType="nt:unstructured"
                    name="jcr:content/metadata/cq:tags"
                    nodeScopeIndex="{Boolean}true"
                    propertyIndex="{Boolean}true"
                    useInSpellcheck="{Boolean}true"
                    useInSuggest="{Boolean}true"/>
            </properties>
        </dam:Asset>
    </indexRules>
    <tika jcr:primaryType="nt:folder">
        <config.xml jcr:primaryType="nt:file"/>
    </tika>
</jcr:root>

  3. Fügen Sie einen Eintrag zum FileVault-Filter in ui.apps/src/main/content/META-INF/vault/filter.xml hinzu:

    code language-xml 
    <?xml version="1.0" encoding="UTF-8"?>
<workspaceFilter version="1.0">
    ...
    <filter root="/oak:index/damAssetLucene-8-custom-1"/>
</workspaceFilter>

  4. Fügen Sie eine Konfigurationsdatei für Apache Tika in ui.apps/src/main/content/jcr_root/_oak_index/damAssetLucene-8-custom-1/tika/config.xml hinzu:

    code language-xml 
    <properties>
    <detectors>
        <detector class="org.apache.tika.detect.TypeDetector"/>
    </detectors>
    <parsers>
        <parser class="org.apache.tika.parser.DefaultParser">
        <mime>text/plain</mime>
        </parser>
    </parsers>
    <service-loader initializableProblemHandler="ignore" dynamic="true"/>
</properties>

  5. Stellen Sie sicher, dass Ihre Konfiguration den Richtlinien entspricht, die im Abschnitt Projektkonfiguration angegeben sind. Nehmen Sie die erforderlichen Anpassungen vor.

Projektkonfiguration

Wir empfehlen dringend, eine Version >= 1.3.2 des Jackrabbit filevault-package-maven-plugin zu verwenden. Die Schritte zur Integration in Ihr Projekt sind wie folgt:

  1. Aktualisieren der Version auf der obersten Ebene pom.xml:

    code language-xml 
    <plugin>
    <groupId>org.apache.jackrabbit</groupId>
        <artifactId>filevault-package-maven-plugin</artifactId>
        ...
        <version>1.3.2</version>
    ...
</plugin>

  2. Fügen Sie der obersten Ebene pom.xml Folgendes hinzu:

    code language-xml 
    <jackrabbit-packagetype>
    <options>
        <immutableRootNodeNames>apps,libs,oak:index</immutableRootNodeNames>
    </options>
</jackrabbit-packagetype>

    Hier ein Beispiel für die Datei pom.xml der obersten Ebene des Projekts mit den oben genannten Konfigurationen:

    Dateiname: pom.xml

    code language-xml 
    <plugin>
    <groupId>org.apache.jackrabbit</groupId>
        <artifactId>filevault-package-maven-plugin</artifactId>
        ...
        <version>1.3.2</version>
        <configuration>
            ...
            <validatorsSettings>
                <jackrabbit-packagetype>
                    <options>
                        <immutableRootNodeNames>apps,libs,oak:index</immutableRootNodeNames>
                    </options>
                </jackrabbit-packagetype>
                ...
            ...
</plugin>

  3. In ui.apps/pom.xml und ui.apps.structure/pom.xml müssen die Optionen allowIndexDefinitions und noIntermediateSaves im filevault-package-maven-plugin aktiviert sein. Das Aktivieren von allowIndexDefinitions ermöglicht benutzerdefinierte Indexdefinitionen, und noIntermediateSaves stellt sicher, dass die Konfigurationen automatisch hinzugefügt werden.

    Dateinamen: ui.apps/pom.xml und ui.apps.structure/pom.xml

    code language-xml 
    <plugin>
    <groupId>org.apache.jackrabbit</groupId>
        <artifactId>filevault-package-maven-plugin</artifactId>
        <configuration>
            <allowIndexDefinitions>true</allowIndexDefinitions>
            <properties>
                <cloudManagerTarget>none</cloudManagerTarget>
                <noIntermediateSaves>true</noIntermediateSaves>
            </properties>
    ...
</plugin>

  4. Fügen Sie einen Filter für /oak:index in ui.apps.structure/pom.xml hinzu:

    code language-xml 
    <filters>
    ...
    <filter><root>/oak:index</root></filter>
</filters>

Stellen Sie nach dem Hinzufügen der neuen Indexdefinition die neue Anwendung mithilfe von Cloud Manager bereit. Diese Bereitstellung startet zwei Aufträge, die für das Hinzufügen (und gegebenenfalls das Zusammenführen) der Indexdefinitionen zu MongoDB und Azure Segment Store verantwortlich sind (für Authoring- bzw. Publishing-Zwecke). Vor dem Wechsel werden die zugrunde liegenden Repositorys einer Neuindizierung mit den aktualisierten Indexdefinitionen unterzogen.

TIP
Weitere Informationen zur erforderlichen Paketstruktur für AEM as a Cloud Service finden Sie unter AEM-Projektstruktur.

Indexverwaltung unter Verwendung von rollierenden Bereitstellungen index-management-using-rolling-deployments

Was ist Indexverwaltung? what-is-index-management

Bei der Indexverwaltung geht es darum, Indizes hinzuzufügen, zu entfernen und zu ändern. Eine Änderung der Definition eines Index geht schnell, doch die Anwendung der Änderung (häufig als „Erstellen eines Index“ oder bei vorhandenen Indizes als „Neuindizierung“ bezeichnet) erfordert Zeit. Das geht nicht sofort: Das Repository muss zunächst auf zu indizierende Daten geprüft werden.

Was sind rollierende Bereitstellungen? what-are-rolling-deployments

Eine rollierende Bereitstellung kann Ausfallzeiten reduzieren. Sie ermöglicht Upgrades ohne Ausfallzeiten sowie schnelle Rollbacks. Die alte Version der Anwendung wird gleichzeitig mit der neuen Version der Anwendung ausgeführt.

Schreibgeschützte Bereiche und Bereiche mit Lese-Schreib-Zugriff read-only-and-read-write-areas

Bestimmte Bereiche des Repositorys (schreibgeschützte Teile des Repositorys) können sich in der alten und der neuen Version der Anwendung unterscheiden. Die schreibgeschützten Bereiche des Repositorys sind in der Regel /app und /libs. Im folgenden Beispiel wird Kursivschrift verwendet, um schreibgeschützte Bereiche zu markieren, während Fettschrift für Bereiche mit Lese-Schreib-Zugriff steht.

  • /
  • /apps (schreibgeschützt)
  • /content
  • /libs (schreibgeschützt)
  • /oak:index
  • /oak:index/acme.
  • /jcr:system
  • /system
  • /var

Die Bereiche mit Lese- und Schreibzugriff des Repositorys werden von allen Versionen des Programms gemeinsam genutzt, während es für jede Version des Programms einen spezifischen Satz von /apps und /libs gibt.

Indexverwaltung ohne rollierende Bereitstellungen index-management-without-rolling-deployments

Bei der Entwicklung oder bei Verwendung von lokalen Installationen können Indizes zur Laufzeit hinzugefügt, entfernt oder geändert werden. Indizes werden verwendet, wenn sie verfügbar sind. Wenn ein Index nicht schon in der alten Version der Anwendung verwendet wird, wird der Index normalerweise während einer geplanten Ausfallzeit erstellt. Dasselbe gilt, wenn ein Index entfernt oder ein vorhandener Index geändert wird. Wenn Sie einen Index entfernen, steht er nach der Entfernung nicht mehr zur Verfügung.

Indexverwaltung mit rollierenden Bereitstellungen index-management-with-rolling-deployments

Bei rollierenden Bereitstellungen gibt es keine Ausfallzeiten. Während einer Aktualisierung werden sowohl die alte Version (z. B. Version 1) der Anwendung als auch die neue Version (Version 2) gleichzeitig für dasselbe Repository ausgeführt. Wenn für Version 1 ein bestimmter Index verfügbar sein muss, darf dieser Index in Version 2 nicht entfernt werden. Der Index sollte erst später entfernt werden, z. B. in Version 3. Ab diesem Zeitpunkt ist garantiert, dass Version 1 der Anwendung nicht mehr ausgeführt wird. Außerdem sollten Programme so geschrieben werden, dass Version 1 gut funktioniert, auch wenn Version 2 ausgeführt wird und Indizes von Version 2 verfügbar sind.

Nach Abschluss der Aktualisierung auf die neue Version können alte Indizes vom System entfernt werden. Die alten Indizes können möglicherweise noch einige Zeit bleiben, um Rollbacks zu beschleunigen (falls ein Rollback erforderlich sein sollte).

Die folgende Tabelle zeigt fünf Indexdefinitionen: der Index cqPageLucene wird in beiden Versionen verwendet, während der Index damAssetLucene-custom-1 nur in Version 2 zum Einsatz kommt.

NOTE
Die <indexName>-custom-<customerVersionNumber> ist erforderlich, damit AEM as a Cloud Service ihn als Ersatz für einen vorhandenen Index kennzeichnen kann.
Index
Vordefinierter Index
Verwendung in Version 1
Verwendung in Version 2
/oak:index/damAssetLucene
Ja
Ja
Nein
/oak:index/damAssetLucene-custom-1
Ja (angepasst)
Nein
Ja
/oak:index/acme.product-custom-1
Nein
Ja
Nein
/oak:index/acme.product-custom-2
Nein
Nein
Ja
/oak:index/cqPageLucene
Ja
Ja
Ja

Die Versionsnummer wird bei jeder Indexänderung inkrementiert. Um zu vermeiden, dass benutzerspezifische Indexnamen mit den Indexnamen des Produkts selbst kollidieren, müssen benutzerdefinierte Indizes und Änderungen an vordefinierten Indizes mit -custom-<number> enden.

Änderungen an vordefinierten Indizes changes-to-out-of-the-box-indexes

Nachdem Adobe einen vordefinierten Index wie „damAssetLucene“ oder „cqPageLucene“ geändert hat, wird ein neuer Index mit dem Namen damAssetLucene-2 oder cqPageLucene-2 erstellt. Oder wenn der Index bereits angepasst wurde, wird die angepasste Indexdefinition mit den Änderungen im vordefinierten Index zusammengeführt, wie unten dargestellt. Die Zusammenführung von Änderungen erfolgt automatisch. Das bedeutet, dass Sie nichts tun müssen, wenn sich ein vordefinierter Index ändert. Der Index lässt sich jedoch später erneut anpassen.

Index
Vordefinierter Index
Verwendung in Version 2
Verwendung in Version 3
/oak:index/damAssetLucene-custom-1
Ja (angepasst)
Ja
Nein
/oak:index/damAssetLucene-2-custom-1
Ja (automatisch aus „damAssetLucene-custom-1“ und „damAssetLucene-2“ zusammengeführt)
Nein
Ja
/oak:index/cqPageLucene
Ja
Ja
Nein
/oak:index/cqPageLucene-2
Ja
Nein
Ja

Beachten Sie, dass sich Umgebungen in verschiedenen AEM-Versionen befinden können. Beispiel: Die Umgebung dev befindet sich in Version X+1, während sich die Staging- und Produktionsumgebung noch in Version X befinden und darauf warten, auf Version X+1 aktualisiert zu werden, nachdem die erforderlichen Tests für dev durchgeführt wurden. Wenn Version X+1 mit einer neueren Version eines Produktindexes geliefert wird, der angepasst wurde, und eine neue Anpassung dieses Indexes erforderlich ist, wird in der folgenden Tabelle erläutert, welche Versionen für Umgebungen basierend auf der AEM-Version festgelegt werden müssen:

Umgebung (AEM-Release-Version)
Produktindex-Version
Vorhandene benutzerdefinierte Indexversion
Neue benutzerdefinierte Indexversion
Entwicklung (X+1)
damAssetLucene-11
damAssetLucene-11-custom-1
damAssetLucene-11-custom-2
Staging (X)
damAssetLucene-10
damAssetLucene-10-custom-1
damAssetLucene-10-custom-2
Produktion (X)
damAssetLucene-10
damAssetLucene-10-custom-1
damAssetLucene-10-custom-2

Aktuelle Einschränkungen current-limitations

Die Indexverwaltung wird derzeit nur für Indizes des Typs lucene unterstützt, wobei compatVersion auf 2 gesetzt ist. Intern können andere Indizes konfiguriert und für Abfragen verwendet werden, z. B. Elasticsearch-Indizes. Sie können Abfragen, die gegen den damAssetLucene-Index geschrieben werden, auf AEM as a Cloud Service tatsächlich für eine Elasticsearch-Version dieses Indexes ausführen. Dieser Unterschied ist für die Anwenderinnen und Anwender nicht sichtbar. Bestimmte Tools wie die explain-Funktion melden jedoch einen anderen Index. Unterschiede zwischen Lucene- und Elasticsearch-Indizes finden Sie in der Elasticsearch-Dokumentation in Apache Jackrabbit Oak. Elasticsearch-Indizes können und müssen nicht direkt konfiguriert werden.

Es werden nur integrierte Analyzer unterstützt (d. h. diejenigen, die mit dem Produkt geliefert werden). Benutzerdefinierte Analyzer werden nicht unterstützt.

Derzeit wird die Indizierung der Inhalte von /oak:index nicht unterstützt.

Um eine optimale Betriebsleistung zu erzielen, sollten Indizes nicht zu groß sein. Die Gesamtgröße aller Indizes kann als Richtwert dienen. Wenn diese Größe um mehr als 100 % zunimmt, nachdem benutzerdefinierte Indizes hinzugefügt und Standardindizes in einer Entwicklungsumgebung angepasst wurden, sollten benutzerdefinierte Indexdefinitionen angepasst werden. AEM as a Cloud Service kann die Bereitstellung von Indizes verhindern, die die Systemstabilität und -leistung negativ beeinflussen würden.

Hinzufügen eines Index adding-an-index

Um einen Index mit dem Namen /oak:index/acme.product-custom-1 hinzuzufügen, der in einer neuen Version der Anwendung und höher verwendet werden soll, muss der Index wie folgt konfiguriert werden:

acme.product-1-custom-1

Dies funktioniert, indem dem Indexnamen eine benutzerdefinierte Kennung vorangestellt wird, gefolgt von einem Punkt (.). Die Kennung muss zwischen 2 und 5 Zeichen lang sein.

Wie oben wird durch diese Konfiguration sichergestellt, dass der Index nur von der neuen Version der Anwendung verwendet wird.

Ändern eines Index changing-an-index

Wenn ein vorhandener Index geändert wird, muss ein neuer Index mit der geänderten Indexdefinition hinzugefügt werden. Angenommen, der vorhandene Index /oak:index/acme.product-custom-1 wird geändert. Der alte Index wird unter /oak:index/acme.product-custom-1, der neue Index unter /oak:index/acme.product-custom-2 gespeichert.

Die alte Version des Programms nutzt die folgende Konfiguration:

/oak:index/acme.product-custom-1

Die neue Version des Programms nutzt die folgende (geänderte) Konfiguration:

/oak:index/acme.product-custom-2

NOTE
Die Indexdefinitionen für AEM as a Cloud Service stimmen möglicherweise nicht vollständig mit den Indexdefinitionen für eine lokale Entwicklungsinstanz überein. Die Entwicklungsinstanz verfügt im Gegensatz zu AEM as a Cloud Service-Instanzen nicht über eine Tika-Konfiguration. Wenn Sie einen Index mit einer Tika-Konfiguration anpassen, behalten Sie die Tika-Konfiguration bei.

Rückgängigmachen einer Änderung undoing-a-change

Manchmal ist es erforderlich, eine Änderung in einer Indexdefinition rückgängig zu machen. Dies kann auf einen versehentlichen Fehler zurückzuführen sein, oder die Änderung ist nicht mehr erforderlich. Nehmen wir beispielsweise die Indexdefinition damAssetLucene-8-custom-3,, die versehentlich erstellt und bereits bereitgestellt wurde. Daher müssen Sie zur vorherigen Indexdefinition zurückkehren. damAssetLucene-8-custom-2. Dazu müssen Sie einen neuen Index mit dem Namen damAssetLucene-8-custom-4 einführen, der die Definition aus dem vorherigen Index enthält, damAssetLucene-8-custom-2.

Entfernen eines Index removing-an-index

Nachfolgendes gilt nur für anwenderdefinierte Indizes. Produktindizes können nicht entfernt werden, da sie von AEM verwendet werden.

Ein benutzerdefinierter Index kann in einer späteren Version der Kundenanwendung entfernt werden, indem er aus dem Kunden-Repository entfernt wird. Ein Index, der aus dem Repository entfernt wird, wird nicht für Abfragen in AEM verwendet, obwohl er möglicherweise noch eine Weile in den Instanzen vorhanden ist. Es gibt einen Bereinigungsmechanismus, der regelmäßig ausgeführt wird, um ältere Versionen von Indizes aus den Instanzen zu bereinigen.

Index- und Abfrageoptimierung index-query-optimizations

Apache Jackrabbit Oak ermöglicht flexible Indexkonfigurationen zur effizienten Verarbeitung von Suchabfragen. Indizes sind besonders für größere Repositorys wichtig. Stellen Sie sicher, dass alle Abfragen durch einen geeigneten Index gestützt werden. Bei Abfragen ohne geeigneten Index können Tausende von Knoten gelesen werden. Bei einem solchen Vorgang wird eine Warnung protokolliert.

Beachten Sie dieses Dokument für Informationen zur Optimierung von Abfragen und Indizes.

recommendation-more-help
fbcff2a9-b6fe-4574-b04a-21e75df764ab