Bereitstellen von Data Connect

Anwendungsbereich: Tableau Cloud

Bevor Sie Data Connect in Ihrer Organisation bereitstellen, überprüfen Sie, dass Sie die folgenden Voraussetzungen erfüllt haben:

Schritt 1: Einrichten Ihres Clusters

Überprüfen Sie die folgende Konnektivität und den folgenden Zugriff:

  • Data Connect-Infrastruktur, -Cluster und -Container erfordern Netzwerkzugriff auf die Orchestrierungsanbieterdienste (Nr. 2 im Bild oben) und auf Tableau Cloud (nur ausgehend, Nr. 5).

  • Data Connect-Infrastruktur, Cluster, Container und Agent erfordern Netzwerkzugriff auf Ihre Datenbank (#6).

Siehe Netzwerkspezifikationen.

Bereitstellen und Konfigurieren

Führen Sie die folgenden Schritte in Ihrem Unternehmen auf jedem Computer aus, auf dem Sie den Kubernetes-Cluster ausführen möchten.

  1. Stellen Sie sicher, dass Ihr sekundäres Volume nicht formatiert ist. Führen Sie auf dem Linux-Knoten den folgenden Befehl aus:

    lsblk -f

    Das folgende Bild zeigt ein Beispiel, in dem das zusätzliche Volume nvme1n1 auf einem Clusterknoten unformatiert ist und der FSTYPE leer ist:

  2. Klicken Sie auf der Registerkarte „Data Connect“ unter „Pools“ auf Neuer Pool. Geben Sie im Fenster „Neuer Pool“ einen Poolnamen ein, und klicken Sie dann auf Erstellen.

  3. Klicken Sie auf der Registerkarte „Data Connect“ unter „Cluster und Knoten“ auf Neuer Cluster. Geben Sie im Fenster „Neuer Cluster“ einen Clusternamen ein, und klicken Sie dann auf Erstellen.

  4. Klicken Sie auf dem Cluster, den Sie soeben erstellt haben, auf die Spalte Aktionen und klicken Sie dann auf Neuer Knoten. Klicken Sie im Fenster „Neuen Knoten hinzufügen“ auf Datei herunterladen.

    Eine Datei cluster.tar wird in den Download-Ordner heruntergeladen. Diese Datei enthält die Bootstrapping-Skripte, die Sie auf dem Knoten ausführen werden.

  5. Speichern Sie die cluster.tar-Datei auf Ihrem Computer. Das folgende Beispiel zeigt, wie Sie die TAR-Datei kopieren, die Dateien extrahieren, das Skript in eine ausführbare Datei ändern und dann das Skript ausführen. Das Beispiel zeigt dies im Kontext von AWS. Ändern Sie die Dateipfade für eine Umgebung.

    Führen Sie die folgenden Befehle als Root- oder Sudo-Benutzer aus, und ersetzen Sie dabei <key-name> und <IP-address> mit Ihren Werten:

    > scp -i <key-name>.pem /Downloads/cluster.tar ec2-user@ip-<IP-address>.us-west-2compute.internal:~/

    > ssh -i <key-name>.pem ex2-user@ip-<IP-address>.us-west-2compute.internal

    > tar -xvf clustertar.tar

    > chmod +x onboard_node.sh preflight_check.sh

    > ./onboard_node.sh

    Nach Ausführung des Skriptes wird im Terminalfenster die Meldung Successfully performed all operations (Alle Vorgänge erfolgreich durchgeführt) angezeigt, und das Tableau-Team wird mit dem Bereitstellungsprozess beginnen.

    Sollte ein Fehler auftreten, überprüfen Sie, ob Ihre Bereitstellung die Mindestanforderungen an die Hardware und die Netzwerkspezifikationen erfüllt, die in Planen Ihrer Data Connect-Bereitstellung beschrieben sind.

  6. Suchen Sie auf der Registerkarte „Data Connect“ für Ihre Site den Pool, den Sie in Schritt 2 erstellt haben. Klicken Sie unter der Spalte „Aktionen“ auf Cluster zuweisen und wählen Sie dann den Cluster aus, den Sie in Schritt 3 erstellt haben.

  7. Klicken Sie auf den nach unten weisenden Winkel (⌄), um den Hostnamen und die verfügbaren Aktionen einzublenden. Wenn diese Informationen nicht angezeigt werden, müssen Sie die Seite möglicherweise neu laden. Nachdem Sie bestätigt haben, dass der Hostname der Zielknoten ist, klicken Sie auf Knoten akzeptieren und dann auf Bestätigen.

    Der Clusterknoten wechselt dann in den Status „Bereitstellung“. Die Bereitstellung des Knotens kann eine Stunde oder länger dauern.

  8. Wenn der Status Ihres Knotens zu „Verfügbar“ wechselt, navigieren Sie zu dem Pool, dem Sie den Cluster zugewiesen haben, klicken Sie auf die Aktionsschaltfläche (...) und klicken Sie dann auf Token aktualisieren. Stellen Sie sicher, dass Sie die Token für den richtigen Pool aktualisieren, und klicken Sie dann auf Bestätigen.

  9. Warten Sie, bis die Tokenaktualisierung abgeschlossen ist. Nach Abschluss wird der Poolstatus auf „Verfügbar“ gesetzt. Navigieren Sie zurück zu dem Cluster und klicken Sie auf den Winkel (⌄), um den Abschnitt mit dem Clusternamen auszublenden. Klicken Sie auf die Aktionsschaltfläche für den Cluster (...), und klicken Sie dann auf Container-Registry-Informationen abrufen.

    • Wenn bei diesem Schritt eine Fehlermeldung angezeigt wird, ist die Registrierung noch nicht bereitgestellt, und der Bereitstellungsprozess muss möglicherweise noch fertiggestellt werden. Warten Sie ein paar Minuten, und versuchen Sie es dann noch einmal.
    • Wenn die Registrierungsinformationen (Servername, Benutzername und Kennwort) angezeigt werden, kopieren Sie diese Informationen für den nächsten Schritt.

Schritt 2: Erstellen und Veröffentlichen Ihres Basis-Images

In diesem Schritt werden Sie Ihr Basis-Image mit den Treibern erstellen und das Image dann in Ihrer Docker-Container-Registrierung veröffentlichen. Bevor Sie beginnen:

  • Vergewissern Sie sich, dass Sie die Registrierungsinformationen für Ihren Docker-Container aus dem vorherigen Schritt zur Hand haben.

  • Jeder Pool kann über sein eigenes, einzigartiges Basis-Image und seinen eigenen Treibersatz verfügen.

  • Wenn Sie eine Verbindung mithilfe einer TDC-Datei herstellen möchten, müssen Sie diese Datei in Ihr Basis-Image aufnehmen. Der Systembenutzer, tableau, muss Lesezugriff auf diese Datei haben. Weitere Informationen zum Erstellen und Speichern dieser Datei finden Sie im Tableau Desktop-Hilfethema Anpassen und Optimieren einer Verbindung(Link wird in neuem Fenster geöffnet).

Erstellen des Containers

Das folgende Verfahren zeigt ein Beispiel für eine RHEL-Distribution. Möglicherweise müssen Sie Paketmanager-Tools oder andere Tools installieren, die speziell für Ihre Distribution ausgelegt sind.

  1. Melden Sie sich bei einem beliebigen Knoten in Ihrem Kubernetes-Cluster an. Installieren Sie Docker und unterstützende Tools, wie erforderlich:

    #RedHat
sudo dnf install -y container-tools podman-docker
#Ubuntu
sudo apt-get update -y
sudo apt-get install -y docker.io

  2. Erstellen Sie die Docker-Datei:

    touch Dockerfile

  3. Aktualisieren Sie die Docker-Datei so, dass sie die Treiber zur Unterstützung Ihrer Verbindungen enthält. Die in dieser Docker-Datei angegebenen Befehle werden zum Zeitpunkt der Erstellung für Ihr Basis-Image ausgeführt. Beispiel:

    # example base 
FROM registry.access.redhat.com/ubi8
RUN yum -y update
WORKDIR /
# Go to https://tableau.com/support/drivers
# Follow the instructions to install your drivers for linux
CMD [“/bin/bash”]

    Das Zielverzeichnis für Treiberdateien kann variieren. Weitere Einzelheiten dazu finden Sie unter Treiber herunterladen(Link wird in neuem Fenster geöffnet).

    Hinweis: Data Connect unterstützt Exchange-Connectoren, die über einen Linux-Treiber verfügen und mit „Funktioniert mit Tableau Cloud über Bridge” gekennzeichnet sind. Weitere Informationen finden Sie unter Tableau-Exchange-Connectoren(Link wird in neuem Fenster geöffnet).

    Nachfolgend sehen Sie ein Beispiel für Zeilen in der Docker-Datei für einen öffentlichen JDBC-Treiber, wobei der Treiber mithilfe eines „curl“-Befehls heruntergeladen wird:

    RUN mkdir -p /opt/tableau/tableau_driver/jdbc
RUN curl --location --output /opt/tableau/tableau_driver/jdbc/<file> <URL>

    Nachfolgend sehen Sie ein Beispiel für Zeilen in der Docker-Datei für einen nicht-öffentlichen JDBC-Treiber, wobei der „copy“-Befehl verwendet wird:

    RUN mkdir -p /opt/tableau/tableau_driver/jdbc
COPY  <file> /opt/tableau/tableau_driver/jdbc

    Nachfolgend sehen Sie ein Beispiel für Zeilen in der Docker-Datei für einen Taco-Treiber, wobei der „copy“-Befehl verwendet wird:

    RUN mkdir -p /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors
COPY  <file> /home/tableau/Documents/My_Tableau_Bridge_Repository/Connectors

  4. Legen Sie, während Sie noch bei Ihrem Kubernetes-Clusterknoten angemeldet sind, die Variable POOL_ID mit dem Wert Ihrer Pool-ID fest. Um den Pool-ID-Wert anzuzeigen, öffnen Sie die Registerkarte „Data Connect“, und klicken Sie auf den Namen des Pools.

    • Legen Sie die Werte in der Registrierung, die Sie kopiert haben, auf die entsprechenden Werte fest.

      REGISTRY_HOSTNAME=registry_host_name_you_copied
REGISTRY_USERNAME=registry_user_name_you_copied
REGISTRY_PASSWORD=registry_password_you_copied

    • Legen Sie den Pool-ID-Wert fest:

      POOL_ID=<pool_id_value>

  5. Erstellen Sie den Container, der als Basis-Image verwendet wird.

    docker build -f <path_to_dockerfile> -t $REGISTRY_HOSTNAME/bridge-base:$POOL_ID .

  6. Melden Sie sich bei Ihrem vorhandenen Kubernetes-Knoten an, und übertragen Sie das Image per Push in die lokale Containerregistrierung.

    docker login --username $REGISTRY_USERNAME $REGISTRY_HOSTNAME
docker push $REGISTRY_HOSTNAME/bridge-base:$POOL_ID

  7. Klicken Sie unter dem Pool, den Sie konfigurieren, auf die Aktionsschaltfläche (...) und klicken Sie dann auf Basis-Image aktualisieren. Diese Aktion veranlasst eine Bereitstellung unter Verwendung des Basis-Images, was bis zu zehn Minuten dauern kann.

    Hinweis: Jedes Mal, wenn ein neues Basis-Image erstellt und aktualisiert wird, wird eine neue Bereitstellung erstellt. Der für das vorherige Basis-Image verwendete Bridge-Agent verbleibt als ein nicht zugewiesenes Asset. Löschen Sie keine Bridge-Agenten, die nicht zugewiesen sind.

Schritt 3: Zuordnen einer Domäne zu einem Pool

Die Domänennamen, die Sie in der Zulassungsliste angeben, sind die Servernamen, die für die Datenquellenverbindung verwendet werden.

  1. Wählen Sie auf der Registerkarte „Data Connect“ unter dem Abschnitt mit dem Pool und der Zulassungsliste für Privatnetzwerke den Pool aus, den Sie zugewiesen haben, und klicken Sie in der Spalte „Aktionen“ auf Neue Domäne.

  2. Geben Sie in dem Textfeld „Domäne“ den URI der Domäne unter Beachtung der Informationen ein, die unter Regeln für die Registrierung in der Zulassungsliste beschrieben sind. Die Domänen-URI, die Sie angeben, wird nur für den Pool gelten, den Sie konfigurieren.

  3. Vergewissern Sie sich, dass unter „Domänenberechtigungen“ das Optionsfeld „Zulassen“ ausgewählt ist.

  4. Wenn Sie fertig sind, klicken Sie auf Speichern.

Problembehebung bei Verbindungsfehlern

Sie müssen Ihre Netzwerkinfrastruktur so konfigurieren, dass Data Connect alle erforderlichen Datenquellen erreichen kann, zu denen Sie eine Verbindung herstellen möchten. Um zu überprüfen, ob Data Connect Ihre Datenquellen erreichen kann, führen Sie den folgenden „curl“-Befehl auf den Knoten aus, auf denen Data Connect ausgeführt werden soll:

$ curl -v $DB_HOSTNAME:$DB_PORT

Wenn Sie Ihre Verbindung erfolgreich eingerichtet haben, sollten Sie eine Reihe von Antwortmeldungen sehen. Diese können in etwa so aussehen:

  • Host $DB_HOSTNAME:$DB_PORT was resolved: Bestätigt, dass die DNS-Server den Hostnamen erfolgreich aufgelöst haben.

  • Connected to $DB_HOSTNAME: Bestätigt, dass der Knoten über eine Netzwerkverbindung verfügt.

  • Empty reply from server. Closing connection: Dies ist zu erwarten, da „curl“ kein Datenbank-Client ist.

  • Could not resolve host: $DB_HOSTNAME: Es gibt ein Problem mit der DNS-Auflösung.

  • Trying $DB_IP_ADDRESS:$DB_PORT: Wenn nach Anzeige dieser Meldung der Computer nicht mehr reagiert, liegt ein Netzwerkproblem vor.

Wenn Sie für die Datenverbindungs-Infrastruktur einen Drittanbieter verwenden, müssen Sie sicherstellen, dass die Netzwerklogik nicht durch den Drittanbieter gestört wird.

(Optional) Schritt 4: Freigeben von Clustern Site-übergreifend

Standardmäßig werden Data Connect-Cluster und ihre zugehörigen Knoten nur von der Site verwendet, auf der sie ursprünglich erstellt wurden. Data Connect-Cluster können jedoch über alle Sites innerhalb Ihres Tableau Cloud Manager-Mandanten hinweg gemeinsam genutzt werden. Durch die gemeinsame Nutzung von Clustern können Abfragen auf unterschiedlichen Sites innerhalb des Mandanten dieselbe Knoteninfrastruktur verwenden.

Um sicherzustellen, dass der Datenschutz Site-übergreifend gewährleistet bleibt, sind für andere Sites in Ihrem Mandanten keine Daten zu Ihrem freigegebenen Cluster verfügbar.

Hinweis: Die gemeinsame Nutzung eines Clusters ist ein dauerhafter Vorgang. Um die Freigabe eines Clusters aufzuheben, müssen Sie den Cluster entfernen und erneut installieren.

Cluster können erst freigegeben werden, nachdem sie auf der ursprünglichen Site, auf der sie erstellt wurden, erfolgreich akzeptiert wurden.

So geben Sie einen Data Connect-Cluster frei:

  • Navigieren Sie zu dem Cluster, den Sie freigeben möchten, klicken Sie auf die Aktionsschaltfläche (...), und klicken Sie dann auf Freigeben.

Nachdem Sie den Cluster freigegeben haben, können Site-Administratoren auf anderen Sites innerhalb Ihres Mandanten den Cluster mit beliebigen Pools nutzen, die sie in ihren Sites erstellen.

(Optional) Schritt 5: Erstellen eines Pools auf einem freigegebenen Cluster als Clusterempfänger

Bevor Sie Ihren Pool als einen Empfänger in einem gemeinsam genutzten Cluster erstellen, müssen Sie sich vergewissern, dass:

  • Der gemeinsam genutzte Cluster über Netzwerkkonnektivität zu den Datenbanken verfügt, die von Ihrer Site verwendet werden.

  • Alle von der Datenbank in Ihrer Site benötigten Datenbanktreiber auf dem Cluster installiert sind.

Um einen freigegebenen Cluster als Clusterempfänger zu verwenden, müssen Sie sich an den Clusterbesitzer wenden, damit das Basis-Image Ihres Pools dem Cluster hinzugefügt werden kann:

  1. Klicken Sie auf der Registerkarte „Data Connect“ unter „Pools“ auf Neuer Pool.

  2. Geben Sie im Fenster „Neuer Pool“ einen Poolnamen ein, und klicken Sie dann auf Erstellen.

  3. Klicken Sie in dem neuen Pool auf Cluster zuweisen, wählen Sie den freigegebenen Cluster aus, klicken Sie auf die Aktionsschaltfläche (...), und klicken Sie dann auf Token aktualisieren.

  4. Stellen Sie sicher, dass Sie die Token für den richtigen Pool aktualisieren, und klicken Sie dann auf Bestätigen.

  5. Wenn der Poolstatus auf „Verfügbar“ gesetzt ist, kopieren Sie die Pool-ID Ihres Pools. Klicken Sie auf den Poolnamen, um den Wert für „Pool_ID“ anzuzeigen.

  6. Fügen Sie ein Basis-Image für Ihre Site hinzu. Siehe dazu Schritt 2: Erstellen und Veröffentlichen Ihres Basis-Images, weiter oben.

    Der Administrator mit Zugriff auf den Cluster muss beim Hinzufügen des Basis-Images einen neuen Container mit dem Pool_ID-Wert erstellen. Außerdem werden Sie auch die Registrierungswerte für die Site benötigen, auf der der Cluster ursprünglich erstellt wurde. Diese können Sie vom Clusterbesitzer erfahren.

  7. Nachdem das Basis-Image in der lokalen Containerregistrierung veröffentlicht wurde, navigieren Sie zu dem Pool auf der Freigabe-Site, und klicken Sie dann auf Basisbild aktualisieren.

  8. Um die Einrichtung abzuschließen, führen Sie die Schritte durch, die oben im Abschnitt Schritt 3: Zuordnen einer Domäne zu einem Pool aufgeführt sind.

Hinzufügen eines Knotens aus einem vorhandenen Cluster

  1. Navigieren Sie zu dem Cluster, und klicken Sie auf Neuer Knoten.

  2. Folgen Sie den Schritten 4, 5, 7, 8 und 9 aus dem Abschnitt Schritt 1: Einrichten Ihres Clusters, weiter oben. Überspringen Sie Schritt 6, da Sie den Cluster nicht zuweisen müssen.

  3. Nachdem der Schritt zum Aktualisieren des Tokens abgeschlossen ist, wechseln Sie zu dem Pool, der dem Cluster zugeordnet ist, und klicken Sie auf Basisbild aktualisieren.

Hinweis: Wenn ein neues Basis-Image erstellt und aktualisiert wird, wird eine neue Bereitstellung erstellt. Der für das vorherige Basis-Image verwendete Bridge-Client verbleibt als ein nicht zugewiesenes Asset. Löschen Sie keine Bridge-Clients, die nicht zugewiesen sind.

Entfernen eines Knotens aus einem vorhandenen Cluster

Nachdem ein Knoten aus einem Cluster entfernt wurde, ist der Bridge-Client für Tableau Cloud nicht mehr zugänglich. Aufträge, die zum Zeitpunkt der Löschung des Knotens in Data Connect ausgeführt werden, werden mit einer Fehlermeldung abgebrochen. Es werden jedoch auch keine weiteren Aufträge an diese Bridge-Clients weitergeleitet.

Um einen Knoten zu entfernen, navigieren Sie zu dem Cluster, klicken Sie auf die Aktionsschaltfläche (...), und wählen Sie Löschen aus.

Aktualisieren von Basis-Images für vorhandene Pools

Wenn Sie sich entscheiden, eine andere Datenbank zu verwenden oder einen Treiber zu aktualisieren, den Ihr Data Connect-Cluster verwenden wird, können Sie Änderungen an vorhandenen Basis-Images vornehmen, um diese Änderungen zu berücksichtigen. Aktualisieren Sie dazu die Containerdatei mit den Änderungen, wie in Schritt 2: Erstellen und Veröffentlichen Ihres Basis-Images erklärt. Nachdem Sie die Containerdatei aktualisiert haben, klicken Sie auf Basisbild aktualisieren. Ihr vorheriges Basis-Image bleibt so lange in Gebrauch, bis das neue Basis-Image erfolgreich bereitgestellt wurde.

Fehlerbehebung bei der Datenbankkonnektivität

Als Erstes sollten Sie sich vergewissern, dass Ihre Domänen den Regeln für die Registrierung in der Zulassungsliste entsprechen. Siehe Konfigurieren von Pools.

Als Nächstes müssen Sie sich vergewissern, dass Sie Ihre Netzwerkinfrastruktur so konfiguriert haben, dass Data Connect alle erforderlichen Datenquellen erreichen kann, zu denen eine Verbindung hergestellt werden soll. Um zu überprüfen, ob Data Connect Ihre Datenquellen erreichen kann, führen Sie den folgenden „curl“-Befehl auf den Knoten aus, auf denen Data Connect ausgeführt werden soll:

$ curl -v $DB_HOSTNAME:$DB_PORT

Wenn Sie Ihre Verbindung erfolgreich eingerichtet haben, sollten Sie eine Reihe von Antwortmeldungen sehen. Diese können in etwa so aussehen:

  • Host $DB_HOSTNAME:$DB_PORT was resolved: Bestätigt, dass die DNS-Server den Hostnamen erfolgreich aufgelöst haben.

  • Connected to $DB_HOSTNAME: Bestätigt, dass der Knoten über eine Netzwerkverbindung verfügt.

  • Empty reply from server. Closing connection: Dies ist zu erwarten, da „curl“ kein Datenbank-Client ist.

  • Could not resolve host: $DB_HOSTNAME: Es gibt ein Problem mit der DNS-Auflösung.

  • Trying $DB_IP_ADDRESS:$DB_PORT: Wenn nach Anzeige dieser Meldung der Computer nicht mehr reagiert, liegt ein Netzwerkproblem vor.

Wenn Sie für die Datenverbindungs-Infrastruktur einen Drittanbieter verwenden, müssen Sie sicherstellen, dass die Netzwerklogik nicht durch den Drittanbieter gestört wird.

Zurück zum Anfang
Vielen Dank für Ihr Feedback!Ihr Feedback wurde erfolgreich übermittelt. Vielen Dank.