Help voor Tableau Prep

Alleen ondersteund in Tableau Prep Builder.

Als u de uitvoer van een flow wilt vernieuwen, kunt u de flow uitvoeren vanaf de opdrachtregel, in plaats van vanuit Tableau Prep Builder. Met deze methode kunt u één flow tegelijk uitvoeren. Deze optie is beschikbaar op zowel Windows- als Mac-computers waarop Tableau Prep Builder is geïnstalleerd.

Opmerking: Als u Licentiebeheer op basis van inloggen (LBLM) gebruikt, zorg er dan voor dat u Tableau Prep regelmatig opent. Anders kan de lease verlopen en kunnen de flows die via de opdrachtregel worden uitgevoerd, mislukken. U kunt ook contact opnemen met uw beheerder om de leaseduur te wijzigen naar de maximale lengte. Zie Licentiebeheer op basis van inloggen(Link wordt in een nieuw venster geopend) voor meer informatie.

Beperkingen van de connector:

• JDBC- of ODBC-connectoren: Flows die deze connectoren bevatten, kunnen vanaf versie 2019.2.3 vanaf de opdrachtregel worden uitgevoerd.
• Cloudconnectoren: Flows die cloudconnectoren bevatten, zoals Google BigQuery, kunnen niet vanaf de opdrachtregel worden uitgevoerd. Voer in plaats daarvan de flow handmatig uit, of volgens een schema in Tableau Server of Tableau Cloud met behulp van Tableau Prep Conductor. Zie Flowdata actueel houden voor meer informatie.
• Authenticatie via eenmalige aanmelding: U kunt geen flows vanaf de opdrachtregel uitvoeren als u authenticatie via eenmalige aanmelding toepast. In plaats daarvan kunt u de flows uitvoeren vanaf Tableau Prep Builder.
• Multi-factor authenticatie: De Tableau Prep-CLI (Command Line Interface) biedt geen ondersteuning voor Tableau met multi-factor authenticatie (MFA). Zie dit artikel(Link wordt in een nieuw venster geopend) in de Tableau Knowledge Base.

Bij Windows-computers kunt u dit proces ook plannen met behulp van Windows Task Scheduler. Zie Task Scheduler(Link wordt in een nieuw venster geopend) in de online Help-functie van Microsoft voor meer informatie.

Wanneer u flows uitvoert vanaf de opdrachtregel, vernieuwt Tableau Prep Builder alle uitvoer voor de flow op basis van de instellingen voor de uitvoerstappen die zijn opgegeven in Tableau Prep Builder. Zie Data-extractbestanden en gepubliceerde databronnen maken(Link wordt in een nieuw venster geopend) voor informatie over hoe u uw uitvoerlocaties kunt specificeren. Zie Schrijfopties configureren voor informatie over het instellen van uw schrijfopties (versie 2020.2.1 en later).

Voordat u de flow uitvoert

Als u de flow vanaf de opdrachtregel wilt uitvoeren, hebt u beheerdersrechten nodig op de computer waarop u de flow uitvoert. Ook hebt u de volgende informatie nodig:

• Het pad waar Tableau Prep Builder is geïnstalleerd.

• Als u verbinding maakt met databases en uitvoerbestanden publiceert naar een server of een database (versie 2020.3.1 en later), maak dan een .json-bestand met alle vereiste referenties.

• Het pad waar het Tableau Flow-bestand (.tfl) zich bevindt.

Vereisten voor het .json-bestand voor referenties

Opmerking: Er zijn geen .json-bestanden met referenties vereist als de flow verbinding maakt met en uitvoer levert naar lokale bestanden, bestanden die zijn opgeslagen op een netwerkshare of invoerbestanden die gebruikmaken van Windows-verificatie (SSPI). Zie SSPI-model(Link wordt in een nieuw venster geopend) in de online-Help van Microsoft voor meer informatie over Windows-verificatie.

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. De databasenaam voor uw externe verbindingen en de projectnaam voor uw uitvoerbestanden komen bijvoorbeeld uit de flow, terwijl de servernaam en de aanmeldingsgegevens uit het .json-bestand met referenties komen.

