Importa o exporta datos desde una instancia de Looker (Google Cloud Core)

Es posible que desee exportar los datos de su instancia de Looker (Google Cloud Core), que incluye el contenido creado y los datos internos sobre su 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 es posible que quieras importar y exportar datos:

• Quieres actualizar o cambiar a una edición diferente de Looker (Google Cloud Core).
• Desea migrar a una instancia de Looker (Google Cloud Core) en un proyecto diferente.
• Desea trasladarse a una instancia de Looker (Google Cloud Core) en una región diferente.

Exporta los datos de tu instancia de Looker (Google Cloud Core) a un bucket de Cloud Storage

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

Nota: Si exportas datos con la consola de Google Cloud, no es necesario que otorgues los siguientes permisos de forma manual, ya que se otorgarán de forma automática.

• Un bucket de Cloud Storage con el permiso storage.objects.create asignado a la cuenta de servicio de la instancia de Looker (Google Cloud Core) La función de creador de objetos de almacenamiento (roles/storage.objectCreator) incluye este permiso, por lo que, de forma alternativa, puedes asignar esa función a la cuenta de servicio de la instancia de Looker (Google Cloud Core).
• Una clave de encriptación administrada por el cliente (CMEK). Esta CMEK es específica del proceso de exportación y de importación, y difiere de una CMEK que se usa para encriptar los datos de las instancias. El permiso cloudkms.cryptoKeyVersions.useToEncrypt de CMEK debe asignarse a la cuenta de servicio de la instancia de Looker (Google Cloud Core). La función Encriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) incluye este permiso, por lo que puedes asignar esa función a la cuenta de servicio de la instancia de Looker (Google Cloud Core).

Exporta a un bucket de Cloud Storage

Para exportar los datos, haz lo siguiente:

Console

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

   Ir a Instancias de Looker

2. En la lista desplegable Seleccionar organización, 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 quieres exportar datos.

3. Haz clic en el nombre de la instancia para la que deseas exportar datos.

4. Haga clic en Exportar.

5. En el campo Exportar bucket, especifica la ubicación del bucket en el que deseas crear 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.

6. En el campo Selecciona una clave administrada por el cliente, selecciona la CMEK que se usará para encriptar el artefacto de exportación.

7. Haz clic en EXPORTAR.

gcloud

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

Importa tus datos de un bucket de Cloud Storage a una instancia de Looker (Google Cloud Core)

Permisos necesarios para importar desde un bucket de Cloud Storage

Nota: Si importas datos con la consola de Google Cloud, no es necesario que otorgues los siguientes permisos de forma manual, ya que se otorgarán de forma automática.

• Otorga el permiso storage.objects.get a la cuenta de servicio de la instancia de Looker (Google Cloud Core). La función de visualizador de objetos de almacenamiento (roles/storage.objectViewer) incluye este permiso, por lo que, de forma alternativa, puedes asignar esa función a la cuenta de servicio de Looker (Google Cloud Core).
• El permiso cloudkms.cryptoKeyVersions.useToDecrypt debe asignarse a la cuenta de servicio de la instancia de Looker (Google Cloud Core). La función Desencriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) incluye este permiso, por lo que puedes asignar esa función a la cuenta de servicio de Looker (Google Cloud Core).

Nota: Si creaste tu instancia de Looker (Google Cloud Core) con una CMEK, la operación de importación debe tener acceso a esa CMEK y a la versión de clave. Cuando realice la migración entre dos regiones diferentes de Google Cloud, es posible que el proceso de importación deba acceder a una CMEK en un servidor KMS de una región diferente de la región de destino.

Importa desde un bucket de Cloud Storage

Para importar sus datos, siga estos pasos:

Console

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

   Ir a Instancias de Looker

2. En la lista desplegable Seleccionar organización, 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 deseas importar datos.

3. Haz clic en el nombre de la instancia en la que deseas importar datos.

4. Haga clic en IMPORTAR.

5. En el campo Importar bucket, ingresa la ruta de acceso o navega a la ubicación de Cloud Storage donde exportaste tus datos. Selecciona la carpeta que contiene el archivo metadata.json y otros archivos.

6. Haga clic en IMPORTAR.

gcloud

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

Soluciona problemas en la exportación o importación de datos de Looker (Google Cloud Core)

En esta sección, se describe cómo solucionar las condiciones de error que podrían hacer que el proceso de exportación o importación falle.

Errores durante la exportación

• Asegúrate de que le otorgaste a la cuenta de servicio de Looker (Google Cloud Core) el permiso storage.objects.create o la función 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 (Google Cloud Core) el permiso cloudkms.cryptoKeyVersions.useToEncrypt o el rol Encriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) a la Clave de encriptación administrada por el cliente (CMEK) que creaste.

• Asegúrate de que la ubicación de Cloud Storage proporcionada no tenga ningún archivo de una operación de exportación anterior antes de exportar los datos. 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 que le otorgaste a la cuenta de servicio de Looker (Google Cloud Core) el permiso storage.objects.get o la función 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 (Google Cloud Core) el permiso cloudkms.cryptoKeyVersions.useToDecrypt o el rol 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 una incompatibilidad de versiones entre la instancia de destino y la de exportación, de la siguiente manera:

  • La instancia de destino tiene una versión secundaria de Looker que es inferior a la versión de datos exportados de Looker. Por ejemplo, la instancia de destino se encuentra 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 secundaria de la instancia que creó los datos de exportación está 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 Looker versión 23.4.X.

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