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

Potresti voler esportare i dati dell'istanza di Looker (Google Cloud Core), che include contenuti creati e dati interni, sull'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 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 progetto diverso.
  • Vuoi passare a un'istanza di Looker (Google Cloud core) in un'altra area geografica.

Esportazione dei dati delle istanze Looker (Google Cloud core) in un bucket Cloud Storage

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

  • Un bucket Cloud Storage con l'autorizzazione storage.objects.create assegnata all'account di servizio dell'istanza di Looker (Google Cloud Core). Il ruolo di Storage Object Creator (roles/storage.objectCreator) include questa autorizzazione, quindi puoi assegnare tale ruolo all'account di servizio dell'istanza di Looker (Google Cloud Core).
  • 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 criptare i dati dell'istanza. L'autorizzazione CMEK cloudkms.cryptoKeyVersions.useToEncrypt deve essere assegnata all'account di servizio dell'istanza di Looker (Google Cloud Core). Il ruolo Autore crittografia CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) include questa autorizzazione, quindi puoi assegnare in alternativa quel ruolo all'account di servizio dell'istanza Looker (Google Cloud Core).

Esportazione in un bucket Cloud Storage

Per esportare i dati:

console

  1. Vai alla pagina Looker nella console Google Cloud.

    Vai alle istanze Looker

  2. Nell'elenco a discesa Seleziona organizzazione nella parte superiore della pagina, scegli la risorsa Organizzazione che include l'istanza di Looker (Google Cloud Core) per la quale 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 posizione del bucket in cui vuoi creare l'artefatto di esportazione. Puoi inserire il percorso nel campo di immissione <bucket_name>/<folder_name> e sfogliare o selezionare la località appropriata nel bucket.

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

  7. Fai clic su ESPORTA.

gcloud

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

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

  • Concedi l'autorizzazione storage.objects.get all'account di servizio dell'istanza di Looker (Google Cloud Core). Il ruolo del Visualizzatore oggetti Storage (roles/storage.objectViewer) include questa autorizzazione, quindi puoi assegnare tale ruolo all'account di servizio Looker (Google Cloud Core).
  • L'autorizzazione cloudkms.cryptoKeyVersions.useToDecrypt deve essere assegnata all'account di servizio dell'istanza di Looker (Google Cloud Core). Il ruolo Decriptatore per criptovalute Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) include questa autorizzazione, quindi puoi assegnarlo in alternativa all'account di servizio Looker (Google Cloud Core).

Importazione da un bucket Cloud Storage

Per importare i dati:

console

  1. Vai alla pagina Looker nella console Google Cloud.

    Vai alle istanze Looker

  2. Nell'elenco a discesa Seleziona organizzazione nella parte superiore della pagina, scegli la risorsa 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 alla posizione di 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 LOOKER_INSTANCE_NAME \
--source-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME'

Risoluzione dei problemi di esportazione o importazione dei dati Looker (Google Cloud Core)

Questa sezione descrive come correggere le condizioni di errore che potrebbero impedire l'esecuzione di un processo di esportazione o importazione.

Errori durante l'esportazione

Errori di importazione

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

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

  • L'importazione può avere esito negativo a causa di incompatibilità della versione tra l'istanza di destinazione e l'istanza di esportazione, come descritto di seguito:

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

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