Selfservice-Migration von Looker (Original) zu Looker (Google Cloud Core)

In diesem Dokument werden die technischen Schritte zur Migration Ihrer vorhandenen Looker-Instanz von der Looker (Original)-Umgebung zu Looker (Google Cloud Core) beschrieben.

Looker (Google Cloud Core) ist eine Bereitstellungsumgebung, die eng in die Google Cloud -Plattform eingebunden ist. Looker (Google Cloud Core) wird auf der Infrastruktur von Google Cloud gehostet. Sie können es direkt über die Google Cloud Console verwalten und es ist eng in viele andere Produkte, Dienste und Funktionen von Google Cloudeingebunden.

Looker (Google Cloud Core) unterstützt die Migration von einer Looker (Original)-Instanz zu einer FIPS-fähigen Looker (Google Cloud Core)-Instanz nicht, da Looker (Original)-Instanzen die FIPS-Compliance nicht unterstützen.

Hinweis

  1. Machen Sie sich mit den Prinzipien und Tools von Google Cloud vertraut, indem Sie die folgende Dokumentation lesen:
  2. Wenden Sie sich an Ihren Kundenbetreuer, um mehr über die Migration zu erfahren und zu prüfen, ob Ihre Looker (Original)-Instanz dafür infrage kommt. Wenn Ihre Instanz die Voraussetzungen erfüllt und Sie Ihren bestehenden Looker (Original)-Vertrag auf Looker (Google Cloud Core) umgestellt haben, können Sie die Schritte in diesem Dokument ausführen, um Ihre Instanz zu migrieren.

  3. Bitten Sie Ihren Administrator, Ihnen die folgenden IAM-Rollen für das Google Cloud -Projekt zuzuweisen, in dem sich die Looker (Google Cloud Core)-Instanz befinden wird, um die Berechtigungen zu erhalten, die Sie für die Vorbereitung der Migration benötigen:

    • Looker (Google Cloud Core)-Instanz erstellen: Looker-Administrator (roles/looker.admin).
    • IAM-Rollen in Ihrem Google Cloud -Projekt zuweisen: Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin).
    • Cloud Storage-Bucket erstellen: Storage-Administrator (roles/storage.admin).

    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 andere vordefinierte Rollen erhalten.

  4. Wenn Sie die Looker-Instanz (Original) zur Vorbereitung auf die Migration verwalten möchten, benötigen Sie die Looker-Rolle Administrator in dieser Instanz.

  5. Erstellen Sie eine neue „leere“ Looker (Google Cloud Core)-Instanz.

    Achten Sie darauf, die richtige Version, den richtigen Netzwerkverbindungstyp (öffentliche sichere Verbindungen oder private Verbindungen) und andere Konfigurationsattribute (CMEK, VPC-SC) für Ihre neue Looker (Google Cloud Core)-Instanz auszuwählen, damit sie die erforderlichen Funktionen hat. Einige der Funktionen in Looker (Google Cloud Core) hängen von der ausgewählten Version oder dem ausgewählten Netzwerktyp ab.

    Lassen Sie die Instanz „leer“. Füllen Sie sie nicht mit Daten wie Modelldateien, Nutzern, Verbindungen, Explores, Dashboards oder Ordnern. Während des Imports werden alle Einstellungen oder Inhalte gelöscht und durch Daten aus der Migration ersetzt.

    Die Konfigurationsattribute von Looker (Google Cloud Core), die über die Google Cloud -Konsole angegeben werden oder nur während der Instanzerstellung angegeben werden können, werden jedoch während der Migration nicht überschrieben.

Übersicht

Auf übergeordneter Ebene besteht der Migrationsprozess aus den folgenden Schritten.

  1. Prüfen Sie, ob Ihre Looker (Original)-Instanz für die Migration bereit ist.
  2. Exportieren Sie die Daten aus Ihrer Looker (Original)-Instanz.
  3. Importieren Sie die Daten in die neue „leere“ Looker (Google Cloud Core)-Instanz.
  4. Schließen Sie die Einrichtung der Looker (Google Cloud Core)-Instanz ab.
  5. Looker-Instanz (Original) außer Betrieb nehmen

In den folgenden Abschnitten finden Sie Details zu den einzelnen Schritten.

Sicherstellen, dass Ihre Looker-Instanz (Original) für die Migration bereit ist

