tabcmd

Nota: La utilidad de línea de comandos tabcmd versión 2.0 está disponible en Tabcmd de Tableau(El enlace se abre en una ventana nueva). Esta nueva versión le permite ejecutar comandos tabcmd en MacOS y Linux y autenticarse mediante tokens de acceso personal (PAT). La versión 2.0 se basa en puntos de conexión públicos disponibles en Tableau Server Client (TSC) basado en Python. Esta última versión tiene soporte limitado para Tableau Server.

Tableau proporciona la utilidad de línea de comandos tabcmd, que puede usar para automatizar las tareas de administración de su sitio de Tableau Server. Por ejemplo, para crear o eliminar usuarios, proyectos y grupos.

Nota: En las versiones de Tableau anteriores a la 2024.1, la versión 1 de tabcmd no funciona para exportar visualizaciones.

Esta utilidad se incluye con Tableau Server y se instala automáticamente en los nodos del servidor. También puede ejecutarla desde otros equipos, incluso aquellos que no formen parte de la instalación de Tableau Server, pero para ello tendrá que descargar el instalador de tabcmd del sitio web de Tableau. Para obtener más información, consulte Instalar tabcmd más adelante.

Instalar tabcmd

Nota: Estas instrucciones son para instalar la utilidad de línea de comandos tabcmd 1.0. Para instalar la utilidad de línea de comandos tabcmd 2.0, vaya a Tableau tabcmd(El enlace se abre en una ventana nueva) (ventana nueva).

Cuando Tableau Server o Tableau Cloud se actualiza a una nueva versión, si se requiere una versión actualizada de tabcmd, puede descargarla desde la página de versiones de Tableau Server en el sitio web de Tableau.

Para Tableau Server, recomendamos que descargue la versión que coincida con su versión de servidor. Para Tableau Cloud, le recomendamos que descargue siempre la versión más reciente para evitar problemas causados por incompatibilidades de versiones. En cualquier caso, si utiliza una versión obsoleta de tabcmd se pueden producir errores y resultados imprevisibles.

  1. Abra un navegador web y vaya a la página Versiones de Tableau Server(El enlace se abre en una ventana nueva). Vaya a esta página incluso si utiliza Tableau Online.

  2. Si estás usando:

    En cualquier caso, si la información ampliada muestra versiones de mantenimiento, seleccione la última versión de mantenimiento o la que coincida con la versión de su servidor.

    Seleccione la versión que use del servidor (última versión de Tableau Cloud)

    Esto le llevará a la página de notas de la versión, llamada Problemas resueltos, donde puede leer las mejoras de seguridad y los problemas resueltos.

  3. Desplácese a la sección Descargar archivos en los problemas resueltos y seleccione el enlace de descarga de tabcmd que sea compatible con el equipo desde el que ejecutará los comandos de tabcmd. 

    Seleccione el instalador de tabcmd para el equipo en la que lo vaya a usar (32 o 64 bits)

    En el resto de los pasos, nos referiremos a este equipo como "el equipo de tabcmd".

  4. Guarde el instalador en el equipo de tabcmd o en una ubicación a la que se pueda acceder desde ese equipo (una unidad montada, por ejemplo).

  5. Complete los pasos de instalación según proceda para el sistema operativo del equipo de tabcmd:

    • Windows
    • Linux

    Para desinstalar tabcmd desde un equipo Linux, consulte la documentación de la variedad linux que está ejecutando.

  6. (Opcional) Añada la ubicación totalmente cualificada en la que está instalado tabcmd a su ruta de acceso al sistema para que pueda ejecutar los comandos de tabcmd sin cambiar a esa ubicación, o especificando la ubicación con cada comando. Los pasos para hacerlo dependen del tipo y la versión de su sistema operativo. Para más información, consulte PATH_(variable).

Cómo usar tabcmd

Los pasos básicos para usar tabcmd son los siguientes:

  1. Abra el símbolo del sistema como administrador.

    Nota: No utilice PowerShell para ejecutar comandos tabcmd en Windows. El uso de PowerShell puede causar un comportamiento inesperado.

  2. En un equipo Windows, si instaló tabcmd en un equipo distinto del nodo inicial, cambie al directorio donde instaló tabcmd.

    En un equipo Linux, no tiene que cambiar al directorio de instalación.

  3. Ejecute el comando tabcmd.

Al usar tabcmd, debe establecer una sesión de servidor autenticada. La sesión identifica el servidor o el sitio de Tableau Cloud y el usuario que ejecuta la sesión. Primero puede iniciar una sesión, luego especificar su siguiente comando o puede iniciar una sesión y ejecutar un comando, todo a la vez.

Importante: Si usa tabcmd para realizar más de una tarea, deberá ejecutar las tareas de una en una (en serie), en lugar de ejecutarlas al mismo tiempo (en paralelo).

Los comandos (como login) y las opciones (como -s, -u, etc.) no distinguen entre mayúsculas y minúsculas, pero los valores que proporcione (como User@Example.com) sí lo hacen.

Ejemplos

El siguiente comando demuestra cómo iniciar una sesión con Tableau Server denominada tabserver.mycompany.com:

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

El siguiente ejemplo muestra un comando que elimina el libro de trabajo denominado Sales_Workbook:

tabcmd delete "Sales_Workbook" 

Aquí se muestra cómo lograr todo lo anterior con un comando: observe que no necesita login aquí:

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

Tableau Server puede ejecutar varios sitios. Cuando hay un libro de trabajo en el sitio Predeterminado de un servidor de varios sitios, no necesita especificar Predeterminado. Basta con el comando anterior. Sin embargo, si el comando se aplica a algo del sitio que no sea Predeterminado, necesita especificar el identificador del sitio para dicho sitio (consulte login). Este es el mismo comando para un libro de trabajo que está en el sitio West Coast Sales (identificador de sitio wsales):

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

Las opciones -s, -t, -u, and -p están entre las variables globales de tabcmd, lo que significa que se pueden usar con cualquier comando.

Para obtener más información, consulte Comandos de tabcmd.

Mensajes de estado y registros

Cuando un comando es exitoso, tabcmd arroja un código de estado cero. Un mensaje de error completo para códigos de estado que no son cero se imprime en stderr. Además, es posible que se impriman mensajes informativos o de progreso en stdout.

Un registro completo con el nombre tabcmd.log, incluidos mensajes de depuración, progreso y error, se escribe en <home dir>/.tableau/tabcmd/.