数据库
创建数据库
CREATE DATABASE 语句用于创建关系数据库对象（Relational Database）。每条语句支持创建一个关系数据库。
所需权限
用户具有 Admin 角色。默认情况下，root 用户具有 Admin 角色。创建成功后，用户拥有该数据库的全部权限。
语法格式
参数说明
| 参数 | 说明 |
|---|---|
IF NOT EXISTS | 可选关键字。当使用 IF NOT EXISTS 关键字时，如果目标数据库不存在，系统创建目标数据库。如果目标数据库存在，系统创建数据库失败，但不会报错。当未使用 IF NOT EXISTS 关键字时，如果目标数据库不存在，系统创建目标数据库。如果目标数据库存在，系统报错，提示目标数据库已存在。 |
db_name | 待创建的数据库的名称。该名称必须唯一，且遵循数据库标识符规则。 |
WITH | 可选关键字，是否使用该关键字不影响数据库的创建。 |
ENCODING | 可选关键字，指定编码方式。目前，KWDB 只支持 UTF-8 编码以及 UTF-8 的别名（UTF8 和 UNICODE）。编码值应该用单引号（''）括起来，并且不区分大小写。例如：CREATE DATABASE bank ENCODING = 'UTF-8'。 |
语法示例
创建关系数据库。
以下示例创建一个名为
db1的关系数据库。CREATE DATABASE db1; CREATE DATABASE使用
IF NOT EXISITS关键字创建关系数据库。以下示例使用
IF NOT EXISITS关键字创建一个已经存在的db1关系数据库。系统创建数据库失败，但不报错。CREATE DATABASE IF NOT EXISTS db1; CREATE DATABASE
查看数据库
SHOW DATABASES 语句用于查看 KWDB 中的所有数据库。
所需权限
无
语法格式
参数说明
| 参数 | 说明 |
|---|---|
WITH COMMENT | 可选关键字，查看数据库的注释信息。默认情况下，数据库的注释信息为 NULL。 |
语法示例
说明
时序数据库和关系数据库的 engine_type 分别为 TIME SERIES 和 RELATIONAL。
查看数据库。
以下示例查看已创建的数据库。
SHOW DATABASES;执行成功后，控制台输出以下信息：
database_name | engine_type ----------------+-------------- db1 | RELATIONAL db2 | RELATIONAL defaultdb | RELATIONAL postgres | RELATIONAL system | RELATIONAL iot | TIME SERIES (6 rows)查看数据库的注释信息。
以下示例查看数据库的注释信息。
SHOW DATABASES WITH COMMENT;执行成功后，控制台输出以下信息：
database_name | engine_type | comment ----------------+-------------+---------- db1 | RELATIONAL | NULL db2 | RELATIONAL | NULL defaultdb | RELATIONAL | NULL postgres | RELATIONAL | NULL system | RELATIONAL | NULL iot | TIME SERIES | NULL (6 rows)
查看数据库的建库语句
SHOW CREATE DATABASE 语句用于查看创建数据库的 SQL 语句。目前，关系数据库只支持查看创建数据库时使用的数据库名称。
所需权限
无
语法格式
参数说明
| 参数 | 说明 |
|---|---|
database_name | 待查看数据库的名称。 |
语法示例
以下示例查看 reldb1 数据库的建库语句。
-- 1. 创建数据库 reldb1。
CREATE DATABASE reldb1 WITH ENCODING = 'UTF8';
--2. 查看已创建的 reldb1 数据库。
SHOW CREATE DATABASE reldb1;
database_name | create_statement
----------------+-------------------------
reldb1 | CREATE DATABASE reldb1
(1 row)
修改数据库
ALTER DATABASE 语句用于修改数据库名称。
说明
KWDB 不支持修改视图关联的数据库的名称。
所需权限
用户为 Admin 用户或者 Admin 角色成员。默认情况下，root 用户具有 Admin 角色。
语法格式
参数说明
| 参数 | 说明 |
|---|---|
database_name | 数据库的名称。在修改数据库名称的语法中，第一个 database_name 指当前数据库的名称。第二个 database_name 指拟修改的的数据库名称。新数据库名称必须唯一，并且遵循数据库标识符规则。如果目标数据库为当前数据库，或者将 sql_safe_updates 参数设置为 true，则无法重命名该数据库。 |
语法示例
修改数据库的名称。
以下示例将
rdb数据库重命名为relationaldb。-- 1. 查看所有数据库。 SHOW DATABASES; database_name|engine_type -------------+----------- defaultdb |RELATIONAL postgres |RELATIONAL rdb |RELATIONAL system |RELATIONAL tsdb |TIME SERIES (5 rows) -- 2. 重命名数据库。 ALTER DATABASE rdb RENAME TO relationaldb; ALTER DATABASE -- 3. 查看所有数据库。 SHOW DATABASES; database_name|engine_type -------------+----------- defaultdb |RELATIONAL postgres |RELATIONAL relationaldb |RELATIONAL system |RELATIONAL tsdb |TIME SERIES (5 rows)
删除数据库
DROP DATABASE 语句用于从 KWDB 中删除数据库及其所有对象。目标数据库不能是当前数据库。如需删除当前数据库，使用 USE <database_name> 语句将当前数据库切换成其他数据库，再进行删除。
所需权限
用户拥有目标数据库和其下全部模式及对象的 DROP 权限。删除成功后，所有用户针对目标数据库和其下全部模式及对象的所有权限均被删除。
语法格式
参数说明
| 参数 | 说明 |
|---|---|
IF EXISTS | 可选关键字。当使用 IF EXISTS 关键字时，如果目标数据库存在，系统删除目标数据库。如果目标数据库不存在，系统删除数据库失败，但不会报错。当未使用 IF EXISTS 关键字时，如果目标数据库存在，系统删除目标数据库。如果目标数据库不存在，系统报错，提示目标数据库不存在。 |
database_name | 待删除的数据库的名称。 |
CASCADE | 可选关键字，表示级联删除，即删除数据库中的所有表、视图及其关联对象（例如约束和视图）。CASCADE 不会列出待删除的关联对象，应谨慎使用。 |
RESTRICT | 可选关键字，如果目标数据库包含表和视图，系统报错，提示目标数据库为非空数据库。 |
语法示例
使用
CASCADE关键字删除数据库及其对象。以下示例使用
CASCADE关键字删除relationaldb数据库及其级联对象。-- 1. 查看 relationaldb 数据库中的关系表。 SHOW TABLES FROM relationaldb; table_name|table_type ----------+---------- ints |BASE TABLE (1 row) -- 2. 删除 relationaldb 数据库及其级联对象。 DROP DATABASE relationaldb CASCADE; DROP DATABASE -- 3. 查看 relationaldb 数据库中的关系表。 SHOW TABLES FROM relationaldb; ERROR: target database or schema does not exist使用
RESTRICT关键字阻止删除非空数据库。以下示例使用
RESTRICT关键字阻止删除db1非空数据库。-- 1. 查看 db1 数据库中的关系表。 SHOW TABLES FROM db1; table_name|table_type ----------+---------- int |BASE TABLE ints |BASE TABLE (2 rows) -- 2. 删除 db1 数据库。 DROP DATABASE db1 RESTRICT; ERROR: database "db1" is not empty and RESTRICT was specified