Importer ou exporter des données depuis une instance Looker (Google Cloud Core)

Vous pouvez exporter vos données d'instance Looker (Google Cloud Core), y compris le contenu créé et les données internes concernant votre instance Looker (Google Cloud Core) depuis une instance Looker (Google Cloud Core), puis les importer dans une autre instance Looker (Google Cloud Core). Vous pouvez souhaiter exporter et importer des données pour plusieurs raisons:

  • Vous souhaitez passer à une autre édition de Looker (Google Cloud Core).
  • Vous souhaitez migrer vers une instance Looker (Google Cloud Core) dans un autre projet.
  • Vous souhaitez migrer vers une instance Looker (Google Cloud Core) dans une autre région.

Rôle requis

Pour obtenir les autorisations dont vous avez besoin pour importer ou exporter des données d'instance Looker (Google Cloud Core), demandez à votre administrateur de vous accorder le rôle IAM Administrateur Looker (roles/looker.admin) pour le projet dans lequel l'instance a été créée. Pour en savoir plus sur l'attribution de rôles, consultez la section Gérer les accès.

Vous pouvez également obtenir les autorisations requises via des rôles personnalisés ou d'autres rôles prédéfinis.

Exporter vos données d'instance Looker (Google Cloud Core) vers un bucket Cloud Storage

Objets et autorisations requis pour exporter vers un bucket Cloud Storage

  • Un compte de service Looker Si vous avez utilisé la Google Cloud CLI, Terraform ou l'API pour créer votre instance Looker (Google Cloud Core), mais que vous n'avez pas encore créé de compte de service Looker, vous devrez en créer un.
  • Un bucket Cloud Storage disposant de l'autorisation storage.objects.create attribuée au compte de service Looker. Le rôle Créateur d'objets Storage (roles/storage.objectCreator) inclut cette autorisation. Vous pouvez donc aussi attribuer ce rôle au compte de service Looker.
  • Une clé de chiffrement gérée par le client (CMEK) Cette clé CMEK est spécifique au processus d'exportation et d'importation, et différente de celle utilisée pour chiffrer les données de votre instance. L'autorisation CMEK cloudkms.cryptoKeyVersions.useToEncrypt doit être attribuée au compte de service Looker. Le rôle Chiffreur de CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) inclut cette autorisation. Vous pouvez donc également l'attribuer au compte de service Looker.

Exporter vers un bucket Cloud Storage

Pour exporter vos données, sélectionnez l'une des options suivantes:

Console

  1. Accédez à la page Looker dans la console Google Cloud.

    Accéder aux instances Looker

  2. Dans la liste déroulante Sélectionner une organisation en haut de la page, sélectionnez la ressource d'organisation qui inclut l'instance Looker (Google Cloud Core) pour laquelle vous souhaitez exporter des données.

  3. Cliquez sur le nom de l'instance pour laquelle vous souhaitez exporter des données.

  4. Cliquez sur Exporter.

  5. Dans le champ Export Bucket (Exporter le bucket), spécifiez l'emplacement du bucket dans lequel vous souhaitez créer l'artefact d'exportation. Vous pouvez soit saisir le chemin d'accès dans le champ de saisie en tant que <bucket_name>/<folder_name>, soit parcourir le champ afin de sélectionner l'emplacement approprié dans le bucket.

  6. Dans le champ Sélectionner une clé gérée par le client, sélectionnez la clé CMEK à utiliser pour chiffrer l'artefact d'exportation.

  7. Cliquez sur EXPORTER.

gcloud

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

Remplacez les éléments suivants :

  • INSTANCE_NAME: nom de votre instance Looker (Google Cloud Core) ; il n'est pas associé à l'URL de l'instance
  • BUCKET_NAME: emplacement du bucket Cloud Storage dans lequel vous souhaitez créer l'artefact d'exportation
  • FOLDER_NAME: dossier dans lequel vous souhaitez placer l'artefact d'exportation dans le bucket Cloud Storage
  • KMS_KEY_ID: chemin d'accès complet à l'ID de clé CMEK spécifique à l'importation et à l'exportation

