DataWorks:Configuración y uso de parámetros de programación

Paso 1: Definir parámetros

1. Haga doble clic en el nodo de destino, por ejemplo, un MaxCompute SQL node, para abrir la página de edición del nodo.

2. Defina los parámetros en el código: en un nodo SQL de MaxCompute, utilice la sintaxis ${param} para definir un nombre de parámetro. DataWorks recomienda usar nombres de parámetros descriptivos para facilitar su referencia y gestión.

   Formatos de referencia de parámetros de programación:

   Tipo de formato	Sintaxis	Ámbito	Observaciones
   Formato general	${parameter_name}	Compatible con la mayoría de los tipos de nodos, como los nodos SQL de MaxCompute y los nodos de sincronización por lotes.	Es el formato más utilizado.
   Formato especial	Varía según el tipo de nodo. No utiliza el formato ${...}.	PyODPS, Shell, Python	Para más detalles, consulte Configure scheduling parameters for different types of nodes.

   -- Example: Define a variable named pt_date for partition filtering
   SELECT * FROM my_table WHERE ds = '${pt_date}'; 

3. Haga clic en Scheduling Settings en el lado derecho de la página para abrir la configuración de Scheduling Parameters.

4. Configure los parámetros de programación tal como se describe a continuación.

Paso 2: Configurar parámetros

Configure los parámetros de programación en Define with table o en Defined with an expression. Para alternar entre modos, haga clic en Defined with an expression en la esquina superior derecha. El modo predeterminado es Define with table.

1. Configurar parámetros

   Define with table

   Haga clic en Scheduling Settings en el lado derecho del nodo para abrir la página de configuración de parámetros de programación.

   

   • Agregar parámetros

     Haga clic en Scheduling Settings en el lado derecho del nodo y agregue parámetros en Scheduling Parameters. Se admiten los siguientes métodos para agregar parámetros.

     1. Haga clic en Add parameters para introducir manualmente el nombre y el valor del parámetro. El nombre del parámetro debe coincidir con el nombre de la variable definida en el código.

     2. Haga clic en Loading parameters in code. DataWorks analiza sintácticamente de forma automática las variables del código, como ${pt_date}, y completa los nombres de los parámetros. Solo necesita introducir los valores de los parámetros.

   • Asignar valores

     Puede establecer parámetros integrados del sistema, parámetros de tiempo personalizados, parámetros del espacio de trabajo, parámetros de salida de nodos ascendentes y constantes.

     • Haga clic en el cuadro de entrada. La lista desplegable muestra algunas expresiones de parámetros de uso común que puede seleccionar directamente. También puede introducir manualmente una expresión personalizada o una variable integrada del sistema.

     • Introduzca los valores según sus requisitos de negocio. Para conocer los formatos de valor compatibles, consulte Supported formats for scheduling parameters.

     • La asignación de parámetros de programación también admite el enlace rápido de parámetros de contexto. Haga clic en el botón junto al parámetro. En el cuadro de diálogo Associate Output Parameter of Ancestor Node, seleccione un nodo que tenga parámetros de salida configurados y asocie rápidamente la dependencia. Para obtener más información sobre los parámetros de salida, consulte Configure output parameters.

   Define with an expression

   Haga clic en Defined with an expression para cambiar el modo de configuración. Utilice este modo si prefiere configurar los parámetros mediante expresiones.

   

   • Cuando use la definición basada en expresiones, separe varios parámetros con espacios.

   • Cuando agregue, elimine o modifique parámetros de programación en el modo Defined with an expression, DataWorks valida la sintaxis de la expresión actual. Si la validación falla, no se podrán configurar los parámetros de programación.

     Por ejemplo, DataWorks comprueba reglas de sintaxis como no spaces are allowed around the equal sign.

2. Vista previa de parámetros

   Después de definir los parámetros, haga clic en Preview of scheduling parameters para obtener una vista previa de los valores de los parámetros para N instancias después de una fecha de negocio específica. Así podrá comprobar si las definiciones de los parámetros cumplen con lo esperado. Puede ajustar la fecha de negocio y la cantidad de instancias para la vista previa.

   

   Nota

   Algunos nodos, como los de sincronización por lotes, incluyen un parámetro integrado ${bizdate}. A este parámetro se le asigna automáticamente el valor $bizdate. Puede reemplazar el nombre del parámetro bizdate en su código por un nombre de parámetro personalizado. ${bizdate} no tiene ningún significado especial por sí mismo y funciona igual que cualquier otro parámetro personalizado.

   

Paso 3: Pruebas de humo

Después de asignar los valores de los parámetros, utilice la función de prueba de humo durante el despliegue para simular un escenario de programación con una fecha de negocio específica. Compruebe que la sustitución de parámetros y la ejecución del código generen los resultados esperados. Si no es así, realice los ajustes de inmediato para evitar afectar la programación en producción.

1. Despliegue el código del nodo.

   

   1. Configure scheduling time y scheduling dependency.

   2. Haga clic en Save para guardar el código y la configuración. Luego, haga clic en el botón Deploy de la barra de herramientas para iniciar la prueba de humo durante el proceso de despliegue.

      Nota

      Si la prueba de humo no ejecuta el código o los parámetros más recientes, haga clic en Republish Production.

2. Ejecute la prueba de humo.

   Haga clic en Initiate Smoke Testing. En el cuadro de diálogo Smoke test, seleccione una fecha de negocio, haga clic en Confirm e inicie la prueba de humo.

3. Consulte los registros de la prueba de humo.

   1. Haga clic en el botón de registros de pruebas de humo del menú izquierdo y luego haga clic en Logs en los registros de la prueba de humo.

      

   2. Revise la salida de los parámetros en los registros para confirmar si los resultados cumplen con lo esperado.

Paso 4: Desplegar y verificar

Una vez verificada la configuración en el entorno de desarrollo, despliegue la tarea en Operation Center para la programación en producción. Revise los parámetros de programación en el entorno de producción para evitar errores de ejecución.

Si la configuración de los parámetros de programación de una tarea programada no cumple con lo esperado, o si no encuentra la tarea de destino en Operation Center, compruebe que la tarea se haya desplegado correctamente. Para obtener más información sobre cómo desplegar tareas, consulte Deploy a node.

1. Revise las definiciones de los parámetros.

   Vaya a Operation Center, cambie a la región y al espacio de trabajo de destino, y vaya a la página Auto Triggered Task O&M > Auto Triggered Task. Haga clic en el nombre de una tarea en la lista de tareas y compruebe si los parámetros de ejecución del panel General cumplen con lo esperado.

   

2. Pruebas de humo en Operation Center.

   También puede utilizar las pruebas de humo en Operation Center para confirmar si una tarea desplegada realiza la sustitución de parámetros y la ejecución del código según lo esperado en el entorno de producción. Para más detalles, consulte Smoke testing in Operation Center.

   Importante

   Tenga en cuenta que las pruebas de humo se ejecutan sobre datos reales en el entorno de producción. Actúe con precaución para evitar alterar los datos de producción.

   

3. Observe los resultados reales de la programación.

   Una vez que la tarea entra en programación automática, puede verificar adicionalmente si la sustitución de parámetros es correcta. Para ello, compruebe si los parámetros en Cycle Examples se reemplazaron automáticamente según lo requerido.

   

Este ejemplo utiliza un nodo SQL de MaxCompute para verificar la configuración de los parámetros de programación mediante pruebas de humo en el entorno de desarrollo y, posteriormente, confirma los valores de los parámetros en Operation Center tras el despliegue.