博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
可定制的 elasticsearch 数据导入工具:mysql_2_elasticsearch
阅读量:6359 次
发布时间:2019-06-23

本文共 3572 字,大约阅读时间需要 11 分钟。

最近为了es导库的问题,费了一些周折。于是乎做了一个小工具(用过npm的一些jdbc的导库工具,感觉还不够好用),这里抛砖引玉,自荐一下下,欢迎同道兄弟吐槽和参与,我会不定时的更新这个扩展。

A customizable importer from mysql to elasticsearch.

可定制的 elasticsearch 数据导入工具 ——基于 elasticsearch 的 JS API

主要功能

  1. 完全使用 JS 实现数据从 MySQL 到 elasticsearch 的迁移;

  2. 可批量导入多张 MySQL 表;

  3. 可自定义的数据迁移的规则(数据表/字段关系、字段过滤、使用正则进行异常处理);

  4. 可自定义的异步分片导入方式,数据导入效率更高。

一键安装

npm install mysql_2_elasticsearch

快速开始(简单用例)

var esMysqlRiver = require('mysql_2_elasticsearch');var river_config = {  mysql: {    host: '127.0.0.1',    user: 'root',    password: 'root',    database: 'users',    port: 3306  },  elasticsearch: {    host_config: {               // es客户端的配置参数      host: 'localhost:9200',      // log: 'trace'    },    index: 'myIndex'  },  riverMap: {    'users => users': {}         // 将数据表 users 导入到 es 类型: /myIndex/users  }};/*** 以下代码内容:** 通过 esMysqlRiver 方法进行数据传输,方法的回调参数(一个JSON对象) obj 包含此次数据传输的结果** 其中:** 1. obj.total    => 需要传输的数据表数量** 2. obj.success  => 传输成功的数据表数量** 3. obj.failed   => 传输失败的数据表数量** 4. obj.result   => 本次数据传输的结论*/esMysqlRiver(river_config, function(obj) {  /* 将传输结果打印到终端 */  console.log('\n---------------------------------');  console.log('总传送:' + obj.total + '项');  console.log('成功:' + obj.success + '项');  console.log('失败:' + obj.failed + '项');  if (obj.result == 'success') {    console.log('\n结论:全部数据传送完成!');  } else {    console.log('\n结论:传送未成功...');  }  console.log('---------------------------------');  /* 将传输结果打印到终端 */});

最佳实践(完整用例)

var esMysqlRiver = require('mysql_2_elasticsearch');/*** mysql_2_elasticsearch 的相关参数配置(详情见注释)*/var river_config = {  /* [必需] MySQL数据库的相关参数(根据实际情况进行修改) */  mysql: {    host: '127.0.0.1',    user: 'root',    password: 'root',    database: 'users',    port: 3306  },  /* [必需] es 相关参数(根据实际情况进行修改) */  elasticsearch: {    host_config: {               // [必需] host_config 即 es客户端的配置参数,详细配置参考 es官方文档      host: 'localhost:9200',      log: 'trace',      // Other options...    },    index: 'myIndex',            // [必需] es 索引名    chunkSize: 8000,             // [非必需] 单分片最大数据量,默认为 5000 (条数据)    timeout: '2m'                // [非必需] 单次分片请求的超时时间,默认为 1m    //(注意:此 timeout 并非es客户端请求的timeout,后者请在 host_config 中设置)  },  /* [必需] 数据传送的规则 */  riverMap: {    'users => users': {            // [必需] 'a => b' 表示将 mysql数据库中名为 'a' 的 table 的所有数据 输送到 es中名为 'b' 的 type 中去      filter_out: [                // [非必需] 需要过滤的字段名,即 filter_out 中的设置的所有字段将不会被导入 elasticsearch 的数据中        'password',        'age'      ],      exception_handler: {           // [非必需] 异常处理器,使用JS正则表达式处理异常数据,避免 es 入库时由于类型不合法造成数据缺失        'birthday': [                // [示例] 对 users 表的 birthday 字段的异常数据进行处理          {            match: /NaN/gi,          // [示例] 正则条件(此例匹配字段值为 "NaN" 的情况)            writeAs: null            // [示例] 将 "NaN" 重写为 null          },          {            match: /(\d{4})年/gi,    // [示例] 正则表达式(此例匹配字段值为形如 "2016年" 的情况)            writeAs: '$1.1'          // [示例] 将 "2015年" 样式的数据重写为 "2016.1" 样式的数据          }        ]      }    },    // Other fields' options...  }};/*** 将传输结果打印到终端*/esMysqlRiver(river_config, function(obj) {  console.log('\n---------------------------------');  console.log('总传送:' + obj.total + '项');  console.log('成功:' + obj.success + '项');  console.log('失败:' + obj.failed + '项');  if (obj.result == 'success') {    console.log('\n结论:全部数据传送完成!');  } else {    console.log('\n结论:传送未成功...');  }  console.log('---------------------------------');});

注意事项及参考

  1. elasticsearch数据导入前请先配置好数据的 mapping;

  2. host_config 更多参数设置详见 ;

  3. mysql 表的自增 id 自动替换为 表名+_id 的格式,如:users_id

  4. 如出现数据缺失情况,请注意查看 elasticsearch 终端进程或日志,找出未成功导入的数据,通过设置 exception_handler 参数处理它。

github 项目地址

转载地址:http://nxbma.baihongyu.com/

你可能感兴趣的文章
Java统计文件夹中文件总行数
查看>>
python之基本数据类型及深浅拷贝
查看>>
将bootstrap弹出框的点击弹出改为鼠标移入弹出
查看>>
SKF密码设备研究
查看>>
数据对象映射模式(通过工厂模式和注册树模式)v2
查看>>
4939 欧拉函数[一中数论随堂练]
查看>>
MySQL笔记(一)
查看>>
spring boot 包jar运行
查看>>
18年秋季学习总结
查看>>
Effective前端1:能使用html/css解决的问题就不要使用JS
查看>>
网络攻防 实验一
查看>>
由莫名其妙的错误开始---浅谈jquery的dom节点创建
查看>>
磨刀-CodeWarrior11生成的Makefile解析
查看>>
String StringBuffer StringBuilder对比
查看>>
bootstrap随笔点击增加
查看>>
oracle 中proc和oci操作对缓存不同处理
查看>>
[LeetCode] Spiral Matrix 解题报告
查看>>
60906磁悬浮动力系统应用研究与模型搭建
查看>>
指纹获取 Fingerprint2
查看>>
面试题目3:智能指针
查看>>