SHOW SEMANTIC METRICS

列出语义视图中的指标（Metrics）。指标是预先定义的聚合表达式，可直接在查询中使用。

语法

SHOW SEMANTIC METRICS IN <semantic_view_name>; SHOW SEMANTIC METRICS FROM <semantic_view_name>;

其中

IN

和

FROM

FROM

可互换使用。

说明：当前仅支持指定语义视图名称的查询，不支持跨视图列举所有指标。

参数说明

参数	描述
`<semantic_view_name>` <semantic_view_name>	必填。语义视图名称。支持多段标识符（如 `db.schema.view` db.schema.view ）。

输出列

列名	类型	描述
`workspace_name` workspace_name	TEXT	工作空间名称
`schema_name` schema_name	TEXT	Schema 名称
`semantic_view_name` semantic_view_name	TEXT	语义视图名称
`table_name` table_name	TEXT	指标所属的逻辑表名（大写的表别名）
`name` name	TEXT	指标名称
`data_type` data_type	TEXT	指标的数据类型
`synonyms` synonyms	TEXT	指标的同义词列表
`comment` comment	TEXT	指标的注释
`access` access	TEXT	访问级别： `PUBLIC` PUBLIC 或 `PRIVATE` PRIVATE

结果按

table_name, name

table_name, name

字典序排列。

使用说明

无需运行中的虚拟集群 — 该命令不需要虚拟集群即可执行。
权限控制 — 仅返回当前用户有权限访问的语义视图中的指标。
Private 指标 — 标记为
```
PRIVATE
```
PRIVATE
的指标不会暴露给仅拥有普通权限的用户。

权限要求

权限	对象	说明
任意权限	语义视图	至少需要对语义视图拥有一个权限

示例

列出指定语义视图中的指标

SHOW SEMANTIC METRICS IN tpch_sv;

输出示例（节选）：

tianqi_ws semantic_view tpch_sv LINEITEM AVG_DISC decimal(19,6) "" NULL PUBLIC tianqi_ws semantic_view tpch_sv LINEITEM AVG_PRICE decimal(19,6) "" NULL PUBLIC tianqi_ws semantic_view tpch_sv LINEITEM COUNT_ORDER bigint "" NULL PUBLIC tianqi_ws semantic_view tpch_sv LINEITEM REVENUE decimal(38,4) "" NULL PUBLIC tianqi_ws semantic_view tpch_sv LINEITEM SUM_BASE_PRICE decimal(25,2) "" NULL PUBLIC tianqi_ws semantic_view tpch_sv LINEITEM SUM_QTY decimal(25,2) "" NULL PUBLIC ...

使用 FROM 关键字（IN 的等价写法）

SHOW SEMANTIC METRICS FROM tpch_sv;