Todos los productos
Search

Este producto

    Microservices Engine:Variables de sistema para tareas de script

    Centro de documentos

    Microservices Engine:Variables de sistema para tareas de script

    Última actualización: Sep 05, 2026

    SchedulerX proporciona variables de sistema integradas que puede referenciar en tiempo de ejecución dentro de tareas de script. Estas variables le permiten acceder a parámetros de trabajo, contexto de fragmentación y metadatos de ejecución sin necesidad de codificar valores fijos.

    Todas las variables utilizan la sintaxis #{schedulerx.<variable>}.

    Nota

    La versión de agent version debe ser 1.12.5 o posterior.

    Contexto de programación

    Variable

    Descripción

    Ejemplo

    #{schedulerx.jobParameters}

    Parámetro del trabajo.

    test

    #{schedulerx.triggerType}

    Forma en que se activó el trabajo. Consulte Tipos de activación.

    1

    #{schedulerx.scheduleTime}

    Marca de tiempo de programación, con precisión de milisegundos.

    1743150114875

    #{schedulerx.dataTime}

    Marca de tiempo de los datos, con precisión de milisegundos.

    1743150114875

    #{schedulerx.agentVersion}

    Número de versión del agente; los scripts lo utilizan para identificar el entorno de ejecución.

    1.13.5

    Variables de fragmentación

    Estas variables proporcionan contexto a nivel de fragmento para trabajos de difusión y trabajos de fragmentación.

    Variable

    Descripción

    Ejemplo

    #{schedulerx.shardingId}

    ID del fragmento. Compatible con trabajos de difusión y de fragmentación.

    0

    #{schedulerx.shardingParameters}

    Parámetro del fragmento. Compatible únicamente con trabajos de fragmentación.

    hangzhou

    #{schedulerx.shardingNum}

    Número total de fragmentos. Compatible con trabajos de difusión y de fragmentación.

    2

    Estado de ejecución

    Variable

    Descripción

    Ejemplo

    #{schedulerx.attempt}

    Cantidad de reintentos del trabajo. Su valor es 0 en la primera ejecución.

    0

    Tipos de activación

    La variable #{schedulerx.triggerType} devuelve uno de los siguientes valores enteros:

    Valor

    Significado

    1

    Programación periódica

    2

    Actualización de datos

    3

    Programación mediante API

    4

    Nueva ejecución manual

    5

    Reintento del sistema

    6

    Ejecución manual

    Ejemplo de uso

    A continuación se muestra un script de shell que ejemplifica cómo referenciar las variables de sistema:

    #!/bin/bash

# Access scheduling context
echo "Job parameter: #{schedulerx.jobParameters}"
echo "Trigger type: #{schedulerx.triggerType}"
echo "Schedule time: #{schedulerx.scheduleTime}"
echo "Data time: #{schedulerx.dataTime}"

# Sharding context (broadcast and sharding jobs only)
echo "Shard ID: #{schedulerx.shardingId}"
echo "Shard parameter: #{schedulerx.shardingParameters}"
echo "Total shards: #{schedulerx.shardingNum}"

# Execution state
echo "Attempt: #{schedulerx.attempt}"

    Tras la sustitución de variables, la salida tiene un formato similar al siguiente:

    Job parameter: test
Trigger type: 1
Schedule time: 1743150114875
Data time: 1743150114875
Shard ID: 0
Shard parameter: hangzhou
Total shards: 2
Attempt: 0