动态表:返回值变更,并向 DYNAMIC_TABLE_GRAPH_HISTORY、DYNAMIC_TABLE_REFRESH_HISTORY 和 SHOW DYNAMIC TABLES 添加新列

注意

此行为变更在 2024_02 捆绑包中。

有关捆绑包的当前状态,请参阅 捆绑包历史记录

返回值行为

DYNAMIC_TABLE_GRAPH_HISTORY、DYNAMIC_TABLE_REFRESH_HISTORY 和 SHOW DYNAMIC TABLES 函数的行为已变更。这些函数的返回值显示如下。

DYNAMIC_TABLE_GRAPH_HISTORY 函数的返回值行为

启用此行为变更捆绑包后,DYNAMIC_TABLE_GRAPH_HISTORY 函数的输出包括以下返回值变更:

变更前:
  • SCHEDULING_STATE 列返回 "state": "RUNNING""state": "SUSPENDED",以描述动态表的状态。

  • 如果上游表暂停,且您对此上游表没有 MONITOR 权限,SCHEDULING_STATE 列会返回 RUNNING。

变更后:
  • SCHEDULING_STATE 列返回 "state": "ACTIVE""state": "SUSPENDED",以描述动态表的状态。

  • 即使您对上游表没有 MONITOR 权限,SCHEDULING_STATE 列也会返回 SUSPENDED。

DYNAMIC_TABLE_REFRESH_HISTORY 函数的返回值行为

启用此行为变更捆绑包后,DYNAMIC_TABLE_REFRESH_HISTORY 函数的输出包括以下返回值变更:

变更前:
  • LAST_COMPLETED_DEPENDENCY 列可能会错误地返回 NULL 值。

  • 因上游故障而跳过的刷新任务,STATE 列返回 SKIPPED。

  • 显示所有动态表状态的刷新历史记录。

变更后:
  • LAST_COMPLETED_DEPENDENCY 列现在可以返回准确值。

  • 因上游故障而跳过的刷新任务,STATE 列现在返回 UPSTREAM_FAILED。

  • 如果 STATE 列返回 QUEUED 或 SKIPPED,则刷新历史记录将不再显示。(如果您的动态表刷新因上游故障而跳过,STATE 列现在改为返回 UPSTREAM_FAILED)。

SHOW DYNAMIC TABLE 函数的返回值行为

启用此行为变更捆绑包后,SHOW DYNAMIC TABLES 命令的输出包括以下返回值变更:

变更前:
  • SCHEDULING_STATE 列返回 RUNNING 或 SUSPENDED,以描述动态表的状态。

变更后:
  • SCHEDULING_STATE 列返回 ACTIVE 或 SUSPENDED,以描述动态表的状态。

列变更

启用后,DYNAMIC_TABLE_GRAPH_HISTORY 和DYNAMIC_TABLE_REFRESH_HISTORY 功能将增加以下列。

DYNAMIC_TABLE_GRAPH_HISTORY 函数:输出中的新列

启用此行为变更捆绑包后,DYNAMIC_TABLE_GRAPH_HISTORY 函数的输出包括以下新列:

列名称

数据类型

描述

ALTER_TRIGGER

ARRAY

说明要在 DYNAMIC_TABLE_GRAPH_HISTORY 函数中创建新条目的原因。可以是以下项之一:

  • NONE(向后兼容性)

  • CREATE_DYNAMIC_TABLE

  • ALTER_TARGET_LAG

  • SUSPEND

  • RESUME

  • REPLICATION_REFRESH

  • ALTER_WAREHOUSE

DYNAMIC_TABLE_REFRESH_HISTORY 函数:输出中的新列

启用此行为变更捆绑包后,DYNAMIC_TABLE_REFRESH_HISTORY 函数的输出包括以下新列:

列名称

数据类型

描述

TARGET_LAG

TEXT

此列描述了刷新时动态表的 TARGET_LAG 值。

GRAPH_HISTORY_VALID_FROM

TIMESTAMP_NTZ

刷新时对 DYNAMIC_TABLE_GRAPH_HISTORY 表函数的 VALID_FROM 时间戳进行编码。

参考:1543

语言: 中文