Solucionar problemas de Tableau Prep Builder

Este artículo muestra los problemas que podría encontrarse al usar Tableau Prep Builder y sugerencias sobre cómo solucionarlos.

Al solucionar problemas con el flujo, ya sea para depurar usted mismo o para ponerse en contacto con el soporte técnico, normalmente necesitará recopilar los archivos de registro y los archivos de volcado de memoria para su análisis, así como documentar los pasos necesarios para reproducir el error. Proporcionar los pasos exactos que realizó antes de que se produjera el error, así como proporcionar el archivo de flujo, es la mejor manera de ayudar al desarrollador o al equipo de soporte técnico a diagnosticar el problema.

Recopilar archivos de registro y de volcado de memoria

Los archivos de registro de Tableau Prep se almacenan en la carpeta Mi repositorio de Tableau Prep. De forma predeterminada, la ubicación es:

Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Logs.

MacOS: /users/<username>/Documents/My Tableau Prep Repository/Logs

Para diagnosticar correctamente el problema, deberá recopilar todos los archivos de registro. Si ejecuta Tableau Prep Builder, esto es todo lo que hay en la carpeta “Mi repositorio de Tableau Prep/Registros”. Si ejecuta Tableau Prep desde la línea de comandos, incluya los archivos de registro de “Mi repositorio de Tableau Prep/Repositorio de línea de comandos/Registros”.

Esta tabla describe los diferentes archivos de registro que se generan.

Nombre de archivo de registro	Proceso que genera el archivo de registro	Descripción
app.log	Tableau Prep.exe	Archivo de registro de la interfaz de usuario. Esto es producido por el código JavaScript que se ejecuta en el proceso Electron.
backendProcessManager.log	Tableau Prep.exe	Esto es producido por el código JavaScript que se inicia y supervisa el proceso de Java.
preprestapi.log	Java.exe	Este es el archivo de registro producido por el código Java. Las entradas de registro relacionadas con el uso de la API de REST, la compilación, la administración de caché y el inicio y apagado del proceso tabminerva (anteriormente prepservice) deben estar aquí.
log.txt	prepservice.exe tabminerva.exe	Este registro se genera con el código C++. Este registro incluye toda la interacción con la pila de tecnología compartida de Tableau, incluidas las conexiones a bases de datos, las consultas, la ejecución, el almacenamiento en caché externo, la canalización de consultas, los protocolos, etc.
tdeserver.txt	tdeserver64.exe	Este es el archivo de registro creado por el antiguo motor de datos de Tableau. Tableau Prep todavía utiliza el motor de datos de Tableau.
tabprotosrv.txt	tabprotosrv.exe	Registro del servidor de protocolo. Cualquier elemento en el que utilice un controlador de base de datos alojado generará líneas de registro en este archivo.
hyperd.log	hyperd.exe	El registro de Hyper. Las consultas y los errores relacionados con las consultas están aquí.

Habilitar el registro de consultas

A partir de Tableau Prep Builder versión 2026.2, puede activar la configuración Habilitar registro de consultas en el menú Ayuda > Configuración y rendimiento sin tener que reiniciar la aplicación. Cuando está activada, esta configuración genera un archivo de consulta XML para cada consulta que ejecuta Tableau Prep Builder. Esto puede ser útil a la hora de diagnosticar problemas con su flujo. Los registros se generan y almacenan en la carpeta Consulta.

Menú Ayuda en Tableau Prep que muestra las opciones del menú Configuración y Rendimiento.

Encontrará estos registros de consultas en las siguientes ubicaciones:

Windows: C:\Users\<username>\Documents\My Tableau Prep Repository\Query

MacOS: /users/<username>/Documents/My Tableau Prep Repository/Query

Ejecutar LogShark

LogShark es una utilidad de línea de comandos de código abierto gratuita que puede usar para extraer información de los archivos de registro de Prep para solucionar problemas y obtener información sobre errores y uso. Usando el complemento de LogSharkPrep.twbx, puede generar libros de trabajo con un panel de error y flujo para ayudarlo a analizar y visualizar los problemas de Prep.

