ALTER SEMANTIC VIEW

修改现有语义视图的属性。

语法

ALTER SEMANTIC VIEW <name> RENAME TO <new_name>; ALTER SEMANTIC VIEW <name> SET COMMENT '<string>'; ALTER SEMANTIC VIEW <name> SET TBLPROPERTIES ('<key>' = '<value>' [, ...]); ALTER SEMANTIC VIEW <name> UNSET COMMENT; ALTER SEMANTIC VIEW <name> UNSET TBLPROPERTIES ('<key>' [, ...]);

参数说明

参数	描述
`<name>` <name>	要修改的语义视图名称。支持多段标识符（如 `db.schema.view` db.schema.view ）。
`RENAME TO <new_name>` RENAME TO <new_name>	重命名语义视图。新名称在 Schema 内必须唯一。
`SET COMMENT '<string>'` SET COMMENT '<string>'	设置或覆盖注释。
`SET TBLPROPERTIES (...)` SET TBLPROPERTIES (...)	设置自定义属性键值对。
`UNSET COMMENT` UNSET COMMENT	移除注释。
`UNSET TBLPROPERTIES (...)` UNSET TBLPROPERTIES (...)	移除指定的自定义属性。

使用说明

无需运行中的虚拟集群 — 该命令不需要虚拟集群即可执行。
修改核心定义 — 要修改语义视图的 TABLES、DIMENSIONS、METRICS 或 FACTS 定义，请使用
```
CREATE OR REPLACE SEMANTIC VIEW
```
CREATE OR REPLACE SEMANTIC VIEW
。
RENAME 行为 — 重命名操作仅更改视图名称，不会影响已定义的维度、指标或关系。
SET TBLPROPERTIES — 用于存储用户自定义的键值对元数据。

权限要求

权限	对象	说明
`OWNERSHIP` OWNERSHIP	语义视图	必须拥有目标语义视图的所有权

示例

重命名

ALTER SEMANTIC VIEW sv RENAME TO sv_new_name;

设置注释

ALTER SEMANTIC VIEW my_semantic_view SET COMMENT 'Updated comment for the view';

移除注释

ALTER SEMANTIC VIEW my_semantic_view UNSET COMMENT;

设置自定义属性

ALTER SEMANTIC VIEW my_semantic_view SET TBLPROPERTIES ('owner' = 'analytics_team');

移除自定义属性

ALTER SEMANTIC VIEW my_semantic_view UNSET TBLPROPERTIES ('owner');