[大数据]金仓数据库 MySQL 至 KingbaseES 迁移最佳实践（3. MySQL 数据库移植实战）

3.?MySQL 数据库移植实战

由于 KingbaseES 利用 KDTS-PLUS 等多种工具简化移植过程。

本节重点描述了在实际应用中移植一个 MySQL 数据库系统的完整过程，以及其中的主要移植内容、常用移植方法和关键移植步骤。

本章节包含以下内容：

• 主要移植内容

• 关键移植步骤

3.1.?主要移植内容

在实际应用中，一个 MySQL 数据库系统的移植主要包括如下内容。这些内容的迁移是存在先后顺序的。若违反该顺序，则可能导致迁移受阻。

根据迁移构成中业务是否可以停止服务，迁移又分为离线迁移和再线迁移。

3.1.1.?数据库、用户移植

数据库是各种 SQL 和 PL/SQL 数据库对象的存放容器，而用户是这些对象的管理者和使用者。因此，在迁移数据库对象之前，一般应先迁移数据库、用户。

那么，如何移植这些内容呢？应在目的数据库 KingbaseES 上创建与源数据库 MySQL 同名的数据库、用户。

另外，所创建数据库的字符集应与 MySQL 数据库字符集一致。

3.1.2.?数据迁移

支持在线迁移和离线迁移。

使用 KDTS-PLUS 将 MySQL 离线迁移到 KingbaseES 中。

使用 KFS 支持将 MySQL 在线迁移到 KingbaseES 中。

3.1.3.?应用程序移植

在完成数据库对象迁移以后，才可开始迁移应用程序，主要原因是：在用程序中，可能会访问和操作前面迁移的数据库对象。

应用程序移植是指对 MySQL API 方式或嵌入式 SQL 方式的应用程序的移植。它主要包括接口驱动程序和连接方法的移植，以及 MySQL 扩展或私有的、且 KingbaseES 未兼容的 API 移植。通常，该项任务的工作量较少。

在实际应用中，通常应用程序移植与移植系统测试与调试交叉进行。

3.2.?关键移植步骤

作为一个典型的项目过程，MySQL 数据库移植应具有健全的项目团队和全面细致的的项目执行过程。通常，移植一个 MySQL 数据库主要包括以下步骤：

• 确定移植目标

• 评估移植任务

• 组建移植团队

• 准备迁移环境

• 数据库用户迁移

• 数据迁移_

• 应用程序迁移

• 测试与调试移植系统

这些步骤指之间的关系是：前四个步骤是迁移前的准备工作，这些准备工作是确保后续 MySQL 移植顺利进行的前提条件，而最后一步是保证最终移植系统正确性和可用性的关键步骤。

下面，分别对上述各个步骤进行详细说明。

3.2.1.?确定移植目标

开始迁移前，应根据用户的实际需求，确定移植目标。这些目标诸如：

• 迁移 MySQL 数据库的规模。

• 迁移 MySQL 数据库对象的种类和特征，如简单和复杂迁移对象所占比例等。

• 迁移的难易程度，如是否迁移大对象，是否迁移大量约束等。

• 迁移的工期要求。

• 迁移数据时是在线迁移还是离线迁移。

• 对目标系统的技术指标要求，诸如平台、版本、应用编程接口、工具、可用性、安全性和性能指标要求等。

3.2.2.?评估移植任务

明确移植目标以后，则可开始移植任务评估。

当计划把一个 MySQL 数据库系统移植到 KingbaseES 环境时，如果不做评估或评估不充分的话，那么整个移植工作会存在很多潜在风险，额外增加移植工程师的工作量并且无法确认移植完成时间。因此，移植前对移植的可行性、工作量、难易程度和工作进度等进行充分评估是非常必要的。

通常，移植评估主要包括以下内容：

• 移植技术指标，如移植业务压力和性能指标等。

• 移植数据规模，如移植各类数据库对象的数量，PL/SQL 程序的规模等。

• 移植中 KingbaseES 不支持功能的种类和数量。

• 移植的约束种类和数量。

• 移植过程中可能遇到的其他问题。

在 MySQL 移植中常用的评估模板如下表所示：

表 3.2.23??移植评估的数据库 / 应用概况模板

表 3.2.24??移植评估的移植报告总结模板

表 3.2.25??移植评估的对象统计模板

表 3.2.26??移植评估的约束统计模板

