在 KingbaseES（人大金仓）的 Docker 容器内，管理和操作数据库主要通过 ksql 命令行客户端和 sys_ctl 控制工具来完成。

下面是核心操作的快速参考：

操作	命令	说明
进入容器	docker exec -it <容器名或ID> /bin/bash	进入容器内部。
连接数据库	ksql -U <用户名> -d <数据库名> -p 54321	-U指定用户，-d指定数据库。默认用户是system，默认数据库是test。
免密连接	ksql	仅输入命令，然后按提示输入密码即可。
执行SQL文件	\i /path/to/your/file.sql	在ksql交互界面中，执行指定路径的SQL文件。
查看数据库状态	sys_ctl -D /home/kingbase/userdata/data/ status	检查Kingbase数据库进程是否正常运行。
重新加载配置	sys_ctl reload -D /home/kingbase/userdata/data/	修改kingbase.conf等配置文件后，使其生效。
退出ksql	\q	退出ksql命令行界面，返回容器的shell。

---

📌 核心命令详解

1. 进入容器

首先，你需要进入Kingbase容器的bash环境，才能执行后续的所有命令。

# 请将 <容器名或ID> 替换为你实际的容器名（如 kingbase）或容器ID（如 bb0a406b3e7a）
docker exec -it <容器名或ID> /bin/bash

# 成功进入后，命令行提示符通常会变成类似 [root@xxx /]# 的形式

2. 连接数据库：ksql

ksql 是KingbaseES自带的命令行客户端，功能类似PostgreSQL的psql。进入容器后，使用ksql命令连接数据库。

指定参数连接（推荐）

此方式最为明确。连接成功后，提示符会变为 <数据库名>=#。

# 语法：ksql -U 用户名 -d 数据库名 -p 端口号
ksql -U system -d test -p 54321

免密快速连接

如果你的环境已经配置好（通常是默认的system用户），直接输入ksql命令并回车，它会自动尝试以当前Linux用户（通常是kingbase）免密登录test数据库。

ksql

3. 执行SQL文件：\i

当你需要执行一个已写好的.sql脚本文件时，可以先连接数据库，再使用\i命令。

-- 1. 先连接到目标数据库
ksql -U system -d test -p 54321

-- 2. 在ksql提示符下，执行脚本文件
\i /home/kingbase/userdata/defence_cloud-kb.sql

4. 查看和管理数据库

在容器内，你可以使用sys_ctl工具来管理数据库进程。

查看数据库状态

# 切换到 kingbase 用户（如果需要），然后执行状态查看命令
su - kingbase
sys_ctl -D /home/kingbase/userdata/data/ status

输出示例：

sys_ctl: server is running (PID: 76)

这表示数据库正在运行。

重新加载配置

当修改了数据库的配置文件（如 kingbase.conf）后，需要让配置生效，但又不想重启整个服务，可以使用reload命令。

# 执行重新加载命令
/home/kingbase/install/kingbase/bin/sys_ctl reload -D /home/kingbase/userdata/data/

💡 常见问题与路径速查

• 数据库默认目录: /home/kingbase/userdata/data/
• 默认账户/密码: system / 123456 （或 12345678ab）
• ksql连接不上: 确认容器已用-p 54321:54321映射端口，并且数据库服务已启动
• 提示权限不足: 如果遇到权限错误，可以尝试切换到kingbase用户再执行命令：su - kingbase