DataWorks:Depurar nodos y flujos de trabajo

Requisito previo

Debe haber desarrollado un nodo. Para obtener más información, consulte Data Studio.

Contexto

Puede debug a single node o debug a workflow. Una vez finalizada la ejecución, puede consultar los resultados en Operating history, usar un ad hoc query para inspeccionar datos y process the query results.

• Al depurar un solo nodo o un flujo de trabajo, no se le cobra por los recursos de programación de DataWorks, pero sí por los motores de cómputo utilizados. Para más detalles sobre las tarifas de los motores de cómputo, consulte la documentación de facturación del motor correspondiente.

• Las consultas que utilizan aceleración de consultas tienen un tiempo máximo de ejecución de 1 hora.

Depurar un solo nodo

1. Vaya a la página Data Studio. En el panel de navegación izquierdo, bajo Data Development o Manually Triggered Workflow, localice el flujo de trabajo deseado y haga doble clic en el nodo que desea editar.

2. Ejecute el nodo para depurarlo.

   En la pestaña del editor del nodo, utilice Run o Run with Parameters de la barra de herramientas para depurar la lógica del código. También puede usar Quick run para depurar un fragmento de código. La siguiente tabla describe cada opción.

   Nota

   Si no cuenta con permisos sobre los datos que desea consultar al ejecutar un nodo, consulte Overview of permission management for compute engines and data para conocer el control de permisos de los distintos motores de cómputo en DataWorks.

   Opción de ejecución	Descripción	Caso de uso
   Run (icono )	Esta opción permite asignar valores a variables y especificar un resource group para pruebas. Esta configuración se guarda para ejecuciones futuras. Nota Al ejecutar por primera vez un nodo recién creado, aparece un cuadro de diálogo de configuración. Debe asignar manualmente valores constantes a las variables del código. DataWorks guarda los valores asignados. En la siguiente ejecución del nodo, se utiliza de forma predeterminada la configuración guardada.	Utilice esta opción cuando necesite depurar código con frecuencia.
   Run with Parameters (icono )	Cada vez que ejecute el nodo, deberá asignar valores constantes a las variables del escenario de prueba y especificar un resource group.	Utilice esta opción cuando necesite modificar los valores asignados a las variables del código o cambiar el resource group utilizado por la tarea.
   Quick run (icono )	Esta opción permite depurar un fragmento de código dentro del área de código en la pestaña del editor del nodo.	Utilice esta opción cuando solo necesite depurar un fragmento de código dentro de un nodo. Nota Esta función sirve únicamente para depurar la corrección de un fragmento de código. Para depurar la lógica completa del código, utilice Run o Run with Parameters.

Depurar un flujo de trabajo

1. Vaya a la página Data Studio. En el panel de navegación izquierdo, bajo Data Development o Manually Triggered Workflow, haga doble clic en el flujo de trabajo deseado para abrir su panel.

2. Depure el flujo de trabajo.

   Haga clic en el botón Run ( icon) de la barra de herramientas del panel del flujo de trabajo para ejecutar todas las tareas del flujo de trabajo de forma secuencial según sus dependencias.

   También puede hacer clic derecho en un nodo del panel del flujo de trabajo y seleccionar Run Node and Downstream Nodes para ejecutar dicho nodo y todos sus nodos descendientes según sus dependencias.

   La ejecución desde la barra de herramientas y la opción Run Node and Downstream Nodes del menú contextual funcionan de manera diferente:

   • Ejecución desde la barra de herramientas: Ejecuta todos los nodos secuencialmente de arriba hacia abajo según el DAG completo del flujo de trabajo. Cada nodo se envía para su ejecución de forma independiente, lo cual equivale a ejecutar cada nodo individualmente desde su pestaña de edición.

   • Run Node and Downstream Nodes mediante clic derecho: Comienza desde el nodo seleccionado y ejecuta dicho nodo junto con sus descendientes aplicando la lógica de programación de dependencias. Esta opción valida el estado de ejecución y la salida de los nodos precedentes, a diferencia de ejecutar un nodo directamente desde su pestaña de edición (modo de depuración independiente).

   Si ocurre un error al utilizar Run Node and Downstream Nodes, pero el mismo SQL se ejecuta correctamente desde la pestaña de edición del nodo, se debe a que la ejecución mediante clic derecho aplica la lógica de programación de dependencias para validar el estado de ejecución y los datos de salida de los nodos precedentes, mientras que la ejecución directa solo ejecuta el código SQL del nodo actual. Puede solucionar el problema de la siguiente manera:

   • Compruebe el estado de ejecución de los nodos precedentes. La ejecución mediante clic derecho valida las dependencias anteriores. Si un nodo precedente no se ha ejecutado o ha fallado, el nodo actual reportará un error. Consulte los iconos de estado de ejecución de los nodos precedentes en el panel del flujo de trabajo para confirmar que todos se han ejecutado correctamente.

   • Revise las configuraciones de dependencia entre nodos. Compruebe que el paso de parámetros de entrada y salida entre nodos sea correcto y que las asignaciones de parámetros de programación coincidan con lo esperado. En la página de configuración de programación del nodo, verifique si las tablas de salida precedentes coinciden con las tablas de entrada del nodo actual.

   • Haga clic derecho en el nodo que reporta el error, seleccione la opción para ver los registros de ejecución y localice el mensaje de error específico. El error en los registros suele contener la causa concreta, como una tabla inexistente, permisos insuficientes o errores de sintaxis.

   • Verifique problemas de sintaxis en comentarios dentro del código SQL. Algunos motores analizan los comentarios de forma distinta en modo de programación comparado con la ejecución directa, lo que puede causar errores de sintaxis. Para solucionar esto, intente eliminar los comentarios de bloque (/* */) del código SQL conservando solo los comentarios de línea (--) y compruebe si el error persiste.

   • Compruebe si los datos de salida de los nodos precedentes están listos. La ejecución mediante clic derecho depende de las tablas de datos generadas por los nodos anteriores como entrada. Si un nodo precedente se ejecutó correctamente pero sus datos de salida aún no están disponibles o se han limpiado, el nodo actual reportará un error porque no podrá leer la tabla de entrada.

   Nota

   • Si los nodos de un flujo de trabajo activado manualmente tienen variables con el mismo nombre y estas pueden asignarse uniformemente, puede definir workflow parameters en el panel del flujo de trabajo y asignar valores a los parámetros. Luego, ejecute el flujo de trabajo para ver los resultados de la asignación y el estado de ejecución de las tareas manuales.

   • Solo algunos tipos de nodo admiten parámetros de flujo de trabajo. Consulte la interfaz real para obtener detalles.

   • Una vez finalizada la ejecución, puede hacer clic derecho en un nodo del panel del flujo de trabajo para ver los registros de ejecución de ese nodo.

Consultar el historial de operaciones

En la página Operating history de Data Studio, puede consultar todas las tareas ejecutadas por la cuenta actual durante los últimos tres días.

Después de ejecutar una tarea en Data Studio, esta se envía al motor correspondiente para su ejecución. Incluso si cierra accidentalmente la tarea durante su ejecución, esta continuará corriendo. Puede utilizar la página Operating history para ver los registros de ejecución o detener las tareas enviadas.

Crear un archivo de consulta ad hoc

Procesar resultados de consulta