Categories:

表函数 (Snowpark Container Services)

<service_name>!SPCS_GET_METRICS

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

另请参阅：

监控服务

语法

<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

用于提供有关指标的其他信息的键值对。

访问控制要求

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

权限

对象

备注

MONITOR

服务

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

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

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

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

SELECT * FROM TABLE(mydb.myschema.my_test_job!SPCS_GET_METRICS())
 WHERE instance_id = 0 AND container_name = 'main';
Copy
语言: 中文