Tableau Prep-Befehlszeilenreferenz

Sie können mit Tableau Prep über die Befehlszeile interagieren – entweder über die Hauptanwendung (Tableau Prep.exe) oder über die Befehlszeilenschnittstelle (tableau-prep-cli.bat).

  • Tableau Prep.exe: Wird zum Konfigurieren der Selbstinitialisierung der Anwendung verwendet. Zum Beispiel zum Installieren, Aktivieren, Lizenzieren, Einrichten von Benutzerdatenverzeichnissen oder Beheben von Fehlern bei der Electron-Shell.

  • Tableau-prep-cli.bat: Wird zum Ausführen von Schemas verwendet. Zum Beispiel zum Übergeben von Anmeldeinformationen und Parametern sowie zum Aktualisieren von Datenausgaben, ohne die visuelle Benutzeroberfläche zu öffnen.

In diesem Dokument werden alle Optionen für die Befehlszeilensyntax beschrieben, die von Tableau Prep unterstützt werden und Kunden zur Verfügung stehen, getrennt nach dem Dienstprogramm, in dem sie verfügbar sind.

Zusätzliche unterstützte Befehlszeilensyntax, die von den Entwicklern und dem Support von Tableau verwendet wird, sind in diesem Dokument nicht enthalten.

Tableau Prep-Anwendung

Die folgenden Aktionen können über die Befehlszeile für die Anwendung „Tableau Prep.exe“ ausgeführt werden.

Installieren

Installieren Sie Tableau Prep, indem Sie die EXE-Datei des Installationsprogramms als Administrator über die Befehlszeile des Computers ausführen. Weitere Informationen dazu finden Sie unter Installieren über die Befehlszeile(Link wird in neuem Fenster geöffnet).

Hinweis: Diese Option ist nur für Windows verfügbar.

SyntaxBeschreibung
tableau_<product_installer_name>.exe /option1 /option2 PROPERTY1 PROPERTY2

Führen Sie den Befehl als Administrator in dem Verzeichnis aus, in dem sich die EXE-Datei befindet, oder geben Sie den vollständigen Pfad zum Speicherort der EXE-Datei auf dem Computer an. Führen Sie den Befehl nicht in einem freigegebenen Verzeichnis aus. Eine Liste der unterstützten Optionen des Installationsprogramms finden Sie unter Optionen des Installationsprogramms(Link wird in neuem Fenster geöffnet). Eine Liste der unterstützten Eigenschaften des Installationsprogramms finden Sie unter Eigenschaften des Installationsprogramms(Link wird in neuem Fenster geöffnet).

  • tableau_<product_installer_name>.exe ist das Tableau-Installationsprogramm für das Produkt und die Version, das bzw. die Sie installieren.

  • option1, option2 usw. ist die Art und Weise, wie der Installationsprozess ausgeführt werden soll.

  • PROPERTY1, PROPERTY2 ermöglicht es Ihnen Konfigurationseinstellungen anzugegeben, die das Installationsprogramm während des Installationsvorgangs vornehmen soll.

Beispiel:

tableauPrepBuilder-64bit-2026-2-0.exe /quiet /norestart ACCEPTEULA=1 CRASHDUMP="0" SENDTELEMETRY="0"

Mit diesem Befehl wird Tableau Version 2026.2 im Hintergrund installiert (d.h. es werden keine Eingabeaufforderungen, Benutzeroberflächen oder Lizenzdialogfelder angezeigt). In diesem Modus wird das Installationsprogramm ohne Neustart abgeschlossen, die Lizenzvereinbarung für Endbenutzer (EULA) wird akzeptiert und Fehlerberichterstattung und Nutzungsberichterstattung werden deaktiviert.

Aktivierung, Lizenz und Registrierung

