元數(shù)據(jù)結(jié)構(gòu)
fe/doris-meta > tree .
.
├── bdb # bdb 為 分布式 KV 系統(tǒng),存放元數(shù)據(jù)的 journal
│ ├── 00000000.jdb # bdbje 的數(shù)據(jù)文件
│ ├── je.config.csv
│ ├── je.info.0 # bdbje 的運(yùn)行日志
│ ├── je.info.0.lck
│ ├── je.lck
│ └── je.stat.csv
└── image # 用于存放 Doris 定期生成的元數(shù)據(jù)鏡像文件
├── image.xxx # 后綴 xxx 表明 image 所包含的最后一條日志的 id
├── image.ckpt # 正在寫入的 image 文件,如果寫入成功,會重命名為 image.[logid],并替換掉舊的 image 文件。
├── ROLE # 文件記錄了 FE 的類型(FOLLOWER 或 OBSERVER),是一個(gè)文本文件
└── VERSION # 文件記錄了這個(gè) Doris 集群的 cluster id,以及用于各個(gè)節(jié)點(diǎn)之間訪問認(rèn)證的 token,也是一個(gè)文本文件。
注 修改配置之后,需要通過 metadata_failure_recovery=true 來清空 bdbje 的元數(shù)據(jù), 因此當(dāng)修改 FE 端口等都可以通過在 fe/conf/fe.conf 的方式來使其生效即可,然后將 fe.conf 文件中的 metadata_failure_recovery=true 刪除防止下次再次清除咯。(源碼: org.apache.doris.journal.bdbje.BDBDebugger)
查看 bdbje 數(shù)據(jù)
- 進(jìn)入調(diào)試模式
修改 fe.conf 文件增加 enable_bdbje_debug_mode=true , 然后通過 sh start_fe.sh --daemon 啟動 FE 即可進(jìn)入 debug 模式。 進(jìn)入 debug 模式之后,僅會啟動 http server 和 MySQLServer 并打開 BDBJE 實(shí)例,但不會進(jìn)入任何元數(shù)據(jù)的加載及后續(xù)其他啟動流程。
- 查看
BDBJE數(shù)據(jù)
進(jìn)入 FE web ui 或 MySQL 客戶端訪問 Doris 服務(wù):
# 查看 bdbje 數(shù)據(jù)庫列表
mysql> show proc "/bdbje";
+----------+---------------+---------+
| DbNames | JournalNumber | Comment |
+----------+---------------+---------+
| metricDB | 430694 | |
+----------+---------------+---------+
# 查看庫內(nèi)數(shù)據(jù)實(shí)例列表
mysql> show proc "/bdbje/metricDB";
+-----------+
| JournalId |
+-----------+
| 1 |
| 2 |
+-----------+
4273 rows in set (0.06 sec)
# 查看數(shù)據(jù)值
mysql> show proc "/bdbje/metricDB/1";
+-----------+--------------+---------------------------------------------+
| JournalId | OpType | Data |
+-----------+--------------+---------------------------------------------+
| metricDB | OP_HEARTBEAT | org.apache.doris.persist.HbPackage@6583d5fb |
+-----------+--------------+---------------------------------------------+
1 row in set (0.05 sec)
FE 磁盤損壞元數(shù)據(jù)運(yùn)維
當(dāng)硬盤損壞之后,磁盤上 image 文件可能損壞,但內(nèi)存中元數(shù)據(jù)完好的情況下可以從內(nèi)存中 dump 元數(shù)據(jù),在替換磁盤上的 image 文件,來恢復(fù)元數(shù)據(jù),整個(gè)不停查詢服務(wù)的操作如下:
- 集群停止所有
load, create, alter操作 - 執(zhí)行如下命令,從
Master FE內(nèi)存中dump出元數(shù)據(jù)
# 下載元數(shù)據(jù) dump 文件 (源碼: org.apache.doris.httpv2.meta.MetaService.dump())
# 格式: curl -u $root_user:$password http://$master_hostname:8030/dump
curl -u root:root http://127.0.0.1:8030/dump
將
dump文件替換OBSERVER FE節(jié)點(diǎn)上fe/doris-meta/image目錄下的 image 文件,重啟OBSERVER FE節(jié)點(diǎn),驗(yàn)證image文件的準(zhǔn)確性(也可以通過FE Web進(jìn)行查看Database和Table的元數(shù)據(jù)是否正常,查看fe.log是否存在異常,是否正常replayed journal), 依次啟動其他FE節(jié)點(diǎn)即可集群恢復(fù)所有
load, create, alter操作
同步元數(shù)據(jù)
FE 啟動腳本中指定了 -helper 參數(shù),并且指向了正確的 leader FE 節(jié)點(diǎn),那么該 FE 首先會通過 http 向 leader 節(jié)點(diǎn)詢問自身的角色(即 ROLE)和 cluster_id。然后拉取最新的 image 文件。讀取 image 文件,生成元數(shù)據(jù)鏡像后,啟動 bdbje,開始進(jìn)行 bdbje 日志同步。同步完成后,開始回放 bdbje 中,image 文件之后的日志,完成最終的元數(shù)據(jù)鏡像生成。