Calcoli dello spazio di archiviazione

Questa pagina descrive le dimensioni di archiviazione di entità, chiavi, proprietà e voci di indice in Firestore in modalità Datastore. Per informazioni sui costi di archiviazione, vedi Prezzi in modalità Datastore.

Dimensione stringa

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

Le seguenti stringhe vengono memorizzate come stringhe:

  • Chiavi
  • Nomi ordinari
  • Nomi degli spazi dei nomi (la dimensione dello spazio dei nomi predefinito è 0)
  • Nomi proprietà
  • Valori delle proprietà stringa

Ad esempio:

  • Il nome del tipo Task utilizza 4 byte + 1 byte, per un totale di 5 byte.
  • Il nome della proprietà description utilizza 11 byte + 1 byte, per un totale di 12 byte.
  • Il nome dello spazio dei nomi my_name_space utilizza 13 byte + 1 byte, per un totale di 14 byte.

Dimensione chiave

La dimensione di una chiave è la somma

  • Le dimensioni della stringa dello spazio dei nomi (se non si trova nello spazio dei nomi predefinito)
  • Le dimensioni complete della stringa del percorso della chiave (gli ID interi sono di 8 byte ciascuno)
  • 16 byte

Per una chiave di tipo Task nello spazio dei nomi predefinito con ID numerico e nessun predecessore:

Task id:5730082031140864

La dimensione della chiave è 5 + 8 + 16 = 29 byte:

  • 5 byte per il nome del tipo Task
  • 8 byte per l'ID numerico
  • 16 byte per una chiave

Per una chiave di tipo Task nello spazio dei nomi predefinito con ID stringa e nessun predecessore:

Task name:my_task_id

La dimensione della chiave è 5 + 11 + 16 = 32 byte:

  • 5 byte per il nome del tipo Task
  • 11 byte per l'ID stringa my_task_id
  • 16 byte per una chiave

Per un'entità Task con un predecessore TaskList nello spazio dei nomi predefinito:

TaskList id:5654313976201216 > Task id:5629499534213120

L'antenato usa 9 + 8 = 17 byte:

  • 9 byte per il nome del tipo TaskList
  • 8 byte per l'ID numerico

Di conseguenza, la dimensione della chiave di un'entità Task con un predecessore TaskList utilizza 17 + 5 + 8 + 16 = 46 byte:

  • 17 byte per il predecessore
  • 5 byte per il nome del tipo Task
  • 8 byte per l'ID numerico
  • 16 byte per una chiave

Se questa entità si trova nello spazio dei nomi my_name_space, la dimensione della chiave è 14 + 46 = 60 byte, perché il nome my_name_space utilizza 14 byte.

Dimensioni proprietà

La dimensione di una proprietà è la somma

  • La dimensione della stringa del nome della proprietà
  • Le dimensioni del valore della proprietà

Di seguito sono riportate le dimensioni dei valori delle proprietà per tipo.

Tipo Dimensioni
Array la somma delle dimensioni dei suoi valori
Blob lunghezza in byte
Booleano 1 byte
Double 8 byte
Entità incorporata Le dimensioni dell'entità
Punto geografico 16 byte
Numero intero 8 byte
Chiave le dimensioni della chiave
Null 1 byte
Stringa numero di byte con codifica UTF-8 + 1
Timestamp 8 byte

Ad esempio, una proprietà denominata done con un tipo di valore booleano userebbe 6 byte:

  • 5 byte per il nome della proprietà done
  • 1 byte per il valore booleano

Dimensione entità

La dimensione di un'entità è la somma

Questo esempio riguarda un'entità di tipo Task nello spazio dei nomi predefinito con un ID numerico e nessun predecessore:

Task id:5730082031140864
 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Google Cloud Datastore"

La dimensione totale delle proprietà è di 78 byte:

Nome e valore della proprietà Dimensioni proprietà in byte
"type": "Personal" 14
5 per il nome della proprietà + 9 per il valore della stringa della proprietà
"done": false 6
5 per il nome della proprietà + 1 per il valore booleano della proprietà
"priority": 1 17
9 per il nome della proprietà + 8 per il valore intero della proprietà
"description": "Learn Google Cloud Datastore" 41
12 per il nome della proprietà + 29 per il valore della stringa della proprietà

Quindi la dimensione dell'entità è 29 + 78 + 32 = 139 byte:

  • 29 byte per la chiave
  • 78 byte per le proprietà
  • 32 byte per un'entità

Dimensioni voce di indice

La dimensione di una voce di indice viene calcolata come segue per gli indici integrati e composti.

Indici integrati

La dimensione di una voce di indice integrata è la somma di:

Ad esempio, prendi un'entità di tipo Task nello spazio dei nomi predefinito con un ID numerico e nessun predecessore:

Task id:5730082031140864
 - "type": "Personal"
 - "done": false
 - "priority": 1
 - "description": "Learn Google Cloud Datastore"

Se done è una proprietà indicizzata, la voce dell'indice integrato per la singola proprietà dell'indice done è composta dalla chiave, dal nome e dal valore della proprietà done, dal nome del tipo Task e da 32 byte per una voce di indice. La dimensione totale di questa voce di indice è di 72 byte:

  • 29 per la chiave
  • 6 per il nome della proprietà done e il valore booleano
  • 5 per il nome tipo Task
  • 32 per una voce di indice

Per impostazione predefinita, i database in modalità Datastore predefinire automaticamente due indici di proprietà singoli per ogni proprietà di ogni tipo di entità, uno in ordine crescente e uno in ordine decrescente. Pertanto, questa entità avrà una voce di indice di dimensione 72 byte nell'indice della singola proprietà done in ordine crescente e una voce di indice di 72 byte nell'indice della singola proprietà done in ordine decrescente.

Indici composti

La dimensione di una voce di indice composto è la somma di:

Ad esempio, prendi un'entità di tipo Task nello spazio dei nomi predefinito con un ID numerico e nessun predecessore:

indexes:
- kind: Task
  properties:
  - name: done
    direction: asc
  - name: priority
    direction: asc

Considera un indice composto che utilizza le proprietà done e priority (entrambe in ordine crescente):

La dimensione totale della voce di indice in questo indice è di 70 byte:

  • 29 per la chiave
  • 1 per il valore booleano della proprietà done
  • 8 per il valore intero della proprietà priority
  • 32 per una voce di indice

Se non vuoi che Firestore in modalità Datastore mantenga un indice per una proprietà, escludi la proprietà dagli indici. Tieni presente che l'esclusione di una proprietà la rimuove da tutti gli indici composti.

Passaggi successivi