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), inclusi i contenuti creati e i 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 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.
  • Vuoi esportare i dati da un'istanza non di produzione all'istanza di produzione.

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

  • Non vengono esportate le impostazioni della Google Cloud console, che devono essere configurate nella Google Cloud console 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 utilizzi OAuth per le singole connessioni al database, dopo l'importazione ogni utente dovrà accedere di nuovo e aggiornare i token per le connessioni al database che utilizzano OAuth.
  • 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, potrebbe essere necessario configurare le connessioni ai servizi esterni in modo diverso.
  • Se sposti un'esportazione da un'istanza in un progetto Google Cloud a un'istanza in un progetto diverso, devi impostare le autorizzazioni IAM nel nuovo progetto per fornire agli utenti l'accesso all'istanza.

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 di Looker (roles/looker.admin) nel progetto in cui è stata creata l'istanza. 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.

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

Le sezioni seguenti spiegano come esportare i dati dell'istanza.

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

Esportazione in un bucket Cloud Storage

Per esportare i dati, seleziona una delle seguenti opzioni:

console

  1. Vai alla pagina di Looker nella console Google Cloud .

    Vai a Istanze di Looker

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

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

  4. Fai clic su Esporta.

  5. Nel campo Bucket di esportazione, specifica la posizione del bucket in cui vuoi creare l'artefatto di esportazione. Puoi inserire il percorso nel campo di input come <bucket_name>/<folder_name> o sfogliare per selezionare la posizione 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 posizione del bucket Cloud Storage in cui vuoi che venga creato 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 dell'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)

Le sezioni seguenti spiegano come importare i dati dell'istanza.

Autorizzazioni richieste per l'importazione da un bucket Cloud Storage

  • Un service account Looker. Se hai utilizzato Google Cloud CLI, Terraform o l'API per creare l'istanza di Looker (Google Cloud core) e non hai ancora creato un account di servizio Looker, dovrai crearne uno.
  • Concedi l'autorizzazione storage.objects.get al account di servizio Looker. Il ruolo IAM Visualizzatore oggetti archiviazione (roles/storage.objectViewer) include questa autorizzazione, quindi puoi assegnare in alternativa questo ruolo al account di servizio Looker.
  • L'autorizzazione cloudkms.cryptoKeyVersions.useToDecrypt deve essere assegnata al account di servizio Looker. Il ruolo Cloud KMS CryptoKey Decrypter (roles/cloudkms.cryptoKeyDecrypter) include questa autorizzazione, quindi puoi assegnare in alternativa questo ruolo al account di servizio Looker.

Importazione da un bucket Cloud Storage

Per importare i dati, seleziona una delle seguenti opzioni:

console

  1. Vai alla pagina di Looker nella console Google Cloud .

    Vai a Istanze di Looker

  2. Nell'elenco a discesa Seleziona organizzazione nella parte superiore della pagina, seleziona 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 Bucket di importazione, inserisci il percorso o cerca la posizione 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 posizione 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

Dopo un'importazione, agli utenti di Looker (Google Cloud core) verrà chiesto di eseguire nuovamente l'autenticazione per qualsiasi connessione al database BigQuery o Snowflake che utilizza OAuth per l'autenticazione dei singoli utenti. Questo perché un'esportazione di Looker (Google Cloud core) non conserva l'accesso OAuth o i token di aggiornamento per le connessioni al database dei singoli utenti.

Gli utenti possono eseguire nuovamente l'autenticazione ai propri database con uno dei seguenti metodi:

  • Segui il prompt Accedi visualizzato quando visualizzi un'esplorazione o una dashboard che utilizza una connessione al database OAuth individuale.
  • Vai alla pagina Account e seleziona Accedi per ciascuno dei database nella sezione Credenziali di connessione OAuth.

Tutte le pianificazioni o gli avvisi automatici di proprietà di un singolo utente che fanno riferimento a una connessione OAuth non funzioneranno finché l'utente non avrà eseguito l'accesso con le proprie credenziali OAuth.

Risoluzione dei problemi relativi all'esportazione o all'importazione dei dati di Looker (Google Cloud core)

Questa sezione descrive come correggere le condizioni di errore che potrebbero causare l'esito negativo di un 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 IAM Visualizzatore oggetti Storage (roles/storage.objectViewer) per il bucket Cloud Storage.

  • Assicurati di aver concesso all'account di servizio Looker l'autorizzazione cloudkms.cryptoKeyVersions.useToDecrypt o il ruolo Autore crittografia/decrittografia 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à di versione tra l'istanza di destinazione e l'istanza di esportazione, come segue:

    • L'istanza di destinazione ha una versione secondaria di Looker inferiore alla versione di Looker dei dati esportati. Ad esempio, l'istanza di destinazione è su Looker 23.5.X, ma l'esportazione è stata creata da un'istanza sulla versione 23.6.X di Looker.
    • La versione secondaria dell'istanza che ha creato i dati di esportazione è precedente alla versione di Looker dell'istanza di destinazione di più di una release. Ad esempio, l'istanza di destinazione è su 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.