Es posible que desees 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, luego, importarlos a otra instancia de Looker (Google Cloud Core). Existen varios motivos por los que podrías querer exportar e importar datos:
- Quieres actualizar a una edición de Looker (Google Cloud Core) o pasar a una versión anterior.
- Quieres pasarte a una instancia de Looker (Google Cloud Core) en un proyecto diferente.
- Quieres pasarte a una instancia de Looker (Google Cloud Core) en una región diferente.
- Quieres exportar datos de una instancia que no es de producción a tu instancia de producción.
Función requerida
Para obtener los permisos que necesitas para importar o exportar datos de instancias de Looker (Google Cloud Core),
pídele a tu administrador que te otorgue el rol de IAM de
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 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.
Exporta los datos de tu instancia de Looker (Google Cloud Core) a un bucket 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 bucket de Cloud Storage
- Una cuenta de servicio de Looker Si usaste Google Cloud CLI, Terraform o la API para crear tu instancia de Looker (Google Cloud Core) y aún no creaste una cuenta de servicio de Looker, deberás crear una.
- Un bucket de Cloud Storage con el permiso
storage.objects.create
asignado a la cuenta de servicio de Looker El rol de IAM Creador de objetos de almacenamiento (roles/storage.objectCreator
) incluye este permiso, por lo que, como alternativa, puedes asignar ese rol a la cuenta de servicio de Looker. - Una clave de encriptación administrada por el cliente (CMEK) Esta CMEK es específica del proceso de exportación e importación y es diferente de una CMEK que se usa para encriptar los datos de tu instancia. El permiso
cloudkms.cryptoKeyVersions.useToEncrypt
de la CMEK se debe asignar a la cuenta de servicio de Looker. El rol de encriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypter
) incluye este permiso, por lo que, como alternativa, puedes asignar ese rol a la cuenta de servicio de Looker.
Exporta a un bucket de Cloud Storage
Para exportar tus datos, selecciona una de las siguientes opciones:
Console
Ve a la página Looker en la consola de Google Cloud.
En la lista desplegable Seleccionar una organización, en la parte superior de la página, selecciona el recurso de la organización que incluye la instancia de Looker (Google Cloud Core) para la que deseas exportar datos.
Haz clic en el nombre de la instancia de la que deseas exportar datos.
Haz clic en Exportar.
En el campo Export Bucket, especifica la ubicación del bucket en la que deseas que se cree el artefacto de exportación. Puedes ingresar la ruta de acceso en el campo de entrada como
<bucket_name>/<folder_name>
o explorar para seleccionar la ubicación adecuada en el bucket.En el campo Select a customer-managed key, selecciona la CMEK que se usará para encriptar el artefacto de exportación.
Haz clic en EXPORTAR.
gcloud
gcloud looker instances export INSTANCE_NAME \ --target-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME' \ --kms-key=KMS_KEY_ID
Reemplaza lo siguiente:
INSTANCE_NAME
: Es un nombre para tu instancia de Looker (Google Cloud Core). No está asociado con la URL de la instancia.BUCKET_NAME
: Es la ubicación del bucket de Cloud Storage en la que deseas que se cree el artefacto de exportación.FOLDER_NAME
: Es la carpeta en la que deseas que se coloque el artefacto de exportación dentro del bucket de Cloud Storage.KMS_KEY_ID
: Es la ruta de acceso completa al ID de clave CMEK específico de importación y exportación.
Importa tus datos de un bucket 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 bucket de Cloud Storage
- Una cuenta de servicio de Looker Si usaste Google Cloud CLI, Terraform o la API para crear tu instancia de Looker (Google Cloud Core) y aún no creaste una cuenta de servicio de Looker, deberás crear una.
- Otorga el permiso
storage.objects.get
a la cuenta de servicio de Looker. El rol de IAM de visualizador de objetos de almacenamiento (roles/storage.objectViewer
) incluye este permiso, por lo que, como alternativa, puedes asignar ese rol a la cuenta de servicio de Looker. - El permiso
cloudkms.cryptoKeyVersions.useToDecrypt
se debe asignar a la cuenta de servicio de Looker. El rol de desencriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyDecrypter
) incluye este permiso, por lo que, como alternativa, puedes asignar ese rol a la cuenta de servicio de Looker.
Importación desde un bucket de Cloud Storage
Para importar tus datos, selecciona una de las siguientes opciones:
Console
Ve a la página Looker en la consola de Google Cloud.
En la lista desplegable Seleccionar una organización, en la parte superior de la página, selecciona el recurso de la organización que incluye la instancia de Looker (núcleo de Google Cloud) en la que deseas importar datos.
Haz clic en el nombre de la instancia en la que deseas importar datos.
Haz clic en IMPORTAR.
En el campo Import Bucket, ingresa la ruta de acceso o explora la ubicación de Cloud Storage a la que exportaste tus datos. Selecciona la carpeta que contiene el archivo
metadata.json
y otros archivos.Haz clic en IMPORTAR.
gcloud
gcloud looker instances import INSTANCE_NAME \ --source-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME'
Reemplaza lo siguiente:
INSTANCE_NAME
: Es un nombre para tu instancia de Looker (Google Cloud Core). No está asociado con la URL de la instancia.BUCKET_NAME
: Es la ubicación del bucket de Cloud Storage en la que se encuentran el archivometadata.json
y otros archivos.FOLDER_NAME
: Es la carpeta en la que se encuentran el archivometadata.json
y otros archivos.
Después de una importación, se les pedirá a los usuarios de Looker (núcleo de Google Cloud) 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 (Google Cloud Core) no retiene el acceso de OAuth ni los tokens de actualización para 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 el mensaje Acceder que aparece cuando ve una exploración o un panel que usa una conexión de base de datos de OAuth individual.
- Ve a la página Account y selecciona Log in para cada una de las bases de datos en el encabezado OAuth Connection Credentials.
Cualquier programación o alerta automatizada que sea propiedad de un solo usuario y que haga referencia a una conexión de OAuth se interrumpirá hasta que ese usuario acceda con sus credenciales de OAuth.
Soluciona problemas relacionados con la 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 hacer que falle un proceso de exportación o importación.
Errores durante la exportación
Asegúrate de haber otorgado a la cuenta de servicio de Looker el permiso
storage.objects.create
o el rol de IAM de creador de objetos de almacenamiento (roles/storage.objectCreator
) al bucket de Cloud Storage.Asegúrate de haber otorgado a la cuenta de servicio de Looker el permiso
cloudkms.cryptoKeyVersions.useToEncrypt
o el rol de encriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypter
) a la clave de encriptación administrada por el cliente (CMEK) que creaste.Antes de exportar tus datos, asegúrate de que la ubicación de Cloud Storage que se proporciona no tenga archivos de una operación de exportación anterior. Si hay archivos preexistentes, quítalos primero.
No puedes usar un bucket de Cloud Storage que tenga habilitados los pagos del solicitante.
Errores de importación
Asegúrate de haber otorgado a la cuenta de servicio de Looker el permiso
storage.objects.get
o el rol de IAM de Visualizador de objetos de almacenamiento (roles/storage.objectViewer
) al bucket de Cloud Storage.Asegúrate de haber otorgado a la cuenta de servicio de Looker el permiso
cloudkms.cryptoKeyVersions.useToDecrypt
o el rol de Desencriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyDecrypter
) a la clave de encriptación administrada por el cliente (CMEK) que creaste.La importación puede fallar debido a la incompatibilidad de versiones entre la instancia de destino y la instancia 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 está en Looker 23.5.X, pero la exportación se creó desde una instancia en la versión 23.6.X de Looker.
- La versión menor de la instancia que creó los datos de exportación está por detrás de la versión de Looker de la instancia de destino en más de una versión. Por ejemplo, la instancia de destino está en Looker 23.6.X, pero la exportación se creó desde una instancia en la versión 23.4.X de Looker.
En este caso, actualiza la instancia de exportación o la instancia de destino para que ambas instancias ejecuten la misma versión de Looker.