2.1.2-2、V8R3迁移到V8R6-迁移介绍

一、迁移工具介绍

1、数据迁移工具

​ 金仓支持应用系统离线迁移、在线迁移。

• 离线迁移（业务停机）一般使用 KDTS 完成全量迁移（所有对象定义和数据的迁移）；
• 在线迁移（业务不停机）使用 KFS，实现全量数据搬迁、增量数据同步，将源数据库的对象定义和数据搬迁到目的数据库。

工具特性对比	KDTS	KFS
是否支持迁移存储过程等对象定义迁移	支持所有对象定义的迁移	支持表结构和主键的定义的迁移
同步一次，还是持续同步	一次同步	持续同步
是否需要初始状态同步	不需要	需要
跨平台	支持	支持
迁移部分表	支持	支持
迁移一个表的部分数据	支持	支持
断点续传	不支持	支持

2、调试工具

• 命令行的ksql
• 图形化的KStudio

工具特性对比	ksql	Kstudio
执行 SQL	支持	支持
直接编辑数据	需要写 SQL 语句	支持，通过图形界面直接编辑
执行存储过程	支持	支持
查看 SQL 执行计划	支持	支持
调试 plsql	支持	支持
数据库状态分析	不支持	不支持
慢 SQL 分析	不支持	不支持

3、数据同步工具

• 自带的物理同步
• KFS

工具特性对比	物理同步功能	KFS
跨 CPU	支持	支持
断点续传	支持	支持
同步部分对象	不支持	支持
同步所有操作	支持	支持

• 自带物理同步，用于两套 KingbaseES 之间同步，以整个 data 目录为单位，无法单独同步部分对象；可同步全部用户操作，支持断点续传与事务重放。
• KFS 用于 V8R3 与 V8R6 跨版本同步，支持筛选部分对象，同步粒度更灵活。业务割接需双轨运行时，可按需选用物理同步或 KFS。

4、备份工具

• 逻辑备份：sys_dump
• 物理备份：sys_rman

工具特性对比	sys_dump	sys_rman
异构数据源	不支持	不支持
支持增量	不支持	支持
支持根据日志恢复到指定时间点	不支持	支持
备份单个表	支持	不支持
可以不备份指定表	支持	不支持

• sys_dump 是逻辑备份，对象选择灵活、支持单表备份，无增量能力，不能配合 redo 日志；
• sys_rman 为物理备份，整实例备份，不支持单表，支持增量。

二、支持产品能力

1、模式对象和数据类型

模式对象

序号	模式下对象	创建示例 SQL
1	表和分区	create table t1(id int) partition by range(id);
2	视图（包含 force view）	create force view v1 as select * from t1;
3	可更新视图	create view v_update as select id from t1;
4	触发器	create trigger tr1 before insert on t1 for each row execute function func_test();
5	规则	create rule r1 as on insert to t1 do nothing;
6	约束	alter table t1 add constraint pk_t1 primary key(id);
7	索引	create index idx_t1 on t1(id);
8	数据库连接 dblink	create extension dblink; create database link link1 connect to system using 'host=127.0.0.1 port=5432 dbname=test';
9	函数	create function func_test() returns void as $$ begin end; $$ language plsql;
10	存储过程	create procedure proc_test() as $$ begin end; $$ language plsql;
11	操作符	create operator +> (leftarg=int, rightarg=int, procedure=int4add);
12	包	create package pkg_test is procedure p1; end pkg_test;
13	序列	create sequence seq1 start with 1;
14	同义词	create synonym syn_t1 for t1;
15	外部数据源	create foreign data wrapper fdw_test; create server srv1 foreign data wrapper fdw_test;
16	数据类型	create type typ1 as (col1 int, col2 text);
17	标记和策略	alter table t1 enable row level security; create policy pol1 on t1 for select using(true);
18	域 domain	create domain domain_int as int check(value>0);
19	扩展包	create extension pg_stat_statements;
20	全局临时表	create global temporary table gtt1(id int) on commit preserve rows;
21	DUAL 表	内置，无需创建，查询示例：select 1 from dual;
22	ROWNUM, LEVEL 等伪列	内置，无需创建，查询示例：select rownum,level from t1 connect by level<=10;
23	匿名块	do $$ begin raise notice 'hello'; end $$;
24	表达式，包括条件表达式等	内置，无需创建，示例：select case when id>1 then 1 else 0 end from t1;

