DataX 快速入门

1. DataX 概述及安装


DataX 是被广泛使用的\color{red}{离线}数据同步工具,由阿里巴巴集团使用 Java 和 Python 开发,实现了包括 MySQL、Oracle、SqlServer、Postgre、HDFS、Hive、ADS、HBase、TableStore(OTS)、MaxCompute(ODPS)、DRDS 等各种异构数据源之间的高效数据同步功能。

Sqoop: HDFS 与 RDBMS 之间的 数据迁移 & 同步
DataX:上述任意两种数据源 之间的 数据迁移 & 同步


概述

为了解决异构数据源同步问题,DataX 将复杂的网状的同步链路变成了星型数据链路,DataX 作为中间传输载体负责连接各种数据源。当需要接入一个新的数据源的时候,只需要将此数据源对接到 DataX,便能跟已有的数据源做到无缝数据同步。

DataX 作为星形数据链路的中间载体

DataX 本身作为离线数据同步框架,采用 Framework + plugin 架构构建。将数据源读取和写入抽象成为Reader/Writer插件,纳入到整个同步框架中。

DataX 数据交换原理

核心组件:

  • Reader:数据采集模块,负责采集数据源的数据,将数据发送给 Framework;
  • Writer: 数据写入模块,负责不断向 Framework 取数据,并将数据写入到目的端;
  • Framework:用于连接 reader 和 writer,作为两者的数据传输通道,并处理缓冲,流控,并发,数据转换等核心技术问题。

