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
- 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.
- Um bucket do Cloud Storage com a permissão
storage.objects.create
atribuída à conta de serviço do Looker. O papel do IAM de Criador de objetos do Storage (roles/storage.objectCreator
) inclui essa permissão. Portanto, você pode atribuir esse papel à conta de serviço do Looker. - Uma chave de criptografia gerenciada pelo cliente (CMEK, na sigla em inglês). Essa CMEK é específica para o processo de exportação e importação e é diferente de uma CMEK usada para criptografar os dados da instância. A permissão
cloudkms.cryptoKeyVersions.useToEncrypt
da CMEK precisa ser atribuída à conta de serviço do Looker. O papel Criptografador de CryptoKeys do Cloud KMS (roles/cloudkms.cryptoKeyEncrypter
) inclui essa permissão, que pode ser atribuído à conta de serviço do Looker.
Como exportar para um bucket do Cloud Storage
Para exportar seus dados, selecione uma das seguintes opções:
Console
Acesse a página do Looker no console do Google Cloud.
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.
Clique no nome da instância com os dados que você quer exportar.
Clique em Exportar.
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.No campo Selecionar uma chave gerenciada pelo cliente, selecione a CMEK a ser usada para criptografar o artefato de exportação.
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ânciaBUCKET_NAME
: o local do bucket do Cloud Storage em que o artefato de exportação será criadoFOLDER_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
Acesse a página do Looker no console do Google Cloud.
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.
Clique no nome da instância para a qual você quer importar dados.
Clique em IMPORTAR.
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.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ânciaBUCKET_NAME
: o local do bucket do Cloud Storage em que o arquivometadata.json
e outros arquivos estão localizadosFOLDER_NAME
: a pasta em que o arquivometadata.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
Confira se você concedeu a permissão
storage.objects.create
ou o papel do IAM de Criador de objetos do Storage (roles/storage.objectCreator
) 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.useToEncrypt
ou o papel Criptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypter
) para a chave de criptografia gerenciada pelo cliente (CMEK) que você criou.Verifique se o local do Cloud Storage especificado não contém arquivos de uma operação de exportação anterior antes de exportar seus dados. Se houver arquivos pré-existentes, remova-os primeiro.
Não é possível usar um bucket do Cloud Storage com o recurso Pagamentos do solicitante ativado.
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.