SHOW SEMANTIC DIMENSIONS

列出语义视图中的维度。

语法

SHOW SEMANTIC DIMENSIONS IN <semantic_view_name>; SHOW SEMANTIC DIMENSIONS 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

字典序排列。

使用说明

无需运行中的虚拟集群 — 该命令不需要虚拟集群即可执行。
权限控制 — 仅返回当前用户有权限访问的语义视图中的维度。
粒度安全 — 该命令返回所有声明的维度，不进行粒度过滤。（如需按指标过滤维度，请使用
```
SHOW SEMANTIC DIMENSIONS ... FOR METRIC
```
SHOW SEMANTIC DIMENSIONS ... FOR METRIC
。）

权限要求

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

示例

列出指定语义视图中的所有维度

SHOW SEMANTIC DIMENSIONS IN tpch_sv;

输出示例（节选）：

tianqi_ws semantic_view tpch_sv CUSTOMER C_MKTSEGMENT char(10) "" NULL PUBLIC tianqi_ws semantic_view tpch_sv LINEITEM L_RETURNFLAG char(25) "" NULL PUBLIC tianqi_ws semantic_view tpch_sv ORDERS O_ORDERDATE date "" NULL PUBLIC tianqi_ws semantic_view tpch_sv PART P_BRAND char(10) "" NULL PUBLIC tianqi_ws semantic_view tpch_sv REGION R_NAME char(25) "" NULL PUBLIC ...

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

SHOW SEMANTIC DIMENSIONS FROM tpch_sv;