Comprendi la fatturazione di Cloud Firestore

Questo documento illustra i dettagli sui prezzi di Cloud Firestore. Ti dice anche come limitare e monitorare la tua spesa su Cloud Firestore.

Se paghi in una valuta diversa da USD, si applicano i prezzi indicati nella tua valuta negli SKU di Cloud Platform .

Panoramica dei prezzi

Quando utilizzi Cloud Firestore, ti vengono addebitati i seguenti costi:

• Il numero di documenti che leggi, scrivi ed elimini .
• Il numero di voci di indice corrispondenti alle query di aggregazione . Ti viene addebitato un documento letto per ogni batch di un massimo di 1000 voci di indice corrispondenti alla query.
• La quantità di spazio di archiviazione utilizzato dal database , incluso il sovraccarico per metadati e indici.
• La quantità di larghezza di banda di rete utilizzata .

Lo spazio di archiviazione e l'utilizzo della larghezza di banda sono calcolati in gibibyte (GiB), dove 1 GiB = 2 ³⁰ byte. Tutti gli addebiti maturano giornalmente.

Le seguenti sezioni forniscono dettagli su come ti viene addebitato l'utilizzo di Cloud Firestore.

Prezzi per località

La tabella seguente elenca i prezzi per letture, scritture, eliminazioni e archiviazione per ogni posizione di Cloud Firestore:

Seleziona regione

Se paghi in una valuta diversa da USD, si applicano i prezzi indicati nella tua valuta negli SKU di Cloud Platform .

Legge, scrive ed elimina

Ti viene addebitato ogni documento letto, scritto ed eliminato che esegui con Cloud Firestore.

Gli addebiti per scritture ed eliminazioni sono semplici. Per le scritture, ogni operazione set o update conta come una singola scrittura.

Gli addebiti per le letture hanno alcune sfumature che dovresti tenere a mente. Le sezioni seguenti spiegano queste sfumature in dettaglio.

Query di aggregazione

Per le query di aggregazione come count() , ti viene addebitato un documento letto per ogni batch di un massimo di 1000 voci di indice corrispondenti alla query. Per le query di aggregazione che corrispondono a 0 voci di indice, è previsto un addebito minimo di una lettura di documento.

Ad esempio, le operazioni count() che corrispondono a un numero di voci di indice compreso tra 0 e 1000 vengono fatturate per la lettura di un documento. Per un'operazione count() che corrisponde a 1500 voci di indice, vengono fatturate 2 letture di documenti.

Ascolto dei risultati della query

Cloud Firestore ti consente di ascoltare i risultati di una query e ottenere aggiornamenti in tempo reale quando i risultati della query cambiano.

Quando ascolti i risultati di una query, ti viene addebitata una lettura ogni volta che un documento nel set di risultati viene aggiunto o aggiornato. Ti viene inoltre addebitata una lettura quando un documento viene rimosso dal set di risultati perché il documento è stato modificato. (Al contrario, quando un documento viene eliminato, non ti viene addebitato alcun costo per la lettura.)

La fatturazione degli ascoltatori negli SDKS per dispositivi mobili e Web dipende anche dall'abilitazione o meno della persistenza offline :

• Se la persistenza offline è abilitata e l'ascoltatore è disconnesso per più di 30 minuti (ad esempio, se l'utente va offline), ti verranno addebitate le letture come se avessi emesso una query nuova di zecca.

• Se la persistenza offline è disabilitata, ti verranno addebitate le letture come se avessi emesso una query nuova di zecca ogni volta che l'ascoltatore si disconnette e si riconnette.

Gestione di set di risultati di grandi dimensioni

Cloud Firestore ha diverse funzionalità per aiutarti a gestire le query che restituiscono un gran numero di risultati:

• Cursori , che consentono di riprendere una query di lunga durata.
• Token di pagina , che ti aiutano a impaginare i risultati della query.
• Limits , che specificano quanti risultati recuperare.
• Offset , che consentono di saltare un numero fisso di documenti.

Non ci sono costi aggiuntivi per l'utilizzo di cursori, token di pagina e limiti. In effetti, queste funzionalità possono aiutarti a risparmiare denaro leggendo solo i documenti di cui hai effettivamente bisogno.

Tuttavia, quando invii una query che include un offset, ti viene addebitata una lettura per ogni documento ignorato. Ad esempio, se la tua query utilizza un offset di 10 e la query restituisce 1 documento, ti verranno addebitate 11 letture. A causa di questo costo aggiuntivo, dovresti usare i cursori invece degli offset quando possibile.

Query diverse dalle letture di documenti

