Importação ou exportação única de dados para uma instância do Looker (Google Cloud Core)

Talvez você queira exportar os dados da instância do Looker (Google Cloud Core), que incluem conteúdo criado e dados internos sobre a 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 adicionar configurações que só podem ser ativadas durante a criação da instância, como o Private Service Connect ou a CMEK.
• 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 de não produção para a instância de produção.

Importante: a importação de dados para uma instância do Looker (Google Cloud Core) substitui todos os dados da instância.

Uma exportação única inclui todos os dados, configurações e conteúdo de uma instância, incluindo dados do BigQuery, com as seguintes exceções:

• Os relatórios do Data Studio não são exportados.
• As configurações do Google Cloud console, que precisam ser feitas no Google Cloud console para cada instância, não são exportadas. No entanto, as configurações no painel Admin do Looker no aplicativo Looker (Google Cloud Core) são exportadas.
• Os tokens OAuth armazenados em uma instância não são exportados. Se o OAuth for usado para conexões de banco de dados individuais, após a importação, cada usuário precisará fazer login novamente e atualizar os tokens para todas as conexões de banco de dados que usam o OAuth.
• As chaves de API do aplicativo Looker não são exportadas. Todos os usuários vão perder o acesso a todas as chaves de API atuais, porque elas não farão parte do pacote importado.
• Se você exportar e importar para uma instância do Looker (Google Cloud Core) que usa uma configuração de rede diferente da instância que criou a exportação, talvez seja necessário configurar suas conexões com serviços externos de maneira diferente.
• Se uma exportação de uma instância em um Google Cloud projeto for movida para uma instância em um projeto diferente, as permissões do IAM para conceder aos usuários acesso à instância precisarão ser definidas no novo projeto.

Observação: se você quiser exportar de uma instância do Looker (Google Cloud Core) para uma nova instância, o Google recomenda que você conclua e valide a importação para a nova instância antes de excluir a antiga. Isso exige cota adicional enquanto você mantém duas instâncias.

A exportação e importação de dados únicas não estão disponíveis quando um job de exportação programado está em execução. Para saber mais sobre jobs de exportação programados, consulte a página de documentação Criar uma exportação programada para uma instância do Looker (Google Cloud Core).

A importação e exportação do Looker (Google Cloud Core) não oferecem suporte à movimentação de dados de uma instância que não seja compatível com FIPS para uma instância compatível com FIPS.

Funções exigidas

Para conseguir as permissões necessárias para importar ou exportar dados da instância do Looker (Google Cloud Core), peça ao administrador para conceder a você os seguintes papéis e permissões do IAM:

• O papel do IAM de administrador do Looker (roles/looker.admin) no projeto em que a instância foi criada.

• As storage.buckets.getIamPolicy e storage.buckets.setIamPolicy permissões no bucket do Cloud Storage em que a exportação será criada. Os papéis de administrador do Storage (roles/storage.admin) ou proprietário do bucket legado do Storage (roles/storage.legacyBucketOwner) também contêm essas permissões. Portanto, você pode solicitar que um desses papéis seja concedido.

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 com papéis personalizados ou 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 da instância.

Objetos e permissões necessários para exportar para um bucket do Cloud Storage

A lista a seguir mostra os objetos e permissões necessários para exportar para um bucket do Cloud Storage:

**Observação**: se você estiver exportando dados usando o Google Cloud console, não será necessário conceder as permissões a seguir manualmente. Elas serão concedidas automaticamente.

• Uma conta de serviço do Looker. Se você usou a Google Cloud CLI, o Terraform ou a API para criar a instância do Looker (Google Cloud Core) e ainda não criou uma conta de serviço do Looker, será necessário criar uma.

• Um bucket do Cloud Storage com as seguintes permissões do IAM atribuídas à conta de serviço do Looker:

  • storage.objects.create permissão: o papel do IAM de criador de objetos do Storage (roles/storage.objectCreator) inclui essa permissão. Portanto, você também pode atribuir esse papel à conta de serviço do Looker.
  • storage.buckets.getIamPolicy e storage.buckets.setIamPolicy permissões: os papéis de administrador do Storage (roles/storage.admin) ou proprietário do bucket legado do Storage (roles/storage.legacyBucketOwner) também contêm essas permissões. Portanto, você pode solicitar que um desses papéis seja concedido.

