Importe ou exporte dados de uma instância do Looker (Google Cloud core)

Pode exportar os dados da sua instância do Looker (Google Cloud core), que incluem conteúdo criado e dados internos sobre a sua instância do Looker (Google Cloud core), de uma instância do Looker (Google Cloud core) e, em seguida, importar esses dados para outra instância do Looker (Google Cloud core). Existem vários motivos pelos quais pode querer exportar e importar dados:

• Quer atualizar ou alterar para uma edição diferente do Looker (Google Cloud Core).
• Quer mudar para uma instância do Looker (Google Cloud Core) num projeto diferente.
• Quer mudar para uma instância do Looker (Google Cloud Core) numa região diferente.
• Quer exportar dados de uma instância de não produção para a sua instância de produção.

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

• As Google Cloud definições da consola, que têm de ser feitas na Google Cloud consola para cada instância, não são exportadas. No entanto, as definições no painel Administração do Looker na aplicação Looker (essencial para o Google Cloud) são exportadas.
• Os tokens OAuth armazenados numa instância não são exportados. Se usar o OAuth para ligações individuais à base de dados, após a importação, cada utilizador tem de iniciar sessão novamente e atualizar os respetivos tokens para todas as ligações à base de dados que usam o OAuth.
• Se exportar e importar para uma instância do Looker (essencial para o Google Cloud) que usa uma configuração de rede diferente da instância que criou a exportação, pode ter de configurar as suas ligações a serviços externos de forma diferente.
• Se mover uma exportação de uma instância num projeto Google Cloud para uma instância num projeto diferente, tem de definir as autorizações da IAM no novo projeto para conceder aos utilizadores acesso à instância.

Função necessária

Para receber as autorizações de que precisa para importar ou exportar dados da instância do Looker (Google Cloud core), peça ao seu administrador que lhe conceda a função do IAM administrador do Looker (roles/looker.admin) no projeto em que a instância foi criada. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Exportar os dados da sua instância do Looker (Google Cloud core) para um contentor do Cloud Storage

As secções seguintes explicam como exportar os dados da instância.

Objetos e autorizações necessários para exportar para um contentor do Cloud Storage

• Uma conta de serviço do Looker. Se usou a CLI Google Cloud, o Terraform ou a API para criar a sua instância do Looker (essencial para o Google Cloud) e ainda não criou uma conta de serviço do Looker, tem de criar uma.
• Um contentor do Cloud Storage com a autorização storage.objects.create atribuída à conta de serviço do Looker. A função do IAM de criador de objetos de armazenamento (roles/storage.objectCreator) inclui esta autorização, pelo que pode atribuir essa função à conta de serviço do Looker em alternativa.
• Uma chave de encriptação gerida pelo cliente (CMEK). Esta CMEK é específica do processo de exportação e importação e é diferente de uma CMEK usada para encriptar os dados da instância. A autorização cloudkms.cryptoKeyVersions.useToEncrypt da CMEK tem de ser atribuída à conta de serviço do Looker. A função Encriptador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) inclui esta autorização, pelo que, em alternativa, pode atribuir essa função à conta de serviço do Looker.

Exportar para um contentor do Cloud Storage

Para exportar os seus dados, selecione uma das seguintes opções:

gcloud looker instances export INSTANCE_NAME \
--target-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME' \
--kms-key=KMS_KEY_ID

Importar os seus dados de um contentor do Cloud Storage para uma instância do Looker (Google Cloud core)

As secções seguintes explicam como importar os dados da instância.

Autorizações necessárias para a importação a partir de um contentor do Cloud Storage

• Uma conta de serviço do Looker. Se usou a CLI Google Cloud, o Terraform ou a API para criar a sua instância do Looker (essencial para o Google Cloud) e ainda não criou uma conta de serviço do Looker, tem de criar uma.
• Conceda a autorização storage.objects.get à conta de serviço do Looker. A função do IAM Storage Object Viewer (roles/storage.objectViewer) inclui esta autorização, pelo que pode atribuir essa função à conta de serviço do Looker.
• A autorização cloudkms.cryptoKeyVersions.useToDecrypt tem de ser atribuída à conta de serviço do Looker. A função desencriptador de CryptoKey do Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) inclui esta autorização, pelo que pode atribuir essa função à conta de serviço do Looker em alternativa.

Importar a partir de um contentor do Cloud Storage

Para importar os dados, selecione uma das seguintes opções:

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

Após uma importação, os utilizadores do Looker (Google Cloud core) são solicitados a autenticar novamente as ligações à base de dados do BigQuery ou do Snowflake que usam o OAuth para a autenticação de utilizadores individuais. Isto deve-se ao facto de uma exportação do Looker (Google Cloud core) não reter o acesso OAuth nem os tokens de atualização para as ligações à base de dados de utilizadores individuais.

Os utilizadores podem autenticar novamente as respetivas bases de dados com um dos seguintes métodos:

• Siga a mensagem Iniciar sessão apresentada quando visualizam uma exploração ou um painel de controlo que usa uma ligação individual da base de dados OAuth.
• Aceda à página Conta e selecione Iniciar sessão para cada uma das bases de dados no cabeçalho Credenciais de ligação OAuth.

Todos os agendamentos ou alertas automáticos pertencentes a um único utilizador e que referenciem uma ligação OAuth vão deixar de funcionar até que esse utilizador inicie sessão com as respetivas credenciais OAuth.

Resolução de problemas da exportação ou importação de dados do Looker (Google Cloud core)

Esta secção descreve como corrigir condições de erro que podem fazer com que um processo de exportação ou importação falhe.

Erros durante a exportação

• Certifique-se de que concedeu à conta de serviço do Looker a autorização storage.objects.create ou a função do IAM Storage Object Creator (roles/storage.objectCreator) ao contentor do Cloud Storage.

• Certifique-se de que concedeu à conta de serviço do Looker a autorização cloudkms.cryptoKeyVersions.useToEncrypt ou a função encriptador de chaves criptográficas do Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) à chave de encriptação gerida pelo cliente (CMEK) que criou.

• Certifique-se de que a localização do Cloud Storage indicada não tem ficheiros de uma operação de exportação anterior antes de exportar os seus dados. Se existirem ficheiros pré-existentes, remova-os primeiro.

• Não pode usar um contentor do Cloud Storage com a opção Requester Pays ativada.

Erros de importação

• Certifique-se de que concedeu à conta de serviço do Looker a autorização storage.objects.get ou a função do IAM Leitor de objetos de armazenamento (roles/storage.objectViewer) ao contentor do Cloud Storage.

• Certifique-se de que concedeu à conta de serviço do Looker a autorização cloudkms.cryptoKeyVersions.useToDecrypt ou a função desencriptador de chaves criptográficas do Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) à chave de encriptação gerida pelo cliente (CMEK) que criou.

• A importação pode falhar devido à incompatibilidade de versões entre a instância de destino e a instância de exportação, da seguinte forma:

  • A instância de destino tem uma versão secundária do Looker inferior à 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 na versão 23.6.X do Looker.
  • A versão secundária da instância que criou os dados de exportação está mais de uma versão atrás da versão do Looker da instância de destino. 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 na versão 23.4.X do Looker.

  Neste caso, atualize a instância de exportação ou a instância de destino para que ambas as instâncias estejam a executar a mesma versão do Looker.