类别：: Information Schema、表函数

DYNAMIC_TABLE_GRAPH_HISTORY¶

此表函数返回有关当前账户中所有动态表的信息。此信息包括动态表和基表之间的依赖项。常见的用途是标识属于管道的所有动态表。

在此函数的输出中，每一行表示一个动态表。VALID_FROM 和 VALID_TO 列指定动态表的描述有效的时间范围（即，准确描述动态表）。

对动态表的更改（例如更改 TARGET_LAG）会导致创建新条目。

此表函数仅提供当前时间 7 天内 VALID_TO 值的描述。

语法¶

DYNAMIC_TABLE_GRAPH_HISTORY(
  [ AS_OF => <constant_expr> ]
  [ , HISTORY_START => <constant_expr> [ , HISTORY_END => <constant_expr> ] ]
)

Copy

实参¶

所有实参均为可选。如果未提供任何实参，则仅返回当前现有动态表的最新描述。

AS_OF => constant_expr: 返回图形状态的时间（ TIMESTAMP_LTZ 格式）。您可以指定与 DYNAMIC_TABLE_REFRESH_HISTORY 函数输出中的 REFRESH_VERSION 列中的值相对应的时间。
HISTORY_START => constant_expr、. HISTORY_END => constant_expr: 动态表刷新历史记录的日期/时间范围。HISTORY_START 指定返回数据的最早日期/时间（含）。HISTORY_END 必须与 HISTORY_START 一起指定，指定返回数据的结束日期/时间。

输出¶

该函数返回以下列：

列名称	数据类型	描述
NAME	TEXT	动态表的名称。
SCHEMA_NAME	TEXT	包含动态表的架构的名称。
DATABASE_NAME	TEXT	包含动态表的数据库的名称。
QUALIFIED_NAME	TEXT	动态表在动态表图形中显示的完全限定名称。您可以使用它来联接 DYNAMIC_TABLE_REFRESH_HISTORY 函数的输出。
INPUTS	OBJECTs 的 ARRAY	每个 OBJECT 都表示一个表、视图或动态表，用作此动态表的输入，由以下部分组成： `name` (TEXT)：完全限定名称。 `kind` (TEXT)：输入类型（TABLE、VIEW 或 DYNAMIC TABLE）。
TARGET_LAG_TYPE	TEXT	其中之一： USER_DEFINED – 由为动态表指定的 TARGET_LAG 参数确定。 DOWNSTREAM – 指示带有 DOWNSTREAM TARGET_LAG 的动态表。有关更多信息，请参阅了解动态表刷新。
TARGET_LAG_SEC	NUMBER	此动态表的目标滞后时间（以秒为单位）。这是在动态表的 TARGET_LAG 参数中指定的值。
QUERY_TEXT	TEXT	此动态表的 SELECT 语句。
VALID_FROM	TIMESTAMP_LTZ	在此时间之后，动态表的描述将有效。
VALID_TO	TIMESTAMP_LTZ	如果存在，则动态表的描述在此之前有效。如果为 Null，则描述仍然准确。
SCHEDULING_STATE	OBJECT	OBJECT 包括： `state` (TEXT)：计划状态（RUNNING 或 SUSPENDED）。 `reason_code` (TEXT)：如果状态不是 RUNNING，则为原因的可选原因。 `reason_message` (TEXT)：动态表未运行原因的文本描述。仅当状态未运行时才适用。 `suspended_on` (TIMESTAMP_LTZ)：动态表暂停时的可选时间戳。 `resumed_on` (TIMESTAMP_LTZ)：如果动态表为 RUNNING，则上次恢复时的可选时间戳。
ALTER_TRIGGER	ARRAY	说明要在 DYNAMIC_TABLE_GRAPH_HISTORY 函数中创建新条目的原因。可以是以下项之一： NONE（向后兼容性） CREATE_DYNAMIC_TABLE ALTER_TARGET_LAG SUSPEND RESUME REPLICATION_REFRESH ALTER_WAREHOUSE

使用说明¶

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