KingbaseES_GIS数据迁移方案.pdf
KingbaseES_GIS数据迁移方案.pdf
KingbaseES GIS 数据迁移方案 金仓数据库管理系统 KingbaseES 文档版本：V9（V009R001C001B0024） 发布日期：2023 年 10 月 12 日 北京人大金仓信息技术股份有限公司 目 目 录 录 第 1 章 前言 1 1.1 适用读者 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.2 相关文档 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.3 术语 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1 1.4 手册约定 2 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 第 2 章 KingbaseES GIS 能力介绍 3 2.1 概述 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 2.2 KingbaseES 数据库管理系统与 GIS 系统及数据的关系 . . . . . . . . . . . . . . . . . . . . . . . . . . . 3 第 3 章 基于 ArcGIS 平台的数据迁移到 KingbaseES 3.1 3.2 6 KDTS 工具迁移 GIS 数据 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1.1 KDTS 迁移步骤 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6 3.1.2 迁移结果验证 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20 3.1.3 常见问题汇总（FAQ） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23 ArcGIS/GeoScene 平台迁移 GIS 数据到 KingbaseES . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 3.2.1 利用 ArcGIS/GeoScene 软件的数据迁移 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24 3.2.2 迁移结果验证 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 3.2.3 常见问题汇总（FAQ） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 30 第 4 章 基于 SuperMap 平台的数据迁移到 KingbaseES 31 4.1 SuperMap 平台迁移 GIS 数据 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31 4.2 迁移结果验证 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34 4.3 常见问题汇总（FAQ） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 35 第 5 章 第三方通用格式 GIS 数据迁移到 KingbaseES 36 5.1 通用 GIS 数据文件的迁移入库 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36 5.2 迁移结果验证 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38 5.3 常见问题汇总（FAQ） . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39 版权声明 40 服务周期承诺 41 I 第 1 章 前言 1 第 章 前言 KingbaseES 是国内最早的拥有自主知识产权的国内数据库管理系统产品，具备出色的数据库产品研发和服务能 力。在地理信息行业有丰富的数据库应用案例支撑，具有快速准确的 GIS 数据及应用迁移能力。本文将着重介绍地 理信息空间数据 (GIS 数据) 的迁移方案。 前言部分包含以下主题： • 适用读者 • 相关文档 • 术语 • 手册约定 1.1 适用读者 KingbaseES 数据库概念面向所有使用 KingbaseES 的用户，主要是数据库管理员和应用程序开发人员。 1.2 相关文档 《KingbaseGIS 参考手册》 1.3 术语 ArcGIS 为美国 ESRI 公司的 GIS 平台软件； GeoScene 是易智瑞公司的 GIS 平台软件； SuperMap 是超图公司的 GIS 平台软件； QGIS 为开源的 GIS 平台软件； 1 第 1 章 前言 KDTS 为人大金仓的数据库迁移工具。 1.4 手册约定 本文档中可能出现“注意、提示、警告、另请参阅”等标志，它们所代表的含义如下： 注意: 用于突出重要/关键信息、最佳实践等。 提示: 用于突出小窍门、捷径等。 警告: 用于传递设备或环境安全警示信息，若不避免，可能会导致设备损坏、数据丢失、设备性能降低或其 它不可预知的结果。 另请参阅: 用于突出参考、参阅等。 以下程序代码书写约定适用于本文档： 符号 说明 [] 表示包含一个或多个可选项。不需要输入中括号本身。 {} 表示包含两个以上（含两个）的候选，必须在其中选取一个。不需要输入花括号本身。 | 分割中括号或者花括号中的两个或两个以上选项。不需要输入“|”本身。 ... 表示其之前的元素可以被重复。 斜体 表示占位符或者需要提供特定值的变量。 大写 表示系统提供的元素，以便与用户定义的元素相互区分。除出现在方括号中的元素外，应当按 照顺序逐字输入。当然，部分元素在系统中是大小写不敏感的，因此用户可以根据系统说明以 小写形式输入。 小写 表示由用户提供的元素。 2 第 2 章 KINGBASEES GIS 能力介绍 2 第 章 2.1 KingbaseES GIS 能力介绍 概述 以 5G、大数据中心、人工智能、工业互联网、物联网等为代表的新基建正成为我国经济发展的助推新引擎。作 为新基建底层的安全重要保障，地理信息技术也将大有可为。随着 GIS 在各个行业的规模化应用，围绕 GIS 相关的 技术研究、项目应用和市场推广应运而生，如各类 GIS 平台、中间件、存储等，同时对 GIS 核心的空间数据库，提 出了更高要求。 人大金仓作为国产数据库软件头部企业，拥有自主知识产权的数据管理软件产品 KingbaseES，该产品可广 泛应用于政务信息化、企业信息化和个人信息服务、自然资源、电力、金融等领域。金仓数据库管理系统 [简 称:KingbaseES] 可以替代国外数据库产品如 Oracle、MySQL 等，满足企事业单位管理信息系统、业务及生产系统、 决策支持系统等国产化数据库改造升级要求。 2.2 KingbaseES 数据库管理系统与 GIS 系统及数据 的关系 GIS 数据主要有结构化数据（如矢量数据）、非结构化数据（如栅格数据）和一些文件类型数据（各类切片缓存 数据）等。这些数据的存储关系，如下图所示： 3 第 2 章 KINGBASEES GIS 能力介绍 图 2.2.1: 数据库关系 国内外 GIS 平台大多数都采用上述架构存储空间数据, 并且在数据库类型中存储量最多、使用频度最广的是关 系型数据库，可以存储矢量数据、栅格数据、三维数据等 GIS 相关数据，如易智瑞的 GeoScene 平台和超图公司的 SuperMap 平台等，都是使用上图所展示的结构存储空间数据。 KingbaseES 拥有 KGIS 插件（以下简称 KGIS），具有空间数据库能力。KingbaseES+KGIS 正是满足上述需求 的关系型数据库系统, 下面将介绍 KingbaseES 数据库管理系统存储的空间数据的能力： 1) 矢量数据：如行政区划、建筑物、POI 点、道路等矢量数据，常见的矢量数据文件格式的扩展名有.dwg、 .dxf、.shp、.kml、.geosjon 等。其中.dwg、.dxf 为 CAD 的文件格式，.shp 为 ESRI 的矢量格式 (现已成国际标 准)。 数据存储方式 空间数据库将矢量数据文件转为数据库表存储，数据库表中会有专门的字段来储存矢量文件的空间位置，如下 图中的 geom 字段。 4 第 2 章 KINGBASEES GIS 能力介绍 图 2.2.2: 数据库存储空间数据 2) 栅格数据：KGIS 具有存储栅格数据的能力，栅格数据用像元值信息表达地理与特征，数据种类繁多，例如有 表示航片、卫片、高程或无人机等各类栅格文件，如 tif、img 等栅格数据。KGIS 可以直接存储数据的元数据等属性 信息，从而提高数据的查询效率，同时可以减少栅格数据存储读取的时间及空间成本。如影像的实际存储路径、中心 点、范围框、星历参数信息等。如下图所示： 图 2.2.3: 栅格数据存储属性表 3) 三维数据：KGIS 具有存储三维数据的能力，支持用于表示高度信息的”Z” 维度以及用于添加额外附加信息的” M” 维度三维、四维数据，同时还支持三维空间数据，如 TIN（不规则三角网）、POLYHEDRALSURFACE 在数据 库中对体积对象进行建模，KGIS 同时拥有许多函数可用于计算三维对象之间的关系。 注意: GIS 系统中的三维模型、倾斜摄影测量数据等，不采用这种方式存储，存储方式参见栅格数据存储。 5 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 3 第 章 基于 ArcGIS 平台的数据迁移到 KingbaseES 本章主要介绍基于 ArcGIS/GeoScene 平台的两种数据迁移方案，首先是基于 KDTS 的迁移，主要应用在数据图 层较多且数据体量巨大的情况, 另一种为利用 ArcGIS/GeoScene 平台的异构数据库迁移，主要是一些少量图层或者小 数据量的迁移需求。 3.1 KDTS 工具迁移 GIS 数据 3.1.1 KDTS 迁移步骤 下面讲述通过 KDTS 工具完成 GIS 空间数据库的迁移工作。 通过 KDTS 迁移 GIS 数据主要是基于两种情况： 其一，在 GIS 平台中，数据存储在 OracleSpatial 数据库中，且数据量巨大。上一章节所述的 GIS 平台适 合迁移如要素类、要素集、单个库等少量数据，当数据表体量巨大时，迁移过程较慢； 其二，原始数据存储在 OracleSpatial 数据数据库中，不论数据量的多少，但没有 GIS 平台支撑，只有备 份的数据库文件。 上述两种情况下，都可以采用 KDTS 数据迁移工具完成 GIS 空间数据库的迁移工作。 6 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.1.1: KDTS 迁移方案 1) 以迁移 Oracle 数据库数据为例（默认客户已安装 Oracle 软件） a. ArcGIS 连接源数据库与目标数据库 • 创建数据库连接 在开始菜单中启动 ArcMap 软件，在菜单栏点击“Arctoolbox”图标，在右侧显示的 Arctoolbox 栏中，选择数据管理工具-> 地理数据库管理-> 创建企业级地理数据库，界面截图如下： • Oracle 数据库（待迁移 GIS 数据的数据库）连接配置 7 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.1.2: 数据库配置 • KingbaseES 数据库连接配置 通过 ArcMap 菜单栏，打开 ArcCatalog 软件，在目录树中点击“数据库连接”->“添加 数据库连接”。在“数据库连接”对话框中设置 KingbaseES 连接参数, 其中需要注意的 是 instance 端口号不使用 5432 时，需要注明端口号；例如：192.168.4.30,5444。 图 3.1.3: 数据库连接 8 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES • 启动地理数据库 在 ArcCatalog 软件目录树中点选已连接的数据库，右键选择“启动地理数据库”功能, 源 数据库和目标数据库都要进行此操作。配置对应参数时，选择 ArcGIS 授权文件需要注意 只能用 *.ecp 文件。 2) KDTS 迁移 KDTS 迁移工具使用插件方式动态加载待迁移的数据库访问接口，方便用户定制和使用。支持同异构数据源之间 的数据迁移、支持结构迁移、支持全量数据迁移、支持列名映射，支持表数据的过滤迁移。 KDTS 迁移方案设置 下面介绍 KDTS 迁移工具的使用方案 (本文只描述 GIS 数据迁移使用的步骤, 详细 KDTS 使用参见《KDTS 迁 移工具使用指南》)： a. 新建源数据与目标数据连接 新建源/目标数据库连接，填写需要的相关数据源连接信息，包括：“连 接 名 称”、“数 据 库 类 型”、“数 据 库 版 本”、“服 务 器 地 址”、“端 口”、“用户名”、“密码”、“数据库”、“驱动”、“URL”、“连 接参数”。 • 连接名称： 输入自定义的连接名称，用于标注此数据源连接。 • 数据库类型： 在源数据库中支持“Oracle”、“MySQL”、“SQLServer”、“Db2”、“Gbase”、“PostgreSQL”、“DM”、“KingbaseES”数据库类型。 • 数据库版本： 9 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 与数据库类型相关联的迁移工具支持迁移的数据库版本。 • 服务器地址： 数据库所在服务器 IP 地址。 • 端口： 数据库端口号。 • 用户名： 操作数据库的用户名。 • 密码： 与操作数据库用户名相匹配的密码。 • 数据库： 操作数据库的名称。 • 驱动： 数据库驱动信息，会根据数据库类型及数据库版本动态调整。 • URL: 完成“服务器地址”、“端口号”、“数据库”的键入，如果源数据库为 Oracle 数据库，需要选择“SID”、“ServiceName”；如果源数据库为 KingbaseES 数据库，需要选择“JDBC”、“UnixDomainSocket”，选择完成后， 自动生成 URL。 SID：数据库实例名用于和操作系统进行联系的标识。 ServiceName：数据库服务名，对于集群环境来说，每个节点的 SID 可能不一 致，但 ServiceName 是一致的，简化客户端连接配置。 UnixDomainSocket 用于实现同一主机上的进程间通信。当迁移工具与目标数据 库（KingbaseES）安装在同一台 Linux 服务器上时可以使用，可提高数据传输 效率。 • 连接参数 根据数据库做相应适配，可自行添加或删除参数。 b. 创建数据迁移任务 新建迁移任务以进行数据迁移。新建任务包含四步：“选择数据源”、“选择 模式”、“选择迁移对象”、“配置参数”。 （1）选择数据源 填写自定义任务名称（任务名称不能重复），选择“源数据库”和“目标 数据库”，或者选择“新建数据源”后使用。 10 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.1.4: （2）选择模式 根据您的数据迁移所需选择对应模式（如需选择模式在系统模式中可选中“包含系统模式”复选框）的表、视图、序列、函 数、存储过程、程序包、同义词。当模式较多时也可以通过左上方的查询框进行检索。 请您至少选择一种模式，否则将收到错误提示，以至于不能完成新建任务。 在选择模式的前提下如您未选择“表”，即没有迁移对象，则系统将认为您不需要迁移对象，将提示您直接跳过“选择迁移 对象”进入“配置参数”。 11 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.1.5: （3）选择迁移对象 通过已选模式选择您需要迁移数据的表，模式较多时可在已选模式搜索框内输入模式名关键字进行快速检索。 图 3.1.6: 可迁移此模式下全部表，也可以指定或排除部份表，当您选择“包含指定表”或“排除指定表”时，请您通 过“从列表选择”、“从文件导入”或者在输入框内输入表名将数据添加到包含列表中，如您未添加数据，则会提示 错误导致无法进行下一步并完成新建任务。 12 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 当您点击“包含指定表”时也可选择多种方式。可直接在输入框内填写表名， 多个表用“，”分割，回车确认；“从列表选择”可在模式中选择指定表；如 您要“从文件导入”，可点击“下载导入模板”，根据导入模板规则填写，然 后从文件导入该模板。当您需要“排除指定表”时，同指定部份表相同操作， 但结果相反。 从列表选择表时，可选择对应模式、检索表名关键字、数据条数限制进行快速 13 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 检索对应的表。点击“添加”按钮后加入到已选列表，当您想要移除部份表时 可以选择对应的表点击“移除”按钮取消表。选择完成后点击确定。 图 3.1.7: （4）配置参数 您可以通过对参数的更改获得预估的数据迁移结果。其中迁移配置包括“表默认处理方式”、“表排序依据”、“表数据读取和 写入”、“大表拆分阈值依据”、“非对象设置”、“设置表名”、“列名大小写”、“数据库连接数设置”。 14 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 数据类型配置包括“源数据类型”、“目标数据类型”、“长度限制”。 • 表默认处理方式： 包括两个复选框项（“建表/重建表”、“导入数据”），迁移到 KingBaseES 数据库是否需要建表或者重建表，以及是否只迁移表结构而不迁移数据的选 择，根据您的需求选择合适的选项（默认是全选）。 • 表排序依据： 15 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 对迁移的表进行排序，可通过“按行数和大字段大小交替”、“行数”、“大 小进行排序”（默认是按行数和大字段大小交替）。 • 表数据读取和写入： 对表数据的读取和写入制定规则，可操作项包括“源库游标读取记录数”（默 认是 100）、“批量写入目标库记录数”（默认是 1000）、“每次批量提交大 小”（默认是 100MB）、“LOB 字段预读取大小”（默认是 4000Byte）。 • 大表拆分阈值依据： 对大表进行拆分迁移，设置拆分界限。 操作项 备注 拆分阈值行数 根据行数拆分大表进行迁移 拆分阈值大小 根据表大小拆分进行迁移 拆分最大块数 设置块数上限 含大对象表游标读取记录数 设置游标读取记录数上限 • 非对象设置： 其 中 包 含 “主 键”、“检 查 约 束”、“唯 一 约 束”、“外 键”、“索 引”、“触 发 器”、“自 动 转 换 对 象 名”、“注 释”。 您 可 以 根 据 自 己 的 需求选择是否迁移这些非对象数据（默认是全选）。 • 设置表名、列名大小写： 您根据迁移需求将迁移表的表名和列名改为大写、小写或者与源数据库相同 （默认是不变）。 • 数据库连接数设置： 您可以限制迁移程序对源数据库和目标数据库的最大连接数（默认是 100）。 （5）保存或保存并迁移 您可将此任务作为预迁移任务点击“保存”，或者作为执行任务点击 “保存并迁移”。 16 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES • 迁移完成： 迁移结束“状态”栏显示“完成”，则迁移任务成功。 • 迁移失败： 迁移结束“状态”栏显示“失败”，则迁移任务失败。失败后可点击详情查看 17 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 日志有助于解决问题。 c. 迁移后注册数据 (参见《迁移工具（KDTS）使用指南》) ArcGIS/GeoScene 平台的数据迁移后，必须要进行注册，后续应用才能正常使用。 （1） 迁 移 后， 在 形 如 “result/ 2021-12-02_15-15-15/ SDE/ AcrpyRegisterScript/” 目 录 下的 acrpyRegisterWithGeodatabase.py 文件拷贝到 ArcGIS 所 在 机 器 上， 放 到 形 如 “c:Python27ArcGIS10.8”目录下，如图： 18 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES （2）查看 ArcMap 的 kingbase 数据库连接信息，并拷贝。如下图： 19 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES （3）编辑 acrpyRegisterWithGeodatabase.py 文件，将上一步复制的内容粘贴到以下位置，保 存文件，如下图所示： （4）执行 acrpyRegisterWithGeodatabase.py 脚本，将表注册到 ArcGIS 地理信息库。 （5）执行完成后使用 ArcMap 软件进行验证，能否正常显示图层信息。 至此，完成利用迁移工具的 GIS 数据迁移。 3) 案例说明 案例一 通过模拟 10 个省市亿级的地类图斑数据，使用金仓 KDTS 工具完成 GIS 数据迁移，迁移时间为 1 个小时左右。 KDTS 工具迁移效率较传统方法提升 4 到 5 倍。 3.1.2 迁移结果验证 1) 可视化校验 20 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES a. 显示验证：ArcMap 软件中，将迁移后的数据拖到窗口。数据展示如下图： 图 3.1.8: 数据显示 b. 操作验证：验证数据正确性，采用对迁移数据进行增、删、改、查等功能验证，如进行函数分析判 断结果正确性。 c. 应用程序验证：运行与迁移数据相关的应用程序，验证数据正确性。 2) 数据库对比校验 迁 移 后 的 结 果 可 以 查 看 迁 移 结 果，“迁 移 结 果” 功 能 的 工 作 区 包 括 “任 务 执 行 批 次”、“迁 移 对 象”、“总 数”、“成 功 数”、“失 败 数”、“略 过 数”、“操 作”。 您 可 以 查 看 历 史 迁 移 任 务 执 行 的每次记录，以及每次迁移的对象、成功数、失败数、查看失败任务的错误日志。 21 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 迁移成功对象 迁移失败对象 迁移略过对象 22 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.1.9: 上述两类数据校验方式完成，才能保证数据迁移工作完成，迁移结果正确。 3.1.3 常见问题汇总（FAQ） 1) 数据迁移中, 复杂表和约束迁移失败问题。 答：在 KingbaseES 之间可以迁移的数据库对象包括：表、视图、存储过程、函数、程序包、触发器、索 引、主外键、非空约束、检查约束、唯一约束、缺省值。若目的库中存在与要迁移的存储过程、函数、触 发器或程序包相同的名称, 数据迁移工具会将其删除后在进行迁移。 其他数据库向 KingbaseES 可以迁移的数据库对象包括：表、索引、主外键、非空约束、检查约束、唯一 约束、缺省值。不支持函数索引和表达式索引的迁移；不支持聚集索引的迁移。 2) 数据迁移工具的数据迁移中, 将其它数据库的表导入到 KingbaseES V9 数据库时,KingbaseES 数据库并没有与 要导入的表重名的表, 为什么迁移日志会报告表重名错误, 从而导致迁移失败？ 答：在 KingbaseES 中同一个模式下表、视图、序列都使用同一个命名空间，即表、视图和序列之间不可 以重名，否则后创建的表会将覆盖已经存在的表。 3) 源库为 KingbaseES V7，迁移中文表中文乱码问题。 答：编辑 KingbaES V7 的数据库连接，添加参数 clientencoding=UNICODE, 保存。打开对应的迁移任 务，刷新源库节点，即可。 4) 数据迁移中, 复杂表和约束迁移失败问题。 答：当迁移 Oracle 的复杂表和约束时，如果总是遇到错误，则可能是因为 KingbaseES 自带的 Oracle JDBC 驱动程序版本与 Oracle JDBC 版本不兼容。此时，用户可用 Oracle 数据库安装目录 JDBC/lib 23 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 文件夹下的 JDBC 驱动程序，替换 $KINGBASE_HOME/plugins/database/Oracle 目录下的 JDBC 驱动 程序，然后重新迁移。 Oracle 数据库向 KingbaseES 可以迁移的数据库对象包括：表、索引、主外键、非空约束、检查约束、唯 一约束、缺省值。需要注意的是：不支持函数索引和表达式索引的迁移；不支持聚集索引的迁移。 5) 数据迁移中, 使用【追加数据】的迁移方式会导致迁移失败问题。 答：为了提高迁移速度，在【配置】对话框中，将【一次批量提交记录个数】设置为 50000。在追加数据 时，如果在一次提交的 50 条记录中，如果有某些记录的主键值与已存记录的主键值相同，会导致 50 条记 录全部迁移失败。因此在使用【追加数据】的迁移方式时，建议将【一次批量提交记录个数】设置为 1， 这样可以使主键值重复的记录迁移失败，主键值不重复的记录迁移成功。 6) 迁移数据时报错“Caused by: com.kingbase8.util.KSQLException: ERROR: value too long for type character varying(50)” 答： 原 因： 源 库 的 服 务 器 参 数 char_default_type=char， 而 目 标 库 KingbaseES 的服务器参数 char_default_type=byte，造成部分数据迁移到 v9 之后溢出了。 修改【首选项】-【迁移配置】选项卡的“设置 char 默认类型”，选择“char”或者“与源库保持一 致”。保存后重新迁移出错的表。 7) 迁移工具可以迁移那些 GIS 数据类型？ 答： 在 迁 移 设 置 过 程 中， 设 置 迁 移 的 数 据 类 型，KDTS SDO_GEOMETRY 数 据 类 型。 其 中 工具能够迁移 ST_GEOMETRY 为 ArcGIS ST_GEOMETRY 和 平 台 生 成 的 数 据 类 型， SDO_GEOMETRY 为 Oracle 的数据类型。 3.2 ArcGIS/GeoScene 平台迁移 GIS 数据到 KingbaseES 3.2.1 利用 ArcGIS/GeoScene 软件的数据迁移 本节主要介绍利用 ArcGIS 软件进行向 KingbaseES 数据库迁移 GIS 数据的方案，数据迁移前需要安装 KGIS 插 件，安装方法参见《KingbaseGIS 参考手册》。 1) 迁移对象说明 • 文件地理数据库和个人地理数据库，即 MDB 或者 GDB 文件。 • 商用数据库：PostgreSQL、Oracle spatial、DM、MYSQL、SQL Server 等。 2) 以迁移 Oracle 数据库数据为例（默认客户已安装 Oracle 软件） a. ArcGIS 连接源数据库与目标数据库 • 创建数据库连接 24 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 在开始菜单中启动 ArcMap 软件，在菜单栏点击“Arctoolbox”图标，在右侧显示的 Arctoolbox 栏中，选择数据管理工具-> 地理数据库管理-> 创建企业级地理数据库，界面截图如下： • Oracle 数据库（待迁移 GIS 数据的数据库）连接配置 图 3.2.1: 数据库配置 • KingbaseES 数据库连接配置 通过 ArcMap 菜单栏，打开 ArcCatalog 软件，在目录树中点击“数据库连接”->“添加 数据库连接”。在“数据库连接”对话框中设置 KingbaseES 连接参数, 其中需要注意的 是 instance 端口号不使用 5432 时，需要注明端口号；例如：192.168.4.30,5444。 25 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.2.2: 数据库连接 • 启动地理数据库 在 ArcCatalog 软件目录树中点选已连接的数据库，右键选择“启动地理数据库”功能, 源 数据库和目标数据库都要进行此操作。配置对应参数时，选择 ArcGIS 授权文件需要注意 只能用 *.ecp 文件。 b. 数据迁移 • 上步操作中已将 Oracle 和 KingbaseES 数据库同时与 ArcGIS 平台连接，下面介绍如何 将 GIS 数据迁移到 KingbaseES 数据库。 连接后的数据库如下图： 26 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.2.3: 数据目录树 在 Oracle 数据库中选择要迁移的数据要素集，右键 copy； 27 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.2.4: 数据拷贝 • 选择“数据库连接”中已连接的 KingbaseES 数据库, 右建粘贴, 弹出下图界面, 选择 ok。 28 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 图 3.2.5: 数据迁移 显示数据迁移进度条, 如下图: 迁移成功后如下图所示: 完成数据库迁移。 至此，完成基于 ArcGIS/GeoScene 平台的数据迁移。如果需要迁移的数据库具有少量的要素 表，或者数据量较少的空间数据可以采用这种方法，但一旦空间数据体量大空间表众多，建 议使用 KDTS 迁移工具批量迁移数据。 29 第 3 章 基于 ARCGIS 平台的数据迁移到 KINGBASEES 3) 案例介绍 案例一 a. 项目应用环境：ArcGIS，X86，Linux。 b. 数据迁移：采用特有的空间数据全量离线迁移工具，实现 Oracle Spatial 到人大金仓空间数据库的快 速自动化平滑迁移，48 小时完成 3TB+Oracle Spatial 数据迁移。 c. 稳定性：数据库并发连接 1000+，在大并发高吞吐量业务压力下，数据库稳定运行。 d. 性能：提供经优化的空间数据索引，并对空间函数进行深度优化，使得空间数据处理性能提升 80%。 3.2.2 迁移结果验证 1）可视化校验 a. 显示验证：ArcMap 软件中，将迁移后的数据拖到数据窗口。数据展示如下图： 图 3.2.6: 数据显示 b. 操作验证：验证数据正确性，在 ArcMap 软件中采用对迁移数据进行增、删、改、查等功能验证， 如利用函数分析验证结果正确性。 c. 应用程序验证：运行与迁移数据相关的应用程序，验证数据正确性。 3.2.3 常见问题汇总（FAQ） 1) 目前可以迁移哪些类型数据库中的 GIS 数据？ 答：可以迁移通过 ArcGIS 存储的 ST_GEOMETRY 类型的数据，数据库类型不限。如 PostgreSQL、Oracle spatial、DM、MYSQL、SQL Server 等。 30 第 4 章 基于 SUPERMAP 平台的数据迁移到 KINGBASEES 4 第 章 基于 SuperMap 平台的数据迁移到 KingbaseES 本章主要介绍基于 SuperMap 平台的异构数据库之间 GIS 数据迁移方案。 4.1 SuperMap 平台迁移 GIS 数据 目前，KGIS 插件与 SuperMap 产品已完成适配，包含 SuperMap iDesktop、SuperMap iServer、SuperMap iEdge 等。 SuperMap 利用自主的空间数据引擎，将 GIS 数据存储在如 OracleSpatial、MySQL、DB2、Kingbase ES、PostgreSQL 等数据库，KGIS 可以存储从各种数据库迁移到 KingbaseES 的 GIS 数据。 本节主要介绍利用 SuperMap 软件进行向 KingbaseES 数据库迁移 GIS 数据的方案，数据迁移前需要安装 KGIS 插件，安装方法参见《KingbaseGIS 参考手册》。 1）以迁移 Oracle 数据库数据为例（默认客户已安装 Oracle 软件）。 a. 在 SuperMap 软件的“工作空间管理器中”，右击“数据库”，然后点击“打开数据库型数据源” 打开，分别连接 Oracle 和 KingbaseES，如下图： • SuperMap 连接 Oracle 数据库： 31 第 4 章 基于 SUPERMAP 平台的数据迁移到 KINGBASEES 输入正确的实例名，用户、用户密码即可，如上图所示。 • SuperMap 连接 KingbaseES 数据库： 图 4.1.1: 数据库配置 32 第 4 章 基于 SUPERMAP 平台的数据迁移到 KINGBASEES 输入正确的实例名，用户、用户密码即可，如上图所示。 b. 待迁移的数据在“工作空间管理器”中显示，如下图所示： 图 4.1.2: 数据查看 c. 选中需要迁移的数据，拖拽到 KingbaseES 目标库中，松开鼠标，弹出“复制数据集”对话框, 点击 “确定”完成数据迁移。 2）将工作空间中第三方通用格式的数据迁移至 KingbaseES。 选中需要迁移的数据，拖拽到 KingbaseES 目标库中，松开鼠标，弹出“复制数据源”对话框，点击“确 定”，开始迁移，直至完成数据迁移。如下图所示: 33 第 4 章 基于 SUPERMAP 平台的数据迁移到 KINGBASEES 图 4.1.3: 数据迁移 待进度条走完，数据迁移成功。 注意: 迁移数据时，可以将所有数据表迁移到 KingbaseES 库中，同时也可以将数据迁移到一个固定的表 中。 至此，完成基于 SuperMap 平台的数据迁移。 4.2 迁移结果验证 1）可视化校验 a. 显示验证：SuperMap 软件中，将迁移后的数据拖到数据窗口。 b. 操作验证：验证数据正确性，采用 SuperMap 软件对迁移数据进行增、删、改、查等功能验证，如函数分析判 断结果正确性。 c. 应用程序验证：运行与迁移数据相关的应用程序，验证数据正确性。 34 第 4 章 基于 SUPERMAP 平台的数据迁移到 KINGBASEES 4.3 常见问题汇总（FAQ） 1) 使用 Super Map 软件，KingbaseES 都可以迁移那些异构数据库？ 答：只要超图的 SuperMap 软件可以连接的关系型数据库，KingbaseES 都可以完成迁移。 2) 超图的 UDBX 数据可以导入 KingbaseES 吗？ 答：UDBX（Universal Spatial Database Extension）是一种文件型的空间数据格式，支持全空间数据 的高效存储与管理，只要使用超图软件打开就可以迁移到 KingbaseES。 3) 在迁移超图数据时，会遇到表名大小写混合等情况，是否能够正常迁移数据，KingbaseES 是否支持？ 答：KingbaseES 支持表名及字段名大小写混合等各种情况的数据存储。 35 第5章 5 第 章 第三方通用格式 GIS 数据迁移到 KINGBASEES 第三方通用格式 GIS 数据迁移到 KingbaseES 本章主要介绍如何将第三方通用 GIS 数据的迁移入库到 KingbaseES，包括矢量、栅格等数据。 通用 GIS 数据文件的迁移入库 5.1 本节主要介绍将矢量数据（Esri Shapefile 格式，简称 shp）和栅格数据（TIF 格式）迁移到 KingbaseES 的方 案。 • 矢量数据：提供两个转换工具，shp2pgsql 和 pgsql2shp。 Esri Shapefile 是 ESRI 公司的矢量数据格式，同时也是通用的数据格式之一，其由多个文件组成：SHP 描述几 何特征；SHX 描述形状的位置和索引；DBF 描述属性数据等。 1) shp2pgsql 和 pgsql2shp shp2pgsql 和 pgsql2shp 是 KGIS 对 shapefile 文件与数据库之间进行转换的工具，下面以 shp2pgsql 为例 说明。 使用方法如下： shp2pgsql -s 3857 -a -W GBK 文件名.shp 命名空间名. 表名 | psql -h localhost -U kingbase -d 数据库名 -p 5432 其中，命令中的参数含义如下： 参数 -s 含义 空间参考标识符（SRID） (d|a|c|p) 这些是互斥选项, 只能选择其中之一: -d 重新建立表，并插入数据 -a 在同一个表中增加数据 -c 建立新表，并插入数据 (缺省) -p 只创建表 36 第5章 -g 指定要创建的表的空间字段名称 (在追加数据时有用) -D 使用 dump 方式，比缺省生成 sql 的速度快 -G 使用类型 geography -k 保持标识符（列名，模式，属性）大小写。 -i 将所有整型都转为标准的 32-bit 整数 -I 在几何列上建立 GIST 索引 -S 生成简单几何，而非 MULTI 几何 -t 指定几何的维度 -w 指定输出格式为 WKT -W 输入的 dbf 文件编码方式 -N 指定几何为空时的操作 -n 只导入 dbf 文件 -T 指定表的表空间 -X 指定索引的表空间 -? 帮助 第三方通用格式 GIS 数据迁移到 KINGBASEES • 栅格数据： 1) raster2pgsql KGIS 提供支持通用栅格数据文件的迁移，栅格数据格式为 GDAL 支持的数据格式，KGIS 提供 raster2pgsql 工具，用于栅格数据的导入导出，下面以 raster2pgsql 说明。 使用方法如下： raster2pgsql [] -s