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

É possível exportar os dados da sua instância do Looker (Google Cloud Core), que inclui 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 depois 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.

Como 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

Observação: se você estiver exportando dados usando o Console do Google Cloud, não precisará conceder as seguintes permissões manualmente. Elas serão concedidas automaticamente.

• Um bucket do Cloud Storage com a permissão storage.objects.create atribuída à conta de serviço da instância do Looker (Google Cloud Core). O papel de Criador de objetos do Storage (roles/storage.objectCreator) inclui essa permissão. Também é possível atribuir esse papel à conta de serviço da instância do Looker (Google Cloud Core).
• 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 da instância do Looker (Google Cloud Core). O papel Criptografador da CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) inclui essa permissão. Também é possível atribuir esse papel à conta de serviço da instância do Looker (Google Cloud Core).

Como exportar para um bucket do Cloud Storage

Para exportar seus dados:

Console

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

   Acessar instâncias do Looker

2. Na lista suspensa Selecionar organização, na parte superior da página, selecione o recurso da organização que inclui a instância do Looker (Google Cloud Core) de que 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. Insira o caminho no campo de entrada como <bucket_name>/<folder_name> ou procure para selecionar o local apropriado 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 LOOKER_INSTANCE_NAME \
--target-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME' \
--kms-key=KMS_KEY_ID

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

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

Observação: se você estiver importando dados usando o Console do Google Cloud, não será necessário conceder as seguintes permissões manualmente. Elas serão concedidas automaticamente.

• Conceda a permissão storage.objects.get à conta de serviço da instância do Looker (Google Cloud Core). O papel de Leitor de objetos do Storage (roles/storage.objectViewer) inclui essa permissão. Portanto, é possível atribuir esse papel à conta de serviço do Looker (Google Cloud Core).
• A permissão cloudkms.cryptoKeyVersions.useToDecrypt precisa ser atribuída à conta de serviço da instância do Looker (Google Cloud Core). O papel Descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) inclui essa permissão. Também é possível atribuir esse papel à conta de serviço do Looker (Google Cloud Core).

Observação: se você criou sua instância do Looker (Google Cloud Core) usando uma CMEK, a operação de importação precisa ter acesso a essa CMEK e à versão da chave. Ao migrar entre duas regiões diferentes do Google Cloud, o processo de importação pode precisar acessar uma CMEK em um servidor KMS em uma região diferente da região de destino.

Como importar de um bucket do Cloud Storage

Para importar seus dados:

Console

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

   Acessar instâncias do Looker

2. Na lista suspensa Selecionar organização, na parte superior da página, selecione 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 em que 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 os dados. Selecione a pasta que contém o arquivo metadata.json e outros arquivos.

6. Clique em IMPORTAR.

gcloud

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

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

Nesta seção, descrevemos como corrigir condições de erro que podem causar falha no processo de exportação ou importação.

Erros durante a exportação

• Verifique se você concedeu à conta de serviço do Looker (Google Cloud Core) a permissão storage.objects.create ou o papel Criador de objetos do Storage (roles/storage.objectCreator) para o bucket do Cloud Storage.

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

• Verifique se o local do Cloud Storage fornecido não contém nenhum arquivo de uma operação de exportação anterior antes de exportar os dados. Se houver arquivos pré-existentes, remova-os primeiro.

• Não é possível usar um bucket do Cloud Storage que tenha a opção Pagamentos do solicitante ativada.

Erros de importação

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

• Verifique se você concedeu a conta de serviço do Looker (Google Cloud Core) a permissão cloudkms.cryptoKeyVersions.useToDecrypt ou o papel Descriptografador da 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 menor que a versão dos dados exportados. Por exemplo, a instância de destino está no Looker 23.5.X, mas a exportação foi criada 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 de 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 ambas executem a mesma versão do Looker.