元数据结构
fe/doris-meta > tree .
.
├── bdb # bdb 为 分布式 KV 系统,存放元数据的 journal
│ ├── 00000000.jdb # bdbje 的数据文件
│ ├── je.config.csv
│ ├── je.info.0 # bdbje 的运行日志
│ ├── je.info.0.lck
│ ├── je.lck
│ └── je.stat.csv
└── image # 用于存放 Doris 定期生成的元数据镜像文件
├── image.xxx # 后缀 xxx 表明 image 所包含的最后一条日志的 id
├── image.ckpt # 正在写入的 image 文件,如果写入成功,会重命名为 image.[logid],并替换掉旧的 image 文件。
├── ROLE # 文件记录了 FE 的类型(FOLLOWER 或 OBSERVER),是一个文本文件
└── VERSION # 文件记录了这个 Doris 集群的 cluster id,以及用于各个节点之间访问认证的 token,也是一个文本文件。
注 修改配置之后,需要通过 metadata_failure_recovery=true 来清空 bdbje 的元数据, 因此当修改 FE 端口等都可以通过在 fe/conf/fe.conf 的方式来使其生效即可,然后将 fe.conf 文件中的 metadata_failure_recovery=true 删除防止下次再次清除咯。(源码: org.apache.doris.journal.bdbje.BDBDebugger)
查看 bdbje 数据
- 进入调试模式
修改 fe.conf 文件增加 enable_bdbje_debug_mode=true , 然后通过 sh start_fe.sh --daemon 启动 FE 即可进入 debug 模式。 进入 debug 模式之后,仅会启动 http server 和 MySQLServer 并打开 BDBJE 实例,但不会进入任何元数据的加载及后续其他启动流程。
- 查看
BDBJE数据
进入 FE web ui 或 MySQL 客户端访问 Doris 服务:
# 查看 bdbje 数据库列表
mysql> show proc "/bdbje";
+----------+---------------+---------+
| DbNames | JournalNumber | Comment |
+----------+---------------+---------+
| metricDB | 430694 | |
+----------+---------------+---------+
# 查看库内数据实例列表
mysql> show proc "/bdbje/metricDB";
+-----------+
| JournalId |
+-----------+
| 1 |
| 2 |
+-----------+
4273 rows in set (0.06 sec)
# 查看数据值
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 磁盘损坏元数据运维
当硬盘损坏之后,磁盘上 image 文件可能损坏,但内存中元数据完好的情况下可以从内存中 dump 元数据,在替换磁盘上的 image 文件,来恢复元数据,整个不停查询服务的操作如下:
- 集群停止所有
load, create, alter操作 - 执行如下命令,从
Master FE内存中dump出元数据
# 下载元数据 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节点上fe/doris-meta/image目录下的 image 文件,重启OBSERVER FE节点,验证image文件的准确性(也可以通过FE Web进行查看Database和Table的元数据是否正常,查看fe.log是否存在异常,是否正常replayed journal), 依次启动其他FE节点即可 -
集群恢复所有
load, create, alter操作
同步元数据
FE 启动脚本中指定了 -helper 参数,并且指向了正确的 leader FE 节点,那么该 FE 首先会通过 http 向 leader 节点询问自身的角色(即 ROLE)和 cluster_id。然后拉取最新的 image 文件。读取 image 文件,生成元数据镜像后,启动 bdbje,开始进行 bdbje 日志同步。同步完成后,开始回放 bdbje 中,image 文件之后的日志,完成最终的元数据镜像生成。












网友评论