Verwenden Sie die folgenden Befehle, um Ihre Lizenz zu überprüfen, das Produkt während oder nach der Installation zu aktivieren und das Produkt zu registrieren. Weitere Informationen finden Sie unter Aktivieren von Tableau Desktop und Tableau Prep Builder(Link wird in neuem Fenster geöffnet).

SyntaxBeschreibung
--activate <key>

Aktiviert das Produkt mit dem angegebenen Produktschlüssel. Wird im Erfolgsfall mit Code 0 beendet. Andernfalls wird der Befehl mit einem Fehlercode beendet. Akzeptiert auch einen einfachen Bindestrich (-activate).

Wenn das Produkt während der Installation aktiviert werden soll, fügen Sie eine einzelne Befehlszeile hinzu, die die Installer-Option ACTIVATE_KEY "<Schlüssel>" enthält, und geben Sie den Produktschlüssel in Anführungszeichen ein.

--register

Registriert das Produkt. Akzeptiert auch einen einfachen Bindestrich (-register). Wenn Sie Tableau über die Befehlszeile registrieren möchten, müssen Sie die Registrierungswerte (Windows) oder PLIST-Werte (Mac) vorab auf jedem Computer ausfüllen, auf dem Tableau Prep Builder ausgeführt werden soll.

Unter Windows können Sie das Produkt während der Installation registrieren, indem Sie eine einzelne Befehlszeile hinzufügen, die die Installationsprogrammoption REGISTER="1" enthält.

Weitere Informationen finden Sie unter Registrieren von Tableau Desktop und Tableau Prep Builder(Link wird in neuem Fenster geöffnet).

--check-license Zeigt die Aktivierungsbenutzeroberfläche an, wenn nicht lizenziert.
--refresh

Aktualisiert Lizenzen mit dem Datum, an dem ihr aktueller Wartungszeitraum abläuft, und stoppt Ablaufmeldungen. Wird im Erfolgsfall mit Code 0 beendet. Akzeptiert auch einen einfachen Bindestrich (-refresh).

Windows: Führen Sie „tableau.exe“ mit der Option --refresh und einem Produktschlüssel aus.

MacOS: Führen Sie die Option -refresh für das Tableau-Objekt im „/Applications“-Pfad aus.

--return <key>

Deaktiviert den angegebenen Produktschlüssel, sodass er wiederverwendet werden kann. Akzeptiert auch einen einfachen Bindestrich (-return).

Windows: Führen Sie „tableau.exe“ mit der Option -return und einem Produktschlüssel aus.

MacOS: Führen Sie die Option -return für das Tableau-Objekt im „/Applications“-Pfad aus.

Konfiguration und Speicher

Verwenden Sie die folgenden Befehle, um Dateieinstellungen und Repository-Speicherorte zu konfigurieren.

SyntaxBeschreibung
--settings-file <file location>

Lädt Anwendungskonfigurationseinstellungen aus der angegebenen Datei. Kann mehrfach angegeben werden, um mehrschichtige Konfigurationen zu unterstützen (z. B. wenn Sie eine globale Proxyserver-Konfiguration haben, die von allen verwendet wird, und eine spezielle Datenbank-Konfiguration, die für ein Schema verwendet wird).

Beispiel für eine JSON-Datei:

{
 "connection-sources":[
  {
	"endpoint":"prod-db-server.company.com",
	"username":"service_account_admin",
	"password":"secure_password_123"
	}
 ]
}

Beispielbefehl:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --settings-file "C:\ProgramData\Tableau\global-proxy-config.json" --settings-file "C:\Users\jsmith\AppData\Roaming\Tableau\db-config.json"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --settings-file "/Library/Tableau/global-proxy-config.json" --settings-file "/Users/jsmith/Library/Application Support/Tableau/db-config.json"

--repository-location <file path>

