#ALTER OUTLINE
# 通用描述
ALTER OUTLINE用于修改一个存储纲要,包括重建,更改名称,更改归属类别,设置为有效,设置为无效等操作。
用户必须拥有ALTER ANY OUTLINE权限才能修改一个存储纲要。
在分布式部署中,执行本语句时系统会检查是否存在异常未恢复DDL语句,若存在将报错并需等待对应DDL恢复成功后才能执行本语句。
# 语句定义
alter_outline::=
# public
公有模式,默认值。
# outline_name
将要修改的OUTLINE的名称。
# rebuild
OUTLINE进行重建,即重新生成对应的hint信息。
# rename to new_outline_name
对OUTLINE重命名。重命名的OUTLINE名称不能带模式名指定,且需符合YashanDB的对象命名规范。
# change category to category_name
更改OUTLINE对应的类别。类别名称可以是已经存在的或者新指定的,不能带模式名指定,且需符合YashanDB的对象命名规范。
# enable
允许使用该OUTLINE。
# disable
不允许使用该OUTLINE。
示例
-- 重建OUTLINE
ALTER OUTLINE ol_a REBUILD;
-- 更改OUTLINE的归属类别,系统自动创建不存在的类别
ALTER OUTLINE ol_a CHANGE CATEGORY TO ctgy_new;
-- 禁止使用OUTLINE
ALTER OUTLINE ol_a DISABLE;
-- 取消OUTLINE的禁用状态
ALTER OUTLINE ol_a ENABLE;