All Products
Search
Document Center

Dataphin:Configure offline task runtime parameters

Last Updated:May 28, 2025

Runtime parameter configuration assigns values to variables in offline tasks, allowing parameter variables to be automatically replaced with corresponding variable values during node scheduling. This topic describes how to configure parameters and use node parameters, using MAX_COMPUTE_SQL as an example to explain parameter configuration.

Procedure

  1. In the top navigation bar of the Dataphin homepage, choose Develop > Data Development.

  2. On the Development page, select a Project from the top navigation bar (In Dev-Prod mode, you need to select an Environment).

  3. In the left-side navigation pane, choose Data Processing > Script Task.

  4. In the computing task list, click the target computing task to open the corresponding computing task tab.

  5. Click Property in the right sidebar to open the Property panel, and configure the following parameters in the Runtime Parameter section.

    • Input parameters

      Parameters configured in the computing task through the expression ${variable name} will be displayed in the Runtime Parameter section. You can modify the parameter type and assign values to parameters in the runtime parameter list.

      Parameter

      Description

      Parameter Name

      The parameter name defined in the code editor. The variable name can only contain digits, letters, and underscores (_), and cannot exceed 32 characters in length.

      Parameter Type

      Includes Global Variable, Space Name Variable, Local Variable, Cross-node Variable, and Fixed Value types. For more information, see Variable classification.

      After selecting multiple parameters or clicking Select All, click Modify Parameter Type at the bottom of the parameter list to batch modify parameter types.

      Parameter Value

      • Global variable: Defaults to the variable value defined by the global variable and cannot be set. For more information, see Create a global variable.

      • Space name variable: The parameter value is the space name.

      • Local variable: Supports up to 258 characters or can be set to empty. To input date and time, you can select or refer to expressions in the list. For details, see Variable assignment.

      • Cross-node variable: After setting upstream dependencies, you can select cross-node output parameters from upstream as parameter values.

      • Non-variable: Definition is not supported.

      Note

      If you reference a global variable with permission control enabled, the system will automatically verify whether the current user has permission. Global variables without permission will be marked with an image icon. You can click Request Permission to jump to the Permission Management > Variable permission management page to request permission.

    • Cross-node output parameters

      Important
      • Only Python, SQL, and Shell computing tasks support defining cross-node output parameters.

      • Integration tasks, computing tasks, normal/hierarchical dimension logical tables, and fact logical tables support cross-node variable parameters as input parameters.

      Variable parameters passed to the direct downstream nodes of this object node must be pre-declared and defined in this list. Undeclared output variables will be ignored by the system. Variables that are declared but not assigned values in the code will use the configured default values. In the code editing area, you can assign values to variable parameters by right-clicking and selecting Set cross-node parameters from the menu.

      Note
      • To add multiple cross-node output parameters, you can click + Add Parameter.

      • The cross-node output parameter list supports batch operations. After selecting or selecting all cross-node output parameters, you can click image.png to perform batch deletion.

      Parameter

      Description

      Parameter name

      Cannot exceed 32 characters in length and only supports digits, letters, and underscores (_).

      Parameter description

      A brief description of the parameter, within 128 characters.

      Default value

      • The default value used when the variable is not assigned a value. To assign a value to a cross-node output parameter, see Cross-node output parameter assignment.

      • When a downstream node references a cross-node output parameter from an upstream node, and you perform a data backfill operation on the downstream node without including the upstream node in the same data backfill instance, the cross-node input parameter in the downstream node will take values from the most recent N days of operation records from the upstream node. If no operation records exist or they exceed N days, the default value will be used. The most recent N days (N) defaults to 15 days.

      • When performing data backfill, it is recommended to select both upstream and downstream nodes. If the upstream node code does not assign a value to the cross-node parameter, the downstream node will also use the default value.

  6. Click OK to complete the Runtime Parameter configuration for the computing task.