Per query diverse dalle letture di documenti, ad esempio una richiesta di un elenco di ID raccolta, ti viene addebitata una lettura di documento. Se il recupero del set completo di risultati richiede più di una richiesta (ad esempio, se utilizzi l'impaginazione), ti verrà addebitata una volta per richiesta.

Costo minimo per le query

È previsto un addebito minimo di un documento letto per ogni query eseguita, anche se la query non restituisce alcun risultato.

Regole di sicurezza di Cloud Firestore

Per le librerie di client Web e mobili, se le regole di sicurezza di Cloud Firestore utilizzano exists() , get() o getAfter() per leggere uno o più documenti dal database, ti verranno addebitate le letture aggiuntive come segue:

• Ti vengono addebitate le letture necessarie per valutare le regole di sicurezza di Cloud Firestore.

  Ad esempio, se le tue regole fanno riferimento a tre documenti, ma Cloud Firestore deve leggere solo due di quei documenti per valutare le tue regole, ti verranno addebitate due letture aggiuntive per i documenti dipendenti.

  Ti viene addebitata solo una lettura per documento dipendente anche se le tue regole fanno riferimento a quel documento più di una volta.

• Ti viene addebitata la valutazione della regola solo una volta per richiesta.

  Di conseguenza, può costare meno leggere più documenti che leggerli uno alla volta, perché la lettura di più documenti richiede meno richieste.

• Quando ascolti i risultati di una query, ti viene addebitata la valutazione della regola in tutti i seguenti casi:

  • Quando invii la query.
  • Ogni volta che i risultati della query vengono aggiornati.
  • Ogni volta che il dispositivo dell'utente va offline, torna online.
  • Ogni volta che aggiorni le tue regole.
  • Ogni volta che aggiorni i documenti dipendenti nelle tue regole.

Dimensioni di archiviazione

Ti viene addebitata la quantità di dati archiviati in Cloud Firestore, incluso l'overhead di archiviazione. La quantità di sovraccarico include metadati, indici automatici e indici compositi. Ogni documento archiviato in Cloud Firestore richiede i seguenti metadati:

• L'ID del documento, inclusi l'ID della raccolta e il nome del documento.
• Il nome e il valore di ciascun campo. Poiché Cloud Firestore è senza schema, il nome di ogni campo in un documento deve essere archiviato con il valore del campo.
• Eventuali indici a campo singolo e compositi che fanno riferimento al documento. Ogni voce di indice contiene l'ID raccolta; qualsiasi numero di valori di campo, a seconda della definizione dell'indice; e il nome del documento.

Scopri come viene calcolato lo spazio di archiviazione di Cloud Firestore in Calcolo delle dimensioni dello spazio di archiviazione . Puoi visualizzare la quantità di spazio di archiviazione utilizzata dal tuo database visitando la pagina dei dettagli della quota di App Engine nella console di GCP.

Larghezza di banda della rete

Ti viene addebitata la larghezza di banda di rete utilizzata dalle tue richieste Cloud Firestore, come mostrato nelle sezioni seguenti. Il costo della larghezza di banda di rete di una richiesta Cloud Firestore dipende dalle dimensioni della risposta della richiesta, dalla posizione del database Cloud Firestore e dalla destinazione della risposta.

Cloud Firestore calcola la dimensione della risposta in base a un formato di messaggio serializzato. L'overhead del protocollo, come l'overhead SSL, non conta per l'utilizzo della larghezza di banda della rete. Le richieste rifiutate dalle regole di sicurezza di Cloud Firestore non vengono conteggiate ai fini dell'utilizzo della larghezza di banda della rete.

Per sapere quanta larghezza di banda di rete hai utilizzato, puoi utilizzare la console di GCP per esportare i tuoi dati di fatturazione in un file .

Prezzi generali della rete

Per le richieste che hanno origine all'interno di Google Cloud Platform (ad esempio, da un'applicazione in esecuzione su Google Compute Engine), ti verranno addebitati i seguenti costi:

Tipo di traffico	Prezzo
Ingresso	Gratuito
Uscita all'interno di una regione	Gratuito
Uscita tra regioni nella stessa multiregione	Gratuito
In uscita tra regioni all'interno degli Stati Uniti (per GiB)	$ 0,01 (i primi 10 GiB al mese sono gratuiti)
In uscita tra regioni, escluso il traffico tra regioni degli Stati Uniti	Tariffe in uscita da Internet di Google Cloud Platform

Se paghi in una valuta diversa da USD, si applicano i prezzi indicati nella tua valuta negli SKU di Cloud Platform .

Cloud Firestore è inoltre soggetto a costi aggiuntivi in ​​uscita da Internet per quanto segue:

• Richieste Google Cloud tra regioni, escluso il traffico tra regioni degli Stati Uniti
• Richieste dall'esterno di Google Cloud (ad esempio, dal dispositivo mobile di un utente)

Consulta le tariffe in uscita da Internet di Google Cloud .

Guarda un esempio di prezzo

Per vedere in che modo i costi di fatturazione di Cloud Firestore maturano in un'app di esempio reale, consulta l' esempio di fatturazione di Cloud Firestore .

Gestisci la spesa

Per evitare addebiti imprevisti sulla bolletta, imposta budget mensili e avvisi utilizzando la console di fatturazione di Google Cloud.

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.