Quote e limiti

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

Quota gratuita

Cloud Firestore offre una quota gratuita che ti consente di iniziare senza alcun costo. Le operazioni incluse nella quota gratuita sono elencate di seguito. Se hai bisogno di quote superiori, devi abilitare la fatturazione per il tuo progetto Cloud Platform.

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

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
In uscita dalla rete 10 GiB al mese

Limiti standard

Le tabelle riportate di seguito mostrano i limiti applicabili al tuo utilizzo di Cloud Firestore.

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 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 punto (.) o da due punti consecutivi (..)
  • Non possono corrispondere all'espressione regolare __.*__
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
Dimensione massima del nome di un campo 1500 byte
Vincoli dei percorsi dei campi
  • È necessario separare i nomi dei campi con un singolo punto (.)
  • È necessario racchiudere ciascun nome di campo tra apici inversi, a meno che il nome del campo non soddisfi i seguenti requisiti:
    • Il nome del campo contiene solo i caratteri a-z, A-Z o 0-9 e il trattino basso (_)
    • Il nome del campo non inizia con 0-9
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

Operazioni di scrittura e transazioni

Limite Dettagli
Dimensione massima della richiesta API 10 MiB
Numero massimo di operazioni di scrittura al secondo per database 10.000 (fino a 10 MiB al secondo)
Frequenza massima di scrittura per un documento 1 al secondo
Frequenza massima di scrittura in una raccolta in cui i documenti contengono valori sequenziali in un campo indicizzato 500 al secondo
Numero massimo di operazioni di scrittura che possono essere passate a un'operazione Commit o eseguite in una transazione 500
Numero massimo di trasformazioni di campo che possono essere eseguite su un singolo documento in un'operazione Commit o in una transazione 500
Limite di tempo per una transazione 270 secondi, con un periodo di scadenza di 60 secondi di inattività

Aggiornamenti in tempo reale

Limite Dettagli
Numero massimo di connessioni simultanee per client mobili/web per database 1.000.000

Indici

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

Limite Dettagli
Numero massimo di indici composti per un database 200
Numero massimo di esenzioni degli indici a campo singolo per un database 200

Numero massimo di voci di indice per ogni documento

40.000

Il numero di voci di indice è la somma di quanto segue per un documento:

  • Il numero di voci degli indici a campo singolo
  • Il numero di voci degli indici composti
Dimensione massima di una voce di indice

7,5 KiB

Per scoprire in che modo Cloud 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 è la somma di quanto segue per un documento:

  • La somma delle dimensioni delle voci degli indici a campo singolo di un documento
  • La 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.

    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 delle operazioni 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 contano ai fini dei limiti.

    Profondità massima delle chiamate funzione 20
    Numero massimo delle chiamate funzione ricorrenti o cicliche 0 (non consentite)
    Numero massimo di espressioni valutate per richiesta 1000
    Dimensione massima di un set di regole 64 kB

    Monitoraggio dell'utilizzo

    Puoi visualizzare l'utilizzo giornaliero di Cloud Firestore nella pagina Quote di App Engine:

    Vai alla pagina Quote