Crea un job di esportazione pianificata per un'istanza di Looker (Google Cloud core)

Questa pagina mostra come configurare un job di esportazione pianificato per un'istanza di Looker (Google Cloud core). Le esportazioni pianificate vengono eseguite ogni 24 ore, a partire da un orario di inizio che hai impostato. L'esportazione viene salvata in un bucket Cloud Storage. Le esportazioni pianificate non creano tempi di inattività per l'istanza di Looker (Google Cloud core).

Un'esportazione pianificata include tutti i dati, le configurazioni e i contenuti di un'istanza, con le seguenti eccezioni:

• I dati di BigQuery non vengono esportati.

• I dati di Secret Manager non vengono esportati.

• I report di Looker Studio non vengono esportati.

• Non vengono esportate le impostazioni della console Google Cloud , che devono essere configurate nella console Google Cloud per ogni istanza. Tuttavia, le impostazioni nel pannello Amministrazione di Looker all'interno dell'applicazione Looker (Google Cloud core) vengono esportate.

• I token OAuth memorizzati in un'istanza non vengono esportati. Se OAuth viene utilizzato per le singole connessioni al database, dopo l'importazione ogni utente dovrà accedere di nuovo e aggiornare i propri token per le connessioni al database che utilizzano OAuth.

• Le chiavi API dell'applicazione Looker non vengono esportate. Tutti gli utenti perderanno l'accesso a tutte le chiavi API esistenti, in quanto non faranno parte del pacchetto importato.

• Se esporti e importi in un'istanza di Looker (Google Cloud core) che utilizza una configurazione di rete diversa da quella dell'istanza che ha creato l'esportazione, potresti dover configurare le connessioni ai servizi esterni in modo diverso.

• Se un'esportazione da un'istanza in un progetto Google Cloud viene spostata in un'istanza in un progetto diverso, è necessario impostare le autorizzazioni IAM per fornire agli utenti l'accesso all'istanza nel nuovo progetto.

Il processo di esportazione pianificato richiede da pochi minuti a diverse ore, a seconda delle dimensioni dell'istanza. Durante l'esecuzione di un processo di esportazione programmata, le operazioni di importazione e le esportazioni una tantum non sono disponibili.

Una volta configurato un job di esportazione pianificato, puoi configurare uno script per importare i dati esportati in un'istanza di backup su base giornaliera.

Ruolo richiesto

Per ottenere le autorizzazioni necessarie per creare un job di esportazione pianificato per Looker (Google Cloud core), chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto in cui è stata creata l'istanza:

• Tutti: Amministratore Looker (roles/looker.admin)

Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Prima di iniziare

1. Crea un bucket Cloud Storage per archiviare l'artefatto di esportazione.
2. Crea una chiave di crittografia gestita dal cliente (CMEK) in Cloud Key Management Service. Questo è necessario per criptare i dati per l'esportazione pianificata, anche se l'istanza non utilizza CMEK. La chiave CMEK deve trovarsi in una regione diversa dall'istanza di Looker (Google Cloud core) oppure deve essere una chiave globale.
3. Identifica l'account di servizio per la tua istanza di Looker (Google Cloud core).
4. Concedi i seguenti ruoli e permessi Identity and Access Management (IAM) richiesti al account di servizio dell'istanza:
   • Concedi il roles/storage.objectAdmin ruolo sul bucket Cloud Storage in cui è archiviata l'esportazione.
   • Concedi il ruolo roles/cloudkms.cryptoKeyEncrypterDecrypter alla chiave CMEK che utilizzi per criptare i tuoi dati.
   • In alternativa, puoi creare un ruolo personalizzato con le seguenti autorizzazioni:
     • storage.objects.create
     • storage.objects.delete
     • cloudkms.cryptoKeyVersions.useToEncrypt
     • cloudkms.cryptoKeyVersions.useToDecrypt

Configurare un job di esportazione programmato

Puoi configurare un job di esportazione pianificato utilizzando la console Google Cloud o gcloud.

console

1. Nella console Google Cloud , vai alla pagina Istanze di Looker (Google Cloud core).

   Vai alle istanze di Looker

2. Fai clic sul nome dell'istanza per cui vuoi pianificare un job di esportazione.

3. Fai clic sulla scheda Esporta.

4. Espandi la sezione Pianifica job di esportazione e inserisci le seguenti informazioni:

   1. Ora di inizio: l'ora del giorno in ora locale (HH:MM) in cui eseguire l'esportazione giornaliera.
   2. Bucket Cloud Storage: l'URI del bucket Cloud Storage, ad esempio: gs://bucket-name/export-path.
   3. Chiave Cloud KMS: seleziona la chiave Cloud Key Management Service che verrà utilizzata per criptare i dati dell'istanza.

5. Fai clic su Imposta pianificazione.

gcloud

1. Per configurare un'esportazione periodica, esegui il seguente comando gcloud:

gcloud looker instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --region=REGION \
    --periodic-export-gcs-uri="gs://BUCKET_NAME/EXPORT_PATH" \
    --periodic-export-kms-key="KMS_KEY_NAME" \
    --periodic-export-start-time="TIME"

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza di Looker (Google Cloud core).
• PROJECT_ID: il tuo Google Cloud ID progetto.
• REGION: la regione in cui si trova l'istanza.
• BUCKET_NAME: il nome del tuo bucket Cloud Storage.
• EXPORT_PATH: il percorso all'interno del bucket per l'artefatto di esportazione.
• KMS_KEY_NAME: il nome completo della risorsa della chiave CMEK.
• TIME: l'ora del giorno in UTC (HH:MM) in cui eseguire l'esportazione giornaliera.

Verificare la configurazione dell'esportazione

Dopo aver impostato una pianificazione, puoi visualizzare la configurazione del job di esportazione pianificato nella pagina Dettagli istanza.

1. Nella console Google Cloud , vai alla pagina Istanze di Looker (Google Cloud core).

   Vai alle istanze di Looker

2. Fai clic sul nome dell'istanza.

3. Nella pagina Dettagli istanza, visualizza la configurazione Pianificazione esportazione, che include l'ora di inizio pianificata ogni giorno in ora locale. L'ora di inizio include un link alla pagina Esporta dell'istanza.

Interrompere un'esportazione periodica

Per impedire che si verifichi un'esportazione periodica, cancella i campi di configurazione.

console

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

   Vai alle istanze di Looker

2. Fai clic sul nome dell'istanza.

3. Fai clic sulla scheda Esporta.

4. Nella sezione Imposta pianificazione per l'esportazione periodica, cancella i valori per i campi Bucket Cloud Storage, Chiave di crittografia gestita dal cliente e Ora.

5. Fai clic su Cancella programmazione.

gcloud

1. Per arrestare un'esportazione periodica, esegui il seguente comando gcloud:

gcloud looker instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --region=REGION \
    --clear-periodic-export-config

Sostituisci quanto segue:

• INSTANCE_NAME: il nome dell'istanza di Looker (Google Cloud core).
• PROJECT_ID: il tuo Google Cloud ID progetto.
• REGION: la regione in cui si trova l'istanza.

Passaggi successivi

• Scopri come importare i dati dell'istanza di Looker (Google Cloud core) da Cloud Storage.
• Risolvi i problemi di esportazione o importazione.