Panoramica degli indici

Pertinente solo per la versione Enterprise di Cloud Firestore.

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

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 abilitare le opzioni sparse, multikey o unique.

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
città paese (ordine crescente), popolazione (ordine decrescente)
città 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 regolari 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 di 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.

Indici unici

Imposta l'opzione di indice unico per applicare valori unici per i campi indicizzati. Per gli indici su più campi, ogni combinazione di valori deve essere univoca nell'indice. Il database rifiuta qualsiasi operazione di aggiornamento e inserimento che tenta di creare voci di indice con valori duplicati. Se i dati dei campi indicizzati contengono valori duplicati e tenti di creare un indice univoco, la creazione dell'indice non va a buon fine e viene visualizzato un messaggio di errore nei dettagli dell'operazione.

Campi assenti in un indice univoco

Se inserisci un documento con campi mancanti per l'indice univoco, l'indice imposta i valori null per i campi mancanti. La voce di indice risultante deve essere univoca, altrimenti l'operazione non va a buon fine.

Ad esempio, con questo indice:

db.cities.createIndex( { "name": 1 }, { unique: true } )

Se aggiungi il documento {"abbreviation": "LA"} alla raccolta, l'indice univoco crea una voce con name impostato su null. Se poi provi ad aggiungere il documento {"abbreviation": "NYC"}, l'operazione non va a buon fine perché la voce risultante per l'indice univoco è la stessa.

Lo stesso comportamento si applica agli indici univoci con più campi. Quando crei o aggiorni un documento, i campi indicizzati mancanti vengono impostati su null e la voce di indice risultante deve essere univoca nell'indice.

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.
  • È richiesto un indice multikey. 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 di dati o le definizioni degli indici.
  • Se imposti l'opzione di indice univoco, i dati dei campi indicizzati creano voci di indice duplicate. Per procedere, rimuovi le combinazioni duplicate di valori dai dati.

Passaggi successivi