Webdaten-Connectors in Tableau Server

Webdaten-Connectors (WDCs) sind Webseiten, mit denen Sie eine über HTTP zugängliche Datenverbindung für Datenquellen herstellen können, für die es in Tableau noch keinen Connector gibt. Mit WDCs können Benutzer Verbindungen zu praktisch allen Daten herstellen, die über das Internet zugänglich sind, und Extrakte für ihre Arbeitsmappen erstellen. Mögliche Datenquellen für einen WDC sind interne Webservices, JSON-Daten, REST-APIs und weitere über HTTP oder HTTPS zugängliche Quellen. Benutzer haben die Möglichkeit, ihren eigenen WDC zu erstellen oder von anderen erstellte Connectoren zu verwenden.

Für Informationen zur Verwendung von WDCs in Tableau Desktop, siehe Webdaten-Connector(Link wird in neuem Fenster geöffnet) in der Dokumentation zu Tableau Desktop.

Informationen zum Erstellen von WDCs finden Sie in der Dokumentation zum Webdaten-Connector auf Github.

Vor der Ausführung von Connectors in Tableau Server

Als Sicherheitsmaßnahme führt Tableau Server WDCs erst aus, wenn Sie die Connectors wie in diesem Thema erläutert zugelassen haben.

Hinweis: Sie müssen ein Serveradministrator sein, um WDCs für die Verwendung in Tableau Server zulassen zu können.

WDCs müssen von Ihnen zugelassen werden, da sie einen ausführbaren Code beinhalten und üblicherweise dazu dienen, Anforderungen an Drittanbieter-Websites zu senden. Bevor ein Benutzer einen WDC mit Tableau Server verwenden kann, müssen Sie die vom Connector verwendete Domäne und den Port zu einer Sicherheitsliste hinzufügen und auch die Domäne angeben, an die ein Connector Anfragen senden und empfangen kann, die auf einer sekundären Sicherheitsliste stehen. Bevor Sie dies tun, empfehlen wir, den Connector zu prüfen und zu testen, um zu ermitteln, was der Connector tut und zu welchen Websites er Verbindungen herstellt. Weitere Informationen finden Sie im Abschnitt Testen und Prüfen von Webdaten-Connectoren.

Wenn Sie einer Positivliste einen Connector hinzufügen, konfigurieren Sie Tableau Server so, dass Verbindungen zu einer bestimmten URL, auf der der Connector gehostet ist, und von einer URL erlaubt werden, die der Connector abfragen kann. Dies ist die einzige Möglichkeit, um die Ausführung von WDCs in Tableau Server zuzulassen. Die Connectors können dann auf einem Server innerhalb der Firewall Ihrer Organisation oder in einer externen Domäne gehostet werden. Der WDC-Import wird für Tableau Server nicht unterstützt.

Verwalten von Connectors in einer Positivliste

Verwenden Sie den Befehl tsm data-access web-data-connectors add zum Hinzufügen eines WDC zur sicheren Liste. Mithilfe dieses Befehls und der zugehörigen Befehle, die nachstehend beschrieben werden, können Sie die folgenden Aufgaben ausführen:

  • Hinzufügen von WDCs zur sicheren Liste und zur sekundären sicheren Liste

  • Zulassen oder Verbieten aller WDCs oder WDC-Aktualisierungen

  • Entfernen eines oder mehrerer Connectors aus der sicheren Liste

  • Auflisten aller WDCs in der sicheren Liste und sekundären sicheren Liste

Für die Aktualisierung der sicheren Liste für WDCs ist ein Serverneustart erforderlich.

Nachdem Sie beliebige Befehle ausgeführt haben, die Änderungen an WDCs vornehmen, müssen Sie die ausstehenden Änderungen mithilfe des Befehls tsm pending-changes apply anwenden.

