Scelta tra la modalità nativa e la modalità Datastore

Quando crei un nuovo database Firestore, puoi configurare l'istanza del database in modo che venga eseguita in modalità Datastore, rendendo il database compatibile con le versioni precedenti di Datastore. Questa pagina ti aiuta a capire la differenza tra le seguenti modalità del database Firestore: modalità Native e modalità Datastore.

Firestore in modalità Native

Firestore è la prossima versione principale di Datastore e un rebranding del prodotto. Combinando le migliori caratteristiche di Datastore e del Database in tempo reale di Firebase, Firestore è un database di documenti NoSQL creato per offrire scalabilità automatica, prestazioni elevate e facilità di sviluppo delle applicazioni.

Firestore introduce le seguenti funzionalità:

  • Un livello di archiviazione a elevata coerenza
  • Un modello di dati a livello di raccolta e documento
  • Aggiornamenti in tempo reale
  • Librerie client web e per dispositivi mobili

Firestore è compatibile con le versioni precedenti di Datastore, ma il nuovo modello dei dati, gli aggiornamenti in tempo reale e le funzionalità delle librerie client web e mobile non lo sono. Per accedere a tutte le funzionalità di Firestore, devi utilizzare Firestore in modalità Native.

Firestore in modalità Datastore

Firestore in modalità Datastore utilizza il comportamento del sistema Datastore, ma accede al livello di archiviazione di Firestore, rimuovendo le seguenti limitazioni di Datastore:

  • Ora tutte le query di Datastore sono fortemente coerenti, a meno che non richieda esplicitamente la coerenza finale.
  • Le query nelle transazioni non devono più essere query antenate.
  • Le transazioni non sono più limitate a 25 gruppi di entità.
  • Le scritture a un gruppo di entità non sono più limitate a 1 al secondo.

La modalità Datastore disattiva le funzionalità di Firestore non compatibili con Datastore:

  • Il progetto accetterà le richieste dell'API Datastore e rifiuterà le richieste dell'API Firestore.
  • Il progetto utilizzerà gli indici Datastore anziché quelli di Firestore.
  • Puoi utilizzare le librerie client di Datastore con questo progetto, ma non le librerie client di Firestore.
  • Le funzionalità in tempo reale di Firestore non saranno disponibili.
  • Nella console Google Cloud, il database utilizzerà il visualizzatore Datastore.

Prezzi e località

I database in modalità nativa e in modalità Datastore utilizzano la stessa struttura di prezzi e sono disponibili nelle stesse località. I prezzi e le località sono descritti in dettaglio nelle seguenti pagine:

Firestore in modalità Native

Firestore in modalità Datastore

Scegli una modalità di database

Quando crei un nuovo database Firestore, devi selezionare una modalità di database. Puoi avere database in modalità Datastore e in modalità nativa nello stesso progetto, ma ogni database sarà di un solo tipo. Ti consigliamo quanto segue quando scegli una modalità di database:

  • Utilizza Firestore in modalità Datastore per i nuovi progetti server.

    Firestore in modalità Datastore ti consente di utilizzare le architetture di server Datastore consolidate rimuovendo al contempo le limitazioni fondamentali di Datastore. La modalità Datastore può scalare automaticamente fino a milioni di scritture al secondo.

  • Utilizza Firestore in modalità Native per le nuove app web e mobile.

    Firestore offre librerie client web e mobile con funzionalità in tempo reale e offline. La modalità nativa può scalare automaticamente fino a milioni di client simultanei.

Confronto delle funzioni

La seguente tabella mette a confronto il comportamento del sistema delle modalità di database:

Firestore in
modalità Native
Firestore in
modalità Datastore
Modello di dati Database di documenti organizzato in documenti e raccolte. Entità organizzate in tipi e gruppi di entità.
Livello di archiviazione Un livello di archiviazione a elevata coerenza. Un livello di archiviazione a elevata coerenza.
Query e transazioni
  • Query altamente coerenti nell'intero database
  • Rimuove le limitazioni di coerenza precedenti di Datastore
  • Query altamente coerenti nell'intero database
  • Le transazioni possono accedere a un numero qualsiasi di gruppi di entità
