Importar ou exportar dados de uma instância do Looker (Google Cloud Core)

Você pode exportar os dados da sua instância do Looker (Google Cloud Core), incluindo conteúdo criado e dados internos sobre sua instância do Looker (Google Cloud Core), de uma instância do Looker (Google Cloud Core) e importar esses dados para outra instância do Looker (Google Cloud Core). Há vários motivos para exportar e importar dados:

  • Você quer fazer upgrade ou downgrade para uma edição diferente do Looker (Google Cloud Core).
  • Você quer migrar para uma instância do Looker (Google Cloud Core) em outro projeto.
  • Você quer migrar para uma instância do Looker (Google Cloud Core) em outra região.

Papel necessário

Para ter as permissões necessárias para importar ou exportar dados da instância do Looker (Google Cloud Core), peça ao administrador para conceder a você Administrador do Looker (roles/looker.admin) no projeto em que a instância foi criada. Para mais informações sobre como conceder papéis, consulte Gerenciar acesso.

Também é possível conseguir as permissões necessárias com papéis personalizados ou outros papéis predefinidos.

Exportar os dados da instância do Looker (Google Cloud Core) para um bucket do Cloud Storage

Permissões e objetos necessários para exportar para um bucket do Cloud Storage

Como exportar para um bucket do Cloud Storage

Para exportar seus dados, selecione uma das seguintes opções:

Console

  1. Acesse a página do Looker no console do Google Cloud.

    Acessar as instâncias do Looker

  2. Na lista suspensa Selecionar organização, na parte de cima da página, escolha o recurso da organização que inclui a instância do Looker (Google Cloud Core) para a qual você quer exportar dados.

  3. Clique no nome da instância para a qual você quer exportar dados.

  4. Clique em Exportar.

  5. No campo Exportar bucket, especifique o local do bucket em que você quer que o artefato de exportação seja criado. É possível inserir o caminho no campo de entrada como <bucket_name>/<folder_name> ou navegar para selecionar o local apropriado no bucket.

  6. No campo Selecionar uma chave gerenciada pelo cliente, selecione a CMEK a ser usada para criptografar o artefato de exportação.

  7. Clique em Exportar.

gcloud

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

Substitua:

  • INSTANCE_NAME: um nome para sua instância do Looker (Google Cloud Core); ela não está associada ao URL da instância
  • BUCKET_NAME: o local do bucket do Cloud Storage em que o artefato de exportação será criado
  • FOLDER_NAME: a pasta em que você quer que o artefato de exportação seja colocado no bucket do Cloud Storage.
  • KMS_KEY_ID: o caminho completo para o ID da chave CMEK específica de importação e exportação.

Importar dados de um bucket do Cloud Storage para uma instância do Looker (Google Cloud Core)

Permissões necessárias para importação de um bucket do Cloud Storage

  • Uma conta de serviço do Looker. Se você usou a Google Cloud CLI, o Terraform ou a API para criar sua instância do Looker (Google Cloud Core) e ainda não criou uma conta de serviço do Looker, crie uma.
  • Conceda a permissão storage.objects.get à conta de serviço do Looker. O papel do IAM Leitor de objetos do Storage (roles/storage.objectViewer) inclui essa permissão, então ele pode ser atribuído à conta de serviço do Looker.
  • A permissão cloudkms.cryptoKeyVersions.useToDecrypt precisa ser atribuída à conta de serviço do Looker. O papel Descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) inclui essa permissão, então ele pode ser atribuído à conta de serviço do Looker.
.

Como importar de um bucket do Cloud Storage

Para importar seus dados, selecione uma das seguintes opções:

Console

  1. Acesse a página do Looker no console do Google Cloud.

    Acessar as instâncias do Looker

  2. Na lista suspensa Selecionar organização, na parte de cima da página, escolha o recurso da organização que inclui a instância do Looker (Google Cloud Core) para onde você quer importar os dados.

  3. Clique no nome da instância para a qual você quer importar dados.

  4. Clique em IMPORTAR.

  5. No campo Importar bucket, digite o caminho ou navegue até o local do Cloud Storage para onde você exportou seus dados. Selecione a pasta que contém o arquivo metadata.json e outros arquivos.

  6. Clique em IMPORTAR.

gcloud

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

Substitua:

  • INSTANCE_NAME: um nome para sua instância do Looker (Google Cloud Core); ela não está associada ao URL da instância
  • BUCKET_NAME: o local do bucket do Cloud Storage em que o arquivo metadata.json e outros arquivos estão localizados
  • FOLDER_NAME: a pasta em que o arquivo metadata.json e outros arquivos estão localizados

Resolver problemas na exportação ou importação de dados do Looker (Google Cloud Core)

Esta seção descreve como corrigir condições de erro que poderiam causar falha no processo de exportação ou importação.

Erros durante a exportação

Erros de importação

  • Confira se você concedeu a permissão storage.objects.get ou o papel do IAM de Leitor de objetos do Storage (roles/storage.objectViewer) ao bucket do Cloud Storage à conta de serviço do Looker.

  • Verifique se você concedeu à conta de serviço do Looker a permissão cloudkms.cryptoKeyVersions.useToDecrypt ou o papel Descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) à chave de criptografia gerenciada pelo cliente (CMEK) que você criou.

  • A importação pode falhar devido à incompatibilidade de versão entre a instância de destino e a instância de exportação, da seguinte maneira:

    • A instância de destino tem uma versão secundária do Looker que é anterior à versão dos dados exportados do Looker. Por exemplo, a instância de destino está no Looker 23.5.X, mas a exportação foi criada com base em uma instância no Looker versão 23.6.X.
    • A versão secundária da instância que criou os dados de exportação está por trás da versão do Looker da instância de destino em mais de uma versão. Por exemplo, a instância de destino está no Looker 23.6.X, mas a exportação foi criada com base em uma instância no Looker versão 23.4.X.

    Nesse caso, faça upgrade da instância de exportação ou de destino para que as duas executem a mesma versão do Looker.