表 3.2.27??移植评估的其它方面模板

3.2.3.?组建移植团队

任何一个高效、成功的项目都应具备一个健全和良好的团队，MySQL 数据库移植也不例外。如果没有这样团队互相配合和支持，那么 MySQL 数据库移植将可能存在巨大的风险。所以，组建一个高效的移植团队是非常必要的。

那么，移植团队的组成人员应具备哪些条件呢？他们应至少具备以下的知识与技能：

• 熟悉 MySQL 和 KingbaseES 的 SQL 语言和 PL/SQL 语言特性，以及相关的 MySQL 兼容特性。

• 熟悉 MySQL 和 KingbaseES 的各种应用编程接口，以及相关的 MySQL 兼容特性。

• 熟悉 MySQL 和 KingbaseES 的相关客户端工具，以及这些工具间的相同点和异同点。

由这些优秀人员组建的团队是高效移植 MySQL 数据库的可靠保障。

3.2.4.?准备迁移环境

在上述步骤完成以后，移植工程师应开始准备迁移环境了，这些准备工作诸如：

3.2.4.1.?部署目的数据库服务器

部署目的数据库服务器应遵循以下原则：

• 目的数据库服务器的 CPU、内存、网络环境等硬件应尽量采用较高的配置。

• 如果移植的 MySQL 数据库系统规模较大，如超过 1GB，则建议把 MySQL 和 KingbaseES 部署在不同的物理机器上。

• 为确保迁移效率，应尽量把 KingbaseES 和 MySQL 服务器部署到同一局域网内。

3.2.4.2.?获取并安装必要的软件

迁移前应获取并安装如下软件：MySQL 数据库系统、KingbaseES 数据库系统、JDBC 和 ODBC 驱动程序、C 语言开发工具、TPC-C 测试工具、LoadRunner 等。

如果迁移数据规模较大，建议对安装的 KingbaseES 数据库服务器进行适当的优化，如增大 shared_buffer 大小、预先创建较大的日志文件，预先申请足够的表空间数据库文件等。

完成上述准备工作后，移植工程师便可开始 MySQL 数据库移植工作了。

3.2.5.?数据库用户迁移

数据库、用户和模式迁移主要包括以下内容：

• 获取源 MySQL 数据库的 IP 地址、实例名、网络服务端口号、用户名 / 密码等信息。

• 在目的 KingbaseES 数据库上，使用 KSQL 工具上执行如下操作：

  • 创建与源 MySQL 用户同名的用户，用户 root。

  • 创建与源 MySQL 同名的数据库，mysql。

  • 创建与源 MySQL 同名的模式。

3.2.6.?数据迁移

KingbaseES 数据迁移工具 KDTS-PLUS 动态加载待迁移的数据库访问接口，方便用户定制和使用。

KingbaseES 数据同步工具 KFS 支持同、异构数据源之间的数据迁移

同构数据源间数据迁移：支持 Kingbase V7 和 V8R3 到 KingbaseES V8.6 的数据迁移。

异构数据源之间的数据迁移：支持 MySQL5、MySQL8 到 KingbaseES V8.6 的数据前迁移。

KingbaseES 数据同步工具 KFS 支持结构迁移、支持全量数据迁移、支持列名映射，支持数据迁移过滤，在配置数据任务时，可以对迁移的表配置 where 条件、通过匹配的 where 条件过滤需要迁移的数据。

数据库迁移时需要按照用户需求确定在线迁移还是离线迁移，若是离线迁移，使用 KDTS-PLUS 完成 MySQL 的完整迁移； 若是在线迁移，目前支持使用 KFS 完成，注意这种情况下无法迁移 plsql 等复杂对象。

本节包括：

• 迁移前准备

• 离线迁移

• 在线迁移

3.2.6.1.?迁移前准备

在使用 KDTS-PLUS 迁移 MySQL 数据库之前，应先做如下准备工作：

3.2.6.1.1.?获取 MySQL 数据库的相关信息

迁移前，应获取源数据库 MySQL 服务名及迁移的数据规模信息。

1. 数据库、用户和模式迁移主要包括以下内容：

获取源 MySQL 数据库的 IP 地址、实例名、网络服务端口号、用户名 / 密码等信息。

在目的 KingbaseES 数据库上，使用 KSQL 工具上执行如下操作：

创建与源 MySQL 用户同名的用户，用户 root。

