Einmaliger Datenimport oder -export für eine Looker (Google Cloud Core)-Instanz

Möglicherweise möchten Sie Ihre Looker-Instanzdaten (Google Cloud Core), einschließlich erstellter Inhalte und interner Daten zu Ihrer 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) durchführen.
  • Sie möchten Einstellungen hinzufügen, die nur bei der Instanzerstellung aktiviert werden können, z. B. Private Service Connect oder CMEK.
  • Sie möchten zu einer Looker-Instanz (Google Cloud Core) in einem anderen Projekt wechseln.
  • Sie möchten zu einer Looker-Instanz (Google Cloud Core) in einer anderen Region wechseln.
  • Sie möchten Daten aus einer Nicht-Produktionsinstanz in Ihre Produktionsinstanz exportieren.

Ein einmaliger Export umfasst alle Daten, Konfigurationen und Inhalte aus einer Instanz, einschließlich BigQuery-Daten, mit folgenden Ausnahmen:

  • Data Studio-Berichte werden nicht exportiert.
  • Alle Google Cloud Console-Einstellungen, die in der Google Cloud Console für jede Instanz vorgenommen werden müssen, werden nicht exportiert. Einstellungen im Looker-Bereich Admin in der Looker-Anwendung (Google Cloud Core) werden jedoch exportiert.
  • Alle OAuth-Tokens, die in einer Instanz gespeichert sind, werden nicht exportiert. Wenn OAuth für einzelne Datenbankverbindungen verwendet wird, muss sich jeder Nutzer nach dem Import noch einmal anmelden und seine Tokens für alle Datenbankverbindungen aktualisieren, die OAuth verwenden.
  • API-Schlüssel für die Looker-Anwendung werden nicht exportiert. Alle Nutzer verlieren den Zugriff auf alle vorhandenen API-Schlüssel, da API-Schlüssel nicht im importierten Paket enthalten sind.
  • Wenn Sie Daten in eine Looker-Instanz (Google Cloud Core) exportieren und importieren, die eine andere Netzwerkkonfiguration als die Instanz verwendet, die den Export erstellt hat, müssen Sie Ihre Verbindungen zu externen Diensten möglicherweise anders konfigurieren.
  • Wenn ein Export aus einer Instanz in einem Google Cloud Projekt in eine Instanz in einem anderen Projekt verschoben wird, müssen im neuen Projekt IAM-Berechtigungen festgelegt werden, um Nutzern Zugriff auf die Instanz zu gewähren.

Einmaliger Datenexport und ‑import sind nicht verfügbar, wenn ein geplanter Exportjob ausgeführt wird. Weitere Informationen zu geplanten Exportjobs finden Sie auf der Dokumentationsseite Geplanten Export für eine Looker-Instanz (Google Cloud Core) erstellen.

Looker (Google Cloud Core) unterstützt keinen Import und Export von Daten aus einer Instanz, die nicht FIPS-konform ist, in eine FIPS-konforme Instanz.

Erforderliche Rollen

Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen und ‑Berechtigungen zuzuweisen, um die Berechtigungen zu erhalten, die Sie zum Importieren oder Exportieren von Looker-Instanzdaten (Google Cloud Core) benötigen:

  • Die Looker-Administrator (roles/looker.admin) IAM-Rolle für das Projekt, in dem die Instanz erstellt wurde.

  • Die storage.buckets.getIamPolicy und storage.buckets.setIamPolicy Berechtigungen für den Cloud Storage-Bucket, in dem der Export erstellt wird. Die Rollen Storage-Administrator (roles/storage.admin) und Inhaber alter Storage-Buckets (roles/storage.legacyBucketOwner) enthalten ebenfalls diese Berechtigungen. Alternativ können Sie also beantragen, dass Ihnen eine dieser Rollen zugewiesen wird.

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff auf Projekte, Ordner und Organisationen verwalten.

Sie können die erforderlichen Berechtigungen auch über benutzerdefinierte Rollen oder vordefinierte Rollen erhalten.

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

In den folgenden Abschnitten wird beschrieben, wie Sie Ihre Instanzdaten exportieren.

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

In der folgenden Liste sind die erforderlichen Objekte und Berechtigungen für den Export in einen Cloud Storage-Bucket aufgeführt:

In einen Cloud Storage-Bucket exportieren

Wählen Sie eine der folgenden Optionen aus, um Ihre Daten zu exportieren:

Console

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

    Looker-Instanzen aufrufen

  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. Maximieren Sie den Tab Einmaliger Export.

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

  7. Wählen Sie im Feld Cloud KMS-Schlüssel auswählen den CMEK aus, der zum Verschlüsseln des Exportartefakts verwendet werden soll.

  8. Klicken Sie auf Exportieren.