Wenn die ausstehenden Änderungen einen Neustart des Servers erfordern, zeigt der Befehl pending-changes apply eine Meldung an, um Sie darüber zu informieren, dass ein Neustart stattfinden wird. Diese Meldung wird auch angezeigt, wenn der Server angehalten ist. In diesem Fall erfolgt jedoch kein Neustart. Sie können diese Meldung mithilfe der Option --ignore-prompt unterdrücken, dies ändert jedoch nichts an dem Neustartverhalten. Wenn die Änderungen keinen Neustart erfordern, werden die Änderungen ohne Meldung angewendet. Weitere Informationen finden Sie unter tsm pending-changes apply.

Connectors zur Positivliste und zur sekundären Positivliste hinzufügen

Verwenden Sie zum Hinzufügen eines Connectors zu einer sicheren Liste und sekundären sicheren Liste den Befehl tsm data-access web-data-connectors add und geben Sie den Namen, die URL der sicheren Liste und die URLs der sekundären sicheren Liste an. WDCs können auch mithilfe der Entität web-data-connector-settings-Entität verwaltet werden. Nach dem Ausführen dieses Befehls müssen Sie Ihre ausstehenden Änderungen mit dem Befehl tsm pending-changes apply anwenden. Sie werden durch eine Meldung darüber informiert, dass durch diesen Befehl Tableau Server neu gestartet wird. Falls Tableau Server derzeit ausgeführt wird, wird die Anwendung neu gestartet. Ist sie angehalten, wird sie in diesem Zustand gelassen und nicht neu gestartet.

tsm data-access web-data-connectors add --name "USGS Earthquakes" --url https://tableau.github.io:443/webdataconnector/Examples/html/earthquakeUSGS.html --secondary https://tableau.github.io/.*,https://earthquake.usgs.gov/.*,https://maxcdn.bootstrapcdn.com/.*,https://ajax.googleapis.com/.*,https://connectors.tableau.com/.*

 