• Als u het bestand opnieuw wilt kunnen gebruiken, plaats het dan in een map waar het niet wordt overschreven door het installatieproces van Tableau Prep Builder.
• Als u een flow uitvoert die een van de volgende elementen bevat, moet u een .json-bestand opnemen met de referenties die nodig zijn om verbinding te maken.
  • Maakt verbinding met databasebestanden of gepubliceerde databronnen.
  • De uitvoer wordt op een server of in een database gepubliceerd (versie 2020.3.1 en later).
  • De flow bevat scriptstappen voor Rserve of TabPy. Het .json-bestand moet de referenties bevatten die nodig zijn om verbinding te maken met deze services. Raadpleeg de onderstaande matrixvereisten voor uw versie voor meer informatie.
• De referenties die u in uw flow hebt opgegeven, moeten overeenkomen met de referenties in uw .json-bestand. Anders kan de flow niet worden uitgevoerd.
• Wanneer u het proces uitvoert, worden de hostnaam, poort en gebruikersnaam gebruikt om de overeenkomende verbinding te vinden in het Tableau-flowbestand (.tfl). Deze worden bijgewerkt voordat het proces wordt uitgevoerd. De poort-ID en site-ID zijn optioneel als uw verbindingen deze informatie niet nodig hebben.

• Als u verbinding maakt met een gepubliceerde databron, moet u de hostnaam, contentUrl en poort (80 voor http en 443 voor https) opnemen in de invoerverbindingen. De hostnaam is vereist om de overeenkomende verbinding in het Tableau-flowbestand (.tfl) te vinden, en de contentUrl en poort worden gebruikt om de verbinding met de server tot stand te brengen.

• Als u verbinding maakt met Tableau Cloud, moet u de poort (80 of 443) opnemen in de invoerverbindingen voor de pod waarmee u verbinding maakt. Zorg ervoor dat u in de URI voor serververbindingen het bijbehorende pod-voorvoegsel opneemt, samen met online.tableau.com. Zie Tableau Bridge-verbindingen met Tableau Cloud(Link wordt in een nieuw venster geopend) in de Help van Tableau Cloud voor meer informatie over Tableau Cloud.
• (versie 2021.4.1 en later) Als u parameters in uw flow opneemt, kunt u een .json-bestand voor het overschrijven van parameters maken en dat opnemen in de opdrachtregel. Zo kunt u de huidige standaardwaarden voor parameters wijzigen. Zie Flows uitvoeren die parameterwaarden bevatten voor meer informatie.

Afhankelijk van uw Tableau Prep Builder-versie, is de notatie voor uw referenties mogelijk anders. Klik op het onderstaande tabblad om de juiste referentie-indeling voor uw Tableau Prep Builder-versie te bekijken.

{
    "Parameter 1": Value 1,
    "Number Parameter": 40,
    "Boolean Parameter": True
}				

 "\[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

/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

{
 "tableauServerConnections":[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
 ]
}				

{
 "tableauServerConnections":[
   {
    "serverUrl":"https://my.server",
    "contentUrl": "mysite",
    "port":443,
    "username": "jsmith",
    "password": "passw0rd$"
   }
],
 "databaseConnections":[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port":"5439",
    "username":"jsmith",
    "password":"p@s$w0rd!"
   }
 ]
}

{
 "extensions": [
    {
	  "extensionName": "rSupport",
	  "regular": {
		"host": "localhost",
		"port": "9000",
		"username": "jsmith"
	},
	"sensitive": {	
	  "password": "pwd"	
	}
   },
   {
	"extensionName": "pythonSupport",
	"regular": {
	  "host": "localhost",
	  "port": "9000"
	},
	"sensitive": {
	}
   }
 ],										
 "databaseConnections":[
   {
    "hostname":"example123.redshift.amazonaws.com",
    "port": "5439",
    "username": "jsmith",
    "password": "p@s$w0rd!"
   },
   {
    "hostname":"mysql.mydb.tsi.lan",
    "port": "3306",
    "username": "jsmith",
    "password": "mspa$$w0rd"
   }
 ]
}			

{
 "databaseConnections":[
{
  "hostname":"example123.redshift.amazonaws.com",
  "port": "5439",
  "username": "jsmith",
  "password": "p@s$w0rd!"
 },
 {
   "hostname":"mysql.mydb.tsi.lan",
   "port": "3306",
   "username": "jsmith",
   "password": "mspa$$w0rd"
  }
 ]
}			

