Crie uma tarefa de exportação agendada para uma instância do Looker (Google Cloud Core)

Esta página mostra como configurar uma tarefa de exportação agendada para uma instância do Looker (Google Cloud core). As exportações agendadas são executadas a cada 24 horas, começando à hora de início que definir. A exportação é guardada num contentor do Cloud Storage. As exportações agendadas não criam qualquer tempo de inatividade para a instância do Looker (Google Cloud core).

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

  • Os dados do BigQuery não são exportados.

  • Os dados do Secret Manager não são exportados.

  • Os relatórios do Looker Studio não são exportados.

  • 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 o OAuth for usado 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 quaisquer ligações à base de dados que usem o OAuth.

  • As chaves da API da aplicação Looker não são exportadas. Todos os utilizadores vão perder o acesso a todas as chaves da API existentes, uma vez que as chaves da API não fazem parte do pacote importado.

  • Se exportar e importar para uma instância do Looker (essencial para o Google Cloud) que use 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 uma exportação de uma instância num projeto Google Cloud for movida para uma instância num projeto diferente, as autorizações da IAM para conceder aos utilizadores acesso à instância têm de ser definidas no novo projeto.

O processo de exportação agendado demora entre alguns minutos e várias horas, consoante o tamanho da instância. Enquanto um processo de exportação agendado estiver em execução, as operações de importação e as exportações únicas não estão disponíveis.

Depois de configurar uma tarefa de exportação agendada, pode configurar um script para importar os dados exportados para uma instância de cópia de segurança diariamente.

Função necessária

Para receber as autorizações de que precisa para criar uma tarefa de exportação agendada para o Looker (Google Cloud core), peça ao seu administrador que lhe conceda as seguintes funções do IAM no projeto no qual 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.

Antes de começar

  1. Crie um contentor do Cloud Storage para armazenar o artefacto de exportação.
  2. Crie uma chave de encriptação gerida pelo cliente (CMEK) no Cloud Key Management Service. Isto é necessário para encriptar os dados para a exportação agendada, mesmo que a sua instância não use CMEK. A chave CMEK tem de estar numa região diferente da instância do Looker (Google Cloud core) ou tem de ser uma chave global.
  3. Identifique a conta de serviço da sua instância do Looker (essencial para o Google Cloud).
  4. Conceda as seguintes funções e autorizações de gestão de identidade e de acesso (IAM) necessárias à conta de serviço da instância:
    • Conceda a roles/storage.objectAdminfunção no contentor do Cloud Storage que armazena a sua exportação.
    • Conceda a roles/cloudkms.cryptoKeyEncrypterDecrypterfunção na chave CMEK que usa para encriptar os seus dados.
    • Em alternativa, pode criar uma função personalizada com as seguintes autorizações:
      • storage.objects.create
      • storage.objects.delete
      • cloudkms.cryptoKeyVersions.useToEncrypt
      • cloudkms.cryptoKeyVersions.useToDecrypt

Configure uma tarefa de exportação agendada

Pode configurar uma tarefa de exportação agendada através da Google Cloud consolagcloud.

consola

  1. Na Google Cloud consola, aceda à página Instâncias do Looker (Google Cloud core).

    Aceda às instâncias do Looker

  2. Clique no nome da instância para a qual quer agendar uma tarefa de exportação.

  3. Clique no separador Exportar.

  4. Expanda a secção Agendar tarefa de exportação e introduza as seguintes informações:

    1. Hora de início: a hora do dia na hora local (HH:MM) para fazer a exportação diária.
    2. Contentor do Cloud Storage: o URI do seu contentor do Cloud Storage, por exemplo: gs://bucket-name/export-path.
    3. Chave do Cloud KMS: selecione a chave do Cloud Key Management Service que vai ser usada para encriptar os dados da instância.

  5. Clique em Definir programação.

gcloud

  1. Para configurar uma exportação periódica, execute o seguinte comando gcloud:
gcloud looker instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --region=REGION \
    --periodic-export-gcs-uri="gs://BUCKET_NAME/EXPORT_PATH" \
    --periodic-export-kms-key="KMS_KEY_NAME" \
    --periodic-export-start-time="TIME"

Substitua o seguinte:

  • INSTANCE_NAME: o nome da sua instância do Looker (Google Cloud Core).
  • PROJECT_ID: o ID Google Cloud do projeto.
  • REGION: a região onde a sua instância está localizada.
  • BUCKET_NAME: o nome do seu contentor do Cloud Storage.
  • EXPORT_PATH: o caminho no contentor do artefacto de exportação.
  • KMS_KEY_NAME: o nome completo do recurso da sua chave CMEK.
  • TIME: a hora do dia em UTC (HH:MM) para fazer a exportação diária.

Valide a configuração de exportação

Depois de definir uma programação, pode ver a configuração da tarefa de exportação agendada na página Detalhes da instância.

  1. Na Google Cloud consola, aceda à página Instâncias do Looker (Google Cloud core).

    Aceda às instâncias do Looker

  2. Clique no nome da instância.

  3. Na página Detalhes da instância, veja a configuração do Agendamento de exportação, que inclui a hora de início agendada todos os dias na hora local. A hora de início inclui um link para a página Exportar da instância.

Pare uma exportação periódica

Para impedir que uma exportação periódica ocorra, limpe os campos de configuração.

consola

  1. Na Google Cloud consola, aceda à página Instâncias.

    Aceda às instâncias do Looker

  2. Clique no nome da instância.

  3. Clique no separador Exportar.

  4. Na secção Definir programação para exportação periódica, limpe os valores dos campos Bucket do Cloud Storage, Chave de encriptação gerida pelo cliente e Hora.

  5. Clique em Limpar programação.

gcloud

  1. Para parar uma exportação periódica, execute o seguinte comando gcloud:
gcloud looker instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --region=REGION \
    --clear-periodic-export-config

Substitua o seguinte:

  • INSTANCE_NAME: o nome da sua instância do Looker (Google Cloud Core).
  • PROJECT_ID: o ID Google Cloud do projeto.
  • REGION: a região onde a sua instância está localizada.

O que se segue?