Vous pouvez exporter vos données d'instance Looker (Google Cloud Core), y compris les contenus créés et les données internes concernant 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). Nous vous conseillons d'exporter et d'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) d'un autre projet.
- Vous souhaitez passer à une instance Looker (Google Cloud Core) dans une autre région.
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 bucket Cloud Storage avec l'autorisation
storage.objects.create
attribuée au compte de service de l'instance Looker (Google Cloud Core). Le rôle de Créateur d'objets Storage (roles/storage.objectCreator
) vous permet d'attribuer ce rôle au compte de service de l'instance Looker (Google Cloud Core). - 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 de la CMEK utilisée pour chiffrer vos données d'instance. L'autorisation CMEK
cloudkms.cryptoKeyVersions.useToEncrypt
doit être attribuée au compte de service de l'instance Looker (Google Cloud Core). Le rôle Chiffreur de CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyEncrypter
) inclut cette autorisation. Vous pouvez donc l'attribuer au compte de service de l'instance Looker (Google Cloud Core).
Exporter vers un bucket Cloud Storage
Pour exporter vos données:
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 Organisation qui inclut l'instance Looker (Google Cloud Core) pour laquelle vous souhaitez exporter les données.
Cliquez sur le nom de l'instance pour laquelle vous souhaitez exporter des données.
Cliquez sur Exporter.
Dans le champ Exporter le bucket, spécifiez l'emplacement où vous souhaitez créer l'artefact d'exportation. Vous pouvez saisir le chemin d'accès dans le champ de saisie en tant que
<bucket_name>/<folder_name>
ou parcourir la liste pour 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 LOOKER_INSTANCE_NAME \ --target-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME' \ --kms-key=KMS_KEY_ID
Importer vos données depuis un bucket Cloud Storage dans une instance Looker (Google Cloud Core)
Autorisations requises pour l'importation à partir d'un bucket Cloud Storage
- Accordez l'autorisation
storage.objects.get
au compte de service de l'instance Looker (Google Cloud Core). Le rôle de 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 (Google Cloud Core). - L'autorisation
cloudkms.cryptoKeyVersions.useToDecrypt
doit être attribuée au compte de service de l'instance Looker (Google Cloud Core). Le rôle Déchiffreur de CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyDecrypter
) inclut cette autorisation. Vous pouvez donc l'attribuer au compte de service Looker (Google Cloud Core).
Importer à partir d'un bucket Cloud Storage
Pour importer vos données:
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 Organisation qui inclut l'instance Looker (Google Cloud Core) dans laquelle vous souhaitez importer des données.
Cliquez sur le nom de l'instance sur laquelle vous souhaitez importer des données.
Cliquez sur IMPORTER.
Dans le champ Importer un bucket, 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.Cliquez sur IMPORTER.
gcloud
gcloud looker instances import LOOKER_INSTANCE_NAME \ --source-gcs-uri='gs://BUCKET_NAME/FOLDER_NAME'
Résoudre les problèmes liés à l'exportation ou l'importation de données Looker (Google Cloud Core)
Cette section explique comment corriger les conditions d'erreur susceptibles d'échouer dans un processus d'exportation ou d'importation.
Erreurs lors de l'exportation
Assurez-vous d'avoir accordé au compte de service Looker (Google Cloud Core) l'autorisation
storage.objects.create
ou le rôle Créateur d'objets Storage (roles/storage.objectCreator
) au bucket Cloud Storage.Assurez-vous d'avoir accordé au compte de service Looker (Google Cloud Core) l'autorisation
cloudkms.cryptoKeyVersions.useToEncrypt
ou le rôle Chiffreur de CryptoKey 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 issu d'une opération d'exportation précédente. Le cas échéant, supprimez d'abord les fichiers existants.
Vous ne pouvez pas utiliser un bucket Cloud Storage sur lequel les paiements du demandeur sont activés.
Erreurs d'importation
Assurez-vous d'avoir accordé au compte de service Looker (Google Cloud Core) l'autorisation
storage.objects.get
ou le rôle de lecteur des objets Storage (roles/storage.objectViewer
).Assurez-vous d'avoir accordé au compte de service Looker (Google Cloud Core) l'autorisation
cloudkms.cryptoKeyVersions.useToDecrypt
ou le rôle Déchiffreur de CryptoKey Cloud KMS (roles/cloudkms.cryptoKeyDecrypter
) à 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 versions entre l'instance cible et l'instance d'exportation, comme suit:
- L'instance cible possède une version mineure de Looker inférieure à la version de Looker des données exportées. Par exemple, l'instance cible utilise 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 de plusieurs versions à la version Looker de l'instance cible. Par exemple, l'instance cible utilise 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.