Supporto dell'API Datastore v1 No, le richieste vengono rifiutate
Supporto dell'API Firestore v1 No, le richieste vengono rifiutate
Aggiornamenti in tempo reale

Supporta la possibilità di ascoltare un documento o un insieme di documenti per gli aggiornamenti in tempo reale.

Durante l'ascolto di un documento o di un insieme di documenti, i tuoi clienti vengono informati di eventuali modifiche ai dati e ricevono l'insieme di dati più recente.

Non supportata
Persistenza dei dati offline Le librerie client web e per dispositivi mobili supportano la persistenza dei dati offline. Non supportata
Librerie client Librerie client di Firestore:
  • Java
  • Python
  • PHP
  • Go
  • Ruby
  • C#
  • Node.js
  • Android
  • iOS+
  • Web
  • C++
  • Unity
Librerie client di Datastore:
  • Java
  • Python
  • PHP
  • Go
  • Ruby
  • C#
  • Node.js
  • C++
Sicurezza
  • Identity and Access Management (IAM) gestisce l'accesso al database
  • Le regole di sicurezza di Firestore supportano l'autenticazione e l'autorizzazione serverless per le librerie client web e mobile
IAM gestisce l'accesso al database
Prestazioni Scala automaticamente a milioni di client simultanei. Scala automaticamente fino a milioni di scritture al secondo.
SLA (accordo sul livello del servizio) Contratto di servizio Firestore Contratto di servizio Firestore
Località

Entrambe le modalità supportano le stesse località. Per un elenco dettagliato delle località, consulta le seguenti pagine:

Prezzi

Entrambe le modalità utilizzano la stessa struttura di prezzi per le operazioni relative a entità e documenti.

Firestore in modalità Datastore non prevede costi per le piccole operazioni.

Entrambe le modalità utilizzano la stessa struttura dei prezzi per i dati archiviati e la larghezza di banda di rete.

Per ulteriori dettagli sui prezzi, consulta le seguenti pagine:

Console Visualizzatore Firestore della console Firebase e della console Google Cloud Datastore Viewer della console Google Cloud
Spazi dei nomi Non supportata Spazi dei nomi supportati
Integrazione della libreria client di App Engine

Non supportato nei runtime Python 2.7 e PHP 5.5 dell'ambiente standard di App Engine

Supportato nell'ambiente standard di App Engine, in tutti gli altri ambienti di runtime

Supportato nell'ambiente flessibile di App Engine, tutti i runtime

Supportato in tutti i runtime

Crea un nuovo database

Puoi creare un nuovo database Firestore in modalità nativa o in modalità Datastore. Questa scelta non dipende dalle modalità dei database esistenti nel progetto.

Per saperne di più, consulta Creare e gestire i database.

Passare dalla modalità Native alla modalità Datastore e viceversa

Se il database è vuoto, puoi passare dalla modalità Native alla modalità Datastore e viceversa.

Modifica il database in modalità Native:

gcloud

Utilizza il comando gcloud firestore databases update per impostare il database in modalità Native.

gcloud firestore databases update --type=firestore-native --database='DATABASE_ID'

Sostituisci DATABASE_ID con l'ID del tuo database.

rest

curl --request PATCH \
--header "Authorization: Bearer "$(gcloud auth print-access-token) \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"type":"FIRESTORE_NATIVE"}' \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=type"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • DATABASE_ID: l'ID database

Modifica il database in modalità Datastore:

gcloud

Utilizza il comando gcloud firestore databases update per impostare il database in modalità Datastore.

 gcloud firestore databases update --type=datastore-mode --database='DATABASE_ID'

Sostituisci DATABASE_ID con l'ID del tuo database.

rest

curl --request PATCH \
--header "Authorization: Bearer "$(gcloud auth print-access-token) \
--header 'Accept: application/json' \
--header 'Content-Type: application/json' \
--data '{"type":"DATASTORE_MODE"}' \
"https://firestore.googleapis.com/v1/projects/PROJECT_ID/databases/DATABASE_ID?updateMask=type"

Sostituisci quanto segue:

  • PROJECT_ID: l'ID progetto
  • DATABASE_ID: l'ID database