KingbaseES Docker速查表

在 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
相关推荐
无足鸟ICT8 小时前
【RHCA+】sosreport(收集诊断文档)
linux·运维·服务器
IT大白鼠9 小时前
当 AI 开始自动化渗透:FBI ARTEX 警报的防守对策
运维·人工智能·自动化
Decay__9 小时前
SQLServer 运维自动化平台 —— PowerShell + SQL Agent 作业:部署、监控、巡检、告警、工单闭环一体化
运维·数据库·sql·mysql·架构
A-刘晨阳10 小时前
K8S 二进制集群搭建(一主两从)v1.37.2 版本
运维·云原生·容器·kubernetes·calico·nerdctl
tonydf10 小时前
没完了,Nginx又报新漏洞!
运维·nginx
瑞雪兆丰年兮11 小时前
Linux零基础快速入门-第二章 Linux基础命令
linux·运维·服务器
lambo mercy11 小时前
01初识docker
运维·docker·容器
时间的拾荒人12 小时前
Docker 容器、仓库与数据管理实战
docker·容器·eureka
时间的拾荒人14 小时前
Docker 入门实战:从核心概念、安装配置到镜像操作与 Dockerfile 定制
运维·docker·容器·eureka
光电笑映14 小时前
TCP 为什么可靠?从三次握手、滑动窗口到拥塞控制全面拆解(上)
运维·服务器·网络·udp