Ihre Looker (Original)-Instanz muss die folgenden Voraussetzungen erfüllen, um migriert werden zu können:

  • Ihre Looker (Original)-Instanz muss von Google verwaltet werden (also nicht vom Kunden gehostet) und auf Google Cloud oder Amazon Web Services gehostet werden.

  • Ihre Looker (Original)-Instanz muss eine Version verwenden, die maximal ein monatliches Release von der aktuellen Looker (Google Cloud Core)-Version entfernt ist. Die aktuelle Looker (Google Cloud Core)-Version finden Sie in den Looker-Versionshinweisen. Suchen Sie dort nach der neuesten Bereitstellungsankündigung.

Führen Sie außerdem vor der Migration die folgenden Aktivitäten aus:

  • Es gibt einige Funktionsunterschiede zwischen Looker (Original) und Looker (Google Cloud Core). Prüfen Sie diese Unterschiede, um sicherzustellen, dass die Funktionen in Looker (Google Cloud Core) Ihren Anforderungen entsprechen.

  • Bei der Migration werden alle Projekte im Produktionsmodus und die darin enthaltenen Modelldateien kopiert, jedoch nicht die Projekte im Entwicklungsmodus, die einzelnen Nutzern gehören. Damit Dateien im Entwicklungsmodus bei der Migration übertragen werden, müssen Sie alle Dateien in allen Projekten im Entwicklungsmodus in Git-Repositories committen, bevor Sie die Migration starten.

  • Looker (Google Cloud Core) unterstützt nur die Authentifizierungsmethoden Google OAuth, SAML und OpenID Connect.

  • Während der Migration werden zwei Looker-Instanzen – eine Looker (Original)- und eine Looker (Google Cloud Core)-Instanz – für einen bestimmten Zeitraum parallel ausgeführt. Alle automatischen Aktivitäten (z. B. Benachrichtigungen und geplante Datenlieferungen sowie Hintergrundaktivitäten, die auf Backend-Datenbanken zugreifen) werden möglicherweise dupliziert. Um doppelte Aktivitäten zu vermeiden, löschen Sie automatische Benachrichtigungen und Zeitpläne entweder in der Looker (Original)- oder in der Looker (Google Cloud Core)-Instanz.

Daten aus Ihrer Looker-Instanz (Original) exportieren

Das Exportieren der Daten aus Ihren Looker (Original)-Instanzen erfordert zwei Schritte:

  1. Speicherort für die Migrationsdaten erstellen
  2. Export starten

In der Dokumentation Einmaliger Datenimport oder -export für eine Looker (Google Cloud Core)-Instanz erfahren Sie, welche Daten in einem Export enthalten sind und welche nicht.

Speicherort für die Migrationsdaten erstellen

Führen Sie alle folgenden Vorgänge im selben Google Cloud -Projekt aus, in dem Sie die Looker (Google Cloud Core)-Instanz erstellt haben.

  1. Erstellen Sie einen neuen Cloud Storage-Bucket (z. B. <bucket-name>).
    • In diesem Bucket werden die Migrationsdaten gespeichert.
    • Folgen Sie der Anleitung auf der Dokumentationsseite Buckets erstellen.
    • Beachten Sie, dass der <bucket-name> in allen Google Cloudeindeutig sein muss. Wir empfehlen, dem Bucket-Namen eine eindeutige Kennung voranzustellen, z. B. Ihre Projekt-ID.
  2. Legen Sie einen Namen für einen Ordner im Cloud Storage-Bucket fest (z. B. <folder-name>). Erstellen Sie den Ordner noch nicht. Geben Sie den Ordnernamen während der Exportanfrage an. Er wird während des Exportvorgangs automatisch erstellt.
  3. Erstellen Sie einen Schlüsselbund und einen Schlüssel in Cloud KMS (z. B. <kms_keyring_id> und <kms-key-id>).
  4. Erstellen Sie ein neues Dienstkonto speziell für die Migration (z. B. <export-service-account>).

  5. Weisen Sie dem <export-service-account> zwei bestimmte IAM-Rollen zu:

  6. Erstellen Sie einen Dienstkontoschlüssel, der mit <export-service-account> verknüpft ist, und laden Sie die JSON-Schlüsseldatei herunter.

Export anfordern

