Esportazione e importazione di dati

Esportazione e importazione di dati

Puoi utilizzare il servizio di esportazione e importazione gestito di Firestore ripristinare i dati dopo l'eliminazione accidentale ed esportarli per offline e l'elaborazione dei dati. Puoi esportare tutti i documenti o solo raccolte specifiche. Analogamente, puoi importare tutti i dati da un'esportazione o solo raccolte specifiche. I dati esportati da un database Firestore possono essere importati in un altro database Firestore. Puoi anche caricare Firestore esporta in BigQuery.

Questa pagina descrive come esportare e importare documenti Firestore utilizzando il servizio di esportazione e importazione gestito e Cloud Storage. Il servizio di esportazione e importazione gestito di Firestore è disponibile tramite lo strumento a riga di comando gcloud e l'API Firestore (REST, RPC).

Attenzione: l'esportazione dei dati da Firestore prevede una lettura per ogni documento esportato. Tuttavia, queste letture non verranno visualizzate sull'utilizzo della console. Assicurati di aver compreso questo aspetto prima di configurare le esportazioni ricorrenti per evitare una fattura imprevista.

Prima di iniziare

Prima di poter utilizzare il servizio di esportazione e importazione gestito, devi completare le seguenti attività:

1. Abilita la fatturazione per il tuo progetto Google Cloud. Solo Google Cloud I progetti con fatturazione abilitata possono utilizzare la funzionalità di esportazione e importazione.
   Nota: i progetti Firebase devono trovarsi in Piano Blaze
2. Crea un bucket Cloud Storage per il tuo progetto in una posizione vicina alla località del database Firestore. Non puoi utilizzare un Il richiedente paga il bucket per le operazioni di esportazione e importazione.

3. Assicurati che il tuo account disponga delle autorizzazioni necessarie per Firestore e Cloud Storage. Se sei il proprietario del progetto, il tuo account dispone delle autorizzazioni richieste. In caso contrario, i seguenti ruoli grantano le autorizzazioni necessarie per le operazioni di esportazione e importazione e per l'accesso a Cloud Storage:

   • Ruoli Firestore: Owner, Cloud Datastore Owner o Cloud Datastore Import Export Admin
     Nota: questi ruoli Datastore concedono anche autorizzazioni in Firestore.

   • Ruoli di Cloud Storage: Owner oppure Storage Admin

Autorizzazioni agente di servizio

Le operazioni di esportazione e importazione utilizzano un agente di servizio Firestore autorizzare le operazioni di Cloud Storage. L'agente di servizio Firestore utilizza la seguente convenzione di denominazione:

Agente di servizio Firestore

[e-mail]

Per scoprire di più sugli agenti di servizio, consulta Agenti di servizio.

Nota: in precedenza Firestore utilizzava l'account di servizio predefinito di App Engine anziché l'agente di servizio Firestore. Se il tuo database utilizza ancora l'account di servizio App Engine per importare o esportare i dati, ti consigliamo di eseguire la migrazione all'agente di servizio Firestore specifico del servizio. Puoi visualizzare l'account utilizzato dalle operazioni di importazione ed esportazione nella console Google Cloud.

Se utilizzi i Controlli di servizio VPC, devi utilizzare l'agente di servizio Firestore specifico per il servizio per proteggere completamente le operazioni di importazione ed esportazione. I Controlli di servizio VPC non sono compatibili con il servizio App Engine .

L'agente di servizio Firestore richiede l'accesso al Bucket Cloud Storage utilizzato in un'operazione di esportazione o importazione. Se le tue Il bucket Cloud Storage si trova nello stesso progetto di Firestore , l'agente di servizio Firestore potrà accedere per impostazione predefinita.

Se il bucket Cloud Storage si trova in un altro progetto, devi fornire all'agente di servizio Firestore l'accesso al bucket Cloud Storage.

Assegnare i ruoli all'agente di servizio

Puoi utilizzare lo strumento a riga di comando gsutil per assegnare uno dei ruoli riportati di seguito. Ad esempio, per assegnare il ruolo Amministratore Storage all'agente di servizio Firestore, esegui questo comando:

gsutil iam ch serviceAccount:[e-mail]:roles/storage.admin \
    gs://[BUCKET_NAME]

Sostituisci PROJECT_NUMBER con il numero del progetto, che viene utilizzato per assegnare un nome all'agente di servizio Firestore. Per visualizzare nome dell'agente di servizio, consulta la sezione Visualizzare il nome dell'agente di servizio.

In alternativa, puoi assegnare questo ruolo utilizzando la console Google Cloud.

Visualizza il nome dell'agente di servizio

Puoi visualizzare l'account utilizzato dalle operazioni di importazione ed esportazione per autorizzare le richieste dalla pagina Importa/Esporta nella console Google Cloud. Puoi anche controllare se il tuo database utilizza l'agente di servizio Firestore o l'account di servizio App Engine precedente.

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importa/Esporta.

4. Visualizza l'account di autorizzazione accanto a L'etichetta Job di importazione/esportazione eseguiti come.

L'agente di servizio deve avere il ruolo Storage Admin per Cloud Storage bucket da utilizzare per l'operazione di esportazione o importazione.

Configura gcloud per il progetto

Puoi avviare le operazioni di importazione ed esportazione tramite la console Google Cloud o lo strumento a riga di comando gcloud. Per usare gcloud, configura lo strumento a riga di comando e connettersi al progetto in uno dei seguenti modi:

• Accedi a gcloud dalla console di Google Cloud Platform utilizzando Cloud Shell.

  Avvia Cloud Shell

  Assicurati che gcloud sia configurato per il progetto corretto:

  gcloud config set project [PROJECT_ID]
  

• Installa e inizializza Google Cloud SDK.

Esporta i dati

Un'operazione di esportazione copia i documenti del tuo database in un set di file in un nel bucket Cloud Storage. Tieni presente che un'esportazione non è uno snapshot esatto del database acquisito all'ora di inizio dell'esportazione. Un'esportazione potrebbe includere modifiche apportate durante l'operazione era in esecuzione.

Nota: devi esportare raccolte specifiche se intendi:

• Importare solo raccolte specifiche
• Carica Firestore in BigQuery

Esportazione di tutti i documenti

Google Cloud Console

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importazione/esportazione.

4. Fai clic su Esporta.

5. Fai clic sull'opzione Esporta l'intero database.

6. Sotto Scegli destinazione, inserisci il nome di un bucket Cloud Storage o utilizza il pulsante Sfoglia per selezionarne uno.

7. Fai clic su Esporta.

La console torna alla pagina Importa/Esporta. Se l'operazione si avvia correttamente, la pagina aggiunge una voce alla pagina delle importazioni ed esportazioni recenti. In caso di errore, nella pagina viene visualizzato un messaggio di errore.

gcloud

Utilizza il comando firestore export per esportare tutti documenti nel database, sostituendo [BUCKET_NAME] con il nome del tuo nel bucket Cloud Storage. Aggiungi il flag --async per impedire allo strumento gcloud di in attesa del completamento dell'operazione.

  gcloud firestore export gs://[BUCKET_NAME] \
  --database=[DATABASE]

Sostituisci quanto segue:

• BUCKET_NAME: organizza le esportazioni aggiungendo un prefisso file dopo il nome del bucket, ad esempio BUCKET_NAME/my-exports-folder/export-name. Se non fornisci un prefisso del file, il servizio di esportazione gestita ne crea uno in base al timestamp corrente.

• DATABASE: il nome del database da cui vuoi esportare i documenti. Per il database predefinito, utilizza --database='(default)'.

Una volta avviata un'operazione di esportazione, la chiusura del terminale non annulla l'operazione. Consulta Annullare un'operazione.

Esporta raccolte specifiche

Google Cloud Console

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importazione/esportazione.

4. Fai clic su Esporta.

5. Fai clic sull'opzione Esporta uno o più gruppi di raccolte. Utilizza il menu a discesa per selezionare uno o più gruppi di raccolte.

6. Sotto Scegli destinazione, inserisci il nome di un bucket Cloud Storage o utilizza il pulsante Sfoglia per selezionarne uno.

7. Fai clic su Esporta.

La console torna alla pagina Importa/Esporta. Se l'operazione si avvia correttamente, la pagina aggiunge una voce alla pagina delle importazioni ed esportazioni recenti. In caso di errore, nella pagina viene visualizzato un messaggio di errore.

gcloud

Per esportare gruppi di raccolte specifici, utilizza il flag --collection-ids. L'operazione esporta solo i gruppi di raccolte con gli ID raccolta specificati. Il gruppo di raccolte include tutte le raccolte e le sottoraccolte (in qualsiasi percorso) con l'ID raccolta specificato.

Nota: l'esportazione di una raccolta non verrà eseguita automaticamente. e le sue sottoraccolte. Devi anche specificare le sottocollezioni da esportare.

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1] \
--database=[DATABASE]

Ad esempio, puoi progettare una raccolta restaurants nel database foo in modo da includere più sottoraccolte, ad esempio ratings, reviews o outlets. Per esportare raccolte specifiche restaurants e reviews, il tuo comando ha questo aspetto: che segue:

gcloud firestore export gs://[BUCKET_NAME] \
--collection-ids=restaurants,reviews \
--database='cymbal'

Esporta da un timestamp PITR

Puoi esportare il tuo database in Cloud Storage dai dati PITR utilizzando il comando gcloud firestore export. Puoi esportare i dati PITR in cui il timestamp è un timestamp intero di un minuto negli ultimi sette giorni, ma non prima del giorno earliestVersionTime. Se i dati non esistono più al timestamp specificato, l'operazione di esportazione non va a buon fine.

L'operazione di esportazione PITR supporta tutti i filtri, incluse l'esportazione di tutti i documenti e l'esportazione di raccolte specifiche.

1. Esporta il database, specificando il parametro snapshot-time nel timestamp di recupero desiderato.

   gcloud

   Esegui il comando seguente per esportare il database nel bucket.

   gcloud firestore export gs://[BUCKET_NAME_PATH] \
       --snapshot-time=[PITR_TIMESTAMP] \
       --collection-ids=[COLLECTION_IDS] \
       --namespace-ids=[NAMESPACE_IDS]
   

   Dove,

   • PITR_TIMESTAMP: un timestamp PITR con granularità a livello di minuto, ad esempio 2023-05-26T10:20:00.00Z.

   Tieni presente quanto segue prima di esportare i dati PITR:

   • Specifica il timestamp in RFC 3339 standard. Ad esempio, 2020-09-01T23:59:30.234233Z.
   • Assicurati che il timestamp specificato sia un timestamp di un minuto intero degli ultimi sette giorni, ma non precedente al giorno earliestVersionTime. Se i dati non esistono più al livello viene generato un errore.
   • Non ti viene addebitato alcun costo per un'esportazione PITR non riuscita.

Importa dati

Una volta creati i file di esportazione in Cloud Storage, puoi importare i documenti in di nuovo i file nel tuo progetto o in un altro progetto. Tieni presente quanto segue sulle operazioni di importazione:

• Quando importi dati, gli indici richiesti vengono aggiornati utilizzando le definizioni dell'indice attuali. Un'esportazione non contiene definizioni di indice.

• Le importazioni non assegnano nuovi ID documento. Le importazioni utilizzano gli ID acquisiti in l'ora dell'esportazione. Durante l'importazione di un documento, il relativo ID viene riservato per evitare collisioni tra ID. Se esiste già un documento con lo stesso ID, l'importazione sovrascrive il documento esistente.

• Se un documento nel tuo database non è interessato da un'importazione, rimarrà nel database dopo l'importazione.

• Le operazioni di importazione non attivano le funzioni Cloud Functions. I listener snapshot ricevono aggiornamenti relativi alle operazioni di importazione.

• Il nome del file .overall_export_metadata deve corrispondere a quello del file principale cartella:

  gs://BUCKET_NAME/OPTIONAL_NAMESPACE_PATH/PARENT_FOLDER_NAME/PARENT_FOLDER_NAME.overall_export_metadata

  Se sposti o copi i file di output di un'esportazione, mantieni invariato il nome dei file PARENT_FOLDER_NAME e .overall_export_metadata.

Importare tutti i documenti di un'esportazione

Google Cloud Console

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importazione/esportazione.

4. Fai clic su Importa.

5. Nel campo Nome file, inserisci il nome di un file .overall_export_metadata di un'operazione di esportazione completata. Puoi utilizza il pulsante Sfoglia per selezionare il file.

6. Fai clic su Importa.

La console torna alla pagina Importa/Esporta. Se l'operazione si avvia correttamente, la pagina aggiunge una voce alla pagina delle importazioni ed esportazioni recenti. In caso di errore, nella pagina viene visualizzato un messaggio di errore.

gcloud

Utilizza il comando firestore import per importare documenti da un precedente operazione di esportazione.

gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ --database=[DATABASE]

Sostituisci quanto segue:

• BUCKET_NAME/EXPORT_PREFIX: posizione del tuo esporta i file.

• DATABASE: nome del database. Per il database predefinito, usa --database='(default)'.

Ad esempio:

gcloud firestore import gs://my-bucket/2017-05-25T23:54:39_76544/ --database='cymbal'

Puoi confermare la posizione dei file di esportazione nel Browser Cloud Storage nella console Google Cloud:

Apri il browser Cloud Storage

Una volta avviata un'operazione di importazione, la chiusura del terminale non annulla l'operazione. Consulta Annullare un'operazione.

Importa collezioni specifiche

Nota: per importare raccolte specifiche, devi utilizzare l'output di un'operazione di esportazione in cui hai esportato raccolte specifiche.

Google Cloud Console

Non puoi selezionare raccolte specifiche nella console. Usa invece il criterio gcloud.

gcloud

Per importare gruppi di raccolte specifici da un insieme di file di esportazione, utilizza la --collection-ids. L'operazione importa solo i gruppi di raccolte con gli ID collezione specificati. Il gruppo di raccolte include tutte le raccolte e le sottoraccolte (in qualsiasi percorso) con l'ID raccolta specificato. Specifica il nome del database utilizzando il flag --database. Per il database predefinito, usa --database='(default)'.

Solo un'esportazione di gruppi di raccolte specifici supporta un'importazione di gruppi di raccolte specifici. Non puoi importare raccolte specifiche da un'esportazione di tutti gli elementi documenti.

  gcloud firestore import gs://[BUCKET_NAME]/[EXPORT_PREFIX]/ \
  --collection-ids=[COLLECTION_ID_1],[COLLECTION_ID_2],[SUBCOLLECTION_ID_1] \
  --database=[DATABASE]

Importare un'esportazione PITR

Per importare il database esportato, segui la procedura descritta in Importare tutti i documenti. Se nel database esiste già un documento, verrà sovrascritto.

Gestione delle operazioni di esportazione e importazione

Dopo aver avviato un'operazione di esportazione o importazione, Firestore assegna un nome univoco per l'operazione. Puoi utilizzare il nome dell'operazione per eliminare, annullare l'operazione o controllare lo stato dell'operazione.

I nomi delle operazioni sono preceduti dal prefisso projects/[PROJECT_ID]/databases/(default)/operations/ Ad esempio:

projects/my-project/databases/(default)/operations/ASA1MTAwNDQxNAgadGx1YWZlZAcSeWx0aGdpbi1zYm9qLW5pbWRhEgopEg

Tuttavia, puoi omettere il prefisso quando specifichi un nome dell'operazione per i comandi describe, cancel e delete.

Elenco di tutte le operazioni di esportazione e importazione

Google Cloud Console

Puoi visualizzare un elenco delle operazioni di esportazione e importazione recenti nella pagina Importa/Esporta della console Google Cloud.

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importa/Esporta.

gcloud

Utilizza il comando operations list per vedere tutti i file in esecuzione le operazioni di esportazione e importazione completate di recente:

gcloud firestore operations list

Controllare lo stato dell'operazione

Google Cloud Console

Puoi visualizzare lo stato di un'operazione di esportazione o importazione recente nella pagina Importa/Esporta della console Google Cloud.

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importa/Esporta.

gcloud

Utilizza il comando operations describe per visualizzare lo stato di un'esportazione o un'operazione di importazione.

gcloud firestore operations describe [OPERATION_NAME]

Stima il tempo di completamento

Una richiesta relativa allo stato di un'operazione a lunga esecuzione restituisce le metriche workEstimated e workCompleted. Ognuna di queste metriche viene restituita sia in termini di numero di byte sia in termini di numero di entità:

• workEstimated mostra il numero totale stimato di byte e documenti verrà elaborata. Firestore potrebbe omettere questa metrica se non riesce a fare una stima.

• workCompleted mostra il numero di byte e documenti elaborati finora. Al termine dell'operazione, il valore mostra il numero totale di byte e documenti effettivamente elaborati, che potrebbe essere superiore al valore di workEstimated.

Dividi workCompleted per workEstimated per ottenere una stima approssimativa. Questa stima potrebbe non essere precisa, in quanto dipende dalla raccolta delle statistiche con ritardo.

Annullare un'operazione

Google Cloud Console

Puoi annullare un'operazione di esportazione o importazione in esecuzione nella pagina Importa/Esporta della console Google Cloud.

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importazione/esportazione.

Nella tabella Importazioni ed esportazioni recenti, attualmente in esecuzione le operazioni includono un pulsante Annulla nella colonna Completato. Fai clic sull' Pulsante Annulla per interrompere l'operazione. Il pulsante diventa un messaggio Annullamento e poi Annullato quando l'operazione si interrompe completamente.

gcloud

Utilizza il comando operations cancel per arrestare un'operazione in corso:

gcloud firestore operations cancel [OPERATION_NAME]

L'annullamento di un'operazione in esecuzione non ne annulla l'operazione. Un'operazione di esportazione annullata lascerà i documenti già esportati in Cloud Storage, mentre un'operazione di importazione annullata lascerà invariati gli aggiornamenti già apportati al database. Non puoi importare un'esportazione completata parzialmente.

Elimina un'operazione

Utilizza il comando gcloud firestore operations delete per rimuovere un'operazione dall'elenco delle operazioni recenti. Questo comando non elimina i file di esportazione da Cloud Storage.

gcloud firestore operations delete [OPERATION_NAME]

Fatturazione e prezzi per le operazioni di esportazione e importazione

Devi abilitare la fatturazione per il tuo progetto Google Cloud prima di utilizzarlo il servizio gestito di esportazione e importazione.

Le operazioni di esportazione e importazione vengono addebitate per le operazioni di lettura e scrittura di documenti alle velocità elencate in Prezzi di Firestore. Le operazioni di esportazione comportano un'operazione di lettura per ogni documento esportato. Le operazioni di importazione sono soggette a un'operazione di scrittura per documento importato.

I file di output archiviati in Cloud Storage vengono conteggiati ai fini dei costi di archiviazione dei dati di Cloud Storage.

I costi delle operazioni di esportazione e importazione non vengono conteggiati ai fini della spesa di sicurezza. Le operazioni di esportazione o importazione non attiveranno Avvisi relativi al budget di Google Cloud fino al completamento. Analogamente, le letture e le scritture eseguite durante un'operazione di esportazione o importazione vengono applicate alla tua quota giornaliera al termine dell'operazione. Le operazioni di esportazione e importazione non influiscono sull'utilizzo mostrato nella sezione relativa all'utilizzo della console.

Visualizzare i costi di esportazione e importazione

Le operazioni di esportazione e importazione applicano goog-firestoremanaged:exportimport alle operazioni fatturate. Nella pagina dei report di fatturazione Cloud, puoi utilizzare questa etichetta per visualizzare i costi relativi alle operazioni di importazione ed esportazione:

Nota: alle operazioni di esportazione e importazione eseguite prima dell'8 settembre 2020 non è stata applicata l'etichetta goog-firestoremanaged.

Esporta in BigQuery

Puoi caricare i dati da un'esportazione di Firestore in BigQuery, ma solo se hai specificato un filtro collection-ids. Consulta Caricare i dati dalle esportazioni di Firestore.

Limite di colonne BigQuery

BigQuery impone un limite di 10.000 colonne per tabella. Le operazioni di esportazione di Firestore generano una tabella BigQuery schema per ogni gruppo di raccolte. In questo schema, ogni nome di campo univoco all'interno di un gruppo di raccolte diventa una colonna dello schema.

Se lo schema BigQuery di un gruppo di raccolte supera le 10.000 colonne, l'operazione di esportazione di Firestore tenta di rimanere al di sotto del limite di colonne trattando i campi mappa come byte. Se questa conversione genera numero di colonne inferiore a 10.000, puoi caricare i dati in BigQuery, ma non puoi eseguire query sui campi secondari all'interno dei campi della mappa. Se il numero di colonne è ancora superiore a 10.000, l'operazione di esportazione non generare uno schema BigQuery per il gruppo di raccolte che non puoi caricare i propri dati in BigQuery.

File di formato ed esportazione dei metadati

L'output di un'esportazione gestita utilizza il formato del log LevelDB.

File di metadati

Un'operazione di esportazione crea un file di metadati per ciascun gruppo di raccolte da te specificato. I file di metadati sono in genere denominati ALL_NAMESPACES_KIND_[COLLECTION_GROUP_ID].export_metadata.

I file di metadati sono buffer di protocollo e puoi decodificarli con Compilatore di protocollo protoc. Ad esempio, puoi decodificare un file di metadati per determinare i gruppi di raccolte i file di esportazione contengono:

protoc --decode_raw < export0.export_metadata

Migrazione dell'agente di servizio

Firestore utilizza un agente di servizio Firestore per autorizzare l'importazione le operazioni di esportazione e l'esportazione invece di utilizzare l'account di servizio App Engine. L'agente di servizio e l'account di servizio utilizzano le seguenti convenzioni di denominazione:

Agente di servizio Firestore

[e-mail]

In precedenza, Firestore utilizzava l'account di servizio predefinito di App Engine anziché l'agente di servizio Firestore. Se il tuo database utilizza ancora l'account di servizio App Engine per importare o esportare dati, ti consigliamo di seguire le istruzioni riportate in questa sezione per eseguire la migrazione all'utilizzo dell'agente di servizio Firestore.

Service account App Engine

[e-mail]

È preferibile utilizzare l'agente di servizio Firestore perché è specifico in Firestore. L'account di servizio App Engine è condiviso da più di un servizio.

Nota: se utilizzi Controlli di servizio VPC, devi utilizzare Agente di servizio Firestore per proteggere completamente importazione ed esportazione operazioni aziendali. Controlli di servizio VPC non è compatibile con l'account servizio App Engine.

Visualizza account di autorizzazione

Puoi visualizzare l'account utilizzato dalle operazioni di importazione ed esportazione per autorizzare richieste dalla pagina Importa/Esporta della console Google Cloud. Puoi anche verifica se il tuo database utilizza già Firestore dell'agente di servizio di servizio di Google Cloud.

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importa/Esporta.

4. Visualizza l'account di autorizzazione accanto all'etichetta I job di importazione/esportazione vengono eseguiti come.

Se il tuo progetto non utilizza l'agente di servizio Firestore, puoi eseguire la migrazione all'agente di servizio Firestore utilizzando una di queste tecniche:

• Esegui la migrazione di un progetto controllando e aggiornando le autorizzazioni del bucket Cloud Storage (opzione consigliata).
• Aggiungi un vincolo di criteri a livello di organizzazione che interessa tutti i progetti all'interno di all'interno dell'organizzazione.

La prima di queste tecniche è preferibile perché localizza l'ambito per un singolo progetto Firestore. La seconda tecnica non è è l'opzione preferita perché non esegue la migrazione del bucket Cloud Storage esistente autorizzazioni aggiuntive. Tuttavia, offre conformità alla sicurezza a livello di organizzazione livello.

Eseguire la migrazione controllando e aggiornando le autorizzazioni dei bucket Cloud Storage

La procedura di migrazione prevede due passaggi:

1. Aggiorna le autorizzazioni del bucket Cloud Storage. Consulta la sezione seguente per i dettagli.
2. Conferma la migrazione all'agente di servizio Firestore.

Autorizzazioni bucket dell'agente di servizio

Per qualsiasi operazione di esportazione o importazione che utilizza un bucket Cloud Storage in un altro progetto, devi concedere all'agente di servizio Firestore le autorizzazioni per quel bucket. Ad esempio, le operazioni che spostano i dati in un'altra devono accedere a un bucket in quell'altro progetto. In caso contrario, queste operazioni non andranno a buon fine dopo la migrazione all'agente di servizio Firestore.

I flussi di lavoro di importazione ed esportazione che rimangono all'interno dello stesso progetto non richiedono modifiche alle autorizzazioni. L'agente di servizio Firestore può accedere nello stesso progetto per impostazione predefinita.

Aggiorna le autorizzazioni per i bucket Cloud Storage di altri progetti per dare accesso all'agente di [e-mail]. Concedi all'agente di servizio il ruolo Firestore Service Agent.

Il ruolo Firestore Service Agent concede le autorizzazioni di lettura e scrittura per un nel bucket Cloud Storage. Se devi concedere solo l'autorizzazione di lettura o solo scrittura autorizzazioni, utilizza ruolo personalizzato.

La procedura di migrazione descritta nella sezione seguente ti aiuta a identificare i bucket Cloud Storage che potrebbero richiedere aggiornamenti delle autorizzazioni.

Esegui la migrazione di un progetto all'agente di servizio Firestore

Completa i seguenti passaggi per eseguire la migrazione dall'account di servizio App Engine a l'agente di servizio Firestore. Una volta completata la migrazione, annullata.

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importa/Esporta.

4. Se non è ancora stata eseguita la migrazione del progetto al servizio Firestore , vedrai un banner che descrive la migrazione un pulsante Controlla lo stato del bucket. Il passaggio successivo ti consente di identificare correggere i potenziali errori di autorizzazione.

   Fai clic su Controlla lo stato del bucket.

   Viene visualizzato un menu con l'opzione per completare la migrazione e un dei bucket Cloud Storage. Potrebbero essere necessari alcuni minuti per completare il caricamento dell'elenco.

   Questo elenco include bucket recenti utilizzati nelle operazioni di importazione ed esportazione, ma attualmente non forniscono dati le autorizzazioni di scrittura per l'agente di servizio Firestore.

5. Prendi nota del nome principale dell'agente di servizio Firestore del tuo progetto. Il nome dell'agente di servizio viene visualizzato sotto l'etichetta Agente di servizio a cui concedere l'accesso.

6. Per ogni bucket nell'elenco che dovrai da utilizzare per operazioni di importazione o esportazione future, completa quanto segue passaggi:

   1. Nella riga della tabella di questo bucket, fai clic su Correggi. Si apre la pagina delle autorizzazioni del bucket in una nuova scheda.

   2. Fai clic su Aggiungi.
   3. Nel campo Nuove entità, inserisci il nome delle Agente di servizio Firestore.
   4. Nel campo Seleziona un ruolo, scegli Agenti di servizio > Agente di servizio Firestore.
   5. Fai clic su Salva.
   6. Torna alla scheda con la pagina di importazione/esportazione di Firestore.
   7. Ripeti questi passaggi per gli altri bucket nell'elenco. Assicurati di visualizzare tutte le pagine dell'elenco.

7. Fai clic su Esegui la migrazione all'agente di servizio Firestore. Se hai ancora bucket con controlli delle autorizzazioni non riusciti, confermare la migrazione facendo clic su Migra.

   Un avviso ti informa al completamento della migrazione. La migrazione non può essere annullata.

Visualizzare lo stato della migrazione

Per verificare lo stato della migrazione del progetto:

1. Nella console Google Cloud, vai alla pagina Database.

   Vai a Database

2. Seleziona il database richiesto dall'elenco dei database.

3. Nel menu di navigazione, fai clic su Importa/Esporta.

4. Cerca il principale accanto all'etichetta I job di importazione/esportazione vengono eseguiti come.

   Se l'entità è [e-mail], il progetto è già stato migrato a Firestore dell'agente di servizio di servizio di Google Cloud. La migrazione non può essere annullata.

   Se non è stata eseguita la migrazione del progetto, nella parte superiore della pagina viene visualizzato un banner con il pulsante Verifica stato del bucket. Per completare la migrazione, consulta Eseguire la migrazione all'agente di servizio Firestore.

Aggiungi un vincolo di criteri a livello di organizzazione

• Imposta il seguente vincolo nel criterio della tua organizzazione:

  Richiedi l'agente di servizio Firestore per l'importazione/esportazione (firestore.requireP4SAforImportExport).

  Questo vincolo richiede le operazioni di importazione ed esportazione per utilizzare Agente di servizio Firestore per autorizzare le richieste. Per impostare questo vincolo, consulta Creare e gestire i criteri dell'organizzazione .

L'applicazione di questo vincolo del criterio dell'organizzazione non concede automaticamente la le autorizzazioni appropriate per il bucket Cloud Storage Agente di servizio Firestore.

Se il vincolo crea errori di autorizzazione per qualsiasi flusso di lavoro di importazione o esportazione, puoi disabilitarlo per tornare a usare l'account di servizio predefinito. Dopo aver controllato e aggiornato le autorizzazioni del bucket Cloud Storage, puoi riattivare il vincolo.