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), depuis 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 passer à 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.

Une exportation inclut toutes les données, configurations et contenus d'une instance, à l'exception des éléments suivants :

• Les paramètres de la console Google Cloud , qui doivent être définis dans la console Google Cloud pour chaque instance, ne sont pas exportés. Toutefois, les paramètres du panneau Admin de Looker dans l'application Looker (Google Cloud Core) sont exportés.
• Les jetons OAuth stockés dans une instance ne sont pas exportés. Si vous utilisez OAuth pour des connexions individuelles à des bases de données, chaque utilisateur devra se reconnecter et actualiser ses jetons pour toutes les connexions à des bases de données qui utilisent OAuth après l'importation.
• Si vous exportez et importez des données dans une instance Looker (Google Cloud Core) qui utilise une configuration réseau différente de celle de l'instance qui a créé l'exportation, vous devrez peut-être configurer vos connexions aux services externes différemment.
• Si vous déplacez une exportation d'une instance d'un projet Google Cloud vers une instance d'un autre projet, vous devez définir des autorisations IAM dans le nouveau projet pour permettre aux utilisateurs d'accéder à l'instance.

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 avec 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

• 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 Storage (roles/storage.objectCreator) inclut cette autorisation. Vous pouvez donc également 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. Elle est différente d'une clé CMEK 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 clé de chiffrement Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) inclut cette autorisation. Vous pouvez donc également 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 :

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

Importer vos données d'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 des données à partir d'un bucket Cloud Storage

• Un compte de service Looker. Si vous avez utilisé 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 également 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 également attribuer ce rôle au compte de service Looker.

Importer des données depuis un bucket Cloud Storage

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

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

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

Les utilisateurs peuvent confirmer de nouveau leur identité pour accéder à leurs bases de données à l'aide de l'une des méthodes suivantes :

• Suivez l'invite Se connecter qui s'affiche lorsque vous consultez une exploration ou un tableau de bord qui utilise une connexion de base de données OAuth individuelle.
• Accédez à la page Compte et 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 faisant référence à une connexion OAuth seront interrompues jusqu'à ce que cet utilisateur se connecte avec ses identifiants OAuth.

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 qui pourraient entraîner l'échec d'un processus d'exportation ou d'importation.

Erreurs lors de l'exportation

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

• Assurez-vous d'avoir accordé au compte de service Looker l'autorisation cloudkms.cryptoKeyVersions.useToEncrypt ou le rôle Chiffreur de CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyEncrypter) pour 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 provenant d'une opération d'exportation précédente. S'il existe des fichiers, supprimez-les d'abord.

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

Erreurs d'importation

• Assurez-vous d'avoir accordé au compte de service Looker l'autorisation storage.objects.get ou le rôle IAM Lecteur des objets de l'espace de stockage (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 CryptoKey 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 Looker 23.6.X.
  • La version mineure de l'instance qui a créé les données d'exportation est antérieure à 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 Looker 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.