Bereiten Sie die Ausführung des Tableau-Sammlers vor

Richten Sie den API-Zugriff, die Authentifizierung und die Berechtigungen ein, bevor Sie den Sammler ausführen.

Vorbereitungen

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Der Sammler verwendet die Tableau-Metadaten-API, um Metadaten zu sammeln. Sie müssen die API aktivieren (für Tableau-Server), Anwenderberechtigungen konfigurieren und eine Authentifizierungsmethode auswählen. Konfigurieren Sie optional die Hostnamenzuordnung für Datenbankaliasse.

Prozedur

1. Aktivieren Sie die Metadaten-API auf Tableau-Server.

   Weitere Informationen finden Sie unter Aktivieren Sie die Tableau-Metadaten-API.

   Hinweis:

   Die Metadaten-API ist standardmäßig für Tableau Cloud aktiviert. Dieser Schritt gilt nur für Tableau-Server.
2. Konfigurieren Sie Anwenderberechtigungen, und erstellen Sie ein persönliches Zugriffstoken.

   Weitere Informationen finden Sie unter Konfigurieren Sie Tableau-Anwenderberechtigungen.

3. Wahlweise: Konfigurieren Sie die JWT-Authentifizierung mit einer verbundenen App.

   Weitere Informationen finden Sie unter Konfigurieren Sie die Tableau-JWT-Authentifizierung.

4. Wahlweise: Konfigurieren Sie die Hostnamenzuordnung für Datenbankaliasse.

   Weitere Informationen finden Sie unter Richten Sie eine YAML-Datei für die Hostnamenzuordnung ein.

Aktivieren Sie die Tableau-Metadaten-API

Aktivieren Sie die Metadaten-API auf Tableau Server, um die Metadatensammlung zuzulassen.

Vorbereitungen

Erforderliche Rolle: Administrator

Sie müssen Folgendes haben:

• Tableau Server 2019,3 oder höher
• Account mit Serveradministratorrolle im Tableau-Server
• REST API aktiviert (nicht deaktiviert)

Hinweis:

Die Metadaten-API ist standardmäßig für Tableau Cloud aktiviert. Dieses Verfahren gilt nur für Tableau-Server.

Warum und wann dieser Vorgang ausgeführt wird

Der Tableau-Sammler verwendet die Metadaten-API, um Metadaten vom Tableau-Server zu sammeln. Standardmäßig ist diese API auf Tableau-Server deaktiviert und muss über die Befehlszeilenschnittstelle des Tableau-Servicemanagers (TSM) aktiviert werden.

Prozedur

1. Öffnen Sie eine Eingabeaufforderung als Administrator auf dem anfänglichen Knoten, auf dem Tableau Services Manager (TSM) im Cluster installiert ist.
2. Führen Sie den folgenden Befehl aus, um die Metadaten-API zu aktivieren.

   tsm maintenance metadata-services enable

3. Aktivieren Sie abgeleitete Berechtigungen, wenn Sie nicht über die Datenverwaltungslizenz verfügen.

   Mit abgeleiteten Berechtigungen können Sie zugehörige externe Assets anzeigen. Detaillierte Anweisungen finden Sie unter Tableau-Dokumentation .

Ergebnisse

Die Metadaten-API ist jetzt auf Tableau Server aktiviert und bereit für die Metadatensammlung.

Konfigurieren Sie Tableau-Anwenderberechtigungen

Erstellen Sie einen Tableau-Anwender mit Administratorberechtigungen, und generieren Sie ein persönliches Zugriffstoken.

Vorbereitungen

Erforderliche Rolle: Administrator

Sie müssen über Berechtigungen zum Erstellen von Anwendern und Zuweisen von Rollen in Tableau Server oder Tableau Cloud verfügen.

Warum und wann dieser Vorgang ausgeführt wird

Der Tableau-Sammler erfordert einen Anwenderaccount mit Administratorrechten für den Zugriff auf und das Sammeln von Metadaten. Erstellen Sie einen dedizierten Anwenderaccount, und generieren Sie ein persönliches Zugriffstoken (PAT) für die Authentifizierung.

Prozedur

1. Erstellen Sie einen neuen Anwender in Tableau mit Administratorberechtigungen.
   • Weisen Sie für Tableau-Server die Serveradministratorrolle zu. Siehe Tableau-Dokumentation Für Details
   • Weisen Sie für Tableau Cloud die Rolle „Websiteadministrator“ zu. Siehe Tableau-Dokumentation Für Details
