# CREATE DATABASE
#### 功能描述
创建模式。DATABASE与SCHEMA同义。
访问命名对象时可以使用模式名作为前缀进行访问，如果无模式名前缀，则访问当前模式下的命名对象。创建命名对象时也可用模式名作为前缀修饰。
#### 注意事项
- 只要用户对当前数据库有CREATE权限，就可以创建模式。
- 系统管理员在普通用户同名Schema下创建的对象，所有者为Schema的同名用户（非系统管理员）。
 
#### 语法格式
```
CREATE {DATABASE | SCHEMA} [IF NOT EXISTS] database_name [AUTHORIZATION role_id]
    [[create_option] [,...]]
create_option: [DEFAULT] {
    CHARACTER SET [=] default_charset
  | CHAR SET [=] default_charset
  | CHARSET [=] default_charset
  | COLLATE [=] default_collation
}
```
#### 参数说明
- **database_name**
  模式名称。
  ![](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/public_sys-resources/notice_3.0-zh-cn.png)
  - 模式名不能和当前数据库里其他的模式重名。
  
  - 模式名不能和当前数据库的初始用户重名。
  
  - 模式的名称不可以"pg_"开头。
  
  - 模式的名称不可以"gs_role_"开头。
   
  取值范围：字符串，要符合[标识符说明](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0040.html#ZH-CN_TOPIC_0000002558805265)。
  ![](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/public_sys-resources/note_3.0-zh-cn.png)
  如果当前搜索路径上的模式中存在同名对象时，需要明确指定引用对象所在的模式。可以通过命令SHOW SEARCH_PATH来查看当前搜索路径上的模式。
  
- **AUTHORIZATION role_id**
  可选。指定创建相应数据库的所有者。缺省时，新数据库的所有者是当前用户。
  取值范围：已存在的用户名。
  
- **COL** **LATE \[=\] collation_name**
  可选。指定新数据库使用的字符集。例如，通过collate = 'zh_CN.gbk'设定该参数。
  该参数的使用会影响到对字符串的排序顺序（如使用ORDER BY执行，以及在文本列上使用索引的顺序）。默认是使用模板数据库的字符集。
  取值范围：参考[库级字符集和字符序](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0034.html#ZH-CN_TOPIC_0000002558925177)。
  
- **{CHAR SET \| CHARSET \| CHARACTER SET} \[=\] charset_name**
  可选。指定新数据库使用的字符分类。例如，通过CHARSET = 'zh_CN.gbk'设定该参数。该参数的使用会影响到字符的分类，如大写、小写和数字。默认是使用模板数据库的字符分类。
  取值范围：参考[库级字符集和字符序](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0034.html#ZH-CN_TOPIC_0000002558925177)。
  
 
#### 示例
```
--创建并切换至测试数据库。
m_db=# CREATE DATABASE test1;
m_db=# USE test1;
--创建表a。
m_db=# CREATE TABLE a(id int);
m_db=# DROP TABLE a;
--删除DATABASE test1。
m_db=# USE public;
m_db=# DROP DATABASE test1;
```
#### 相关链接
[ALTER DATABASE](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0048.html#ZH-CN_TOPIC_0000002558925185)，[DROP DATABASE](https://support.huaweicloud.com/distributed-m-comp-devg-v8-gaussdb/gaussdb-81-0086.html#ZH-CN_TOPIC_0000002558925209)
#### 优化建议
- **create database**
  事务中不支持创建database。
  

- **ENCODING** **LC_COLLATE** **LC_CTYPE**
  当新建数据库Encoding与模板数据库（SQL_ASCII）不匹配（为'GBK' /'UTF8'/'LATIN1'/'GB18030'/'GB18030_2022/ZHS16GBK'）时，必须指定template \[=\] template。