Daten aus einer Looker-Instanz (Google Cloud Core) importieren oder exportieren

Sie möchten die Looker-Instanzen (Google Cloud Core-Instanzen) – einschließlich erstellter Inhalte und interner Daten der Looker-Instanz (Google Cloud Core) – aus einer Looker-Instanz (Google Cloud Core) exportieren und dann in eine andere Looker-Instanz (Google Cloud Core) importieren. Es gibt mehrere Gründe, warum Sie Daten exportieren und importieren möchten:

• Sie möchten ein Upgrade oder Downgrade auf eine andere Version von Looker (Google Cloud Core) ausführen.
• Sie möchten zu einer Looker-Instanz (Google Cloud-Kern) in einem anderen Projekt wechseln.
• Sie möchten zu einer Looker-Instanz (Google Cloud-Kern) in einer anderen Region wechseln.

Looker-Instanzdaten (Google Cloud Core-Instanz) in einen Cloud Storage-Bucket exportieren

Erforderliche Objekte und Berechtigungen für den Export in einen Cloud Storage-Bucket

Hinweis: Wenn Sie Daten über die Google Cloud Console exportieren, müssen Sie die folgenden Berechtigungen nicht manuell gewähren, da sie automatisch gewährt werden.

• Ein Cloud Storage-Bucket mit der Berechtigung storage.objects.create, die dem Looker-Dienstkonto (Google Cloud-Kern) zugewiesen ist. Die Rolle „Storage-Objekt-Ersteller“ (roles/storage.objectCreator) enthält diese Berechtigung. Sie können diese Rolle stattdessen auch dem Looker-Dienstkonto (Google Cloud-Kern) zuweisen.
• Ein vom Kunden verwalteter Verschlüsselungsschlüssel (CMEK) Dieser CMEK ist für den Export- und Importvorgang spezifisch und unterscheidet sich von einem CMEK, der zum Verschlüsseln Ihrer Instanzdaten verwendet wird. Die CMEK-Berechtigung cloudkms.cryptoKeyVersions.useToEncrypt muss dem Looker-Dienstkonto (Google Cloud-Kern) zugewiesen werden. Die Rolle Cloud KMS CryptoKey-Verschlüsseler (roles/cloudkms.cryptoKeyEncrypter) enthält diese Berechtigung. Sie können diese Rolle stattdessen auch dem Looker-Dienstkonto (Google Cloud Core-Instanz) zuweisen.

In einen Cloud Storage-Bucket exportieren

So exportieren Sie Ihre Daten:

Console

1. Rufen Sie in der Google Cloud Console die Seite „Looker“ auf.

   Zu Looker-Instanzen

2. Wählen Sie oben auf der Seite in der Drop-down-Liste Organisation auswählen die Organisationsressource aus, die die Looker-Instanz (Google Cloud Core) enthält, für die Sie Daten exportieren möchten.

3. Klicken Sie auf den Namen der Instanz, für die Sie Daten exportieren möchten.

4. Klicken Sie auf Exportieren.

5. Geben Sie im Feld Bucket exportieren den Bucket-Speicherort an, an dem das Exportartefakt erstellt werden soll. Sie können entweder den Pfad in das Eingabefeld <bucket_name>/<folder_name> eingeben oder den entsprechenden Speicherort im Bucket auswählen.

6. Wählen Sie im Feld Vom Kunden verwalteten Schlüssel auswählen den CMEK aus, der zum Verschlüsseln des Exportartefakts verwendet werden soll.

7. Klicken Sie auf EXPORTIEREN.

gcloud

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

Daten aus einem Cloud Storage-Bucket in eine Looker-Instanz (Google Cloud-Kern) importieren

Erforderliche Berechtigungen für den Import aus einem Cloud Storage-Bucket

Hinweis: Wenn Sie Daten über die Google Cloud Console importieren, müssen Sie die folgenden Berechtigungen nicht manuell gewähren, da sie automatisch gewährt werden.

• Gewähren Sie dem Looker (Google Cloud Core)-Instanzdienstkonto die storage.objects.get Berechtigung. Die Rolle „Storage-Objekt-Betrachter“ (roles/storage.objectViewer) enthält diese Berechtigung. Sie können diese Rolle alternativ dem Looker-Dienstkonto (Google Cloud-Kern) zuweisen.
• Die Berechtigung cloudkms.cryptoKeyVersions.useToDecrypt muss dem Looker-Dienstkonto (Google Cloud-Kern) zugewiesen werden. Die Rolle Cloud KMS CryptoKey-Entschlüsseler (roles/cloudkms.cryptoKeyDecrypter) enthält diese Berechtigung. Sie können diese Rolle alternativ dem Looker-Dienstkonto (Google Cloud-Kern) zuweisen.

