Innehållssökning och indexering indexing

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

Med AEM as a Cloud Service går Adobe från en AEM instanscentrerad modell till en tjänstebaserad vy med n-x-AEM-behållare, som drivs av CI/CD-pipelines i Cloud Manager. I stället för att konfigurera och underhålla index för enskilda AEM måste indexkonfigurationen anges före en distribution. Konfigurationsförändringar i produktionen bryter helt klart CI/CD-reglerna. Detsamma gäller för indexändringar eftersom det kan påverka systemets stabilitet och prestanda om det inte anges testat och omindexerat innan de tas i produktion.

Nedan finns en lista över de viktigaste ändringarna jämfört med AEM 6.5 och tidigare versioner:

Begränsningar:

Använda how-to-use

Indexdefinitioner kan kategoriseras i tre primära användningsområden:

För båda punkterna 1 och 2 ovan måste du skapa en indexdefinition som en del av din anpassade kodbas i respektive Cloud Manager-utgåva. Mer information finns i Distribuera till AEM as a Cloud Service dokumentation.

Indexnamn index-names

En indexdefinition kan delas in i någon av följande kategorier:

Förbereder den nya indexdefinitionen preparing-the-new-index-definition

Om du vill anpassa ett OOTB-index förbereder du ett nytt paket som innehåller den faktiska indexdefinitionen som följer namnmönstret:

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

För ett helt anpassat index skapar du ett nytt indexdefinitionspaket som innehåller indexdefinitionen som följer detta namnmönster:

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

Distribuera anpassade indexdefinitioner deploying-custom-index-definitions

Så här illustrerar du hur en anpassad version av det körklara indexvärdet används damAssetLucene-8kommer vi att tillhandahålla en stegvis guide. I det här exemplet byter vi namn på den till damAssetLucene-8-custom-1. Sedan är processen följande:

Projektkonfiguration

Vi rekommenderar starkt att du använder version >= 1.3.2 av Jackrabbit filevault-package-maven-plugin. Så här implementerar du den i ditt projekt:

När du har lagt till den nya indexdefinitionen distribuerar du det nya programmet med Cloud Manager. Distributionen initierar två jobb som ansvarar för att lägga till (och sammanfoga om det behövs) indexdefinitionerna i MongoDB och Azure Segment Store för författare respektive publicering. Före bytet omindexeras de underliggande databaserna med de uppdaterade indexdefinitionerna.

Indexhantering med rullande distributioner index-management-using-rolling-deployments

Vad är indexhantering? what-is-index-management

Indexhantering handlar om att lägga till, ta bort och ändra index. Ändra definition för ett index är snabbt, men det tar lång tid att tillämpa ändringen (kallas ofta"skapa ett index" eller"omindexering" för befintliga index). Det är inte omedelbart: databasen måste genomsökas för att data ska kunna indexeras.

Vad är rullande distributioner? what-are-rolling-deployments

En rullande driftsättning kan minska driftstoppen. Det ger även inga driftavbrott och ger snabba återställningar. Den gamla versionen av programmet körs samtidigt som den nya versionen av programmet.

Skrivskyddade och skrivskyddade områden read-only-and-read-write-areas

Vissa delar av databasen (skrivskyddade delar av databasen) kan vara olika i den gamla och den nya versionen av programmet. De skrivskyddade områdena i databasen är vanligtvis /app och /libs. I följande exempel används kursiv för att markera skrivskyddade områden, medan fetstil används för skrivskyddade områden.

Databasens läs- och skrivområden delas mellan alla programversioner, medan det för varje programversion finns en specifik uppsättning /apps och /libs.

Indexhantering utan rullande distributioner index-management-without-rolling-deployments

Under utvecklingen, eller när du använder lokala installationer, kan index läggas till, tas bort eller ändras under körningen. Index används när de är tillgängliga. Om ett index ännu inte används i den gamla versionen av programmet skapas det vanligtvis under en schemalagd driftstopp. Samma sak händer när du tar bort ett index eller ändrar ett befintligt index. När du tar bort ett index blir det otillgängligt när det tas bort.

Indexhantering med rullande distributioner index-management-with-rolling-deployments

Med rullande driftsättningar sker inga driftavbrott. Under en uppdatering körs både den gamla versionen (till exempel version 1) av programmet och den nya versionen (version 2) samtidigt mot samma databas. Om version 1 kräver att ett visst index är tillgängligt får detta index inte tas bort i version 2. Indexet bör tas bort senare, t.ex. i version 3, där det är garanterat att version 1 av programmet inte längre körs. Dessutom bör program skrivas så att version 1 fungerar bra, även om version 2 körs, och om det finns index för version 2.

När uppgraderingen till den nya versionen är klar kan gamla index samlas in av systemet. De gamla indexen kan fortfarande finnas kvar en tid för att påskynda återställningen (om en återställning behövs).

I följande tabell visas fem indexdefinitioner: index cqPageLucene används i båda versionerna medan index damAssetLucene-custom-1 används endast i version 2.

Versionsnumret ökas stegvis varje gång indexvärdet ändras. För att undvika att egna indexnamn kolliderar med indexnamnen för själva produkten måste anpassade index och ändringar i färdiga index sluta med -custom-<number>.

Ändringar av färdiga index changes-to-out-of-the-box-indexes

