Migrieren von Arbeitsmappen und Datenquellen mit eingebetteten Anmeldeinformationen

Ab Version 2023.1 können autorisierte Benutzer Arbeitsmappen und veröffentlichte Datenquellen mit eingebetteten Anmeldeinformationen von Tableau Server zu Tableau Cloud oder zu einem anderen Tableau Server migrieren. Vor der Migration mit Content Migration Tool ist eine zusätzliche Konfiguration erforderlich.

Hinweis: Content Migration Tool unterstützt nicht die Migration eingebetteter Anmeldeinformationen für OAuth-Verbindungen. Weitere Informationen finden Sie unter Migrationseinschränkungen.

Übersicht

Die Migration eingebetteter Anmeldeinformationen mittels Content Migration Tool (CMT) ist verfügbar, wenn die Verbindung zu Tableau Server als Quellsite und Tableau Cloud oder Tableau Server als Zielsite hergestellt wird. Beides Sites müssen über eine Advanced Management-Lizenz verfügen.

Hinweis: Auch wenn Sie Arbeitsmappen und veröffentlichte Datenquellen von einem Tableau Server zu einem anderen migrieren können, konzentriert sich dieses Thema auf die Migration dieser Ressourcen von Tableau Server zu Tableau Cloud.

Nachdem wir nun die Anforderungen erläutert haben, möchten wir jetzt erklären, wie die Migration funktioniert. Sie müssen eng mit dem Tableau Cloud-Site-Administrator und TSM-Administrator (manchmal dieselbe Person) zusammenarbeiten, um das Feature zuzulassen und einen Site-Benutzer zu autorisieren. Nachdem die Funktion aktiviert wurde, erstellt der autorisierte Site-Benutzer einen Migrationsplan und wählt die Veröffentlichungsoptionen Migrate Embedded Credentials for Workbooks (Eingebettete Anmeldeinformationen für Arbeitsmappen migrieren) und Migrate Embedded Credentials for Data Sources (Eingebettete Anmeldeinformationen für Datenquellen migrieren).

Beim Ausführen des Migrationsplans werden alle erforderlichen Inhaltsanmeldeinformationen in einem verschlüsselten Inhaltsmanifest von Tableau Server zu Tableau Cloud übertragen. Wenn CMT Inhalte veröffentlicht, bettet die Tableau Cloud-Zielsite übereinstimmende Anmeldeinformationen sicher aus dem Manifest in den Inhalt (Arbeitsmappen oder veröffentlichte Datenquellen) ein. Etwaige Probleme während der Migration werden in CMT auf der Registerkarte "Fehler und Warnungen" angezeigt. Weitere Informationen finden Sie unter Übersicht über den Migrationsplan.

Zulassen der Migration eingebetteter Anmeldeinformationen

Führen Sie die folgenden Schritte aus, um die Migration eingebetteter Anmeldeinformationen von Tableau Server nach Tableau Cloud zuzulassen.

Tableau Cloud

  1. Öffnen Sie ein Browserfenster und melden Sie sich bei Tableau Cloud als Site-Administrator an.

  2. Wählen Sie Einstellungen > Allgemein, und scrollen Sie nach unten zu Inhaltsmigration verwalten.

  3. Klicken Sie auf Neuen Schlüssel erstellen, um ein Verschlüsselungs-Schlüsselpaar zu generieren.

    Anmerkung: Der öffentliche Schlüssel wird nur einmal angezeigt. Wenn Sie den Schlüssel verlieren, bevor Sie die Konfiguration abgeschlossen haben, müssen Sie einen neuen Schlüssel generieren.

  4. Klicken Sie im darauf folgenden Fenster auf In Zwischenablage kopieren, und schließen Sie dann das Fenster.

  5. Fügen Sie den öffentlichen Schlüssel in eine Datei ein und speichern Sie ihn an einem sicheren Ort. Der TSM-Administrator wird den öffentlichen Schlüssel verwenden, um die Migration zuzulassen. Das Ablaufdatum des öffentlichen Schlüssels wird auf der Seite "Einstellungen" angezeigt.

