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

Você pode exportar os dados da instância do Looker (Google Cloud Core), que inclui conteúdo criado e dados internos sobre a instância do Looker (Google Cloud Core), e, em seguida, 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 um projeto diferente.
  • Você quer migrar para uma instância do Looker (Google Cloud Core) em uma região diferente.

Papel necessário

Para ter as permissões necessárias para importar ou exportar dados de instâncias 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 a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

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

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

As seções a seguir explicam como exportar os dados de instância.

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 com os dados que você quer exportar.

  4. Clique em Exportar.

  5. No campo Export 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.

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

As seções a seguir explicam como importar os dados da instância.

Permissões necessárias para importar de um bucket do Cloud Storage

  • Uma conta de serviço do Looker. Se você usou a CLI do Google Cloud, o Terraform ou a API para criar sua instância do Looker (núcleo do Google Cloud) 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, que 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.

    Acesse as instâncias do Looker

  2. Na lista suspensa Selecionar organização, na parte de cima da página, selecione o recurso da organização que inclui a instância do Looker (núcleo do Google Cloud) para importar 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), que não está associado 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

Após uma importação, os usuários do Looker (Google Cloud Core) podem receber uma solicitação para fazer a autenticação novamente em qualquer conexão de banco de dados do BigQuery ou do Snowflake que usa o OAuth para autenticação de usuário individual. Isso ocorre porque uma exportação do Looker (Google Cloud Core) pode não reter os tokens de acesso ao OAuth ou atualizar os tokens de conexões de banco de dados.

Os usuários podem fazer a autenticação novamente nos bancos de dados com um dos seguintes métodos:

  • Siga o prompt Login que aparece ao acessar uma Análise ou um painel que usa uma conexão de banco de dados OAuth individual.
  • Acesse a página Conta e selecione Fazer login para cada um dos bancos de dados no cabeçalho Credenciais de conexão do OAuth.

Qualquer programação ou alerta automático de um único usuário que faz referência a uma conexão OAuth pode ser interrompido até que o usuário faça login com as credenciais OAuth.

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 podem causar a falha de um processo de exportação ou importação.

Erros durante a exportação

Erros de importação

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

  • 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) para a 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 menor do que a versão do Looker dos dados exportados. 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 a partir de uma instância no Looker versão 23.4.X.

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