Efter att Adobe har ändrat ett index som inte finns med i kartongen, som "damAssetLucene" eller "cqPageLucene", ett nytt index med namnet damAssetLucene-2 eller cqPageLucene-2 skapas. Om indexet redan har anpassats sammanfogas den anpassade indexdefinitionen med ändringarna i det körklara indexet, vilket visas nedan. Ändringarna sammanfogas automatiskt. Det innebär att du inte behöver göra något om ett index som inte finns i kartongen ändras. Det går dock att anpassa indexet igen senare.

Aktuella begränsningar current-limitations

Indexhantering stöds bara för index av typen lucene, med compatVersion ange till 2. Internt kan andra index konfigureras och användas för frågor, till exempel Elasticsearch-index. Frågor som skrivs mot damAssetLucene på AEM as a Cloud Service kan ett index i själva verket köras mot en Elasticsearch-version av detta index. Skillnaden är osynlig för programanvändaren, men vissa verktyg, som explain funktionen rapporterar ett annat index. Skillnader mellan indexen Lucene och Elasticsearch finns i Elasticsearch dokumentation i Apache Jackrabbit Oak. Kunder kan inte och behöver inte konfigurera Elasticsearch-index direkt.

Endast inbyggda analysatorer stöds (det vill säga analysatorer som levereras tillsammans med produkten). Anpassade analysatorer stöds inte.

För bästa prestanda bör index inte vara alltför stora. Den totala storleken för alla index kan användas som vägledning. Om den här storleken ökar med mer än 100 % efter att anpassade index har lagts till och standardindex har justerats i en utvecklingsmiljö, bör anpassade indexdefinitioner justeras. AEM as a Cloud Service kan förhindra användning av index som skulle påverka systemets stabilitet och prestanda negativt.

Lägga till ett index adding-an-index

Lägga till ett helt anpassat index med namnet /oak:index/acme.product-custom-1För att kunna användas i en ny version av programmet och senare måste indexet konfigureras på följande sätt:

acme.product-1-custom-1

Den här konfigurationen fungerar genom att en anpassad identifierare försätts i indexnamnet, följt av en punkt (.). Identifieraren ska vara mellan 2 och 5 tecken lång.

Som ovan säkerställer den här konfigurationen att indexet bara används av den nya versionen av programmet.

Ändra ett index changing-an-index

När ett befintligt index ändras måste ett nytt index läggas till med den ändrade indexdefinitionen. Ta till exempel det befintliga indexet /oak:index/acme.product-custom-1 ändras. Det gamla indexet lagras under /oak:index/acme.product-custom-1och det nya indexet lagras under /oak:index/acme.product-custom-2.

I den gamla versionen av programmet används följande konfiguration:

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

I den nya versionen av programmet används följande (ändrade) konfiguration:

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

Ångra en ändring undoing-a-change

Ibland behöver du ångra en ändring i en indexdefinition. Detta kan bero på ett oavsiktligt fel eller på att ändringen inte längre behövs. Ta till exempel indexdefinitionen damAssetLucene-8-custom-3, som har skapats av misstag och redan har distribuerats. Därför vill du återgå till den tidigare indexdefinitionen, damAssetLucene-8-custom-2. För att uppnå detta måste du infoga ett nytt index med namnet damAssetLucene-8-custom-4 som innehåller definitionen från föregående index, damAssetLucene-8-custom-2.

Ta bort ett index removing-an-index

Följande gäller bara för anpassade index. Produktindex kan inte tas bort eftersom de används av AEM.

Om ett index tas bort i en senare version av programmet kan du definiera ett tomt index (ett tomt index som aldrig används och som inte innehåller några data) med ett nytt namn. I det här exemplet kan du ge det ett namn /oak:index/acme.product-custom-3. Det här namnet ersätter indexet /oak:index/acme.product-custom-2. Efter /oak:index/acme.product-custom-2 tas bort av systemet, det tomma indexet /oak:index/acme.product-custom-3 kan sedan tas bort. Ett exempel på ett sådant tomt index är:

<acme.product-custom-3
        jcr:primaryType="oak:QueryIndexDefinition"
        async="async"
        compatVersion="2"
        includedPaths="/dummy"
        queryPaths="/dummy"
        type="lucene">
        <indexRules jcr:primaryType="nt:unstructured">
            <rep:root jcr:primaryType="nt:unstructured">
                <properties jcr:primaryType="nt:unstructured">
                    <dummy
                        jcr:primaryType="nt:unstructured"
                        name="dummy"
                        propertyIndex="{Boolean}true"/>
                </properties>
            </rep:root>
        </indexRules>
</acme.product-custom-3>

Om det inte längre behövs någon anpassning av ett index som inte finns i kartongen måste du kopiera indexdefinitionen. Om du till exempel redan har distribuerat damAssetLucene-8-custom-3, men behöver inte längre anpassningar och vill växla tillbaka till standardinställningen damAssetLucene-8 index, måste du lägga till ett index damAssetLucene-8-custom-4 som innehåller indexdefinitionen för damAssetLucene-8.

Optimeringar av index och frågor index-query-optimizations

Apache Jackrabbit Oak möjliggör flexibla indexkonfigurationer för att effektivt hantera sökfrågor. Index är särskilt viktiga för större databaser. Se till att alla frågor backas upp av ett lämpligt index. Frågor utan lämpligt index kan läsa tusentals noder, som sedan loggas som en varning.

Se det här dokumentet för information om hur frågor och index kan optimeras.