CREATE DATABASE
功能描述
创建一个新的数据库。缺省情况下新数据库将通过复制标准系统数据库template0来创建,且仅支持使用template0来创建。
注意事项
- 只有拥有CREATEDB权限的用户才可以创建新数据库,系统管理员默认拥有此权限。
- 不能在事务块中执行创建数据库语句。
- 在创建数据库过程中,出现类似“Permission denied”的错误提示,可能是由于文件系统上数据目录的权限不足。出现类似“No space left on device”的错误提示,可能是由于磁盘满引起的。
- 事务中不支持创建database。
- 当新建数据库Encoding、LC-Collate 或LC_Ctype与模板数据库(SQL_ASCII)不匹配(为'GBK' /'UTF8'/'LATIN1'/'GB18030')时,必须指定template [=] template0。
语法格式
CREATE DATABASE database_name
[ [ WITH ] {[ OWNER [=] user_name ]|
[ TEMPLATE [=] template ]|
[ ENCODING [=] encoding ]|
[ LC_COLLATE [=] lc_collate ]|
[ LC_CTYPE [=] lc_ctype ]|
[ DBCOMPATIBILITY [=] compatibility_type ]|
[ TABLESPACE [=] tablespace_name ]|
[ CONNECTION LIMIT [=] connlimit ]}[...] ]|
[ PAD_ATTRIBUTE [=] pad_attribute_type ];
参数说明
database_name
数据库名称。
取值范围:字符串,要符合标识符的命名规范。
OWNER [ = ] user_name
数据库所有者。缺省时,新数据库的所有者是当前用户。
取值范围:已存在的用户名。
TEMPLATE [ = ] template
模板名。即从哪个模板创建新数据库。Vastbase采用从模板数据库复制的方式来创建新的数据库。初始时,Vastbase包含两个模板数据库template0、template1,以及一个默认的用户数据库postgres。
取值范围:仅template0。
ENCODING [ = ] encoding
指定数据库使用的字符编码,可以是字符串(如'SQL_ASCII')、整数编号。
不指定时,默认使用模版数据库的编码。模板数据库template0和template1的编码默认与操作系统环境相关。template1不允许修改字符编码,因此若要变更编码,请使用template0创建数据库。
常用取值:GBK、UTF8、Latin1、GB10830等,具体支持的字符集如下:
表 1 Vastbase字符集
需要注意并非所有的客户端API都支持上面列出的字符集。 SQL_ASCII设置与其他设置表现得相当不同。如果服务器字符集是SQL_ASCII,服务器把字节值0-127根据 ASCII标准解释,而字节值128-255则当作无法解析的字符。如果设置为SQL_ASCII,就不会有编码转换。因此,这个设置基本不是用来声明所使用的指定编码, 因为这个声明会忽略编码。在大多数情况下,如果你使用了任何非ASCII数据,那么使用 SQL_ASCII设置都是不明智的,因为Vastbase将无法帮助你转换或者校验非ASCII字符。
- 指定新的数据库字符集编码必须与所选择的本地环境中(LC_COLLATE和LC_CTYPE)的设置兼容。
- 当指定的字符编码集为GBK时,部分中文生僻字无法直接作为对象名。这是因为GBK第二个字节的编码范围在0x40-0x7E之间时,字节编码与ASCII字符@A-Z[]^_`a-z{|}重叠。其中@[]^_'{|}是数据库中的操作符,直接作为对象名时,会语法报错。例如“侤”字,GBK16进制编码为0x8240,第二个字节为0x40,与ASCII“@”符号编码相同,因此无法直接作为对象名使用。如果确实要使用,可以在创建和访问对象时,通过增加双引号来规避这个问题。
- 若客户端编码为A,服务器端编码为B,则需要满足数据库中存在编码格式A与B的转换。数据库能够支持的所有的编码格式转换详见系统表PG_CONVERSION(若无法转换,则建议客户端编码与服务器端编码保持一致,客户端编码可通过GUC参数client_encoding修改)。
LC_COLLATE [ = ] lc_collate
指定新数据库使用的字符集。例如,通过
lc_collate = 'zh_CN.gbk'
设定该参数。该参数的使用会影响到对字符串的排序顺序(如使用ORDER BY执行,以及在文本列上使用索引的顺序)。默认是使用模板数据库的排序顺序。
取值范围:操作系统支持的字符集。
LC_CTYPE [ = ] lc_ctype
指定新数据库使用的字符分类。例如,通过
lc_ctype = 'zh_CN.gbk'
设定该参数。该参数的使用会影响到字符的分类,如大写、小写和数字。默认是使用模板数据库的字符分类。取值范围:操作系统支持的字符分类。
对于lc_collate和lc_ctype参数的取值范围,取决于本地环境支持的字符集。
例如:在Linux操作系统上,可通过
locale -a
命令获取操作系统支持的字符集列表,在应用lc_collate和lc_ctype参数时可从中选择用户需要的字符集和字符分类。DBCOMPATIBILITY [ = ] compatibility_type
指定兼容的数据库的类型。
取值范围:A、B、C、PG、MSSQL。分别表示兼容O、MY、TD、POSTGRES和SQLServer。
默认值:A
SQLServer兼容性模式仅在Vastbase G100 V2.2 Build 10(Patch No.12)及以后补丁版本支持。
TABLESPACE [ = ] tablespace_name
指定数据库对应的表空间。
取值范围:已存在表空间名。
CONNECTION LIMIT [ = ] connlimit
数据库可以接受的并发连接数。
- 系统管理员不受此参数的限制。
- connlimit数据库主节点单独统计,Vastbase整体的连接数 = connlimit * 当前正常数据库主节点个数。
取值范围:>=-1的整数。默认值为-1,表示没有限制。
PAD_ATTRIBUTE [=] pad_attribute_type
指定数据库默认的列校对规则。
取值范围:
- N,NO PAD:把字符串尾端的空格当作一个字符处理,即字符串等值比较不忽略尾端空格。
- S,PAD SPACE:字符串等值比较忽略尾端空格。
默认值:N,NO PAD
该选项仅Vastbase G100 V2.2 Build 10(Patch No.8)及以后版本支持此功能。
该选项仅在数据库兼容模式为MySQL时能够使用(即创建DB时DBCOMPATIBILITY='B'),在其他数据库兼容模式下不能使用该特性。
其余相关内容请参考CREATE DATABASE。
有关字符编码的一些限制
- 若区域设置为C(或POSIX),则允许所有的编码类型,但是对于其他的区域设置,字符编码必须和区域设置相同。
- 若字符编码方式是SQL_ASCII,并且修改者为管理员用户时,则字符编码可以和区域设置不相同。
- 编码和区域设置必须匹配模板数据库,除了将template0当作模板。 因为其他数据库可能会包含不匹配指定编码的数据,或者可能包含排序顺序受LC_COLLATE和LC_CTYPE影响的索引。复制这些数据会导致在新数据库中的索引失效。template0是不包含任何会受到影响的数据或者索引。
示例
1、创建jim和tom用户。
CREATE USER jim PASSWORD 'Aa@12345'; CREATE USER tom PASSWORD 'Aa@12345';
2、创建一个”UTF-8”编码的数据库music。
CREATE DATABASE music ENCODING 'UTF-8' template = template0;
3、创建数据库music2,并指定所有者为jim。
CREATE DATABASE music2 OWNER jim;
4、用模板template0创建数据库music3,并指定所有者为jim。
CREATE DATABASE music3 OWNER jim TEMPLATE template0;
5、设置music数据库的连接数为10。
ALTER DATABASE music CONNECTION LIMIT= 10;
6、将music名称改为music4。
ALTER DATABASE music RENAME TO music4;
7、将数据库music2的所属者改为tom。
ALTER DATABASE music2 OWNER TO tom;
8、设置music3的表空间为PG_DEFAULT。
ALTER DATABASE music3 SET TABLESPACE PG_DEFAULT;
9、关闭在数据库music3上缺省的索引扫描。
ALTER DATABASE music3 SET enable_indexscan TO off;
10、重置enable_indexscan参数。
ALTER DATABASE music3 RESET enable_indexscan;
11、删除数据库和用户。
DROP DATABASE music2; DROP DATABASE music3; DROP DATABASE music4; DROP USER jim; DROP USER tom;
12、创建兼容TD(Teradata)格式的数据库。
CREATE DATABASE td_compatible_db DBCOMPATIBILITY 'C';
13、创建兼容A(Oracle)格式的数据库。
CREATE DATABASE ora_compatible_db DBCOMPATIBILITY 'A';
14、删除兼容TD、A格式的数据库。
DROP DATABASE td_compatible_db; DROP DATABASE ora_compatible_db;
相关链接