创建与源 MySQL 同名的数据库，mysql。

创建与源 MySQL 同名的模式。如果通过查询分析器或 KSQL 工具创建同名用户，则省略此步。但是，如果通过企业管理器创建同名用户，则此步则不能省略。

2. 大小写是否敏感

MySQL 通常默认是大小写不敏感，而 KingbaseES V8.6 默认是大小写敏感，可以在初始化数据库的时候进行修改。

./initdb -D /home/kingbase/Kingbase/ES/V8/data -U SYSTEM  --enable-ci

3. 查询 MySQL 数据库编码方式

show variables like 'character_set_database';

【Kingbase初始化设置编码方式】
 --encoding=GBK（支持 GBK UNICODE ASCII）

4. 查看表数据量大小

查看当前用户在 MySQL 中的表大小，按从大到小排序（单位 GB）

select
table_schema, table_name, table_rows, truncate(data_length/1024/1024, 2), truncate(index_length/1024/1024,2)
from information_schema.tables
where table_schema = 'mysql'
order by data_length desc, index_length desc;

  # TABLE_SCHEMA TABLE_NAME  TABLE_ROWS  truncate(data_length/1024/1024, 2)  truncate(index_length/1024/1024,2)
 mysql help_topic  817 1.51  0.09
 mysql help_keyword  938 0.12  0.12
 mysql help_relation 1723  0.09  0.00
 mysql innodb_index_stats  158 0.06  0.00
 mysql global_grants 47  0.04  0.00
 mysql proxies_priv  1 0.01  0.01
 mysql db  2 0.01  0.01
 mysql replication_asynchronous_connection_failover  0 0.01  0.01
 mysql procs_priv  0 0.01  0.01
 mysql help_category 53  0.01  0.01
 mysql replication_group_member_actions  2 0.01  0.01
 mysql tables_priv 2 0.01  0.01
 mysql engine_cost 2 0.01  0.00
 mysql func  0 0.01  0.00
 mysql gtid_executed 0 0.01  0.00

5. 检查数据库日期格式

MySQL 数据库中 date 的默认格式为 'YYYY-MM-DD',time 的默认格式为 'HH:MM:SS'

KES 中时间的默认格式为：ISO, YMD

MySQL 数据库中有日期 "0099-09-30 00:00:00"，KingbaseES 中将 99 识别为月份报错：

ERROR: date/time field value out of range

3.2.6.1.2.?配置 KingbaseES 的 MySQL 兼容开关

根据实际情况，应对目的数据库 KingbaseES 进行适当的 MySQL 兼容配置。通常，应配置以下兼容参数：

1. mysql_interval_style：兼容 MySQL 的 interval 格式。

在 KingbaseES 系统参数?mysql_interval_style?的默认值为 off。

2. sql_mode：兼容 MySQL 的模式列表。

在 KingbaseES 系统参数?sql_mode?的默认值为 ONLY_FULL_GROUP_BY。

可以用如下方式使用 sql_mode 参数:

TEST=# set sql_mode = 'ONLY_FULL_GROUP_BY';
SET
TEST=# show sql_mode;
      sql_mode
-----------------------------------
ONLY_FULL_GROUP_BY
(1 行记录)

3.2.6.1.3.?移植数据库、用户

在目的数据库 KingbaseES 上创建与源数据库 MySQL 同名的用户、数据库，并且授予新建用户具有使用该数据库和新建模式的所有或适当的权限。另外，所创建数据库的字符集应与 MySQL 数据库字符集一致。如果 KingbaseES 已有同名数据库，则登录该数据库后，只需创建同名用户。

3.2.6.1.4.?配置 JDBC 数据源

配置 KingbaseES 和 MySQL 的 JDBC 数据源，并设置相关的连接信息。

3.2.6.1.5.?配置目的库 KingbaseES 性能参数

为了提高迁移速度，应对目的库 KingbaseES 进行性能优化配置。

例如：

1. 根据迁移数据规模的大小，迁移前可预先创建适当大小的的数据和日志文件。

   开始迁移之前根据待迁移数据库的大小，保证 KingbaseES 数据目录所在位置有足够的空间。

2. 根据 KingbaseES 服务器硬件配置的实际情况调整?shared_buffers?大小，默认是 128M，建议调整为内存的 1/4 大小。

3.2.6.2.?离线迁移

