Importar o exportar datos de una instancia de Looker (Google Cloud core)

Puede que quieras exportar los datos de tu instancia de Looker (Google Cloud core), que incluyen el contenido creado y los datos internos sobre tu instancia de Looker (Google Cloud core), desde una instancia de Looker (Google Cloud core) y, a continuación, importar esos datos a otra instancia de Looker (Google Cloud core). Hay varios motivos por los que puede querer exportar e importar datos:

  • Quieres cambiar a otra edición de Looker (en la infraestructura de Google Cloud).
  • Quieres cambiar a una instancia de Looker (Google Cloud core) en otro proyecto.
  • Quieres cambiar a una instancia de Looker (Google Cloud core) en otra región.
  • Quieres exportar datos de una instancia que no es de producción a tu instancia de producción.

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

  • 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 almacenados en una instancia. Si usas 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.
  • 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 vas a mover una exportación de una instancia de un proyecto a una instancia de otro proyecto, debes configurar los permisos de gestión de identidades y accesos en el nuevo proyecto para que los usuarios puedan acceder a la instancia. Google Cloud

Rol necesario

Para obtener los permisos que necesitas para importar o exportar datos de la instancia de Looker (Google Cloud core), pide a tu administrador que te conceda el rol de gestión de identidades y accesos Administrador de Looker (roles/looker.admin) 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 el acceso a proyectos, carpetas y organizaciones.

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

Exportar los datos de tu instancia de Looker (Google Cloud core) a un segmento de Cloud Storage

En las siguientes secciones se explica cómo exportar los datos de tu instancia.

Objetos y permisos necesarios para exportar a un segmento de Cloud Storage

Exportar a un segmento de Cloud Storage

Para exportar tus datos, selecciona una de las siguientes opciones:

consola

  1. Ve a la página de Looker en la Google Cloud consola.

    Ir a instancias de Looker

  2. En la lista desplegable Seleccionar organización, situada en la parte superior de la página, selecciona el recurso de organización que incluye la instancia de Looker (Google Cloud core) de la que quieras exportar datos.

  3. Haga clic en el nombre de la instancia de la que quiera exportar datos.

  4. Haz clic en Exportar.

  5. En el campo Export Bucket (Segmento de exportación), especifica la ubicación del segmento en el que quieres que se cree el artefacto de exportación. Puede introducir la ruta en el campo de entrada como <bucket_name>/<folder_name> o buscar la ubicación adecuada en el segmento.

  6. En el campo Seleccionar una clave gestionada por el cliente, elige la CMEK que se usará para cifrar el artefacto de exportación.

  7. Haz clic en EXPORTAR.

gcloud

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

Haz los cambios siguientes:

  • INSTANCE_NAME: nombre de la instancia de Looker (servicio principal de Google Cloud). No está asociado a la URL de la instancia.
  • BUCKET_NAME: la ubicación del segmento de Cloud Storage en el que quieres que se cree el artefacto de exportación
  • FOLDER_NAME: la carpeta del segmento de Cloud Storage en la que quieres que se coloque el artefacto de exportación
  • KMS_KEY_ID: la ruta completa del ID de la clave CMEK específica para la importación y la exportación

Importar datos de un segmento de Cloud Storage a una instancia de Looker (Google Cloud core)

En las siguientes secciones se explica cómo importar los datos de tu instancia.

Permisos necesarios para importar desde un segmento de Cloud Storage

  • Una cuenta de servicio de Looker. Si has usado la CLI de Google Cloud, Terraform o la API para crear tu instancia de Looker (Google Cloud Core) y aún no has creado una cuenta de servicio de Looker, tendrás que crear una.
  • Concede el permiso storage.objects.get a la cuenta de servicio de Looker. El rol de gestión de identidades y accesos Lector de objetos de almacenamiento (roles/storage.objectViewer) incluye este permiso, por lo que también puedes asignar ese rol a la cuenta de servicio de Looker.
  • El permiso cloudkms.cryptoKeyVersions.useToDecrypt debe asignarse a la cuenta de servicio de Looker. El rol Encargado de desencriptar claves de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) incluye este permiso, por lo que también puedes asignar ese rol a la cuenta de servicio de Looker.

