类别：

表函数 (Snowpark Container Services)

<service_name>!SPCS_GET_EVENTS

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

另请参阅：

监控服务

语法

<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 列。

访问控制要求

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

权限

对象

备注

MONITOR

服务

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).

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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

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

使用说明

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

示例

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

SELECT * FROM TABLE(mydb.myschema.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 | {                                      |        0    | 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 | {                                      |        0    | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Running",                |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "READY"                    |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
| 2025-06-26 00:23:34.127 | INFO     | CONTAINER.STATUS_CHANGE | {                                      |        0    | main           | {                                    | NULL              |
|                         |          |                         |   "message": "Waiting to start",       |             |                |   "name": "CONTAINER.STATUS_CHANGE", |                   |
|                         |          |                         |   "status": "PENDING"                  |             |                |   "severity_text": "INFO"            |                   |
|                         |          |                         | }                                      |             |                | }                                    |                   |
+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+

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

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