用量与账单视图

sys.information_schema.instance_usage

sys.information_schema.instance_usage

是 ClickZetta Lakehouse 的系统视图，记录实例级别的资源用量和费用明细。每行对应一个 SKU 在一个计费周期（小时或天）内的消耗记录，是账单核对、成本归因和用量趋势分析的主要数据来源。

数据从实例创建起持续保留。

字段说明

字段	类型	说明
`account_id` account_id	int	账户 ID
`account_name` account_name	string	账户名称（即实例名）
`instance_id` instance_id	int	实例 ID
`region_name` region_name	string	所在云区域，例如 `阿里云-华东2（上海）` 阿里云-华东2（上海）
`sku_category` sku_category	string	SKU 大类，见下方分类说明
`sku_name` sku_name	string	SKU 具体名称
`workspace_id` workspace_id	string	workspace ID
`workspace_name` workspace_name	string	workspace 名称
`measurement_start` measurement_start	timestamp	计量周期开始时间
`measurement_end` measurement_end	timestamp	计量周期结束时间
`measurements_unit` measurements_unit	string	计量单位，例如 `yuan/cru` yuan/cru 、 `yuan/GiB/day` yuan/GiB/day 、 `yuan/gb` yuan/gb 、 `M Tokens` M Tokens
`measurements_consumption` measurements_consumption	double	当期实际消耗量（对应计量单位）
`price_rate` price_rate	string	单价（字符串形式，如 `"0.020000"` "0.020000" ）
`amount` amount	double	原始金额（消耗量 × 单价，折扣前）
`discount_rate` discount_rate	double	折扣率， `1` 1 表示无折扣， `0.8` 0.8 表示八折
`total_after_discount` total_after_discount	double	折后实际费用（最终计费金额）

SKU 分类

`sku_category` sku_category	包含的 `sku_name` sku_name	说明
`compute` compute	GP类型计算集群、AP类型计算集群、同步型计算集群、数据集成、流式集成、IGS服务、任务调度	计算资源消耗，单位 `yuan/cru` yuan/cru
`storage` storage	托管存储容量、多版本未删除存储、作业缓存存储、托管user_volume存储	存储占用，单位 `yuan/GB/day` yuan/GB/day 或 `yuan/GiB/day` yuan/GiB/day
`network` network	数据查询Internet数据传输	公网出流量，单位 `yuan/gb` yuan/gb
`ai` ai	AI 模型调用（含多种模型，input/output 分别计量）	AI 函数消耗，单位 `M Tokens` M Tokens

常用查询示例

查询最近 7 天的总费用（按 SKU 大类汇总）

SELECT sku_category, SUM(measurements_consumption) AS total_consumption, SUM(amount) AS amount_before_discount, SUM(total_after_discount) AS total_cost FROM sys.information_schema.instance_usage WHERE measurement_start >= CURRENT_DATE() - INTERVAL 7 DAYS GROUP BY sku_category ORDER BY total_cost DESC;

按 workspace 查看本月费用排行

SELECT workspace_name, SUM(total_after_discount) AS total_cost FROM sys.information_schema.instance_usage WHERE measurement_start >= DATE_TRUNC('month', CURRENT_DATE()) GROUP BY workspace_name ORDER BY total_cost DESC;

查看某个 workspace 的每日费用趋势

SELECT DATE(measurement_start) AS date, sku_category, SUM(total_after_discount) AS daily_cost FROM sys.information_schema.instance_usage WHERE workspace_name = '<your_workspace>' AND measurement_start >= CURRENT_DATE() - INTERVAL 30 DAYS GROUP BY DATE(measurement_start), sku_category ORDER BY date DESC, daily_cost DESC;

查询计算集群的 CRU 消耗明细

SELECT workspace_name, sku_name, DATE(measurement_start) AS date, measurements_consumption AS cru_hours, total_after_discount AS cost FROM sys.information_schema.instance_usage WHERE sku_category = 'compute' AND measurement_start >= CURRENT_DATE() - INTERVAL 7 DAYS ORDER BY date DESC, cost DESC;

查看存储用量超过阈值的 workspace

SELECT workspace_name, sku_name, DATE(measurement_start) AS date, measurements_consumption AS storage_gib FROM sys.information_schema.instance_usage WHERE sku_category = 'storage' AND measurements_consumption > 100 AND measurement_start >= CURRENT_DATE() - INTERVAL 7 DAYS ORDER BY storage_gib DESC;

查看 AI 函数的 Token 消耗

SELECT workspace_name, sku_name, SUM(measurements_consumption) AS total_tokens_m, SUM(total_after_discount) AS total_cost FROM sys.information_schema.instance_usage WHERE sku_category = 'ai' GROUP BY workspace_name, sku_name ORDER BY total_cost DESC;

注意事项

