Importa o esporta i dati da un'istanza di Looker (Google Cloud core)

Ti consigliamo di esportare i dati dell'istanza di Looker (Google Cloud core), che includono i contenuti creati e i dati interni relativi all'istanza di Looker (Google Cloud core), da un'istanza di Looker (Google Cloud core) e poi importarli in un'altra istanza di Looker (Google Cloud core). Esistono diversi motivi per cui potresti voler esportare e importare i dati:

  • Vuoi eseguire l'upgrade o il downgrade a una versione diversa di Looker (Google Cloud core).
  • Vuoi passare a un'istanza di Looker (Google Cloud core) in un altro progetto.
  • Vuoi passare a un'istanza di Looker (Google Cloud core) in un'altra regione.

Ruolo richiesto

Per ottenere le autorizzazioni necessarie per importare o esportare i dati dell'istanza di Looker (Google Cloud core), chiedi all'amministratore di concederti il ruolo IAM Amministratore Looker (roles/looker.admin) per il progetto in cui è stata creata l'istanza. Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

Potresti anche essere in grado di ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Esportazione dei dati dell'istanza di Looker (Google Cloud core) in un bucket Cloud Storage

Oggetti e autorizzazioni richiesti per l'esportazione in un bucket Cloud Storage

  • Un account di servizio Looker. Se hai utilizzato l'interfaccia a riga di comando di Google Cloud, Terraform o l'API per creare la tua istanza di Looker (Google Cloud core) e non hai ancora creato un account di servizio Looker, dovrai crearne uno.
  • Un bucket Cloud Storage con l'autorizzazione storage.objects.create assegnata all'account di servizio Looker. Il ruolo Creatore oggetti Storage (roles/storage.objectCreator) include questa autorizzazione, quindi puoi assegnare questo ruolo all'account di servizio Looker.
  • Una chiave di crittografia gestita dal cliente (CMEK). Questa CMEK è specifica per il processo di esportazione e importazione ed è diversa da una CMEK utilizzata per la crittografia dei dati dell'istanza. L'autorizzazione CMEK cloudkms.cryptoKeyVersions.useToEncrypt deve essere assegnata all'account di servizio Looker. Il ruolo Autore crittografia CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) include questa autorizzazione, che puoi assegnare in alternativa all'account di servizio Looker.

Esportazione in un bucket Cloud Storage

Per esportare i dati, seleziona una delle seguenti opzioni:

console

  1. Vai alla pagina Looker nella console Google Cloud.

    Vai alle istanze di Looker

  2. Nell'elenco a discesa Seleziona organizzazione nella parte superiore della pagina, scegli la risorsa dell'organizzazione che include l'istanza di Looker (Google Cloud core) di cui vuoi esportare i dati.

  3. Fai clic sul nome dell'istanza per la quale vuoi esportare i dati.

  4. Fai clic su Esporta.

  5. Nel campo Esporta bucket, specifica la località del bucket in cui vuoi creare l'artefatto di esportazione. Puoi inserire il percorso nel campo di immissione come <bucket_name>/<folder_name> oppure sfogliare per selezionare la località appropriata nel bucket.

  6. Nel campo Seleziona una chiave gestita dal cliente, seleziona la CMEK da utilizzare per criptare l'artefatto di esportazione.

  7. Fai clic su ESPORTA.

gcloud

gcloud looker instances export INSTANCE_NAME \
--target-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME' \
--kms-key=KMS_KEY_ID

Sostituisci quanto segue:

  • INSTANCE_NAME: un nome per l'istanza di Looker (Google Cloud core); non è associato all'URL dell'istanza
  • BUCKET_NAME: la località del bucket Cloud Storage in cui vuoi creare l'artefatto di esportazione
  • FOLDER_NAME: la cartella in cui vuoi inserire l'artefatto di esportazione all'interno del bucket Cloud Storage
  • KMS_KEY_ID: il percorso completo all'ID chiave CMEK specifico per l'importazione e l'esportazione

Importazione dei dati da un bucket Cloud Storage a un'istanza di Looker (Google Cloud core)

Autorizzazioni richieste per l'importazione da un bucket Cloud Storage

  • Un account di servizio Looker. Se hai utilizzato Google Cloud CLI, Terraform o l'API per creare l'istanza di Looker (Google Cloud core) e non hai già creato un account di servizio Looker, dovrai crearne uno.
  • Concedi l'autorizzazione storage.objects.get all'account di servizio Looker. Il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer) include questa autorizzazione, che puoi scegliere in alternativa di assegnare il ruolo all'account di servizio Looker.
  • L'autorizzazione cloudkms.cryptoKeyVersions.useToDecrypt deve essere assegnata all'account di servizio Looker. Il ruolo Autore crittografia CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) include questa autorizzazione, che puoi assegnare in alternativa all'account di servizio Looker.

Importazione da un bucket Cloud Storage

Per importare i dati, seleziona una delle seguenti opzioni:

console

  1. Vai alla pagina Looker nella console Google Cloud.

    Vai alle istanze di Looker

  2. Nell'elenco a discesa Seleziona organizzazione nella parte superiore della pagina, scegli la risorsa dell'organizzazione che include l'istanza di Looker (Google Cloud core) in cui vuoi importare i dati.

  3. Fai clic sul nome dell'istanza in cui vuoi importare i dati.

  4. Fai clic su IMPORTA.

  5. Nel campo Importa bucket, inserisci il percorso o vai al percorso Cloud Storage in cui hai esportato i dati. Seleziona la cartella contenente il file metadata.json e altri file.

  6. Fai clic su IMPORTA.

gcloud

gcloud looker instances import INSTANCE_NAME \
--source-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME'

Sostituisci quanto segue:

  • INSTANCE_NAME: un nome per l'istanza di Looker (Google Cloud core); non è associato all'URL dell'istanza
  • BUCKET_NAME: la località del bucket Cloud Storage in cui si trovano il file metadata.json e altri file
  • FOLDER_NAME: la cartella in cui si trovano il file metadata.json e altri file

Risolvere i problemi di esportazione o importazione dei dati di Looker (Google Cloud core)

In questa sezione viene descritto come risolvere le condizioni di errore che potrebbero causare la mancata riuscita del processo di esportazione o importazione.

Errori durante l'esportazione

Errori di importazione

  • Assicurati di aver concesso all'account di servizio Looker l'autorizzazione storage.objects.get o il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer) al bucket Cloud Storage.

  • Assicurati di aver concesso all'account di servizio Looker l'autorizzazione cloudkms.cryptoKeyVersions.useToDecrypt o il ruolo Autore crittografia CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) alla chiave di crittografia gestita dal cliente (CMEK) che hai creato.

  • L'importazione può non riuscire a causa dell'incompatibilità della versione tra l'istanza di destinazione e l'istanza di esportazione, come indicato di seguito:

    • L'istanza di destinazione ha una versione secondaria di Looker inferiore a quella dei dati esportati di Looker. Ad esempio, l'istanza di destinazione è su Looker 23.5.X, ma l'esportazione è stata creata da un'istanza su Looker versione 23.6.X.
    • La versione secondaria dell'istanza che ha creato i dati dell'esportazione si trova dietro la versione di Looker dell'istanza di destinazione da più di una release. Ad esempio, l'istanza di destinazione è su Looker 23.6.X, ma l'esportazione è stata creata da un'istanza su Looker versione 23.4.X.

    In questo caso, esegui l'upgrade dell'istanza di esportazione o di destinazione in modo che entrambe le istanze eseguano la stessa versione di Looker.