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

Te recomendamos exportar los datos de tu instancia de Looker (Google Cloud Core), que incluyen contenido creado y datos internos sobre tu instancia de Looker (Google Cloud Core), desde una instancia de Looker (Google Cloud Core) y, luego, importar esos datos a otra de Looker (Google Cloud Core). Existen varios motivos por los que podrías querer exportar e importar datos:

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

Función requerida

Si quieres 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 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.

Es posible que también puedas obtener los permisos necesarios a través de los roles personalizados o de otros roles predefinidos.

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 automáticamente.

• Una cuenta de servicio de Looker Si usaste la CLI de 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 Creador de objetos de almacenamiento (roles/storage.objectCreator) incluye este permiso, por lo que puedes asignarlo 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 importación y exportación, y es diferente de una CMEK que se usa para encriptar los datos de tu instancia. El permiso cloudkms.cryptoKeyVersions.useToEncrypt de CMEK debe asignarse a la cuenta de servicio de Looker. El rol Encriptador de CryptoKey de Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) incluye este permiso, por lo que puedes asignarlo de forma alternativa a la cuenta de servicio de Looker.

Exporta a un bucket de Cloud Storage

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

Console

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

   Ir a las instancias de Looker

2. En la lista desplegable Seleccionar una 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) para la que quieres exportar datos.

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

4. Haz clic en Exportar.

5. En el campo Exportar 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 navegar para seleccionar la ubicación adecuada en el bucket.

6. En el campo Selecciona una clave administrada por el cliente, elige la CMEK que se usará para encriptar 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

Reemplaza lo siguiente:

• INSTANCE_NAME: Es un nombre para la 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 desde 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 necesitas otorgar los siguientes permisos de forma manual, ya que se otorgarán automáticamente.

• 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 visualizador de objetos de almacenamiento (roles/storage.objectViewer) incluye este permiso, por lo que puedes asignarlo a la cuenta de servicio de Looker.
• El permiso cloudkms.cryptoKeyVersions.useToDecrypt debe asignarse 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 puedes asignarlo de forma alternativa a la cuenta de servicio de Looker.

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 la versión de clave. Cuando migras entre dos regiones diferentes de Google Cloud, es posible que el proceso de importación necesite acceder a una CMEK en un servidor KMS en una región diferente de la región de destino.

Importa desde un bucket de Cloud Storage

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

Console

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

   Ir a las instancias de Looker

2. En la lista desplegable Seleccionar una 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 quieres importar datos.

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

4. Haz clic en IMPORTAR.

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

6. 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 la 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 archivo metadata.json y otros archivos.
• FOLDER_NAME: Es la carpeta en la que se encuentran el archivo metadata.json y otros archivos.

Soluciona problemas de 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 provocar que falle un proceso de exportación o importación.

Errores durante la exportación

• Asegúrate de haberle otorgado a la cuenta de servicio de Looker el permiso storage.objects.create o el rol de creador de objetos de almacenamiento (roles/storage.objectCreator) al bucket de Cloud Storage.

• Asegúrate de haberle 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.

• Asegúrate de que la ubicación de Cloud Storage determinada no tenga ningún archivo de una operación de exportación anterior antes de exportar tus datos. Si hay algún archivo preexistente, quítalo primero.

• No puedes usar un bucket de Cloud Storage que tenga habilitados los pagos del solicitante.

Errores de importación

• Asegúrate de haberle otorgado a la cuenta de servicio de Looker el permiso storage.objects.get o el rol de Visualizador de objetos de Storage (roles/storage.objectViewer) al bucket de Cloud Storage.

• Asegúrate de haberle 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 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 Looker de los datos exportados. Por ejemplo, la instancia de destino está en Looker 23.5.X, pero la exportación se creó a partir de una instancia en Looker versión 23.6.X.
  • 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ó a partir de 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.