ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA

返回特定账户或整个组织的每日使用量，并确定该使用量是否被视为 成本异常。

语法

SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '<start_date>',
  '<end_date>',
  <account_name> )
Copy

实参

'start_date'

指定返回使用量数据的时间段的开始时间。

数据类型：DATE

'end_date'

指定返回使用量数据的时间段的结束时间。

数据类型：DATE

account_name

指定用于确定返回使用量数据的账户的表达式。您可以指定以下值：

  • 'account_name'：返回指定账户的数据。您必须指定账户名称，而不是账户定位器。

  • CURRENT_ACCOUNT_NAME()：返回当前账户的数据。

  • NULL：返回整个组织的数据，而不是特定账户的数据。

返回

返回包含以下列的表：

列名称

数据类型

描述

USAGE_DATE

DATE

使用量产生的日期（采用 UTC 格式）。

CONSUMPTION

NUMBER

使用量数额（以 CURRENCY_TYPE 作为计量单位）。

FORECASTED_CONSUMPTION

NUMBER

根据异常检测算法预测的使用量（以 CURRENCY_TYPE 作为计量单位）。

UPPER_BOUND

NUMBER

根据异常检测算法预测的最高使用量水平（以 CURRENCY_TYPE 作为计量单位）。高于该值的使用量水平被视为异常。

LOWER_BOUND

NUMBER

根据异常检测算法预测的最低使用量水平（以 CURRENCY_TYPE 作为计量单位）。低于该值的使用量水平被视为异常。

IS_ANOMALY

BOOLEAN

如果为 true，则确定使用量为成本异常，因为它已超出上限和下限范围。

CURRENCY_TYPE

VARCHAR

使用量的计量单位。有关计量单位为何是 credit 或货币的信息，请参阅 成本数据的计量单位。

ANOMALY_ID

VARCHAR

系统生成的标识符。

访问控制要求

具有以下任何角色的用户都可以调用此方法：

  • ACCOUNTADMIN 角色

  • GLOBALORGADMIN 角色

使用说明

要返回其他账户或整个组织的数据，必须从 组织账户 或 启用了 ORGADMIN 的账户 中执行此方法。

示例

根据 2024 年 1 月 1 日至 2024 年 3 月 31 日期间的使用量，识别组织级异常：

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '2024-01-01', '2024-03-31', NULL);
Copy

根据 2024 年 1 月 1 日至 2024 年 3 月 31 日期间的使用量，识别当前账户中的异常：

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '2024-01-01', '2024-03-31', current_account_name());
Copy

根据 2024 年 1 月 1 日至 2024 年 3 月 31 日期间的使用量，识别账户 prod_acct1 中的异常：

CALL SNOWFLAKE.LOCAL.ANOMALY_INSIGHTS!GET_DAILY_CONSUMPTION_ANOMALY_DATA(
  '2024-01-01', '2024-03-31', 'prod_acct1');
Copy
语言: 中文