Quote e limiti

Questa pagina identifica le quote e i limiti delle richieste per Firestore.

Quota gratuita

Firestore offre una quota gratuita che ti consente di iniziare con il tuo database (default) senza costi aggiuntivi. Di seguito viene riportata la quantità di quote gratuite. Se hai bisogno di un aumento della quota, devi abilitare la fatturazione per il tuo progetto Google Cloud.

Le quote sono applicate giornalmente e reimpostate alla mezzanotte del fuso orario del Pacifico.

Solo il database (default) è idoneo per la quota gratuita.

Livello gratuito Quota
Dati archiviati 1 GiB
Operazioni di lettura documenti 50.000 al giorno
Operazioni di scrittura documenti 20.000 al giorno
Operazioni di eliminazione documenti 20.000 al giorno
Trasferimento dei dati in uscita 10 GiB al mese

Le seguenti operazioni e funzionalità non includono l'utilizzo gratuito. Per utilizzare queste funzionalità, devi attivare la fatturazione:

  • Utilizzo di database denominati (non predefiniti)
  • Eliminazioni TTL
  • Dati PITR
  • Backup dei dati
  • Operazioni di ripristino

Per ulteriori informazioni sulle modalità di fatturazione di queste funzioni, consulta Prezzi dell'archiviazione.

Limiti standard

Le seguenti tabelle mostrano i limiti che si applicano a Firestore Si tratta di limiti rigidi, se non diversamente specificato.

Database

Limite Dettagli
Numero massimo di database per progetto

100

Puoi contattare l'assistenza per richiedere un aumento di questo limite.

Raccolte, documenti e campi

Limite Dettagli
Vincoli degli ID raccolta
  • Devono contenere esclusivamente caratteri UTF-8 validi
  • Non devono superare i 1500 byte
  • Non possono contenere una barra (/)
  • Non possono essere composti unicamente da un singolo punto (.) o da due punti consecutivi (..)
  • Non possono corrispondere all'espressione regolare __.*__
Profondità massima delle sottoraccolte 100
Vincoli degli ID documento
  • Devono contenere esclusivamente caratteri UTF-8 validi
  • Non devono superare i 1500 byte
  • Non possono contenere una barra (/)
  • Non possono essere composti unicamente da un singolo punto (.) o da due punti consecutivi (..)
  • Non possono corrispondere all'espressione regolare __.*__
  • Se importi entità Datastore in un database Firestore, gli ID entità numerici vengono esposti come __id[0-9]+__
Dimensione massima del nome di un documento 6 KiB
Dimensione massima di un documento 1 MiB (1.048.576 byte)
Vincoli dei nomi dei campi
  • Devono contenere esclusivamente caratteri UTF-8 validi
  • Non possono corrispondere all'espressione regolare __.*__
Dimensione massima del nome di un campo 1500 byte
Vincoli dei percorsi dei campi
  • È necessario separare i nomi dei campi con un singolo punto (.)
  • Può essere trasmesso come stringa di segmenti delimitati da punti (.) in cui ogni segmento è un nome di campo semplice o un nome di campo tra virgolette (definito di seguito).
Un nome di campo semplice è un nome in cui tutte le seguenti condizioni sono vere:
  • Contiene solo i caratteri a-z, A-Z o 0-9 e il trattino basso (_)
  • Non inizia con 0-9
