Kommandoradsreferens för Tableau Prep

Du kan interagera med Tableau Prep med hjälp av kommandoraden via antingen huvudprogrammet (Tableau Prep.exe) eller kommandoradsgränssnittet (tableau-prep-cli.bat).

  • Tableau Prep.exe: Används för att konfigurera hur programmet initieras. Exempel: installera, aktivera, licensiera, ställa in kataloger för användardata eller felsöka Electron-skalet.

  • Tableau-prep-cli.bat: Används för att köra flöden. Exempel: skicka inloggningsuppgifter och parametrar samt uppdatera utdata utan att öppna det visuella gränssnittet.

I det här dokumentet beskrivs alla kommandoradssyntaxer som stöds i Tableau Prep och är tillgängliga för kunderna, sorterat efter det verktyg där de är tillgängliga.

Ytterligare kommandoradssyntaxer som stöds och som används av Tableau-utvecklare och Tableaus support ingår inte i det här dokumentet.

Programmet Tableau Prep

Följande åtgärder kan utföras från kommandoraden för programmet Tableau Prep.exe.

Installation

Installera Tableau Prep genom att köra .exe-installationsfilen som administratör från datorns kommandorad. Mer information finns i Installera från kommandoraden(Länken öppnas i ett nytt fönster).

Obs! Det här alternativet finns bara i Windows.

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

Kör kommandot som administratör från den mapp där .exe-filen finns eller ange den fullständiga sökvägen till .exe-filen på datorn. Kör inte från en delad katalog. En lista över de installationsalternativ som stöds finns i Installationsalternativ(Länken öppnas i ett nytt fönster). En lista över de installationsegenskaper som stöds finns i Installationsegenskaper(Länken öppnas i ett nytt fönster).

  • tableau_<product_installer_name>.exe är Tableau-installationsprogrammet för den produkt och den version som du installerar.

  • option1, option2 o.s.v. anger hur du vill att installationsprocessen ska köras.

  • PROPERTY1, PROPERTY2 o.s.v. anger konfigurationsinställningar som ska ställas in under installationen.

Exempel:

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

Det här kommandot installerar Tableau version 2026.2 i tyst läge (visar inga uppmaningar, inget användargränssnitt och ingen licensdialogruta). Installationen slutförs utan omstart, slutanvändaravtalet (EULA) godkänns och felrapportering samt användningsrapportering stängs av.

Aktivering, licensiering och registrering

Använd de här kommandona för att kontrollera licensen, aktivera produkten under eller efter installationen och registrera produkten. Du hittar mer information i Aktivera Tableau Desktop och Tableau Prep Builder(Länken öppnas i ett nytt fönster).

SyntaxBeskrivning
--activate <key>

Aktivera produkten med den medföljande produktnyckeln. Avslutar med koden 0 när det lyckas. Avslutar i annat fall med en felkod. Accepterar även enkelt bindestreck (-activate).

Om du vill aktivera produkten under installationen lägger du till en enda kommandorad som innehåller installationsalternativet ACTIVATE_KEY ”<key>” och anger produktnyckeln inom citattecken.

--register

Registrera produkten. Accepterar även enkelt bindestreck (-register). Om du vill registrera Tableau från kommandoraden måste du fylla i värdena i registret (Windows) eller .plist (Mac) först på alla datorer som ska köra Tableau Prep Builder.

I Windows kan du registrera produkten under installationen genom att lägga till en enda kommandorad som innehåller installationsalternativet REGISTER=”1”.

Mer information finns i Registrera Tableau Desktop och Tableau Prep Builder(Länken öppnas i ett nytt fönster).

--check-license Visa aktiveringsgränssnittet om olicensierad.
--refresh

Uppdaterar licenser med det datum då deras aktuella underhållsperiod löper ut och stoppar förfallomeddelanden. Avslutar med koden 0 när det lyckas. Accepterar även enkelt bindestreck (-refresh).

Windows: Kör tableau.exe med alternativet --refresh och en produktnyckel.

MacOS: Kör alternativet -refresh på Tableau-objektet i /Applications-sökvägen.

--return <key>

Inaktivera den medföljande produktnyckeln så att den kan återanvändas. Accepterar även enkelt bindestreck (-return).

Windows: Kör tableau.exe med alternativet -return och en produktnyckel.

MacOS: Kör alternativet -return på Tableau-objektet i /Applications-sökvägen.

Konfiguration och lagring

Använd de här kommandona för att konfigurera filinställningar och lagringsplatser.

SyntaxBeskrivning
--settings-file <file location>