数据类型

序号	分类	KingbaseES 数据类型	作用	建表示例 SQL
1	数值型	smallint	短整型，占用 2 字节，存储小范围整数	create table t(id smallint);
2	数值型	integer	整型，占用 4 字节，常用整数类型	create table t(id integer);
3	数值型	bigint	长整型，占用 8 字节，存储大范围整数	create table t(id bigint);
4	数值型	decimal	定点高精度数值，适合金额财务数据	create table t(val decimal(10,2));
5	数值型	numeric	和 decimal 等价，任意精度小数，无精度丢失	create table t(val numeric(10,2));
6	数值型	number	Oracle 兼容定点数，支持精度与刻度定义	create table t(val number(10,2));
7	数值型	real	单精度浮点数，4 字节，存在精度损失	create table t(val real);
8	数值型	float	浮点数，可指定精度，Oracle 兼容浮点类型	create table t(val float);
9	数值型	double precision	双精度浮点数，8 字节	create table t(val double precision);
10	数值型	double	等价 double precision，双精度浮点简写形式	create table t(val double);
11	数值型	smallserial	自增短整型，自动生成递增序列号	create table t(id smallserial);
12	数值型	serial	自增整型，常用主键自增类型	create table t(id serial);
13	数值型	bigserial	自增长整型，适合海量数据主键自增	create table t(id bigserial);
14	字符型	character(n[char｜byte]), char(n[char｜byte])	定长字符，不足长度自动补空格	create table t(name char(10));
15	字符型	character varying(n[char｜byte]), varchar(n[char｜byte]), varchar2(n[char｜byte])	变长字符，varchar2 为 oracle 兼容变长字符串	create table t(name varchar2(50));
16	字符型	nvarchar(n[char｜byte])	unicode 变长字符，存储多语言中文	create table t(name nvarchar(50));
17	字符型	text	无上限变长文本，存储大段文字内容	create table t(content text);
18	大对象型	clob, nclob	字符大对象，oracle 兼容，存储超大文本	create table t(big_text clob);
19	大对象型	blob	二进制大对象，存储文件、图片二进制流	create table t(big_data blob);
20	日期时间型	timestamp [§] [ without time zone ]	不带时区时间戳，保存年月日时分秒	create table t(ts timestamp);
21	日期时间型	timestamp [§] with time zone	带时区时间戳，跨时区业务使用	create table t(ts timestamptz);
22	日期时间型	date	仅保存年月日日期，不含时分秒	create table t(dt date);
23	日期时间型	time [§] [ without time zone]	不带时区时间，仅存时分秒	create table t(tm time);
24	日期时间型	time [§] with time zone	带时区的时分秒时间类型	create table t(tm timetz);
25	日期时间型	interval year	时间间隔，以年为单位	create table t(itv interval year);
26	日期时间型	interval month	时间间隔，以月为单位	create table t(itv interval month);
27	日期时间型	interval day	时间间隔，以天为单位	create table t(itv interval day);
28	日期时间型	interval hour	时间间隔，以小时为单位	create table t(itv interval hour);
29	日期时间型	interval minute	时间间隔，以分钟为单位	create table t(itv interval minute);
30	日期时间型	interval second	时间间隔，以秒为单位	create table t(itv interval second);
31	日期时间型	interval year to month	时间间隔，年 + 月组合	create table t(itv interval year to month);
32	日期时间型	interval day to second	时间间隔，天 + 时 + 分 + 秒组合	create table t(itv interval day to second);
33	布尔型	boolean	布尔类型，取值 true/false/null	create table t(flag boolean);
34	二进制型	bit(n)	定长二进制位串，存储比特数据	create table t(bits bit(8));
35	二进制型	bit varying(n)	变长二进制位串	create table t(bits bit varying(100));
36	XML 型	xml	xml 数据专用类型，支持 xml 解析查询	create table t(xml_data xml);
37	数组型	array	数组类型，一列存储多个同类型元素	create table t(arr int[]);
38	枚举型	enum	自定义枚举，限定字段只能取预设值	create type color as enum('red','blue'); create table t(c color);
39	JSON 型	json	json 文本存储，原始 json 字符串	create table t(j_data json);
40	JSON 型	jsonb	二进制 json，支持索引，查询性能更高	create table t(j_data jsonb);
41	UUID 型	uuid	全局唯一 id，分布式场景主键	create table t(uid uuid);
42	GIS 型	point	空间点坐标类型，地理信息	create table t(geo point);
43	GIS 型	line	空间线段类型	create table t(geo line);
44	GIS 型	box	空间矩形框类型	create table t(geo box);
45	GIS 型	path	空间路径类型	create table t(geo path);
46	GIS 型	circle	空间圆形类型	create table t(geo circle);
47	GIS 型	polygon	空间多边形类型	create table t(geo polygon);
48	GIS 型	geometry	通用空间几何类型，postgis 扩展使用	create table t(geo geometry);

