tabcmd

Opmerking: Het opdrachtregelhulpprogramma tabcmd versie 2.0 is beschikbaar op Tableau tabcmd(Link wordt in een nieuw venster geopend). Met deze nieuwe versie kunt u tabcmd-opdrachten uitvoeren in MacOS en Linux en verificatie uitvoeren met persoonlijke toegangstokens (PAT's). Versie 2.0 is gebouwd op openbare eindpunten die beschikbaar zijn in een op Python gebaseerde Tableau Server Client (TSC). Deze nieuwste versie biedt beperkte ondersteuning voor Tableau Server.

Tableau biedt het opdrachtregelhulpprogramma tabcmd waarmee u taken voor sitebeheer kunt automatiseren voor uw Tableau Server-site. Bijvoorbeeld voor het maken of verwijderen van gebruikers, projecten en groepen.

Opmerking: in Tableau-versies vóór 2024.1 werkt tabcmd versie 1 niet voor het exporteren van visualisaties.

Dit hulpprogramma is inbegrepen bij Tableau Server, en wordt automatisch op de serverknooppunten geïnstalleerd. U kunt het ook vanaf andere computers uitvoeren, zelfs computers die geen deel uitmaken van uw Tableau Server-installatie. Maar daarvoor moet u het tabcmd-installatieprogramma downloaden van de Tableau-website. Zie Tabcmd installeren hieronder voor meer informatie.

Tabcmd installeren

Opmerking: deze instructies zijn bedoeld voor het installeren van het opdrachtregelhulpprogramma tabcmd 1.0. Om het opdrachtregelhulpprogramma tabcmd 2.0 te installeren, gaat u naar Tableau tabcmd(Link wordt in een nieuw venster geopend) (nieuw venster).

Wanneer Tableau Server of Tableau Cloud wordt bijgewerkt naar een nieuwe versie, kunt u, indien een bijgewerkte versie van tabcmd vereist is, deze downloaden van de pagina Tableau Server Release op de Tableau-website.

Voor Tableau Server raden we aan de versie te downloaden die overeenkomt met uw serverversie. Voor Tableau Cloud raden we aan altijd de nieuwste versie te downloaden om problemen door incompatibele versies te voorkomen. In beide gevallen kan het gebruik van een verouderde versie van tabcmd fouten en onvoorspelbare resultaten veroorzaken.

  1. Open een webbrowser en ga naar de pagina Tableau Server Release(Link wordt in een nieuw venster geopend). Ga naar deze pagina, zelfs als u Tableau Online gebruikt.

  2. Als u het volgende gebruikt:

    In beide gevallen geldt: als de uitgebreide informatie onderhoudsreleases aangeeft, selecteert u de nieuwste onderhoudsrelease of de release die overeenkomt met uw serverversie.

    Selecteer de serverversie die u gebruikt (nieuwste versie voor Tableau Cloud)

    Hiermee gaat u naar de pagina met release-opmerkingen, genaamd Opgeloste problemen. Hier kunt u meer lezen over beveiligingsverbeteringen en opgeloste problemen.

  3. Ga naar het deel Bestanden downloaden onder Opgeloste problemen. Download hier de downloadlink voor tabcmd die compatibel is met de computer waarop u de tabcmd-opdrachten wilt uitvoeren. 

    Selecteer het tabcmd-installatieprogramma voor de computer waarop u het wilt gebruiken (32 of 64 bits)

    In de overige stappen wordt naar deze computer verwezen als ’de tabcmd-computer’

  4. Sla het installatieprogramma op de tabcmd-computer op, of op een locatie die toegankelijk is vanaf die computer (bijv. een gemonteerd station).

  5. Voer de installatiestappen uit die geschikt zijn voor het besturingssysteem van de tabcmd-computer:

    • Windows

      tabcmd wordt standaard geïnstalleerd op C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility. U kunt dit tijdens de installatie wijzigen. We adviseren om tabcmd te installeren in een map met de naam tabcmd in de hoofdmap van het C:\-station (C:\tabcmd). Hierdoor kunt u het programma gemakkelijker vinden en uitvoeren. Bovendien worden er enkele beperkingen van het Windows-besturingssysteem ondervangen als u de map tabcmd toevoegt aan het Windows PATH.

      Opmerking het tabcmd-installatieprogramma voegt de tabcmd-map niet toe aan de variabele Windows PATH. U kunt deze handmatig toevoegen, of u kunt het volledige pad naar tabcmd opgeven telkens wanneer u tabcmd aanroept.

      U kunt tabcmd op twee manieren installeren op Windows:

      • Dubbelklik op het installatieprogramma om de stappen in de gebruikersinterface te volgen:

        1. Accepteer de licentieovereenkomst.

        2. Als u op een niet-standaardlocatie wilt installeren, klikt u op Aanpassen en typt u of bladert u naar de locatie waar u tabcmd wilt installeren.

        3. Klik Installeren.

          Als u hierom wordt gevraagd door Windows Defender Firewall of Gebruikersaccountbeheer, klikt u op Toegang toestaan.

      • Voer het installatieprogramma uit vanaf een opdrachtprompt:

        1. Open een opdrachtprompt als beheerder op de tabcmd-computer.

        2. Ga naar de directory waar u het installatieprogramma voor tabcmd hebt geplaatst.

        3. Installeer tabcmd:

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1

          Voor installatie op een niet-standaardlocatie:

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="<path\to\install\directory>"

          Bijvoorbeeld:

          tableau-setup-tabcmd-tableau-<version_code>-x64.exe /quiet ACCEPTEULA=1 INSTALLDIR="C:\tabcmd"

          Voor een volledige lijst met opdrachtregelopties die u kunt gebruiken met het tabcmd-installatieprogramma, voert u het installatieprogramma uit met een /?. Zie Switches en eigenschappen installeren voor tabcmd (Windows) voor meer informatie over de opdrachtregelopties van het tabcmd-installatieprogramma.

      Het tabcmd-installatieprogramma maakt logboeken aan in C:\Users\<user>\AppData\Local\Temp. Deze kunt u gebruiken als u problemen hebt met het installeren van tabcmd. De logboeken gebruiken de naamgevingsconventie Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log.

    • Linux

      Opmerking: om tabcmd op een Linux-computer te kunnen uitvoeren, moet Java 11 geïnstalleerd zijn. Op RHEL-achtige systemen wordt dit als afhankelijkheid geïnstalleerd wanneer u tabcmd installeert. Op Ubuntu-systemen moet u Java 11 apart installeren als dit nog niet het geval is.

      Vanaf juli 2022 worden Debian-distributies niet meer ondersteund. Raadpleeg dit Tableau Community-bericht(Link wordt in een nieuw venster geopend) voor meer informatie.

      1. Meld u aan als gebruiker met sudo-toegang op de tabcmd-computer.

      2. Ga naar de map waar u het .rpm- of .deb-pakket heeft geplaatst dat u hebt gedownload.

        • Op RHEL-achtige distributies, inclusief CentOS, voert u de volgende opdracht uit:

          sudo yum install tableau-tabcmd-<version>.noarch.rpm

        • Op Ubuntu voert u de volgende opdracht uit:

          sudo apt-get install ./tableau-tabcmd-<version>_all.deb

    Om tabcmd van een Linux-computer te verwijderen, raadpleegt u de documentatie voor de Linux-versie die u gebruikt.

  6. (Optioneel) Voeg de volledige locatie waar tabcmd is geïnstalleerd toe aan het systeempad. Zo kunt u tabcmd-opdrachten uitvoeren zonder dat u naar die locatie hoeft te gaan of de locatie bij elke opdracht hoeft op te geven. De stappen die u hiervoor moet nemen, zijn afhankelijk van het type en de versie van uw besturingssysteem. Zie PATH_(variabele) voor meer informatie.

Hoe tabcmd te gebruiken

De basisstappen voor het gebruik van tabcmd zijn als volgt:

  1. Open de opdrachtprompt als beheerder.

    Opmerking: gebruik PowerShell niet om tabcmd-opdrachten uit te voeren in Windows. Het gebruik van PowerShell kan onverwacht gedrag veroorzaken.

  2. Als u tabcmd op een Windows-computer hebt geïnstalleerd die niet het oorspronkelijke knooppunt is, gaat u naar de map waarin u tabcmd hebt geïnstalleerd.

    Op een Linux-computer hoeft u niet naar de installatiemap te gaan.

  3. Voer de opdracht tabcmd uit.

Wanneer u tabcmd gebruikt, moet u een geverifieerde serversessie tot stand brengen. De sessie identificeert de server of Tableau Cloud-site en de gebruiker die de sessie uitvoert. U kunt eerst een sessie starten en vervolgens uw opdracht opgeven, of u kunt een sessie starten en een opdracht in één keer uitvoeren.

Belangrijk: als u tabcmd gebruikt om meer dan één taak uit te voeren, moet u de taken één voor één (serieel) uitvoeren in plaats van tegelijkertijd (parallel).

Opdrachten (zoals login) en de opties (zoals -s, -u, enz.) zijn niet hoofdlettergevoelig. Maar de waarden die u opgeeft (zoals User@Example.com) zijn hoofdlettergevoelig.

Voorbeelden

De volgende opdracht laat zien hoe u een sessie start met de Tableau-server met de naam tabserver.mijnbedrijf.com:

tabcmd login -s http://tabserver.mycompany.com -u admin -p mypassword

Het volgende voorbeeld toont een opdracht die een werkmap verwijdert met de naam Sales_Workbook:

tabcmd delete "Sales_Workbook" 

Hier ziet u hoe u al het bovenstaande met één opdracht kunt bereiken. U hoeft hier geen login op te geven:

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -u admin -p mypassword 

Een Tableau Server kan meerdere sites verwerken. Wanneer een werkmap zich op de standaardsite van een server met meerdere sites bevindt, hoeft u Standaard niet op te geven. De bovenstaande opdracht is voldoende. Als de opdracht van toepassing is op een andere site dan Standaard, moet u de site-ID voor die site echter opgeven (zie login). Hier is dezelfde opdracht voor een werkmap die zich op de bevindt op de site West Coast Sales (site-ID wsales):

tabcmd delete "Sales_Workbook" -s http://tabserver.mycompany.com -t wsales -u admin -p mypassword 

De opties -s, -t, -u en -p behoren tot de algemene tabcmd-variabelen en kunnen met elke opdracht worden gebruikt.

Zie tabcmd-opdrachten voor meer informatie.

Statusberichten en logboeken

Wanneer een opdracht succesvol is, retourneert tabcmd de statuscode nul. Voor statuscodes die niet nul zijn, wordt een volledig foutbericht afgedrukt naar stderr. Bovendien kunnen er informatieve of voortgangsberichten worden afgedrukt naar stdout.

Een volledig logboek met de naam tabcmd.log dat foutoplosssingen, voortgang en foutmeldingen omvat, wordt geschreven naar <home dir>/.tableau/tabcmd/.

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