Crear una tarea de exportación programada 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 hayas definido. La exportación se guarda en un segmento de Cloud Storage. Las exportaciones programadas no provocan ningún tiempo de inactividad en la instancia de Looker (Google Cloud Core).

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

  • Los datos de BigQuery no se exportan.

  • Los datos de Secret Manager no se exportan.

  • Los informes de Looker Studio no se exportan.

  • No se exporta ninguna Google Cloud configuración de la consola, que debe hacerse en la Google Cloud consola de cada instancia. Sin embargo, se exporta la configuración del panel Administrar de Looker en la aplicación Looker (Google Cloud Core).

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

  • Las claves de API de la aplicación Looker no se exportan. Todos los usuarios perderán el acceso a todas las claves de API, 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 a la de la instancia que creó la exportación, es posible que tengas que configurar tus conexiones a servicios externos de otra forma.

  • Si se mueve una exportación de una instancia de un proyecto Google Cloud a una instancia de otro proyecto, se deben definir los permisos de gestión de identidades y accesos en el nuevo proyecto para que los usuarios puedan acceder a la instancia.

El proceso de exportación programada tarda entre unos minutos y unas horas, en función del tamaño de la instancia. Mientras se esté ejecutando un proceso de exportación programada, no estarán disponibles las operaciones de importación ni las exportaciones únicas.

Una vez que hayas configurado una tarea de exportación programada, puedes configurar una secuencia de comandos para importar los datos exportados a una instancia de copia de seguridad a diario.

Rol necesario

Para obtener los permisos que necesitas para crear una tarea de exportación programada de Looker (Google Cloud Core), pide a tu administrador que te conceda los siguientes roles de gestión de identidades y accesos en el proyecto en el que se creó la instancia:

Para obtener más información sobre cómo conceder roles, consulta el artículo Gestionar acceso a proyectos, carpetas y organizaciones.

También puedes conseguir los permisos necesarios a través de roles personalizados u otros roles predefinidos.

Antes de empezar

  1. Crea un segmento de Cloud Storage para almacenar el artefacto de exportación.
  2. Crea una clave de cifrado gestionada por el cliente (CMEK) en Cloud Key Management Service. Esto es necesario para cifrar los datos de la exportación programada, aunque tu instancia no use CMEK. La clave de CMEK debe estar en una región diferente a la de tu 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. Concede los siguientes roles y permisos necesarios de Gestión de Identidades y Accesos (IAM) a la cuenta de servicio de la instancia:
    • Asigna el roles/storage.objectAdmin rol al segmento de Cloud Storage que almacena tu exportación.
    • Concede el rol roles/cloudkms.cryptoKeyEncrypterDecrypter en la clave CMEK que uses para cifrar tus datos.
    • También puedes crear un rol personalizado con los siguientes permisos:
      • storage.objects.create
      • storage.objects.delete
      • cloudkms.cryptoKeyVersions.useToEncrypt
      • cloudkms.cryptoKeyVersions.useToDecrypt

Configurar un trabajo de exportación programado

Puedes configurar una tarea de exportación programada mediante la consola de Google Cloud Google Cloud o gcloud.

consola

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

    Ir a instancias de Looker

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

  3. Haz clic en la pestaña Exportar.

  4. Despliega la sección Programar exportación e introduce la siguiente información:

    1. Hora de inicio: la hora del día en hora local (HH:MM) en la que se realizará la exportación diaria.
    2. Segmento de Cloud Storage: el URI de tu segmento 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 Definir programación.

gcloud

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

Haz los cambios siguientes:

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

Verificar la configuración de exportación

Una vez que hayas definido una programación, podrás 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 (en la infraestructura de Google Cloud).

    Ir a 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 de cada día en hora local. La hora de inicio incluye un enlace a la página Exportar de la instancia.

Detener una exportación periódica

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

consola

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

    Ir a 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 Definir una programación para la exportación periódica, borre los valores de los campos Contenedor de Cloud Storage, Clave de cifrado gestionada por el cliente y Hora.

  5. Haz clic en Borrar programación.

gcloud

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

Haz los cambios siguientes:

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

Siguientes pasos