Best practices indexeren in AEM

Meer informatie over het indexeren van beste praktijken in Adobe Experience Manager (AEM). Apache ​ Jackrabbit Oak ​ bevoegdheden het inhoudsonderzoek in AEM en het volgende zijn zeer belangrijke punten:

Om een efficiënte en correcte onderzoeksfunctionaliteit te hebben die niet de prestaties van de instantie van AEM beïnvloedt, is het belangrijk om de het indexeren beste praktijken te begrijpen.

Aangepaste versus OTB-index

Soms moet u aangepaste indexen maken ter ondersteuning van uw zoekvereisten. Volg echter onderstaande richtlijnen voordat u aangepaste indexen maakt:

De OOTB-index aanpassen

Volledig aangepaste index

Het maken van een volledig aangepaste index moet de laatste optie zijn en alleen als de bovenstaande optie niet werkt.

Voorbeelden

Om de beste praktijken te begrijpen, herzien enkele voorbeelden.

Onjuist gebruik van eigenschap tags

Onder de afbeelding ziet u een aangepaste en OOTB-indexdefinitie, waarbij de eigenschap tags wordt gemarkeerd. Beide indexen gebruiken dezelfde visualSimilaritySearch -waarde.

Analyse

Dit is een onjuist gebruik van de eigenschap tags op de aangepaste index. De Oak-query-engine selecteert de aangepaste index boven de OOTB-indexoorzaak van de laagste geschatte kosten.

De juiste manier is om de OOTB-index aan te passen en de benodigde eigenschappen toe te voegen in het knooppunt indexRules . Zie ​ Aanpassen van de index OOTB ​ voor meer details.

Index op het knooppunttype dam:Asset

Onder de afbeelding ziet u een aangepaste index voor het knooppunttype dam:Asset , waarbij de eigenschap includedPaths is ingesteld op een specifiek pad.

Analyse

Als u op Assets een uitgebreide zoekopdracht uitvoert, worden onjuiste resultaten geretourneerd, waardoor de aangepaste index lagere geschatte kosten heeft.

Maak geen aangepaste index voor het knooppunttype dam:Asset , maar pas de OOTB damAssetLucene -index aan met de benodigde eigenschappen in het knooppunt indexRules .

Meerdere knooppunttypen onder indexeringsregels

Onder de afbeelding ziet u een aangepaste index met meerdere knooppunttypen onder het knooppunt indexRules .

Analyse

Het wordt afgeraden meerdere knooppunttypen toe te voegen in één index, maar het is niet verstandig knooppunttypen in dezelfde index te indexeren als de knooppunttypen nauw verwant zijn, bijvoorbeeld cq:Page en cq:PageContent .

Een geldige oplossing is om de OOTB cqPageLucene - en damAssetLucene -index aan te passen en de benodigde eigenschappen toe te voegen onder het bestaande knooppunt indexRules .

Geen eigenschap queryPaths

Onder de afbeelding ziet u een aangepaste index (niet alleen volgens de naamgevingsconventie) zonder de eigenschap queryPaths .

Analyse

Stel queryPaths altijd in op dezelfde waarde als includedPaths value. Stel de eigenschap evaluatePathRestrictions ook in op true als u de padbeperking wilt afdwingen.

Vragen met indextag

Onder de afbeelding ziet u een aangepaste index met de eigenschap tags en hoe u deze kunt gebruiken tijdens het opvragen van informatie.

/jcr:root/content/dam//element(*,dam:Asset)[(jcr:content/@contentFragment = 'true' and jcr:contains(., '/content/sitebuilder/test/mysite/live/ja-jp/mypage'))]order by @jcr:created descending option (index tag assetPrefixNodeNameSearch)

Analyse

Toont aan hoe te om niet-tegenstrijdige en correcte tags bezitswaarde op de index te plaatsen en het te gebruiken terwijl het vragen. De algemene querysyntaxis is is <query> option(index tag <tagName>) . Zie ook {de Markering van de Index van de Optie van 0} Vraag 🔗

Aangepaste index

Onder de afbeelding ziet u een aangepaste index met het knooppunt suggestion voor het bereiken van de geavanceerde zoekfunctionaliteit.

Analyse

Het is een geldig gebruiksgeval om een douaneindex voor de ​ geavanceerde onderzoek ​ functionaliteit tot stand te brengen. De indexnaam moet echter volgen op &lt;prefix>.&lt;customIndexName>-&lt;version>-douane- \ <customVersion> noemende overeenkomst.

Optimalisatie indexeren door Apache Tika uit te schakelen

AEM gebruikt ​ Tika van Apache ​ voor het halen van meta-gegevens en tekstinhoud uit dossier types zoals PDF, Word, Excel, en meer. De geëxtraheerde inhoud wordt opgeslagen in de opslagplaats en geïndexeerd door de Oak Lucene-index.

Soms hebben gebruikers de mogelijkheid om te zoeken binnen de inhoud van een bestand/middel niet nodig. In dergelijke gevallen kunt u de indexprestaties verbeteren door de Apache-trojka uit te schakelen. De voordelen zijn:

Uitschakelen op mime-type

Ga als volgt te werk om Apache Tika op mime-type uit te schakelen:

/oak:index/damAssetLucene
    - jcr:primaryType = "oak:QueryIndexDefinition"
    - type = "lucene"
    ...
    <tika jcr:primaryType="nt:unstructured">
        <config.xml/>
    </tika>

<properties>
  <parsers>
    <parser class="org.apache.tika.parser.EmptyParser">
      <mime>application/pdf</mime>
      <!-- Add more mime types to disable -->
  </parsers>
</properties>

In de volgende afbeelding ziet u de OOTB damAssetLucene -index met het tika node- en config.xml -bestand waarmee de PDF en andere mime-typen worden uitgeschakeld.

Volledig uitschakelen

Volg onderstaande stappen om Apache Tika volledig uit te schakelen:

/oak:index/<INDEX-NAME>/indexRules/<NODE-TYPE>/properties/data
    - jcr:primaryType = "nt:unstructured"
    - type = "String"
    - name = "jcr:data"
    - nodeScopeIndex = false
    - propertyIndex = false
    - analyze = false

Nuttige gereedschappen

Laten we enkele gereedschappen bekijken die u kunnen helpen de indexen te definiëren, te analyseren en te optimaliseren.

Gereedschap Index maken en Oak-gereedschappen

Het ​ hulpmiddelhulp van de Generator van de Definitie van de Index van 0} Oak ​ om de indexdefinitie te produceren die op de inputvragen wordt gebaseerd. Het is een goed beginpunt om een aangepaste index te maken.

De ​ Hulpmiddelen van Oak ​ bevatten ook andere
hulpprogramma's voor indexering en opvragen, bijvoorbeeld voor het omzetten van indexen tussen JSON- en XML-indeling;
om vragen van XPath in SQL-2 om te zetten, en indexen te vergelijken.

Gereedschap Query-prestaties

Het Hulpmiddel van de Prestaties van de Vraag OTB beschikbaar bij lokale SDK ​ en AEMCS via Developer Console of ​ hulp https://author-pXXXX-eYYYY.adobeaemcloud.com/ui#/aem/libs/granite/operations/content/diagnosistools/queryPerformance.html?appId=aemshell om de vraagprestaties en JCR de Cheat Sheet van de Vraag te analyseren ​ om de optimale vraag te bepalen.

Problemen met gereedschappen en tips oplossen

De meeste van de onderstaande opties zijn van toepassing voor AEM 6.X en lokale probleemoplossing.

Aanvullende bronnen

Raadpleeg de volgende documentatie voor meer informatie: