Amministrazione datastore

Avviso: le funzionalità descritte di seguito sono ritirato. Dovresti utilizza invece il servizio di esportazione e importazione gestita.

Firestore in modalità Datastore supportava in precedenza la possibilità di abilitare Datastore Admin, un modulo facoltativo con eliminazione e backup in blocco le funzionalità di machine learning. Datastore Admin è stato sostituito da alternative più affidabili:

• La funzionalità di backup è stata sostituita da esportazioni e importazioni gestite.
• La funzionalità di eliminazione collettiva è stata sostituita dalla Modello Eliminazione collettiva delle entità per Dataflow.

Accesso ad Amministrazione Datastore

Se in precedenza hai abilitato Amministrazione Datastore, puoi continuare ad accedere Visita il modulo https://ah-builtin-python-bundle-dot-PROJECT_ID.appspot.com/_ah/datastore_admin?app_id=PROJECT_ID, dove PROJECT_ID è l'ID del tuo progetto Google Cloud. Se disabiliti Amministrazione Datastore, non potrai riattivare il modulo.

Avvertenze sull'utilizzo delle funzionalità di amministrazione di Datastore

• Per la copia, l'eliminazione e i backup, gli aggiornamenti recenti potrebbero non essere presi in considerazione.
• Tutte le operazioni di Datastore Admin vengono eseguite all'interno dell'applicazione e pertanto vengono conteggiate ai fini della quota.
• Ti consigliamo vivamente di disabilitare le operazioni di scrittura durante un backup o un ripristino.
• Le entità esistenti con le stesse chiavi verranno sovrascritte durante una copia/un ripristino operativa. I duplicati non vengono creati se vengono eseguite operazioni di copia/ripristino più volte. Le operazioni di copia/ripristino non eliminano dati aggiuntivi.
• Se utilizzi una coda non predefinita per il backup/il ripristino, puoi specificare solo ah-builtin-python-bundle in queue.yaml target. Non puoi utilizzare altre destinazioni.

Autorizzazioni di accesso al database

Per impostazione predefinita, Amministrazione Datastore può accedere a un datastore database nello stesso progetto e non richiede Identity and Access Management autorizzazioni per Datastore.

Avviso: un utente con accesso a Datastore Admin può utilizzare le relative funzionalità per modificare i dati di Datastore indipendentemente dalle sue autorizzazioni di gestione di identità e accessi. Per rimuovere Datastore Admin dal progetto, vedi Disattivare l'accesso amministrativo.

Backup dei dati in corso...

Avviso: le funzionalità descritte di seguito sono ritirate. Dovresti utilizza invece il servizio di esportazione e importazione gestita.

Segui questi passaggi per creare un file di backup per futuri ripristini dei dati o per esportando.

1. Se non l'hai ancora fatto, crea un bucket di archiviazione per il tuo progetto. Facoltativamente, verifica che l'account di servizio predefinito di App Engine per il progetto ha accesso al bucket tramite Elenco di controllo dell'accesso. Questa opzione potrebbe essere già impostata per impostazione predefinita e, se necessario, può essere ignorata.

   Nota: le operazioni di backup, ripristino, copia ed eliminazione vengono eseguite all'interno dell'applicazione e quindi verranno conteggiate ai fini della quota.

2. (Consigliato) Disabilita le scritture di Cloud Datastore.

3. Apri Amministrazione Datastore

4. Seleziona i tipi di entità di cui vuoi eseguire il backup.

5. Fai clic su Entità di backup per visualizzare il modulo di backup.

6. Nota che viene fornito un nome di backup e che include un'indicazione della data.

   Devi modificare questo valore se esegui più di un backup al giorno perché il backup non viene eseguito se esiste già un backup con lo stesso nome.

7. Nota che per il job di backup viene utilizzata la coda predefinita; puoi usare questo nella maggior parte dei casi.

   Se utilizzi una coda non predefinita per il backup/il ripristino, puoi specificare solo ah-builtin-python-bundle in queue.yaml target. Non puoi utilizzare nessun altro target.

8. Seleziona Google Cloud Storage come posizione di archiviazione di backup.

9. Quando scegli Cloud Storage, ti viene richiesto il nome del bucket in cui archiviare i backup, nel formato [BUCKET_NAME]. Puoi facoltativamente specificare il nome del bucket con una struttura di directory come come [BUCKET_NAME]/backups/foo): se non sono già presenti esistenti, verranno creati.

   Nota: in alternativa, puoi aggiungere /gs/ al nome del bucket, ad esempio /gs/[BUCKET_NAME]

10. Avvia i job di backup facendo clic su Entità di backup. Nota che un job viene visualizzata la pagina dello stato.

11. Fai clic su Torna ad Amministrazione Datastore per visualizzare lo stato del backup.

12. Al termine del backup, se hai disabilitato Cloud Datastore scrivi, riattivale.

Considerazioni su backup e ripristino

La funzionalità di backup e ripristino ha lo scopo di aiutarti a ripristinare i dati in caso di errore eliminazioni di dati o per permetterti di esportare i dati. Puoi eseguire il backup di tutte le entità solo i tipi di entità selezionati e il ripristino da uno di questi i backup quando necessario.

I backup vengono salvati in Cloud Storage.

Tieni presente che il backup non contiene indici. Quando ripristini, gli indici obbligatori vengono ricreati automaticamente utilizzando le definizioni di indice caricati con la tua applicazione.

Puoi anche utilizzare i file di backup per esportare i dati in altri servizi Google Cloud come BigQuery.

I ripristini non assegnano nuovi ID alle entità. I ripristini utilizzano gli ID esistenti al momento del backup e sovrascrivono qualsiasi entità esistente con lo stesso ID. Durante un ripristino, gli ID vengono riservati durante il ripristino delle entità. Questa operazione dovrebbe evita collisioni tra ID con nuove entità se le scritture sono abilitate mentre è in corso un ripristino in esecuzione. Le nuove entità aggiunte dopo il backup vengono conservate.

Puoi ripristinare tutti i dati da un backup oppure puoi ripristinare tipi di entità specifici dal backup. Inoltre, puoi utilizzare questa funzionalità anche per ripristinare un backup degli dati di un'applicazione in un'altra applicazione, a condizione che tu utilizzi Cloud Storage per i backup.

Nota: il processo di backup non include i valori archiviati nel Blobstore o di archiviazione ideale in Cloud Storage. Inoltre, Cloud Datastore BlobInfo registra che che corrispondono ai valori dell'archivio BLOB non sono inclusi nel backup. Viene eseguito il backup delle proprietà dell'entità Cloud Datastore del tipo BlobKey, anche se si basano sui valori del Blobstore corrispondenti chiavi originali. I valori delle proprietà Cloud Datastore di tipo Blob sono non correlati al BLOB e sono inclusi nel backup.

Interruzione di un backup

Se i job di backup sono attualmente in esecuzione, vengono visualizzati nell'elenco Backup in attesa nella schermata Amministrazione di Cloud Datastore.

Per interrompere questi backup in esecuzione:

1. Apri Amministrazione Datastore
2. Nella sezione Backup in attesa, seleziona il backup nell'elenco e fai clic su Interrompi.

Quando interrompi un job di backup, App Engine tenta di eliminare i dati di backup salvato fino a quel momento. Tuttavia, in alcuni casi, alcuni file possono rimanere dopo l'interruzione. Puoi individuare questi file nella posizione che hai scelto per i backup. in Google Cloud Storage, per poi eliminarle in modo sicuro al termine dell'interruzione. La I nomi di questi file iniziano con il seguente pattern: datastore_backup_[BUCKET_NAME].

Nota: se interrompi o elimini un backup, App Engine non elimina i file da Google Cloud Storage. Devi eliminare manualmente i file di backup da Google Cloud Spazio di archiviazione.

Trovare informazioni su un backup

Potresti voler trovare informazioni dettagliate su un backup, ad esempio quali tipi di entità contiene, dove è stato salvato in Google Cloud Storage, i suoi dati di partenza ora di fine. Per visualizzare le informazioni di backup:

1. Apri Amministrazione Datastore
2. Seleziona uno o più backup nell'elenco Backup o Backup in attesa.
3. Fai clic su Informazioni per visualizzare le informazioni relative ai backup.
4. Fai clic su Indietro per tornare alla schermata principale Amministrazione di Cloud Datastore.

Ripristino dei dati

Per eseguire il ripristino da un backup:

1. (Consigliato) Disabilita le scritture di Cloud Datastore per i tuoi un'applicazione. Di solito è una buona idea eseguire questa operazione per evitare conflitti tra il ripristino ed eventuali nuovi dati scritti in Cloud Datastore.
2. Apri Amministrazione Datastore
3. Nell'elenco dei backup disponibili, seleziona il backup da cui vuoi eseguire il ripristino.
4. Fai clic su Ripristina.
5. Nella pagina di avviso visualizzata, nota l'elenco di entità con caselle di controllo. Per impostazione predefinita, tutte le entità verranno ripristinate. Deseleziona le casella di controllo accanto a ogni entità che non vuoi ripristinare.
6. Sempre nella pagina delle avvertenze, puoi notare che la coda predefinita, con i suoi impostazioni delle prestazioni preconfigurate, sono utilizzate per il job di ripristino. Cambia a un'altra coda configurata in modo diverso a seconda della necessità caratteristiche di prestazioni della coda, assicurando che la coda scelta non abbia qualsiasi target specificato in queue.yaml diverso da ah-builtin-python-bundle.
7. Avvia il ripristino facendo clic su Ripristina. Nota che la pagina Stato job visualizzati.
8. Fai clic su Torna ad Amministrazione Datastore per visualizzare lo stato del ripristino.
9. Al termine del ripristino, se hai disabilitato le scritture, riattivare le scritture di Cloud Datastore per l'applicazione.

Ripristino dei dati in un'altra applicazione

Se esegui il backup dei dati utilizzando Google Cloud Storage, puoi ripristinare i backup in applicazioni diverse da quella utilizzata per crearli.

Per ripristinare i dati di backup da un'applicazione di origine a un'applicazione di destinazione:

1. Crea un criterio IAM (Identity and Access Management) nell'origine del bucket di archiviazione dell'applicazione con la seguente autorizzazione:

   • Entità: [PROJECT_ID]@appspot.gserviceaccount.com
   • Ruoli: Storage Legacy Bucket Reader e Storage Legacy Object Reader

   dove [PROJECT_ID] è l'ID progetto dell'applicazione di destinazione.

2. Crea un nuovo backup nell'applicazione di origine.

   Nota: le autorizzazioni impostate nei passaggi precedenti non sono retroattive in backup esistenti, quindi l'applicazione di destinazione non può accedervi backup precedenti. L'applicazione di destinazione può accedere solo ai backup eseguiti dopo che le sono state concesse le autorizzazioni.

3. (Consigliato) Disabilita le operazioni di scrittura di Cloud Datastore per il target per evitare conflitti tra i dati ripristinati e quelli nuovi in Cloud Datastore.

4. Apri Amministrazione Datastore

5. Nella casella di testo accanto al pulsante Importa informazioni di backup. specifica il bucket dell'applicazione di origine contenente il backup, nel formato /gs/[BUCKET_NAME].
   In alternativa, fornisci l'handle file per un backup specifico: per visualizzare l'handle file di un backup, apri la pagina Amministrazione dell'applicazione di origine, seleziona il backup e fai clic su Informazioni. Dovresti vedere l'handle file accanto all'etichetta Handle.

6. Fai clic su Importa informazioni di backup.
   La pagina di selezione visualizzata mostra i backup disponibili per il bucket specificato, a meno che tu non abbia specificato un backup tramite il relativo handle. Seleziona il tipo backup e fai clic su una delle seguenti opzioni:

   • Aggiungi all'elenco dei backup se vuoi conservare questo backup nell'elenco dei backup disponibili per la tua applicazione.
   • Ripristina da backup se vuoi eseguire il ripristino da questo backup ma non vogliono che il backup venga visualizzato nell'elenco dei backup disponibili per la tua applicazione.

7. Nella pagina di avviso visualizzata, nota l'elenco di entità con caselle di controllo. Per impostazione predefinita, tutte le entità verranno ripristinate. Deseleziona le casella di controllo accanto a ogni entità che non vuoi ripristinare.

8. Sempre nella pagina delle avvertenze, nota che la coda predefinita, con le sue impostazioni del rendimento preconfigurate, viene utilizzata per di ripristinare il job. Sostituiscila con un'altra coda che hai configurato in modo diverso se hai bisogno di caratteristiche di prestazioni della coda diverse.

9. Avvia il ripristino facendo clic su Ripristina. Nota che la pagina Stato job visualizzati.

10. Al termine del ripristino, se hai disabilitato Cloud Datastore scrivi, riattivale.

Visualizzazione dell'utilizzo delle risorse

Backup molto frequenti spesso comportano costi più elevati. Quando esegui un Job Amministratore Cloud Datastore, in realtà stai eseguendo un Job MapReduce. I job MapReduce causano un aumento delle ore di istanza di frontend in alto delle operazioni di archiviazione e dell'utilizzo dello spazio di archiviazione.

Per visualizzare l'utilizzo delle risorse:

1. Visita la pagina di App Engine della console Google Cloud.

   Vai alla pagina App Engine

2. Utilizza i menu a discesa nella parte superiore della pagina per selezionare il servizio default e la versione ah-builtin-python-bundle.

Abilitazione o disabilitazione delle operazioni di scrittura dei database

In genere è una buona idea disabilitare le scritture prima di un ripristino. In questo modo eviterai conflitti tra il ripristino e gli eventuali nuovi dati scritti del database.

La disabilitazione delle scritture impedisce che le entità vengano modificate

• il visualizzatore Datastore.
• che utilizzano l'API Datastore.

di Gemini Advanced.

Nota: l'API Datastore non consente di forzare le scritture durante le scritture sono disabilitate. Tuttavia, le librerie client di App Engine consentono di forzare le scritture anche se le operazioni di scrittura sono disabilitate. Un'applicazione scritta con il client App Engine le librerie possono modificare l'istanza del database mentre le scritture disattivata.

Per attivare o disattivare le operazioni di scrittura:

1. Vai alla pagina Amministrazione.

   Vai alla pagina Amministrazione

2. Fai clic su Attiva operazioni di scrittura per attivarle o su Disattiva operazioni di scrittura per disattivarle. Il testo del pulsante varia a seconda lo stato del progetto.

Visualizzazione dell'utilizzo delle risorse dell'amministratore Datastore

Quando esegui un job Amministrazione Datastore, in realtà esegui un il job MapReduce sottostante. I job MapReduce fanno aumentare le ore di istanza frontend, oltre alle operazioni e all'utilizzo dello spazio di archiviazione.

Per visualizzare l'utilizzo delle risorse:

1. Visita la pagina di App Engine della console Google Cloud.

   Vai alla pagina di App Engine

2. Utilizza i menu a discesa nella parte superiore della pagina per selezionare il servizio default e la versione ah-builtin-python-bundle.

Disabilita l'accesso Amministratore Datastore

1. Esegui questo comando, sostituendo PROJECT_ID con l'ID del tuo progetto Google Cloud:

   curl -X DELETE -H "Authorization: Bearer $(gcloud auth print-access-token)" \
   https://appengine.googleapis.com/v1/apps/PROJECT_ID/services/default/versions/ah-builtin-python-bundle