CREATE TABLESPACE
功能描述
在数据库中创建一个新的表空间。
注意事项
- 系统管理员或者继承了内置角色gs_roles_tablespace权限的用户可以创建表空间。
- 不允许在一个事务块内部执行CREATE TABLESPACE。
- 执行CREATE TABLESPACE失败，如果内部创建目录（文件）操作成功了就会产生残留的目录（文件），重新创建时需要用户手动清理表空间指定的目录下残留的内容。如果在创建过程中涉及到数据目录下的表空间软连接残留，需要先将软连接的残留文件删除，再重新执行OM相关操作。
- CREATE TABLESPACE不支持两阶段事务，如果部分节点执行失败，不支持回滚。
创建表空间前的准备工作参考下述参数说明。
语法格式
CREATE TABLESPACE tablespace_name [ OWNER user_name ] [ RELATIVE ] LOCATION 'directory' [ MAXSIZE 'space_size' ] [with_option_clause] [ THRESHOLD 'space_percentile' ];
其中普通表空间的with_option_clause为：
WITH ( filesystem= { 'systemtype'| "systemtype" | systemtype }
[ { , address = { 'ip:port [ , ... ]' | "ip:port [ , ... ]"} } ]
, cfgpath = { 'path'| "path" } ,storepath = { 'rootpath'| "rootpath"}
[{, random_page_cost = { 'value'| "value" | value }}]
[{,seq_page_cost = { 'value'| "value" | value }}])
参数说明
tablespace_name
要创建的表空间名称。
表空间名称不能和Vastbase中的其他表空间重名，且名称不能以“pg”开头，这样的名称留给系统表空间使用。
取值范围：字符串，要符合标识符的命名规范。
user_name
指定该表空间的所有者。缺省时，新表空间的所有者是当前用户。
只有系统管理员可以创建表空间，但是可以通过OWNER子句把表空间的所有权赋给其他非系统管理员。
取值范围：字符串，已存在的用户。
RELATIVE
若指定该参数，表示使用相对路径，LOCATION目录是相对于各个数据库节点数据目录下的。
目录层次：数据库节点的数据目录/pg_location/相对路径
相对路径最多指定两层。
若没有指定该参数，表示使用绝对表空间路径，LOCATION目录需要使用绝对路径。
LOCATION directory
用于表空间的目录。当创建绝对表空间路径时，对于目录有如下要求：
- Vastbase系统用户必须对该目录拥有读写权限，并且目录为空。如果该目录不存在，将由系统自动创建。
- 目录必须是绝对路径，目录中不得含有特殊字符（如$、> 等）。
- 目录不允许指定在数据库数据目录下。
- 目录需为本地路径。
取值范围：字符串，有效的目录。
-
指定表空间在单个数据库节点上的最大值。
取值范围：字符串格式为正整数+单位，单位当前支持K/M/G/T/P。解析后的数值以K为单位，且范围不能够超过64比特表示的有符号整数，即1KB~9007199254740991KB。
THRESHOLD 'space_percentile'
指定表空间阈值。当表空间实际大小达到该表空间阈值(THRESHOLD)时，告知用户该表空间使用信息，包括该表空间名、阈值、当前表空间大小、申请空间大小等，以便用户能够做出相应处理。
取值范围：字符串格式为正整数（1-99 默认为90），为MAXSIZE的百分比信息。
filesystem
指定表空间的文件系统。
取值范围：general。
默认值：general。
random_page_cost
指定随机读取page的开销。
取值范围：0~1.79769e+308。
默认值：使用GUC参数random_page_cost的值。
seq_page_cost
指定顺序读取page的开销。
取值范围：0~1.79769e+308。
默认值：使用GUC参数seq_page_cost的值。
示例
1、创建表空间。
CREATE TABLESPACE ds_location1 RELATIVE LOCATION 'tablespace/tablespace_1';
2、创建用户joe、用户jay。。
CREATE ROLE joe IDENTIFIED BY 'Aa123456';
CREATE ROLE jay IDENTIFIED BY 'Aa123456';
3、创建表空间，且所有者指定为用户joe。
CREATE TABLESPACE ds_location2 OWNER joe RELATIVE LOCATION 'tablespace/tablespace_2';
4、把表空间ds_location1重命名为ds_location3。
ALTER TABLESPACE ds_location1 RENAME TO ds_location3;
5、改变表空间ds_location2的所有者。
ALTER TABLESPACE ds_location2 OWNER TO jay;
6、删除表空间。
DROP TABLESPACE ds_location2;
DROP TABLESPACE ds_location3;
7、删除用户。
DROP ROLE joe;
DROP ROLE jay;
相关链接
CREATE DATABASE，CREATE TABLE，CREATE INDEX，DROP TABLESPACE，ALTER TABLESPACE
