<budget_name>!GET_SPENDING_HISTORY

查看 预算 的支出历史记录。

另请参阅：

<budget_name>!GET_SERVICE_TYPE_USAGE

语法

<budget_name>!GET_SPENDING_HISTORY( [ TIME_LOWER_BOUND => <constant_expr> ,
                                      TIME_UPPER_BOUND => <constant_expr> ] )
Copy

可选实参

TIME_LOWER_BOUND => constant_expr, . TIME_UPPER_BOUND => constant_expr

支出发生的时间范围（UTC 时间戳格式）。

您必须同时设置时间下限和时间上限，以便根据时间范围限定结果。

返回

该函数返回以下列：

列名称

数据类型

描述

MEASUREMENT_DATE

DATE

使用发生的日期。

SERVICE_TYPE

VARCHAR

使用 Credit 的 服务类型，可以是以下类型之一：

  • AUTO_CLUSTERING

  • HYBRID_TABLE_REQUESTS

  • MATERIALIZED_VIEW

  • PIPE

  • QUERY_ACCELERATION

  • SEARCH_OPTIMIZATION

  • SERVERLESS_TASK

  • SNOWPIPE_STREAMING

  • WAREHOUSE_METERING

  • WAREHOUSE_METERING_READER

CREDITS_SPENT

FLOAT

使用的 Credit。

访问控制要求

  • 查看 自定义预算 的结果需要以下最低权限和角色：

    • 预算实例的任何 实例角色。

    • 对包含预算实例的数据库和架构的 USAGE 权限。

  • 需要以下角色才能查看 账户预算 的结果：

    账户预算的任何 应用程序角色。

有关更多信息，请参阅 Budgets 角色和权限。

使用说明

调用此方法不会返回对象。因此，您无法使用方法链来调用此方法返回值上的另一个方法。相反，应在单独 SQL 语句中调用每个方法。

示例

查看 budget_db.budget_schema 架构中预算 my_budget 的支出历史记录：

CALL budget_db.budget_schema.my_budget!GET_SPENDING_HISTORY();
Copy

查看账户预算最近 7 天的支出历史记录：

CALL snowflake.local.account_root_budget!GET_SPENDING_HISTORY(
  TIME_LOWER_BOUND=>dateadd('days', -7, current_timestamp()),
  TIME_UPPER_BOUND=>current_timestamp()
);
Copy
语言: 中文