1.1. # oralce 矢量数据入库工具使用手册（arcgis 矢量数据）
## 指引
本手册指导将 oracle 中存储的 arcgis 矢量数据快速导入至平台 Kudu 数据库中
## 快速使用
修改/config/props.properties 中的相应配置信息，在命令行中执行 java -jar oracleread-1.0.2.jar -t，即可完成数据导入
（总部服务器 192.168.20.8 桌面 /import service 文件夹中有该工具可直接使用）
## 使用环境说明
#### java 环境
需要有 jdk/jre 1.8 的环境，并配置环境变量
#### python 环境
需要有 python 2.7 的环境（python 3 不行），并配置环境变量
#### arcgis 环境
需要有 arcigs 环境（arcgis engine）
#### oracle 环境
需要有 oracle client 环境，安装的 oracle client 版本需要对应 arcgis 的版本，（arcgis10.4 以上必须使用 Oracle client 11 以上的版本），该环境用于 arccatalog 能够正常连接 oracle 数据库
## 配置文件说明
配置项 | 说明 |
—————— | ————————————————– |
# 数据表参数 | |
params.fromTable | 被导入的表名（对应 oracle 数据表表名） |
params.toTable | 导入至的表（对应需要在 kudu 数据库中需要创建的表） |
# oracle 参数 | |
params.toTable | 导入至的表（对应需要在 kudu 数据库中需要创建的表） |
params.url | oracle 连接字符串 |
params.user | oracle 账户名 |
params.pwd | oracle 密码 |
# sde 参数 | |
params.sdePath | sde 文件本地路径 |
# kudu 参数 | |
params.kuduMaster | kudu master ip 地址及端口号（ip:port） |
params.kuduCatalog | kudu 数据库 catalog |
params.kuduUser | kudu 用户名 （一般为 admin，不用修改） |
# mysql 参数 | （用于在平台数据库中创建集成记录，不配置也可以） |
params.mysqlUrl | mysql 连接字符串 |
params.mysqlUser | mysql 账户名 |
params.mysqlPwd | mysql 密码 |
—
## 数据导入微服务
本工具可以作为服务开启，提供接口调用以实现数据导入操作
开启方式：命令行输入 java -jar oracleread-1.0.2.jar
(默认服务端口为 9401，注册中心等配置可通过/config/application.properties 修改)
以服务的形式开启后不会自动执行导入操作
## 服务接口
### 创建数据导入任务
#### POST /read/importData
将 oracle 中的 arcgis 矢量数据导入至 kudu 数据库中
##### 参数
名称 | 类型 | 是否必传 | 备注 | 例 |
———– | —— | ——– | —————————————- | —————————————- |
orclUser | string | Y | oracle 账户名 | YN_SD_SDE |
orclPwd | string | Y | oracle 密码 | *** |
kuduUrl | string | Y | kudu master ip 地址及端口号（ip:port） | 192.168.10.170:7051 |
kuduCatalog | string | Y | kudu 数据库 catalog | changsha_demo |
kuduUser | string | Y | kudu 用户名 （一般为 admin，不用修改） | admin |
from | string | Y | 被导入的表名（oracle 表） | test1w |
to | string | Y | 导入到的表名（kudu 表） | test |
indexFields | string | Y | kudu 表需要创建索引的属性字段（’,’分隔） | field1,field2,field3… |
##### 返回
名称 | 类型 | 是否必传 | 备注 |
——- | —— | ——– | —————————— |
code | int | Y | 0-正常，10000-系统错误 |
message | string | Y | 异常消息，返回结果正常时无内容 |
data | int | Y | 数据导入任务的 id |
### 查询数据导入任务状态
#### GET /read/queryImportStatus
将 oracle 中的 arcgis 矢量数据导入至 kudu 数据库中
##### 参数
名称 | 类型 | 是否必传 | 备注 | 例 |
—- | —- | ——– | ————- | — |
id | int | Y | 导入任务的 id | |
##### 返回
名称 | 类型 | 是否必传 | 备注 |
————— | —— | ——– | ———————————————————– |
code | int | Y | 0-正常，10000-系统错误 |
message | string | Y | 异常消息，返回结果正常时无内容 |
data | object | Y | |
data.id | int | Y | 导入任务的 id |
data.status | int | Y | 状态。 0-导入任务创建中，1-完成，2-失败, 3-下载中, 4-导入中 |
data.costtime | long | Y | 导入任务从开始至最近一次状态更新所花时间，毫秒 |
data.createtime | long | Y | 导入任务的创建时间，毫秒 |
data.msg | long | Y | 导入任务状态更新的消息通知 |