类别：

表函数

<service_name>!SPCS_GET_EVENTS

返回 Snowflake 为指定服务收集的事件。有关更多信息，请参阅 访问平台事件。

备注

仅在版本 9.20 或更高版本中创建的服务和作业支持该函数。

另请参阅：

监控服务

语法

<service_name>!SPCS_GET_EVENTS(
  [ START_TIME => <constant_expr> ],
  [ END_TIME => <constant_expr> ] )
Copy

实参

START_TIME => constant_expr

检索事件的时间范围的开始时间（TIMESTAMP_LTZ 格式）。有关构造日期、时间和时间戳数据的可用函数，请参阅 日期和时间函数。

如果未指定 START_TIME，则默认为一天前。

END_TIME => constant_expr

检索事件的时间范围的结束时间（TIMESTAMP_LTZ 格式）。

如果未指定 END_TIME，则默认为当前时间戳。

输出

列

类型

描述

TIMESTAMP

TIMESTAMP_NTZ

Snowflake 收集事件时的协调世界时 (UTC) 时间戳。该值映射到事件表中的 TIMESTAMP 列。

SEVERITY

VARCHAR

事件的严重性。该值映射到事件表中 RECORD 列中的 severity_text 字段。

EVENT_NAME

VARCHAR

事件的名称。该值映射到事件表中 RECORD 列中的 name 字段。

EVENT_DETAILS

OBJECT

有关事件的详细信息。该值映射到事件表中的 VALUE 列。

INSTANCE_ID

NUMBER

如果事件与服务实例相关，则服务实例的标识符。该值映射到事件表中 RESOURCE_ATTRIBUTES 列中的 snow.service.instance 字段。

CONTAINER_NAME

VARCHAR

如果事件与容器相关，则为容器的名称。该值映射到事件表中 RESOURCE_ATTRIBUTES 列中的 snow.service.container.name 字段。

RECORD

OBJECT

JSON 格式的事件信息。该值映射到事件表中的 RECORD 列。

RECORD_ATTRIBUTES

OBJECT

有关事件的其他信息。该值映射到事件表中的 RECORD_ATTRIBUTES 列。

访问控制要求

用于执行此操作的 角色 必须至少具有以下 权限：

权限

对象

备注

OWNERSHIP

服务

OWNERSHIP is a special privilege on an object that is automatically granted to the role that created the object, but can also be transferred using the GRANT OWNERSHIP command to a different role by the owning role (or any role with the MANAGE GRANTS privilege).

要对架构中的任何对象执行操作，需要对父数据库和架构具有 USAGE 权限。

有关创建具有指定权限集的自定义角色的说明，请参阅 创建自定义角色。

有关对 安全对象 执行 SQL 操作的相应角色和权限授予的一般信息，请参阅 访问控制概述。

使用说明

  • 事件可能需要几分钟才能显示在输出中。

示例

检索 Snowflake 在过去一天为 my_test_job 作业记录的事件。

SELECT * FROM TABLE(my_test_job!SPCS_GET_EVENTS());
Copy

输出示例：

+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+
| TIMESTAMP               | SEVERITY | EVENT_NAME              | EVENT_DETAILS                          | INSTANCE_ID | CONTAINER_NAME | RECORD                               | RECORD_ATTRIBUTES |
|-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------|
| 2025-06-26 00:23:40.933 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Completed successfully", |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "DONE"                     |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:35.919 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Running",                |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "READY"                    |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:34.127 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        NULL | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Waiting to start",       |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "PENDING"                  |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+

检索 Snowflake 在过去三天为 my_test_job 作业记录的事件。

SELECT * FROM TABLE(my_test_job!SPCS_GET_EVENTS(START_TIME => DATEADD('day', -3, CURRENT_TIMESTAMP())));
Copy
语言: 中文