元数据结构
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
文件之后的日志,完成最终的元数据镜像生成。