类别：

Information Schema、表函数

WAREHOUSE_METERING_HISTORY

此表函数可用在查询中，以返回指定日期范围内单个仓库（或账户中的所有仓库）的每小时 Credit 使用量。

备注

此函数返回过去 6 个月内的 Credit 使用量。但如果您查询多个仓库在很长一段时间内的数据，则可能无法返回完整数据集。要获得完整的数据集，请改用 ACCOUNT_USAGE 视图。

另请参阅：

WAREHOUSE_LOAD_HISTORY

语法

WAREHOUSE_METERING_HISTORY(
      DATE_RANGE_START => <constant_expr>
      [ , DATE_RANGE_END => <constant_expr> ]
      [ , WAREHOUSE_NAME => '<string>' ] )
Copy

实参

必填：

DATE_RANGE_START => constant_expr

过去 6 个月内返回仓库使用情况的开始日期。

可选：

DATE_RANGE_END => constant_expr

过去 6 个月内返回仓库使用情况的结束日期。

默认：使用 CURRENT_DATE。

WAREHOUSE_NAME => 'string'

要检索其 Credit 使用量的仓库的名称。注意，仓库名称必须使用单引号括起来。此外，如果仓库名称包含任何空格、混合大小写字符或特殊字符，则名称必须在单引号内使用双引号（例如 '"My Warehouse"' 和 'mywarehouse'）。

默认：在指定日期范围内运行的所有仓库。

使用说明

  • 仅为 ACCOUNTADMIN 角色或任何已明确授予 MONITOR USAGE 全局权限的角色返回结果。

  • 当调用 Information Schema 表函数时，会话必须具有正在使用的 INFORMATION_SCHEMA 架构，或者 函数名称必须受到完全限定。有关更多详细信息，请参阅 Snowflake Information Schema。

  • 实参的顺序和结构取决于是否包含实参关键字（例如 DATE_RANGE_START）：

    • 如果按顺序指定实参，则不需要关键字。

    • 如果包含实参关键字，则可以按任意顺序指定实参。

输出

该函数按 WAREHOUSE_NAME 和 START_TIME 排序返回以下列：

列名称

数据类型

描述

START_TIME

TIMESTAMP_LTZ

此仓库使用的开始时间。

END_TIME

TIMESTAMP_LTZ

此仓库使用的结束时间。

WAREHOUSE_NAME

TEXT

仓库的名称。

CREDITS_USED

NUMBER

一小时内此仓库的计费 Credit。

CREDITS_USED_COMPUTE

NUMBER

一小时内仓库使用的 Credit 的量。

CREDITS_USED_CLOUD_SERVICES

NUMBER

一小时内用于云服务的 Credit 的量。

示例

检索过去 10 天在此时间段内运行的所有仓库的每小时仓库使用情况：

select *
from table(information_schema.warehouse_metering_history(dateadd('days',-10,current_date())));
Copy

检索在指定日期 testingwh 仓库的每小时仓库使用情况：

select *
from table(information_schema.warehouse_metering_history('2017-10-23', '2017-10-23', 'testingwh'));
Copy
语言: 中文