TSM-Befehlszeilenschnittstelle

  1. Öffnen Sie eine Eingabeaufforderung mit einem Konto, das Mitglied der Gruppe tsmadmin auf einem Knoten im Cluster ist.

  2. Verwenden Sie tsm security authorize-credential-migration, um die Migration eingebetteter Anmeldeinformationen zur Tableau Cloud-Site zu ermöglichen. Weitere Informationen finden Sie unter tsm security.

    tsm security authorize-credential-migration --source-site-url-namespace <Tableau Server site ID> --destination-site-url-namespace <Tableau Cloud site ID> --destination-server-url <Tableau Cloud site url> --authorized-migration-runner <username> --destination-public-encryption-key <public key>

    Anmerkung: Verwenden Sie tsm login beim Ausführen von TSM-Befehlen über einen Remote-Knoten, um vor der Ausführung von tsm security authorize-credential-migration eine Sitzung mit dem Tableau Server Administration Controller-Dienst zu authentifizieren.

  3. (Optional) Verwenden Sie tsm security cancel-credential-migrations, um erteilte Autorisierungen wieder zu entziehen. Standardmäßig läuft die Migrationsautorisierung nach 7 Tagen oder nach der Anzahl von Tagen ab, die mit der Option --expiration-time-in-days festgelegt wird.

Content Migration Tool

  1. Öffnen Sie Content Migration Tool und wählen Sie Create New Plan (Neuen Plan erstellen) oder Browse for a Plan (Plan suchen).

  2. Klicken Sie auf der Sites-Seite auf Bei Tableau anmelden, und stellen Sie eine Verbindung mit Tableau Server als Quelle und mit Tableau Cloud als Ziel her. Die Migration eingebetteter Anmeldeinformationen ist nur bei der Migration von Tableau Server zu Tableau Cloud verfügbar.

  3. Erstellen Sie einen Migrationsplan und wählen Sie die folgenden Veröffentlichungsoptionen aus:

    • Wählen Sie auf der Seite "Workbook Publish Options" (Veröffentlichungsoptionen für Arbeitsmappen) die Option Migrate Embedded Credentials for Workbooks (Eingebettete Anmeldeinformationen für Arbeitsmappen migrieren). Weitere Informationen finden Sie unter Migrationspläne: Arbeitsmappen.

    • Wählen Sie auf der Seite "Data Source Publish Options" (Datenquellen-Veröffentlichungsoptionen) Migrate Embedded Credentials for Data Sources (Eingebettete Anmeldeinformationen für Datenquellen migrieren) aus . Weitere Informationen finden Sie unter Migrationspläne: Veröffentlichte Datenquellen.
  4. Wenn Sie fertig sind, klicken Sie auf Verify & Run (Verifizieren & Ausführen), um die Migration zu starten.

Die ausgewählten Arbeitsmappen und veröffentlichten Datenquellen werden zu Ihrer Tableau Cloud-Site migriert und sollten nicht zur Authentifizierung auffordern. Wenn beim Migrieren eingebetteter Anmeldeinformationen Probleme auftreten, lesen Sie weiter unter Problembehebung.

Problembehebung

Dieser Abschnitt enthält einige häufig auftretende Migrationsprobleme und Vorschläge zu deren Lösung.

Es gibt keine Option zum Migrieren eingebetteter Anmeldeinformationen

Sie können nur eingebettete Anmeldeinformationen von einer Tableau Server-Site zu einer Tableau Cloud-Site migrieren. Auf Tableau Server und Content Migration Tool müssen die Versionen 2023.1 oder höher ausgeführt werden. Weitere Informationen finden Sie unter Installieren von Content Migration Tool von Tableau.

Die Migration eingebetteter Anmeldeinformationen ist fehlgeschlagen

In der Registerkarte Fehler und Warnungen von CMT erhalten Sie möglicherweise eine Fehlermeldung, die darauf hinweist, dass die Migration der eingebetteten Anmeldeinformationen fehlgeschlagen ist. Dies kann auftreten, wenn der öffentliche Schlüssel, der zum Autorisieren der Migration verwendet wurde, abgelaufen ist.

Gehen Sie als Tableau Cloud-Site-Administrator zur Seite "Einstellungen" und vergewissern Sie sich, dass der öffentliche Schlüssel gültig ist. Wenn seine Gültigkeit bereits abgelaufen ist, müssen Sie ein neues Verschlüsselungspaar erstellen, um die Migration zu autorisieren. Weitere Informationen finden Sie unter Zulassen der Migration eingebetteter Anmeldeinformationen.

Wer kann dies tun?

  • Die Migration eingebetteter Anmeldeinformationen muss von einem Tableau Cloud-Site-Administrator und TSM-Administrator durchgeführt werden.

  • Autorisierte Site-Benutzer benötigen eine Explorer-Rolle oder höher. Sie müssen auch über die Berechtigungen zum Anzeigen und Herunterladen/Speichern einer Kopie für Arbeitsmappen auf der Quellsite sowie über Funktionen zum Anzeigen und Veröffentlichen für Zielprojekte auf der Zielsite verfügen.

Weitere Informationen finden Sie unter Berechtigungen.

Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.