Hilfe zu Tableau Server für Windows

Tableau umfasst ein Befehlszeilen-Dienstprogramm "tabcmd", mit dessen Hilfe Sie Site-Verwaltungsaufgaben auf Ihrer Tableau Server-Site automatisieren können. Beispielsweise für das Erstellen und Löschen von Benutzern, Projekten und Gruppen.

Hinweis: In Tableau-Versionen vor 2024.1 funktioniert tabcmd in der Version 1 nicht zum Exportieren von Visualisierungen.

Hinweis: Das tabcmd-Dienstprogramm ist in Tableau Server integriert und wird automatisch auf den Serverknoten installiert. Das Installationsprogramm ist jedoch nicht enthalten. Wenn Sie also tabcmd auf Computern ausführen möchten, die nicht Teil Ihrer Tableau Server-Installation sind, müssen Sie das Installationsprogramm von der Tableau-Website herunterladen. Weitere Informationen finden Sie im Folgenden unter Installieren von "tabcmd".

Installieren von "tabcmd"

Hinweis: Diese Anweisungen beziehen sich auf die Installation des Befehlszeilendienstprogramms tabcmd 1.0. Um das Befehlszeilendienstprogramm tabcmd 2.0 zu installieren, navigieren Sie zu Tableau tabcmd(Link wird in neuem Fenster geöffnet) (neues Fenster).

Wenn ein Upgrade von Tableau Server oder Tableau Cloud auf eine neue Version ausgeführt wird und eine aktualisierte Version von tabcmd erforderlich ist, können Sie sie von der Seite "Tableau Server-Versionen" der Tableau-Website herunterladen.

Wir empfehlen Ihnen für Tableau Server die Version herunterzuladen, die Ihrer Server-Version entspricht. Für Tableau Cloud empfehlen wir Ihnen, immer die neueste Version herunterzuladen, um Probleme zu vermeiden, die durch Versionsinkompatibilitäten verursacht werden. In beiden Fällen kann die Verwendung einer veralteten Version von tabcmd kann zu Fehlern und nicht vorhersehbaren Ergebnissen führen.

1. Öffnen Sie einen Webbrowser und rufen Sie die Seite Tableau Server-Versionen(Link wird in neuem Fenster geöffnet) auf. Rufen Sie die Seite auch dann auf, wenn Sie Tableau Online verwenden.

2. Sie verwenden:

   • Tableau Cloud: Verwenden Sie Tableau tabcmd 2.0(Link wird in neuem Fenster geöffnet) (neues Fenster).
   • Tableau Server (Windows oder Linux): Wählen Sie die Version, die mit Ihrer Server-Version übereinstimmt.

   Wählen Sie in beiden Fällen, wenn in den erweiterten Informationen Wartungsversionen angezeigt werden, die aktuelle Wartungsversion oder die Version aus, die mit Ihrer Server-Version übereinstimmt.

   

   Dadurch gelangen Sie zur Seite mit den Versionshinweisen, "gelöste Probleme" genannt. Dort können Sie sich über Sicherheitsverbesserungen und behobene Probleme informieren.

3. Führen Sie einen Bildlauf zum Abschnitt Dateien herunterladen unter den behobenen Problemen durch, und wählen Sie den tabcmd-Download-Link aus, der mit dem Computer kompatibel ist, auf dem Sie die Befehle ausführen werden. 

   

   In den noch folgenden Schritten wird dieser Computer als "der tabcmd-Computer" bezeichnet.

4. Speichern Sie das Installationsprogramm auf dem tabcmd-Computer bzw. an einem Ort, auf den über diesen Computer zugegriffen werden kann .

