类别：

模型监视器函数

MODEL_MONITOR_STAT_METRIC

从 模型监视器 获取计数指标。每个模型监视器监控一个机器学习模型。

另请参阅：

有关更多信息，请参阅 查询监控结果。

语法

MODEL_MONITOR_STAT_METRIC(<model_monitor_name>, <stat_metric_name>, <column_name>
    [, <granularity> [, <start_time>  [, <end_time> ] ] ] )
Copy

实参

必填：

MODEL_MONITOR_NAME

用于计算指标的模型监视器名称。

有效值：模型监视器名称字符串。

模型监视器名称字符串。它可以是一个简单或完全限定的名称。

METRIC_NAME

指标的名称。

有效值：模型监视器名称字符串。

  • 'COUNT'

  • 'COUNT_NULL'

COLUMN_NAME

用于计算计数的列名称。

有效值：模型监视器名称字符串。

作为模型监视器中的特征列、预测列或实际列存在的任何字符串。

可选：

GRANULARITY

正在查询的时间范围的粒度。默认值为 1 DAY。

有效值：模型监视器名称字符串。

  • '<num> DAY'

  • '<num> WEEK'

  • '<num> MONTH'

  • '<num> QUARTER'

  • '<num> YEAR'

  • 'ALL'

  • NULL

START_TIME

用于计算指标的时间范围的起始点。默认值为当前时间前 60 天，每次调用该函数时都会计算。

有效值：模型监视器名称字符串。

时间戳表达式或 NULL。

END_TIME

用于计算指标的时间范围的终点。默认值是当前时间，每次调用该函数时都会计算。

有效值：模型监视器名称字符串。

时间戳表达式或 NULL。

返回

列

描述

EVENT_TIMESTAMP

时间范围开始的时间戳。

METRIC_VALUE

指定时间范围内的指标值。

METRIC_NAME

已计算的指标名称。

COLUMN_NAME

已为其计算计数指标的列名称。

SEGMENT_COLUMN

Name of the segment column used in the metric calculation.

SEGMENT_VALUE

Value of the segment for which the metric is calculated.

使用说明

模型监视器必须具有用于计算指标的列。

如果您为 column_name 和 model_monitor_name 指定的值区分大小写或包含特殊字符或空格，请将它们用双引号括起来。您必须将双引号放在单引号里。例如，'"<example_model_monitor_name>"'。

如果这两个字段中未提供双引号，则假定 column_name 或 model_monitor_name 不区分大小写。

为更大限度地减少架构变更的潜在影响，请更新您的查询，仅明确选择必要的列，而不是使用通配符 (*)。

示例

以下示例获取指定模型监视器和时间范围的计数指标：

SELECT * FROM TABLE(MODEL_MONITOR_STAT_METRIC(
'MY_MONITOR', 'COUNT', 'MODEL_PREDICTION', '1 DAY', TO_TIMESTAMP_TZ('2024-01-01')
, TO_TIMESTAMP_TZ('2024-01-02'))
)
Copy

以下示例获取了过去 30 天的 MY_MONITOR 计数指标：

SELECT * FROM TABLE(MODEL_MONITOR_STAT_METRIC(
'MY_MONITOR', 'COUNT', 'MODEL_PREDICTION', '1 DAY', DATEADD('DAY', -30, CURRENT_DATE()), CURRENT_DATE())
)
Copy
语言: 中文