Crea un trabajo de exportación programado para una instancia de Looker (Google Cloud Core)

En esta página, se muestra cómo configurar un trabajo de exportación programado para una instancia de Looker (Google Cloud Core). Las exportaciones programadas se ejecutan cada 24 horas, a partir de la hora de inicio que establezcas. La exportación se guarda en un bucket de Cloud Storage. Las exportaciones programadas no generan tiempo de inactividad para la instancia de Looker (Google Cloud Core).

Una exportación programada incluye todos los datos, la configuración y el contenido de una instancia, con las siguientes excepciones:

  • No se exportan los datos de BigQuery.

  • No se exportan los datos de Secret Manager.

  • No se exportan los informes de Looker Studio.

  • No se exporta ningún Google Cloud parámetro de configuración de la consola, que se debe establecer en la Google Cloud consola para cada instancia. Sin embargo, se exportan los parámetros de configuración del panel Administrador de Looker en la aplicación de Looker (Google Cloud Core).

  • No se exportan los tokens de OAuth que se almacenan en una instancia. Si se usa OAuth para las conexiones individuales a la base de datos, después de la importación, cada usuario deberá volver a acceder y actualizar sus tokens para las conexiones a la base de datos que usen OAuth.

  • No se exportan las claves de API de la aplicación de Looker. Todos los usuarios perderán el acceso a todas las claves de API existentes, ya que estas no formarán parte del paquete importado.

  • Si exportas e importas a una instancia de Looker (Google Cloud Core) que usa una configuración de red diferente de la instancia que creó la exportación, es posible que debas configurar tus conexiones a servicios externos de manera diferente.

  • Si se mueve una exportación de una instancia en un proyecto Google Cloud a una instancia en un proyecto diferente, se deben establecer los permisos de IAM en el proyecto nuevo para proporcionar a los usuarios acceso a la instancia.

El proceso de exportación programada tarda entre minutos y horas, según el tamaño de la instancia. Mientras se ejecuta un proceso de exportación programado, no están disponibles las operaciones de importación ni las exportaciones únicas.

Una vez que se configura un trabajo de exportación programado, puedes configurar una secuencia de comandos para importar los datos exportados a una instancia de copia de seguridad todos los días.

Función requerida

Para obtener los permisos que necesitas para crear un trabajo de exportación programado para Looker (Google Cloud Core), pídele a tu administrador que te otorgue los siguientes roles de IAM en el proyecto en el que se creó la instancia:

Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.

También puedes obtener los permisos necesarios mediante roles personalizados o cualquier otro rol predefinido.

Antes de comenzar

  1. Crea un bucket de Cloud Storage para almacenar el artefacto de exportación.
  2. Crea una clave de encriptación administrada por el cliente (CMEK) en Cloud Key Management Service. Esto es necesario para encriptar los datos de la exportación programada, incluso si tu instancia no usa CMEK. La clave CMEK debe estar en una región diferente de la instancia de Looker (Google Cloud Core) o debe ser una clave global.
  3. Identifica la cuenta de servicio de tu instancia de Looker (Google Cloud Core).
  4. Otorga los siguientes roles y permisos obligatorios de Identity and Access Management (IAM) a la cuenta de servicio de la instancia:
    • Otorga el rol de roles/storage.objectAdmin en el bucket de Cloud Storage que almacena tu exportación.
    • Otorga el rol de roles/cloudkms.cryptoKeyEncrypterDecrypter en la clave de CMEK que usas para encriptar tus datos.
    • Como alternativa, puedes crear un rol personalizado con los siguientes permisos:
      • storage.objects.create
      • storage.objects.delete
      • cloudkms.cryptoKeyVersions.useToEncrypt
      • cloudkms.cryptoKeyVersions.useToDecrypt

Configura un trabajo de exportación programado

Puedes configurar un trabajo de exportación programado con la consola de Google Cloud o gcloud.

Console

  1. En la Google Cloud consola, ve a la página Instancias de Looker (Google Cloud Core).

    Ir a las instancias de Looker

  2. Haz clic en el nombre de la instancia para la que deseas programar un trabajo de exportación.

  3. Haz clic en la pestaña Exportar.

  4. Expande la sección Programar trabajo de exportación y, luego, ingresa la siguiente información:

    1. Hora de inicio: Es la hora del día en hora local (HH:MM) para realizar la exportación diaria.
    2. Bucket de Cloud Storage: Es el URI de tu bucket de Cloud Storage, por ejemplo, gs://bucket-name/export-path.
    3. Clave de Cloud KMS: Selecciona la clave de Cloud Key Management Service que se usará para encriptar los datos de la instancia.

  5. Haz clic en Establecer programación.

gcloud

  1. Para configurar una exportación periódica, ejecuta el siguiente comando de 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"

Reemplaza lo siguiente:

  • INSTANCE_NAME: Es el nombre de tu instancia de Looker (Google Cloud Core).
  • PROJECT_ID: Es el Google Cloud ID del proyecto.
  • REGION: Es la región en la que se encuentra la instancia.
  • BUCKET_NAME: Es el nombre de tu bucket de Cloud Storage.
  • EXPORT_PATH: Es la ruta de acceso dentro del bucket para el artefacto de exportación.
  • KMS_KEY_NAME: Es el nombre completo del recurso de tu clave de CMEK.
  • TIME: Es la hora del día en UTC (HH:MM) para realizar la exportación diaria.

Verifica la configuración de exportación

Después de configurar una programación, puedes ver la configuración del trabajo de exportación programado en la página Detalles de la instancia.

  1. En la Google Cloud consola, ve a la página Instancias de Looker (Google Cloud Core).

    Ir a las instancias de Looker

  2. Haz clic en el nombre de la instancia.

  3. En la página Detalles de la instancia, consulta la configuración de Programación de exportación, que incluye la hora de inicio programada cada día en hora local. La hora de inicio incluye un vínculo a la página Exportar de la instancia.

Detén una exportación periódica

Para detener una exportación periódica, borra los campos de configuración.

Console

  1. En la consola de Google Cloud , ve a la página Instancias.

    Ir a las instancias de Looker

  2. Haz clic en el nombre de la instancia .

  3. Haz clic en la pestaña Exportar.

  4. En la sección Set schedule for periodic export, borra los valores de los campos Cloud Storage bucket, Customer-managed encryption key y Time.

  5. Haz clic en Borrar programación.

gcloud

  1. Para detener una exportación periódica, ejecuta el siguiente comando de gcloud:
gcloud looker instances update INSTANCE_NAME \
    --project=PROJECT_ID \
    --region=REGION \
    --clear-periodic-export-config

Reemplaza lo siguiente:

  • INSTANCE_NAME: Es el nombre de tu instancia de Looker (Google Cloud Core).
  • PROJECT_ID: Es el Google Cloud ID del proyecto.
  • REGION: Es la región en la que se encuentra la instancia.

¿Qué sigue?