• 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 de criptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) inclui essa permissão. Portanto, você também pode atribuir esse papel à conta de serviço do Looker.

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 Google Cloud console.

   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 a qual você quer exportar dados.

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

4. Clique em Exportar.

5. Expanda a guia Exportação única.

6. No campo Bucket de exportação, 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 procurar para selecionar o local apropriado no bucket.

7. No campo Selecionar uma chave do Cloud KMS, selecione a CMEK a ser usada para criptografar o artefato de exportação.

8. 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). Ele 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ífica de importação e exportação

Atenção: sua instância ficará indisponível durante o processo de exportação. O processo de exportação leva de minutos a horas, dependendo do tamanho da instância.

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

A lista a seguir mostra as permissões necessárias para importar de um bucket do Cloud Storage:

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

• Uma conta de serviço do Looker. Se você usou a Google Cloud CLI, o Terraform ou a API para criar a instância do Looker (Google Cloud Core) e ainda não criou uma conta de serviço do Looker, será necessário criar uma.

• Conceda à conta de serviço do Looker as seguintes permissões do IAM no bucket do Cloud Storage em que a exportação está localizada:

  • storage.objects.get — O papel do IAM de visualizador de objetos do Storage (roles/storage.objectViewer) inclui essa permissão. Portanto, você também pode atribuir esse papel à conta de serviço do Looker.
  • storage.buckets.getIamPolicy e storage.buckets.setIamPolicy permissões: os papéis de administrador do Storage (roles/storage.admin) ou proprietário do bucket legado do Storage (roles/storage.legacyBucketOwner) também contêm essas permissões. Portanto, você pode solicitar que um desses papéis seja concedido.

• A permissão cloudkms.cryptoKeyVersions.useToDecrypt precisa ser atribuída à conta de serviço do Looker. O papel de descriptografador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) inclui essa permissão. Portanto, você também pode atribuir esse papel à conta de serviço do Looker.

Observação: Se você criou a instância do Looker (Google Cloud Core) usando uma CMEK, a operação de importação precisará ter acesso a essa CMEK e à versão da chave. Ao migrar entre duas Google Cloud regiões diferentes, o processo de importação pode precisar acessar uma CMEK em um servidor KMS em uma região diferente da região de destino. Se a região que hospeda o servidor KMS estiver indisponível, por exemplo, em caso de desastre natural, o processo de importação vai falhar.

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 Google Cloud console.

   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) em que você quer importar dados.

3. Clique no nome da instância em que você quer importar dados.

4. Clique em IMPORT.

5. No campo Bucket de importação, insira o caminho ou navegue até o local do Cloud Storage em que você exportou os dados. Selecione a pasta que contém o arquivo metadata.json e outros arquivos.

6. Clique em IMPORT.

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). Ele 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 receber uma solicitação para fazer a reautenticação em todas as conexões de banco de dados do BigQuery ou do Snowflake que usam 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 atualiza os tokens 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 solicitação Fazer login que aparece quando eles visualizam um Explore 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 OAuth.

Todas as programações ou alertas automatizados que pertencem a um único usuário e que referenciam uma conexão OAuth serão interrompidos até que o usuário faça login com as credenciais do OAuth.

Observação: se, ao tentar importar dados da instância para uma nova instância, a importação falhar, a instância será redefinida para um estado ATIVO, em vez de permanecer em um estado IMPORTANDO ou ERRO. Isso permite que a instância ainda seja acessada e, por exemplo, excluída, se necessário.

Resolver 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 falha em um processo de exportação ou importação.

Erros durante a exportação

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

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

• Verifique se o local do Cloud Storage fornecido não tem arquivos de uma operação de exportação anterior antes de exportar os dados. Se houver arquivos preexistentes, remova-os primeiro.

• Não é possível usar um bucket do Cloud Storage que tenha os pagamentos do solicitante ativados.

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 visualizador 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 de 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 é menor 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 em uma instância na versão 23.6.X do Looker.
  • 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 em uma instância na versão 23.4.X do Looker.

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