Nachdem Sie sichergestellt haben, dass Ihre Instanz für die Migration bereit ist, eine „leere“ Looker (Google Cloud Core)-Instanz erstellt und einen Speicherort für die Migrationsdaten eingerichtet haben, geben Sie die folgenden Informationen auf der Seite Exportieren im Admin-Bereich Ihrer Looker (Original)-Instanz ein:

  • Der Name des von Ihnen erstellten Cloud Storage-Bucket.
  • Der Name des Cloud Storage-Ordners. Ein Ordner mit diesem Namen wird während des Exports automatisch erstellt. Wenn der Export abgeschlossen ist, werden die Exportdateien in einem Unterordner mit Zeitstempel in diesem Ordner im von Ihnen erstellten Cloud Storage-Bucket angezeigt.
  • Der KMS-Schlüsselname.
  • Der JSON-Text, der den Dienstkontoschlüssel enthält.

Nachdem Sie die Informationen auf der Seite Exportieren eingegeben haben, klicken Sie auf Export anfordern, um den Export zu starten.

Der Exportvorgang dauert einige Minuten bis Stunden. Nach Abschluss des Exports werden in Ihrem Cloud Storage-Bucket und -Ordner mehrere Exportdateien (in einem nicht menschenlesbaren Format) angezeigt. Diese Dateien sind die Eingabe für den folgenden Importschritt.

Daten in die neue „leere“ Looker (Google Cloud Core)-Instanz importieren

Nachdem Sie Ihre Instanzdaten exportiert haben, können Sie sie in Ihre Looker (Google Cloud Core)-Instanz importieren.

Folgen Sie der Anleitung auf der Seite Daten aus Cloud Storage in eine Looker (Google Cloud Core)-Instanz importieren und verweisen Sie mit den Befehlen auf den Bucket und den Ordner, in dem die Exportdateien abgelegt wurden.

Der Importvorgang dauert einige Minuten bis Stunden. Nach Abschluss wird Ihre Looker (Google Cloud Core)-Instanz mit allen migrierten Daten neu gestartet.

Einrichtung der Looker (Google Cloud Core)-Instanz abschließen

An dieser Stelle können Looker-Administratoren die Instanz-URL aufrufen und sich bei der Instanz anmelden, um die Einrichtung abzuschließen.

Beim Migrationsprozess wird so viel wie möglich von der Konfiguration der Looker-Instanz (Original) kopiert. Einige Elemente können jedoch nicht migriert werden oder funktionieren in Looker (Google Cloud Core) etwas anders und müssen angepasst werden.

Für die folgenden Elemente ist besondere Aufmerksamkeit erforderlich:

Allgemeine Einstellungen (im Looker-Admin-Bereich)

Die meisten Optionen für Allgemeine Einstellungen (und andere Einstellungen im Admin-Bereich) werden nicht automatisch kopiert, da sie in Looker (Google Cloud Core) in der Regel anders sind oder nicht in derselben Form existieren. Sie sollten alle Einstellungen im Kontext Ihrer ausgewählten Looker (Google Cloud Core)-Konfiguration sorgfältig prüfen und konfigurieren. Weitere Informationen zu den Einstellungen in Looker (Google Cloud Core) finden Sie auf den Dokumentationsseiten Looker (Google Cloud Core)-Instanz über Looker verwalten und Looker (Google Cloud Core)-Instanz über die Google Cloud Console verwalten.

Nutzer

Looker (Google Cloud Core) unterstützt nur die Authentifizierungsmethoden Google OAuth, SAML und OpenID Connect.

Wenn die Looker-Instanz (Original) auch für Google OAuth konfiguriert wurde, werden die Nutzerdatensätze und ihre Attribute kopiert (sofern sie in beiden Instanzen mit derselben Google-ID und E‑Mail-Adresse verknüpft sind). Ein Projekt-IAM-Administrator muss jedem Nutzer die IAM-Rolle Looker-Administrator oder Looker-Instanznutzer für das Google Cloud Projekt zuweisen, in dem sich die Instanz befindet.

Wenn die Looker-Instanz (Original) für SAML oder OpenID Connect konfiguriert wurde, muss im Feld Nutzer zusammenführen mit für die Authentifizierungsmethode nur eine Authentifizierungsmethode angegeben sein, die von Looker (Google Cloud Core) unterstützt wird.

Wenn sich einige Nutzer der Looker-Instanz (Original) über einen Mechanismus authentifiziert haben, der in Looker (Google Cloud Core) nicht unterstützt wird (z. B. LDAP oder E-Mail-Adresse und Passwort), müssen diese Nutzerkonten neu erstellt und in eine unterstützte Authentifizierungsmethode konvertiert werden.

