# 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 数据库中

##### 参数

| 名称        | 类型   | 是否必传 | 备注                                     | 例                                       |
| ----------- | ------ | -------- | ---------------------------------------- | ---------------------------------------- |
| orclUrl     | string | Y        | oracle 连接字符串                        | jdbc:oracle:thin:@192.168.20.8:1521:orcl |
| 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        | 导入任务状态更新的消息通知                                  |