更新时间:2026-10-21 GMT+08:00
分享

CREATE PLUGGABLE DATABASE

功能描述

创建一个新的Pluggable Database(PDB),即多租特性中租户的概念,表示一种特殊的数据库,也可以作为一个数据库实例中被划分出来的逻辑实例。

注意事项

  • 不能在事务块中执行创建PDB的DDL语句,包括CREATE、ALTER以及DROP。
  • 只能在GUC参数enable_mtd为on的状态下使用。
  • 只能在非PDB中进行该操作。
  • 不支持在M-Compatibility模式数据库中执行该命令。
  • 执行该操作的用户需要为gs_role_create_pdb的角色或拥有SYSADMIN权限。
  • 最多可以创建128个用户PDB。
  • 当未指定兼容性选项时,默认创建A兼容模式PDB。
  • 若安装数据库实例时未指定初始化账户密码,且初始化账户名字区分大小写,且新创建的PDB为M-Compatibility模式数据库的情况下,需要在开启并使用该PDB前,先在命令行执行以下语句,使数据库将双引号中的内容作为对象引用进行处理。语句执行后再开启并使用该PDB,按照提示重置其初始账户密码。(该操作主要为保证能正常为新PDB设置账户密码,后续操作可以按照实际业务需求重置sql_mode参数。)
    gs_guc set --pdbname my_pdb -Z datanode -N all -I all -c "sql_mode = 'ansi_quotes'" # my_pdb为新建的PDB名

语法格式

CREATE PLUGGABLE DATABASE pdb_name
    [ [ WITH ] { [ ENCODING [=] 'encoding' ] |
               [ LC_COLLATE [=] 'lc_collate' ] |
               [ LC_CTYPE [=] 'lc_ctype' ] |
               [ DBCOMPATIBILITY [=] 'compatibility_type' ] |
               [ DBTIMEZONE [=] 'time_zone' ] }];

参数说明

  • pdb_name

    PDB名称。

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

    PDB名称中不能含有美元($)符号。

  • ENCODING [ = ] 'encoding'

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

    常用取值:GBK、UTF8、Latin1以及GB18030等。

    • 不指定时,对于M-Compatibility模式数据库,默认使用UTF8编码;其他默认使用模板数据库的编码。
    • 模板数据库template0、template1和templatea的编码默认与操作系统环境相关。template1不允许修改字符编码,因此若要变更编码,A兼容模式数据库请使用templatea创建数据库,非A兼容模式数据库请使用template0或templatem创建数据库。
  • LC_COLLATE [ = ] 'lc_collate'

    可选。指定新数据库使用的字符集。该参数的使用会影响到对字符串的排序顺序,默认使用模板数据库的字符集。该参数对M-Compatibility模式数据库不生效。

    取值范围:操作系统支持的字符集。

  • LC_CTYPE [ = ] 'lc_ctype'

    可选。指定新数据库使用的字符分类。该参数的使用会影响到字符的分类(如大写、小写和数字),默认使用模板数据库的字符分类。该参数对M-Compatibility模式数据库不生效。

    取值范围:操作系统支持的字符分类。

  • DBCOMPATIBILITY [ = ] compatibility_type

    可选。指定兼容的数据库的类型,默认兼容Oracle。

    取值范围:A、C、PG、M。分别表示兼容Oracle、Teradata、PostgreSQL和M-Compatibility。

  • DBTIMEZONE [ = ] time_zone

    指定新数据库的时区。该参数会影响新数据库的时区,默认设置为PRC时区。

    取值范围:

    • 操作系统支持的时区名称和缩写。
    • -15:59 ~ +15:00时间戳范围。

    该参数仅在A兼容模式数据库下,且设置参数设置为a_format_version='10c'和a_format_dev_version='s2'时生效。

示例

  • 前置条件。

    完成多租数据库实例的安装。

  • 创建PDB。
    --使用系统管理员连接postgres数据库,开启待决区(pending area),进入资源计划编辑状态。
    gaussdb=# CALL resource_manager.create_pending_area();
     create_pending_area 
    ---------------------
    
    (1 row)
    --由于该接口是创建资源,是否成功与当前实例资源规格有关。如遇到接口报错,请根据错误描述进行参数调整后重新尝试。
    gaussdb=# CALL resource_manager.create_resource_plan_directive(pdb_name =>'my_pdb', min_cpu => 4, max_dynamic_memory => '18022MB', max_shared_memory => '14745MB', io_limits=> 300, io_priority => 'High', max_connections => 880);
     create_resource_plan_directive 
    --------------------------------
    
    (1 row)
    gaussdb=# CALL resource_manager.submit_pending_area();
     submit_pending_area 
    ---------------------
    
    (1 row)
    
    --使用系统管理员连接postgres数据库,创建PDB。
    gaussdb=# CREATE PLUGGABLE DATABASE my_pdb;
    CREATE PLUGGABLE DATABASE
  • 删除PDB。
    --如果PDB状态是open时,无法进行删除,需要先关闭该PDB。
    gaussdb=# ALTER PLUGGABLE DATABASE my_pdb CLOSE IMMEDIATE;
    ALTER PLUGGABLE DATABASE
    
    --使用系统管理员连接postgres数据库,删除已经关闭的PDB。
    gaussdb=# DROP PLUGGABLE DATABASE my_pdb INCLUDING DATAFILES;
    DROP PLUGGABLE DATABASE

相关链接

CREATE DATABASE

相关文档