Le operazioni di lettura vengono addebitate in unità di lettura, che riflettono i dati elaborati per soddisfare la query, misurati in tranche da 4 KiB.
Le operazioni di scrittura ed eliminazione vengono addebitate in unità di scrittura, che riflettono i dati elaborati per eseguire l'operazione, misurati in tranche da 1 KiB.
Gli addebiti per le operazioni di lettura, scrittura ed eliminazione presentano alcune sfumature di cui devi tenere conto. Tali sottigliezze vengono spiegate in dettaglio nelle sezioni che seguono.
Nota: puoi utilizzare Firestore Query Explain per comprendere meglio come viene elaborata e fatturata ogni query.
Operazioni di lettura
La maggior parte delle operazioni di lettura comporta l'esecuzione di una lettura puntuale di un documento specifico basata su un identificatore o la scansione di un intervallo di dati . Le operazioni di lettura consumano unità di lettura.
Le operazioni di lettura puntuale vengono addebitate in base ai dati letti, arrotondati per eccesso in tranche da 4 KiB. Ad esempio, la ricerca di un documento per ID con un documento di 3 KiB verrà arrotondata a 4 KiB e verrà addebitata 1 unità di lettura.
Le operazioni di scansione comportano la lettura di intervalli di dati continui. La quantità di dati letti durante le operazioni di scansione dipende da considerazioni quali la forma dei dati stessi, la disponibilità di indici e la complessità del piano di query. La quantità totale di dati continui scansionati viene sommata e fatturata come unità di lettura in tranche da 4 KiB.
Le query vengono addebitate in base alla quantità di dati (indici e/o documenti) letti per elaborare la query, che potrebbe superare i dati restituiti.
Un costo minimo di 1 unità di lettura si applica a tutte le operazioni di lettura.
Firestore Query Explain può aiutarti a comprendere come viene elaborata e fatturata ogni query.
Operazioni di scrittura
Le operazioni di scrittura includono la creazione di nuovi documenti e l'aggiornamento di quelli esistenti. Le operazioni di scrittura consumano unità di scrittura.
La creazione di un nuovo documento viene addebitata in base alle dimensioni del documento creato e alle dimensioni delle voci di indice che vengono scritte. Ogni documento o voce di indice scritta viene addebitata in base all'elemento individuale scritto, arrotondato per eccesso al KiB più vicino.
L'aggiornamento di un documento comporta la lettura dei dati per trovare il documento da aggiornare, la valutazione delle modifiche da apportare al documento stesso e agli indici corrispondenti e quindi la scrittura di queste modifiche nel database. La dimensione del documento addebitata è la più grande tra le dimensioni prima e dopo l'aggiornamento e vengono addebitati i costi per le voci di indice che devono essere aggiornate ed eliminate. La quantità totale di dati coinvolti nell'aggiornamento, come descritto sopra, viene addebitata come unità di scrittura in tranche da 1 KiB.
Operazioni di eliminazione
Le operazioni di eliminazione vengono addebitate in base alle dimensioni del documento e alle voci di indice corrispondenti che vengono eliminate. Ogni elemento eliminato viene addebitato come unità di scrittura in tranche da 1 KiB.
Prezzi delle query di ascolto in tempo reale
Le query in tempo reale sono suddivise in due passaggi distinti con una struttura dei prezzi separata:
Query iniziale per sincronizzare i risultati: recupera il set iniziale di dati e viene addebitata utilizzando le unità di lettura.
Aggiornamenti in tempo reale: aggiornamenti successivi che riflettono le modifiche al documento dopo la query iniziale e vengono addebitati utilizzando le unità di aggiornamento in tempo reale.
Per ogni documento aggiornato, paghi un'unità di aggiornamento in tempo reale per 4 KiB di dati.
Ti viene addebitata un'unità di aggiornamento in tempo reale anche quando un documento viene rimosso dal set di risultati. Al contrario, quando un documento viene eliminato, non viene addebitata una lettura.
La fatturazione degli ascoltatori negli SDK per dispositivi mobili e web dipende anche dal fatto che la persistenza offline sia abilitata o meno:
Se la persistenza offline è abilitata e il listener viene disconnesso per più di 30 minuti (ad esempio, se l'utente va offline), ti verrà addebitato il costo come se avessi emesso una query completamente nuova e gli aggiornamenti in tempo reale successivi.
Se la persistenza offline è disabilitata, ti verranno addebitati i documenti e le voci di indice letti come se avessi eseguito una query completamente nuova ogni volta che il listener si disconnette e si riconnette e per gli aggiornamenti in tempo reale successivi.