在完成上述准备工作以后，用户可使用 KDTS-PLUS 进行数据的离线迁移，KDTS-PLUS 提供了两种形态（BS、SHELL），用户可根据需要进行选择，以下章节将分别介绍 BS、SHELL 版本进行 mysql 迁移的具体步骤。

3.2.6.2.1.?BS 迁移步骤

• 创建源数据库连接

创建源库数据库连接。创建数据库连接界面如下，填写数据源信息，包括：?“连接名称”、“数据库类型”、“数据库版本”、“服务器地址”、“端口”、“用户名”、“密码”、“数据库”、“驱动”、“URL”、“连接参数”。

• 创建目标数据库连接

创建目标数据库连接。创建数据库连接界面如下，填写数据源信息，包括：?“连接名称”、“数据库类型”、“数据库版本”、“服务器地址”、“端口”、“用户名”、“密码”、“数据库”、“驱动”、“URL”、“连接参数”。

• 新建迁移任务

KDTS-PLUS 采用向导页的方式指导用户新建迁移任务，简单易用，用户依次配置” 选择数据源 “- 选择模式”-“选择迁移对象”-“配置参数”，即可快速配置一个迁移任务。

1. 选择数据源

   填写自定义任务名称（任务名称不能重复），选择 “源数据库” 和 “目标数据库”，或者选择 “新建数据源” 后使用。

   

2. 选择模式

   根据您的数据迁移所需选择对应模式（如需选择模式在系统模式中可选中 “包含系统模式” 复选框）的表、视图、序列、函数、存储过程、程序包、同义词。当模式较多时也可以通过左上方的查询框进行检索。 请您至少选择一种模式，否则将收到错误提示，以至于不能完成新建任务。

   

   在选择模式的前提下如您未选择 “表”，即没有迁移对象，则系统将认为您不需要迁移对象，将提示您直接跳过 “选择迁移对象” 进入 “配置参数”。

3. 选择迁移对象

   通过已选模式选择您需要迁移数据的表，模式较多时可在已选模式搜索框内输入模式名关键字进行快速检索。

   

   可迁移此模式下全部表，也可以指定或排除部份表，当您选择 “包含指定表” 或 “排除指定表” 时，请您通过 “从列表选择”、“从文件导入” 或者在输入框内输入表名将数据添加到包含列表中，如您未添加数据，则会提示错误导致无法进行下一步并完成新建任务。

   

   当您点击 “包含指定表” 时也可选择多种方式。可直接在输入框内填写表名，多个表用 “，” 分割，回车确认；“从列表选择” 可在模式中选择指定表；如您要 “从文件导入”，可点击 “下载导入模板”，根据导入模板规则填写，然后从文件导入该模板。当您需要 “排除指定表” 时，同指定部份表相同操作，但结果相反。

   

   从列表选择表时，可选择对应模式、检索表名关键字、数据条数限制进行快速检索对应的表。点击 “添加” 按钮后加入到已选列表，当您想要移除部份表时可以选择对应的表点击 “移除” 按钮取消表。选择完成后点击确定。

   

4. 配置参数

   可以通过对参数的更改获得预估的数据迁移结果。包括迁移配置、数据类型映射和线程配置。其中迁移配置包括 “表默认处理方式”、“表排序依据”、“表数据读取和写入”、“大表拆分阈值依据”、“非对象设置”、“数据库连接数设置”。

   

   • 表默认处理方式：

     包括两个复选框项（“建表 / 重建表”、“导入数据”），迁移到 KingBaseES 数据库是否需要建表或者重建表，以及是否只迁移表结构而不迁移数据的选择，根据您的需求选择合适的选项（默认是全选）。

   • 表排序依据：

     对迁移的表进行排序，可通过 “按行数和大字段大小交替”、“行数”、“大小” 进行排序（默认是按行数和大字段大小交替）。

   • 表数据读取和写入：

     对表数据的读取和写入制定规则，可操作项包括 “源库游标读取记录数”（默认是 100）、“批量写入目标库记录数”（默认是 1000）、“每次批量提交大小”（默认是 100MB）、“LOB 字段预读取大小”（默认是 4000Byte）。

   • 大表拆分阈值依据：

     对大表进行拆分迁移，设置拆分界限。

   • 非对象设置：

     其中包含 “主键”、“检查约束”、“唯一约束”、“外键”、“索引”、“触发器”、“自动转换对象名”。您可以根据自己的需求选择是否迁移这些非对象数据（默认是全选）。

   • 数据库连接数设置：

     您可以限制迁移程序对源数据库和目标数据库的最大连接数（默认是 100）。

