DataWorks:Nodo Shell

Desarrollo de nodos

1. Inicie sesión en la consola de DataWorks. Después de cambiar a la región de destino, haga clic en Data Development and O&M > Data Development en el panel de navegación izquierdo. Seleccione el workspace de destino en la lista desplegable y luego haga clic en Go to DataStudio.

2. Pase el cursor sobre el icono y haga clic en Create Node > General > Shell. En el cuadro de diálogo Create Node, introduzca el nombre y la ruta del nodo.

3. Introduzca código de shell estándar en el editor de scripts (no se admite sintaxis interactiva):

   echo "Hello DataWorks!"

4. Una vez completado el código, haga clic en , seleccione el resource group y la imagen de destino, y ejecute la tarea del nodo Shell.

5. Después de que el script pase la depuración, haga clic en Scheduling Settings en el lado derecho para configurar directivas de programación a nivel de producción, como el horario de ejecución y las propiedades de los recursos. Esto permite que el nodo se ejecute periódicamente según lo planificado. Para obtener más información sobre cómo configurar las propiedades de programación de nodos, consulte Configure schedule settings.

Desplegar y gestionar nodos

1. Tras configurar las propiedades de programación, puede enviar el nodo al entorno de desarrollo y luego deploy al entorno de producción para su programación periódica.

2. Una vez desplegado el nodo, la tarea se ejecuta periódicamente según la programación configurada. Puede hacer clic en el icono en la esquina superior izquierda y luego seleccionar All Products > Data Development and O&M > Operation Center en la página de navegación que aparece para ir a Operation Center. A continuación, en el menú izquierdo, vaya a Task O&M > Auto Triggered Task O&M > Periodic tasks para consultar las tareas programadas desplegadas. Para obtener más información, consulte Manage scheduled tasks.

Referenciar recursos

1. DataWorks permite cargar recursos mediante la gestión de recursos para utilizarlos en nodos Shell. Para obtener más información, consulte Manage resources.

   Nota

   Un recurso debe enviarse antes de que un nodo pueda referenciarlo. Si una tarea de producción requiere el recurso, también debe desplegarlo en el entorno de producción. Para obtener más información, consulte Deploy nodes.

2. En el árbol de directorios izquierdo de Data Studio, localice el recurso cargado.

3. Haga clic con el botón derecho en el recurso y seleccione Insert Resource Path. De este modo, el recurso queda referenciado en el nodo actual. Puede escribir código en la página de edición del nodo para ejecutar el recurso.

   Nota

   Tras una referencia correcta, el sistema inserta automáticamente un comentario de declaración con el formato ##@resource_reference{resource_name} al inicio del script.

   Este comentario es un identificador obligatorio para que DataWorks reconozca las dependencias de recursos y monte automáticamente el recurso correspondiente en el entorno de ejecución durante el tiempo de ejecución. No lo modifique ni elimine manualmente.

Usar parámetros de programación

Los parámetros de programación se inyectan en los nodos Shell como parámetros posicionales. No se admiten nombres de variables personalizadas. DataWorks pasa los valores de los parámetros de programación que configure en Scheduling Settings de un nodo al script de shell en orden, como parámetros posicionales tales como $1, $2, $3, etc. Cuando se utilicen más de 9 parámetros, emplee la sintaxis de llaves, como ${10} y ${11}, para garantizar un análisis sintáctico correcto. Los valores de múltiples parámetros deben separarse con espacios, y el orden debe coincidir estrictamente con las referencias posicionales en el script.

En este ejemplo:

• El parámetro integrado $1 tiene asignada la fecha de negocio: $bizdate.

• El parámetro personalizado $2 tiene asignada la fecha de negocio: ${yyyymmdd}.

• El parámetro personalizado $3 tiene asignada la fecha de negocio: $[yyyymmdd].

• Si el valor de un parámetro contiene espacios, enciérrelo entre comillas. Todo el contenido dentro de las comillas se trata como un solo parámetro.

• Para obtener más información sobre cómo configurar y utilizar parámetros de programación, consulte Configure scheduling parameters.

Usar ossutil para acceder a OSS

El nodo Shell de DataWorks admite de forma nativa la herramienta de línea de comandos de Alibaba Cloud OSS ossutil, la cual permite la gestión de buckets, la carga y descarga de archivos, operaciones por lotes y otras tareas. Puede configurar credenciales de acceso para usar ossutil y acceder a OSS mediante un archivo de configuración o parámetros de línea de comandos.

• Para usar ossutil y acceder a OSS mediante parámetros de línea de comandos, consulte Access OSS by using command-line parameters.

• Para usar ossutil y acceder a OSS mediante un archivo de configuración, consulte Access OSS by using a configuration file.

Apéndice: Códigos de salida de scripts

Puede utilizar los códigos de salida de scripts para determinar con mayor precisión si un script se ejecutó correctamente.

• Código de salida 0: Indica éxito.

• Código de salida -1: Indica que el proceso finalizó.

• Código de salida 2: Indica que la plataforma necesita volver a ejecutar la tarea automáticamente una vez.

• Otros códigos de salida: Indican fallo.

A continuación se muestra un ejemplo de registro de ejecución cuando el nodo Shell se ejecuta correctamente (código de salida 0).

INFO Exit code of the Shell command 0 INFO --- Invocation of Shell command completed --- INFO Shell run successfully!

Debido al mecanismo subyacente de shell, el código de salida de todo el script en un nodo Shell equivale al código de salida del último comando ejecutado.