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 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 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
- 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 (Google Cloud Core) 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, então ele pode ser atribuído à conta de serviço do Looker. - Uma chave de criptografia gerenciada pelo cliente (CMEK). 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 para a qual você quer exportar dados.
Clique em Exportar.
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.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.
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
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 onde você quer importar os 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); ela não está associada 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
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
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 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.