Todos los productos
Search

Este producto

    DataWorks:Nodo FTP Check

    Centro de documentos

    DataWorks:Nodo FTP Check

    Última actualización: Sep 04, 2026

    El nodo FTP Check verifica periódicamente la existencia de un archivo específico mediante el protocolo FTP. Si el archivo existe, el nodo se ejecuta correctamente y activa sus nodos descendientes. Si el archivo no existe, el nodo continúa verificando a intervalos configurados hasta que se cumple una condición de detención. Este nodo se usa comúnmente como mecanismo de señalización entre el sistema de programación de DataWorks y sistemas externos. Este tema explica cómo usar el nodo FTP Check y proporciona notas importantes sobre su uso.

    Notas

    • En la versión anterior de DataStudio, los nodos FTP Check están obsoletos. Debe migrar sus nodos FTP Check a nodos Check lo antes posible. Para obtener más información, consulte Check node.

    • DataStudio ya no admite nodos FTP Check.

    Requisitos previos

    • Debe contar con un origen de datos FTP. El nodo FTP Check no es compatible con un FTP data source configurado con el protocolo SFTP que utilice autenticación mediante key pair.

    • Debe tener un flujo de trabajo. Para obtener más información, consulte Create a scheduled workflow.

    Contexto

    Un caso de uso típico del nodo FTP Check ocurre cuando una tarea en el sistema de programación de DataWorks necesita acceder a una base de datos externa, pero la tarea correspondiente de escritura de datos no está gestionada por DataWorks. En este escenario, DataWorks no puede determinar cuándo finaliza la tarea de escritura y los datos están listos para su acceso. Si DataWorks lee los datos antes de que termine la operación de escritura, es posible que los datos estén incompletos o que la operación de lectura falle. Para resolver esto, puede configurar el otro sistema de programación para que cree un archivo marcador en un sistema de archivos específico una vez completada su tarea de escritura de datos. Por ejemplo, el sistema puede generar un archivo .done para indicar que la tarea ha terminado. Luego, configure un nodo FTP Check en DataWorks para verificar periódicamente la existencia de este archivo .done. Cuando se detecta el archivo, significa que la tarea de escritura de datos en la base de datos ha finalizado y puede activar las tareas que necesitan acceder a dichos datos.

    Nota

    • Puede configurar el sistema de programación externo para generar el archivo marcador en un sistema de archivos específico.

    • Este tema utiliza un archivo .done como ejemplo. Puede personalizar el formato y el nombre del archivo marcador según sus necesidades.

    El proceso es el siguiente:FTP Check

    1. Un sistema de programación externo detecta que los datos en una base de datos externa están listos. A continuación, genera un archivo marcador, como xxxx2021-03-03.done, en un sistema de archivos designado. En este ejemplo se usa un archivo con sufijo .done, pero puede definir un archivo personalizado según sus requisitos empresariales.

    2. El origen de datos FTP proporciona acceso al sistema de archivos que contiene el archivo marcador.

    3. El nodo FTP Check sondea el archivo marcador a través del origen de datos FTP según la directiva de verificación configurada.

      • Si se encuentra el archivo marcador, los datos externos están listos. El nodo FTP Check se ejecuta correctamente y envía un estado de éxito a sus nodos descendientes.

      • Si no se encuentra el archivo marcador, los datos externos no están listos. El nodo FTP Check falla en el intento actual y no activa sus nodos descendientes. Continúa verificando según su directiva configurada hasta que se cumple la condición de detención.

      Para obtener más información sobre las directivas de verificación, consulte Configurar el objetivo y la directiva de verificación en el procedimiento siguiente.

    4. Los nodos descendientes deciden si se ejecutan basándose en el resultado del nodo FTP Check.

      • Si el nodo FTP Check tiene éxito, los nodos descendientes se inician y acceden a la base de datos externa.

      • Si el nodo FTP Check falla, los nodos descendientes no se ejecutan.

    5. Los nodos descendientes acceden a los datos en la base de datos externa.

    Nota

    Las bases de datos externas pueden incluir diversos servicios de bases de datos o almacenamiento, como Oracle, MySQL y SQL Server.

    Limitaciones

    • Resource groups: Los nodos FTP Check pueden ejecutarse en un resource group serverless (recomendado) o en un resource group exclusivo heredado para programación. Para adquirir y utilizar un resource group serverless, consulte Use a serverless resource group.

    • Orígenes de datos: No puede utilizar un nodo FTP Check con un FTP data source configurado con el protocolo SFTP que emplee autenticación mediante key pair.

    • Si un nodo FTP Check está programado para ejecutarse por minuto u hora, no puede establecer la Policy for Stopping Check en Time for Stopping Check. Para estas tareas, debe usar la directiva Checks Allowed Before Check Node Stops.

    • Regiones compatibles: China (Hangzhou), China (Shanghai), China (Beijing), China (Shenzhen), China (Chengdu), China (Hong Kong), Japan (Tokyo), Singapore, Malaysia (Kuala Lumpur), Indonesia (Jakarta), Germany (Frankfurt), UK (London), US (Silicon Valley) y US (Virginia).

    Crear un nodo FTP Check

    1. Inicie sesión en la consola de DataWorks.

    2. En la página Data Studio, pase el cursor sobre el icono 新建 y seleccione General > FTP Check.

      Alternativamente, abra un flujo de trabajo, haga clic con el botón derecho en General y seleccione Create > FTP Check.

    3. En el cuadro de diálogo Create Node, introduzca un Node Name y seleccione una Location para el nodo.

      Nota

      El nombre del nodo debe tener 128 caracteres o menos y solo puede contener letras, caracteres chinos, dígitos, guiones bajos (_) y puntos (.).

    4. Haga clic en Commit.

    5. En el panel derecho, haga clic en Scheduling para configurar las propiedades de programación del nodo.

      Las propiedades incluyen General, time properties, Resource Group y Scheduling Dependency. Para obtener más información, consulte Configure basic properties, Configure time properties, Configure resource properties y Configure same-cycle scheduling dependencies.

    6. Configure el objetivo y la directiva de verificación.

      Configure los siguientes parámetros: Seleccione un FTP Data Source, especifique la ruta en el campo File to Check, por ejemplo /root/abc, establezca el Check Interval (Seconds) y elija una check stop policy (check stop time o check stop count).

      1. En la lista desplegable Select FTP Data Source, seleccione el origen de datos FTP de destino.

        Puede seleccionar un origen de datos FTP o SFTP. Si no hay orígenes de datos disponibles en la lista, debe crear uno. Para obtener más información, consulte Configure an FTP data source.

      2. En el campo File to Check, especifique la ruta del archivo a verificar. Si la ruta del archivo es dinámica, puede usar parámetros de programación para crear una ruta variable. Para obtener más información, consulte Formats of scheduling parameters.

      3. En el campo Check Interval (Seconds), configure el intervalo de tiempo entre verificaciones.

      4. En la sección Policy for Stopping Check, seleccione una directiva de detención de verificación.

        • Time for Stopping Check: El nodo deja de verificar a una hora específica del día. Especifique la hora en formato de 24 horas hh:mm:ss. Si una verificación falla, el nodo reintenta a intervalos configurados hasta que encuentra el archivo o se alcanza la hora de detención. Los nodos descendientes se activan solo después de que la verificación tenga éxito. Si la verificación falla repetidamente, puede consultar los registros para obtener detalles.

          Nota

          La configuración del ciclo de programación de un FTP Check node afecta la directiva de detención:

          • Si el ciclo de programación está establecido en minute o Hour, no puede seleccionar Time for Stopping Check. Debe usar Checks Allowed Before Check Node Stops. Para obtener más información, consulte Configure the check target and policy.

          • Si el ciclo de programación se establece inicialmente en Day con la directiva configurada en Time for Stopping Check, y posteriormente cambia el ciclo a minute o Hour, la opción Time for Stopping Check deja de ser válida. Debe cambiar la directiva a Checks Allowed Before Check Node Stops antes de poder confirmar el nodo.

        • Checks Allowed Before Check Node Stops: El nodo deja de verificar después de un número especificado de intentos. Si una verificación falla, el nodo reintenta a intervalos configurados hasta que encuentra el archivo o se alcanza el número máximo de verificaciones. Los nodos descendientes se activan solo después de que la verificación tenga éxito. Si la verificación falla repetidamente, puede consultar los registros para obtener detalles.

    7. Guarde y confirme el nodo.

      Nota

      Debe configurar las propiedades Rerun attribute y Parent Nodes antes de poder confirmar el nodo.

      1. En la barra de herramientas superior, haga clic en el icono 保存 para guardar el nodo.

      2. Haga clic en el icono 提交 en la barra de herramientas superior.

      3. En el cuadro de diálogo Commit Node, introduzca una Change Description.

      4. Haga clic en OK.

      Si su espacio de trabajo está en modo estándar, debe desplegar el nodo después de confirmarlo. Haga clic en Deploy en la esquina superior derecha. Para obtener más información, consulte Deploy nodes.

    8. Pruebe el nodo. Para obtener más información, consulte Manage scheduled tasks.