架构：: ACCOUNT_USAGE

TASK_HISTORY 视图¶

此 Account Usage 视图使您能够检索过去 365 天（1 年）内的任务使用情况历史记录。该视图为历史记录中任务的每次运行显示一行。

列¶

列名称	数据类型	描述
NAME	TEXT	任务的名称。
QUERY_TEXT	TEXT	SQL 语句的文本。
CONDITION_TEXT	TEXT	任务在确定是否运行时评估的 WHEN 条件的文本。
SCHEMA_NAME	TEXT	包含任务的架构的名称。
TASK_SCHEMA_ID	NUMBER	包含任务的内部/系统生成的架构标识符。
DATABASE_NAME	TEXT	包含任务的数据库的名称。
TASK_DATABASE_ID	NUMBER	包含任务的内部/系统生成的数据库标识符。
SCHEDULED_TIME	TIMESTAMP_LTZ	任务计划开始运行的时间。注意，我们会尽最大努力确保绝对精度，但仅保证任务不会在计划时间之前执行。
COMPLETED_TIME	TIMESTAMP_LTZ	任务完成的时间。
STATE	TEXT	已完成任务的状态：SUCCEEDED、FAILED、CANCELLED 或 SKIPPED。请注意，该视图不返回 SCHEDULED 或 EXECUTING 任务运行。要检索处于计划或执行状态的运行的任务历史记录详细信息，请查询 Information Schema 中的 TASK_HISTORY 表函数。
RETURN_VALUE	TEXT	为任务图中的前置任务设置的值。由前置任务通过调用 SYSTEM$SET_RETURN_VALUE 函数显式设置返回值。
QUERY_ID	TEXT	任务执行的 SQL 语句的 ID。可以与 QUERY_HISTORY 视图联接，以获取有关语句或存储过程执行的其他详细信息。
QUERY_START_TIME	TIMESTAMP_LTZ	任务定义中的查询开始运行的时间。此时间戳与 QUERY_HISTORY 返回的查询的开始时间一致。
ERROR_CODE	NUMBER	错误代码（如果语句返回错误）。
ERROR_MESSAGE	TEXT	错误消息（如果语句返回错误）。
GRAPH_VERSION	NUMBER	整数，用于识别已运行或计划运行的任务图版本。该值的每个增量增加表示对任务图中的任务的一个或多个修改。如果重新创建根任务（使用 CREATE OR REPLACE TASK），则版本号从 1 重新开始。
RUN_ID	NUMBER	任务图中的独立任务或根任务最初计划开始运行的时间。格式是纪元时间（以毫秒为单位）。. . 最初计划时间是指系统可能会将同一任务重新计划为在不同时间运行以重试或重新平衡负载的罕见情况。如果发生这种情况，RUN_ID 会显示最初计划运行时间，SCHEDULED_TIME 则会显示重新计划的运行时间。. . 注意，在重试之前，RUN_ID 可能不是当前任务/图形运行的唯一标识符。您可以使用 GRAPH_RUN_GROUP_ID 列来代替 RUN_ID。
ROOT_TASK_ID	TEXT	任务图中根任务的唯一标识符。此 ID 与同一任务的 SHOW TASKS 输出中的 ID 列值匹配。
SCHEDULED_FROM	TEXT	其中之一： `SCHEDULE`：任务计划正常运行，如 CREATE TASK 中的 SCHEDULE 或 AFTER 子句所述。 `EXECUTE TASK`：计划使用 EXECUTE TASK 运行此任务。 `MANUAL RETRY`：计划使用 EXECUTE TASK ...RETRY LAST 运行此任务。对于任务图中子任务的运行，该列返回与根任务运行相同的值。
ATTEMPT_NUMBER	NUMBER	整数表示尝试运行此任务的次数。最初的一次。
INSTANCE_ID	NUMBER	对象所属实例的内部/系统生成的标识符。
CONFIG	TEXT	如果为根任务设置了图形级别配置，则显示图形级别配置，否则显示 NULL。
QUERY_HASH	TEXT	根据规范化 SQL 文本计算的哈希值。
QUERY_HASH_VERSION	NUMBER	用于计算 `QUERY_HASH` 的逻辑版本。
QUERY_PARAMETERIZED_HASH	TEXT	根据参数化查询计算的哈希值。
QUERY_PARAMETERIZED_HASH_VERSION	NUMBER	用于计算 `QUERY_PARAMETERIZED_HASH` 的逻辑版本。
GRAPH_RUN_GROUP_ID	NUMBER	图形运行标识符。当图形运行有多个任务运行时，每个任务运行将显示相同的 GRAPH_RUN_GROUP_ID。GRAPH_RUN_GROUP_ID 和 ATTEMPT_NUMBER 的组合可用于对图形运行进行唯一标识。
BACKFILL_INFO	OBJECT	保留以供将来使用。所有行的返回值均为 NULL。

使用说明¶

视图的延迟时间最长可达 45 分钟。
为了提高性能，请按 COMPLETED_TIME 或 SCHEDULED_TIME 列筛选查询。请参阅示例部分（本主题内容）。

示例¶

检索最近完成的 10 个任务运行的记录：

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
ORDER BY completed_time DESC
LIMIT 10;

Copy

检索过去一小时内完成的任务运行的记录：

SELECT query_text, completed_time
FROM snowflake.account_usage.task_history
WHERE completed_time > DATEADD(hours, -1, CURRENT_TIMESTAMP());

Copy