Utilizzo e limiti

Utilizza questa guida per comprendere i limiti di Cloud Firestore e consulta i prezzi di Cloud Firestore per una spiegazione completa e dettagliata dei costi di Cloud Firestore, inclusi gli aspetti a cui prestare attenzione.

Monitora il tuo utilizzo

Per monitorare l'utilizzo di Cloud Firestore, apri la scheda Utilizzo di Cloud Firestore nella console di Firebase. Utilizza la dashboard per valutare il tuo utilizzo in diversi periodi di tempo.

Nota: a causa del modo in cui il dashboard calcola l'utilizzo, i numeri riportati possono differire leggermente dai report di fatturazione. I report di fatturazione sono i numeri di utilizzo finali.

Utilizzo dettagliato in Google Cloud Console

Quando crei un progetto Firebase, crei anche un progetto Google Cloud. Le pagine Cloud Firestore API Quotas e App Engine Quotas in Google Cloud Console monitorano l'utilizzo di Cloud Firestore e le informazioni sulle quote.

Quota gratuita

Cloud Firestore offre una quota gratuita che ti consente di iniziare senza alcun costo. Gli importi delle quote gratuite sono elencati di seguito. Se hai bisogno di una quota maggiore, devi abilitare la fatturazione per il tuo progetto Cloud Platform .

Le quote vengono applicate quotidianamente e reimpostate intorno alla mezzanotte del fuso orario del Pacifico.

Livello gratuito	Quota
Dati memorizzati	1 GB
Il documento legge	50.000 al giorno
Il documento scrive	20.000 al giorno
Documento eliminato	20.000 al giorno
Uscita dalla rete	10 Giga al mese

Limiti standard

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

Raccolte, documenti e campi

Limite	Dettagli
Vincoli sugli ID raccolta	Devono essere caratteri UTF-8 validi Non deve superare i 1.500 byte Non può contenere una barra ( / ) Non può essere costituito esclusivamente da un singolo punto ( . ) o da doppi punti ( .. ) Impossibile trovare una corrispondenza con l'espressione regolare __.*__
Profondità massima delle sottoraccolte	100
Vincoli sugli ID documento	Devono essere caratteri UTF-8 validi Non deve superare i 1.500 byte Non può contenere una barra ( / ) Non può essere costituito esclusivamente da un singolo punto ( . ) o da doppi punti ( .. ) Impossibile trovare una corrispondenza con l'espressione regolare __.*__ Se importi entità Datastore in un database Firestore, gli ID entità numerici vengono esposti come __id[0-9]+__
Dimensione massima per un nome di documento	6 KiB
Dimensione massima per un documento	1 MiB (1.048.576 byte)
Vincoli sui nomi dei campi	Devono essere caratteri UTF-8 validi
Dimensione massima di un nome di campo	1.500 byte
Vincoli sui percorsi del campo	Devi separare i nomi dei campi con un solo punto ( . ) Può essere passato come stringa quando tutti i nomi di campo nel percorso sono semplici, altrimenti deve essere passato come oggetto FieldPath ( es. JavaScript FieldPath ) Un nome di campo semplice è quello in cui sono vere tutte le seguenti condizioni: Contiene solo i caratteri az , AZ , 0-9 e underscore ( _ ) Non inizia con 0-9
Dimensione massima di un percorso di campo	1.500 byte
Dimensione massima di un valore di campo	1 MiB - 89 byte (1.048.487 byte)
Profondità massima di campi in una mappa o in un array	20

Scritture e transazioni

Oltre a questi limiti, dovresti anche vedere le best practice per la progettazione in scala .

Limite	Dettagli
Dimensione massima della richiesta API	10 MB
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 tempo di scadenza inattivo di 60 secondi

Limiti morbidi

Cloud Firestore non ti impedisce di superare le soglie sottostanti, ma ciò influisce sulle prestazioni.

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

Indici

I seguenti limiti si applicano agli indici a campo singolo e agli indici compositi :