Hinweis: Wenn Sie Ihre Looker-Instanz (Google Cloud-Kern) mit einem CMEK erstellt haben, muss der Importvorgang Zugriff auf diesen CMEK und die Schlüsselversion haben. Wenn Sie zwischen zwei verschiedenen Google Cloud-Regionen migrieren, muss der Importprozess möglicherweise auf einen CMEK in einem KMS-Server in einer Region zugreifen, die von der Zielregion abweicht.

Aus einem Cloud Storage-Bucket importieren

So importieren Sie Ihre Daten:

Console

1. Rufen Sie in der Google Cloud Console die Seite „Looker“ auf.

   Zu Looker-Instanzen

2. Wählen Sie oben auf der Seite in der Drop-down-Liste Organisation auswählen die Organisationsressource aus, die die Looker-Instanz (Google Cloud Core) enthält, in die Sie Daten importieren möchten.

3. Klicken Sie auf den Namen der Instanz, in die Sie Daten importieren möchten.

4. Klicken Sie auf IMPORTIEREN.

5. Geben Sie im Feld Bucket importieren den Pfad ein oder suchen Sie nach dem Cloud Storage-Speicherort, an den Sie Ihre Daten exportiert haben. Wählen Sie den Ordner aus, der die Datei metadata.json und weitere Dateien enthält.

6. Klicken Sie auf IMPORTIEREN.

gcloud

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

Fehlerbehebung beim Export oder Import von Looker-Daten (Google Cloud Core)

In diesem Abschnitt wird beschrieben, wie Sie Fehlerbedingungen beheben, die dazu führen, dass der Export- oder Importvorgang fehlschlägt.

Fehler beim Export

• Achten Sie darauf, dass Sie dem Looker-Dienstkonto (Google Cloud-Kern) die Rolle storage.objects.create oder die Rolle Storage-Objekt-Erstellerroles/storage.objectCreator (roles/storage.objectCreator) für den Cloud Storage-Bucket gewährt haben.

• Prüfen Sie, ob Sie dem von Ihnen erstellten Vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) das Looker-Dienstkonto (Google Cloud-Kern) oder die Rolle Cloud KMS CryptoKey-Verschlüsseler (roles/cloudkms.cryptoKeyEncrypter) gewährt haben.cloudkms.cryptoKeyVersions.useToEncrypt

• Achten Sie darauf, dass der angegebene Cloud Storage-Speicherort vor dem Export keine Daten aus einem vorherigen Exportvorgang enthält. Entfernen Sie alle vorhandenen Dateien zuerst.

• Sie können keinen Cloud Storage-Bucket verwenden, für den Anforderer bezahlt aktiviert ist.

Importfehler

• Achten Sie darauf, dass Sie dem Looker-Dienstkonto (Google Cloud-Kern) die Rolle storage.objects.get oder die Rolle Storage-Objekt-Betrachterroles/storage.objectViewer (roles/storage.objectViewer) für den Cloud Storage-Bucket gewährt haben.

• Achten Sie darauf, dass Sie dem von Ihnen erstellten Vom Kunden verwalteten Verschlüsselungsschlüssel (Customer-Managed Encryption Key, CMEK) das Looker-Dienstkonto (Google Cloud-Kern) oder die Rolle Cloud KMS CryptoKey-Entschlüsseler (roles/cloudkms.cryptoKeyDecrypter) gewährt haben.cloudkms.cryptoKeyVersions.useToDecrypt

• Der Import kann aufgrund einer Versionskompatibilität zwischen der Zielinstanz und der Exportinstanz so fehlschlagen:

  • Die Zielinstanz hat eine Looker-Nebenversion, die älter als die Looker-Version der exportierten Daten ist. Die Zielinstanz befindet sich beispielsweise in Looker 23.5.X, aber der Export wurde aus einer Instanz mit Looker-Version 23.6.X erstellt.
  • Die Nebenversion der Instanz, die die Exportdaten erstellt hat, liegt um mehr als einen Release hinter der Looker-Version der Zielinstanz. Die Zielinstanz befindet sich beispielsweise in Looker 23.6.X, aber der Export wurde aus einer Instanz mit Looker-Version 23.4.X erstellt.

  Führen Sie in diesem Fall ein Upgrade der Exportinstanz oder der Zielinstanz durch, sodass auf beiden Instanzen dieselbe Looker-Version ausgeführt wird.