#ALTER OUTLINE

# 通用描述

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

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

在分布式部署中，执行本语句时系统会检查是否存在异常未恢复DDL语句，若存在将报错并需等待对应DDL恢复成功后才能执行本语句。

# 语句定义

alter_outline::=

语法图

代码

syntax

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