Generieke Lucene-index verwijderen
Gemaakt voor:
- Beheerder
Adobe is van plan om de "generische index van Lucene"(/oak:index/lucene-*) uit Adobe Experience Manager as a Cloud Service te verwijderen. Deze index is vervangen sinds AEM 6.5. In dit document wordt het effect van dit besluit beschreven, samen met een gedetailleerde beschrijving van de wijze waarop moet worden onderzocht of een AEM instantie wordt beïnvloed. Het bevat ook manieren om vragen te veranderen zodat blijven zij zonder de generische index van Lucene functioneren.
Achtergrond
In AEM, zijn de volledige tekstvragen die die de volgende functies gebruiken:
jcr:contains()in JCR XPATHCONTAINSin JCR-SQL2
Dergelijke vragen kunnen geen resultaten zonder een index terugkeren. In tegenstelling tot een vraag die slechts weg of bezitsbeperkingen bevat, zal een vraag die een volledige tekstbeperking bevat waarvoor geen index kan worden gevonden (en zo wordt een traversal uitgevoerd) altijd nul resultaten terugkeren.
De generieke index van Lucene (/oak:index/lucene-*) bestaat sinds AEM 6.0 / Oak 1.0 om een volledige tekstonderzoek over het grootste deel van de repository hiërarchie te verstrekken, hoewel sommige wegen, zoals /jcr:system en /var altijd van dit zijn uitgesloten. Deze index is echter grotendeels vervangen door indexen op specifiekere knooppunttypen (bijvoorbeeld damAssetLucene-* voor het knooppunttype dam:Asset ), die zowel zoekopdrachten in volledige tekst als in eigenschappen ondersteunen.
In AEM 6.5 werd de generische index van Lucene gemerkt zoals afgekeurd, erop wijzend dat het in toekomstige versies zou worden verwijderd. Sindsdien, is WARN geregistreerd wanneer de index is gebruikt zoals geïllustreerd door het volgende logboekfragment:
org.apache.jackrabbit.oak.plugins.index.lucene.LucenePropertyIndex This index is deprecated: /oak:index/lucene-2; it is used for query Filter(query=select [jcr:path], [jcr:score], * from [nt:base] as a where contains(*, 'search term') and isdescendantnode(a, '/content/mysite') /* xpath: /jcr:root/content/mysite//*[jcr:contains(.,"search term")] */ fullText="search" "term", path=/content/mysite//*). Change the query or the index definitions.
In recente AEM versies, is de generische index van Lucene gebruikt om een zeer klein aantal eigenschappen te steunen. Deze worden opnieuw bewerkt om andere indexen te gebruiken of anderszins aangepast om de afhankelijkheid van deze index te verwijderen.
Zoekopdrachten voor verwijzingen, zoals in het volgende voorbeeld, moeten nu bijvoorbeeld de index bij /oak:index/pathreference gebruiken, die alleen waarden van String -eigenschappen indexeert die overeenkomen met een reguliere expressie die naar JCR-paden zoekt.
//*[jcr:contains(., '"/content/dam/mysite"')]
Om grotere volumes van klantengegevens te steunen, leidt de Adobe niet meer tot de generische index van Lucene op nieuwe milieu's van AEM as a Cloud Service. Bovendien verwijdert Adobe de index uit bestaande opslagruimten. zie de chronologieaan het eind van dit document voor meer details.
Adobe heeft de indexkosten al aangepast via de eigenschappen costPerEntry en costPerExecution om ervoor te zorgen dat waar mogelijk andere indexen, zoals /oak:index/pathreference , de voorkeur krijgen.
De toepassingen van de klant die vragen gebruiken die nog van deze index afhangen zouden onmiddellijk moeten worden bijgewerkt om andere bestaande indexen te gebruiken, die zonodig kunnen worden aangepast. U kunt ook nieuwe aangepaste indexen toevoegen aan de toepassing van de klant. De volledige instructies voor indexbeheer in AEM as a Cloud Service kunnen in de indexerende documentatieworden gevonden.
Betrokken bent u?
De generische index van Lucene wordt momenteel gebruikt als reserve als geen andere volledige tekstindex een vraag kan onderhouden. Wanneer deze afgekeurde index wordt gebruikt, wordt een bericht gelijkend op het volgende geregistreerd op het WARN niveau:
org.apache.jackrabbit.oak.plugins.index.lucene.LucenePropertyIndex This index is deprecated: /oak:index/lucene-2; it is used for query Filter(query=select [jcr:path], [jcr:score], * from [nt:base] as a where contains(*, 'test') /* xpath: //*[jcr:contains(.,"test")] */ fullText="test", path=*). Change the query or the index definitions.
In sommige gevallen probeert Oak mogelijk een andere volledige tekstindex (zoals /oak:index/pathreference ) te gebruiken ter ondersteuning van de volledige tekstquery, maar als de querytekenreeks niet overeenkomt met de reguliere expressie in de indexdefinitie, wordt een bericht op WARN-niveau geregistreerd en retourneert de query waarschijnlijk geen resultaten.
org.apache.jackrabbit.oak.query.QueryImpl Potentially improper use of index /oak:index/pathReference with queryFilterRegex (["']|^)/ to search for value "test"
Zodra de generische index van Lucene is verwijderd, wordt een bericht zoals hieronder getoond geregistreerd op WARN niveau als een volledige tekstvraag van geen geschikte indexdefinitie kan de plaats bepalen:
org.apache.jackrabbit.oak.query.QueryImpl Fulltext query without index for filter Filter(query=select [jcr:path], [jcr:score], * from [nt:base] as a where contains(*, 'test') /* xpath: //*[jcr:contains(.,"test")] */ fullText="test", path=*); no results are returned
IMPORTANTPotentiële afhankelijkheden van generieke Lucene-indexen
Er zijn verscheidene gebieden waar uw toepassingen en AEM installaties van generische indexen van Lucene zowel op auteur als publicatieinstanties afhankelijk kunnen zijn.
Publish Instance
Aangepaste query's voor toepassingen
De gemeenschappelijkste bron van vragen gebruikend de generische index van Lucene op publiceer instantie is de vragen van de douanetoepassing.
In de eenvoudigste gevallen kunnen dit query's zijn zonder opgegeven knooppunttype, waardoor nt:base of nt:base expliciet wordt geïmpliceerd, zoals:
/jcr:root/content/mysite//*[jcr:contains(., 'search term')]
/jcr:root/content/mysite//element(*, nt:base)[jcr:contains(., 'search term')]
De query's kunnen bijvoorbeeld worden gewijzigd om resultaten te retourneren die overeenkomen met pagina's of een van de aggregaten onder de cq:Page node . De vraag zou dus kunnen worden:
/jcr:root/content/mysite//element(*, cq:Page)[jcr:contains(., 'search term')]
In andere gevallen, zou een vraag een knooptype kunnen specificeren maar een volledige tekstbeperking bevatten die niet door een andere volledige tekstindex, zoals kan behandelen:
/jcr:root/content/dam//element(*, dam:Asset)[jcr:contains(jcr:content/metadata/@cq:tags, 'NewsTopics:cateogries/domestic'))]
In dit geval heeft de query het knooppunttype dam:Asset , maar bevat deze een volledige tekstbeperking voor de relatieve eigenschap jcr:content/metadata/@cq:tags .
Deze eigenschap wordt niet gemarkeerd zoals geanalyseerd in de damAssetLucene -index. Dit is de volledige tekstindex die het meest wordt gebruikt voor query's op het dam:Asset -knooppunttype. Daarom kan deze index niet voor deze vraag worden gebruikt.
Als dusdanig, valt de vraag terug op de generische volledige tekstindex waar alle inbegrepen eigenschappen zoals geanalyseerd door de vervangingsgelijke bij /oak:index/lucene-2/indexRules/nt:base/properties/prop duidelijk zijn.
IMPORTANTjcr:content/metadata/@cq:tags wordt gemarkeerd zoals deze wordt geanalyseerd in een aangepaste versie van de index damAssetLucene , wordt deze query verwerkt door deze index en wordt geen WARN geregistreerd.Instantie van auteur
Naast vragen in de servers van de klantentoepassing, componenten OSGi, en het teruggeven van manuscripten kan er verscheidene auteur-specifieke toepassingen van de generische index van Lucene zijn.
Referentie zoeken
Historisch is de generische index van Lucene gebruikt om verwijzings onderzoek of het zoeken naar inhoud te steunen die verwijzingen naar een andere inhoudspad bevat. Dergelijke query's moeten al zijn bijgewerkt om de nieuwe /oak:index/pathreference -index te kunnen gebruiken.
Zoekopdracht padveldkiezer
AEM bevat een aangepaste component voor het dialoogvenster Sling-resource granite/ui/components/coral/foundation/form/pathfield , die een browser/kiezer biedt voor het selecteren van een ander AEM pad. De standaardpadveldkiezer, die wordt gebruikt wanneer er geen aangepaste eigenschap pickerSrc is gedefinieerd in de inhoudsstructuur, rendert een zoekbalk in het pop-updialoogvenster.
De knooppunttypen aan de hand waarvan moet worden gezocht, kunnen worden opgegeven met de eigenschap nodeTypes .
Op dit moment, als geen nodeTypes bezit aanwezig is, zal de onderliggende onderzoeksvraag het nt:base knooptype gebruiken, en zal daarom waarschijnlijk de generische index van Lucene gebruiken, typisch registrerend WARN berichten gelijkend op het volgende.
20.01.2022 18:56:06.412 *WARN* [127.0.0.1 [1642704966377] POST /mnt/overlay/granite/ui/content/coral/foundation/form/pathfield/picker.result.single.html HTTP/1.1] org.apache.jackrabbit.oak.plugins.index.lucene.LucenePropertyIndex This index is deprecated: /oak:index/lucene-2; it is used for query Filter(query=select [jcr:path], [jcr:score], * from [nt:base] as a where contains(*, 'test') and isdescendantnode(a, '/content') /* xpath: /jcr:root/content//element(*, nt:base)[(jcr:contains(., 'test'))] order by @jcr:score descending */ fullText="test", path=/content//*). Change the query or the index definitions.
Voordat de generieke Lucene-index wordt verwijderd, wordt de component pathfield bijgewerkt, zodat het zoekvak verborgen is voor componenten met de standaardkiezer, die geen eigenschap nodeTypes bevatten.
IMPORTANTnodeTypes worden opgegeven met de knooppunttypen waarop de klant een query wil uitvoeren. Deze kunnen worden opgegeven als een door komma's gescheiden lijst met knooppunttypen in een eigenschap String . Als geen onderzoek wordt vereist, wordt geen actie vereist van de klant.
NOTEdam/cfm/models/editor/components/contentreference .- Momenteel voeren deze vragen zonder gespecificeerde knooptypes uit, resulterend in WARN die wegens gebruik van de generische index van Lucene worden geregistreerd.
- Exemplaren van deze componenten worden binnenkort automatisch standaard ingesteld op het gebruik van knooppunttypen
cq:Pageendam:Assetzonder verdere actie van de klant. - De eigenschap
nodeTypeskan worden toegevoegd om deze standaardknooppunttypen te overschrijven.
Tijdlijn voor algemene Lucene-verwijdering
De Adobe zal een bifasenbenadering nemen om de generische index van Lucene te verwijderen.
- Fase 1 (gepland begin 31 Januari 2022): creeer niet meer
/oak:index/lucene-*op nieuwe milieu's van AEM as a Cloud Service. - Fase 2 (geplande begin 31 Maart 2022): verwijder
/oak:index/lucene-*index uit bestaande milieu's van AEM as a Cloud Service.
De Adobe zal de hierboven vermelde logboekberichten controleren en zal proberen om klanten te contacteren die van de generische index van Lucene afhankelijk blijven.
Als kortetermijnmatiging, voegt de Adobe de definities van de douaneindex aan klantensystemen direct toe om functionele of prestatieskwesties als resultaat van de verwijdering van de generische index van Lucene zonodig te verhinderen.
In dergelijke gevallen krijgt de klant de bijgewerkte indexdefinitie en wordt hem geadviseerd deze op te nemen in toekomstige versies van zijn toepassing via Cloud Manager.