```
storage
```
storage
类 SKU 的计量粒度为天，其余类别为小时。
数据非实时，约延迟 4 小时出账。
```
price_rate
```
price_rate
是字符串类型，参与数值计算时需
```
CAST(price_rate AS DOUBLE)
```
CAST(price_rate AS DOUBLE)
。
```
total_after_discount
```
total_after_discount
是最终计费金额，
```
amount
```
amount
是折扣前金额，两者之差为折扣优惠金额。

⚠️ 注意：该视图需要具备

instance_admin

instance_admin

角色的用户连接到

sys

sys

workspace 才可访问。若当前 workspace 不是

sys

sys

，可通过三段式写法

sys.information_schema.instance_usage

sys.information_schema.instance_usage

跨空间查询；无

instance_admin

instance_admin

权限的用户查询将返回空结果。

INSTANCE_RESOURCE_USAGE

INSTANCE_RESOURCE_USAGE

sys.information_schema.instance_resource_usage

sys.information_schema.instance_resource_usage

提供当前客户 instance 内非 AI SKU 的用量和费用明细。与按 workspace 汇总的

instance_usage

instance_usage

相比，该视图可以为部分 SKU 提供

resource_name

resource_name

粒度，适合查看具体资源的用量和费用。

以下 SKU 细化到

resource_name

resource_name

：

task_schedule

task_schedule

、

bulk_ingestion

bulk_ingestion

、

external_network

external_network

、

igs_upsert_v1

igs_upsert_v1

、

stream_ingestion

stream_ingestion

、

vc_ap_event

vc_ap_event

、

vc_gp_event

vc_gp_event

、

vc_integration_event

vc_integration_event

。其他非 AI SKU 保持 workspace 粒度，

resource_name

resource_name

为

NULL

NULL

。查询结果仅包含当前客户 instance 的数据，不需要额外按

instance_id

instance_id

过滤。

字段说明

以下字段为现有视图定义中的字段；具体字段类型和列顺序以目标环境执行

DESCRIBE

DESCRIBE

的结果为准。

字段	类型	说明
`account_id` account_id	BIGINT	账户 ID
`account_name` account_name	STRING	账户名称
`instance_id` instance_id	BIGINT	实例 ID
`region_name` region_name	STRING	实例所在区域名称
`sku_category` sku_category	STRING	SKU 大类，如 `compute` compute 、 `storage` storage 、 `network` network
`sku_code` sku_code	STRING	SKU 编码
`sku_name` sku_name	STRING	SKU 展示名称
`workspace_id` workspace_id	BIGINT	工作空间 ID
`workspace_name` workspace_name	STRING	工作空间名称
`measurement_start` measurement_start	TIMESTAMP	计量窗口开始时间
`measurement_end` measurement_end	TIMESTAMP	计量窗口结束时间
`measurements_unit` measurements_unit	STRING	用量计量单位
`measurements_consumption` measurements_consumption	DOUBLE	计量窗口内实际用量
`price_rate` price_rate	DECIMAL	计费单价
`amount` amount	DOUBLE	折前金额
`discount_rate` discount_rate	DOUBLE	折扣率
`total_after_discount` total_after_discount	DOUBLE	折后金额
`payable_amount` payable_amount	DOUBLE	应付金额
`precision_diff` precision_diff	DOUBLE	金额精度差额
`billing_unit` billing_unit	STRING	计费单位
`billing_mode` billing_mode	STRING	计费模式
`resource_name` resource_name	STRING	资源名称；workspace 粒度记录为 `NULL` NULL

查询示例

查看资源粒度 SKU 的用量和费用

SELECT workspace_name, sku_code, resource_name, measurement_start, measurement_end, measurements_consumption, total_after_discount, payable_amount FROM sys.information_schema.instance_resource_usage WHERE sku_code IN ( 'task_schedule', 'bulk_ingestion', 'external_network', 'igs_upsert_v1', 'stream_ingestion', 'vc_ap_event', 'vc_gp_event', 'vc_integration_event' ) AND measurement_start >= CURRENT_DATE() - INTERVAL 7 DAYS ORDER BY measurement_start DESC, workspace_name, sku_code, resource_name;

按 workspace 汇总非资源粒度 SKU

SELECT workspace_name, sku_code, SUM(measurements_consumption) AS total_consumption, SUM(total_after_discount) AS total_after_discount FROM sys.information_schema.instance_resource_usage WHERE resource_name IS NULL GROUP BY workspace_name, sku_code ORDER BY total_after_discount DESC;

联系我们

用量与账单视图

字段说明

SKU 分类

常用查询示例

查询最近 7 天的总费用（按 SKU 大类汇总）

按 workspace 查看本月费用排行

查看某个 workspace 的每日费用趋势

查询计算集群的 CRU 消耗明细

查看存储用量超过阈值的 workspace

查看 AI 函数的 Token 消耗

注意事项

INSTANCE_RESOURCE_USAGEINSTANCE_RESOURCE_USAGE

字段说明

查询示例

`INSTANCE_RESOURCE_USAGE`
INSTANCE_RESOURCE_USAGE