类别：

Information Schema、表函数

NOTIFICATION_HISTORY

此表函数可用于查询通过 Snowflake 发送的通知的历史记录。这些通知包括：

备注

此函数仅返回已处理的通知（已发送或已失败的通知）的有关信息。队列中的通知不会显示在历史记录中。

语法

NOTIFICATION_HISTORY(
  [ START_TIME => <constant_expr> ]
  [, END_TIME => <constant_expr> ]
  [, INTEGRATION_NAME => '<string>' ]
  [, RESULT_LIMIT => <integer> ] )
)
Copy

实参

所有实参均为可选。

START_TIME=> constant_expr、. END_TIME=> constant_expr

发出通知的时间范围（格式为 TIMESTAMP_LTZ）。

  • 如果未指定 START_TIME，则范围从 END_TIME 之前的 24 小时开始。

  • 如果未指定 END_TIME，则默认值为 CURRENT_TIMESTAMP。

最大时间范围是 14 天。

INTEGRATION_NAME => 'string'

与通知绑定的集成的完全限定名称。如果省略此实参，该函数将返回所有通知。

默认值：空字符串。

RESULT_LIMIT => integer

用于指定函数返回的行数上限的数字。

范围：1 至 10000

默认：100。

输出

该函数返回以下列：

列名称

数据类型

描述

CREATED

TIMESTAMP_LTZ

创建通知的时间戳。

PROCESSED

TIMESTAMP_LTZ

上次尝试发送通知的时间戳。

MESSAGE_SOURCE

TEXT

生成了通知的对象或功能的类型。有效值包括：. . TASK （对于 来自任务的通知） . SNOWPIPE`（对于 :doc:`来自 Snowpipe 的通知 </user-guide/data-load-snowpipe-errors>） . STORED_PROCEDURE （对于通过 调用 SYSTEM$SEND_EMAIL 或 SYSTEM$SEND_SNOWFLAKE_NOTIFICATION 存储过程发送的电子邮件通知）

INTEGRATION_NAME

TEXT

用于此通知的集成 的名称。

MESSAGE

TEXT

消息有效负载。

STATUS

TEXT

通知的状态。有效值：SUCCESS 或 FAILURE。

ERROR_MESSAGE

TEXT

如果通知失败，则提供有关通知失败原因的详细信息。

使用说明

  • 仅对 ACCOUNTADMIN 角色、集成所有者（即对集成具有 OWNERSHIP 权限的角色）或对集成具有 USAGE 权限的角色返回结果。

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

示例

检索过去 24 小时内创建的最新通知。

select * from table(information_schema.notification_history())
Copy

检索过去一小时内创建并使用名为 MY_INTEGRATION 的集成发送的最新通知。

select * from table(information_schema.notification_history(
  START_TIME=>dateadd('hour',-1,current_timestamp()),
  END_TIME=>current_timestamp(),
  RESULT_LIMIT=>100,
  INTEGRATION_NAME=>'MY_INTEGRATION'));
Copy
语言: 中文