👋 欢迎来到吴老二技术博客,专注运维 / 数据库 / 云原生
首页/数据库/正文

人大金仓 KingbaseES 数据库库增删改查

吴
吴老二
2026-11-18数据库4 次浏览0 条评论

在金仓数据库 KingbaseES 的逻辑结构中,数据库(Database)是介于实例与模式(Schema)之间的核心隔离单元。一个数据库实例可以包含多个彼此独立的数据库,每个数据库拥有独立的系统目录、权限体系和字符集配置,跨库访问需要通过 dblink 或 fdw 等扩展实现,不能像模式(Schema)那样直接通过 search_path 切换。以下围绕数据库本身的增删改查操作展开,所有示例均基于 ksql 命令行工具的实际执行过程。

创建数据库(CREATE DATABASE)

创建数据库的本质是克隆一个模板库。默认情况下,KingbaseES 会克隆 template1,该模板中若曾安装过扩展或创建过公共对象,新库会一并继承。若需一个完全干净的环境,应显式指定 TEMPLATE template0 。

基础创建

以超级用户 system 连接到维护库 kingbase,执行建库语句:

test=# CREATE DATABASE app_prod;
CREATE DATABASE

此时用 \l 查看数据库列表,可以看到 app_prod 已出现,拥有者为当前连接用户 system,编码继承自模板库(通常为 UTF8)。

指定属主与编码

生产环境中通常需要明确属主和字符集:

test=# CREATE ROLE app_user LOGIN PASSWORD 'App@2026#init';
CREATE ROLE
test=# CREATE DATABASE app_order
test-#     WITH OWNER = app_user
test-#          ENCODING = 'UTF8'
test-#          TEMPLATE = template0
test-#          CONNECTION LIMIT = 200;
CREATE DATABASE

这里 CONNECTION LIMIT 200 限制了该库的最大并发连接数,-1 表示无限制(默认值)。指定 template0 是为了避免 template1 中可能存在的自定义对象污染新库。

创建时的常见报错

若当前用户不具备 CREATEDB 权限,执行会返回:

ERROR:  permission denied to create database

若数据库名已存在且未加 IF NOT EXISTS:

ERROR:  database "app_prod" already exists

加上 IF NOT EXISTS 后,已存在时不会报错,仅返回提示:

NOTICE:  database "app_prod" already exists, skipping
CREATE DATABASE

修改数据库(ALTER DATABASE)

ALTER DATABASE 覆盖的操作包括重命名、变更属主、修改默认表空间、调整会话级参数默认值等。执行者必须是数据库属主或超级用户。

重命名数据库

test=# \l
                                      List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    | Iculocale | Access privileges
-----------+----------+----------+-------------+-------------+-----------+-------------------
 app_order | app_user | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 app_prod  | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 kingbase  | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 security  | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 template0 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
           |          |          |             |             |           | system=CTc/system
 template1 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
           |          |          |             |             |           | system=CTc/system
 test      | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
(7 rows)

test=# ALTER DATABASE app_prod RENAME TO app_prod_v2;
ALTER DATABASE
test=# \l
                                       List of databases
    Name     |  Owner   | Encoding |   Collate   |    Ctype    | Iculocale | Access privileges
-------------+----------+----------+-------------+-------------+-----------+-------------------
 app_order   | app_user | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 app_prod_v2 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 kingbase    | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 security    | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 template0   | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
             |          |          |             |             |           | system=CTc/system
 template1   | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
             |          |          |             |             |           | system=CTc/system
 test        | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
(7 rows)

注意:不能在当前连接的数据库中重命名自身。若当前正连接着 app_prod 执行上述语句,会报错:

ERROR:  current database cannot be renamed

需先 \c kingbase 切换到其他库再执行。

变更属主

将 app_order 的属主从 app_user 转给 ops_user:

test=# \c kingbase
You are now connected to database "kingbase" as userName "system".
kingbase=# CREATE ROLE ops_user LOGIN PASSWORD 'App@2026#init';
CREATE ROLE
kingbase=# alter database app_order owner to ops_user;
ALTER DATABASE
kingbase=#

执行者必须是新属主的直接或间接成员,且具备 CREATEDB 权限(超级用户自动满足)。

修改会话参数默认值

这是 ALTER DATABASE 在日常运维中较高频的用法。例如,为 app_order 库的所有新会话默认关闭索引扫描(仅作演示,生产慎用):

kingbase=# ALTER DATABASE app_order SET enable_indexscan TO off;
ALTER DATABASE
kingbase=#

此后任何新连接到 app_order 的会话,enable_indexscan 初始值均为 off。若需恢复系统默认:

kingbase=# ALTER DATABASE app_order RESET enable_indexscan;
ALTER DATABASE

该设置仅影响新会话,对已存在的连接不生效。

删除数据库(DROP DATABASE)

删除数据库会移除其系统目录项并删除数据文件目录,不可逆。执行者必须是数据库属主,且不能存在任何到目标库的活动连接。