Legt das Repository-Verzeichnis fest. In der Standardeinstellung erstellt Tableau Prep einen Ordner in Ihrem „Dokumente“-Ordner mit dem Namen „Eigenes Tableau Prep-Repository“. Dieser Ordner enthält Ordner für Schemas, Datenquellen, Verbindungen sowie Protokolldateien und einen temporären Cache. In Server- oder Automatisierungsumgebungen können Sie diesen Befehl verwenden, um einen alternativen Repository-Speicherort anzugeben und die Schemaausführung darauf zu verweisen.

Beispiel:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --repository-location "D:\Tableau_Data\My_Prep_Repo"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --repository-location "/Users/jsmith/Documents/My Tableau Prep Repository"

--user-data-directory <location>

Verzeichnis, das zum Speichern von Electron-Anwendungsdaten verwendet wird.

Während --repository-location Ihre geschäftlichen Assets (Protokolle und Daten) verwaltet, verwaltet --user-data-directory die interne Engine der Anwendung.

Als Administrator verwenden Sie dieses Flag, wenn Sie Tableau Prep Builder in einer hoch-parallelen Umgebung ausführen, in der mehrere Prozesse isolierte Anwendungszustände benötigen, oder wenn Sie Probleme mit ständigen Sitzungssperrungen auf einem Headless-Server beheben möchten.

Hinweis: Wenn Sie den Befehl ausführen, wird automatisch der Ordner erstellt, der in --user-data-directory angegeben ist. Allerdings muss das Benutzerkonto, unter dem das Skript ausgeführt wird, über Schreibberechtigungen für dieses übergeordnete Verzeichnis verfügen.

Beispiel:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --user-data-directory "D:\Tableau_Data\Prep_AppData"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --user-data-directory "/Users/jsmith/Library/Application Support/Tableau Prep"

Öffnen von Dateien

Verwenden Sie die folgenden Befehle, um TFL- und TFLX-Tableau Prep-Schemadateien zu öffnen.

SyntaxBeschreibung
--tfl<file>

Öffnet die angegebene TFL-Schemadatei. Verwenden Sie doppelte Anführungszeichen, wenn der Dateipfad Leerzeichen enthält.

Beispiel:

Windows: "C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" -tfl "C:\Users\jsmith\Documents\My Flows\Clean_Sales_Data.tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder -tfl "/Users/jsmith/Documents/My Flows/Clean_Sales_Data.tfl"

--tflx<file>

Öffnet die angegebene TFLX-Schemapaketdatei.

Beispiel:

Windows:"C:\Program Files\Tableau\Tableau Prep Builder 2026.2\Tableau Prep Builder.exe" --tflx "C:\Users\jsmith\Desktop\Quarterly_Report.tflx"

MacOS: /Applications/Tableau\ Prep\ Builder\ 2026.2.app/Contents/MacOS/Tableau\ Prep\ Builder --tflx "/Users/jsmith/Desktop/Quarterly_Report.tflx"

Tableau Prep-Befehlszeilenanwendung

Die folgenden Befehle können über die Tableau Prep Befehlszeilenschnittstelle (tableau-prep-cli.bat) ausgeführt werden.

Aktualisieren der Schemaausgabe

Verwenden Sie die folgenden Optionen, um das Schema über die Befehlszeile auszuführen und die Schemaausgabe zu aktualisieren. Bei dieser Methode können Sie nur ein Schema auf einmal ausführen. Weitere Informationen und Einschränkungen finden Sie unter Aktualisieren von Schema-Ausgabedateien über die Befehlszeile(Link wird in neuem Fenster geöffnet).

SyntaxBeschreibung
-c, --connections <path>

Der Pfad zu der JSON-Datei, die die Anmeldeinformationen für Ihre Datenquellen und Server enthält.

Tableau Prep Builder verwendet Informationen aus der Schemadatei und aus der JSON-Datei mit Anmeldeinformationen, um das Schema bei einer Remote-Verbindung auszuführen. Weitere Informationen finden Sie unter Anforderungen an eine JSON-Datei mit Anmeldeinformationen(Link wird in neuem Fenster geöffnet).

