Calcoli dello spazio di archiviazione

Questa pagina descrive le dimensioni di archiviazione di documenti, nomi di documenti, campi e voci di indice in Cloud Firestore.

Dimensioni della stringa

Le dimensioni delle stringhe vengono calcolate come il numero di byte con codifica UTF-8 + 1.

I seguenti elementi vengono archiviati come stringhe:

• ID raccolta
• ID documento stringa
• Nomi dei documenti
• Nomi dei campi
• Valori dei campi stringa

Ad esempio:

• L'ID raccolta tasks utilizza 5 byte + 1 byte, per un totale di 6 byte.
• Il nome del campo description utilizza 11 byte + 1 byte, per un totale di 12 byte.

Dimensioni dell'ID documento

La dimensione di un ID documento è la dimensione della stringa per un ID stringa o 8 byte per un ID intero.

Dimensioni del nome del documento

La dimensione del nome di un documento è la somma di:

• La dimensione di ogni ID raccolta e ID documento nel percorso del documento
• 16 byte aggiuntivi

Per un documento nella raccolta secondaria users/jeff/tasks con un ID documento stringa di my_task_id, la dimensione del nome del documento è 6 + 5 + 6 + 11 + 16 = 44 byte:

• 6 byte per l'ID raccolta users
• 5 byte per l'ID documento jeff
• 6 byte per l'ID raccolta tasks
• 11 byte per l'ID documento my_task_id
• 16 byte aggiuntivi

Dimensione del valore del campo

La tabella seguente mostra le dimensioni dei valori dei campi in base al tipo.

Ad esempio, un campo booleano denominato done utilizzerebbe 6 byte:

• 5 byte per il nome del campo done
• 1 byte per il valore booleano

Dimensioni del documento

Le dimensioni di un documento sono la somma di:

• Le dimensioni del nome del documento
• La somma della dimensione della stringa di ogni nome di campo
• La somma delle dimensioni di ogni valore di campo
• 32 byte aggiuntivi

Questo esempio riguarda un documento nella raccolta secondaria users/jeff/tasks con un ID documento stringa my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

La dimensione totale dei campi è di 71 byte:

Quindi le dimensioni del documento sono 44 + 71 + 32 = 147 byte:

• 44 byte per il nome del documento
• 71 byte per i campi
• 32 byte aggiuntivi

Dimensioni della voce dell'indice

Le dimensioni delle voci dell'indice vengono calcolate come segue per gli indici a campo singolo e compositi.

Dimensioni della voce dell'indice a campo singolo

La dimensione di una voce di indice a campo singolo dipende dal fatto che l'ambito di un indice sia una raccolta o un gruppo di raccolte.

Ambito della raccolta

La dimensione di una voce in un indice a campo singolo con ambito della raccolta è la somma di:

• Le dimensioni del nome del documento indicizzato
• La dimensione del nome del documento del documento padre del documento indicizzato
• La dimensione della stringa del nome del campo indicizzato
• La dimensione del valore del campo indicizzato
• 32 byte aggiuntivi

Considera un documento nella raccolta secondaria users/jeff/tasks con un ID documento stringa my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

Per un indice a campo singolo con ambito raccolta che indicizza il campo done, la dimensione totale della voce in questo indice è di 109 byte:

• 44 byte per il nome del documento users/jeff/tasks/my_task_id
• 27 byte per il nome del documento padre users/jeff
• 5 byte per il nome del campo done
• 1 byte per il valore del campo booleano
• 32 byte aggiuntivi

Ambito del gruppo di raccolte

La dimensione di una voce in un indice a campo singolo con ambito del gruppo di raccolte è la somma di:

• Le dimensioni del nome del documento indicizzato
• La dimensione della stringa del nome del campo indicizzato
• La dimensione del valore del campo indicizzato
• 48 byte aggiuntivi

Considera un documento nella raccolta secondaria users/jeff/tasks con un ID documento stringa my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

Per un indice a campo singolo con ambito del gruppo di raccolte che indicizza il campo done, la dimensione totale della voce in questo indice è di 98 byte:

• 44 byte per il nome del documento users/jeff/tasks/my_task_id
• 5 byte per il nome del campo done
• 1 byte per il valore del campo booleano
• 48 byte aggiuntivi

Dimensioni della voce dell'indice composto

La dimensione di una voce in un indice composto dipende dal fatto che l'ambito dell'indice sia limitato a una raccolta o a un gruppo di raccolte.

Ambito della raccolta

La dimensione di una voce di indice in un indice composto con ambito della raccolta è la somma di:

• Le dimensioni del nome del documento indicizzato
• La dimensione del nome del documento del documento principale del documento indicizzato
• La somma dei valori dei campi indicizzati
• 32 byte aggiuntivi

Considera un documento nella raccolta secondaria users/jeff/tasks con un ID documento stringa my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

Per un indice composto con ambito della raccolta che indicizza i campi done e priority (entrambi in ordine crescente), la dimensione totale della voce in questo indice è di 112 byte:

• 44 byte per il nome del documento users/jeff/tasks/my_task_id
• 27 byte per il nome del documento padre users/jeff
• 1 byte per il valore del campo booleano
• 8 byte per il valore del campo intero
• 32 byte aggiuntivi

Ambito del gruppo di raccolte

La dimensione di una voce di indice in un indice composto con ambito del gruppo di raccolte è la somma di:

• Le dimensioni del nome del documento indicizzato
• La somma dei valori dei campi indicizzati
• 32 byte aggiuntivi

Considera un documento nella raccolta secondaria users/jeff/tasks con un ID documento stringa my_task_id:

 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Cloud Firestore"

Per un indice composto con ambito del gruppo di raccolte che indicizza i campi done e priority (entrambi in ordine crescente), la dimensione totale della voce di indice in questo indice è di 85 byte:

• 44 byte per il nome del documento users/jeff/tasks/my_task_id
• 1 byte per il valore del campo booleano
• 8 byte per il valore del campo intero
• 32 byte aggiuntivi

Dimensioni della voce dell'indice di ricerca testuale

La dimensione di una voce dell'indice della Ricerca testuale in un indice è la somma di:

• La dimensione della stringa del nome della raccolta
• Le dimensioni del valore dell'ID documento
• La somma dei byte dei valori dei campi indicizzati (x2)
• 48 byte aggiuntivi per i metadati generali

Considera un esempio di evento di inserimento per un documento con ID documento my_task_id nella raccolta tasks:

La dimensione totale di una voce dell'indice della Ricerca testuale su description è di 105 byte in base a:

• 6 byte per il nome della raccolta tasks
• 11 byte per il valore dell'ID documento
• 44 byte, in base a 22 byte per il campo description x2
• 48 byte aggiuntivi per i metadati generali

Dimensioni delle voci dell'indice geospaziale

La dimensione di una voce di indice geospaziale in un indice è la somma di:

• La dimensione della stringa del nome della raccolta
• Le dimensioni del valore dell'ID documento
• 128 byte per ogni punto geografico indicizzato
• 48 byte aggiuntivi per i metadati generali

Considera un esempio di evento di inserimento per un documento con ID documento my_place nella raccolta places:

{
     "type": "Restaurant",
     "visited": false,
     "priority": 1,
     "location": GeoPoint(longitude, latitude)
}

La dimensione totale di una voce dell'indice geospaziale su location è di 192 byte in base a:

• 7 byte per il nome della raccolta places
• 9 byte per l'ID documento
• 128 byte per il campo location
• 48 byte aggiuntivi per i metadati generali

Passaggi successivi