Un nome di campo tra virgolette inizia e termina con il carattere barra verticale (`). Ad esempio, foo.`x&y` fa riferimento al campo x&y nidificato nel campo foo. Per creare un nome di campo con l'accento grave, esegui la fuga del carattere con la barra (\). Per comodità, puoi evitare i nomi di campo tra virgolette passando il percorso del campo come oggetto FieldPath (ad esempio, consulta FieldPath JavaScript).
Dimensione massima di un percorso di campo 1500 byte
Dimensione massima di un valore di campo 1 MiB-89 byte (1.048.487 byte)
Profondità massima dei campi in una mappa o un array

20

I campi di tipo Mappa e array aggiungono un livello alla profondità complessiva di un oggetto. Ad esempio, il seguente oggetto ha una profondità totale di tre livelli: 


{
  nested_map: {         #depth 1
    nested_array: [     #depth 2
      {
        foo: "bar"      #depth 3
      }
    ]
  }
}

Operazioni di scrittura e transazioni

Oltre a questi limiti, consulta anche le best practice per la progettazione su larga scala.

Limite Dettagli
Dimensione massima della richiesta API 10 MiB
Limite di tempo per una transazione 270 secondi, con un periodo di scadenza di inattività di 60 secondi
Numero massimo di trasformazioni di campo che possono essere eseguite su un singolo documento in un'operazione Commit o in una transazione 500

Indici

I seguenti limiti sono applicabili agli indici a campo singolo e agli indici composti:

Questa pagina indica le quote e i limiti delle richieste per Firestore.

Limite Dettagli
Numero massimo di indici composti per un database
Numero massimo di configurazioni a campo singolo per un database

Una configurazione a livello di campo può contenere più configurazioni per lo stesso campo. Ad esempio, un'esenzione dell'indice a campo singolo e un criterio TTL nello stesso campo vengono conteggiati come una configurazione di campo ai fini del raggiungimento del limite.

Numero massimo di voci di indice per ogni documento

40.000

Il numero di voci di indice corrisponde alla somma di quanto segue per un documento:

  • Numero di voci degli indici a campo singolo
  • Numero di voci degli indici composti

Per scoprire in che modo Firestore trasforma un documento e una serie di indici in voci di indice, vedi questo esempio di conteggio di voci di indice.
Numero massimo di campi in un indice composto 100
Dimensione massima di una voce di indice

7,5 KiB

Per scoprire in che modo Firestore calcola la dimensione di una voce di indice, vai alla pagina Dimensioni delle voci di indice.
Somma massima delle dimensioni delle voci di indice di un documento

8 MiB

La dimensione totale corrisponde alla somma di quanto segue per un documento:

  • Somma delle dimensioni delle voci degli indici a campo singolo di un documento
  • Somma delle dimensioni delle voci degli indici composti di un documento
    		•
    Dimensione massima di un valore di campo indicizzato

    1500 byte

    I valori di campo superiori a 1500 byte vengono troncati. Le query che includono valori di campo troncati possono restituire risultati incoerenti.

    Durata (TTL)

    Limite Dettagli
    Numero massimo di configurazioni a campo singolo per un database

    Una configurazione a livello di campo può contenere più configurazioni per lo stesso campo. Ad esempio: un'esenzione dell'indicizzazione a campo singolo e un criterio TTL per lo stesso campo vengono conteggiate come una configurazione del campo ai fini del limite.

    Esportazione/importazione

    Per le operazioni di importazione ed esportazione gestite si applicano i limiti seguenti:

    Limite Dettagli
    Numero massimo totale di richieste di esportazione e importazione consentite al minuto per un progetto 20
    Numero massimo di esportazioni e importazioni simultanee 50
    Numero massimo di filtri ID raccolta per richieste di esportazione e importazione 100

    Regole di sicurezza

    Limite Dettagli
    Numero massimo di chiamate exists(), get() e getAfter() per richiesta
    • 10 per richieste di documenti singoli e di query.

    • 20 per transazioni, operazioni di scrittura in batch e operazioni di lettura di più documenti. A ciascuna operazione si applica anche il limite precedente di 10.

      Ad esempio, immagina di creare una richiesta di scrittura in batch con 3 operazioni di scrittura e che le tue regole di sicurezza utilizzino 2 chiamate di accesso ai documenti per convalidare ogni operazione di scrittura. In questo caso, ogni operazione di scrittura utilizza 2 delle sue 10 chiamate di accesso e la richiesta di scrittura in batch utilizza 6 delle sue 20 chiamate di accesso.

    Il superamento di uno dei limiti comporta un errore di autorizzazione negata.

    Alcune chiamate di accesso ai documenti possono essere memorizzate nella cache e le chiamate nella cache non vengono considerate ai fini dei limiti.
    Profondità massima delle istruzioni match nidificate 10
    Lunghezza massima del percorso, in segmenti di percorso, consentita all'interno di un set di istruzioni match nidificate 100
    Numero massimo di variabili di acquisizione percorso consentite all'interno di un set di istruzioni match nidificate 20
    Profondità massima delle chiamate funzione 20
    Numero massimo di argomenti di funzione 7
    Numero massimo di associazioni di variabili let per funzione 10
    Numero massimo di chiamate di funzione ricorsive o cicliche 0 (non consentite)
    Numero massimo di espressioni valutate per richiesta 1000
    Dimensione massima di un set di regole I set di regole devono rispettare due limiti di dimensione:
    • un limite di 256 kB per la dimensione dell'origine di testo del set di regole pubblicate dalla console Firebase o dall'interfaccia a riga di comando utilizzando firebase deploy.
    • un limite di 250 kB per la dimensione del set di regole compilato che risulta quando Firebase elabora l'origine e la rende attiva sul e il backend.

    Monitoraggio dell'utilizzo

    Puoi visualizzare l'utilizzo di Firestore nel Quote dell'API Cloud Firestore e ai nelle pagine relative alle quote di App Engine.