EOS 区块链数据实时异构到 MySQL

时间 2019-11-16

标签 eos 区块数据实时异构 mysql 栏目比特币繁體版

原文原文链接

文/robinnode

这是「区块链技术指北」的第 33 篇文章。mysql

若是对我感兴趣，想和我交流，个人微信号：Wentasy，加我时简单介绍下本身，并注明来自「区块链技术指北」。同时我会把你拉入微信群「区块链技术指北」。BTW，李笑来老师也加入了个人知识星球，文末有加入方式。c++

题图来自: © ChainONE / Original / chainone.xyzgit

0x00 背景

早在 6 月 7 日，kesar 在 EOSIO 提交了一个编号为 #3882 的 PR，但直至目前仍处于未合并状态。团队作一些开发须要取 EOS 链上数据，但没法直接从 EOS 区块链中获取。#3882 提供 EOS 链上数据导入 MySQL，能够很方便的读取历史数据。但问题来了，该 PR 未合并，EOSIO 也没有一个 sql_db_plugin 相关的 branch 或 tag，因此没法使用 git 自动合并。github

0x01 解决

SuperONE 团队将 #3882 提交的内容打包，提交了个一个 repo，连接以下：sql

github.com/superoneio/…数据库

接下来本文将讲解如何将 EOS 链上数据异构到 MySQL。json

0x02 部署

部署的思路以下：bash

安装 MySQL 以及 client 库
安装 soci
修改 eos CMakeLists.txt
编译支持 sql_db_plugin 的 nodeos
建立数据库，分配用户名
导入 eos 表结构
启动 nodeos，同步主网数据
查看 MySQL，确认数据

接下来咱们逐步讲解。微信

若是使用 Ubuntu，安装 MySQL 能够快速使用 apt-get 安装，笔者建议使用源码编译。

若是使用源码编译，mysql-client 相关库已经存在。若是使用 apt-get 或者 yum 安装 mysql-sever，须要执行以下命令安装 mysql-client，命令以下：

$ apt-get -y install mysql-client
复制代码

接下来咱们安装 soci。soci 是 C++ 链接 MySQL 的 Library。Ubuntu 能够快速安装，命令以下：

$ apt-get -y install libsoci-dev
复制代码

固然，咱们还能够源码编译，步骤以下：[1]

$ git clone clone https://github.com/SOCI/soci.git
$ cd soci && mkdir build && cd build
$ cmake -DWITH_BOOST=ON -WITH_MYSQL=ON -MYSQL_INCLUDE_DIR=/usr/local/mysql/include -MYSQL_LIBRARIES=/usr/local/mysql/lib/libmysqlclient.a /data/tmp/robin/soci
$ make
$ make install
复制代码

固然 -MYSQL_INCLUDE_DIR 和 -MYSQL_LIBRARIES 根据实际路径更改。[2]

接下来咱们须要 clone eos 代码，命令以下：

$ cd /data
$ git clone https://github.com/EOSIO/eos --recursive
$ cd /data/eos
# 若是不想用 master 分支代码，可使用 git checkout v1.0.8 使用其余分支
$ git submodule update –init –recursive
复制代码

而后更改 CMakeLists.txt，总共有两个 CMakeLists.txt 须要更改。

eos/plugins/CMakeLists.txt
eos/programs/nodeos/CMakeLists.txt

在 eos/plugins/CMakeLists.txt 添加以下行：

add_subdirectory(sql_db_plugin)

在 eos/programs/nodeos/CMakeLists.txt 添加以下内容：

// 若是如下内容已经取消注释，能够忽略。
if(TARGET sql_db_plugin)
    target_link_libraries( nodeos PRIVATE -Wl,${whole_archive_flag} sql_db_plugin -Wl,${no_whole_archive_flag} )
   endif()
复制代码

接着将 SuperONE 团队合并的 sql_db_plugin 合并到 EOS 代码中。