{ 
  "inputConnections":[
    {
     "hostname":"https://my.server",
     "contentUrl": "mysite",
     "port":443,								
     "username": "jsmith",
     "password": "passw0rd$"
    }
 ],
  "outputConnections":[
    {
     "serverUrl":"https://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    }
 ]
}

{ 
  "inputConnections":[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  },
    {
     "hostname":"Oracle.example.lan",
     "port":5678,
     "username": "jsmith",				
     "password": "passw0rd" 
  }
], 
  "outputConnections":[
    {
     "serverUrl":"http://my.server",
     "contentUrl":"mysite",
     "username":"jsmith",
     "password":"passw0rd$"
    } 
  ]
}

{ 
  "inputConnections":[
    {
     "hostname":"mysql.example.lan",
     "port":1234,
     "username": "jsmith",				
     "password": "passw0rd"
  }
], 
  "extensions":[
    {
     "extensionName":"rSupport",
     "credentials":{
     "password":"pwd",
    }
  },
   {
	"extensionName" : "pythonSupport",
	"credentials": {
	"password": "pwd"
	}
   } 
  ]
}

Tips voor het maken van uw referentiebestand

Om fouten bij het uitvoeren van de flow te voorkomen, moet u ervoor zorgen dat uw referentiebestand aan de volgende richtlijnen voldoet:

• Als u Tableau Prep Builder versie 2018.2.2 tot en met 2018.3.1 gebruikt, moet u altijd de matrixen 'inputConnections' en 'outputConnections' opnemen, zelfs als de flow geen externe verbindingen voor invoer of uitvoer heeft. Laat deze matrixen gewoon leeg.

  Als u Tableau Prep Builder versie 2018.3.2 en hoger gebruikt, hoeft u de lege matrix niet op te nemen.

  • Geen externe verbinding voor invoer? Voeg deze syntaxis toe bovenaan het .json-bestand

    {
     "inputConnections":[
      ],

  • Geen externe verbinding voor uitvoer? Voeg deze syntaxis toe onderaan het .json-bestand

  "outputConnections":[
    ]
  }

• Er is geen poort-ID voor uw invoerverbinding, of de poort is opgegeven als onderdeel van de servernaam.

  Als er geen poort-ID voor uw verbinding is, neem dan geen"port":xxxx,-referentie op in het .json-bestand, zelfs niet "port": "". Als de poort-ID is opgenomen in de servernaam, neem de poort-ID dan op in de hostnaam. Bijvoorbeeld: "hostname": "mssql.example.lan,1234"

• Als u verwijst naar de "serverUrl": moet u geen '/' opnemen aan het einde van het adres. Gebruik bijvoorbeeld "serverUrl": "http://server", maar niet "serverUrl": "http://server/".

• Als u meerdere invoer- of uitvoerverbindingen hebt, moet u de referenties voor elke verbinding in het bestand opnemen.

• Als u verbinding maakt met gepubliceerde databronnen, zorg er dan voor dat u de hostnaam en contentUrl in de invoerverbindingen opneemt.

De flow uitvoeren

Belangrijk: De onderstaande voorbeelden bevatten de naamswijziging voor 'Tableau Prep' versie 2019.1.2 naar 'Tableau Prep Builder'. Als u een eerdere versie van het product gebruikt, gebruikt u in plaats daarvan 'Tableau Prep'.

1. Open de opdrachtprompt of terminalopdrachtprompt (MacOS) als beheerder.

2. Voer een van de volgende opdrachten uit met de onderstaande syntaxis.

   • De flow maakt verbinding met lokale bestanden of bestanden die zijn opgeslagen op een netwerkshare en publiceert naar lokale bestanden, bestanden die zijn opgeslagen op een netwerkshare, of de flow maakt gebruik van Windows-verificatie:

     Opmerking: Als u verbinding maakt met of uitvoer uitvoert naar bestanden die zijn opgeslagen op een netwerkshare, gebruikt u de UNC-indeling voor het pad: \\server\pad\bestandsnaam. Er kan geen wachtwoordbeveiliging worden toegepast.

     Windows

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

     Mac

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

   • De flow maakt verbinding met databases of publiceert op een server:

     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"

     Mac

     /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

   • Het flowbestand of het referentiebestand wordt opgeslagen op een netwerkshare (gebruik de UNC-indeling voor het pad: \\server\pad\bestandsnaam):

     Windows

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

     Mac: Koppel de netwerkshare aan /Volumes in Finder zodat deze permanent is en gebruik vervolgens /Volumes/.../[your file] om het pad op te geven:

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

Zie Veelvoorkomende fouten bij gebruik van de opdrachtregel om flows uit te voeren voor meer informatie over veelvoorkomende fouten en oplossingen.

