Criar um job de exportação programada para uma instância do Looker (Google Cloud Core)

Nesta página, mostramos como configurar um job de exportação programada para uma instância do Looker (Google Cloud Core). As exportações programadas são executadas a cada 24 horas, começando em um horário de início definido por você. A exportação é salva em um bucket do Cloud Storage. As exportações programadas não criam tempo de inatividade para a instância do Looker (Google Cloud Core).

Uma exportação programada 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 configurações do console Google Cloud , que precisam ser feitas no console Google Cloud para cada instância, não são exportadas. No entanto, as configurações no painel Administrador do Looker no aplicativo Looker (Google Cloud Core) são exportadas.

  • Os tokens do 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, já que 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 projeto Google Cloud for movida para uma instância em um projeto diferente, as permissões do IAM para dar aos usuários acesso à instância precisarão ser definidas no novo projeto.

O processo de exportação programada leva de minutos a horas, dependendo do tamanho da instância. Enquanto um processo de exportação programada está em execução, as operações de importação e as exportações únicas não estão disponíveis.

Depois que um job de exportação programada é configurado, você pode configurar um script para importar os dados exportados para uma instância de backup diariamente.

Papel necessário

Para receber as permissões necessárias para criar um job de exportação programada do Looker (Google Cloud Core), peça ao administrador para conceder a você os seguintes papéis do IAM no projeto em que a instância foi criada:

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 usando papéis personalizados ou outros papéis predefinidos.

Antes de começar

  1. Crie um bucket do Cloud Storage para armazenar o artefato de exportação.
  2. Crie uma chave de criptografia gerenciada pelo cliente (CMEK) no Cloud Key Management Service. Isso é necessário para criptografar os dados da exportação programada, mesmo que sua instância não use a CMEK. A chave CMEK precisa estar em uma região diferente da sua instância do Looker (Google Cloud Core) ou ser uma chave global.
  3. Identifique a conta de serviço da instância do Looker (Google Cloud Core).
  4. Conceda os seguintes papéis e permissões necessários do Identity and Access Management (IAM) à conta de serviço da instância:
    • Conceda o papel roles/storage.objectAdmin no bucket do Cloud Storage que armazena sua exportação.
    • Conceda a função roles/cloudkms.cryptoKeyEncrypterDecrypter na chave de CMEK usada para criptografar seus dados.
    • Como alternativa, crie um papel personalizado com as seguintes permissões:
      • storage.objects.create
      • storage.objects.delete
      • cloudkms.cryptoKeyVersions.useToEncrypt
      • cloudkms.cryptoKeyVersions.useToDecrypt

Configurar um job de exportação programada

É possível configurar um job de exportação programada usando o console Google Cloud ou gcloud.

Console

  1. No console do Google Cloud , acesse a página Instâncias do Looker (Google Cloud Core).

    Acessar as instâncias do Looker

  2. Clique no nome da instância para a qual você quer programar um job de exportação.

  3. Clique na guia Exportar.

  4. Abra a seção Programar job de exportação e insira as seguintes informações:

    1. Horário de início: o horário do dia no horário local (HH:MM) para realizar a exportação diária.
    2. Bucket do Cloud Storage: o URI do seu bucket do Cloud Storage. Por exemplo: gs://bucket-name/export-path.
    3. Chave do Cloud KMS: selecione a chave do Cloud Key Management Service que será usada para criptografar 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:

  • INSTANCE_NAME: o nome da sua instância do Looker (Google Cloud Core).
  • PROJECT_ID: o Google Cloud ID do projeto.
  • REGION: a região em que a instância está localizada.
  • BUCKET_NAME: o nome do bucket do Cloud Storage.
  • EXPORT_PATH: o caminho dentro do bucket para o artefato de exportação.
  • KMS_KEY_NAME: o nome completo do recurso da chave CMEK.
  • TIME: o horário do dia em UTC (HH:MM) para realizar a exportação diária.

Verificar a configuração de exportação

Depois de definir uma programação, é possível conferir a configuração do job de exportação programada na página Detalhes da instância.

  1. No console do Google Cloud , acesse a página Instâncias do Looker (Google Cloud Core).

    Acessar as instâncias do Looker

  2. Clique no nome da sua instância.

  3. Na página Detalhes da instância, confira a configuração de Programação de exportação, que inclui o horário de início programado de cada dia no horário local. O horário de início inclui um link para a página Exportar da instância.

Interromper uma exportação periódica

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

Console

  1. No console do Google Cloud , acesse a página Instâncias.

    Acessar as instâncias do Looker

  2. Clique no nome da instância.

  3. Clique na guia Exportar.

  4. Na seção Definir programação para exportação periódica, limpe os valores dos campos Bucket do Cloud Storage, Chave de criptografia gerenciada pelo cliente e Horário.

  5. Clique em Limpar programação.

gcloud

  1. Para interromper 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:

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

A seguir