From 329e9c74e12b120645d448a861776cdfeb1dcd64 Mon Sep 17 00:00:00 2001
From: HanHuimin001 <1549755260@qq.com>
Date: Thu, 17 Sep 2020 15:14:45 +0800
Subject: [PATCH] Add kingbasees plug-in.
---
core/src/main/bin/perftrace.py | 3 +
kingbaseesreader/doc/kingbaseesreader.md | 241 ++++++++++++++++++
kingbaseesreader/pom.xml | 88 +++++++
.../src/main/assembly/package.xml | 42 +++
.../reader/kingbaseesreader/Constant.java | 7 +
.../kingbaseesreader/KingbaseesReader.java | 86 +++++++
.../src/main/libs/kingbase8-8.2.0.jar | Bin 0 -> 811979 bytes
.../src/main/resources/plugin.json | 6 +
.../main/resources/plugin_job_template.json | 13 +
kingbaseeswriter/doc/kingbaseeswriter.md | 208 +++++++++++++++
kingbaseeswriter/pom.xml | 84 ++++++
.../src/main/assembly/package.xml | 42 +++
.../kingbaseeswriter/KingbaseesWriter.java | 100 ++++++++
.../src/main/libs/kingbase8-8.2.0.jar | Bin 0 -> 811979 bytes
.../src/main/resources/plugin.json | 6 +
.../main/resources/plugin_job_template.json | 17 ++
package.xml | 14 +
.../datax/plugin/rdbms/util/DataBaseType.java | 11 +-
pom.xml | 2 +
19 files changed, 969 insertions(+), 1 deletion(-)
create mode 100644 kingbaseesreader/doc/kingbaseesreader.md
create mode 100644 kingbaseesreader/pom.xml
create mode 100644 kingbaseesreader/src/main/assembly/package.xml
create mode 100644 kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/Constant.java
create mode 100644 kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/KingbaseesReader.java
create mode 100644 kingbaseesreader/src/main/libs/kingbase8-8.2.0.jar
create mode 100644 kingbaseesreader/src/main/resources/plugin.json
create mode 100644 kingbaseesreader/src/main/resources/plugin_job_template.json
create mode 100644 kingbaseeswriter/doc/kingbaseeswriter.md
create mode 100644 kingbaseeswriter/pom.xml
create mode 100644 kingbaseeswriter/src/main/assembly/package.xml
create mode 100644 kingbaseeswriter/src/main/java/com/alibaba/datax/plugin/writer/kingbaseeswriter/KingbaseesWriter.java
create mode 100644 kingbaseeswriter/src/main/libs/kingbase8-8.2.0.jar
create mode 100644 kingbaseeswriter/src/main/resources/plugin.json
create mode 100644 kingbaseeswriter/src/main/resources/plugin_job_template.json
diff --git a/core/src/main/bin/perftrace.py b/core/src/main/bin/perftrace.py
index 41a1ecb3..b9c79a43 100755
--- a/core/src/main/bin/perftrace.py
+++ b/core/src/main/bin/perftrace.py
@@ -174,6 +174,9 @@ def parsePluginName(jdbcUrl, pluginType):
db2Regex = re.compile('jdbc:(db2)://.*')
if (db2Regex.match(jdbcUrl)):
name = 'db2'
+ kingbaseesRegex = re.compile('jdbc:(kingbase8)://.*')
+ if (kingbaseesRegex.match(jdbcUrl)):
+ name = 'kingbasees'
return "%s%s" % (name, pluginType)
def renderDataXJson(paramsDict, readerOrWriter = 'reader', channel = 1):
diff --git a/kingbaseesreader/doc/kingbaseesreader.md b/kingbaseesreader/doc/kingbaseesreader.md
new file mode 100644
index 00000000..ec5495a6
--- /dev/null
+++ b/kingbaseesreader/doc/kingbaseesreader.md
@@ -0,0 +1,241 @@
+
+# KingbaseesReader 插件文档
+
+
+___
+
+
+## 1 快速介绍
+
+KingbaseesReader插件实现了从KingbaseES读取数据。在底层实现上，KingbaseesReader通过JDBC连接远程KingbaseES数据库，并执行相应的sql语句将数据从KingbaseES库中SELECT出来。
+
+## 2 实现原理
+
+简而言之，KingbaseesReader通过JDBC连接器连接到远程的KingbaseES数据库，并根据用户配置的信息生成查询SELECT SQL语句并发送到远程KingbaseES数据库，并将该SQL执行返回结果使用DataX自定义的数据类型拼装为抽象的数据集，并传递给下游Writer处理。
+
+对于用户配置Table、Column、Where的信息，KingbaseesReader将其拼接为SQL语句发送到KingbaseES数据库；对于用户配置querySql信息，KingbaseesReader直接将其发送到KingbaseES数据库。
+
+
+## 3 功能说明
+
+### 3.1 配置样例
+
+* 配置一个从KingbaseES数据库同步抽取数据到本地的作业:
+
+```
+{
+ "job": {
+ "setting": {
+ "speed": {
+ //设置传输速度，单位为byte/s，DataX运行会尽可能达到该速度但是不超过它.
+ "byte": 1048576
+ },
+ //出错限制
+ "errorLimit": {
+ //出错的record条数上限，当大于该值即报错。
+ "record": 0,
+ //出错的record百分比上限 1.0表示100%，0.02表示2%
+ "percentage": 0.02
+ }
+ },
+ "content": [
+ {
+ "reader": {
+ "name": "kingbaseesreader",
+ "parameter": {
+ // 数据库连接用户名
+ "username": "xx",
+ // 数据库连接密码
+ "password": "xx",
+ "column": [
+ "id"，"name"
+ ],
+ //切分主键
+ "splitPk": "id",
+ "connection": [
+ {
+ "table": [
+ "table"
+ ],
+ "jdbcUrl": [
+ "jdbc:kingbase8://host:port/database"
+ ]
+ }
+ ]
+ }
+ },
+ "writer": {
+ //writer类型
+ "name": "streamwriter",
+ //是否打印内容
+ "parameter": {
+ "print":true,
+ }
+ }
+ }
+ ]
+ }
+}
+
+```
+
+* 配置一个自定义SQL的数据库同步任务到本地内容的作业：
+
+```
+{
+ "job": {
+ "setting": {
+ "speed": 1048576
+ },
+ "content": [
+ {
+ "reader": {
+ "name": "kingbaseesreader",
+ "parameter": {
+ "username": "xx",
+ "password": "xx",
+ "where": "",
+ "connection": [
+ {
+ "querySql": [
+ "select db_id,on_line_flag from db_info where db_id < 10;"
+ ],
+ "jdbcUrl": [
+ "jdbc:kingbase8://host:port/database", "jdbc:kingbase8://host:port/database"
+ ]
+ }
+ ]
+ }
+ },
+ "writer": {
+ "name": "streamwriter",
+ "parameter": {
+ "print": false,
+ "encoding": "UTF-8"
+ }
+ }
+ }
+ ]
+ }
+}
+```
+
+
+### 3.2 参数说明
+
+* **jdbcUrl**
+
+ * 描述：描述的是到对端数据库的JDBC连接信息，使用JSON的数组描述，并支持一个库填写多个连接地址。之所以使用JSON数组描述连接信息，是因为阿里集团内部支持多个IP探测，如果配置了多个，KingbaseesReader可以依次探测ip的可连接性，直到选择一个合法的IP。如果全部连接失败，KingbaseesReader报错。 注意，jdbcUrl必须包含在connection配置单元中。对于阿里集团外部使用情况，JSON数组填写一个JDBC连接即可。
+
+ jdbcUrl按照KingbaseES官方规范，并可以填写连接附件控制信息。具体请参看[KingbaseES官方文档](https://help.kingbase.com.cn/doc-view-5683.html)。
+
+ * 必选：是
+
+ * 默认值：无
+
+* **username**
+
+ * 描述：数据源的用户名
+
+ * 必选：是
+
+ * 默认值：无
+
+* **password**
+
+ * 描述：数据源指定用户名的密码
+
+ * 必选：是
+
+ * 默认值：无
+
+* **table**
+
+ * 描述：所选取的需要同步的表。使用JSON的数组描述，因此支持多张表同时抽取。当配置为多张表时，用户自己需保证多张表是同一schema结构，KingbaseesReader不予检查表是否同一逻辑表。注意，table必须包含在connection配置单元中。
+
+ * 必选：是
+
+ * 默认值：无
+
+* **column**
+
+ * 描述：所配置的表中需要同步的列名集合，使用JSON的数组描述字段信息。用户使用\*代表默认使用所有列配置，例如['\*']。
+
+ 支持列裁剪，即列可以挑选部分列进行导出。
+
+ 支持列换序，即列可以不按照表schema信息进行导出。
+
+ 支持常量配置，用户需要按照KingbaseES语法格式:
+ ["id", "'hello'::varchar", "true", "2.5::real", "power(2,3)"]
+ id为普通列名，'hello'::varchar为字符串常量，true为布尔值，2.5为浮点数, power(2,3)为函数。
+
+ **column必须用户显示指定同步的列集合，不允许为空！**
+
+ * 必选：是
+
+ * 默认值：无
+
+* **splitPk**
+
+ * 描述：KingbaseesReader进行数据抽取时，如果指定splitPk，表示用户希望使用splitPk代表的字段进行数据分片，DataX因此会启动并发任务进行数据同步，这样可以大大提供数据同步的效能。
+
+ 推荐splitPk用户使用表主键，因为表主键通常情况下比较均匀，因此切分出来的分片也不容易出现数据热点。
+
+ 目前splitPk仅支持整形数据切分，`不支持浮点、字符串型、日期等其他类型`。如果用户指定其他非支持类型，KingbaseesReader将报错！
+
+ splitPk设置为空，底层将视作用户不允许对单表进行切分，因此使用单通道进行抽取。
+
+ * 必选：否
+
+ * 默认值：空
+
+* **where**
+
+ * 描述：筛选条件，KingbaseesReader根据指定的column、table、where条件拼接SQL，并根据这个SQL进行数据抽取。在实际业务场景中，往往会选择当天的数据进行同步，可以将where条件指定为gmt_create > $bizdate 。注意：不可以将where条件指定为limit 10，limit不是SQL的合法where子句。
+
+ where条件可以有效地进行业务增量同步。 where条件不配置或者为空，视作全表同步数据。
+
+ * 必选：否
+
+ * 默认值：无
+
+* **querySql**
+
+ * 描述：在有些业务场景下，where这一配置项不足以描述所筛选的条件，用户可以通过该配置型来自定义筛选SQL。当用户配置了这一项之后，DataX系统就会忽略table，column这些配置型，直接使用这个配置项的内容对数据进行筛选，例如需要进行多表join后同步数据，使用select a,b from table_a join table_b on table_a.id = table_b.id
+
+ `当用户配置querySql时，KingbaseesReader直接忽略table、column、where条件的配置`。
+
+ * 必选：否
+
+ * 默认值：无
+
+* **fetchSize**
+
+ * 描述：该配置项定义了插件和数据库服务器端每次批量数据获取条数，该值决定了DataX和服务器端的网络交互次数，能够较大的提升数据抽取性能。
+
+ `注意，该值过大(>2048)可能造成DataX进程OOM。`。
+
+ * 必选：否
+
+ * 默认值：1024
+
+
+### 3.3 类型转换
+
+目前KingbaseesReader支持大部分KingbaseES类型，但也存在部分个别类型没有支持的情况，请注意检查你的类型。
+
+下面列出KingbaseesReader针对KingbaseES类型转换列表:
+
+
+| DataX 内部类型| KingbaseES 数据类型 |
+| -------- | ----- |
+| Long |bigint, bigserial, integer, smallint, serial |
+| Double |double precision, money, numeric, real |
+| String |varchar, char, text, bit, inet|
+| Date |date, time, timestamp |
+| Boolean |bool|
+| Bytes |bytea|
+
+请注意:
+
+* `除上述罗列字段类型外，其他类型均不支持; money,inet,bit需用户使用a_inet::varchar类似的语法转换`。
\ No newline at end of file
diff --git a/kingbaseesreader/pom.xml b/kingbaseesreader/pom.xml
new file mode 100644
index 00000000..6e844c10
--- /dev/null
+++ b/kingbaseesreader/pom.xml
@@ -0,0 +1,88 @@
+
+
+
+ datax-all
+ com.alibaba.datax
+ 0.0.1-SNAPSHOT
+
+ 4.0.0
+
+ kingbaseesreader
+ kingbaseesreader
+ jar
+
+
+
+ com.alibaba.datax
+ datax-common
+ ${datax-project-version}
+
+
+ slf4j-log4j12
+ org.slf4j
+
+
+
+
+
+ org.slf4j
+ slf4j-api
+
+
+
+ ch.qos.logback
+ logback-classic
+
+
+
+ com.alibaba.datax
+ plugin-rdbms-util
+ ${datax-project-version}
+
+
+
+ com.kingbase8
+ kingbase8
+ 8.2.0
+ system
+ ${basedir}/src/main/libs/kingbase8-8.2.0.jar
+
+
+
+
+
+
+
+
+ maven-compiler-plugin
+
+ ${jdk-version}
+ ${jdk-version}
+ ${project-sourceEncoding}
+
+
+
+
+ maven-assembly-plugin
+
+
+ src/main/assembly/package.xml
+
+ datax
+
+
+
+ dwzip
+ package
+
+ single
+
+
+
+
+
+
+
+
diff --git a/kingbaseesreader/src/main/assembly/package.xml b/kingbaseesreader/src/main/assembly/package.xml
new file mode 100644
index 00000000..e369c5f0
--- /dev/null
+++ b/kingbaseesreader/src/main/assembly/package.xml
@@ -0,0 +1,42 @@
+
+
+
+ dir
+
+ false
+
+
+ src/main/resources
+
+ plugin.json
+ plugin_job_template.json
+
+ plugin/reader/kingbaseesreader
+
+
+ target/
+
+ kingbaseesreader-0.0.1-SNAPSHOT.jar
+
+ plugin/reader/kingbaseesreader
+
+
+ src/main/libs
+
+ *.*
+
+ plugin/reader/kingbaseesreader/libs
+
+
+
+
+
+ false
+ plugin/reader/kingbaseesreader/libs
+ runtime
+
+
+
diff --git a/kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/Constant.java b/kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/Constant.java
new file mode 100644
index 00000000..bed4c6e6
--- /dev/null
+++ b/kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/Constant.java
@@ -0,0 +1,7 @@
+package com.alibaba.datax.plugin.reader.kingbaseesreader;
+
+public class Constant {
+
+ public static final int DEFAULT_FETCH_SIZE = 1000;
+
+}
diff --git a/kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/KingbaseesReader.java b/kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/KingbaseesReader.java
new file mode 100644
index 00000000..9246655f
--- /dev/null
+++ b/kingbaseesreader/src/main/java/com/alibaba/datax/plugin/reader/kingbaseesreader/KingbaseesReader.java
@@ -0,0 +1,86 @@
+package com.alibaba.datax.plugin.reader.kingbaseesreader;
+
+import com.alibaba.datax.common.exception.DataXException;
+import com.alibaba.datax.common.plugin.RecordSender;
+import com.alibaba.datax.common.spi.Reader;
+import com.alibaba.datax.common.util.Configuration;
+import com.alibaba.datax.plugin.rdbms.reader.CommonRdbmsReader;
+import com.alibaba.datax.plugin.rdbms.util.DBUtilErrorCode;
+import com.alibaba.datax.plugin.rdbms.util.DataBaseType;
+
+import java.util.List;
+
+public class KingbaseesReader extends Reader {
+
+ private static final DataBaseType DATABASE_TYPE = DataBaseType.KingbaseES;
+
+ public static class Job extends Reader.Job {
+
+ private Configuration originalConfig;
+ private CommonRdbmsReader.Job commonRdbmsReaderMaster;
+
+ @Override
+ public void init() {
+ this.originalConfig = super.getPluginJobConf();
+ int fetchSize = this.originalConfig.getInt(com.alibaba.datax.plugin.rdbms.reader.Constant.FETCH_SIZE,
+ Constant.DEFAULT_FETCH_SIZE);
+ if (fetchSize < 1) {
+ throw DataXException.asDataXException(DBUtilErrorCode.REQUIRED_VALUE,
+ String.format("您配置的fetchSize有误，根据DataX的设计，fetchSize : [%d] 设置值不能小于 1.", fetchSize));
+ }
+ this.originalConfig.set(com.alibaba.datax.plugin.rdbms.reader.Constant.FETCH_SIZE, fetchSize);
+
+ this.commonRdbmsReaderMaster = new CommonRdbmsReader.Job(DATABASE_TYPE);
+ this.commonRdbmsReaderMaster.init(this.originalConfig);
+ }
+
+ @Override
+ public List split(int adviceNumber) {
+ return this.commonRdbmsReaderMaster.split(this.originalConfig, adviceNumber);
+ }
+
+ @Override
+ public void post() {
+ this.commonRdbmsReaderMaster.post(this.originalConfig);
+ }
+
+ @Override
+ public void destroy() {
+ this.commonRdbmsReaderMaster.destroy(this.originalConfig);
+ }
+
+ }
+
+ public static class Task extends Reader.Task {
+
+ private Configuration readerSliceConfig;
+ private CommonRdbmsReader.Task commonRdbmsReaderSlave;
+
+ @Override
+ public void init() {
+ this.readerSliceConfig = super.getPluginJobConf();
+ this.commonRdbmsReaderSlave = new CommonRdbmsReader.Task(DATABASE_TYPE, super.getTaskGroupId(), super.getTaskId());
+ this.commonRdbmsReaderSlave.init(this.readerSliceConfig);
+ }
+
+ @Override
+ public void startRead(RecordSender recordSender) {
+ int fetchSize = this.readerSliceConfig.getInt(com.alibaba.datax.plugin.rdbms.reader.Constant.FETCH_SIZE);
+
+ this.commonRdbmsReaderSlave.startRead(this.readerSliceConfig, recordSender,
+ super.getTaskPluginCollector(), fetchSize);
+ }
+
+ @Override
+ public void post() {
+ this.commonRdbmsReaderSlave.post(this.readerSliceConfig);
+ }
+
+ @Override
+ public void destroy() {
+ this.commonRdbmsReaderSlave.destroy(this.readerSliceConfig);
+ }
+
+ }
+
+}
diff --git a/kingbaseesreader/src/main/libs/kingbase8-8.2.0.jar b/kingbaseesreader/src/main/libs/kingbase8-8.2.0.jar
new file mode 100644
index 0000000000000000000000000000000000000000..0b5ac9646cd25873785bb2e9a8072b2fb82be46b
GIT binary patch
literal 811979
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
z
zvePp2SVWq#&l$QWi5>)LC75da{4@An;Bm8%$u5M?iS23H`@rV9Lxe95clMhk5~P2c
zc$H)`+M2s?Fqa$cl;AMEeVX=J1;tM2mSOFU1TfcZ_ks8C)|~J;NxOy3jb!zan13#c
z+8zC*)E2mmExHi;o*F`4397FI98c_R&inA4COt`cK$eo^Wg4-9*N#qto9b~@KV&>t
z>^y+?mLCX?SndACg1N=2zfxuZ3`OWVTi~>2`b+ZI24=?;wP`#KqT=$ZGX=A{AtYnc
zKeZH+wN)fxZoxp2h*bF!DYj2VvQ-=7$+2tGHBQd`hqO+rmD$0pQ)ZzCX27Uh-zz<@
zi&Bswv3lmcB;8GPly_ovXzWOJu1O1(Ti&+0{c_2lvj2D`Yl{I?Bz~=v(AJI0BW9x*
zjV$;a5gM(@9B>7)sf+*A>gv1VjM^nJF$_M4c9-pUf;7s3hoVJcN{M2xtQdfPwMR8I
zngbhH4sAIWhH%oyvEl={?Dl96CUIN28sg^+qOgGvFYeaE5+JIm`Bh|tGMNo&ToW;1
z5(%#|`C6r9pqog_o0&3rBRL
zjb#TJf2~s^L%_GX72=%(`FVMdRrWG{DH?JO2!S+q?xh2t1sg(fQeLH+X#1LqGm1iPSYtk1*`TW#
zH&IcX_cv!$9+4e;7aExSn8d5?0rxqLGghA>&_I@2Ild)NY1#S-1+bNHlC>#$JGB-J
zsX#O(<{t=F8unJ&hDj#|#Zp%sqFRoPaD4ZIp{p9==x!SKF5|cM^>Xa9%iEC7JDR5)
zo0vrU2*oW|Z`baT5xRs8LnKe@Ol}XLtBY~AY@P#=Z9$_{emx5Wu8xQob1H-`-^VSf
z(Y27lw$OaA(1M}RAcp?QGQpX%WnoDRH10=`W-ZA<*c$YUUGabcNXD>*{>Xk?un*@b
z+eE@b&V9SKcVPnVrahwb9nl{8oo=ml!S#xRr=>Mp23wZc8XKrhK4fG>`KGu@p!DKA
z#x}z!WOHgA_sBpYI-l-)@dSd