- 类别:
系统函数 (系统信息)
SYSTEM$GET_PREDECESSOR_RETURN_VALUE¶
检索 任务图 中的前置任务的返回值。返回值由前置任务通过调用 SYSTEM$SET_RETURN_VALUE 函数显式设置。
语法¶
SYSTEM$GET_PREDECESSOR_RETURN_VALUE('<task_name>')
实参¶
'task_name'
用于设置待检索返回值的前置任务的标识符。
如果该任务有多个任务启用了前置任务,则此实参为必需。
如果该任务仅启用了一项前置任务,则此实参为可选。如果忽略此实参,该函数将检索唯一启用的前置任务的返回值。
如果直接前置任务名称与请求的任务名称不匹配,但祖先级前置任务确实与任务名称匹配,则返回相匹配的祖先级前置任务的返回值。
任务名称实参不应包含数据库名称或架构名称。图表中的所有任务都必须在同一个架构中,因此无需在不同架构中引用任务。例如,您应该使用
MYTASK
作为此函数的输入,而不是使用MYDATABASE.MYSCHEMA.MYTASK
。
使用说明¶
任务名称区分大小写。
指定任务名称时,必须与启用的前置任务相匹配,否则调用将失败。
示例¶
有关此函数的完整示例,请参阅 SYSTEM$SET_RETURN_VALUE。