#ALTER OUTLINE

# 通用描述

ALTER OUTLINE用于修改一个存储纲要,包括重建,更改名称,更改归属类别,设置为有效,设置为无效等操作。

用户必须拥有ALTER ANY OUTLINE权限才能修改一个存储纲要。

# 语句定义

alter_outline::=

syntax
ALTER PUBLIC OUTLINE outline_name REBUILD RENAME TO new_outline_name CHANGE CATEGORY TO category_name ENABLE DISABLE

# 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;