Para obtener información sobre cómo instalar y ejecutar LogShark, consulte Cómo configurar su equipo para LogShark.

Creación de archivos de volcado de memoria

Además de los archivos de registro, también debe recopilar archivos de volcado de memoria de bloqueo. Todo lo que no esté en los archivos de registro se puede detallar aquí y puede ayudar a solucionar problemas de inicio de la aplicación, excepciones o problemas al consultar .hyper.

Al crear archivos de volcado de bloqueo, es útil crearlos para los siguientes procesos.

Proceso	Descripción
tabminerva.exe (anteriormente prepservice.exe)	Este es el proceso nativo que aloja el resto de la lógica empresarial de Tableau Prep. También es el proceso que contiene la tecnología nativa compartida de Tableau, incluidos los conectores de bases de datos.
hyperd.exe	Este es el proceso de la base de datos Hyper. Cada vez que una consulta falla. Los volcados de memoria de Hyper pueden ser útiles cuando se produce un error, ya que gran parte de lo que hace Tableau Prep implica consultas a Hyper.

Para crear archivos de volcado de bloqueo, haga lo siguiente, en función de su sistema operativo.

Windows

Abra el Administrador de tareas.
Haga clic con el botón derecho del ratón en el encabezado de la columna y seleccione Nombre del proceso y Línea de comandos. Aquí se muestran los diferentes procesos y se permite seleccionar el que se desea usar para crear un archivo de volcado de memoria de bloqueo.
Haga clic con el botón derecho en el proceso tabminerva.exe (antes prepservice.exe).
Seleccione Crear archivo de volcado.
Se abrirá un cuadro de diálogo y se mostrará la ubicación del archivo de volcado de memoria en el sistema.

MacOS

En MacOS, hay dos tipos de archivos de diagnóstico útiles para solucionar problemas de Tableau Prep:

Informe de bloqueo: registra la pila de llamadas en el momento del bloqueo, de forma similar a un seguimiento de pila.
Archivo principal: una instantánea completa de la memoria del proceso en el momento de la finalización.

Ambos requieren la finalización del proceso de Tableau Prep. Deberá volver a iniciar Tableau Prep después de recopilar estos archivos.

Requisito previo: Se requiere acceso de administrador para la recopilación de archivos principales.

Paso 1: Crear un informe de error

Abra Terminal.
Ejecute el comando: pgrep tabminerva | xargs kill -SEGV
Esto finaliza el proceso de tabminerva.exe enviándole una señal de error de segmentación, lo que hace que MacOS genere un informe de bloqueo automáticamente.
Busque el informe de bloqueo guardado en: ~/Library/Logs/DiagnosticReports/
El nombre del archivo sigue el formato tabminerva_YYYY-MM-DD-HHMMSS_machinename.crash o tabminerva_YYYY-MM-DD-HHMMSS_machinename.ips

Al enviar este archivo al equipo de soporte de Tableau o al equipo de desarrollo, asegúrese de indicar que envió intencionalmente una señal de error de segmentación para generar el informe. Esto lo distingue de un bloqueo real.

Paso 2: Crear un archivo principal

Use una de las siguientes opciones para crear su archivo principal.

Crear un archivo de núcleo y finalizar la sesión de Tableau Prep

Abra Terminal.
Ejecute el comando sudo chmod 1777 /cores para conceder acceso de escritura al directorio de archivos principal.
Ejecute el comando ulimit -c unlimited para eliminar el límite en el tamaño del archivo principal para la sesión de terminal actual.
Ejecute el comando pgrep tabminerva | xargs kill -SEGV para finalizar el proceso y generar el archivo central.
Encuentre el archivo principal en /cores/ y llamado core.<process_id>.

Crear un archivo de núcleo y mantener Tableau Prep en funcionamiento

