Tous les produits
Search
Centre de documentation

DataWorks:Configurer les paramètres de planification pour différents types de nœuds

Dernière mise à jour :Aug 10, 2026

Vous configurez les paramètres de planification de la même manière pour la plupart des types de nœuds, tels que les nœuds SQL MaxCompute. Toutefois, la procédure diffère pour les nœuds shell courants et PyODPS. Cette rubrique fournit des exemples de configuration pour divers types de nœuds.

Nœuds SQL et nœuds de synchronisation par lots

La configuration des nœuds SQL et des nœuds de synchronisation par lots s'applique à la majorité des types de nœuds. Cet exemple utilise un nœud SQL MaxCompute pour illustrer l'attribution de valeurs aux variables système intégrées et aux paramètres personnalisés, ainsi que leur utilisation dans le code.

Remarque

Tous les nœuds ne prennent pas en charge les paramètres de planification. Pour vérifier si un nœud spécifique les prend en charge, consultez la documentation sur le développement de nœuds.

  • Définir les paramètres

    Paramètre

    Valeur

    var1

    $bizdate

    var2

    ${yyyymmdd}

    var3

    $cyctime

    var4

    ${yyyymmddhh24:mi:ss}

    var5

    abc

  • Utiliser les paramètres

    -- Get the data timestamp
    SELECT '${var1}' '${var2}';
    -- Get the scheduling time
    SELECT '${var3}' '${var4}';
    -- Get a constant
    SELECT '${var5}';

Après avoir attribué des valeurs dans la section Paramètres de planification, référencez-les dans votre code. L'exemple ci-dessous montre comment référencer les variables système intégrées var1 et var3, les paramètres personnalisés var2 et var4, ainsi que la constante var5 avec les affectations suivantes :

  • Attribuez un horodatage de données au paramètre var1 : var1=$bizdate

  • Attribuez une heure de planification au paramètre var3 : var3=$cyctime

  • Attribuez un horodatage de données au paramètre var2 : var2=${yyyymmdd}

  • Attribuez une heure de planification au paramètre var4 : var4=$[yyyymmddhh24:mi:ss]

  • Attribuez la constante abc au paramètre var5 : var5=abc

Pour plus d'informations, consultez les rubriques Configurer les paramètres de planification des nœuds et Sources et expressions des paramètres de planification.

Nœud PyODPS

Pour éviter toute modification directe du code, les nœuds PyODPS ne prennent pas en charge la substitution de chaînes au format ${param_name}. Récupérez plutôt les paramètres de planification depuis l'objet dictionnaire global args.

  • Définir les paramètres

    Paramètre

    Valeur

    var1

    $bizdate

    var2

    ${yyyymmdd}

    var3

    $[yyyymmdd]

  • Utiliser les paramètres

    # Custom parameter: var1 retrieves a built-in parameter value.
    a =args['var1']
    print (format(a))
    # Custom parameter: var2 retrieves a value using ${...} format.
    b =args['var2']
    print (format(b))
    # Custom parameter: var3 retrieves a value using $[...] format.
    c =args['var3']
    print (format(c))

Comme indiqué dans l'exemple précédent, attribuez des valeurs dans la section Paramètres de planification. Dans le code, référencez les paramètres via l'objet dictionnaire, par exemple args['var1'], args['var2'] et args['var3']. Les affectations sont les suivantes :

  • Attribuez un horodatage de données au paramètre var1 : var1=$bizdate

  • Attribuez un horodatage de données au paramètre var2 : var2=${yyyymmdd}

  • Attribuez un horodatage de données au paramètre var3 : var3=$[yyyymmdd]

Pour plus d'informations, consultez les rubriques Configurer les paramètres de planification des nœuds et Sources et expressions des paramètres de planification.

Nœud Python

Les nœuds Python reçoivent les paramètres de planification sous forme d'arguments de ligne de commande. Liste les valeurs des paramètres dans l'ordre dans la section Paramètres de planification ; le système les transmettra au script lors de l'exécution. Dans le code, accédez à ces valeurs via des index tels que sys.argv[1] et sys.argv[2].

Remarque

Contrairement aux nœuds PyODPS, les nœuds Python ne permettent pas de référencer directement les paramètres par leur nom (par exemple, $var1). Lisez plutôt les paramètres de manière positionnelle en utilisant sys.argv.

  • Définir les paramètres

    Pour les nœuds Python, attribuez les valeurs sous forme de liste séparée par des espaces. Les valeurs peuvent être des expressions ou des constantes ; elles correspondent aux arguments du script selon leur position.

    $[yyyymmdd] abc
  • Utiliser les paramètres

    import sys
    
    # Print all received parameters
    print("Current received parameters:", sys.argv)
    
    # Get the first and second parameters
    param1 = sys.argv[1]
    param2 = sys.argv[2]
    print("Parameter 1:", param1)
    print("Parameter 2:", param2)

Comme illustré dans l'exemple précédent, attribuez des valeurs aux paramètres dans la section Paramètres de planification, en les séparant par des espaces. Accédez ensuite aux valeurs dans le code via des index tels que sys.argv[1] et sys.argv[2]. Les affectations sont les suivantes :

  • Attribuez une heure de planification au premier paramètre : $[yyyymmdd].

  • Attribuez la constante abc au deuxième paramètre : abc.

Pour plus d'informations, consultez les rubriques Configurer les paramètres de planification des nœuds et Sources et expressions des paramètres de planification.

Nœud shell courant

Les nœuds shell courants utilisent des paramètres positionnels (tels que $1, $2 et $3) au lieu de variables nommées. Pour les paramètres au-delà du neuvième, utilisez la syntaxe ${10}.

  • Définir les paramètres

    Pour les nœuds shell courants, attribuez les valeurs sous forme de liste séparée par des espaces. L'ordre des valeurs doit correspondre à celui des paramètres positionnels dans le script.

    $bizdate ${yyyymmdd} $[yyyymmdd]
  • Utiliser les paramètres

    # Positional parameter: Get a built-in parameter value.
    echo $1
    # Positional parameter: Get a value using ${...} format.
    echo $2
    # Positional parameter: Get a value using $[...] format.
    echo $3

Après avoir attribué des valeurs dans la section Paramètres de planification, référencez-les dans le code en tant que paramètres positionnels $1, $2 et $3. Les affectations de l'exemple sont les suivantes :

  • Attribuez un horodatage de données au paramètre positionnel $1 : $bizdate

  • Attribuez un horodatage de données au paramètre positionnel $2 : ${yyyymmdd}

  • Attribuez une heure de planification au paramètre positionnel $3 : $[yyyymmdd]

Pour plus d'informations, consultez les rubriques Configurer les paramètres de planification des nœuds et Sources et expressions des paramètres de planification.