2、SQL

分类	语法项	作用	示例 sql
数据操作	insert | update | delete	新增、修改、删除表内数据	insert into t1(id) values(1); update t1 set id=2 where id=1; delete from t1 where id=2;
数据操作	truncate	快速清空整张表数据，不记录单行日志	truncate table t1;
数据操作	merge into	合并数据，匹配则更新、不匹配则插入（upsert）	merge into t1 using t2 on (t1.id = t2.id) when matched then update set name=t2.name when not matched then insert(id,name) values(t2.id,t2.name);
数据操作	insert first/all	多条件分支插入数据，first 匹配第一条即终止；all 匹配全部条件	insert first when id<10 then into t1(id) values(id) else into t2(id) values(id) select id from t_src;
数据操作	copy	批量导入 / 导出表数据，适合大批量文件数据交换	copy t1 from '/data/file.csv' with (format csv);
数据操作	cluster	根据索引物理重排表数据，使数据按索引有序存储	cluster t1 using idx_t1;
数据查询	select	查询数据表中的数据	select id,name from t1 where id>1;
数据查询	层次查询 connect by	树形、层级递归查询（oracle 风格层级查询）	select id,level from t1 connect by prior id = pid start with id=1;
数据查询	lateral 子句	支持关联前面表的字段，执行子查询	select * from t1 left join lateral (select name from t2 where t2.t1_id = t1.id limit 1) sub on true;
数据查询	外连接操作符 (+)	oracle 风格简写外连接语法，标记一侧为驱动表的附属表	select * from t1,t2 where t1.id = t2.t1_id(+);
数据查询	with [recursive] 子句	cte 公用表表达式，recursive 支持递归查询	with recursive cte as (select 1 as n union all select n+1 from cte where n<10) select * from cte;
数据查询	prepare, execute	预编译 sql，一次编译多次执行，提升重复查询性能	prepare p1(int) as select * from t1 where id=$1; execute p1(1);
数据查询	values 子句	构造临时数据集，可直接用于查询、关联	select * from values (1,'a'),(2,'b') as tmp(id,name);
数据查询	explain	查看 sql 执行计划，用于 sql 性能分析调优	explain select * from t1 where id>1;
数据整理	analyze	收集表、索引统计信息，供优化器生成执行计划	analyze t1;
数据整理	vacuum	清理表过期元组，回收存储空间，更新可见性映射	vacuum t1;
数据整理	reindex	重建索引，修复索引碎片、损坏索引	reindex table t1;
事务控制语句	begin, start transaction	开启数据库事务	begin;
事务控制语句	commit	提交事务，持久化事务内所有修改	commit;
事务控制语句	rollback	回滚事务，撤销事务内所有未提交修改	rollback;
事务控制语句	savepoint | release savepoint | rollback to savepoint	设置保存点，支持局部回滚到指定节点，不回滚整个事务	begin; savepoint sp1; insert into t1 values(1); rollback to savepoint sp1; release savepoint sp1; commit;
事务控制语句	set transaction { read only | read write }	设置事务读写属性，只读事务禁止 dml 修改	set transaction read only;
事务控制语句	prepare transaction	两阶段事务提交，分布式事务预提交	prepare transaction 'tx_001';
权限语句	grant	授予用户对象权限或系统权限	grant select on t1 to user1;
权限语句	revoke	回收已经授予用户的权限	revoke select on t1 from user1;