• 执行迁移任务

可将此任务作为预迁移任务点击 “保存”，或者作为执行任务点击 “保存并迁移”。

• 迁移完成：

迁移结束 “状态” 栏显示 “完成”，则迁移任务成功。

• 迁移失败：

迁移结束 “状态” 栏显示 “失败”，则迁移任务失败。失败后可点击详情查看日志有助于解决问题。

• 查看迁移报告及问题处理

迁移完成后，需要确认执行结果，包括迁移数据量，是否有错误发生，可以通过迁移日志和迁移结果进行查看。

“迁移日志” 打印迁移任务执行后的日志，具体可分为 “系统日志”、“Error 日志”、“Info 日志”。

“迁移结果” 功能的工作区包括 “任务执行批次”、“迁移对象”、“总数”、“成功数”、“失败数”、“略过数”、“操作”。您可以查看历史迁移任务执行的每次记录，以及每次迁移的对象、成功数、失败数、查看失败任务的错误日志。

3.2.6.2.2.?SHELL 迁移步骤

• 目录说明

• bin: 启动脚本

• conf: 配置文件

• doc: 帮助文档

• drivers: 数据库连接驱动（注意不同版本驱动的存放目录差别，详见 readme.md）

• jdk: jdk

• kdms: kdms 程序

• lib: 程序包

• logs: 日志

• result: 迁移报告

• JDK 安装

  下载与 KDTS-PLUS 安装服务器相匹配的 JDK（需要匹配操作系统和 CPU 架构，如 Liunx/AArch64、Linux/x64、Windows/x64 等），版本选择 JDK 15 或更高。下载地址:?https://jdk.java.net/archive/

  将下载的 JDK 解压到 kdts-plus/jdk 目录下

  注意：

a、请使用解压版本的 JDK，以免安装 JDK 影响服务器上的其它应用。

b、不要把当前的 JDK 加入系统环境变量，以免影响服务器上的其他应用。

c、如果需要使用服务器上已有的 JDK，配置 bin/startup.sh（Windows 平台为 startup.bat）中的 JAVA_PATH 即可。

• 配置数据库连接信息

• 进入 kdts-plus/conf 目录下，打开 application.yml 文件，根据源库类型设置当前激活的源库配置（active: mysql），如下所示：

  

  在正确设置 application.yml 中的 active 项后，打开对应配置文件（kdts-mysql.yml），按实际运行环境进行配置即可。

• 配置源端数据库连接信息、目标数据库连接信息

编辑 conf/kdts-mysql.yml 文件，编辑源端和目标端连接信息，包括 url、driver-class-name、username、password 信息，如下图所示：

• 配置要迁移的源库模式，数据库对象，涉及到的参数见下图：

  

• 迁移配置参数说明

  编辑 conf/kdts-mysql.yml 文件有多个配置参数，可灵活使用。以下列举常用的配置参数。

• fetch-size：

  源数据库游标读取记录数，在一定范围内增加该值可提升读取效率，但会增加内存开销。

• table-with-large-object-fetch-size:

  源数据库含大对象数据表的游标读取记录数，此参数针对有大对象字段的表。

• large-table-split-threshold-rows：

  大表拆分阈值行数（当表的行数超过此值时，将对表进行拆分，每块的记录数为此值和表总记录数除以 “拆分最大块数” 中的最大值）。

• large-table-split-threshold-size：

  大表拆分阈值大小（单位为 M），当表的数据大小（普通字段 + 大对象字段）超过此值时，将对表进行拆分。

  • large-table-split-condition-file：

  大表拆分条件定义文件，优先于按行数和大小拆分。

• table-data-filter-condition-file：

  表数据过滤条件定义文件。

• use-kdms:

  是否使用 kdms 做转换（视图、函数、存储过程、包、触发器）。

• kdms-url:

  kdms 访问地址，前提是 use-kdms: true

• write-batch-size:

  目标数据库表数据批量提交记录数.

• write-batch-size-big-lob：

  目标数据库表数据批量提交记录数，特指大对象数据。

  • drop-existing-object：

    是否默认删除目标库中已存在的对象（如表、视图等）。

  • truncate-table：

    是否默认清空目标库中已存在的表数据。

