Quote e limiti

Quote e limiti

Questa pagina identifica le quote e i limiti per Firestore.

Quota gratuita

Firestore offre una quota gratuita che ti consente di iniziare senza alcun costo. Di seguito viene riportata la quantità di quote gratuite. 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
Traffico in uscita dalla rete	10 GiB al mese

Limiti standard

Le tabelle seguenti mostrano i limiti che si applicano a Firestore. Questi limiti sono rigidi, se non diversamente specificato.

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
Dimensione massima del nome di un campo	1500 byte
Vincoli dei percorsi dei campi	È necessario separare i nomi dei campi con un singolo punto (.) Possono essere trasmessi come una stringa quando tutti i nomi dei campi nel percorso sono semplici, altrimenti devono essere trasmessi come oggetto FieldPath (es. FieldPath JavaScript) 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
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

Oltre a questi limiti, dovresti visualizzare anche le best practice per la progettazione per la scalabilità.

Limite	Dettagli
Dimensione massima della richiesta API	10 MiB
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 inattività di 60 secondi

Limiti soft

Firestore non ti impedisce di superare le soglie riportate di seguito, ma questo può influire sulle prestazioni.

Limite minimo	Dettagli
Frequenza massima di scrittura in una raccolta in cui i documenti contengono valori sequenziali in un campo indicizzato	500 al secondo

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 Puoi contattare l'assistenza per richiedere un aumento di questo limite.
Numero massimo di configurazioni a campo singolo per un database	200 Sono consentite 200 configurazioni a livello di campo in totale. Una configurazione dei campi può contenere più configurazioni per lo stesso campo. Ad esempio, un'esenzione dell'indicizzazione a campo singolo e un criterio TTL nello stesso campo vengono conteggiati come una configurazione di campo per il 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	200 Sono consentite 200 configurazioni a livello di campo in totale. Una configurazione dei campi può contenere più configurazioni per lo stesso campo. Ad esempio, un'esenzione dell'indicizzazione a campo singolo e un criterio TTL nello stesso campo vengono conteggiati come una configurazione di campo per il 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 sulle dimensioni dell'origine di testo del set di regole pubblicata dalla console Firebase o dall'interfaccia a riga di comando utilizzando firebase deploy. un limite di 250 kB sulle dimensioni del set di regole compilato che risulta quando Firebase elabora l'origine e la rende attiva sul backend.

Monitoraggio dell'utilizzo

Puoi visualizzare l'utilizzo di Firestore nelle pagine Quote dell'API Cloud Firestore e Quote di App Engine.