2. Erstellen Sie ein persönliches Zugriffstoken (PAT) für den Anwender.

   Detaillierte Anweisungen zum Erstellen einer PAT finden Sie unter Tableau-Dokumentation .

3. Speichern Sie das persönliche Zugriffstoken sicher.

   Sie benötigen dieses Token, wenn Sie den Tableau-Metadatensammler konfigurieren.

Konfigurieren Sie die Tableau-JWT-Authentifizierung

Richten Sie eine verbundene App in Tableau für die JWT-Authentifizierung ein

Vorbereitungen

Erforderliche Rolle: Administrator

Sie müssen über Berechtigungen zum Erstellen und Verwalten verbundener Apps in Tableau verfügen.

Wichtig:

Die APIs zum Abrufen von Arbeitsmappen- und Datenquellenüberarbeitungen werden von der JWT-Authentifizierung nicht unterstützt.

Warum und wann dieser Vorgang ausgeführt wird

Konfigurieren Sie eine verbundene App zur Verwendung der JWT-Authentifizierung (JSON-Webtoken) mit dem Tableau-Sammler. Die verbundene App stellt die Client-ID, die geheime ID und den geheimen Wert bereit, die zum Generieren von JWT-Token erforderlich sind.

Prozedur

1. Melden Sie sich bei der Tableau-Instanz an.
2. Navigieren Sie zu Einstellungen .
3. Erstellen Sie eine verbundene App.

   Detaillierte Anweisungen finden Sie unter Tableau-Dokumentation .

4. Aktivieren Sie die verbundene App.
5. Generieren Sie ein Geheimnis in der verbundenen App.
6. Speichern Sie die Anmeldeinformationen der verbundenen App.

   Zeichnen Sie die folgenden Werte auf, die bei der Konfiguration des Tableau-Sammlers verwendet werden sollen:

   • Client-ID
   • Geheime ID
   • Geheimer Wert

   Diese Anmeldeinformationen werden verwendet, um JWT-Token für die Authentifizierung zu generieren.

Richten Sie eine YAML-Datei für die Hostnamenzuordnung ein

Erstellen Sie eine YAML-Datei, um Datenbank-Hostnamen-Aliasse kanonischen Namen zuzuordnen.

Vorbereitungen

Erforderliche Rolle: Administrator

Warum und wann dieser Vorgang ausgeführt wird

Verwenden Sie eine Hostnamenzuordnungsdatei, wenn Sie mehrere Servernamen (Aliasse) für dieselbe Datenbankinstanz haben und der Datenbanksammler einen anderen Alias verwendet als den in der Tableau-Verbindung definierten. Diese optionale Konfiguration ordnet Datenbank-Hostnamen kanonischen Namen zu, um eine konsistente IRI-Coining zu ermöglichen.

Prozedur

1. Erstellen Sie eine YAML-Datei mit dem Namen hostnames.yml.
2. Fügen Sie der Datei Hostnamenzuordnungseinträge hinzu.

   Verwenden Sie das folgende Format:

   mappingValues:
                           - originalHostname: "<Original_HostName>"
                           canonicalHostname: "<canonical_HostName>"

   Beispiel: Wenn Ihre Tableau-Quelle db-server-01.company.local verwendet, Sie jedoch db.company.com als Hostname während der Ire-Coining des Datenbankobjekts verwenden möchten:

   mappingValues:
                           - originalHostname: "db-server-01.company.local"
                           canonicalHostname: "db.company.com"

   Hinweis:

   Sie können Umgebungsvariablen in der Datei für vertrauliche Informationen wie Passwörter verwenden.
3. Speichern Sie die Datei hostnames.yml.
4. Übergeben Sie die YAML-Datei mithilfe der Option „Hostnamen-Zuordnungsdatei“ an den Sammler.

   Verwenden Sie die Option „Hostnamen-Zuordnungsdatei“, wenn Sie den Sammler ausführen, um die Datei „hostnames.yml“ hochzuladen.

Ergebnisse

Der Sammler verwendet beim Prägen von Datenbankobjekt-Iris den kanonischen Hostnamen anstelle des ursprünglichen Hostnamens.