Limite	Dettagli
Numero massimo di indici compositi 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 un totale di 200 configurazioni a livello di campo. Una configurazione di campo può contenere più configurazioni per lo stesso campo. Ad esempio, un'esenzione per l'indicizzazione di un campo singolo e un criterio TTL sullo stesso campo vengono conteggiati come configurazione di un campo ai fini del limite.
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 di indice a campo singolo Il numero di voci di indice composito Per vedere come Cloud Firestore trasforma un documento e una serie di indici in voci di indice, consulta questo esempio di conteggio delle voci di indice .
Numero massimo di campi in un indice composto	100
Dimensione massima di una voce di indice	7,5 KiB Per vedere in che modo Cloud Firestore calcola la dimensione della voce di indice, consulta la dimensione della voce di indice .
Somma massima delle dimensioni delle voci di indice di un documento	8 MB La dimensione totale è la somma di quanto segue per un documento: La somma delle dimensioni delle voci di indice a campo singolo di un documento La somma delle dimensioni delle voci di indice composito 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 coinvolgono valori di campo troncati possono restituire risultati incoerenti.

Tempo di vita (TTL)

Limite	Dettagli
Numero massimo di configurazioni a campo singolo per un database	200 Sono consentite un totale di 200 configurazioni a livello di campo. Una configurazione di campo può contenere più configurazioni per lo stesso campo. Ad esempio, un'esenzione per l'indicizzazione di un campo singolo e un criterio TTL sullo stesso campo vengono conteggiati come configurazione di un campo ai fini del limite.

Esportazione importazione

I seguenti limiti si applicano alle operazioni di importazione ed esportazione gestite :

Limite	Dettagli
Numero totale massimo consentito al minuto di richieste di esportazione e importazione per un progetto	20
Numero massimo di esportazioni e importazioni simultanee	50
Numero massimo di filtri ID raccolta per le 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 richieste di query. 20 per letture multi-documento, transazioni e scritture in batch. Per ogni operazione vale anche il precedente limite 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 scrittura. In questo caso, ogni 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 memorizzate nella cache non vengono conteggiate ai fini dei limiti.
Profondità massima dell'istruzione match nidificata	10
Lunghezza massima del percorso, in segmenti di percorso, consentita all'interno di una serie di istruzioni match nidificate	100
Numero massimo di variabili di acquisizione del percorso consentite all'interno di una serie di istruzioni match nidificate	20
Profondità massima di chiamata di funzione	20
Numero massimo di argomenti della funzione	7
Numero massimo di associazioni di variabili let per funzione	10
Numero massimo di chiamate di funzioni ricorsive o cicliche	0 (non consentito)
Numero massimo di espressioni valutate per richiesta	1.000
Dimensione massima di un set di regole	I set di regole devono rispettare due limiti di dimensione: un limite di 256 KB sulla dimensione dell'origine di testo del set di regole pubblicata dalla console Firebase o dalla CLI utilizzando firebase deploy . un limite di 250 KB sulla dimensione del set di regole compilato che risulta quando Firebase elabora la sorgente e la rende attiva sul back-end.

Gestisci la spesa

Per evitare addebiti imprevisti sulla bolletta, imposta budget e avvisi mensili.

Imposta un budget mensile

Per monitorare i costi di Cloud Firestore, crea un budget mensile in Google Cloud Console. I budget non limiteranno il tuo utilizzo, ma puoi impostare avvisi per avvisarti quando ti avvicini o superi i costi pianificati per il mese.

Per impostare un budget, vai alla sezione Fatturazione in Google Cloud Console e crea un budget per il tuo account Cloud Billing. Puoi utilizzare le impostazioni di avviso predefinite o modificare gli avvisi per inviare notifiche a diverse percentuali del tuo budget mensile.

Ulteriori informazioni sull'impostazione dei budget e degli avvisi sui budget .

Imposta un limite di spesa giornaliero

Importante: Cloud Firestore non supporta più i nuovi limiti di spesa di App Engine. Dopo il 12 dicembre 2019, non puoi applicare i nuovi limiti di spesa di App Engine. Si applicano ancora i limiti di spesa fissati prima del 12 dicembre.

Per limitare l'utilizzo di Cloud Firestore, imposta un limite di spesa giornaliero tramite App Engine. App Engine ti consente di impostare un limite di spesa giornaliero per le risorse associate ad App Engine, incluso Cloud Firestore. Il limite di App Engine non si applica ad altri prodotti Firebase.