
人大金仓 KingbaseES 数据库表增删改查
在人大金仓(KingbaseES)数据库日常运维过程中,表的增删改查是最基础也是最常用的操作。 与 MySQL 不同,人大金仓采用 Schema(模式)组织数据库对象。同一个数据库
在金仓数据库 KingbaseES 的逻辑结构中,数据库(Database)是介于实例与模式(Schema)之间的核心隔离单元。一个数据库实例可以包含多个彼此独立的数据库,每个数据库拥有独立的系统目录、权限体系和字符集配置,跨库访问需要通过 dblink 或 fdw 等扩展实现,不能像模式(Schema)那样直接通过 search_path 切换。以下围绕数据库本身的增删改查操作展开,所有示例均基于 ksql 命令行工具的实际执行过程。
创建数据库的本质是克隆一个模板库。默认情况下,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 覆盖的操作包括重命名、变更属主、修改默认表空间、调整会话级参数默认值等。执行者必须是数据库属主或超级用户。
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
该设置仅影响新会话,对已存在的连接不生效。
删除数据库会移除其系统目录项并删除数据文件目录,不可逆。执行者必须是数据库属主,且不能存在任何到目标库的活动连接。
先确认当前不在目标库中:
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)
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 元命令和系统表查询两种方式。
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 是存储数据库元信息的核心系统表。查询关键字段:
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