Google is committed to advancing racial equity for Black communities. See how.
Questa pagina è stata tradotta dall'API Cloud Translation.
Switch to English

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, comprese le cose 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.

Utilizzo dettagliato nella console di Google Cloud Platform

Quando crei un progetto Firebase, crei anche un progetto in Google Cloud Platform. La pagina delle quote di App Engine nella console di Cloud Cloud Platform tiene traccia dell'utilizzo di Cloud Firestore e delle informazioni sulle quote.

Quota gratuita

Cloud Firestore offre una quota gratuita che ti consente di iniziare senza alcun costo. Gli importi delle quote libere 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 ora del Pacifico.

Livello gratuito quota
Dati memorizzati 1 GiB
Il documento legge 50.000 al giorno
Il documento scrive 20.000 al giorno
Il documento viene eliminato 20.000 al giorno
Uscita dalla rete 10 GiB al mese

Limiti standard

Le tabelle seguenti mostrano i limiti che si applicano all'utilizzo di Cloud Firestore.

Raccolte, documenti e campi

Limite Dettagli
Vincoli sugli ID di raccolta
  • Deve contenere caratteri UTF-8 validi
  • Non deve essere più lungo di 1.500 byte
  • Non può contenere una barra ( / )
  • Non può essere costituito esclusivamente da un singolo punto ( . ) O da un doppio punto ( .. )
  • Impossibile trovare l'espressione regolare __.*__
Profondità massima delle sottoraccolte 100
Vincoli sugli ID documento
  • Deve contenere caratteri UTF-8 validi
  • Non deve essere più lungo di 1.500 byte
  • Non può contenere una barra ( / )
  • Non può essere costituito esclusivamente da un singolo punto ( . ) O da un doppio punto ( .. )
  • Impossibile trovare 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
Dimensioni massime per un documento 1 MiB (1.048.576 byte)
Vincoli sui nomi dei campi Deve contenere caratteri UTF-8 validi
Dimensione massima di un nome di campo 1.500 byte
Vincoli sui percorsi dei campi
  • È necessario separare i nomi dei campi con un unico punto ( . )
  • Può essere passato come stringa quando tutti i nomi di campo nel percorso sono semplici, altrimenti deve essere passato come oggetto FieldPath ( ad 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 trattino basso ( _ )
  • 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 dei campi in una mappa o in un array 20

Scritture e transazioni

Limite Dettagli
Dimensione massima della richiesta API 10 MiB
Numero massimo di scritture al secondo per database 10.000 (fino a 10 MiB al secondo)
Velocità massima di scrittura sostenuta in un documento

1 al secondo

Il mantenimento di una velocità di scrittura superiore a una volta al secondo aumenta la latenza e causa errori di contesa. Questo non è un limite rigido e puoi superare il limite in brevi raffiche.

Velocità di scrittura massima in una raccolta in cui i documenti contengono valori sequenziali in un campo indicizzato 500 al secondo
Numero massimo di scritture che possono essere passati ad un Commit operazione o eseguite in una transazione 500
Numero massimo di trasformazioni di campo che possono essere eseguite su un unico documento in un Commit operazione o in una transazione 500
Limite di tempo per una transazione 270 secondi, con un tempo di scadenza di inattività di 60 secondi

Aggiornamenti in tempo reale

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

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
Numero massimo di esenzioni dell'indice 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 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, vedi questo esempio di conteggio delle voci di indice .

Dimensione massima di una voce di indice

7.5 KiB

Per vedere come Cloud Firestore calcola la dimensione della voce dell'indice, vedi Dimensione della voce dell'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 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.

    Esportazione importazione

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

    Limite Dettagli
    Numero massimo totale di richieste di esportazione e importazione per un progetto consentito al minuto 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 exists() , get() , e getAfter() chiamate per richiesta
    • 10 per richieste di documenti singoli e richieste di query.
    • 20 per letture di più documenti, transazioni e scritture in batch. Il limite precedente di 10 si applica anche a ciascuna operazione.

      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 al documento 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 genera 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 di match nidificata 10
    Lunghezza massima del percorso, in segmenti di percorso, consentita all'interno di una serie di istruzioni di match nidificate 100
    Numero massimo di variabili di acquisizione del percorso consentite all'interno di una serie di istruzioni di match nidificate 20
    Profondità massima della 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 funzione 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 Verax devono rispettare due limiti di dimensione:
    • un limite di 256 KB per la dimensione dell'origine del testo del set di regole Verax pubblicato dalla console Firebase o dalla CLI utilizzando la firebase deploy .
    • un limite di 250 KB sulla dimensione del set di regole compilato che risulta quando Firebase elabora il sorgente Verax e lo rende attivo 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 nella console di Cloud Platform. I budget non limitano 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 nella console di Cloud Platform e crea un budget per il tuo account di fatturazione. È possibile utilizzare le impostazioni di avviso predefinite o modificare gli avvisi per inviare notifiche a percentuali diverse del budget mensile.

    Ulteriori informazioni sull'impostazione di un budget nella console di Cloud Platform .

    Imposta un limite di spesa giornaliero

    Per limitare l'utilizzo di Cloud Firestore, imposta un limite di spesa giornaliero tramite Google 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.