Wenn Sie verhindern möchten, dass beim Konvertieren von Nutzern doppelte Nutzerkonten erstellt werden, oder wenn Sie Probleme mit doppelten Konten beheben möchten, die während der Migration erstellt wurden, lesen Sie den Hilfeartikel Fehlerbehebung bei doppelten Looker-Konten nach einer Änderung der E‑Mail-Adresse.

Datenbankverbindungen

Looker (Google Cloud Core) unterstützt etwas andere Datenbankdialekte als Looker (Original). Alle Konfigurationseigenschaften für Datenbankverbindungen (einschließlich Verbindungsstring und Passwort, falls zutreffend) werden kopiert. Aufgrund der anderen Netzwerktopologie in Looker (Google Cloud Core) funktionieren die Datenbankverbindungen jedoch möglicherweise nicht sofort. Wenn beispielsweise über Firewalls oder Tunnel, die für die Looker-Instanz (Original) spezifisch sind, auf die Datenbanken zugegriffen wird, müssen Sie die Firewalls oder Tunnel möglicherweise neu konfigurieren. Sie sollten jede Verbindung testen und bei Bedarf neu herstellen.

Datenbankverbindungen mit OAuth

Bei der Migration von Looker (Original) zu Looker (Google Cloud Core) werden OAuth-Zugriffs- oder Aktualisierungstokens für die Datenbankverbindungen einzelner Nutzer zu BigQuery oder Snowflake nicht beibehalten. Nach der Migration werden Looker (Google Cloud Core)-Nutzer aufgefordert, sich noch einmal über OAuth zu authentifizieren, wenn sie ein Explore oder ein Dashboard aufrufen, das auf eine OAuth-Datenbankverbindung verweist. Nutzer können sich auch noch einmal bei ihren Datenbanken authentifizieren. Dazu rufen sie die Seite Konto auf und wählen unter der Überschrift OAuth-Anmeldedaten für die Verbindung für jede Datenbank Anmelden aus. Alle automatisierten Zeitpläne oder Benachrichtigungen, die einem einzelnen Nutzer gehören und auf eine OAuth-Verbindung verweisen, funktionieren erst wieder, wenn sich dieser Nutzer mit seinen OAuth-Anmeldedaten anmeldet.

Git-Repository-Verbindungen

Wenn die Instanz Bare-Git-Repositories verwendet, sollten diese ohne Änderungen funktionieren (kopiert, aber nicht freigegeben). Wenn die Instanz jedoch mit Remote-Repositories verbunden ist, müssen diese Verbindungen möglicherweise wie die Datenbankverbindungen überprüft und wieder aktiviert werden.

Sonstige Netzwerkkonfigurationen

Die Looker-Instanz kann andere Arten von Netzwerkverbindungen haben, sowohl eingehende als auch ausgehende (z. B. im Kontext von privaten Verbindungen, Action Hub, Marketplace, E‑Mail usw.). Diese Netzwerkverbindungen müssen ebenfalls verifiziert werden.

URL für den Zugriff auf die Looker (Google Cloud Core)-Instanz

Die Looker (Google Cloud Core)-Instanz hat eine primäre URL, die zufällig zugewiesen wird. Wenn auf die Instanz über eine bestimmte URL zugegriffen werden muss, können Sie eine benutzerdefinierte Domain konfigurieren.

Zeitpläne und Benachrichtigungen

Wenn sowohl die Looker (Original)- als auch die Looker (Google Cloud Core)-Instanz gleichzeitig aktiv sind, können sie doppelte geplante Aktionen und Benachrichtigungen generieren und doppelte Hintergrundvorgänge ausführen, die auf verbundene Datenbanken zugreifen. Diese Aktivitäten sollten so bald wie möglich in einer der Instanzen deaktiviert werden.

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

Wartungsfenster

Im Gegensatz zu Looker (Original) kann für Looker (Google Cloud Core) eine Wartungsrichtlinie angegeben werden.

Elite-Systemaktivität

Elite-Systemaktivitätsdaten werden im Rahmen der Migration nicht kopiert. Die Looker (Google Cloud Core)-Instanz wird mit einem neuen Verlauf gestartet.

Benutzerdefinierte Domain

