DESCRIBE TASK¶

描述任务中的列。

DESCRIBE 可以缩写为 DESC。

另请参阅：: DROP TASK、ALTER TASK、CREATE TASK、SHOW TASKS

语法¶

DESC[RIBE] TASK <name>

Copy

参数¶

name: 指定要描述的任务的标识符。如果标识符包含空格或特殊字符，则整个字符串必须放在双引号内。放在双引号内的标识符也区分大小写。

输出¶

命令输出在以下列中提供任务属性和元数据：

列名称	描述
created_on	创建任务的日期和时间。
name	任务名称。
id	任务的全局唯一标识符 (GUID)。
database_name	包含任务的数据库的名称。
schema_name	包含任务的架构的名称。
owner	拥有任务的角色的名称。
comment	对任务的注释（如果有）。
warehouse	为运行任务提供计算资源的虚拟仓库的名称。
计划	定期运行任务的计划（如果有），cron 表达式形式。例如 `USING CRON 0 9-17 * * SUN America/Los_Angeles`。
predecessors	当前任务的前置任务（如果有）的名称。
state	以下任何一个： SCHEDULED – 计划执行。 EXECUTING – 当前正在执行。 SUCCEEDED – 执行成功。 FAILED – 执行失败，任务超时。 FAILED_AND_AUTO_SUSPENDED – 执行失败，任务自动暂停。 CANCELLED – 已取消执行。 SKIPPED – 表示任务运行开始，但可选的 `WHEN` 条件评估为 false，因此运行没有执行。
definition	任务在计划或触发时执行的 SQL 语句。
condition	`WHEN` 条件文本，该条件必须为 true 才能执行任务。
allow_overlapping_execution	TRUE 或 FALSE。仅适用于根任务。TRUE 表示根任务的多个实例可以同时运行。FALSE 是默认值。
error_integration	用于与 Amazon SNS、MS Azure 事件网格或 Google Pub/Sub 通信的通知集成的名称。如果未指定，则返回 `null`。
last_committed_on	上次设置任务版本的时间戳（如适用）。有关更多信息，请参阅任务运行的版本控制。
last_suspended_on	任务最后一次暂停的时间戳（如适用）。
owner_role_type	拥有对象的角色类型，例如 `ROLE`。如果 Snowflake Native App 拥有该对象，则值为 `APPLICATION`。
config	仅适用于任务图中的根任务。显示配置（如果存在）。
budget	预算名称（如果对象受预算监控）。否则为 NULL。
task_relations	显示根任务与其对应的终结任务之间的关系。
last_suspended_reason	显示任务暂停的原因。可能的原因包括以下几点： USER_SUSPENDED – 用户通过运行 `alter task <name> suspend` 命令暂停了任务。 HEMA_OR_DATABASE_DELETED – 任务的架构或数据库已删除。 GRANT_OWNERSHIP – 用户通过运行 `grant ownership` 命令将任务的所有权转移给了其他角色。 SUSPENDED_DUE_TO_ERRORS – 任务连续失败一定次数后被暂停。您可以设置 SUSPEND_TASK_AFTER_NUM_FAILURES 参数，以确定暂停该任务所需的失败次数。 CHILD_BECAME_ROOT – 该任务之前是任务图中的子任务，但该子任务的所有前置任务都被移除，子任务变成了根任务。 FINALIZER_BECAME_ROOT – 该任务之前是任务图中的终结任务，但该任务已被移除，该任务变成了根任务。 MATCHING_OWNER_NOT_FOUND – 在任务复制期间，在辅助数据库中找不到拥有该任务的角色。

使用说明¶

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

若要对此命令的输出进行后处理，可以使用 RESULT_SCAN 函数，该函数会将输出视为可查询的表。

示例¶

创建示例任务：

CREATE TASK mytask ( ... );

Copy

描述任务中的列：

DESC TASK mytask;

Copy