Hinweise zur Formatierung:

  • Verwenden Sie zum Einschließen des WDC-Namens gerade Anführungszeichen (" und '), aber keine geschwungenen oder "intelligenten" Anführungszeichen. Verwenden Sie doppelte Anführungszeichen ("), wenn der Name ein Leerzeichen enthält.
  • Für viele WDCs lautet die Portangabe für die Option --url 443 oder 80. Sie können jedoch den Wert für Ihren Connector überprüfen, indem Sie sich die Datenquellendetails in Tableau Server ansehen. Sie müssen die Portnummer als Teil der URL angeben, wenn der WDC SSL (HTTPS) verwendet. Um beispielsweise den Standardport für HTTPS zu verwenden, kann die URL wie folgt aussehen: https://example.com:443/WDC/.
  • Für die Option --secondary muss eine URL oder eine kommagetrennte Liste von URLs angegeben werden, die die Domänen angibt, in der die Bibliotheken und Quellen bereitstellt sind, auf die der WDC zugreifen muss. Diese Option kann nicht weggelassen oder leer gelassen werden, es sei denn, der WDC verwendet keine sekundären Domänen. Wenn Sie nicht wissen, ob der WDC sekundäre Domänen verwendet oder wie die sekundären Domänen lauten, müssen Sie sich möglicherweise an den Entwickler des WDC wenden. Sie können sich auch entscheiden, Platzhalter-URLs (http://.* und https://.*) zu verwenden, um sämtliche Domänen zuzulassen. Wir empfehlen jedoch dringend, spezifischere URLs zu verwenden, um die Sicherheit zu erhöhen.
  • Wenn Sie eine gesamte Domäne zu der sekundären sicheren Liste hinzufügen möchten, setzen Sie ein Platzhalterzeichen an das Ende der Domänen-URL. Verwenden Sie .* als Platzhalter, um die gesamte Domäne anzugeben, wie im folgenden Beispiel: https://example.com/.*.

Zulassen oder Verbieten von WDCs oder WDC-Extraktaktualisierungen

Wenn Sie WDCs oder WDC-Extraktaktualisierungen zulassen oder verbieten möchten, nutzen Sie den Befehl tsm data-access web-data-connectors allow mit den Optionen -t oder -r. Standardmäßig sind WDCs und WDC-Extraktaktualisierungen zulässig. Wenn Sie diese Einstellung ändern möchten, führen Sie den Befehl tsm pending-changes apply aus. Weitere Informationen zum Ausführen des Befehls und den Befehlsoptionen finden Sie unter tsm data-access web-data-connectors allow.

Entfernen eines oder mehrerer WDCs aus der sicheren Liste

Wenn Sie einen oder mehrere WDCs aus der sicheren Liste entfernen möchten, verwenden Sie den Befehl tsm data-access web-data-connectors delete. Wenn Sie diese Einstellung ändern möchten, führen Sie den Befehl tsm pending-changes apply aus. Weitere Informationen finden Sie unter tsm data-access web-data-connectors delete.

Auflisten aller WDCs in der sicheren Liste

Wenn Sie alle WDCs in der sicheren Liste aufführen möchten, nutzen Sie den Befehl tsm data-access web-data-connectors list. Weitere Informationen finden Sie unter: tsm data-access web-data-connectors list.

Aktualisieren eines Extrakts für einen Connector

Wenn ein Benutzer eine Arbeitsmappe erstellt, die einen WDC verwendet, erstellt Tableau Server einen Extrakt anhand der vom Connector zurückgegebenen Daten. Veröffentlicht der Benutzer dann die Arbeitsmappe, werden die Arbeitsmappe und der Datenextrakt während des Veröffentlichungsvorgangs an den Server gesendet.

Tableau kann einen von einem WDC erstellten Extrakt genauso wie alle anderen Extrakte aktualisieren. Wenn für die Anmeldung bei der webbasierten Datenquelle für den Connector Anmeldeinformationen angegeben werden müssen, müssen Sie sicherstellen, dass die Anmeldeinformationen in der Datenquelle eingebettet werden und dass sich der WDC in der sicheren Liste für den Server befindet. Tableau Server kann den Extrakt nicht aktualisieren, wenn der Connector Anmeldeinformationen anfordert und sie nicht in der Datenquelle eingebettet sind. Dies ist darauf zurückzuführen, dass die Aktualisierung geplant oder im Hintergrund erfolgen kann, sodass der Server nicht nach Anmeldeinformationen fragen kann.

Derzeit ist es nicht möglich, eine Datenquelle direkt in Tableau Server erneut zu authentifizieren. Wenn die Datenquelle ablaufende Anmeldeinformationen aufweist oder ohne Einbetten der Anmeldeinformationen veröffentlicht wurde, müssen die Arbeitsmappe und der Datenextrakt mit den neuen eingebetteten Anmeldeinformationen erneut veröffentlicht werden.

Schlägt der Hintergrundprozess zur Aktualisierung fehl, werden eine Warnung und ein Protokolleintrag erstellt, die auf dieses Problem hinweisen. Benutzer können sehen, dass sich der Zeitstempel des Extrakts nicht ändert.

Verwenden Sie den Befehl tsm data-access web-data-connectors allow -r false, um die Aktualisierung für alle WDCs zu deaktivieren.

Problembehebung

Falls der Server Probleme beim Hinzufügen von Connectors zur sicheren Liste hat, können Sie die Protokolldateien untersuchen. Überprüfen Sie die Protokolldateien auf dem ursprünglichen Serverknoten und auf den anderen Knoten, auf denen der Gateway-Prozess ausgeführt wird. Weitere Informationen zu Protokolldateien finden Sie unter Speicherorte der Tableau Server-Protokolle und -Protokolldateien.

Falls das Problem darin besteht, dass Tableau Server einen von einem WDC erstellten Extrakt nicht aktualisiert, vergewissern Sie sich, dass die Konfigurationseinstellung webdataconnector.refresh.enabled auf true festgelegt wurde. Wenn Sie auf false festgelegt ist, führen Sie den folgenden Befehl aus, um Extraktaktualisierungen für alle WDCs auf dem Server zuzulassen:

tsm data-access web-data-connectors allow -r true

Hinweis: Die sichere Liste ist die einzige Möglichkeit, Tableau Server zu gestatten, Webdaten-Connectors auszuführen. Das Importieren von Webdaten-Connectors gilt ab Version 10.5 als veraltet.

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