Sie können eine benutzerdefinierte Domain für Ihre Looker (Google Cloud Core)-Instanz erstellen. Sie müssen die DNS-Einträge festlegen, um die Bereitstellung des SSL-Zertifikats zu ermöglichen. Außerdem müssen Sie die Callback-URL in Ihrem Authentifizierungsclient auf die benutzerdefinierte Domain aktualisieren, sobald Ihre benutzerdefinierte Domain aktiviert und Ihre Authentifizierungsmethode eingerichtet ist. Benutzerdefinierte Domains können für Looker (Google Cloud Core) nicht mit einer looker.com-Domain erstellt werden.

Wenn Sie eine benutzerdefinierte Domain für Ihre Looker (Google Cloud Core)-Instanz mit der benutzerdefinierten URL Ihrer Looker-Instanz (Original) erstellen möchten, sollten Sie die benutzerdefinierte Domain einrichten, nachdem die Migration abgeschlossen ist und Sie bestätigt haben, dass die Looker (Google Cloud Core)-Instanz einsatzbereit ist. Sobald die benutzerdefinierte Domain aktiviert ist, sehen Ihre Nutzer die Looker (Google Cloud Core)-Instanz und nicht die Looker (Original)-Instanz, wenn sie die Instanz-URL aufrufen.

Richten Sie SAML oder OpenID Connect für die Looker (Google Cloud Core)-Instanz erst ein, wenn die Instanz einsatzbereit ist, die DNS-Einträge aktualisiert wurden und die benutzerdefinierte Domain aktiviert wurde.

Lesezeichen

Wenn Sie in Ihrer Looker-Instanz (Original) eine benutzerdefinierte URL verwenden, die nicht die Domain looker.com verwendet, sollten die Lesezeichen der Nutzer bei der Migration beibehalten werden, wenn Sie für Ihre Looker-Instanz (Google Cloud Core) eine benutzerdefinierte Domain mit derselben URL wie für Ihre Looker-Instanz (Original) erstellen.

Sobald die benutzerdefinierte Domain aktiviert ist, verweisen Lesezeichen für Looker (Original)-Inhalte wie https://www.yourcustomdomain.com/dashboard/123 auf den entsprechenden Inhalt in der Looker (Google Cloud Core)-Instanz. (Hinweis: Die Enterprise- und Embed-Versionen von Looker (Google Cloud Core) verwenden in ihren URLs alphanumerische Content-Slugs anstelle von numerischen Content-IDs. Ein Lesezeichen mit einer Content-ID wird jedoch trotzdem korrekt zum selben Inhalt weitergeleitet.)

Dieser Prozess kann nicht mit Looker (Original)-URLs verwendet werden, die die Domain looker.com verwenden.

Diese Liste ist nicht vollständig. Testen Sie alle Aspekte der Instanz, die für Sie am wichtigsten sind, bevor Sie die Migration als abgeschlossen betrachten.

Sobald die Migration abgeschlossen ist und Sie sicher sind, dass Sie keinen weiteren Export benötigen, können Sie das zuvor erstellte <export-service-account> löschen. Dadurch wird der dafür freigegebene JSON-Schlüssel unbrauchbar.

Looker-Instanz (Original) außer Betrieb nehmen

Sobald die migrierte Looker (Google Cloud Core)-Instanz zufriedenstellend funktioniert, können Sie Ihren Nutzern die URL für die Instanz senden und sie anweisen, auf diese Instanz zuzugreifen und nicht mehr auf die Looker (Original)-Instanz.

Fehlerbehebung

Die folgenden Abschnitte können Ihnen bei der Behebung von Problemen während des Imports oder Exports helfen.

Probleme beim Export

Wenn beim Export Ihrer Looker-Daten (Original) ein Problem auftritt, wird auf der Seite Export im Admin-Bereich der Status FEHLER angezeigt. Wenn Sie auf den Status FEHLER klicken, wird eine Fehlermeldung angezeigt.

Häufige Fehlerquellen:

  • Der Cloud Storage-Bucket, der KMS-Schlüssel oder <export-service-account> ist ungültig.
  • <export-service-account> fehlen die erforderlichen Berechtigungen.

Es ist hilfreich, den Status dieser Objekte zu bestätigen, bevor Sie Ihre Exportanfrage senden.

Probleme beim Import

Wenn der Importvorgang nach vier Stunden (oder möglicherweise mehr, wenn die Quellinstanz sehr groß war) nicht abgeschlossen ist oder mit einem Fehler beendet wird, müssen Sie möglicherweise ein Ticket beim Cloud Customer Care eröffnen, um das Problem zu beheben. Für diesen Vorgang gibt es relativ wenige Diagnosen, die für Kunden direkt sichtbar sind.

Nächste Schritte