当前位置：首页 > backend >正文

如何在金仓数据库KingbaseES中新建一个数据库？新建一个表？给表添加一个字段？

backend 2025/5/11 0:33:06

如何在KingbaseES（金仓数据库）中新建一个数据库？新建一个表？给表添加一个字段？

摘要

KingbaseES（金仓数据库）新建数据库、创建表、添加字段全流程实战指南，涵盖 KES 数据库属性、sys_database 系统表查询、sys_database_size 磁盘空间监控；基于图形界面快速创建数据库、表及字段；SQL 语句详解：CREATE DATABASE、createdb、CREATE TABLE、ALTER TABLE ADD COLUMN；模板库（template0/template1）、编码（UTF8/GBK/GB18030）、表空间管理、权限配置、DDL 脚本生成；适用于 ksql/psql 客户端、命令行工具和可视化管理工具的数据库对象管理与数据定义语言（DDL）最佳实践。
如何在金仓数据库KingbaseES中新建一个数据库？新建一个表？给表添加一个字段？

问题
文档概述
数据库属性
创建一个KES数据库
1. 基于图形界面创建一个KES数据库
2. 通过 CREATE DATABASE 创建一个KES数据库
3. 通过 createdb 创建一个KES数据库
新建一个表
1. 基于图形界面新建一个表
2. 通过 CREATE TABLE 新建一个表
给表添加一个字段
1. 基于图形界面给表添加字段
2. 通过 ALTER TABLE 给表添加字段

1. 问题

如何在 KingbaseES（金仓数据库）中：

新建一个数据库？
在该数据库中新建一个表？
给已有表添加一个字段？

2. 概述

本文将从 KingbaseES 的基本概念与属性入手，详细介绍三种方式创建数据库，并演示如何通过图形界面与 SQL 语句完成表的创建和字段的添加。阅读完本文，您将掌握在 KingbaseES 中进行常见 DDL（数据定义语言）操作的全流程。

3. 数据库属性

在 KingbaseES 中，数据库（Database）是多个数据库对象（表、索引、序列、视图等）的命名集合。一个实例（Instance）中可以包含多个数据库。每个数据库内的对象相互隔离，但可以通过系统表如 sys_database 和 sys_schema 查看和管理。

sys_database：列出实例中所有数据库名称、所有者、编码等信息。
sys_database_size(‘dbname’)：返回指定数据库所占磁盘空间大小。
模板库：template0、template1，用于在创建新库时复制初始结构。

-- 查看已有数据库列表
SELECT datname, datdba, encoding, datcollate, datctypeFROM sys_database;-- 查看 test 库大小
SELECT sys_database_size('test');

4. 创建一个KES数据库

在 KingbaseES 中，常见的创建数据库方式有三种：

基于图形界面
通过 SQL 语句 CREATE DATABASE
通过命令行工具 createdb

4.1. 基于图形界面创建一个KES数据库

启动 KingbaseES 管理客户端，连接到目标实例。
在左侧导航树中，右键点击 “数据库” 节点，选择 “新建数据库”。
在弹出的向导中，按页填写信息：
- 基本属性页：
  - 名称：指定新数据库名，不得与现有库重复。
  - 属主：默认当前用户，可更改为其他已存在角色。
  - 编码：默认为 UTF8，可选 ASCII、GBK、GB18030。
- 权限页：为其他用户/角色分配 CONNECT、CREATE 等权限。
- DDL 页：查看最终生成的 CREATE DATABASE 语句。
点击确定完成创建。

在向导中，可随时切换到 DDL 页，复制生成的 SQL，便于后续脚本化部署。

4.2. 通过 `CREATE DATABASE` 创建一个KES数据库

使用 SQL 语句直接在客户端（如 ksql、psql）中执行：

-- 仅指定库名，默认属主为当前连接用户
CREATE DATABASE mydb;-- 指定属主和编码
CREATE DATABASE mydbWITHOWNER = dbuserENCODING = 'UTF8'TEMPLATE = template1TABLESPACE = pg_default;

注意事项

数据库名必须符合标识符规则，避免使用保留字。
普通用户只能创建属于自己的数据库；若要创建其他属主的库，需使用超级用户 system。

4.3. 通过 `createdb` 创建一个KES数据库

createdb 是 KingbaseES 提供的命令行辅助工具，本质上会登录实例并执行 CREATE DATABASE。

# 使用默认参数，以当前系统用户名创建同名数据库
$ createdb demo# 指定端口、主机、属主等
$ createdb -h 127.0.0.1 -p 54321 -U system -O dbuser -T template1 demo

-h：服务器地址
-p：端口号
-U：连接用户名
-O：新库属主
-T：指定模板库

5. 新建一个表

创建完数据库后，需要在其中定义表结构。KingbaseES 的表创建方式也有两种：图形界面与 SQL 语句。

5.1. 基于图形界面新建一个表

在管理客户端中，连接到目标数据库 mydb。
展开左侧树形结构至 “模式（Schemas）” → “public” → “表（Tables）”。
右键 “表”，选择 “新建表”。
在向导中填写：
- 表名、表空间
- 列定义：逐行添加列名、数据类型、长度、是否可空、默认值等。
- 主键/索引：在相关页签定义主键或其他索引。
查看生成的 CREATE TABLE DDL，点击确认完成。

5.2. 通过 `CREATE TABLE` 新建一个表

在 SQL 客户端中执行：

-- 示例：创建用户表
CREATE TABLE public.users (id        BIGSERIAL PRIMARY KEY,username  VARCHAR(50) NOT NULL UNIQUE,email     VARCHAR(100),created_at TIMESTAMP WITHOUT TIME ZONE DEFAULT CURRENT_TIMESTAMP
);-- 查看表结构
\d+ public.users;

BIGSERIAL：自增主键
VARCHAR(n)：变长字符
NOT NULL：非空约束
UNIQUE：唯一约束
DEFAULT：默认值

6. 给表添加一个字段

当业务需求变化时，可能需要在已有表中增加新字段。KingbaseES 支持在图形界面或通过 ALTER TABLE 完成。

6.1. 基于图形界面给表添加字段

在管理客户端中，连接到 mydb，找到目标表 public.users。
右键点击该表，选择 “修改表”。
在 “列” 页签点击 “添加”，输入新列名、类型、默认值、约束等。
确认后，客户端会执行相应的 ALTER TABLE 语句。

6.2. 通过 `ALTER TABLE` 给表添加字段

在 SQL 客户端中执行：

-- 为 users 表新增 last_login 字段
ALTER TABLE public.usersADD COLUMN last_login TIMESTAMP WITHOUT TIME ZONE;-- 带默认值且非空
ALTER TABLE public.usersADD COLUMN status VARCHAR(20) NOT NULL DEFAULT 'active';

ADD COLUMN：添加新列
可同时指定 NOT NULL、DEFAULT、CHECK 等约束

查看修改结果：

-- 再次查看表结构
\d+ public.users;

通过以上步骤，您已掌握 KingbaseES 中创建数据库、建表与扩展表结构的核心操作。建议在生产环境中，将这些 DDL 操作纳入版本控制，并在测试库演练后，再应用到线上数据库，以确保安全无误。祝您使用愉快！

7. 结论

通过本文的介绍，您已经全面掌握了在 KingbaseES（金仓数据库）中创建数据库、建表以及给表添加字段的三种主流方法：图形界面操作、SQL DDL 语句（CREATE DATABASE/CREATE TABLE/ALTER TABLE）和命令行工具（createdb）。在实际应用中，建议您：