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.
| Syntaxis | Beschrijving |
|---|---|
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.
Voorbeeld:
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.
| Syntaxis | Beschrijving |
|---|---|
--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 MacOS: voer de optie |
--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 MacOS: voer de optie |
Configuratie en opslag
Gebruik deze opdrachten om de bestandsinstellingen en opslagplaatslocaties te configureren.
| Syntaxis | Beschrijving |
|---|---|
--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: MacOS |
--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: " MacOS: |
--user-data-directory <location> | Directory die wordt gebruikt voor het opslaan van Electron-toepassingsdata. Waar 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 Voorbeeld: Windows: MacOS: |
Bestanden openen
Gebruik de volgende opdrachten om Tableau Prep-flowbestanden met de extensie .tflx en .tfl te openen.
| Syntaxis | Beschrijving |
|---|---|
--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: MacOS: |
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.
| Syntaxis | Beschrijving |
|---|---|
-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: MacOS: |
- 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: MacOS: |
-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: MacOS: |
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.
| Syntaxis | Beschrijving |
|---|---|
--version | Voert 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: MacOS: |
-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: |
-h, --help) | Het Help-menu voor de opdrachtregelopties wordt weergegeven. |
