Tableau Prep-opdrachtregelreferentie

U kunt met gebruik van de opdrachtregel met Tableau Prep communiceren via de hoofdtoepassing (Tableau Prep.exe) of via de opdrachtregelinterface (tableau-prep-cli.bat).

  • Tableau Prep.exe: wordt gebruikt om te configureren hoe de toepassing zichzelf initialiseert. Dus bijvoorbeeld voor installatie, activering, licentieverlening, het instellen van directory's met gebruikersdata of het oplossen van problemen met de Electron-shell.

  • Tableau-prep-cli.bat: wordt gebruikt voor het uitvoeren van flows. Bijvoorbeeld voor het doorgeven van referenties en parameters en voor het vernieuwen van data-uitvoer zonder de visuele interface te openen.

In dit document worden alle opties voor de opdrachtregelsyntaxis beschreven die door Tableau Prep worden ondersteund en die beschikbaar zijn voor klanten. De opties worden vermeld voor elk hulpprogramma waarin ze beschikbaar zijn.

De aanvullende ondersteunde opdrachtregelsyntaxis die door de Tableau-ontwikkelaars en -ondersteuning wordt gebruikt, is niet opgenomen in dit document.

Tableau Prep-toepassing

De volgende acties kunnen vanaf de opdrachtregel worden uitgevoerd voor de toepassing Tableau Prep.exe.

Installeren

Installeer Tableau Prep door het .exe-installatiebestand als beheerder uit te voeren vanaf de opdrachtregel van de computer. Zie Installeren via de opdrachtregel(Link wordt in een nieuw venster geopend) voor meer informatie.

Opmerking: deze optie is alleen beschikbaar voor Windows.

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

Voer de opdracht als beheerder uit vanuit de directory waarin het .exe-bestand zich bevindt of geef een volledig pad op naar de locatie van het .exe-bestand op de computer. Voer de opdracht niet uit vanuit een gedeelde directory. Zie Opties voor installatieprogramma(Link wordt in een nieuw venster geopend) voor een lijst met ondersteunde opties voor installatieprogramma's. Zie Eigenschappen installatieprogramma(Link wordt in een nieuw venster geopend) voor een lijst met ondersteunde eigenschappen voor installatieprogramma's.

  • tableau_<product_installer_name>.exe is het Tableau-installatieprogramma voor het product dat en de versie die u installeert.

  • option1, option2, enz. geeft hoe u het installatieproces wilt laten verlopen.

  • Met PROPERTY1, PROPERTY2 enz. geeft u de configuratie-instellingen op die het installatieprogramma moet aanbrengen tijdens het installatieproces.

Voorbeeld:

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

Met deze opdracht wordt Tableau versie 2026.2 geïnstalleerd in de stille modus (zonder dat prompts, de gebruikersinterface en het licentiedialoogvenster worden weergegeven). De installatie wordt voltooid zonder de computer opnieuw op te starten, de licentieovereenkomst voor eindgebruikers (EULA) wordt geaccepteerd en de rapportage over fouten en gebruik wordt uitgeschakeld.

Activering, licentie en registratie

Gebruik deze opdrachten om uw licentie te controleren, het product tijdens of na de installatie te activeren en het product te registreren. Zie Tableau Desktop en Tableau Prep Builder activeren(Link wordt in een nieuw venster geopend) voor meer informatie.

SyntaxisBeschrijving
--activate <key>

Activeer het product met behulp van de meegeleverde productcode. Na geslaagde uitvoering wordt afgesloten met code 0. In alle andere gevallen wordt afgesloten met een foutcode. Ook het afbreekstreepje wordt geaccepteerd (-activate).

Als u het product tijdens de installatie wilt activeren, voegt u één opdrachtregel toe die de installatieprogrammaoptie ACTIVATE_KEY "<key>" bevat en voert u de productcode in tussen aanhalingstekens.

--register

Registreer het product. Ook het afbreekstreepje wordt geaccepteerd (-register). Als u Tableau vanaf de opdrachtregel wilt registreren, moet u de registerwaarden (Windows) of .plist-waarden (Mac) vooraf invullen op elke computer waarop Tableau Prep Builder wordt uitgevoerd.

In Windows kunt u het product tijdens de installatie registreren door één opdrachtregel toe te voegen die de installatieprogrammaoptie REGISTER="1" bevat.

Zie Tableau Desktop en Tableau Prep Builder registreren(Link wordt in een nieuw venster geopend) voor meer informatie.

--check-license Geef de activeringsinterface weer als u geen licentie hebt.
--refresh

Werkt licenties bij met de datum waarop de huidige onderhoudsperiode afloopt, zodat berichten over aflopende licenties niet meer worden weergegeven. Na geslaagde uitvoering wordt afgesloten met code 0. Ook het afbreekstreepje wordt geaccepteerd (-refresh).

Windows: voer tableau.exe uit met de optie --refresh en een productcode.

MacOS: voer de optie -refresh uit op het Tableau-object op het pad /Applications.

--return <key>

Deactiveer de meegeleverde productcode zodat deze opnieuw kan worden gebruikt. Ook het afbreekstreepje wordt geaccepteerd (-return).

Windows: voer tableau.exe uit met de optie -return en een productcode.

MacOS: voer de optie -return uit op het Tableau-object op het pad /Applications.

Configuratie en opslag

Gebruik deze opdrachten om de bestandsinstellingen en opslagplaatslocaties te configureren.

SyntaxisBeschrijving
--settings-file <file location>

