在国产信创快速发展的背景下，本文目标是对于刚开始接触人大金仓数据库的朋友提供上手指南，这样在拿到一台运行人大金仓数据库的服务器时，不至于无从下手。

查看Kingbase服务是否正在运行

sudo ss -tuln | grep 54321

人大金仓数据库默认使用的端口号是54321，可以使用 netstat 或 ss 命令来查看该端口是否正在被监听，这表明服务正在运行。

命令响应示例：

$sudo ss -tuln | grep 54321
tcp    LISTEN  0       688            0.0.0.0:54321        0.0.0.0:*            
tcp    LISTEN  0       688               [::]:54321           [::]:*

可以看到54321端口有两个监听条目：

• 第一个条目表示服务正在监听所有 IPv4 地址 (0.0.0.0) 上的 54321 端口。
• 第二个条目表示服务同时也在监听所有 IPv6 地址 ([::]) 上的 54321 端口。

连接数据库

ksql -U 用户名 -d 数据库名 -h 主机名 -p 端口号

如果提示-bash: ./ksql: No such file or directory，说明没有正确配置环境变量。

这时我们可以使用find命令找出ksql的安装路径：

sudo find / -name ksql 2>/dev/null

根据找到的结果，使用完整路径来启动链接，例：

/opt/kingbase/Server/bin/ksql -U 用户名 -d 数据库名 -h 主机名 -p 端口号

查看数据库版本

连接数据库后，可使用以下命令查看版本号：

select version();

// 授权有效期
select GET_LICENSE_VALIDDAYS();

查看数据库相关配置

// 查看数据库模式
show database_mode;

// 查看所有配置参数，按空格翻页
SHOW all; 

show max_connections; -- 查看最大连接数
SHOW lc_collate;  -- 查看字符集排序规则
SHOW lc_ctype;    -- 查看字符集分类规则
SHOW datestyle;   -- 查看日期格式
SHOW timezone;    -- 查看时区设置

查看数据表

查看数据库列表：

\l

// 或使用查询语句
select datname from sys_database;

查看当前数据库中的表、视图等：

// 查看所有表，视图等
\d
// 查看所有表（常用）
\dt
// 查看所有视图
\dv
// 查看所有索引
\di
// 查看所有序列
\ds
// 查看所有函数
\df

// 查看当前使用的数据库
SELECT current_database();
// 切换数据库，用户名可选
\c 数据库名 [用户名]

数据表操作SQL语句

以database_mode为MySQL为例，和通用的SQL基本相同。

创建数据库

CREATE DATABASE mydatabase
WITH OWNER = dbuser
ENCODING = 'UTF8';

建表

CREATE TABLE users (
    id SERIAL PRIMARY KEY,
    name VARCHAR(100) NOT NULL,
    age INT
);

操作数据

-- 插入数据
INSERT INTO users (name, age)
VALUES ('张三', 25);

-- 查询
SELECT * FROM users;

-- 更新数据
UPDATE users
SET age = '26'
WHERE name = '张三';

-- 删除
DELETE FROM users WHERE name = '张三';