Importer vos données depuis un bucket Cloud Storage vers une instance Looker (Google Cloud Core)

Autorisations requises pour l'importation depuis un bucket Cloud Storage

  • Un compte de service Looker Si vous avez utilisé la Google Cloud CLI, Terraform ou l'API pour créer votre instance Looker (Google Cloud Core), mais que vous n'avez pas encore créé de compte de service Looker, vous devrez en créer un.
  • Accordez l'autorisation storage.objects.get au compte de service Looker. Le rôle "Lecteur des objets Storage" (roles/storage.objectViewer) inclut cette autorisation. Vous pouvez donc aussi attribuer ce rôle au compte de service Looker.
  • L'autorisation cloudkms.cryptoKeyVersions.useToDecrypt doit être attribuée au compte de service Looker. Le rôle Déchiffreur de CryptoKeys Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) inclut cette autorisation. Vous pouvez donc également l'attribuer au compte de service Looker.

Importer depuis un bucket Cloud Storage

Pour importer vos données, sélectionnez l'une des options suivantes:

Console

  1. Accédez à la page Looker dans la console Google Cloud.

    Accéder aux instances Looker

  2. Dans la liste déroulante Sélectionner une organisation en haut de la page, sélectionnez la ressource d'organisation qui inclut l'instance Looker (Google Cloud Core) dans laquelle vous souhaitez importer des données.

  3. Cliquez sur le nom de l'instance dans laquelle vous souhaitez importer des données.

  4. Cliquez sur IMPORTER.

  5. Dans le champ Import Bucket (Importer un bucket), saisissez le chemin d'accès ou accédez à l'emplacement Cloud Storage où vous avez exporté vos données. Sélectionnez le dossier contenant le fichier metadata.json et les autres fichiers.

  6. Cliquez sur IMPORTER.

gcloud

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

Remplacez les éléments suivants :

  • INSTANCE_NAME: nom de votre instance Looker (Google Cloud Core) ; il n'est pas associé à l'URL de l'instance
  • BUCKET_NAME: emplacement du bucket Cloud Storage où se trouvent le fichier metadata.json et les autres fichiers
  • FOLDER_NAME: dossier dans lequel se trouvent le fichier metadata.json et d'autres fichiers

Résoudre les problèmes d'exportation ou d'importation de données Looker (Google Cloud Core)

Cette section explique comment corriger les conditions d'erreur susceptibles de provoquer l'échec d'un processus d'exportation ou d'importation.

Erreurs lors de l'exportation

Erreurs d'importation

  • Assurez-vous d'avoir accordé au compte de service Looker l'autorisation storage.objects.get ou le rôle Lecteur des objets Storage (roles/storage.objectViewer) pour le bucket Cloud Storage.

  • Assurez-vous d'avoir accordé au compte de service Looker l'autorisation cloudkms.cryptoKeyVersions.useToDecrypt ou le rôle Déchiffreur de clé cryptographique Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) pour la clé de chiffrement gérée par le client (CMEK) que vous avez créée.

  • L'importation peut échouer en raison d'une incompatibilité de version entre l'instance cible et l'instance d'exportation, comme suit:

    • L'instance cible possède une version mineure Looker antérieure à la version Looker des données exportées. Par exemple, l'instance cible est sur Looker 23.5.X, mais l'exportation a été créée à partir d'une instance sur Looker version 23.6.X.
    • La version mineure de l'instance qui a créé les données d'exportation est en retard par rapport à la version Looker de l'instance cible de plusieurs versions. Par exemple, l'instance cible est sur Looker 23.6.X, mais l'exportation a été créée à partir d'une instance sur Looker version 23.4.X.

    Dans ce cas, mettez à niveau l'instance d'exportation ou l'instance cible afin que les deux instances exécutent la même version de Looker.