Wenn Sie eine Verbindung zu einer Snowflake-Datenbank herstellen, stellen Sie sicher, dass Sie spezifische Parameter wie Rolle, Warehouse und manchmal OAuth-Token oder externe Browserauthentifizierung mit einschließen.

Beispiel für JSON-Einstellungsdatei – Snowflake:

{
 "connection-sources":[
  {
	"endpoint":"company_account.snowflakecomputing.com",
	"username":"SVC_TABLEAU_PREP",
	"password":"EncryptedPassword123",
	"attributes":{
	 "warehouse": "DATA_LOAD_WH",
	 "role": "TRANSFORM_ROLE"
	}
  }
 ]
}						

Beispiel:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -c "path\to\[your credential file name].json" -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

- p, - - parameters

Der Pfad zu einer JSON-Datei, die die standardmäßigen Parameterwerte in Ihrem Schema überschreibt. Dies ist eine von Ihrer „credentials.json“-Datei separate Datei, die die Namen und Werte Ihrer Parameter enthält.

Weitere Informationen finden Sie unter „Ausführen von Schemas, die Parameterwerte enthalten“ in Anforderungen an eine JSON-Datei mit Anmeldeinformationen(Link wird in neuem Fenster geöffnet).

Beispiel:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat -t "path\to\[your flow file name].tfl" -p|--parameters parameters.override.json

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -t path/to/[your flow file name].tfl -p|--parameters parameters.override.json

-t,--tflFile <file path>Der Pfad zu Ihrer Tableau Prep-Schemadatei.
-inc, --incrementalRefresh

Wenn Tableau Prep Conductor auf Ihrem Server nicht aktiviert ist, um die Schemaausführungen zu planen, können Sie diesen Befehl verwenden, um Ihr Schema mittels inkrementeller Aktualisierung auszuführen. Weitere Informationen finden Sie unter „Ausführen des Schemas mit aktivierter inkrementeller Aktualisierung“.

Beispiel:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --incrementalRefresh -t "path\to\[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --incrementalRefresh -t path/to/[your flow file name].tfl

Diverse Befehle

Verwenden Sie die folgenden Befehle, um die Tableau Prep-Version zu drucken, den Debug-Modus zu aktivieren, um einen Schemaprozess auf Fehler zu überprüfen, die SSL-Validierung zu deaktivieren und vieles mehr.

SyntaxBeschreibung
--versionGibt die aktuelle Version der Befehlszeilenschnittstelle von Tableau Prep Builder aus und beendet den Prozess sofort.
-d, --debug

Aktiviert den Debug-Modus. Generiert detaillierte Protokolle im Repository-Ordner für Fehlerbehebungszwecke. Protokolldateien werden gespeichert unter: „Eigenes Tableau Prep Builder Repository\Command Line Repository\Logs“.

Beispiel:

Windows: "\[Tableau Prep Builder install location]\Tableau Prep Builder <version>\scripts"\tableau-prep-cli.bat --debug -t "[your flow file name].tfl"

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli --debug -t “[your flow file name]”.tfl

-dsv, --disableSslValidation

Deaktiviert die SSL-Zertifikatvalidierung (nützlich für bestimmte interne Serverumgebungen). Wenn Sie diese Option unter MacOS ausführen, kann ein Dialogfeld angezeigt werden, in dem Sie nach dem Keychain-Benutzer und -Kennwort gefragt werden.

Ab Tableau Prep Builder Version 2019.3.2 können Sie den folgenden zusätzlichen Parameter übergeben, um diesen Schlüsselbund-Dialog zu deaktivieren.

Beispiel:

MacOS: /Applications/Tableau\ Prep\ Builder\ [Tableau Prep Builder version].app/Contents/scripts/./tableau-prep-cli -dsv -c path/to/[your credential file name].json -t path/to/[your flow file name].tfl

-h, --help)

Zeigt das Hilfemenü für die Befehlszeilenoptionen an.

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