Esta opción utiliza una utilidad gcore para capturar un volcado de memoria de un proceso en ejecución sin finalizarlo. Este proceso requiere la instalación de la herramienta de línea de comandos de Xcode. Para comprobar si tiene esta opción instalada, abra el terminal y ejecute Bash xcode-select --install.

Abra Terminal.
Ejecute el comando: sudo gcore -o /tmp/tabminerva.core $(pgrep tabminerva)
Esto guarda el archivo principal en /tmp/tabminerva.core. Tableau Prep sigue ejecutándose con normalidad.

Errores comunes al utilizar la línea de comandos para ejecutar flujos

Puede ejecutar flujos desde la línea de comandos para actualizar sus archivos de salida en lugar de abrir Tableau Prep Builder para ejecutar cada flujo de forma manual. Aunque este proceso ayuda a crear eficiencia en el proceso del flujo, si la sintaxis no es correcta o si faltan las credenciales para sus conexiones o ubicaciones de salida, recibirá errores cuando se ejecute este proceso.

Para obtener una lista de todas las opciones de línea de comandos admitidas en Tableau Prep, consulte Referencia de la línea de comandos de Tableau Prep(El enlace se abre en una ventana nueva).

La tabla siguiente describe errores comunes y cómo resolverlos. Para obtener información sobre cómo ejecutar flujos desde la línea de comandos, consulte Actualizar los archivos de salida del flujo desde la línea de comandos(El enlace se abre en una ventana nueva).

Error	Causa	Cómo corregirlo
"Faltan argumentos"	Falta uno de los argumentos necesarios de la línea de comandos.	Utilice "tableau-prep-cli -help" para ver una lista de los argumentos para la línea de comandos.
"No se puede leer el archivo de conexiones."	Existen algunos errores en la sintaxis o en el formato del archivo credentials.json para las conexiones de entrada.	Compruebe la sintaxis de las conexiones de entrada en el archivo .json. Para obtener más información y ejemplos, consulte Actualizar los archivos de salida del flujo desde la línea de comandos(El enlace se abre en una ventana nueva).
"Existen errores en el flujo. No se puede ejecutar el flujo. Compruebe que el archivo de credentials.json incluye todas las credenciales necesarias. Abra el flujo en Tableau Prep Builder para ver los detalles del error."	Faltan credenciales en el archivo credentials.json para las conexiones de entrada o el flujo tiene errores.	Compruebe que el archivo .json dispone de las credenciales para todas las conexiones y abra el archivo de flujo en Tableau Prep Builder para ver si hay algún error en el flujo. Si el flujo tiene errores, debe corregirlos y volver a publicar el flujo en Tableau Server y, a continuación, vuelva a ejecutar el proceso de nuevo.
"No se ha podido encontrar ninguna coincidencia para <nombre de host de las conexiones de entrada>"	Falta una entrada en el archivo credentials.json para el nombre de host (nombre de servidor).	Asegúrese de que el archivo credentials.json incluye las credenciales correctas para el nombre de host (nombre de servidor). Para obtener más información y ejemplos, consulte Actualizar los archivos de salida del flujo desde la línea de comandos(El enlace se abre en una ventana nueva)
"No dispone de credenciales para todas las conexiones del archivo tfl/tflx. No se han encontrado las conexiones siguientes: <nombre de host de las conexiones de entrada>"	Falta el archivo credentials.json o no dispone de las credenciales adecuadas para el nombre de host (nombre de servidor) mostrado en el mensaje de error.	Asegúrese de que el archivo credentials.json incluye las credenciales correctas para el nombre de host (nombre de servidor) incluido en el mensaje de error. Para obtener más información y ejemplos, consulte Actualizar los archivos de salida del flujo desde la línea de comandos.
"Error al iniciar sesión en el servidor <Url del servidor> como el usuario <nombre de usuario>. Compruebe las credenciales."	El archivo credentials.json no dispone de las credenciales correctas para Tableau Server.	Asegúrese de que el archivo credentials.json incluye todas las credenciales y elementos correctos para la conexión de salida. Para obtener más información y ejemplos, consulte Actualizar los archivos de salida del flujo desde la línea de comandos
"No se ha podido iniciar sesión correctamente como <nombre de usuario> en el servidor <Url del servidor>(<Url del contenido>)"	El archivo credentials.json no dispone de las credenciales correctas para Tableau Server.	Asegúrese de que el archivo credentials.json incluye todas las credenciales y elementos correctos para la conexión de salida. Para obtener más información y ejemplos, consulte Actualizar los archivos de salida del flujo desde la línea de comandos
"No disponemos de las credenciales para que Tableau Server publique el extracto de uno o más nodos de salida en el archivo tfl/tflx."	El archivo credentials.json no se ha pasado como un argumento de línea de comandos o le faltan las credenciales para la conexión de salida.	Asegúrese de que la ruta del archivo credentials.json se ha incluido en la línea de comandos y compruebe que el archivo credentials.json incluye todas las credenciales y elementos correctos para la conexión de salida. Para obtener más información y ejemplos, consulte Actualizar los archivos de salida del flujo desde la línea de comandos
"El servidor Loom rest api no se ha iniciado"	La instalación o la configuración del entorno no son correctos.	Asegúrese de que Tableau Prep Builder se ha instalado correctamente y de que está ejecutando el comando como administrador. Para obtener información sobre cómo instalar Tableau Prep Builder, consulte Instalar Tableau Desktop o Tableau Prep Builder desde la interfaz de usuario(El enlace se abre en una ventana nueva).
"Error. El archivo de flujo no existe."	La ruta del archivo de flujo es incorrecta.	Asegúrese de que se ha incluido la ruta correcta para el archivo de flujo en la línea de comandos.
"Error. El archivo de conexiones no existe."	La ruta del archivo credentials.json es incorrecta.	Asegúrese de que se ha incluido la ruta correcta para el archivo credentials.json en la línea de comandos.
"No se ha podido encontrar ninguna coincidencia para <mapr01:5181>,<mapr02:5181>,<mapr03:5181>"	Debe especificar un identificador de puerto específico al conectarse a Apache Drill mediante ZooKeeper.	Incluya un archivo credentials.json en la línea de comandos en que se especifique "puerto": 31010 para las credenciales de entrada.

