Ayuda de Tableau Cloud

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 Cloud. Por ejemplo, para crear o eliminar usuarios, proyectos y grupos.

Importante: tabcmd 1.0 no es compatible con la autenticación multifactor (MFA). Para usar tabcmd con Tableau Cloud, use Tableau tabcmd 2.0(El enlace se abre en una ventana nueva) (ventana nueva). Para obtener más información sobre Tableau con MFA, consulte Autenticación multifactor y Tableau Cloud.

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:

   • Tableau Cloud: utilice Tableau tabcmd 2.0(El enlace se abre en una ventana nueva) (ventana nueva).
   • Tableau Server (Windows o Linux): seleccione la versión que coincida con la versión de su servidor.

   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.

   

   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. 

   

   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 .

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

   • Windows

     De manera predeterminada, tabcmd se instala en C:\Program Files\Tableau\Tableau Server\<version>\extras\Command Line Utility. Puede cambiar esto durante la instalación y recomendar que se instale tabcmd en una carpeta llamada tabcmd en la carpeta raíz de la unicad C:\ (C:\tabcmd). Esto puede hacer que sea más fácil de localizarlo y ejecutarlo y acomodará algunas limitaciones con el sistema operativo Windows si agrega el directorio tabcmd a la ruta de Windows.

     Nota El programa de configuración de tabcmd no agrega el directorio de tabcmd a la variable PATH de Windows. Puede agregarlo de forma manual o puede incluir la ruta completa a tabcmd cada vez que lo llame.

     Puede instalar tabcmd de dos maneras en Windows:

     • Haga doble clic en el instalador para seguir los pasos de la interfaz de usuario:

       1. Acepte el acuerdo de licencia.

       2. Si desea instalar en una ubicación que no sea la predeterminada, haga clic en Personalizar y escriba o busque la ubicación en la que desea instalar tabcmd.

       3. Haga clic en Instalar.

          Si se muestra un mensaje del Firewall de Windows Defender o de la cuenta de usuario, haga clic en Permitir acceso.

     • Ejecute el instalador desde el símbolo del sistema:

       1. Abra el símbolo del sistema como administrador en el equipo en el que quiera usar tabcmd.

       2. Vaya al directorio donde copió el programa de instalación de tabcmd.

       3. Instalar tabcmd:

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

          Para realizar la instalación en una ubicación personalizada:

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

          Por ejemplo:

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

          Para obtener una lista completa de las opciones de línea de comandos que puede utilizar con el instalador de tabcmd, ejecute el instalador con un /?. Para obtener más información sobre las opciones de línea de comandos del instalador de tabcmd, consulte Instalar conmutadores y propiedades para tabcmd (Windows).

     El programa de instalación de tabcmd crea registros en C:\Users\<user>\AppData\Local\Temp que puede utilizar si tiene problemas para instalar tabcmd. Los registros utilizan la nomenclatura Tableau_Server_Command_Line_Utility_(<version_code>)_##############.log.

   • Linux

     Nota: Para ejecutar tabcmd en un equipo Linux, debe tener instalado Java 11. En sistemas de tipo RHEL esto se instalará como una dependencia cuando se instale tabcmd. En sistemas Ubuntu, necesita instalar Java 11 por separado si no está ya instalado.
     
     A partir de julio de 2022, las distribuciones de Debian ya no son compatibles. Para obtener más información, consulte esta publicación de la Comunidad de Tableau(El enlace se abre en una ventana nueva).

     1. Inicie sesión como usuario con acceso sudo en el equipo de tabcmd.

     2. Vaya al directorio en el que copió el paquete .rpm o .deb que ha descargado.

        • En distribuciones de tipo RHEL, incluido CentOS, ejecute el siguiente comando:

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

        • En Ubuntu, ejecute el comando siguiente:

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

   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

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.