Läs in programmets konfigurationsinställningar från den angivna filen. Kan anges flera gånger för att stödja konfigurationer med flera lager, som när du har en global proxyserverkonfiguration som används av alla och en specifik databaskonfiguration som används för ett flöde.

Exempel på JSON-fil:

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

Exempelkommando:

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>

Ange lagringsplatsens katalog. Som standard skapar Tableau Prep under installationen en mapp i mappen Dokument som heter Min Tableau Prep-lagringsplats. Den här mappen innehåller mappar för flöden, datakällor, anslutningar såväl som loggfiler och en tillfällig cache. I servermiljöer eller automatiserade miljöer kan du använda det här kommandot för att ange en alternativ lagringsplats och rikta flödeskörningen mot den.

Exempel:

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>

Katalog som används för att lagra Electron-programdata.

Medan --repository-location hanterar affärsresurser (loggar och data), så hanterar --user-data-directory programmets interna motor.

Som administratör använder du den här flaggan om du kör Tableau Prep Builder i en miljö med en hög grad av samtidighet, där flera processer behöver isolerade programtillstånd, eller vid felsökning av beständiga sessionslåsfel på en oberoende server.

Obs! När du kör kommandot skapas automatiskt den mapp som anges i --user-data-directory. Det användarkonto som kör skriptet måste dock ha skrivbehörighet till den överordnade katalogen.

Exempel:

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"

Öppna filer

Använd de här kommandona för att öppna Tableau Prep-flödesfiler i formaten .tfl och .tflx.

SyntaxBeskrivning
--tfl<file>

Öppna den angivna .tfl-flödesfilen. Använd dubbla citattecken om filsökvägen innehåller blanksteg.

Exempel:

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>

Öppna den angivna paketerade .tflx-flödesfilen.

Exempel:

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"

Kommandoradsgränssnittet i Tableau Prep

Du kan köra följande kommandon med hjälp av Tableau Preps kommandoradsgränssnitt (tableau-prep-cli.bat).

Uppdatera flödesutdata

Använd de här alternativen för att köra flödet från kommandoraden för att uppdatera flödesutdata. Med den här metoden kan du bara köra ett flöde i taget. Mer information och begränsningar finns i Uppdatera flödesutdatafiler från kommandoraden(Länken öppnas i ett nytt fönster).

SyntaxBeskrivning
-c, --connections <path>

Sökvägen till den .json-fil som innehåller inloggningsuppgifterna för datakällorna och servrarna.

Tableau Prep Builder använder information från flödesfilen och från .json-inloggningsfilen för att köra flödet vid fjärranslutningar. Mer information finns i avsnittet Krav på .json-inloggningsfilen(Länken öppnas i ett nytt fönster).

Om du ansluter till en Snowflake-databas ser du till att inkludera eventuella specifika parametrar som roll, lager och ibland OAuth-token eller autentisering via extern webbläsare.

Exempel på .json-inställningsfil – Snowflake:

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

Exempel:

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

Sökvägen till en .json-fil som åsidosätter standardparametervärdena i flödet. Detta är en annan fil än credentials.json-filen och den innehåller dina parameternamn och värden.

Mer information finns i Krav på .json-inloggningsfilen(Länken öppnas i ett nytt fönster).

Exempel:

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>Sökvägen till Tableau Prep-flödesfilen.
-inc, --incrementalRefresh

Om du inte har Tableau Prep Conductor aktiverat på servern för att schemalägga flödeskörningar kan du använda det här kommandot för att köra flödena med inkrementell uppdatering. Mer information finns i Kör flödet med inkrementell uppdatering aktiverad.

Exempel:

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 kommandon

Använd de här kommandona för att skriva ut Tableau Prep-versionen, aktivera felsökningsläget för att felsöka en flödesprocess, inaktivera SSL-validering och mycket annat.

SyntaxBeskrivning
--versionAnger den aktuella versionen av kommandoradsgränssnittet för Tableau Prep Builder och avslutar omedelbart processen.
-d, --debug

Aktiverar felsökningsläget. Genererar detaljerade loggar i den mapp som angetts för att lagra felsökning. Loggfiler lagras i: My Tableau Prep Builder Repository\Command Line Repository\Logs

Exempel:

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

Inaktiverar kontroll av SSL-certifikat (användbart för vissa interna servermiljöer). När du kör det här alternativet på MacOS kan det visas en dialogruta som frågar efter nyckelringens användare och lösenord.

Från och med Tableau Prep Builder version 2019.3.2 kan du gå in i denna ytterligare parameter för att inaktivera denna dialogruta för nyckelkedja.

Exempel:

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)

Visar hjälpmenyn för kommandoradsalternativen.

Tack för din feedback!Din feedback har skickats in. Tack!