Gestisci indici

In questa pagina viene descritto come gestire gli indici. Per saperne di più sugli indici, consulta la panoramica degli indici.

Prima di iniziare

Prima di poter creare un indice in Cloud Firestore, assicurati di avere uno dei seguenti ruoli:

  • roles/datastore.owner
  • roles/datastore.indexAdmin
  • roles/editor
  • roles/owner

Per concedere un ruolo, consulta Concedi un singolo ruolo. Per saperne di più sui ruoli Cloud Firestore e sulle autorizzazioni associate, consulta Ruoli predefiniti.

Se hai definito ruoli personalizzati, assegna tutte le seguenti autorizzazioni per creare indici:

  • datastore.indexes.create
  • datastore.indexes.delete
  • datastore.indexes.get
  • datastore.indexes.list
  • datastore.indexes.update

Crea un indice

Per creare un indice:

API MongoDB

Utilizza il createIndex() metodo per creare un indice. Ad esempio:

  •   db.restaurants.createIndex({"cuisine" : 1})
      
  •   db.restaurants.createIndex({"cuisine" : 1}, {sparse: true})
      
  • La creazione di indici con db.runCommand() è supportata anche con al massimo un indice.

      db.runCommand({"createIndexes":"restaurant", "index": [{"key": {"cuisine":1}, {"name": "cuisine_index"}]})
      

Tieni presente le seguenti limitazioni:

  • Puoi creare un solo indice per richiesta. db.collection.createIndexes() non è supportato.
  • I log di audit per la creazione di indici con l'API MongoDB utilizzano il nome del metodo google.firestore.admin.v1.FirestoreAdmin.CreateIndex.
  • Per le opzioni di indice supportate, consulta Indici e proprietà degli indici.
Firebase console
  1. Nella console Firebase, vai alla pagina Database Firestore.

    Vai a Database Firestore

  2. Seleziona un database dall'elenco dei database.
  3. Nella scheda Indici, fai clic su Crea indice.
  4. Inserisci un ID raccolta.
  5. Aggiungi uno o più percorsi di campo e seleziona un'opzione di indice per ciascuno.
  6. Seleziona un'opzione di presenza del campo, non sparsa o sparsa.
  7. (Facoltativo) Puoi impostare l'opzione di indice multikey.
  8. Fai clic su Crea.
  9. Il nuovo indice viene visualizzato nell'elenco degli indici e Cloud Firestore inizia a crearlo. Una volta creato l'indice, vedrai un segno di spunta verde accanto all'indice. Se l'indice non viene creato, consulta Errori di creazione dell'indice per le possibili cause.
gcloud CLI

Per creare un indice, utilizza il gcloud firestore indexes composite create comando. Imposta api-scope su mongodb-compatible-api.

gcloud firestore indexes composite create \
--database='DATABASE_ID' \
--collection-group=COLLECTION \
--field-config=FIELD_CONFIGURATION \
--query-scope=collection-group \
--density=dense \
--api-scope=mongodb-compatible-api

Sostituisci quanto segue:

  • DATABASE_ID: un ID database.
  • COLLECTION: un nome di raccolta.
  • FIELD_CONFIGURATION: una configurazione del campo. Per ogni campo, aggiungi --field-config=field-path=. Ad esempio:
        --field-config=field-path=user-id,order=descending \
        --field-config=field-path=score,order=descending
        

    Per saperne di più sulla configurazione di questi campi, consulta --field-config.

Per creare un indice sparso, imposta --density=sparse-any.

Per creare un indice multikey, aggiungi il flag --multikey.

Per creare un indice univoco, aggiungi il flag --unique.

Terraform

Utilizza la google_firestore_index risorsa e imposta api_scope su MONGODB_COMPATIBLE_API e query_scope su COLLECTION_GROUP.

resource "google_firestore_index" "index" {
  database    = "DATABASE_ID"
  collection  = "COLLECTION"
  api_scope   = "MONGODB_COMPATIBLE_API"
  query_scope = "COLLECTION_GROUP"

  // You can include multiple field blocks
  fields {
    field_path = "FIELD_PATH"
    order      = "ORDER"
  }

  // Optional
  multikey = true
  density  = "DENSITY"
}

Sostituisci quanto segue:

  • DATABASE_ID: l'ID database del database scelto
  • COLLECTION: il nome della raccolta da indicizzare
  • FIELD_PATH: il nome del campo da indicizzare
  • ORDER: uno tra ASCENDING o DESCENDING
  • DENSITY: uno tra SPARSE_ANY o DENSE

Elimina un indice

Per eliminare un indice:

API MongoDB

Utilizza il dropIndex() metodo per eliminare un indice. Ad esempio:

Elimina un indice utilizzando il nome dell'indice

db.restaurants.dropIndex("cuisine_index")

Elimina un indice utilizzando la definizione dell'indice

db.restaurants.dropIndex({"cuisine" : 1})
Firebase console
  1. Nella console Firebase, vai alla pagina Database Firestore.

    Vai a Database Firestore

  2. Seleziona un database dall'elenco dei database.
  3. Fai clic sulla scheda Indici.
  4. Nell'elenco degli indici, scegli Elimina dal pulsante Altro per l'indice che vuoi eliminare.
  5. Fai clic su Elimina indice.
gcloud CLI
  1. Per trovare il nome dell'indice, utilizza il gcloud firestore indexes composite list comando.

    gcloud firestore indexes composite list \
    --database='DATABASE_ID'

    Sostituisci DATABASE_ID con l'ID database.

  2. Per eliminare l'indice, utilizza il gcloud firestore indexes composite delete comando.

    gcloud firestore indexes composite delete INDEX_NAME \
    --database='DATABASE_ID'

    Sostituisci quanto segue:

    • INDEX_NAME: il nome di un indice
    • DATABASE_ID: un ID database

Tempo di creazione dell'indice

Per creare un indice, Cloud Firestore deve creare l'indice e poi eseguire il backfill delle voci dell'indice con i dati esistenti. Il tempo necessario per creare un indice è determinato da quanto segue:

  • Il tempo minimo di compilazione di un indice è di pochi minuti, anche per un database vuoto.

  • Il tempo necessario per eseguire il backfill delle voci dell'indice dipende dalla quantità di dati esistenti che appartengono al nuovo indice. Più valori di campo corrispondono alla definizione dell'indice, più tempo è necessario per eseguire il backfill delle voci dell'indice.

Gestione delle operazioni a lunga esecuzione

Le creazioni di indici sono operazioni a lunga esecuzione. Le sezioni seguenti descrivono come utilizzare le operazioni a lunga esecuzione per gli indici.

Dopo aver iniziato a creare un indice, Cloud Firestore assegna all'operazione un nome univoco. I nomi delle operazioni hanno il prefisso projects/PROJECT_ID/databases/DATABASE_ID/operations/, ad esempio:

projects/PROJECT_ID/databases/DATABASE_ID/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

Puoi omettere il prefisso quando specifichi un nome di operazione per il comando describe.

Elenca tutte le operazioni a lunga esecuzione

Per elencare le operazioni a lunga esecuzione, utilizza il gcloud firestore operations list comando. Questo comando elenca le operazioni in corso e quelle completate di recente. Le operazioni vengono elencate per alcuni giorni dopo il completamento:

gcloud firestore operations list

Controlla lo stato dell'operazione

Anziché elencare tutte le operazioni a lunga esecuzione, puoi elencare i dettagli di una singola operazione:

gcloud firestore operations describe operation-name

Stima del tempo di completamento

Durante l'esecuzione dell'operazione, consulta il valore del state campo per lo stato generale dell'operazione.

Una richiesta per lo stato di un'operazione a lunga esecuzione restituisce anche le metriche workEstimated e workCompleted. workEstimated mostra il numero totale stimato di documenti che un'operazione elaborerà. workCompleted mostra il numero di documenti elaborati finora. Al termine dell'operazione, workCompleted riflette il numero totale di documenti effettivamente elaborati, che potrebbe essere diverso dal valore di workEstimated.

Per stimare l'avanzamento di un'operazione, dividi workCompleted per workEstimated.

Di seguito è riportato un esempio dell'avanzamento della creazione di un indice:

{
  "operations": [
    {
      "name": "projects/project-id/operations/AyAyMDBiM2U5NTgwZDAtZGIyYi0zYjc0LTIzYWEtZjg1ZGdWFmZWQHEjF0c2Flc3UtcmV4ZWRuaS1uaW1kYRUKSBI",
      "metadata": {
        "@type": "type.googleapis.com/google.firestore.admin.v1.IndexOperationMetadata",
        "common": {
          "operationType": "CREATE_INDEX",
          "startTime": "2020-06-23T16:52:25.697539Z",
          "state": "PROCESSING"
        },
        "progressDocuments": {
          "workCompleted": "219327",
          "workEstimated": "2198182"
        }
       },
    },
    ...

Al termine di un'operazione, la descrizione dell'operazione conterrà "done": true. Consulta il valore del campo state per il risultato dell'operazione. Se il campo done non è impostato nella risposta, l'operazione non è stata completata.