Query e indicizzazione Oak

Ultimo aggiornamento: 2 giugno 2025
  • Si applica a:
  • Experience Manager 6.5

Creato per:

  • Amministratore
NOTA
Questo articolo riguarda la configurazione degli indici in AEM 6. Per le best practice sull'ottimizzazione delle prestazioni di query e indicizzazione, vedere Best practice per query e indicizzazione.

Introduzione

A differenza di Jackrabbit 2, Oak non indicizza il contenuto per impostazione predefinita. Gli indici personalizzati devono essere creati quando necessario, come con i database relazionali tradizionali. Se non esiste un indice per una query specifica, è possibile che vengano attraversati molti nodi. La query potrebbe ancora funzionare, ma è probabilmente lenta.

Se Oak rileva una query senza un indice, viene stampato un messaggio di registro di livello WARN:

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

Lingue di query supportate

Il motore di query di Oak supporta le seguenti lingue:

  • XPath (consigliato)
  • SQL-2
  • SQL (obsoleto)
  • JQOM

Tipi di indicizzatore e calcolo dei costi

Il backend basato su Apache Oak consente di collegare diversi indicizzatori all’archivio.

Un indicizzatore è l'Indice proprietà, per il quale la definizione dell'indice è archiviata nell'archivio stesso.

Per impostazione predefinita, sono disponibili anche le implementazioni per Apache Lucene e Solr, che supportano entrambe l'indicizzazione full-text.

Se non è disponibile alcun altro indicizzatore, viene utilizzato l'Indice trasversale. Ciò significa che il contenuto non è indicizzato e che i nodi di contenuto vengono attraversati per trovare corrispondenze alla query.

Se per una query sono disponibili più indicizzatori, ogni indicizzatore disponibile stima il costo dell'esecuzione della query. Oak sceglie quindi l’indicizzatore con il costo stimato più basso.

chlimage_1-148

Il diagramma precedente è una rappresentazione di alto livello del meccanismo di esecuzione delle query di Apache Oak.

Innanzitutto, la query viene analizzata in una struttura ad albero della sintassi astratta. Quindi, la query viene controllata e trasformata in SQL-2, che è la lingua nativa per le query Oak.

Successivamente, ogni indice viene consultato per stimare il costo della query. Una volta completato, vengono recuperati i risultati dall’indice più economico. Infine, i risultati vengono filtrati, sia per garantire che l’utente corrente abbia accesso in lettura al risultato sia che il risultato corrisponda alla query completa.

Configurazione degli indici

NOTA
Per un archivio di grandi dimensioni, la creazione di un indice è un’operazione che richiede tempo. Questo vale sia per la creazione iniziale di un indice che per la reindicizzazione (ricostruzione di un indice dopo la modifica della definizione). Vedere anche Risoluzione dei problemi relativi agli indici Oak e Prevenzione della reindicizzazione lenta.

Se la reindicizzazione è necessaria in archivi di grandi dimensioni, specialmente quando si utilizza MongoDB e per gli indici full-text, considera la pre-estrazione del testo e l’utilizzo di oak-run per creare l’indice iniziale e reindicizzare.

Gli indici sono configurati come nodi nell'archivio nel nodo Oak:index.

Il tipo del nodo indice deve essere oak:QueryIndexDefinition. Per ogni indicizzatore sono disponibili diverse opzioni di configurazione come proprietà del nodo. Per ulteriori informazioni, consulta i dettagli di configurazione per ogni tipo di indicizzatore riportati di seguito.

Indice proprietà

L'indice delle proprietà è utile per le query che hanno vincoli di proprietà ma non sono full-text. Può essere configurato seguendo la procedura seguente:

  1. Apri CRXDE andando su http://localhost:4502/crx/de/index.jsp

  2. Crea un nodo in oak:index

  3. Denomina il nodo PropertyIndex e imposta il tipo di nodo su oak:QueryIndexDefinition

  4. Imposta le seguenti proprietà per il nuovo nodo:

    • tipo: property (di tipo Stringa)
    • propertyNames: jcr:uuid (di tipo Name)

    In questo esempio particolare viene indicizzata la proprietà jcr:uuid, il cui processo consiste nell'esporre l'identificatore univoco universale (UUID) del nodo a cui è associata.

  5. Salva le modifiche.

L’indice delle proprietà dispone delle seguenti opzioni di configurazione:

  • La proprietà type specifica il tipo di indice e in questo caso deve essere impostata su property

  • La proprietà propertyNames indica l'elenco delle proprietà memorizzate nell'indice. Se manca, il nome del nodo viene utilizzato come valore di riferimento del nome di proprietà. In questo esempio, la proprietà jcr:uuid il cui processo consiste nell'esporre l'identificatore univoco (UUID) del relativo nodo viene aggiunta all'indice.

  • Il flag unique che, se impostato su true, aggiunge un vincolo di univocità nell'indice della proprietà.

  • La proprietà DeclaringNodeTypes consente di specificare un determinato tipo di nodo a cui si applica solo l'indice.

  • Il flag reindex che, se impostato su true, attiva una reindicizzazione del contenuto completo.

Indice ordinato

L'indice Ordinato è un'estensione dell'indice Proprietà. Tuttavia, è stato dichiarato obsoleto. Gli indici di questo tipo devono essere sostituiti con Indice proprietà Lucene.

Indice full-text Lucene

Un indicizzatore full-text basato su Apache Lucene è disponibile in AEM 6.

Se è configurato un indice full-text, tutte le query con una condizione full-text utilizzano l'indice full-text, indipendentemente dall'esistenza di altre condizioni indicizzate e da eventuali restrizioni di percorso.

Se non è configurato alcun indice full-text, le query con condizioni full-text non funzionano come previsto.

Poiché l’indice viene aggiornato tramite un thread in background asincrono, alcune ricerche full-text non sono disponibili per una piccola finestra di tempo fino al completamento dei processi in background.

Per configurare un indice full-text Lucene, attenersi alla procedura descritta di seguito.

  1. Apri CRXDE e crea un nodo in oak:index.

  2. Denomina il nodo LuceneIndex e imposta il tipo di nodo su oak:QueryIndexDefinition

  3. Aggiungi le seguenti proprietà al nodo:

    • tipo: lucene (di tipo Stringa)
    • asincrono: async (di tipo String)

  4. Salva le modifiche.

L’indice Lucene dispone delle seguenti opzioni di configurazione:

  • La proprietà type che specifica il tipo di indice deve essere impostata su lucene
  • La proprietà async che deve essere impostata su async. In questo modo il processo di aggiornamento dell’indice viene inviato a un thread in background.
  • La proprietà includePropertyTypes, che definisce il sottoinsieme dei tipi di proprietà inclusi nell'indice.
  • La proprietà excludePropertyNames che definisce un elenco di nomi di proprietà, ovvero proprietà da escludere dall'indice.
  • Il flag reindex che, se impostato su true, attiva una reindicizzazione del contenuto completo.