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
Accédez à la page Looker dans la console Google Cloud.
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.
Cliquez sur le nom de l'instance pour laquelle vous souhaitez exporter des données.
Cliquez sur Exporter.
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.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.
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'instanceBUCKET_NAME
: emplacement du bucket Cloud Storage dans lequel vous souhaitez créer l'artefact d'exportationFOLDER_NAME
: dossier dans lequel vous souhaitez placer l'artefact d'exportation dans le bucket Cloud StorageKMS_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
Accédez à la page Looker dans la console Google Cloud.
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.
Cliquez sur le nom de l'instance dans laquelle vous souhaitez importer des données.
Cliquez sur IMPORTER.
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.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'instanceBUCKET_NAME
: emplacement du bucket Cloud Storage où se trouvent le fichiermetadata.json
et les autres fichiersFOLDER_NAME
: dossier dans lequel se trouvent le fichiermetadata.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
Assurez-vous d'avoir accordé au compte de service Looker l'autorisation
storage.objects.create
ou le rôle 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 d'une opération d'exportation précédente. S'il existe déjà des fichiers, supprimez-les d'abord.
Vous ne pouvez pas utiliser un bucket Cloud Storage pour lequel l'option Paiements du demandeur est activée.
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.