Per eseguire la migrazione dei dati da un database Firestore Standard a un database Firestore Enterprise, ti consigliamo di utilizzare una delle seguenti opzioni:
Le funzionalità di importazione ed esportazione. I file di dati di un'operazione di importazione sono compatibili sia con la versione Enterprise sia con la versione Standard.
Il modello Dataflow
firestore-to-firestore. Il servizio Dataflow ti consente di creare pipeline di dati e il modellofirestore-to-firestorecrea una pipeline batch tra i database Cloud Firestore.
L'importazione e l'esportazione sono l'opzione più semplice da eseguire con meno opzioni di configurazione.
Il modello Dataflow è più personalizzabile. Puoi estendere il codice del template per eseguire migrazioni parziali o trasformare i dati. Puoi anche controllare il numero e le dimensioni dei worker.
Entrambe le opzioni supportano le migrazioni tra progetti e regioni.
Esegui la migrazione dei dati con l'esportazione e l'importazione
Per eseguire la migrazione dei dati con operazioni di esportazione e importazione, consulta Esporta e importa dati. Per spostare i dati in un database in un altro progetto, consulta Sposta i dati tra i progetti.
Esegui la migrazione dei dati con il modello Dataflow
Segui queste istruzioni per eseguire la migrazione dei dati con il template firestore-to-firestore Dataflow.
Prima di iniziare
Prima di avviare la migrazione dei dati, assicurati che il recupero point-in-time (PITR) sia abilitato nel database di origine. Il job Dataflow utilizza il PITR per leggere i dati in un timestamp PITR. Se il PITR è disattivato, il job non va a buon fine se viene eseguito per più di un'ora.
Per utilizzare questo template, l'API
datastore.googleapis.comdeve essere abilitata.Assegna i ruoli richiesti descritti nella sezione successiva.
Ruoli obbligatori
Per eseguire la migrazione dei dati da un database a un altro, assegna i seguenti ruoli. Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti:
- Per ottenere le autorizzazioni necessarie per creare un nuovo database e accedere ai dati di Cloud Firestore, chiedi all'amministratore di concederti il ruolo Cloud Datastore Owner (
roles/datastore.owner) Identity and Access Management (IAM) sul tuo progetto. -
Per concedere al job Dataflow l'accesso in lettura e scrittura ai tuoi database Cloud Firestore, assegna al service account worker Dataflow (ad esempio
PROJECT_NUMBER-compute@) il ruolo IAM Utente Cloud Datastore (roles/datastore.user) nel tuo progetto.Per saperne di più sulla sicurezza di Dataflow, consulta Sicurezza e autorizzazioni di Dataflow.
Per saperne di più sulla concessione dei ruoli IAM, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
1. Crea un nuovo database Firestore Enterprise
Per eseguire la migrazione dei dati da un database Standard Edition a un database Enterprise Edition, devi prima creare il database di destinazione Enterprise Edition. Consulta Crea un database.
2. Esegui il template Dataflow firestore-to-firestore
Configura ed esegui il job Dataflow con il template firestore-to-firestore.
I modelli supportano la migrazione dell'intero database o solo di gruppi di raccolte specifici.
Limitazioni
Tieni presente le seguenti limitazioni per il modello firestore-to-firestore
Dataflow:
- Il database di origine deve essere un database della versione Standard.
- La migrazione legge i dati in un momento di lettura specifico. Ti consigliamo di abilitare il recupero point-in-time (PITR) nel database di origine. Se il PITR non è abilitato, i dati scadono dopo un'ora e questo potrebbe non essere un tempo sufficiente per completare la migrazione dei dati. Il PITR estende la conservazione dei dati a sette giorni.
- La migrazione degli indici non viene eseguita.
Il job Dataflow non esegue la migrazione delle configurazioni del database, come le policy di durata (TTL), i backup, il PITR e le chiavi di crittografia gestite dal cliente (CMEK).
Devi configurare queste impostazioni sul nuovo database. Per migliorare la velocità della migrazione dei dati, attendi il completamento della migrazione prima di configurare TTL, backup e PITR sul database di destinazione.
Gli esempi seguenti mostrano come eseguire il template utilizzando Google Cloud CLI.
Esegui la migrazione di tutti i dati
Per eseguire la migrazione di tutti i dati, utilizza il seguente comando:
gcloud dataflow flex-template run "JOB_NAME" \ --project "PROJECT" \ --template-file-gcs-location gs://dataflow-templates-REGION_NAME/VERSION/flex/Cloud_Firestore_to_Firestore \ --region REGION_NAME \ --parameters "sourceProjectId=SOURCE_PROJECT_ID" \ --parameters "sourceDatabaseId=SOURCE_DATABASE_ID" \ --parameters "destinationProjectId=DESTINATION_PROJECT_ID" \ --parameters "destinationDatabaseId=DESTINATION_DATABASE_ID" \ --parameters "readTime=READ_TIME"
Sostituisci quanto segue:
JOB_NAME: un nome per il job.PROJECT: l'ID del progetto Google Cloud.REGION_NAME: la località Google Cloud in cui vuoi eseguire il job Dataflow. Utilizza una località vicina ai tuoi database.VERSION: la versione del template che vuoi utilizzare. Puoi utilizzare i seguenti valori:latestper utilizzare l'ultima versione del template, disponibile nella cartella padre senza data nel bucket: gs://dataflow-templates-REGION_NAME/latest/- il nome della versione, ad esempio
2023-09-12-00_RC00, per utilizzare una versione specifica del template, che si trova nidificata nella rispettiva cartella padre con data nel bucket: gs://dataflow-templates-REGION_NAME/
SOURCE_PROJECT_ID: l'ID del progetto Google Cloud di origine che contiene il database Firestore Standard Edition.SOURCE_DATABASE_ID: l'ID del database Cloud Firestore di origine.DESTINATION_PROJECT_ID: l'ID del progetto Google Cloud di destinazione per il nuovo database Cloud Firestore.DESTINATION_DATABASE_ID: l'ID del database Cloud Firestore di destinazione.READ_TIME: il timestamp per leggere i dati dal database di origine. Impostato su un timestamp nel formato RFC 3339, con granularità al minuto, ad esempio2026-05-15T16:31:00.00Z.Il timestamp valido più recente dipende dalle impostazioni di recupero point-in-time (PITR). Consulta Recupera l'ora della versione più recente.
Esegui la migrazione dei gruppi di raccolte specificati
Per eseguire la migrazione solo di determinati gruppi di raccolte, utilizza il seguente comando:
gcloud dataflow jobs run "JOB_NAME" \ --project "PROJECT" \ --gcs-location gs://dataflow-templates-REGION_NAME/VERSION/Cloud_Firestore_to_Firestore \ --region REGION_NAME \ --parameters "sourceProjectId=SOURCE_PROJECT_ID" \ --parameters "sourceDatabaseId=SOURCE_DATABASE_ID" \ --parameters "collectionGroupIds=COLLECTION_GROUP_IDS" \ --parameters "destinationProjectId=DESTINATION_PROJECT_ID" \ --parameters "destinationDatabaseId=DESTINATION_DATABASE_ID" \ --parameters "readTime=READ_TIME"
Sostituisci quanto segue:
JOB_NAME: un nome per il job.PROJECT: l'ID del progetto Google Cloud.REGION_NAME: la località Google Cloud in cui vuoi eseguire il job Dataflow. Utilizza una località vicina ai tuoi database.VERSION: la versione del template che vuoi utilizzare. Puoi utilizzare i seguenti valori:latestper utilizzare l'ultima versione del template, disponibile nella cartella padre senza data nel bucket: gs://dataflow-templates-REGION_NAME/latest/- il nome della versione, ad esempio
2023-09-12-00_RC00, per utilizzare una versione specifica del template, che si trova nidificata nella rispettiva cartella padre con data nel bucket: gs://dataflow-templates-REGION_NAME/
SOURCE_PROJECT_ID: l'ID del progetto Google Cloud di origine che contiene il database Firestore Standard Edition.SOURCE_DATABASE_ID: l'ID del database Cloud Firestore di origine.COLLECTION_GROUP_IDS: un elenco separato da virgole di ID dei gruppi di raccolte di cui eseguire la migrazione.Le sottoraccolte non vengono incluse in modo ricorsivo. Ad esempio, se specifichi il gruppo di raccolte
users, la migrazione non includerà una sottoraccoltamessagesin/users/userid/messages, a meno che non specifichi anche il gruppo di raccoltemessages.DESTINATION_PROJECT_ID: l'ID del progetto Google Cloud di destinazione per il nuovo database Cloud Firestore.DESTINATION_DATABASE_ID: l'ID del database Cloud Firestore di destinazione.READ_TIME: il timestamp per leggere i dati dal database di origine. Imposta un timestamp nel formato RFC 3339, con granularità al minuto, ad esempio2026-05-15T16:31:00.00Z.Il timestamp valido più recente dipende dalle impostazioni di recupero point-in-time (PITR). Consulta Recupera l'ora della versione più recente.
3. Configura il database
Il job firestore-to-firestore esegue la migrazione solo dei dati.
Gli indici e le altre impostazioni del database non vengono migrati. Oltre alla migrazione dei dati, valuta la possibilità di configurare quanto segue sul nuovo database:
Indici: i database Firestore Enterprise Edition non richiedono necessariamente indici per eseguire query e non creano indici automatici per impostazione predefinita. Consulta le seguenti sezioni per creare indici per le tue query:
- Panoramica degli indici di Firestore Enterprise.
- Ottimizza le prestazioni delle query con gli indici.
- Puoi utilizzare l'interfaccia a riga di comando Firebase per esportare gli indici ed eseguirne il deployment nel nuovo database.
- Utilizza Query Insights per identificare le query che puoi ottimizzare con un indice.
TTL: Crea policy TTL.
Backup: configura i backup.
PITR: Abilita PITR.
Dopo aver configurato il database, puoi continuare a testare l'app con il nuovo database. Per una migrazione completa, aggiorna le tue applicazioni in modo che utilizzino il nuovo database.
Risoluzione dei problemi
Per i database di grandi dimensioni, il job potrebbe non riuscire se legge troppi dati contemporaneamente. Per risolvere questo problema:
Aumenta il valore di
maxNumWorkers.
Passaggi successivi
- Scopri di più sull'esecuzione di query sui dati con le operazioni della pipeline.
- Scopri come ottimizzare le query nella versione Firestore Enterprise
- Scopri come scala un database Enterprise edition.