#ALTER TABLESPACE
# 通用描述
ALTER TABLESPACE语句用于更改一个已存在的表空间的相关属性。
在分布式部署中，执行本语句时系统会检查是否存在异常未恢复DDL语句，若存在将报错并需等待对应DDL恢复成功后才能执行本语句。
# 语句定义
alter tablespace::=
# datafile_clause
该语句用于修改表空间的数据文件。
分布式部署中，仅允许对通过CREATE TABLESPACE语句创建的表空间新增/删除数据文件，若修改表空间数据文件时出现节点故障，恢复措施见用户表空间管理章节描述。
# add (datafile|tempfile)
为表空间增加一个或多个数据文件（临时文件需使用TEMPFILE关键字）。对于本地临时表空间以及本地SWAP表空间而言，添加一个文件等于添加一组文件，每一组文件数量的个数等于集群实例个数。
file_specification的描述请参考CREATE TABLESPACE。
当不指定file_specification时，系统按如下规则自动创建一个数据文件：
- 文件名称由表空间名称以及数据文件在表空间内的序号组合生成，如：tablespace_name1，tablespace_name2...，且统一转换为大写。
- 文件的默认大小为8192个BLOCK，文件路径为系统默认的数据文件路径。
- 对于非MEMORY MAPPED表空间，默认文件开启自动扩展，next为8192个块，maxsize为64MB个块。
- 如果没有显式的规定extent分配方式，extent的默认分配方式为系统自动分配。
# drop (datafile|tempfile)
删除表空间的某个数据文件（临时文件需使用TEMPFILE关键字）。对于本地临时表空间以及本地SWAP表空间而言，删除一个文件等于删除一组文件，每一组文件数量的个数等于集群实例个数。
删除表空间文件的规则如下：
不允许删除创建该表空间时指定的第一个数据文件以及非ONLINE的数据文件。
不允许删除UNDO表空间的数据文件。
不允许删除默认SWAP表空间的数据文件。
如需通过DROP TEMPFILE删除影子文件，需确保创建该临时文件的数据库为当前主库（若不是，需先切换为主库）并在该主库上执行DROP TEMPFILE语句，其他备库收到DROP TEMPFILE的redo后才会清理影子记录。
Note：
MEMORY MAPPED表空间的数据文件删除后该文件内部ID以及全局ID在该表空间被删除并重启数据库之前都不允许被复用。
当增加数据文件导致文件的表空间内部ID到达表空间限制（63）时，删除已有文件也无法向该表空间添加数据文件。
如果删除数据文件中途数据库掉电，重启后磁盘可能会有残留文件，此时需要手动删除。
示例（单机、共享集群部署）
ALTER TABLESPACE SYSTEM ADD DATAFILE 'sys1' SIZE 4M AUTOEXTEND ON NEXT 4M MAXSIZE 1G;
ALTER TABLESPACE yashan ADD DATAFILE 'yashan_add1' SIZE 4M AUTOEXTEND ON NEXT 4M MAXSIZE 1G;
ALTER TABLESPACE yashan ADD DATAFILE 'yashan_add2' SIZE 4M AUTOEXTEND ON NEXT 4M MAXSIZE 1G PARALLEL 4;
ALTER TABLESPACE yashan ADD DATAFILE;
ALTER TABLESPACE SYSTEM DROP DATAFILE 'sys1';
ALTER TABLESPACE yashan DROP DATAFILE 'yashan_add1';
# databucket_clause
该语句用于修改表空间的databucket（数据桶）信息。
# add_databucket_clause
为表空间增加databucket，可同时挂载多个，以,分隔。对于新建databucket的描述与约束与CREATE TABLESPACE章节中databucket_clause语句相同。
# bucket_clause
同CREATE TABLESPACE章节中bucket_clause语句描述。
# s3_bucket_clause
同CREATE TABLESPACE章节中s3_bucket_clause语句描述。
示例（单机、分布式部署）
ALTER TABLESPACE lsc_tb ADD DATABUCKET '?/lscfile_add3' MAXSIZE 1G;
# alter_databucket_clause
该语句用于修改databucket的读写属性，创建的databucket均默认为可读写属性。
分布式部署中用户无法执行此操作。
# bucket_name
对于不同的databucket类型，bucket_name具有不同的含义：
对于本地存储的bucket，bucket_name为bucket在本地文件系统的绝对路径或相对路径（分布式部署中不允许指定绝对路径）。
对于S3 bucket，bucket_name为逻辑名称，用于在数据库内查询具体的bucket信息。
# readonly|readwrite
readonly表示只读，readwrite表示可读写。
注意databucket修改为只读后不支持任何形式的写入操作，但用户执行的DML语句（非Bulkload操作）不受影响，执行Bulkload操作时由于需要生成SCOL数据，若表空间下没有可写入的databucket则会报错。
示例（单机部署）
ALTER TABLESPACE lsc_tb ALTER DATABUCKET '?/lscfile_add3' READONLY;
# drop_databucket_clause
删除表空间的某个databucket，每次只允许指定一个databucket删除。
分布式部署中用户无法执行此操作。
# bucket_name
同alter_databucket_clause语句描述。
示例（单机部署）
ALTER TABLESPACE lsc_tb DROP DATABUCKET '?/lscfile_add3';
# shrink_clause
该语句用于根据各个数据文件的空间使用情况回收空闲空间，收缩表空间大小。
共享集群部署中不允许执行shrink_clause。
Note：
- 不能对UNDO表空间执行该语句。
- 在主库上对SWAP和TEMP表空间进行shrink，不会同步到备库。
# keep size_clause
将表空间收缩至指定大小，如表空间实际使用已超过该大小值，则收缩失败并返回错误。
不指定KEEP时，系统将最大化收缩表空间。
示例（单机、分布式部署）
ALTER TABLESPACE SYSTEM SHRINK SPACE KEEP 100M;
ALTER TABLESPACE SYSTEM SHRINK SPACE;
# offline_clause
改变表空间至脱机状态。本操作一般应用于如下业务场景：
- 数据库的部分数据不再开放访问，则可以将其所在表空间offline
- 需要对表空间里的数据文件进行重命名或重分配时，将表空间offline，则其下所有的数据文件均会被offline
当某个表空间被offline后，该表空间下的所有数据文件将不可读写也不可修改，且不能对该表空间执行DDL操作，包括增删数据文件等操作。
SYSTEM/SYSAUX/UNDO/SWAP/TEMPORARY等内置表空间不允许offline。
共享集群部署中不允许执行offline_clause。
Note：
被offline的表空间及其下数据文件仍为数据库的一部分，因此不能创建与它们同名的表空间或数据文件。
# normal| temporary | immediate
offline选项，可省略，默认为NORMAL。
OFFLINE NORMAL：当表空间所有的数据文件均没有脱机时，才会将表空间及数据文件offline，否则报错。
OFFLINE TEMPORARY：允许表空间中存在已经脱机的数据文件，只对online的数据文件执行offline。
OFFLINE IMMDIATE：对非脱机的数据文件立即执行offline，可能存在归档或redo日志没有完全应用于数据文件，处于不一致状态，所以该操作offline的数据文件无法直接online。当数据库未开启归档模式时，不允许指定此选项执行offline。
示例（单机、分布式部署）
ALTER TABLESPACE yashan OFFLINE;
ALTER TABLESPACE yashan1 OFFLINE NORMAL;
ALTER TABLESPACE yashan2 OFFLINE TEMPORARY;
ALTER TABLESPACE yashan3 OFFLINE IMMEDIATE;
# online
改变脱机表空间至在线状态，使其正常可用。
影子状态的临时文件不存在物理文件，不能被online。
本操作将表空间及其下的所有数据文件online，如果存在无法online的数据文件，则执行失败并返回错误。
共享集群部署中不允许执行online。
示例（单机、分布式部署）
ALTER TABLESPACE yashan ONLINE;
# rename_clause
该语句用于表空间或数据文件重命名，限制如下：
- 不允许将某个表空间重命名为当前已存在的表空间名称。
- 不允许使用该语句对内置表空间进行重命名。
- 不允许使用该语句对OFFLINE的表空间进行重命名。
- 不允许使用该语句对正在使用的SWAP表空间进行重命名，如需对此进行重命名，先修改DEFAULT_SWAP_TABLESPACE配置参数，再进行重命名操作。
- 分布式部署中不允许对表空间或数据文件重命名。
示例（单机、共享集群部署）
ALTER TABLESPACE yashan1 RENAME TO yashanDb;
下载文档
复制链接