• rename-object：

  目标数据库对象重命名，除表名、列名外的其他对象: pk、fk、constraint、unique constraint、index 等。

• 线程相关设置

  线程相关设置可根据实际服务器配置按比例调整，如果与目标数据库运行在同一服务器上，应将绝大部分资源分配给数据库。

  进入 kdts-plus/conf 目录下，打开:kb-thread-config.xml，如下图所示：

  

  数据迁移属于 IO 密集型操作，涉及网络络 IO 和磁盘 IO 的交互，一旦发生 IO，线程就会处于等待状态，当 IO 结束，数据准备好后，线程才会继续执行。为提升数据迁移的效率可以多设置?些线程池中线程的数量，避免任务等待，线程可以去做更多的迁移任务，提高并发处理效率。但不是线程数设置的越高，效率就越高，线程上下文切换是有代价的。 对于对于 IO 密集型线程数的设置公式为：线程数 = CPU 核心数 /(1 - 阻塞系数) ，其中阻塞系数一般为 0.8~0.9 之间，取 0.9 则：

  双核 CPU： 2/(1-0.9) = 20

  64 核 2 路 CPU： 64*2/(1-0.9) = 1280

• 启动脚本

  • 进入 kdts-plus/bin 目录下，编辑: startup.sh

  • 检查 JDK 的路径是否正确

  JAVA_PATH=${BASE_PATH}”/jdk“

  • 设置 JVM 内存

    根据当前服务器的配置，调整 JVM 参数

    JAVA_OPT="-server?-Dfile.encoding=UTF-8?-Dconfig.path=${CONFIG_DIR}?-Xmx16g?-Xms16g"?主要是:?-Xmx16g?-Xms16g?参数

  • 启动运行脚本

    进入 kdts-plus/bin 目录，执行: ./startup.sh

• 查看迁移报告及问题处理

  可以在运行日志（kdts_plus_***.log）中查看到迁移整个过程的信息，包括任务启动、迁移进程、结果汇总

  可查看 result 下的迁移结果（在形如 “result/2021-12-02_15-15-15/Sehcma1” 目录下）

• index.html-- 报告主页面

• detail_XXX.html--XXX 详细信息（如表结构、表数据、表主键等）

• FailedScript-- 失败脚本目录

• IgnoredScript-- 略过脚本目录

• SuccessScript-- 成功脚本目录

在迁移过程中一旦某个对象创建失败，KDTS-PLUS 会将该对象的创建 sql 保留到本次迁移任务文件夹下的 FailedScript 目录下 *.sql 文件，用户可以手动修改后通过 ksql 或者 KStudio 工具手动执行。

3.2.6.3.?在线迁移

在线迁移时，首先需要使用 KFS 完成。

具体参见 KFS 产品的 MYSQL 在线迁移指南。

3.2.6.4.?多次迁移

若项目开发过程中，需要定期从一个指定的源数据库迁移到目的数据库中， 那么根据迁移时源数据库和应用的状态，决定离线迁移还是在线迁移。

同时，由于是多次迁移，需要考虑每次迁移时数据库对象的定义是否需要迁移， 若不需要，则只迁移数据就可以，使用 KDTS-PLUS 和 KFS 都支持只迁移数据； 若每次迁移时需要迁移对象定义，则

1）比较源和目的对象定义是否发生变更

2）对于定义发生变更的表，选择迁移定义和数据

3）对于定义没有发生变更的表，只同步数据即可。

3.2.7.?应用程序迁移

在应用编程接口方面，KingbaseES 与 MySQL 兼容程度较高，所以，一般情况下，应用程序迁移比较容易。应用程序迁移通常应和移植系统测试同时进行。这样可及时修改测试过程中发现的问题。

3.2.7.1.?概述

如何在一个应用程序中访问和操纵数据库呢？通常，可采用以下方式：

3.2.7.1.1.?API 方式

该方式通过数据库厂商提供的各种标准应用编程接口在应用程序中与数据库进行交互。常用的应用编程接口如 JDBC 和 ODBC 等。目前，大多数数据库厂商均提供很多标准的数据库 API 及其驱动程序。

在实际应用中，应首先加载驱动程序。加载成功后，利用 API 函数与数据库交互并完成对数据库数据的操作。

详细参考 《客户端编程接口》。

3.2.7.1.1.1.?JDBC