3、PL/SQL

序号	分类	语法项	作用	示例 sql
1	PL/SQL 基础语句	赋值语句	给变量赋予指定值，支持变量之间赋值	declare v_num integer; begin v_num := 10; end;
2	PL/SQL 基础语句	if-then-else 语句	条件分支判断，满足条件执行对应代码块	declare v_num integer:=5; begin if v_num>0 then raise notice '大于0'; else raise notice '小于等于0'; end if; end;
3	PL/SQL 基础语句	case 语句	多分支条件判断，简化多 if 嵌套场景	declare v_type integer:=1; begin case v_type when 1 then raise notice '类型1'; when 2 then raise notice '类型2'; end case; end;
4	循环语句	loop、while-loop、for loop	循环执行代码块；loop 无条件循环，while 按条件循环，for 遍历集合循环	declare v_i integer:=1; begin loop raise notice '%',v_i; v_i:=v_i+1; exit when v_i>3; end loop; end;
5	变量属性	% type 属性和 % rowtype 属性	% type 引用表字段类型；% rowtype 直接引用表一行记录结构	declare v_name t1.name%type; v_row t1%rowtype; begin select name into v_name from t1 limit 1; end;
6	游标	ref cursor 游标	动态游标，运行时绑定查询，可作为参数传递	declare type ref_cur is ref cursor; cur ref_cur; v_id integer; begin open cur for select id from t1; fetch cur into v_id; close cur; end;
7	异常处理	预定义异常和自定义异常	捕获程序运行错误，可自定义业务异常，异常发生时执行容错逻辑	declare exp_custom exception; begin raise exp_custom; exception when exp_custom then raise notice '捕获自定义异常'; end;
8	游标属性	% notfound、% found、% isopen 和 % rowcount	游标状态属性：% found 是否读到行；% notfound 无数据；% isopen 游标是否打开；% rowcount 返回已读取行数	declare cur cursor for select id from t1; v_id integer; begin open cur; fetch cur into v_id; if cur%found then raise notice '有数据'; end if; close cur; end;
9	DML 扩展	returning into 语句	dml 执行后，直接把修改的数据返回存入变量	declare v_id integer; begin insert into t1(name) values('test') returning id into v_id; end;
10	动态 SQL	execute immediate 语句	执行动态拼接的 sql 字符串，支持动态表名、条件	declare v_sql text; begin v_sql:='select count(*) from t1'; execute immediate v_sql; end;
11	批量处理	bulk collect	批量读取查询结果，一次性把多行数据存入集合，减少循环开销	declare type t_arr is table of t1.id%type; v_arr t_arr; begin select id bulk collect into v_arr from t1; end;
12	消息输出	raise 语句	打印提示消息、抛出异常，用于调试输出信息	begin raise notice 'hello plsql'; end;
13	集合类型	PL/SQL 集合类型（关联数组、嵌套表、可变数组）	存储一组同类型数据，类似数组，用于批量数据处理	declare type nt is table of integer; v_nt nt:=nt(1,2,3); begin raise notice '%',v_nt(1); end;
14	PL/SQL 对象	触发器（行级触发器，列级触发器，事件触发器）	表发生增删改时自动执行代码，实现数据约束、审计	create trigger tr_t1 before insert on t1 for each row begin raise notice '触发行级触发器'; end;
15	PL/SQL 对象	函数，嵌套函数	有返回值，可在 sql 中调用；嵌套函数在函数内部定义子函数	create function f_get_id() returns integer as $$ begin return 1; end; $$ language plsql;
16	PL/SQL 对象	存储过程	封装业务逻辑，无返回值，用于复杂事务处理	create procedure proc_insert() as $$ begin insert into t1 values(1); end; $$ language plsql;
17	PL/SQL 对象	匿名块	临时执行的 PLSQL 代码，不持久化存储，一次性脚本	declare v_msg text; begin v_msg:='test'; raise notice '%',v_msg; end;
18	PL/SQL 对象	package	程序包，把过程、函数、变量封装成一个模块，管理一组相关逻辑	create package pkg_test as procedure p_test(); end pkg_test;
19	PL/SQL 对象	object type	自定义对象类型，可定义属性与成员方法，面向对象特性	create or replace type obj_test as object(id integer,name varchar2(10));

