Importazione o esportazione una tantum dei dati per un'istanza di Looker (Google Cloud core)

Potresti voler esportare i dati dell'istanza di Looker (Google Cloud core), che includono 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 diversa edizione di Looker (Google Cloud core).
  • Vuoi aggiungere impostazioni che possono essere abilitate solo durante la creazione dell'istanza, come Private Service Connect o CMEK.
  • 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 regione.
  • Vuoi esportare i dati da un'istanza non di produzione all'istanza di produzione.

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

  • I report di Data Studio non vengono esportati.
  • Le impostazioni della Google Cloud console, che devono essere effettuate nella Google Cloud console per ogni istanza, non vengono esportate. Tuttavia, le impostazioni nel pannello Amministrazione di Looker all'interno dell'applicazione Looker (Google Cloud core) vengono esportate.
  • I token OAuth archiviati 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 tutte 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, poiché le chiavi API 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, potrebbe essere necessario configurare le connessioni ai servizi esterni in modo diverso.
  • Se un'esportazione da un'istanza in un Google Cloud progetto viene spostata in un'istanza in un progetto diverso, è necessario impostare le autorizzazioni IAM nel nuovo progetto per fornire agli utenti l'accesso all'istanza.

L'esportazione e l'importazione dei dati una tantum non sono disponibili quando è in esecuzione un job di esportazione pianificato. Per saperne di più sui job di esportazione pianificati, consulta la pagina della documentazione Creare un'esportazione pianificata per un'istanza di Looker (Google Cloud core).

L'importazione e l'esportazione di Looker (Google Cloud core) non supportano lo spostamento dei dati da un'istanza non conforme a FIPS a un'istanza conforme a FIPS.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per importare o esportare i dati dell'istanza di Looker (Google Cloud core), chiedi all'amministratore di concederti i seguenti ruoli e autorizzazioni IAM:

  • Il ruolo IAM Amministratore Looker (roles/looker.admin) sul progetto in cui è stata creata l'istanza.

  • Le storage.buckets.getIamPolicy e storage.buckets.setIamPolicy autorizzazioni sul bucket Cloud Storage in cui verrà creata l'esportazione. I ruoli Storage Admin (roles/storage.admin) o Storage Legacy Bucket Owner (roles/storage.legacyBucketOwner) contengono anche queste autorizzazioni, quindi in alternativa puoi richiedere che ti venga concesso uno di questi ruoli.

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 i ruoli predefiniti.

Esportare i 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

L'elenco seguente mostra gli oggetti e le autorizzazioni richiesti per l'esportazione in un bucket Cloud Storage:

Esportare in un bucket Cloud Storage

Per esportare i dati, seleziona una delle seguenti opzioni:

console

  1. Vai alla pagina Looker nella Google Cloud console.

    Vai alle 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. Espandi la scheda Esportazione una tantum.

  6. Nel campo Bucket di esportazione, 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> o sfogliare per selezionare la località appropriata nel bucket.

  7. Nel campo Seleziona una chiave Cloud KMS, seleziona la CMEK da utilizzare per criptare l'artefatto di esportazione.

  8. 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 dell'ID della chiave CMEK specifica per l'importazione e l'esportazione

Importare i 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

L'elenco seguente mostra le autorizzazioni richieste per l'importazione da un bucket Cloud Storage:

Importare da un bucket Cloud Storage

Per importare i dati, seleziona una delle seguenti opzioni:

console

  1. Vai alla pagina Looker nella Google Cloud console.

    Vai alle 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 IMPORT.

  5. Nel campo Bucket di importazione, inserisci il percorso o sfoglia la località di Cloud Storage in cui hai esportato i dati. Seleziona la cartella contenente il file metadata.json e altri file.

  6. Fai clic su IMPORT.

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

Dopo un'importazione, agli utenti di Looker (Google Cloud core) verrà chiesto di eseguire nuovamente l'autenticazione per tutte le connessioni al database BigQuery o Snowflake che utilizzano 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 visualizzano un'esplorazione o una dashboard che utilizza una connessione al database OAuth individuale.
  • Vai alla pagina Account e seleziona Accedi per ciascuno dei database sotto l'intestazione Credenziali di connessione OAuth.

Tutte le pianificazioni o gli avvisi automatici di proprietà di un singolo utente e che fanno riferimento a una connessione OAuth verranno interrotti finché l'utente non accede con le proprie credenziali OAuth.

Risolvere i 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 il fallimento di un processo di esportazione o importazione.

Errori durante l'esportazione

Errori di importazione

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

  • Assicurati di aver concesso al account di servizio Looker l'autorizzazione cloudkms.cryptoKeyVersions.useToDecrypt o il ruolo Cloud KMS CryptoKey Decrypter (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 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 su Looker versione 23.6.X.
    • 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 su Looker versione 23.4.X.

    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.