正常删除流程

先确认当前不在目标库中:

kingbase=# \c kingbase
You are now connected to database "kingbase" as userName "system".
kingbase=# \l
                                       List of databases
    Name     |  Owner   | Encoding |   Collate   |    Ctype    | Iculocale | Access privileges
-------------+----------+----------+-------------+-------------+-----------+-------------------
 app_order   | ops_user | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 app_prod_v2 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 kingbase    | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 security    | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 template0   | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
             |          |          |             |             |           | system=CTc/system
 template1   | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
             |          |          |             |             |           | system=CTc/system
 test        | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
(7 rows)

kingbase=# DROP DATABASE app_prod_v2;
DROP DATABASE
kingbase=# \l
                                      List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    | Iculocale | Access privileges
-----------+----------+----------+-------------+-------------+-----------+-------------------
 app_order | ops_user | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 kingbase  | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 security  | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 template0 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
           |          |          |             |             |           | system=CTc/system
 template1 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
           |          |          |             |             |           | system=CTc/system
 test      | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
(6 rows)

带 IF EXISTS 的安全删除

kingbase=# DROP DATABASE IF EXISTS app_temp;
NOTICE:  数据库 "app_temp" 不存在,跳过
DROP DATABASE

若 app_temp 不存在,返回:

NOTICE:  database "app_temp" does not exist, skipping
DROP DATABASE

常见报错:存在活动连接

若有人正连接着目标库,直接删除会失败:

kingbase=# \c app_order
You are now connected to database "app_order" as userName "system".
app_order=# DROP DATABASE app_order;
ERROR:  无法删除当前使用的数据库
app_order=#

此时需先终止目标库上的会话(通过 sys_terminate_backend 或通知相关人员断开),再重试删除。也可使用 dropdb 命令行工具,它在底层包装了相同逻辑,但操作上更便捷。

查询数据库信息

查询操作不修改数据,但属于日常管理中使用频率最高的部分。KingbaseES 提供了 ksql 元命令和系统表查询两种方式。

使用 \l 查看数据库列表

kingbase=# \l
                                      List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    | Iculocale | Access privileges
-----------+----------+----------+-------------+-------------+-----------+-------------------
 app_order | ops_user | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 kingbase  | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 security  | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
 template0 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
           |          |          |             |             |           | system=CTc/system
 template1 | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           | =c/system        +
           |          |          |             |             |           | system=CTc/system
 test      | system   | UTF8     | zh_CN.UTF-8 | zh_CN.UTF-8 |           |
(6 rows)

该输出直观展示各库的属主、编码和排序规则,便于快速核对配置是否一致。

查询 sys_database 系统表

sys_database 是存储数据库元信息的核心系统表。查询关键字段:

app_order=# SELECT oid, datname, datistemplate, datallowconn, datconnlimit
app_order-# FROM sys_database
app_order-# WHERE datname NOT LIKE 'template%'
app_order-# ORDER BY datname;
  oid  |  datname  | datistemplate | datallowconn | datconnlimit
-------+-----------+---------------+--------------+--------------
 16386 | app_order | f             | t            |          200
 14815 | kingbase  | f             | t            |           -1
 14816 | security  | f             | t            |           -1
 14814 | test      | f             | t            |           -1
(4 rows)

字段含义:

  • datistemplate = t 表示该库可作为建库模板(template0、template1 为 true);
  • datallowconn = f 表示禁止新连接(template0 通常为 false,防止误修改);
  • datconnlimit 为 -1 表示不限制并发连接数。

查看当前连接的数据库

app_order=# SELECT current_database();
 current_database
------------------
 app_order
(1 row)

app_order=#

该函数在编写脚本时用于确认当前会话所在的库,避免误在目标库上执行 DDL。

实际运维中的几个注意点

第一,建库不要用 template1 做“干净库”的模板。 如果曾有人在 template1 中安装过 kdb_zhparser 之类的扩展,之后所有基于 template1 创建的库都会自带该扩展。对合规性要求高的场景,统一使用 TEMPLATE template0 并显式指定 ENCODING 和 LC_COLLATE,可以避免环境漂移。

第二,删库前先查连接。 仅靠 DROP DATABASE 的报错来发现问题是被动的。执行前可以先跑:

app_order=# SELECT pid, usename, application_name, client_addr
app_order-# FROM sys_stat_activity
app_order-# WHERE datname = 'app_order';
 pid  | usename | application_name | client_addr
------+---------+------------------+-------------
 2858 | system  | ksql             |
(1 row)

app_order=#

确认没有业务连接后再执行删除,减少误伤。

第三,ALTER DATABASE ... SET 的参数是会话级默认值,不是库级强制约束。 用户仍可在会话中通过 SET 覆盖它。若需要强制某项行为,应通过角色级参数或应用层连接初始化脚本来实现。

评论 0

评论需 登录 后发表(注册并验证邮箱)。
还没有评论,来抢沙发~