NOTIFICATION_HISTORY 表函数：输出的变更（待定）

注意

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

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

NOTIFICATION_HISTORY 函数正在变更，以提供有关以下信息：

  • 尚未处理的通知。

  • 尝试发送最初失败但正在重试的通知。

以下各部分将说明这些变更如何影响函数的输出：

返回的行数的变更

函数返回的行数正在变更：

变更前:

此函数为已处理的每个通知（已发送或失败的通知）返回一行。

如果多次尝试发送通知，该函数将返回最后一次尝试的行。

变更后:

此函数为每次发送通知的尝试返回一行。STATUS 列中的值指示尝试的状态：

  • 如果尝试失败但可以重试，则值为 RETRIABLE_FAILURE。

  • 如果尝试失败且无法重试，则值为 FAILURE。

  • 如果尝试成功，则值为 SUCCESS。

此外，该函数还为尚未处理的每个通知（已排队的通知）返回一行。

输出中的新列

启用此行为变更捆绑包后，NOTIFICATION_HISTORY 函数的输出包括以下新列：

列名称

数据类型

描述

ID

VARCHAR

发送通知请求的唯一 ID。

如果 Snowflake 无法发送通知并尝试再次发送通知，则此函数为每次尝试返回一行。每次尝试的行在 ID 列中具有相同的值，但在 ATTEMPT 列中具有不同的值。

ATTEMPT

INTEGER

尝试发送通知的次数。

MESSAGE_SOURCE_INFO

OBJECT

包含有关通知源的信息的对象。此对象中的字段取决于源的类型：

  • 对于 任务的错误通知，该对象包含以下字段：

    • name：任务的名称。

    • graph_run_group_id：图形运行标识符。

    • attempt_number：整数表示尝试运行此任务的次数。

  • 对于 Snowpipe 的错误通知，该对象包含 pipe_name 字段，用于指定管道的名称。

  • 对于通过调用 SYSTEM$SEND_EMAIL 存储过程发送的通知，该对象包含 query_id 字段，用于指定调用存储过程的语句的 ID。

弃用 MESSAGE 列

MESSAGE 列已弃用，将来将会移除。

参考：1593

语言: 中文