ALTER SEMANTIC VIEW

更新时间:
复制 MD 格式

ALTER SEMANTIC VIEW用于重命名已有的语义视图。当前仅支持重命名操作,如需修改定义内容,请使用CREATE OR REPLACE SEMANTIC VIEW。

说明

语义视图的所有 DDL 语句均需在语句前添加 Hint /*+ enable_semantic=true */,否则系统无法识别语义视图语法。

语法

/*+ enable_semantic=true */
ALTER SEMANTIC VIEW [ IF EXISTS ] [view_schema.]view_name RENAME TO [view_schema.]new_name

参数说明

参数

是否必选

说明

IF EXISTS

指定后,若目标语义视图不存在,系统不会报错,仅产生告警信息。不指定时,若目标视图不存在则返回错误。

view_schema

语义视图所属的数据库名称。不指定时使用当前数据库。

view_name

要重命名的语义视图的当前名称。

new_name

语义视图的新名称。新名称在目标Schema中必须唯一,不能与已有的语义视图、普通表或普通视图重名。

注意事项

  • 当前仅支持RENAME TO操作,不支持修改定义内容。如需更新定义,请使用CREATE OR REPLACE SEMANTIC VIEW重新创建。

  • 重命名操作会同步更新向量索引。若Embedding服务不可用,操作可能失败;可安全重试,不影响数据一致性(DDL为原子操作,保证幂等)。

  • 重命名不影响语义视图的定义内容和权限配置。

示例

  • 重命名当前数据库中的语义视图。

    /*+ enable_semantic=true */
    ALTER SEMANTIC VIEW sales_analysis RENAME TO sales_overview;
  • 重命名指定数据库中的语义视图。

    /*+ enable_semantic=true */
    ALTER SEMANTIC VIEW analytics.sales_analysis RENAME TO analytics.sales_overview;
  • 使用IF EXISTS安全重命名,视图不存在时不报错。

    /*+ enable_semantic=true */
    ALTER SEMANTIC VIEW IF EXISTS old_view RENAME TO new_view;