Panoramica degli indici

Questa pagina descrive l'indicizzazione per Firestore con compatibilità MongoDB. Firestore con compatibilità MongoDB non crea indici per impostazione predefinita. Per migliorare le prestazioni del database, crea indici per le query più utilizzate.

Gli indici hanno un impatto significativo sulle prestazioni di un database. Se esiste un indice per una query, il database può restituire in modo efficiente i risultati riducendo la quantità di dati da scansionare e il lavoro necessario per ordinare i risultati. Tuttavia, le voci di indice aumentano i costi di archiviazione e la quantità di lavoro eseguito durante un'operazione di scrittura sui campi indicizzati.

Definizione e struttura dell'indice

Un indice è costituito da quanto segue:

  • un ID raccolta
  • un elenco di campi nella raccolta specificata
  • un ordine, crescente o decrescente, per ogni campo

Un indice può anche attivare le opzioni sparse e multikey.

Ordinamento degli indici

L'ordine e la direzione di ordinamento di ogni campo definiscono in modo univoco l'indice. Ad esempio, i seguenti indici sono due indici distinti e non intercambiabili:

Raccolta Campi
cities paese (ordine crescente), popolazione (ordine decrescente)
cities popolazione (ordine decrescente), paese (ordine crescente)

Quando crei un indice per supportare una query, includi i campi nello stesso ordine della query.

Densità dell'indice

Per impostazione predefinita, le voci di indice archiviano i dati di tutti i documenti di una raccolta. Questo è noto come indice non sparso. Una voce di indice verrà aggiunta per un documento indipendentemente dal fatto che il documento contenga uno dei campi specificati nell'indice. I campi inesistenti vengono trattati come se avessero un valore NULL durante la generazione delle voci dell'indice. Per modificare questo comportamento, puoi definire l'indice come indice sparso.

Indici sparsi

Un indice sparso indicizza solo i documenti nella raccolta che contengono un valore (incluso null) per almeno uno dei campi indicizzati. Un indice sparso riduce i costi di archiviazione e può migliorare le prestazioni.

Indici multichiave per i valori dell'array

Se crei un indice su un campo che contiene valori di array, devi creare un indice multichiave. Un indice normale non può indicizzare i valori dell'array. Un indice multichiave supporta fino a un campo array nella definizione dell'indice e può essere utilizzato per operazioni che attraversano i valori dell'array.

Utilizza gli indici multichiave solo se sai di dover indicizzare i valori dell'array. Gli indici regolari presentano vantaggi durante l'elaborazione di una query. Ad esempio, gli indici normali possono filtrare i valori all'interno di un intervallo in modo più efficiente.

Le seguenti situazioni comportano errori quando si utilizzano valori di array e indici multichiave:

  • Un'operazione tenta di aggiungere un valore di array a un campo indicizzato da un indice normale. Per aggiungere il valore dell'array, devi eliminare gli indici regolari esistenti in quel campo e ricrearli come indici multikey.
  • Tentativo di creare un indice normale su un campo che contiene un valore di array. Devi creare un indice multichiave o eliminare i valori dell'array.
  • Un'operazione tenta di indicizzare più campi con valori di array. Non puoi avere più di un campo con un valore di array in un indice multikey. Per procedere, modifica il modello dei dati o le definizioni degli indici.
  • Tentativo di creare un indice multichiave in cui due percorsi di campi condividono un prefisso comune come users.posts e users.zip.

Risolvere i problemi relativi agli errori di creazione dell'indice

Potresti riscontrare errori di creazione dell'indice durante la gestione degli indici. Un'operazione di indicizzazione può non riuscire se il database riscontra un problema con i dati. Le operazioni di indicizzazione possono non andare a buon fine per i seguenti motivi:

  • Hai raggiunto un limite di indice. Ad esempio, l'operazione potrebbe aver raggiunto il numero massimo di voci di indice per documento. Se la creazione dell'indice non riesce, viene visualizzato un messaggio di errore. Se non hai raggiunto un limite di indice, riprova l'operazione di indicizzazione.
  • È necessario un indice multichiave. Almeno uno dei campi indicizzati contiene un valore di array. Per procedere, devi utilizzare un indice multichiave o eliminare i valori dell'array.
  • Un'operazione tenta di indicizzare più campi con valori di array. Non puoi avere più di un campo con un valore di array in un indice multikey. Per procedere, modifica il modello dei dati o le definizioni degli indici.

Passaggi successivi