EOS 區塊鏈數據實時異構到 MySQL

文/robinnode

這是「區塊鏈技術指北」的第 33 篇文章。mysql

若是對我感興趣,想和我交流,個人微信號:Wentasy,加我時簡單介紹下本身,並註明來自「區塊鏈技術指北」。同時我會把你拉入微信羣「區塊鏈技術指北」。BTW,李笑來老師也加入了個人知識星球,文末有加入方式。c++

題圖來自: © ChainONE / Original / chainone.xyzgit

0x00 背景


早在 6 月 7 日,kesarEOSIO 提交了一個編號爲 #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 參考


「區塊鏈技術指北」同名 知識星球,二維碼以下,歡迎加入。BTW,李笑來老師也加入了

區塊鏈技術指北

「區塊鏈技術指北」相關資訊渠道:

同時,本系列文章會在如下渠道同步更新,歡迎關注:

原創不易,讀者能夠經過以下途徑打賞,虛擬貨幣、美圓、法幣均支持。

  • BTC: 3QboL2k5HfKjKDrEYtQAKubWCjx9CX7i8f
  • ERC20 Token: 0x8907B2ed72A1E2D283c04613536Fac4270C9F0b3
  • PayPal: www.paypal.me/robinwen
  • 微信打賞二維碼

Wechat

–EOF–

版權聲明:自由轉載-非商用-非衍生-保持署名(創意共享4.0許可證)

相關文章
相關標籤/搜索