Importar desde un segmento de Cloud Storage

Para importar sus datos, seleccione una de las siguientes opciones:

consola

  1. Ve a la página de Looker en la Google Cloud consola.

    Ir a instancias de Looker

  2. En la lista desplegable Seleccionar organización, que aparece en la parte superior de la página, selecciona el recurso de organización que incluye la instancia de Looker (Google Cloud core) en la que quieres importar datos.

  3. Haga clic en el nombre de la instancia en la que quiera importar datos.

  4. Haga clic en IMPORT.

  5. En el campo Import Bucket (Segmento de importación), introduce la ruta o busca la ubicación de Cloud Storage en la que has exportado los datos. Selecciona la carpeta que contiene el archivo metadata.json y otros archivos.

  6. Haga clic en IMPORT.

gcloud

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

Haz los cambios siguientes:

  • INSTANCE_NAME: nombre de la instancia de Looker (servicio principal de Google Cloud). No está asociado a la URL de la instancia.
  • BUCKET_NAME: la ubicación del segmento de Cloud Storage donde se encuentran el archivo metadata.json y otros archivos
  • FOLDER_NAME: la carpeta en la que se encuentran el archivo metadata.json y otros archivos

Después de una importación, se pedirá a los usuarios de Looker (Google Cloud core) que vuelvan a autenticarse en cualquier conexión de base de datos de BigQuery o Snowflake que use OAuth para la autenticación de usuarios individuales. Esto se debe a que una exportación de Looker (principal de Google Cloud) no conserva el acceso OAuth ni los tokens de actualización de las conexiones de bases de datos de usuarios individuales.

Los usuarios pueden volver a autenticarse en sus bases de datos con uno de los siguientes métodos:

  • Sigue la petición Iniciar sesión que aparece cuando ven una exploración o un panel de control que usa una conexión de base de datos OAuth individual.
  • Ve a la página Cuenta y selecciona Iniciar sesión en cada una de las bases de datos de la sección Credenciales de conexión OAuth.

Las programaciones o alertas automatizadas que pertenezcan a un solo usuario y que hagan referencia a una conexión OAuth dejarán de funcionar hasta que ese usuario inicie sesión con sus credenciales de OAuth.

Solucionar problemas de exportación o importación de datos de Looker (Google Cloud core)

En esta sección se describe cómo corregir las condiciones de error que podrían provocar que falle un proceso de exportación o importación.

Errores durante la exportación

Errores de importación

  • Asegúrate de haber concedido a la cuenta de servicio de Looker el permiso storage.objects.get o el rol de gestión de identidades y accesos Lector de objetos de almacenamiento (roles/storage.objectViewer) al segmento de Cloud Storage.

  • Asegúrate de haber concedido a la cuenta de servicio de Looker el permiso cloudkms.cryptoKeyVersions.useToDecrypt o el rol Encargado del desencriptado de la clave criptográfica Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) a la clave de cifrado gestionada por el cliente (CMEK) que has creado.

  • La importación puede fallar debido a la incompatibilidad de versiones entre la instancia de destino y la de exportación, como se indica a continuación:

    • La instancia de destino tiene una versión secundaria de Looker inferior a la versión de Looker de los datos exportados. Por ejemplo, la instancia de destino tiene la versión 23.5.X de Looker, pero la exportación se creó a partir de una instancia con la versión 23.6.X de Looker.
    • La versión secundaria de la instancia que creó los datos de exportación es anterior a la versión de Looker de la instancia de destino en más de una versión. Por ejemplo, la instancia de destino tiene la versión 23.6.X de Looker, pero la exportación se creó a partir de una instancia con la versión 23.4.X de Looker.

    En este caso, actualiza la instancia de exportación o la de destino para que ambas ejecuten la misma versión de Looker.