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

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

• Vous souhaitez passer à une autre édition de Looker (Google Cloud Core).
• Vous souhaitez passer à 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.
• Vous souhaitez exporter des données d'une instance hors production vers votre instance de production.

Important :L'importation de données dans une instance Looker (Google Cloud Core) existante écrase toutes les données d'instance existantes.

Rôle requis

Pour obtenir les autorisations nécessaires 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) sur le projet dans lequel l'instance a été créée. Pour en savoir plus sur l'attribution de rôles, consultez la page Gérer l'accès aux projets, aux dossiers et aux organisations.

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

Exporter les données de votre instance Looker (Google Cloud Core) vers un bucket Cloud Storage

Les sections suivantes expliquent comment exporter les données de votre instance.

Objets et autorisations requis pour exporter vers un bucket Cloud Storage

Remarque :Si vous exportez des données à l'aide de la console Google Cloud, vous n'avez pas besoin d'accorder manuellement les autorisations suivantes. Elles vous seront automatiquement accordées.

• 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) et que vous n'avez pas encore créé de compte de service Looker, vous devez en créer un.
• Un bucket Cloud Storage avec l'autorisation storage.objects.create attribuée au compte de service Looker. Le rôle IAM Créateur d'objets de l'espace de stockage (roles/storage.objectCreator) inclut cette autorisation. Vous pouvez donc 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ère de la clé CMEK utilisée pour chiffrer les données de votre instance. L'autorisation cloudkms.cryptoKeyVersions.useToEncrypt CMEK doit être attribuée au compte de service Looker. Le rôle Chiffreur de CryptoKeys Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) inclut cette autorisation. Vous pouvez donc attribuer ce rôle 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 (Bucket d'exportation), spécifiez l'emplacement du bucket dans lequel vous souhaitez créer l'artefact d'exportation. Vous pouvez saisir le chemin d'accès dans le champ de saisie sous la forme <bucket_name>/<folder_name> ou parcourir le bucket pour sélectionner l'emplacement approprié.

6. Dans le champ Sélectionner une clé gérée par le client, sélectionnez la 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 vers l'ID de clé CMEK spécifique à l'importation et à l'exportation

Attention :Votre instance sera indisponible pendant le processus d'exportation. Le processus d'exportation prend de quelques minutes à plusieurs heures, selon la taille de l'instance.

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

Les sections suivantes expliquent comment importer les données de votre instance.

Autorisations requises pour importer à partir d'un bucket Cloud Storage

Remarque :Si vous importez des données à l'aide de la console Google Cloud, vous n'avez pas besoin d'accorder manuellement les autorisations suivantes. Elles vous seront automatiquement accordées.

• 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) et que vous n'avez pas encore créé de compte de service Looker, vous devez en créer un.
• Accordez l'autorisation storage.objects.get au compte de service Looker. Le rôle IAM Lecteur des objets de l'espace de stockage (roles/storage.objectViewer) inclut cette autorisation. Vous pouvez donc 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 CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyDecrypter) inclut cette autorisation. Vous pouvez donc attribuer ce rôle au compte de service Looker.

Remarque :Si vous avez créé votre instance Looker (Google Cloud Core) à l'aide d'un CMEK, l'opération d'importation doit avoir accès à ce CMEK et à la version de clé. Lorsque vous migrez entre deux régions Google Cloud différentes, le processus d'importation peut avoir besoin d'accéder à une clé CMEK sur un serveur KMS dans une région différente de la région cible. Si la région qui héberge le serveur KMS n'est pas disponible (par exemple, en cas de catastrophe naturelle), le processus d'importation échoue.

Importer à partir d'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 Bucket d'importation, saisissez le chemin d'accès ou accédez à l'emplacement Cloud Storage dans lequel 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 d'autres fichiers
• FOLDER_NAME: dossier dans lequel se trouvent le fichier metadata.json et d'autres fichiers

Après une importation, les utilisateurs de Looker (Google Cloud Core) sont invités à s'authentifier à nouveau auprès de toutes les connexions de base de données BigQuery ou Snowflake qui utilisent OAuth pour l'authentification individuelle des utilisateurs. En effet, une exportation Looker (Google Cloud Core) ne conserve pas les jetons d'accès OAuth ni d'actualisation pour les connexions de base de données des utilisateurs individuels.

Les utilisateurs peuvent se réauthentifier auprès de leurs bases de données de l'une des manières suivantes:

• Suivez les instructions de la requête Se connecter qui s'affiche lorsqu'il consulte une exploration ou un tableau de bord qui utilise une connexion de base de données OAuth individuelle.
• Accédez à la page Compte, puis sélectionnez Se connecter pour chacune des bases de données sous l'en-tête Identifiants de connexion OAuth.

Toutes les planifications ou alertes automatiques appartenant à un seul utilisateur et qui font référence à une connexion OAuth ne fonctionneront plus jusqu'à ce que cet utilisateur se connecte avec ses identifiants OAuth.

Remarque :Si l'importation échoue lorsque vous essayez d'importer des données d'instance dans une nouvelle instance, l'instance est réinitialisée en état "ACTIVE" au lieu de rester en état "IMPORTING" ou "ERROR". Cela permet de conserver l'accès à l'instance et, par exemple, de la supprimer si nécessaire.

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

Cette section explique comment corriger les conditions d'erreur pouvant entraîner l'échec d'un processus d'exportation ou d'importation.

Erreurs lors de l'exportation

• Assurez-vous d'avoir attribué au compte de service Looker l'autorisation storage.objects.create ou le rôle IAM Créateur d'objets Storage (roles/storage.objectCreator) au bucket Cloud Storage.

• Assurez-vous d'avoir accordé au compte de service Looker l'autorisation cloudkms.cryptoKeyVersions.useToEncrypt ou le rôle Chiffreur de CryptoKeys Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) à la clé de chiffrement gérée par le client (CMEK) que vous avez créée.

• Avant d'exporter vos données, assurez-vous que l'emplacement Cloud Storage indiqué ne contient aucun fichier d'une opération d'exportation précédente. Si des fichiers préexistants sont présents, supprimez-les d'abord.

• Vous ne pouvez pas utiliser de bucket Cloud Storage pour lequel les paiements du demandeur sont activés.

Erreurs d'importation

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

• Assurez-vous d'avoir accordé au compte de service Looker l'autorisation cloudkms.cryptoKeyVersions.useToDecrypt ou le rôle Chiffreur/Déchiffreur de CryptoKeys 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:

  • La version mineure de Looker de l'instance cible est infé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 la version 23.6.X de Looker.
  • La version mineure de l'instance ayant créé les données d'exportation est plus ancienne que la version Looker de l'instance cible de plus d'une version. Par exemple, l'instance cible est sur Looker 23.6.X, mais l'exportation a été créée à partir d'une instance sur la version 23.4.X de Looker.

  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.