类别：: 表函数 (Snowpark Container Services)

<service_name>!SPCS_GET_EVENTS¶

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

另请参阅：: 监控服务

语法¶

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

实参¶

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());

输出示例：

+-------------------------+----------+-------------------------+----------------------------------------+-------------+----------------+--------------------------------------+-------------------+
| 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())));