经过几年积累,DataX 目前已经有了比较全面的插件体系,主流的 RDBMS 数据库、NOSQL、大数据计算系统都已经接入。
DataX 目前支持数据参见官网(https://github.com/alibaba/DataX/blob/master/introduction.md)。

DataX 3.0 开源版本支持单机多线程模式完成同步作业运行,本小节按一个 DataX 作业生命周期的时序图,从整体架构设计非常简要说明 DataX 各个模块相互关系。

DataX 底层运行流程原理
核心模块
  1. DataX 完成单个数据同步的作业,称为 Job。
    DataX 接受到一个 Job 之后,将启动一个进程来完成整个作业同步过程。
    DataX Job 模块是单个作业的中枢管理节点,
    承担了数据清理、子任务切分(将单一作业计算转化为多个子 Task)、TaskGroup 管理等功能。
  2. DataX Job 启动后,会根据不同的源端切分策略,
    将 Job 切分成多个小的 Task(子任务),以便于并发执行。
    Task 是 DataX 作业的最小单元,每一个 Task 都会负责一部分数据的同步工作。
  3. 切分多个 Task 之后,DataX Job 会调用 Scheduler 模块,
    根据配置的并发数据量,将拆分成的 Task 重新组合,组装成 TaskGroup(任务组)。
    每一个 TaskGroup 负责以一定的并发运行完毕分配好的所有 Task,默认单个任务组的并发数量为 5
  4. 每一个 Task 都由 TaskGroup 负责启动,
    Task 启动后,会固定启动 Reader => Channel => Writer 的线程来完成任务同步工作。
  5. DataX 作业运行起来之后,Job 监控并等待多个 TaskGroup 模块任务完成,
    等待所有 TaskGroup 任务完成后 Job 成功退出。
    否则,异常退出,进程退出值非0。


DataX 3.0 六大核心优势
  • 可靠的数据质量监控
  • 丰富的数据转换功能
  • 精准的速度控制
  • 强劲的同步性能
  • 健壮的容错机制
  • 极简的使用体验

详情见官网(https://github.com/alibaba/DataX/blob/master/introduction.md)


DataX 安装配置

DataX 官网:https://github.com/alibaba/DataX
前置条件:Linux、JDK(1.8以上,推荐1.8)、Python(推荐Python2.6.X)

DataX 的安装比较简单,基本上是开箱即用:

  1. 下载 DataX 工具包:
    http://datax-opensource.oss-cn-hangzhou.aliyuncs.com/datax.tar.gz
  2. 下载后解压至本地某个目录,进入bin目录,即可运行同步作业
    配置环境变量 DATAX_HOME
$ cd {YOUR_DATAX_HOME}/bin
$ python datax.py {YOUR_JOB.json}
$ python $DATAX_HOME/bin/datax.py $DATAX_HOME/job/job.json

自检脚本:python {YOUR_DATAX_HOME}/bin/datax.py {YOUR_DATAX_HOME}/job/job.json

  1. 测试


2. DataX 使用案例


Reader 和 Writer 插件

DataX3.0 版本提供的 Reader 插件和 Writer 插件,每种读插件都有一种和多种切分策略:

"reader": {
  "name":"mysqlreader",  #从 mysql 数据库获取数据(也支持 sqlserverreader, oraclereader)
  "name":"txtfilereader",  #从本地获取数据
  "name":"hdfsreader",  #从 hdfs文件、hive表获取数据
  "name":"streamreader",  #从 stream 流获取数据(常用于测试)
  "name":"httpreader",  #从 http URL 获取数据
}
"writer": {
  "name":"hdfswriter",  #向 hdfs、hive表写入数据
  "name":"mysqlwriter ",  #向 mysql 写入数据(也支持 sqlserverwriter, oraclewriter)
  "name":"streamwriter ",  #向 stream 流写入数据(常用于测试)
}

各种 Reader 插件、Writer 插件的参考文档:https://github.com/alibaba/DataX


json 配置文件模板
  • 整个配置文件是一个 job 的描述;
  • job 下面有两个配置项,content 和 setting,其中 content 用来描述该任务的源和目的端的信息,setting 用来描述任务本身的信息;
  • content 又分为两部分,reader 和 writer,分别用来描述源端和目的端的信息;
  • setting 中的 speed 项表示同时起几个并发执行该任务;


job 的基本配置
{
    "job": {
        "content": [{
            "reader": {
                "name":"",
                "parameter": {}
            },
            "writer": {
                "name":"",
                "parameter": {}
            }
        }],
        "setting": {
            "speed": {},
            "errorLimit": {}
        }
    }
}


job Setting 配置
{
    "job": {
        "content": [{
            "reader": {
                "name":"",
                "parameter": {}
            },
            "writer": {
                "name":"",
                "parameter": {}
            }
        }],
        "setting": {
            "speed": {
                "channel":1,
                "byte":104857600
            },
            "errorLimit": {
                "record":10,
                "percentage":0.05
            }
        }
    }
}
  • job.setting.speed(流量控制)
    Job 支持用户对速度的自定义控制,channel 的值可以控制同步时的并发数,byte 的值可以控制同步时的速度。
  • job.setting.errorLimit(脏数据控制)
    Job 支持用户对于脏数据的自定义监控和告警,包括对脏数据最大记录数阈值(record 值)或者脏数据占比阈值(percentage 值),当 Job 传输过程出现的脏数据大于用户指定的数量/百分比,DataX Job 报错退出。


应用案例:Stream ==> Stream

使用 streamreader + streamwriter(这种情况常用于测试)
配置文件:stream2stream.json

{
    "job": {
        "content": [{
            "reader": {
                "name": "streamreader",
                "parameter": {
                    "sliceRecordCount": 10,
                    "column": [{
                        "type": "String",
                        "value": "hello DataX"
                    }, {
                        "type": "string",
                        "value": "DataX Stream To Stream"
                    }, {
                        "type": "string",
                        "value": "数据迁移工具"
                    }]

                }
            },
            "writer": {
                "name": "streamwriter",
                "parameter": {
                    "encoding": "GBK",
                    "print": true
                }
            }
        }],
        "setting": {
            "speed": {
                "channel": 2
            }
        }
    }
}

输入执行命令:

$ python $DATAX_HOME/bin/datax.py ../job/stream2stream.json
运行结果
提示信息

注:json 配置文件中设置了 sliceRecordCount = 10channel = 2,因此共打印了 20 条数据

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,547评论 6 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,399评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,428评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,599评论 1 274
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,612评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,577评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,941评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,603评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,852评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,605评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,693评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,375评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,955评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,936评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,172评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,970评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,414评论 2 342

推荐阅读更多精彩内容