其它问题请参考 《JDBC 指南》

3.2.7.1.1.2.?Hibernate

3.2.7.1.1.3.?MyBatis

目前 Mybatis3.2.8，Mybatis3.3.0 和 Mybatis3.4.5 均已通过 KingbaseES V8.6 版本适配的验证测试

MyBatis 的 jar 包可以从官方网站下载，Mybatis 所以使用的 JDBC 包 kingbase8-8.2.0.jar 位于 $KINGBASE_HOME/jdbc 目录下。使用时将 Mybatis 包和 JDBC 包导入到项目的 Libraries 中并定义相关配置项即可。

定义 Mybatis 配置文件，跟据用户选择，更改一下配置文件。

在 config.xml 中配置 JDBC 的驱动信息参数，数据库服务器信息参数和登陆用户信息参数。当然，这些参数也可以根据用户应用需求，单独生成 property 文件，针对不用的应用场景，导入不同的属性文件。这里以 property 为例说明下 config.xml 的配置使用。

在 property 中增加如下声明：

jdbc.driverClassName=com.kingbase8.Driver
jdbc.url=jdbc:kingbase8://192.168.229.128:54322/TEST
jdbc.username=登录名
jdbc.password=登录密码
在config.xml 中增加如下声明：

   <environments default="development">
      <environment id="development">
         <transactionManager type="JDBC"/>
         <dataSource type="POOLED">
            <property name="driver" value="${jdbc.driverClassName}"/>
            <property name="url" value="${jdbc.url}"/>
            <property name="username" value="${jdbc.username}" />
            <property name="password" value="${jdbc.password}" />
         </dataSource>
      </environment>
   </environments>

具体使用样例请参考 《MyBatis 指南》

或者 MyBatis 官网 http://www.mybatis.org/mybatis-3/zh/index.html

3.2.7.2.?修改应用框架

如果应用使用的框架支持多种数据库和各自方言，修改配置使得框架使用 postgresql 库及其方言。

分享【教育部语言文字系统 - 应用迁移】：

未修改之前框架适配使用的是 MySQL 的方言和表结构，其中用到了 BLOB/CLOB。

经调研框架也支持其他库，例如 MySQL 和 postgresql，除 MySQL 外，类型均为 bytea/binary，目前解决方法是配置框架使用 postgresql 库及其方言。

具体修改：

1. BaseInterceptor.java 中 Kingbase 类型库使用 postgresql 方言

2. Spring-Context-Activiti.xml 中指定 database type 为 postgres，database schema update 设为 false

3. 数据库实例需要配置为大小写不敏感，工作流使用的库需要建在默认 schema 下

3.2.8.?测试与调试移植系统

任何一个成熟的应用系统如果代码、尤其是关键代码变动后，则应进行全面细致的测试。类似的，更换新的后台数据库系统以后，也应对移植后的数据库系统进行全面的功能和性能测试。

3.2.8.1.?功能测试和排错

功能测试是指对移植数据库系统的每一个模块和功能进行全面的系统回归测试，用以确保新系统各个功能的正确性。

因此，完成数据库对象和应用程序迁移后，应对移植系统进行全面的功能测试，并对测出问题及时分析、排查和修改。对那些很难定位的问题，请及时联系 KingbaseES 支持工程师。

3.2.8.2.?性能测试和调优

移植系统性能测试和调优是在完成移植系统功能测试后和系统上线前，在实际或模拟生产数据上，对移植系统进行的性能测试和调优。

移植系统性能测试和调优的主要步骤如下：

• 构造测试数据：若条件允许的话，建议构造与实际生产数据规模相同的数据，并模拟构造未来一年、两年、五年或更长生命周期的数据进行测试。

• 部署测试软硬件环境：根据测试数据规模的大小，配置适当的测试软硬件环境。

• 性能测试：既可采用手动方式，也可利用 TPCC 测试工具、LoadRunner 等工具对移植系统进行自动测试。

• 性能调优：对未达到性能指标的功能模块及其 SQL 语句进行优化并给出相关建议。

通常，性能测试效果与测试数据规模、软硬件配置等因素密切相关。因此，建议性能测试时，测试数据规模、软硬件配置应尽量与将来的实际生产环境一致。必要时，在未来一年、两年、五年等不同模拟数据规模场景下，应分别测试移植系统的性能指标，用以保证移植系统未来仍能具有良好的性能表现。