gcloud

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

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: ein Name für Ihre Looker-Instanz (Google Cloud Core). Er ist nicht mit der Instanz-URL verknüpft.
  • BUCKET_NAME: der Speicherort des Cloud Storage-Bucket, an dem das Exportartefakt erstellt werden soll
  • FOLDER_NAME: der Ordner, in dem das Exportartefakt im Cloud Storage-Bucket platziert werden soll
  • KMS_KEY_ID: der vollständige Pfad zur CMEK-Schlüssel-ID, die für Import und Export spezifisch ist

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

In den folgenden Abschnitten wird beschrieben, wie Sie Ihre Instanzdaten importieren.

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

In der folgenden Liste sind die erforderlichen Berechtigungen für den Import aus einem Cloud Storage-Bucket aufgeführt:

Aus einem Cloud Storage-Bucket importieren

Wählen Sie eine der folgenden Optionen aus, um Ihre Daten zu importieren:

Console

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

    Looker-Instanzen aufrufen

  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 IMPORT.

  5. Geben Sie im Feld Import-Bucket den Pfad zum Cloud Storage-Speicherort ein, an den Sie Ihre Daten exportiert haben, oder suchen Sie danach. Wählen Sie den Ordner mit der Datei metadata.json und anderen Dateien aus.

  6. Klicken Sie auf IMPORT.

gcloud

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

Ersetzen Sie Folgendes:

  • INSTANCE_NAME: ein Name für Ihre Looker-Instanz (Google Cloud Core). Er ist nicht mit der Instanz-URL verknüpft.
  • BUCKET_NAME: der Speicherort des Cloud Storage-Bucket, in dem sich die Datei metadata.json und andere Dateien befinden
  • FOLDER_NAME: der Ordner, in dem sich die Datei metadata.json und andere Dateien befinden

Nach dem Import werden Looker-Nutzer (Google Cloud Core) aufgefordert, sich noch einmal bei allen BigQuery- oder Snowflake-Datenbankverbindungen zu authentifizieren, die OAuth für die Authentifizierung einzelner Nutzer verwenden. Das liegt daran, dass bei einem Looker-Export (Google Cloud Core) keine OAuth-Zugriffs- oder Aktualisierungstokens für die Datenbankverbindungen einzelner Nutzer beibehalten werden.

Nutzer können sich mit einer der folgenden Methoden noch einmal bei ihren Datenbanken authentifizieren:

  • Folgen Sie der Aufforderung Anmelden , die angezeigt wird, wenn sie eine Explore-Abfrage oder ein Dashboard aufrufen, das eine individuelle OAuth-Datenbankverbindung verwendet.
  • Rufen Sie die Seite Konto auf und wählen Sie unter der Überschrift OAuth-Verbindungsanmeldedaten für jede Datenbank Anmelden aus.

Alle automatisierten Zeitpläne oder Warnungen, die einem einzelnen Nutzer gehören und auf eine OAuth-Verbindung verweisen, funktionieren erst wieder, wenn sich dieser Nutzer mit seinen OAuth-Anmeldedaten anmeldet.

Fehlerbehebung beim Exportieren oder Importieren von Looker-Daten (Google Cloud Core)

In diesem Abschnitt wird beschrieben, wie Sie Fehler beheben, die dazu führen können, dass ein Export- oder Importvorgang fehlschlägt.

Fehler beim Export

Importfehler

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

  • Achten Sie darauf, dass Sie dem Looker-Dienstkonto die Berechtigung cloudkms.cryptoKeyVersions.useToDecrypt oder die Rolle Cloud KMS CryptoKey-Entschlüsseler (roles/cloudkms.cryptoKeyDecrypter) für den von Ihnen erstellten kundenverwalteten Verschlüsselungsschlüssel (CMEK) gewährt haben.

  • Der Import kann aufgrund von Inkompatibilitäten zwischen der Zielinstanz und der Exportinstanz fehlschlagen:

    • Die Zielinstanz hat eine Looker-Nebenversion, die niedriger ist als die Looker-Version der exportierten Daten. Beispiel: Die Zielinstanz verwendet Looker 23.5.X, der Export wurde jedoch aus einer Instanz mit Looker-Version 23.6.X erstellt.
    • Die Nebenversion der Instanz, die die Exportdaten erstellt hat, liegt mehr als eine Version hinter der Looker-Version der Zielinstanz. Beispiel: Die Zielinstanz verwendet Looker 23.6.X, der Export wurde jedoch aus einer Instanz mit Looker-Version 23.4.X erstellt.

    Aktualisieren Sie in diesem Fall entweder die Exportinstanz oder die Zielinstanz, sodass beide Instanzen dieselbe Looker-Version verwenden.