语义视图使用指南

语义视图是云器 Lakehouse 中的一种逻辑数据模型对象，在物理表结构与业务分析需求之间建立一层语义抽象：你集中定义表关系、维度和指标，查询时引擎自动处理 JOIN 和聚合，业务用户无需编写复杂 SQL，全组织也能用统一的指标口径。

本页面向数据查询与分析场景，帮你快速上手查询已有的语义视图。功能定位、核心组件、建模与管理的完整文档，见语义视图概述及其文档导航。

查询语义视图

用

semantic_view()

semantic_view()

表函数查询，在括号里指定视图名、维度和指标（视图名后不加逗号，每个关键字只出现一次，后跟逗号分隔的项）：

SELECT * FROM semantic_view( <视图名> DIMENSIONS <维度1>, <维度2> METRICS <指标1>, <指标2> ) ORDER BY <维度1>;

DIMENSIONS

DIMENSIONS

METRICS

METRICS

FACTS

FACTS

与顺序无关，

WHERE

WHERE

和

VARIABLES

VARIABLES

是结尾子句。完整语法、过滤、排序、与传统 SQL 的对比见查询语义视图。

不知道某个视图有哪些维度和指标时，用内省命令逐行查看，例如

SHOW SEMANTIC METRICS IN <视图>

SHOW SEMANTIC METRICS IN <视图>

、

SHOW SEMANTIC DIMENSIONS IN <视图> [ FOR METRIC <指标> ]

SHOW SEMANTIC DIMENSIONS IN <视图> [ FOR METRIC <指标> ]

，详见管理语义视图的"查看视图结构（内省命令）"。

按查询与分析场景，最常用的几篇：

文档	内容
查询语义视图	`semantic_view()` semantic_view() 函数用法、过滤、排序、与传统 SQL 对比
高级查询用法	子查询、CTE、与普通表 JOIN、CTAS、INSERT INTO
关系建模与聚合粒度	外键关系如何决定 JOIN 和聚合粒度、扇出与 chasm trap
管理语义视图	内省命令、SHOW CREATE、DESC EXTENDED、权限控制
能力与限制参考	指标/元数据/DDL/权限的支持与限制汇总

设计、创建、组织发现等完整专题，见语义视图概述的文档导航。