简介人大金仓《KingbaseES GIS数据迁移方案V8.6》是一份面向数据库管理员和GIS开发者的官方技术文档重点解决将ArcGIS、GeoScene、SuperMap等主流GIS平台中的空间数据迁移至KingbaseES数据库的问题。文档详细介绍了KingbaseES对矢量、栅格等空间数据类型的支持及与GIS系统的集成方式并围绕KDTS迁移工具、ArcGIS/GeoScene软件操作、SuperMap平台API等路径给出完整的迁移步骤、结果验证方法和常见FAQ同时覆盖第三方通用格式数据的迁移入库思路。资源为单个PDF文件大小2.76MB排版清晰、目录完整方便离线查阅与快速检索。已有133人学习适合正在推进GIS国产化替换、需要掌握KDB迁移流程或排查迁移异常的技术人员。通过该文档可系统了解从源端配置、数据抽取转换加载到迁移后校验的完整链路减少试错成本。1. 人大金仓 KingbaseES GIS 数据迁移方案从 Oracle 到国产库关键是注册那一步信创类 GIS 项目里最尴尬的场景不是人大金仓 KingbaseES 能不能存空间数据而是数据从 Oracle 迁过去之后ArcGIS 打开要素类直接报未注册。这份 V8.6 版 GIS 数据迁移方案最重要的价值就是点破了迁移闭环里最后一步注册。方案覆盖 KDTS 工具批量迁移、ArcGIS/GeoScene 直连迁移、SuperMap 迁移以及 shp/tif 等通用格式入库读者定位是负责落地迁移的 DBA 和应用开发。照着走能完整迁完数据还能在平台上正常显示适合正在做自然资源、政企 GIS 国产化替换的团队。2. KGIS 空间能力矢量、栅格、三维数据在 KingbaseES 里怎么存2.1 空间数据库在 GIS 架构中的位置GIS 系统无论是 ArcGIS、GeoScene 还是 SuperMap绝大多数都遵循同一套存储架构GIS 软件负责数据展示和分析关系型数据库负责空间数据的持久化。文档里那张数据库关系图展示的就是这种分层关系——平台软件通过数据库中间件访问空间库库里存的是要素类、栅格、三维对象。KingbaseES 加了 KGIS 插件之后就在这个层次上承接了原本属于 Oracle、MySQL 的存储职责。文档里明确给出了一句话国内外 GIS 平台大多数都采用上述架构存储空间数据并且在数据库类型中存储量最多、使用频度最广的是关系型数据库。这句话决定了迁移方案的底层逻辑——你迁移的不是文件而是数据库里的表和空间字段所以迁移工具要能理解空间类型迁移完成后要能让 GIS 平台重新识别这些数据。KGIS 的能力覆盖了三类数据矢量、栅格、三维。每一类的存储方式完全不同这也是迁移时需要分别对待的原因。矢量数据转表加空间字段栅格数据存元数据和范围信息三维数据通过 Z/M 维度和三维几何类型建模。下面分别讲。2.2 矢量数据从 shp 文件到数据库表加空间字段矢量数据的典型形态是行政区划、道路、POI、建筑物这类带明确边界的对象常见文件格式包括 .shp、.dwg、.dxf、.kml、.geojson。空间数据库的做法不是把文件整体塞进库而是把矢量文件转成数据库表一个图层对应一张表表里用专门的字段保存空间位置。以 shp 为例属性字段如 name、type 映射成普通列几何部分映射成一个 geometry 类型的列通常命名为 geom。文档明确写了数据库表中会有专门的字段来储存矢量文件的空间位置如下图中的 geom 字段。这意味着在 KDTS 迁移时空间字段必须被正确识别并转换而不是当成一个普通二进制列搬过去。这也是为什么文档要求在 ArcGIS 中先创建企业级地理数据库——只有让源库和目标库都具备空间数据的元数据语义迁移过程才能保留图层注册信息和空间索引。在 KingbaseES 里一个矢量表的结构大概长这样CREATE TABLE district ( id integer, name varchar(100), geom geometry(Geometry, 4490) -- 空间字段4490 为 CGCS2000 坐标系 SRID );代码逻辑id 和 name 是属性列geom 是空间列。geometry(Geometry, 4490) 里的 4490 是数据库里记录的 SRID它告诉 GIS 平台这批数据是 CGCS2000 坐标系。如果迁移后 SRID 丢了ArcGIS 会提示坐标系未知但仍能显示如果 SRID 值本身写错坐标会偏移。迁移前先确认源数据的坐标系投影是省后患的关键一步。提示空间字段的 SRID 在迁移前后必须一致。迁移前先确认源数据坐标系国内一般用 CGCS2000EPSG:4490迁移后在目标库抽查几个要素的坐标值能及时发现坐标系漂移。2.3 栅格与三维存元数据、支持 Z/M 维度栅格数据在 GIS 里是另一大类影像、DOM、DEM、无人机航片都算常见格式有 tif、img。KGIS 处理栅格的方式比较聪明不把整幅影像像像素块一样全量塞进数据库而是存元数据加属性信息。文档原文提到KGIS 可以直接存储影像的实际存储路径、中心点、范围框、星历参数等信息目的是提高查询效率减少栅格数据的存储读取时间和空间成本。这套机制意味着迁移栅格数据时数据库表里存的更多是指向原始文件的描述信息而不是影像本身。所以做栅格迁移时除了导表还要确保原始文件路径在迁移后仍然可达否则 GIS 平台能读到范围框却打不开影像内容。具体的表结构文档没有展开但实操中的常见做法是属性表记录文件路径和范围影像文件按原目录结构整体拷贝两者配合使用。三维数据方面KGIS 支持带 Z 维度高度和 M 维度附加属性的数据并支持 TIN不规则三角网和 POLYHEDRALSURFACE 做体积对象建模。文档特别加了一条注意三维模型、倾斜摄影测量数据不采用这种方式存储存储方式参照栅格数据。这个边界要记住迁移倾斜摄影数据时别指望它变成三维要素类。3. 用 KDTS 迁移 Oracle 空间库从创建企业级地理数据库到参数调优3.1 前置操作在 ArcGIS 里创建并启动企业级地理数据库KDTS 这条路适合两类场景一类是数据存储在 Oracle Spatial 里且体量巨大单靠 GIS 平台迁移太慢另一类是原始数据就在 Oracle Spatial 里但项目上没有 GIS 平台只有备份的数据库文件。这两种情况都可以用 KDTS 做批量迁移。迁移的第一步不是打开 KDTS而是先在 ArcGIS 里把源库和目标库都初始化成企业级地理数据库。在 ArcMap 菜单栏打开 Arctoolbox选择数据管理工具 - 地理数据库管理 - 创建企业级地理数据库。这里有两个关键点第一源数据库是 Oracle连接配置里要填实例名SID或服务名ServiceName第二目标数据库是 KingbaseES需在 ArcCatalog 里右键数据库连接 - 添加数据库连接填写连接参数。文档特别提醒instance 端口不是默认 5432 时必须写清楚比如 192.168.4.30,5444 这种写法逗号后面是端口。接下来在 ArcCatalog 目录树里选中已连接的数据库右键选择启动地理数据库源库和目标库都要执行这一步。配置参数时ArcGIS 授权文件只能用 .ecp 格式。这一步没做到位后面 KDTS 迁移完的数据在 ArcGIS 里多半打不开。3.2 新建源/目标数据库连接参数逐个对齐打开 KDTS第一步是新建源数据连接和目标数据连接。连接表单里的字段比较多逐个说清楚避免迁到一半发现连错了库。参数说明取值建议连接名称自定义用于标注数据源写明来源或用途比如 oracle-gis-source数据库类型源库支持 Oracle、MySQL、SQLServer、Db2、Gbase、PostgreSQL、DM、KingbaseES源按实际情况选目标选 KingbaseES服务器地址数据库所在机器 IP确保网络可达端口数据库监听端口非默认端口要写完整用户名/密码操作数据库的账号建议用专用迁移账号避免权限不足数据库要迁移的库名目标库建议按 GIS 库标准命名驱动随数据库类型和版本自动调整一般不用手动改URL自动生成源为 Oracle 时选 SID 或 ServiceName集群环境优先 ServiceName连接参数适配具体数据库按需增减URL 的生成逻辑值得单独说一句。如果源库是 Oracle需要选择实例名 SID还是服务名 ServiceNameSID 是数据库实例在操作系统里的标识集群里每个节点的 SID 可能不一致ServiceName 是整个集群统一的服务名对客户端来说连接更稳定。如果目标库 KingbaseES 和 KDTS 装在同一台 Linux 服务器上可以选择 UnixDomainSocket 走本地进程间通信省掉网络开销数据量大时吞吐会好不少。我一般会优先选这项。# 源库 Oracle使用 ServiceName 方式端口 1521 jdbc:oracle:thin://192.168.4.30:1521/ORCL # 目标库 KingbaseES端口 54321 jdbc:kingbase8://192.168.4.30:54321/kgis代码逻辑上面是连接串的形态示例实际由 KDTS 根据数据库类型和版本自动生成。Oracle 选 ServiceName 时 URL 是 //ip:port/service_name 的写法目标库可以选 JDBC 或 UnixDomainSocket 两种模式同机部署优先选 UnixDomainSocket。端口、服务名、库名这三项填错连接测试阶段就会暴露不用等迁移任务跑起来。3.3 创建迁移任务模式、对象、参数三步走完新建任务要依次走四步选择数据源、选择模式、选择迁移对象、配置参数。选择数据源时填任务名称然后指定前面建好的源和目标连接任务名不能重复。选择模式这一步至少要勾选一个模式否则直接报错。如果系统模式下有需要迁移的内容可以勾选包含系统模式把系统模式也列出来。确定模式后下一步就是选择迁移对象可以迁移该模式下全部表也可以选包含指定表或排除指定表做部分迁移。指定表的方式有三种在输入框内直接填表名多个表用逗号分隔从列表选择从文件导入模板。如果想排除某些大表或临时表就用排除指定表操作逻辑相反但同样支持从列表、文件、输入框三种方式。迁移对象选完后进入配置参数页这里直接决定迁移的效率和成功率参数含义如下参数含义默认值表默认处理方式建表/重建表和导入数据两个开关均勾选表排序依据按行数和大字段大小交替、按行数、按大小交替源库游标读取记录数每次从源库读取的记录条数100批量写入目标库记录数单次批量写入条数1000每次批量提交大小事务提交的数据量100MBLOB 字段预读取大小大字段含空间字段预读长度4000Byte大表拆分阈值依据按行数或按表大小拆大表无拆分最大块数拆分块数上限无含大对象表游标读取记录数含 LOB 的表游标读取上限无非对象设置主键、约束、外键、索引、触发器、注释等均勾选表名/列名大小写不变、大写、小写不变数据库连接数限制源和目标的最大连接数100这批参数里最容易被忽略的是源库游标读取记录数和批量写入目标库记录数。默认 100/1000 对普通表没问题但遇到单表几千万行的空间数据游标读 100 条会导致网络往返极其频繁。常见做法是把游标读取记录数提到 1000 到 5000批量写入提到 5000 到 10000同时观察目标库的 IO 和内存压力不要一次拉太高。LOB 字段预读取大小默认只有 4000Byte空间字段如果涉及大对象偏小会导致读取次数成倍增加。大表拆分是 KDTS 解决大数据量迁移的核心机制。按行数拆分就是超过阈值的表拆成多个批次迁移按大小拆分则是按表占用的物理空间阈值来拆。含大对象表的游标读取记录数可以单独设置防止一条几 MB 的 LOB 记录把内存打满。这几个参数建议在迁移前先跑一个抽样表测试根据单条记录的平均大小来定阈值不要直接沿用默认值。非对象设置默认全选主键、外键、索引、触发器、注释都会带过去。如果迁移后打算在 GIS 平台里重建空间索引可以取消勾选索引让平台自己建速度通常更快。配置完成后可以选保存把任务存成预迁移任务也可以直接保存并迁移立即执行。迁移结束后看状态栏完成就是成功失败则点详情看日志。日志里的错误信息是排查问题的主要依据建议把日志目录保留下来尤其当源库表结构不规整时后期核对差异全靠它。3.4 迁移后注册不执行这一步 ArcGIS 不认你的数据KDTS 把表和空间字段搬过去之后还有一个必须在 ArcGIS 端完成的动作注册。文档的原话是ArcGIS/GeoScene 平台的数据迁移后必须要进行注册后续应用才能正常使用。注册的目的是让 ArcGIS 把迁移后的表识别为企业级地理数据库中的合法数据集生成平台需要的注册信息。不做注册数据在库里但 ArcGIS 加载时会报错或看不到。操作方式迁移完成后在结果目录下找到形如 result/2021-12-02_15-15-15/SDE/ArcPyRegisterScript/ 目录里的 acrpyRegisterWithGeodatabase.py 脚本把它复制到 ArcGIS 所在机器放在 c:\Python27\ArcGIS10.8 之类 ArcGIS 自带的 Python 目录下然后在命令行里执行# 进入 ArcGIS 自带的 Python 环境目录后执行注册脚本 python acrpyRegisterWithGeodatabase.py --workspace D:\connections\kingbase_es.sde --user SYSTEM --password ********代码逻辑workspace 指向保存好的 KingbaseES 数据库连接文件user 和 password 是目标库管理账号。脚本会把迁移后的数据逐条注册进地理数据库的系统表中。注意不同的 ArcGIS 版本脚本参数可能略有差异执行前可以先不带参数跑一次看 help 输出。我习惯把这个脚本连同连接文件一起放在迁移结果目录里存档换机器执行时直接拷贝一整套避免漏掉某个文件导致注册失败。4. ArcGIS/GeoScene 直接迁移小数据量场景的另一种选择4.1 什么时候别用 KDTS图层少、数据量小、有平台环境KDTS 适合的场景是数据量大、图层多、或没有 GIS 平台环境但它并不是唯一选择。文档在第三章里同时给了另一条路利用 ArcGIS/GeoScene 平台本身做异构数据库迁移主要面向少量图层或小数据量的需求。两条路的选择标准其实很直白——如果项目里已经有 ArcGIS/GeoScene 环境且待迁移对象只有几个图层、几十万行数据直接在平台内完成复制比搭一套 KDTS 迁移任务更快也更容易调试。反过来当数据表体量巨大时平台内逐个图层的迁移过程会很慢甚至会因为平台自身的组织方式导致效率直线下降。文档里那句当数据表体量巨大时迁移过程较慢说的就是这个意思。所以先判断体量再决定走哪条路是迁移方案设计的第一步。4.2 平台内迁移的操作路径直接迁移的常规路径是把源库比如 Oracle Spatial和目标库KingbaseES都添加到 ArcCatalog 的数据库连接里然后在目录树中把源要素类、要素集或整个库拖到目标连接下或者在 ArcMap 里用数据管理工具中的复制/粘贴功能完成迁移。ArcGIS 的企业级地理数据库迁移会自动处理空间字段类型、坐标系和空间索引的重建这是它比 KDTS 省心的地方。不过要注意源库和目标库在企业级地理数据库的版本、空间类型上要匹配。文档中专门提到ArcGIS/GeoScene 平台支持通过软件的数据迁移功能完成迁移并且做了一个重要的限定此方案适合要素类、要素集、单个库等少量数据数据量大时不推荐。换句话说平台直接迁移的适用边界是对象少、数据小而不是功能上做不到超了体量就容易卡在迁移时长和内存占用上。4.3 两条路的取舍对照把两条路的适用边界放在一起看更清楚对比项KDTS 工具迁移ArcGIS/GeoScene 直接迁移数据量单表亿级、整套库少量图层、小数据量图层数量几十上百个均可建议几个到十几个环境要求有 KDTS 即可必须有 ArcGIS/GeoScene 环境空间类型适配依赖类型映射配置平台自动处理迁移速度批量并行快逐对象复制受平台限制迁移后注册需要手动执行脚本平台写库时自动注册适用典型场景Oracle 空间库整体替换日常增量或单图层迁移这里有个细节容易翻车用 ArcGIS 直接迁移时如果源库是 Oracle Spatial 而目标库是 KingbaseES 的 KGIS两个库的空间类型存储机制不同平台自身能否正确转换取决于 ArcGIS 是否提供了对应的空间数据支持。在地理数据库连接创建时就要确认目标库被识别为可写企业级地理数据库而不是当成普通数据库连接。识别不成功迁移菜单里要素类的复制选项是灰的。5. SuperMap 与第三方通用格式shp、tif 直接入库的三条路径5.1 SuperMap 平台通过数据源连接把数据集迁入 KingbaseESSuperMap 平台的数据迁移思路和 ArcGIS 类似都是通过数据库型数据源来完成。常见做法是在 SuperMap iDesktop 里新建一个数据库型数据源数据源类型选择 KingbaseES填写服务器地址、端口、数据库名和账号建立连接后把工作空间里的数据集导入数据源或者把已有数据源的数据集复制到 KingbaseES 数据源。SuperMap 数据源连接的优势在于它的数据集模型点、线、面、文本、CAD 等会被平台自动映射到数据库表属性字段和空间字段的写入由平台完成省去了手动建表。需要注意字段类型兼容性比如长文本字段、日期字段在两个库之间的映射规则不同导入后可能出现字段截断或类型变更。文档在第四章只给出了平台迁移的整体框架具体到字段级兼容建议在正式迁移前拿两个典型数据集做导入导出验证确认字段类型无损后再全量执行。5.2 通用格式文件入库shp、kml、geojson 的三种方式除了平台化迁移第三方通用格式文件的入库是日常运维中最常碰到的需求。shp 文件作为 ESRI 矢量格式早已是国际标准kml/geojson 是常见的交换格式。入库方式按项目环境灵活选一般有三条路。第一条路是直接用 GIS 桌面软件导入。ArcGIS、QGIS、SuperMap iDesktop 都能连接 KingbaseES 数据库把本地 shp 文件导入为数据库表。适合单次、偶发、有桌面环境的现场操作。第二条路是命令行工具批量导入。在兼容 PostgreSQL 协议的模式下可以用 OGR 库提供的 ogr2ogr 工具直接写入 KingbaseES# 将 district.shp 导入 KingbaseES目标坐标系强制转成 CGCS2000EPSG:4490 ogr2ogr -f PostgreSQL \ host192.168.4.30 port54321 dbnamekgis usersystem password******** \ -nlt PROMOTE_TO_MULTI -t_srs EPSG:4490 \ district.shp代码逻辑-f 指定目标驱动PG 协议兼容时驱动名为 PostgreSQL-nlt PROMOTE_TO_MULTI 把单部件几何提升为 Multi 类型避免后续空间运算时因几何类型不一致报错-t_srs 指定输出坐标系。host、port、dbname 对应 KDTS 连接里的服务器、端口和数据库名。这条命令适合批量循环处理多个 shp 文件写一个 shell 循环就能一次跑完一个目录。第三条路是 SQL 直接插入适合数据量小、需要精确控制字段的场景。先建带空间字段的表再用标准空间函数写入-- 建表geom 字段使用 4490 坐标系 CREATE TABLE district ( id serial PRIMARY KEY, name varchar(100), geom geometry(Geometry, 4490) ); -- 将 WKT 文本写入空间字段 INSERT INTO district (name, geom) VALUES ( 测试点, ST_GeomFromText(POINT(116.39 39.92), 4490) );代码逻辑serial 自增主键保证行号唯一geometry(Geometry, 4490) 声明空间字段的几何类型和 SRIDST_GeomFromText 把 WKT 格式的坐标文本解析为空间对象并绑定坐标系。这套 SQL 的好处是不依赖桌面 GIS 环境但前提是空间字段的类型和 SRID 必须与后续使用的 GIS 平台约定一致否则平台加载时会出现坐标系不匹配的警告。5.3 栅格与切片缓存文件归文件元数据归数据库通用格式里除了矢量还有栅格和切片缓存。文档把这类数据归为文件类型数据——切片缓存、影像文件本身不全部进数据库数据库里存的是它们的元数据和属性信息。KGIS 对栅格的处理方式是存储影像的实际存储路径、中心点、范围框、星历参数等原始文件仍以文件形式保存在存储上。这意味着迁移栅格数据时要分成两件事一起做一是影像文件本身的迁移按原目录结构拷贝二是属性元数据表的迁移路径、范围、中心点等。只导数据库表不导文件GIS 平台查得到记录但加载不出影像只拷文件不导表平台根本不知道有这些影像。两者的对应关系靠路径字段关联所以迁移后路径字段的修改是整个栅格迁移里的高频踩坑点。6. 避坑与验证注册脚本不能省结果对比走三条路6.1 五个高频踩坑点坑一迁移完成后ArcGIS 打开目标库看不到图层或者数据列表里有表但加载出来是空的。原因是迁移后没有执行地理数据库注册ArcGIS 无法把迁移表识别为合法要素类。解决是把结果目录里 ArcPyRegisterScript 下的 acrpyRegisterWithGeodatabase.py 拿到 ArcGIS 机器上执行注册完再刷新连接。坑二ArcCatalog 连接 KingbaseES 时报连接超时或无法连接。原因是端口写错——文档明确提到 instance 端口不是默认 5432 时需要写完整比如 192.168.4.30,5444。解决是检查连接串里的端口号确认目标库监听端口和防火墙放行情况。坑三大表迁移特别慢迁移过程中目标库内存和 CPU 居高不下。原因是游标读取记录数和批量写入记录数沿用默认值 100/1000单条记录大时网络往返过多。解决是把游标读取提到 1000 到 5000批量写入提到 5000 到 10000配合大表拆分阈值让大表分块迁移。坑四迁移完成后发现个别表的 LOB 字段内容缺失或读取异常。原因是 LOB 字段预读取大小默认只有 4000Byte遇到大对象记录时读取不完整。解决是根据单条记录实际大小调大预读取值并确认含大对象表的游标读取记录数没被设得过小。坑五创建企业级地理数据库时授权文件加载失败。原因是文件格式不对文档明确写了只能用 .ecp 格式。解决是重新导出 ArcGIS 授权文件为 .ecp再重新配置。6.2 迁移结果验证三板斧验证迁移结果我一般走三条路缺一不可。第一行数对比源库和目标库分别执行 count数字一致说明数据没丢。第二空间字段抽查取几个要素比对坐标值或包络矩形确保空间位置没有偏移SRID 一致。第三平台加载实测在 ArcGIS 或 SuperMap 里直接加载迁移后的数据看渲染和查询是否正常——这一步顺带验证了注册是否生效。从那以后我每次做 GIS 库迁移都强制把注册脚本跑一遍 三条验证路走一遍写进交付清单哪怕数据量再小也不例外。这个习惯帮我挡掉了不少回访麻烦。这份 V8.6 方案的第三章参数表和 FAQ 部分可以直接当操作清单用下载后对照着做比自己从零摸索高效得多。希望帮到你。本文还有配套的精品资源点击获取