Laad de configuratie-instellingen van de toepassing uit het opgegeven bestand. Kan meerdere keren worden opgegeven in geval van gelaagde configuraties, bijvoorbeeld wanneer u een globale proxyserverconfiguratie hebt die door iedereen wordt gebruikt en een specifieke databaseconfiguratie die voor een flow wordt gebruikt.

Voorbeeld met een .json-bestand:

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

Voorbeeldopdracht:

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>

Stel de opslagplaatsdirectory in. Tijdens de installatie wordt in Tableau Prep standaard een map met de naam Mijn Tableau Prep-opslagplaats gemaakt in uw map Documenten. Deze map bevat mappen voor flows, databronnen en verbindingen, maar ook logboekbestanden en een tijdelijke cache. In automatiserings- of serveromgevingen kunt u deze opdracht gebruiken om een alternatieve opslagplaatslocatie op te geven en de flowuitvoering hiernaartoe te verwijzen.

Voorbeeld:

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>

Directory die wordt gebruikt voor het opslaan van Electron-toepassingsdata.

Waar --repository-location de assets van uw bedrijf beheert (zoals logboeken en data), beheert --user-data-directory de interne engine van de toepassing.

Gebruik deze vlag als u als beheerder Tableau Prep Builder uitvoert in een omgeving met hoge gelijktijdigheid waar meerdere processen geïsoleerde toepassingsstatussen nodig hebben, of bij het oplossen van hardnekkige sessievergrendelingsfouten op een headless server.

Opmerking: wanneer u de opdracht uitvoert, wordt automatisch de map gemaakt die is opgegeven in --user-data-directory. Het gebruikersaccount waarop het script wordt uitgevoerd, moet echter wel schrijfmachtigingen hebben voor die bovenliggende directory.

Voorbeeld:

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"

Bestanden openen

Gebruik de volgende opdrachten om Tableau Prep-flowbestanden met de extensie .tflx en .tfl te openen.

SyntaxisBeschrijving
--tfl<file>

Open het opgegeven .tfl-flowbestand. Gebruik dubbele aanhalingstekens als uw bestandspad spaties bevat.

Voorbeeld:

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>

Open het opgegeven, in een pakket opgenomen .tflx-flowbestand.

Voorbeeld:

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-opdrachtregeltoepassing

De volgende opdrachten kunnen worden uitgevoerd via de Tableau Prep-opdrachtregelinterface (tableau-prep-cli.bat).

Flowuitvoer vernieuwen

Gebruik deze opties om de flow vanaf de opdrachtregel uit te voeren om de flowuitvoer te vernieuwen. Met deze methode kunt u slechts één flow tegelijk uitvoeren. Zie Uitvoerbestanden van een flow vernieuwen vanaf de opdrachtregel(Link wordt in een nieuw venster geopend) voor meer informatie en beperkingen.

SyntaxisBeschrijving
-c, --connections <path>

Het pad naar het .json-bestand met de referenties voor uw databronnen en servers.

Tableau Prep Builder gebruikt informatie uit het flowbestand en uit het .json-bestand met referenties om de flow uit te voeren wanneer u externe verbindingen hebt. Zie Vereisten voor het .json-bestand voor referenties(Link wordt in een nieuw venster geopend) voor meer informatie.

Als u verbinding maakt met een Snowflake-database, zorg er dan voor dat u specifieke parameters opneemt, zoals Rol en Magazijn en soms ook OAuth-tokens of Verificatie via externe browser.

Voorbeeld van .json-instellingenbestand - Snowflake:

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

Voorbeeld:

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

Het pad naar een .json-bestand dat de standaard parameterwaarden in uw flow overschrijft. Dit is een afzonderlijk bestand van uw credentials.json-bestand met de namen en waarden van uw parameters.

Zie Flows uitvoeren die parameterwaarden bevatten inVereisten voor het .json-bestand voor referenties(Link wordt in een nieuw venster geopend) voor meer informatie.

Voorbeeld:

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>Het pad naar uw Tableau Prep-flowbestand.
-inc, --incrementalRefresh

Als Tableau Prep Conductor niet is ingeschakeld op uw server om uw flowuitvoeringen te plannen, kunt u deze opdracht gebruiken om uw flow uit te voeren met behulp van incrementele vernieuwing. Zie De flow uitvoeren met incrementeel vernieuwen ingeschakeld voor meer informatie.

Voorbeeld:

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 opdrachten

Gebruik deze opdrachten om de Tableau Prep-versie af te drukken, de foutopsporingsmodus in te schakelen om fouten in een flowproces op te sporen, SSL-validatie uit te schakelen en meer.

SyntaxisBeschrijving
--versionVoert de huidige versie van de Tableau Prep Builder CLI uit en beëindigt het proces onmiddellijk.
-d, --debug

Schakelt de foutopsporingsmodus in. Genereert gedetailleerde logboeken in de map Opslagplaats voor probleemoplossing. Logboekbestanden worden opgeslagen in: Mijn Tableau Prep Builder Repository\Command Line Repository\Logs

Voorbeeld:

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

Schakelt SSL-certificaatvalidatie uit (handig voor bepaalde interne serveromgevingen). Wanneer u deze optie uitvoert op MacOS, kan er een dialoogvenster verschijnen waarin u wordt gevraagd om de gebruikersnaam en het wachtwoord van de sleutelketen in te voeren.

Vanaf Tableau Prep Builder versie 2019.3.2 kunt u deze extra parameter doorgeven om dit dialoogvenster uit te schakelen.

Voorbeeld:

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)

Het Help-menu voor de opdrachtregelopties wordt weergegeven.

Bedankt voor uw feedback.De feedback is verzonden. Dank u wel.