磐维数据库2.0系列：postmaster文件详解

磐维数据库，简称"PanWeiDB"。是中国移动信息技术中心首个基于中国本土开源数据库打造的面向ICT基础设施的自研数据库产品。其产品内核能力基于华为openGauss开源软件，并进一步提升了系统稳定性。

当安装完磐维数据库2.0，在数据目录下可以看到一个postmaster.pid文件。

postmaster.pid文件在数据库服务启动时会自动创建，关闭时自动删除。

这个文件包含了8行内容，示例如下：

8888
/opt/data_pw_mysql
1705458171
3306
/tmp
*
2004
  3306001         0

下面的表格对应这8行内容的解释：

postmaster.pid文件有什么作用

postmaster.pid文件是一个信号文件，它表示数据库服务正常运行中。其他的程序比如监控工具可以读取该文件来判断数据库的运行状态。

数据库服务启动时如果提前检测到已经存在postmaster.pid文件，则会提示错误：

FATAL: lock file "postmaster.pid" already exists.

第1行：数据库进程的PID

第1行数据8888是数据库进程的PID

如果第1行数据值如果是负数，则表示数据库启动时设置了–single选项，在单用户模式中。

第2行：数据目录的位置

postmaster.pid文件总是在数据目录的根目录下。

第3行：数据服务从何时启动

第3行值是数据库服务运行的生命期，显示自1970-01-01以来的秒数，即epoch值，可以使用如下命令进行展示：

[panwei@node1 ~]$ date -d @`sed -n 3p /opt/data_pw_mysql/postmaster.pid`
Wed Jan 17 10:22:51 CST 2024

第4行：数据库的连接端口号

本地环境初始化时设置了B兼容性模式，使用3306作为端口。

第5行：本地socket连接路径

通过端口连接数据库有两种形式：socket连接方式和TCP/IP连接方式。socket连接方式适用于本地连接，默认socket连接路径为/tmp，生产环境通常修改为数据库目录路径。

第6行：数据库监听的网络接口

该值可以通过listen_addresses参数进行配置，通常设置为*，监听所有的网络接口。

第7行：操作系统宿主UID

第8行：数据库使用的共享内存key和shmid

每个客户端连接可以访问服务端的共享内存shared memory，共享内存在数据库启动时会创建，使用ipcs命令可以查看：