类别：

Information Schema、表函数

TASK_DEPENDENTS

此表函数返回 任务图 中给定根任务的子 任务 列表。

语法

TASK_DEPENDENTS(
      TASK_NAME => '<string>'
      [, RECURSIVE => <Boolean> ] )
Copy

实参

TASK_NAME => 'string'

用于指定任务的字符串。该函数返回指定的根任务作为第一个条目，后跟子任务列表。

  • 请注意，整个名称必须放在单引号内，包括数据库和架构（如果名称是完全限定名称），即 '<db>.<schema>.<task_name>'。

  • 如果任务名称区分大小写或包含任何特殊字符或空格，则需要使用双引号来处理大小写/字符。双引号必须放在单引号内，即 '"<task_name>"'。

RECURSIVE => Boolean

指定输出是限制为仅包含直接子任务，还是限制为包含所有递归子任务。

值:

TRUE：在输出中返回所有递归子任务（子任务、孙子任务等）。

FALSE：在输出中仅返回直接子任务。

默认：TRUE。

使用说明

  • 仅返回任务所有者（即对任务具有 OWNERSHIP 权限的角色） 或者 对任务具有 MONITOR 或 OPERATE 权限的角色的行。

  • 当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者 函数名称必须受到完全限定。有关更多详细信息，请参阅 Snowflake Information Schema。

输出

该函数输出在以下列中提供表属性和元数据：

| created_on | name | database_name | schema_name | owner | comment | warehouse | schedule | predecessors | state | definition | condition |
Copy

列

描述

created_on

创建任务的日期和时间。

name

任务的名称。

database_name

任务架构的数据库。

schema_name

任务的架构。

owner

拥有任务的角色（即，对任务具有 OWNERSHIP 权限）

comment

为任务添加注释。

warehouse

提供任务运行所需资源的仓库。

schedule

任务运行计划。如果未指定计划，则显示 NULL。

predecessors

任务的 AFTER 参数中标识的任何任务的 JSON 数组（即前置任务）。运行成功完成后，这些任务将触发当前任务。数组中的各个任务名称是完全限定名称（即包括容器数据库名称和架构名称）。. . 如果任务没有前置任务，则显示空数组。

state

“已启动”或“已暂停”，具体取决于任务的当前状态。

definition

任务运行时执行的 SQL 语句。

condition

在任务的 WHEN 子句中指定的条件。

示例

检索 mydb.myschema.mytask 任务的直接子任务列表：

select *
  from table(information_schema.task_dependents(task_name => 'mydb.myschema.mytask', recursive => false));
Copy
语言: 中文