5. Führen Sie die Installationsschritte entsprechend dem Betriebssystem auf dem tabcmd-Computer aus:

   • Windows

     Standardmäßig wird tabcmd unter folgendem Dateipfad gespeichert: C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility. Sie können dies während der Installation ändern. Es ist empfehlenswert, tabcmd in einem Ordner namens tabcmd im Stammverzeichnis des Laufwerks C:\ zu speichern (C:\tabcmd). Damit können Sie tabcmd einfacher finden und ausführen. Zudem werden dadurch einige Einschränkungen bei Windows-Betriebssystemen umgangen, die auftreten, wenn Sie das tabcmd-Verzeichnis der Windows PATH-Variable hinzufügen.

     Hinweis Das Setup-Programm von tabcmd fügt das Verzeichnis tabcmd nicht der Windows PATH-Variable hinzu. Sie können dieses manuell hinzufügen oder den vollständigen Pfad zu tabcmd bei jedem Aufruf angeben.

     Sie können tabcmd auf zwei Arten unter Windows installieren:

     • Doppelklicken Sie auf das Installationsprogramm, um die Schritte in der Benutzeroberfläche auszuführen:

       1. Akzeptieren Sie den Lizenzvertrag.

       2. Wenn Sie tabcmd an einem nicht standardmäßigen Speicherort installieren möchten, klicken Sie auf Anpassen und legen Sie den Speicherort fest, an dem tabcmd installiert werden soll. Dazu können Sie den Pfad eingeben oder zum gewünschten Speicherort navigieren.

       3. Klicken Sie auf Installieren.

          Wenn Sie von Windows Defender Firewall oder der Benutzerkontensteuerung dazu aufgefordert werden, klicken Sie auf Zugriff erlauben.

     • Führen Sie das Installationsprogramm über eine Eingabeaufforderung aus:

       1. Öffnen Sie als Administrator auf dem primären tabcmd-Computer eine Eingabeaufforderung.

       2. Navigieren Sie zu dem Verzeichnis, in das Sie das tabcmd-Installationsprogramm kopiert haben.

       3. Installieren Sie tabcmd:

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1

          So installieren Sie tabcmd an einem nicht standardmäßigen Speicherort:

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\to\install\directory>"

          Beispiel:

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\tabcmd"

          Führen Sie das Installationsprogramm mit einem /? aus, um eine vollständige Liste der Befehlszeilenoptionen zu erhalten, die Sie mit dem tabcmd-Installationsprogramm verwenden können. Weitere Informationen zu den Befehlszeilenoptionen des tabcmd-Installationsprogramms finden Sie unter Installieren von Switches und Eigenschaften für tabcmd (Windows).

     Das tabcmd-Setup-Programm erstellt Protokolle unter C:\Users\<user>\AppData\Local\Temp, die Sie verwenden können, wenn Sie Probleme bei der tabcmd-Installation haben. Die Protokolle verwenden die Namenskonvention Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log.

   • Linux

     Hinweis: Wenn Sie tabcmd auf einem Linux-Computer ausführen möchten, müssen Sie Java 11 installiert haben. Auf RHEL-ähnlichen Systemen wird dies als Abhängigkeit installiert, wenn Sie tabcmd installieren. Bei Ubuntu Systemen müssen Sie Java 11 separat installieren, wenn es nicht bereits installiert ist.
     
     Ab Juli 2022 werden Debian-Distributionen nicht mehr unterstützt. Weitere Informationen finden Sie in diesem Tableau Community-Beitrag(Link wird in neuem Fenster geöffnet).

     1. Melden Sie sich als ein Benutzer mit sudo-Zugriffsrecht beim tabcmd-Computer an.

     2. Navigieren Sie in das Verzeichnis, in das Sie das heruntergeladene .rpm- bzw. .deb-Paket kopiert haben.

        • Führen Sie auf RHEL-ähnlichen Distributionen, einschließlich CentOS, den folgenden Befehl aus:

          sudo yum install tableau-tabcmd-<version>.noarch.rpm

        • Führen Sie auf Ubuntu den folgenden Befehl aus:

          sudo apt-get install ./tableau-tabcmd-<version>_all.deb

   Informationen zum Deinstallieren von "tabcmd" auf einem Linux-Computer finden Sie in der Dokumentation für die von Ihnen ausgeführte Linux-Variante.

6. (Optional) Fügen Sie dem Systempfad den vollqualifizierten Speicherort hinzu, an dem tabcmd installiert ist, damit Sie tabcmd-Befehle ausführen können, ohne an diesen Speicherort zu wechseln oder den Speicherort mit jedem Befehl angeben. Die Schritte hierzu hängen vom Typ und der Version Ihres Betriebssystems ab. Weitere Informationen finden Sie unter PATH_(variable).

Verwendungsweise von "tabcmd"

Die grundlegenden Schritte zur Verwendung von tabcmd sind folgende:

1. Öffnen Sie die Eingabeaufforderung als Administrator.

   Hinweis: Verwenden Sie nicht PowerShell, um tabcmd-Befehle unter Windows auszuführen. Die Verwendung von PowerShell kann zu unerwartetem Verhalten führen.

2. Auf einem Windows-Computer: Wenn Sie "tabcmd" auf einem anderen Computer als dem Ausgangsknoten installiert haben, wechseln Sie zum Installationsverzeichnis von "tabcmd".

   Auf einem Linux-Computer müssen Sie kein anderes Installationsverzeichnis auswählen.

3. Führen Sie den Befehl tabcmd aus.

Wenn Sie tabcmd verwenden, müssen Sie eine Sitzung mit einem authentifizierten Server starten. Die Sitzung gibt den Server oder die Tableau Cloud-Site und den Benutzer, der die Sitzung ausführt, an. Sie können zunächst die Sitzung starten und dann Ihren Befehl angeben oder gleichzeitig eine Sitzung starten und einen Befehl ausführen.

Wichtig: Wenn Sie den Befehl "tabcmd" zum Ausführen mehrerer Aufgaben verwenden, müssen Sie Aufgaben nacheinander (seriell) und nicht gleichzeitig ausführen.

Bei Befehlen (wie z. B. login) und Optionen (wie z. B. -s, -u, usw.) muss die Groß- und Kleinschreibung nicht beachtet werden. Für die von Ihnen eingegebenen Werte (wie z. B. User@Example.com) gilt jedoch die Groß- und Kleinschreibung.

Beispiele

tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword

tabcmd delete "Sales_Workbook" 

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword 

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword 

Die Optionen -s, -t, -u und -p gehören zu den globalen Variablen von tabcmd. Sie können daher mit allen Befehlen verwendet werden.

Weitere Informationen hierzu finden Sie unter tabcmd-Befehle-Befehle.

Andere Artikel in diesem Abschnitt