Errores comunes de Tableau Prep

En la tabla siguiente se describen algunos errores comunes que puede encontrar al usar Tableau Prep, junto con las soluciones que puede probar.

Error	Causa	Cómo corregirlo	Artículo de Knowledge
No puede conectarse a Tableau Server. Compruebe que el servidor se esté ejecutando y que la URL sea correcta. `tableauErrorCode=0xD5A9A6F9; tableauStatusCode=UNAUTHENTICATED; exceptionName=VizportalAuthenticationException`	Un proxy o firewall impide que el navegador insertado de Tableau Prep Builder complete el protocolo de enlace de inicio de sesión de Tableau Cloud.	Trabaje con TI para agregar URL de Tableau Cloud a través del proxy. Cierre sesión y vuelva a iniciarla desde Tableau Prep Builder. Si se ha implementado un script de configuración de proxy automático, compruebe que maneja la autenticación sin solicitar credenciales.	No se puede iniciar sesión en Tableau Online desde Tableau Prep Builder en un entorno de proxy que requiere autenticación(El enlace se abre en una ventana nueva)
Puede que falte el certificado SSL requerido o que no coincida con el certificado de Tableau Server para [serverhostname]. También se ve como “No se puede encontrar la ruta de certificado solicitada para el ID de flujo” al ejecutar flujos en el servidor.	Falta el archivo de cadena del certificado SSL en Tableau Server o el archivo de cadena no está instalado en el equipo que ejecuta Tableau Prep Builder. En algunos casos, el problema se debe a que un equilibrador de carga de AWS utiliza una política TLS incompatible.	Compruebe que el archivo de cadena de certificados SSL esté cargado en Tableau Server. Instale el certificado en el equipo que ejecuta Prep Builder (si al hacer doble clic y seleccionar “Instalar certificado” se devuelve “El archivo no es válido para su uso como se sigue: Certificado de seguridad”, el archivo de certificado en sí puede tener un formato malformado. Trabaje con TI para exportar un archivo de cadena válido. Si está detrás de un equilibrador de carga de AWS, cambie la política a ELBSecurityPolicy-TLS-1-2-2017-01.	Error: Puede que falte el certificado SSL requerido o que no coincida con el certificado de Tableau Server: Iniciar sesión desde Tableau Prep(El enlace se abre en una ventana nueva)
Tableau Prep Builder ha dejado de ejecutarse porque un proceso subyacente se ha detenido de forma inesperada. Si el problema continúa, pruebe a reiniciar el producto.	Esto puede deberse a múltiples factores: configuración de VPN/red (confirmada con Cato Network VPN bloqueando la comunicación del host local), interferencia antivirus o un archivo de puerto dañado al abrir un archivo .tfl específico. Nota: Tableau Prep Builder nunca debe instalarse en un nodo de Tableau Server. Esta es una causa conocida de este error.	Reinstale, verifique las exclusiones de AV, verifique la comunicación IPv4/IPv6 del host local Si es específico de VPN, pruebe con una VPN alternativa para aislar. Involucre al equipo de red para verificar si hay bloqueos de localhost Si está vinculado a un archivo .tfl específico, recopile registros de Prep y volcados de IPS para investigar los bloqueos del proceso de tabminerva Compruebe que Tableau Prep Builder no esté instalado en ningún nodo de Tableau Server.	Error: Tableau Prep dejó de ejecutarse porque un proceso subyacente se detuvo inesperadamente al iniciar Tableau Prep(El enlace se abre en una ventana nueva)
Error en la evaluación de AqlProcessor: Canceled”: el flujo falla después de un paso de tabla dinámica	Problema conocido al cambiar el valor de una columna de tabla dinámica después del paso de tabla dinámica.	Nota: Esta solución se aplica a las versiones 2022.2 y posteriores. Actualice a una versión cubierta por la corrección. Como solución alternativa en versiones anteriores, evite modificar los valores de columna de tabla dinámica en pasos descendentes de la tabla dinámica.	Error: Error del sistema: se produjo un error al comunicarse con la fuente de datos (LoomDataSource) al cambiar el valor de una columna dinámica después del paso de tabla dinámica(El enlace se abre en una ventana nueva)
No se puede publicar la fuente de datos”: el flujo se ejecuta correctamente localmente o al generarse en un archivo .hyper, pero falla al publicar en Tableau Cloud.	El flujo falla debido a que el tamaño del archivo temporal supera los límites de Tableau Cloud. También se ve cuando un flujo falla con errores SQL relacionados con la memoria (por ejemplo, grandes operaciones JOIN) que solo aparecen en Tableau Cloud, no localmente.	Cambie la salida a un archivo .hyper local para confirmar que el problema es específico de la nube. Reduzca la complejidad del flujo, divida en flujos más pequeños, elimine columnas no utilizadas o utilice conexiones en tiempo real.	N/D
Prep Builder no se abre en Windows. Los registros de depuración muestran un error relacionado con la ruta de una carpeta temporal relativa.	La variable de entorno Windows TEMP se establece en una ruta relativa (p. ej., `%USERPROFILE%\AppData\Local\Temp`) o contiene una entrada de ruta duplicada. Tableau Prep Builder necesita una ruta absoluta.	Compruebe que la variable de entorno TEMP de Windows está establecida en una ruta absoluta (por ejemplo, `C:\Users[username]\AppData\Local\Temp`) Elimine cualquier entrada duplicada de la variable TEMP.	N/D

Otros artículos de esta sección

Volver arriba

¡Gracias por sus comentarios!

Sus comentarios se han enviado correctamente. ¡Gracias!

Ayuda de Tableau Prep