4、客户端编程

接口编程

序号	编程语言	KingbaseES 对应支持
1	JAVA	JDBC
2	.Net	.Net Data Provider
3	C/C++	Pro*C
4	C/C++	DCI
5	ODBC
6	OCCI
7	Php	pdo
8	Perl	pdi
9	Python	ksycopg2
10	golang	gokb
11	Node.js	kb

开发框架

序号	开发框架	KingbaseES 对应支持	简介
1	Hibernate	支持	Java 老牌 ORM 持久化框架，将对象映射到数据库表，屏蔽原生 SQL，简化数据库操作
2	Activiti	支持	Java 工作流引擎，用于业务流程审批（工单、流程流转），可将流程数据存入金仓
3	Mybatis	支持	Java 主流 ORM 框架，半自动映射，自定义 SQL 灵活，国内项目使用最多
4	Mybatis-Plus	支持	基于 Mybatis 增强封装，自带 CRUD、分页、条件构造器，减少重复基础 SQL 代码
5	Flyway	支持	数据库版本迁移工具，管理 SQL 脚本版本，自动升级 / 降级数据库结构
6	Liquibase	支持	数据库变更管理工具，多数据库兼容，支持 XML/YAML/SQL 格式记录表结构变更
7	Dbunit	支持	数据库单元测试工具，测试前后自动导入 / 清理测试数据，用于单元测试
8	Hibernate-Spatial	支持	Hibernate 空间扩展框架，用于地理空间数据的对象映射、空间查询
9	Qt	支持	C++ 跨平台 GUI 开发框架，内置数据库模块，可连接金仓做桌面客户端开发
10	Ef6	支持	.NET Framework 的 ORM 框架（Entity Framework 6），C# 对象和数据库映射
11	Efcore	支持	跨平台新版 Entity Framework，.NET Core/.NET5 + 的 ORM，.NET 项目主流
12	Django	支持	Python 全栈 Web 框架，自带 ORM 模块，快速开发 Web 业务系统
13	SQLAlchemy	支持	Python 成熟 ORM 框架，灵活度高，Python 后端常用数据库对象映射工具

连接池

序号	连接池	KingbaseES 对应支持	简介
1	C3P0	支持	Java 老牌数据库连接池，管理数据库连接复用，防止频繁创建销毁连接，老项目常用
2	DBCP	支持	Apache 出品的 Java 连接池，稳定可靠，早期传统项目广泛使用
3	Druid	支持	阿里开源 Java 连接池，自带监控、防 SQL 注入，国内 Java 项目使用非常普遍
4	HikariCP	支持	高性能轻量级 Java 连接池，SpringBoot 默认连接池，速度快、开销小