架构：: ACCOUNT_USAGE

STORAGE_REQUEST_HISTORY 视图¶

This Account Usage view displays historical data for storage request usage within the last 365 days (1 year). The view tracks HTTP requests made by external query engines through Snowflake Horizon Catalog to access Iceberg tables that use Snowflake storage.

另请参阅：: 适用于 Apache Iceberg™ 表的 Snowflake Storage

列¶


列名称	数据类型	描述
START_TIME	TIMESTAMP_LTZ	数据聚合窗口的开始时间。
END_TIME	TIMESTAMP_LTZ	数据聚合窗口的结束时间。
OPERATION_TYPE	VARCHAR	操作类型：``Class 1``（PUT、COPY、POST、PATCH 和 LIST 操作）或 ``Class 2``（GET 和 SELECT 操作）。
COUNT	NUMBER	聚合窗口期间 API 调用的总数。

使用说明¶

视图的延迟时间最长可达 6 小时。
此视图跟踪账单报告上根据 ``STORAGE_REQUEST-1``（1 类）和 ``STORAGE_REQUEST-2``（2 类）SKUs 计费的请求。
此视图仅跟踪对使用 Snowflake 存储的 Iceberg 表的请求。对于使用客户拥有的外部存储（桶）的 Iceberg 表，此视图不适用。
当您使用 Snowflake 查询引擎直接访问 Iceberg 表时，Snowflake 不会向您的账户计费。此视图仅跟踪外部查询引擎通过 Horizon 目录发出的请求。
有关计费率，请参阅 Snowflake 服务使用量表中的表 3(g)。

示例¶

检索过去 7 天的存储请求计数：

SELECT
  START_TIME,
  END_TIME,
  OPERATION_TYPE,
  COUNT
FROM SNOWFLAKE.ACCOUNT_USAGE.STORAGE_REQUEST_HISTORY
WHERE START_TIME >= DATEADD(day, -7, CURRENT_TIMESTAMP())
ORDER BY START_TIME DESC;

按操作类型计算过去一个月的请求总数：

SELECT
  OPERATION_TYPE,
  SUM(COUNT) AS TOTAL_REQUESTS
FROM SNOWFLAKE.ACCOUNT_USAGE.STORAGE_REQUEST_HISTORY
WHERE START_TIME >= DATEADD(month, -1, CURRENT_TIMESTAMP())
GROUP BY OPERATION_TYPE;