Dataphin:Configure runtime parameters for offline tasks

Procedure

1. On the top menu bar of the Dataphin homepage, choose R&D > Data Development.

2. On the Develop page, select a Project from the top menu bar. If you are in Dev-Prod mode, select an Environment.

3. In the left-side navigation pane, choose Data processing > Compute task.

4. In the list of computing tasks, click the target computing task to open its tab.

5. In the right-side pane, click Properties to open the Properties panel, and then configure the following parameters in the Runtime parameters section.

   • Input parameters

     Note

     • If you reference a global variable with permission control enabled, the system automatically checks whether you have the necessary permissions. Global variables for which you lack permission are marked with the icon. Click Request Permissions to open the Permission management > Variable permission management page and request access.

     • If a computing task references an offline computing template that contains variables, the system automatically populates the parameter type and value for the input parameters based on the settings in Properties > Task parameters of the template. You can modify these values.

     Parameters that you configure in a computing task by using the expression ${variable_name} are displayed in the Runtime Parameters section. In this section, you can modify the parameter types and assign values to the parameters.

     Parameter	Description
     Parameter name	The parameter name defined in the code editor. A variable name can contain only digits, letters, and underscores (_) and must be no more than 32 characters long.
     Parameter type	Valid types include Global variable, Workspace name variable, Local variable, Cross-node variable, and Non-variable. For more information, see Variable categories. To modify parameter types in bulk, select the desired parameters or click Select All, and then click Modify parameter type at the bottom of the parameter list.
     Parameter value	Global variable: By default, this is the value defined for the global variable and you cannot change it. For more information, see Create a global variable. Workspace name variable: The parameter value is the workspace name. Local variable: The value can be up to 258 characters long or can be empty. If you need to enter a date or time, you can select or reference an expression from the list. For more details, see Variable assignment. Cross-node variable: After you set upstream dependencies, you can select a cross-node output parameter from an upstream node as the parameter value. Non-variable: You cannot define a value for this type.

   • Cross-node output parameters

     Important

     • You can define cross-node output parameters only in Python, SQL, and Shell computing tasks.

     • You can use cross-node variables as input parameters for integration tasks, computing tasks, standard or hierarchical dimension logical tables, and fact logical tables.

     These are parameters passed to the immediate downstream nodes of the current node. You must first declare them in this list. The system ignores any undeclared output variables. If a declared variable is not assigned a value in the code, the system uses its configured default value. In the code editor, you can assign a value by right-clicking and selecting Set cross-node parameters.

     Note

     • To add multiple cross-node output parameters, click + Add parameter.

     • You can perform bulk operations on the list of cross-node output parameters. To delete multiple parameters at once, select them and then click the icon.

     Parameter	Description
     Parameter name	The name can be up to 32 characters long and can contain only digits, letters, and underscores (_).
     Parameter description	A brief description of the parameter, up to 128 characters long.
     Default value	The value used when the variable is not assigned a value in the code. To assign a value to a cross-node output parameter, see Assign a value to a cross-node output parameter. When you backfill data for a downstream node that references a cross-node output parameter from an upstream node, if you do not select the corresponding backfill instance for the upstream node, the cross-node input parameter in the downstream node takes its value from the upstream node's run history from the last N days. If no run history exists within this period, the system uses the default value. The default value for N is 15 days. When you backfill data, select both the upstream and downstream nodes. If the upstream node's code does not assign a value to the cross-node parameter, the downstream node uses the default value.

6. Click OK to save the Runtime parameters configuration for the computing task.