CREATE DATABASE

    注意事项

    • 只有拥有CREATEDB权限的用户才可以创建新数据库,系统管理员默认拥有此权限。
    • 不能在事务块中执行创建数据库语句。
    • 在创建数据库过程中,若出现类似“could not initialize database directory”的错误提示,可能是由于文件系统上数据目录的权限不足或磁盘满等原因引起。

    参数说明

    • database_name

      数据库名称。

      取值范围:字符串,要符合标识符的命名规范。

    • OWNER [ = ] user_name

      数据库所有者。缺省时,新数据库的所有者是当前用户。

      取值范围:已存在的用户名。

    • TEMPLATE [ = ] template

      模板名。即从哪个模板创建新数据库。openGauss采用从模板数据库复制的方式来创建新的数据库。初始时,openGauss包含两个模板数据库template0、template1,以及一个默认的用户数据库postgres。

      取值范围:仅template0。

    • ENCODING [ = ] encoding

      指定数据库使用的字符编码,可以是字符串(如’SQL_ASCII’)、整数编号。

      常用取值:GBK、UTF8、Latin1。

    • LC_COLLATE [ = ] lc_collate

      指定新数据库使用的字符集。例如,通过lc_collate = ‘zh_CN.gbk’设定该参数。

      该参数的使用会影响到对字符串的排序顺序(如使用ORDER BY执行,以及在文本列上使用索引的顺序)。默认是使用模板数据库的排序顺序。

      取值范围:有效的排序类型。

    • LC_CTYPE [ = ] lc_ctype

      指定新数据库使用的字符分类。例如,通过lc_ctype = ‘zh_CN.gbk’设定该参数。该参数的使用会影响到字符的分类,如大写、小写和数字。默认是使用模板数据库的字符分类。

      取值范围:有效的字符分类。

    • DBCOMPATIBILITY [ = ] compatibilty_type

      指定兼容的数据库的类型。

    • TABLESPACE [ = ] tablespace_name

      指定数据库对应的表空间。

      取值范围:已存在表空间名。

    • CONNECTION LIMIT [ = ] connlimit

      数据库可以接受的并发连接数。

      须知:
      - 系统管理员不受此参数的限制。
      - connlimit数据库主节点单独统计,openGauss整体的连接数 = connlimit * 当前正常数据库主节点个数。

      取值范围:>=-1的整数。默认值为-1,表示没有限制。

    有关字符编码的一些限制:

    • 若区域设置为C(或POSIX),则允许所有的编码类型,但是对于其他的区域设置,字符编码必须和区域设置相同。
    • 编码和区域设置必须匹配模板数据库,除了将template0当作模板。 因为其他数据库可能会包含不匹配指定编码的数据,或者可能包含排序顺序受LC_COLLATE和LC_CTYPE影响的索引。复制这些数据会导致在新数据库中的索引失效。template0是不包含任何会受到影响的数据或者索引。
    1. postgres=# CREATE USER jim PASSWORD 'Bigdata@123';
    2. --创建一个GBK编码的数据库music(本地环境的编码格式必须也为GBK)。
    3. postgres=# CREATE DATABASE music ENCODING 'GBK' template = template0;
    4. --创建数据库music2,并指定所有者为jim
    5. postgres=# CREATE DATABASE music2 OWNER jim;
    6. --用模板template0创建数据库music3,并指定所有者为jim
    7. postgres=# CREATE DATABASE music3 OWNER jim TEMPLATE template0;
    8. --设置music数据库的连接数为10
    9. postgres=# ALTER DATABASE music CONNECTION LIMIT= 10;
    10. postgres=# ALTER DATABASE music RENAME TO music4;
    11. --将数据库music2的所属者改为tom
    12. postgres=# ALTER DATABASE music2 OWNER TO tom;
    13. --设置music3的表空间为PG_DEFAULT
    14. postgres=# ALTER DATABASE music3 SET TABLESPACE PG_DEFAULT;
    15. --关闭在数据库music3上缺省的索引扫描。
    16. --重置enable_indexscan参数。
    17. postgres=# ALTER DATABASE music3 RESET enable_indexscan;
    18. --删除数据库。
    19. postgres=# DROP DATABASE music3;
    20. postgres=# DROP DATABASE music4;
    21. --删除jimtom用户。
    22. postgres=# DROP USER jim;
    23. postgres=# DROP USER tom;
    24. --创建兼容TD格式的数据库。
    25. postgres=# CREATE DATABASE td_compatible_db DBCOMPATIBILITY 'C';
    26. --创建兼容ORA格式的数据库。
    27. postgres=# CREATE DATABASE ora_compatible_db DBCOMPATIBILITY 'A';
    28. --删除兼容TDORA格式的数据库。
    29. postgres=# DROP DATABASE td_compatible_db;

    相关链接

    DROP DATABASE

    • create database

      事务中不支持创建database。