<service_name>!SPCS_GET_METRICS¶

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

备注

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

语法¶

<service_name>!SPCS_GET_METRICS(
    [ 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) 时间戳。
`METRIC_NAME`	VARCHAR	指标的名称。
`VALUE`	VARCHAR	指标的值。
`UNIT`	VARCHAR	返回的指标单位。
`INSTANCE_ID`	NUMBER	如果指标与服务实例相关，则为服务实例的名称。
`CONTAINER_NAME`	VARCHAR	如果指标与容器相关，则为容器名称。例如，容量指标没有容器名称。
`RESOURCE`	VARCHAR	指标所针对的硬件（例如 GPU）。此列未填充。
`RECORD`	OBJECT	用于提供指标信息的键值对。
`RECORD_ATTRIBUTES`	OBJECT	用于提供有关指标的其他信息的键值对。

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

权限	对象	备注
OWNERSHIP	服务

要对架构中的任何对象执行操作，需要对父数据库和架构的 USAGE 权限。请注意，如果某个角色获授某个架构的任意权限，该角色便能够解析该架构。例如，若某角色被授予 CREATE 权限，则可以在该架构上创建对象，而无需同时被授予该架构的 USAGE 权限。

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

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

检索 Snowflake 在过去一天（默认值）为 my_test_job 作业收集的指标。

SELECT * FROM TABLE(my_test_job!SPCS_GET_METRICS());

Copy

检索 Snowflake 在过去三天为 my_test_job 作业收集的指标。

SELECT * from TABLE(my_test_job!SPCS_GET_METRICS(start_time => DATEADD('day', -3, CURRENT_TIMESTAMP())));

Copy

检索名为 main 的容器中 spcs_get_metrics 作业实例 0 过去一天的指标。

SELECT * FROM TABLE(my_test_job!SPCS_GET_METRICS())
 WHERE instance_id = 0 AND container_name = 'main';

Copy