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.
  • Você quer exportar dados de uma instância não de produção para a instância de produção.

Papel necessário

Para receber 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ê o papel do IAM de 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.

Como exportar dados de instâncias do Looker (Google Cloud Core) para um bucket do Cloud Storage

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

Objetos e permissões 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 .

    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 (Google Cloud Core) para exportar dados.

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

  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. Você pode inserir o caminho no campo de entrada como <bucket_name>/<folder_name> ou navegar para selecionar o local adequado no bucket.

  6. No campo Selecionar uma chave gerenciada pelo cliente, selecione a CMEK que 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), que não está associado ao URL da instância
  • BUCKET_NAME: o local do bucket do Cloud Storage em que você quer que o artefato de exportação seja 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ífico 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 de 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 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 de leitor de objetos do Storage (roles/storage.objectViewer) inclui essa permissão. Portanto, você pode atribuir esse papel à 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. Portanto, você pode atribuir esse papel à conta de serviço do Looker.

Importação 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 (Google Cloud Core) para importar dados.

  3. Clique no nome da instância para importar dados.

  4. Clique em IMPORTAR.

  5. No campo Import bucket, insira o caminho ou navegue até o local do Cloud Storage para onde você exportou os 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) vão precisar fazer a autenticação novamente em qualquer conexão de banco de dados do BigQuery ou do Snowflake que use o OAuth para autenticação de usuários individuais. Isso ocorre porque uma exportação do Looker (Google Cloud Core) não retém o acesso OAuth nem os tokens de atualização para conexões de banco de dados de usuários individuais.

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

  • Siga a instrução Fazer login que aparece quando eles acessam um painel ou um recurso "Explore" 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 automatizado de um único usuário que faz referência a uma conexão OAuth será interrompido até que o usuário faça login com as credenciais OAuth.

Solução de problemas de 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

  • Verifique se você concedeu à conta de serviço do Looker 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.

  • 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 a partir de 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á atrá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.