$ cd /data
$ git clone https://github.com/superoneio/eos_sql_db_plugin
\cp -rv /data/eos_sql_db_plugin/sql_db_plugin/* /data/eos/plugins/sql_db_plugin
复制代码

接下来编译支持 sql_db_plugin 的 nodeos。

$ cd /data/eos
$ ./eosio_build.sh
复制代码

待 nodeos 编译完成以后，咱们执行以下命令确认是否编译成功。

$ /data/eos/build/programs/nodeos/nodeos --help | grep "sql_db-uri"
复制代码

若是输出以下内容，证实编译成功。

--sql_db-uri arg Sql DB URI connection string If not

接下来在 MySQL 里建立数据库以及分配帐号，SQL 以下：

CREATE DATABASE eos DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
GRANT ALL PRIVILEGES ON eos.* TO app_eos@'%' IDENTIFIED BY 'YOURPASS';
GRANT ALL PRIVILEGES ON eos.* TO app_eos@'127.0.0.1' IDENTIFIED BY 'YOURPASS';
复制代码

而后咱们导入 EOS 数据库表结构，如不想手动导入，能够在启动 nodeos 的时候添加 sql_db-block-start=0 参数，该参数为 0 时会在数据库中建立表。表结构能够在点击此处下载。

接着咱们启动 nodeos，主网 fullnode 相关的配置文件能够访问以下连接下载：

github.com/superoneio/…

启动 fullnode 相关命令以下：

$ mkdir /data/mainnet
$ cd /data/mainnet
$ git clone https://github.com/superoneio/eos-mainnet
$ mkdir -p data logs config
$ cp eos-mainnet/config.ini mainnet/config
$ cp eos-mainnet/genesis.json mainnet
$ cp eos-mainnet/*.sh mainnet
$ chmod +x mainnet
复制代码

修改 config.ini 相关配置以及 start.sh 脚本，sql_db-uri 格式以下：

sql_db-uri="mysql://db=YOURDB user=YOURUSER host=127.0.0.1 password='YOURPASS'

sql_db-uri 参数中的 YOURUSER 表示链接 EOS 区块链数据库的用户名，YOURPASS 表示链接 EOS 区块链数据库的用户密码，YOURDB 表示 EOS 区块链数据库名字。

须要注意的是 sql_db-uri 暂时不能写入 config.ini 配置文件，不然将会遇到 Failed to find shared library for backend "mysql 错误。另外，笔者的操做系统是 Ubuntu 16.04.4 LTS。

最后执行 start.sh，登陆 MySQL 数据库就能够查看到相关数据。

[root@localhost][(none)]> USE eos
Database changed
[root@localhost][eos]> SHOW TABLES;
+------------------+
| Tables_in_eos    |
+------------------+
| accounts         |
| accounts_keys    |
| actions          |
| actions_accounts |
| blocks           |
| stakes           |
| tokens           |
| transactions     |
| votes            |
+------------------+
9 rows in set (0.02 sec)
[root@localhost][eos]> SELECT * FROM tokens LIMIT 1 \G
*************************** 1. row ***************************
account: eosio
 symbol: EOS
 amount: 995314228.4771
1 row in set (0.00 sec)
复制代码

0x03 小结

目前 #3882 暂未合并，具体缘由未从得知。EOS 链上数据和传统的关系型数据库结合，将会大大下降开发者成本。待 #3882 merge 以后，读者将会更便利的使用到这个功能。

0x04 参考

[1] SOCI (2018-07-06). SOCI Installation. Retrieved from soci.sourceforge.net/doc/master/….
[2] 太上绝情 (2016-07-14). soci-mysq 编译. Retrieved from blog.csdn.net/bjrxyz/arti….

「区块链技术指北」同名 知识星球，二维码以下，欢迎加入。BTW，李笑来老师也加入了。

「区块链技术指北」相关资讯渠道：

「区块链技术指北」同名知识星球，t.xiaomiquan.com/ZRbmaU3
官方社区，bcage.one
Telegram Channel，t.me/BlockchainA…
Telegram Group，t.me/bcage
Twitter，twitter.com/bcageone
新浪微博，weibo.com/BlockchainA…

同时，本系列文章会在如下渠道同步更新，欢迎关注：

「区块链技术指北」同名微信公众号（微信号：BlockchainAge）
我的博客，dbarobin.com
知乎，zhuanlan.zhihu.com/robinwen
Steemit，steemit.com/@robinwen
Medium，medium.com/@robinwan
掘金，robinwen@juejin.im
币乎，bihu.com/people/1210…

原创不易，读者能够经过以下途径打赏，虚拟货币、美圆、法币均支持。

BTC: 3QboL2k5HfKjKDrEYtQAKubWCjx9CX7i8f
ERC20 Token: 0x8907B2ed72A1E2D283c04613536Fac4270C9F0b3
PayPal: www.paypal.me/robinwen
微信打赏二维码

–EOF–