De flow uitvoeren met incrementeel vernieuwen ingeschakeld

Ondersteund in Tableau Prep Builder versie 2020.2.1 en later, en op internet vanaf versie 2020.4. Incrementele vernieuwing wordt momenteel niet ondersteund bij het schrijven van flowuitvoer naar Microsoft Excel.

Als Tableau Prep Conductor niet is ingeschakeld op uw server om uw flow-uitvoeringen te plannen, kunt u uw flow uitvoeren met behulp van incrementele vernieuwing vanaf de opdrachtregel. Voeg eenvoudig de parameter --incrementalRefresh toe aan uw opdrachtregel zoals in het onderstaande 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"

Mac

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

Als incrementele vernieuwing is ingeschakeld in de invoerstappen in uw flow en de parameters voor incrementele vernieuwing correct zijn geconfigureerd, doet Tableau Prep Builder het volgende:

• Alle invoerflows in de flow waarvoor incrementele vernieuwing is ingeschakeld, voeren alle bijbehorende uitvoerflows uit met incrementele vernieuwing.
• Als er geen invoer in de flow is waarvoor incrementele vernieuwing is ingeschakeld, worden alle uitvoerdata uitgevoerd met volledige vernieuwing. Er verschijnt een bericht met de details van de vernieuwingsmethode.
• Als incrementele vernieuwing is ingeschakeld voor sommige invoerdata in de flow, worden de bijbehorende uitvoerdata uitgevoerd met incrementele vernieuwing. De overige uitvoer wordt uitgevoerd met volledige vernieuwing en er verschijnt een bericht met de details van de vernieuwingsmethode.

Zie Flowdata vernieuwen met incrementele vernieuwing voor meer informatie over het configureren van flows om incrementele vernieuwing te gebruikenFlowdata vernieuwen met incrementele vernieuwing

Opdrachtopties

Als u de Help-opties wilt bekijken, voegt u -h toe in de opdrachtregel.

usage: tableau-prep-cli [-c <arg>] [-d]  [-h] [-t <arg>]

-c,--connections <arg>        Path to a file with all connection information

-d,--debug                    This option is for debugging

-dsv,--disableSslValidation   Disable SSL validation

-h,--help                     Print usage message

-inc,--incrementalRefresh     Run incremental refresh for all outputs that are configured to support it

-t,--tflFile <arg>            The Tableau Prep Builder flow file	

Syntaxis: voorbeelden

De onderstaande opdrachtregels tonen vier verschillende voorbeelden voor het uitvoeren van een flow met behulp van de volgende criteria:

• Tableau Prep Builder-versie: 2022.1.1

  Belangrijk: De onderstaande voorbeelden omvatten de naamswijziging voor Tableau Prep versie 2019.1.2 naar Tableau Prep Builder. Als u een eerdere versie van het product gebruikt, gebruikt u in plaats daarvan 'Tableau Prep'.

• Flownaam: Flow1.tfl

• Flowlocatie: C:\Gebruikers\jsmith\Documenten\My Tableau Prep Builder Repository\Flows

• Naam van referentiebestand: Flow 1.json

• Locatie van referentiebestand: C:\Users\jsmith\Desktop\Flow credentials

• Locatie van referentiebestand dat is opgeslagen op een netwerkshare: \tsi.lan\files\Flow credentials

De flow maakt verbinding met en wordt gepubliceerd naar lokale bestanden

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

De flow maakt verbinding met en publiceert naar lokale bestanden en gebruikt de korte vorm voor incrementele vernieuwing

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -inc -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -inc -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

De flow maakt verbinding met databases en wordt gepubliceerd op een server

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\C:\Users\jsmith\Desktop\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Users/jsmith/Desktop/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl

De flow wordt gepubliceerd op een server en het referentiebestand wordt opgeslagen op een netwerkshare

Windows

"\Program Files\Tableau\Tableau Prep Builder 2022.1.1\scripts"\tableau-prep-cli.bat -c "\\tsi.lan\files\Flow credentials\Flow1.json" -t "\C:\Users\jsmith\Documents\My Tableau Prep Builder Repository\Flows\Flow1.tfl"

Mac

/Applications/Tableau\ Prep\ Builder\ 2022.1.1.app/Contents/scripts/./tableau-prep-cli -c /Volumes/files/Flow\ credentials/Flow1.json -t /Users/jsmith/Documents/My\ Tableau\ Prep\ Builder\ Repository/Flows.Flow1.tfl