mxstate

显示正在运行的 YMatrix 数据库系统的状态。

1 描述

mxstate 用于获取数据库集群状态信息。
mxstate 工具显示有关正在运行的 YMatrix 数据库实例的信息。由于 YMatrix 数据库系统由跨多台机器的多个PostgreSQL数据库实例（Segment）组成，因此你可能需要了解关于 YMatrix 数据库系统的额外信息。mxstate 工具为 YMatrix 数据库系统提供了额外的状态信息，例如：

哪台 Segment 主机已被关闭？
Master 和 Segment 配置信息（主机、数据目录等）。
系统使用的端口。
主 Segment 到其相应的镜像 Segment 的映射。

2 参数选项

参数名	描述
-c 或 --db-cluster-id <数据库集群 ID>	目标数据库集群的 ID，如果省略则使用默认 ID。
-s 或 --detailed-status	显示详细的状态信息，包括各个数据节点（segment）的状态
-o 或 --from-etcd-only	只显示从 etcd 读取的各个组件的状态
-m 或 --list-mirrors	显示镜像节点（mirror segment）的信息
-Q 或 --quick-status	显示 catalogue 表中的信息
-f 或 --show-standby-master-details	显示备用节点（standby segment）的信息
-i 或 --show-version	显示版本信息
-q 或 --quiet	以静默模式运行。命令输出不显示在屏幕上，但仍然写入日志文件。
-t 或 --timeout <超时时间>	指定读取状态等待停止的超时阈值（以秒为单位）。如果未指定，则默认超时时间为 60 秒。
-h 或 --help	显示帮助信息

3 输出字段定义

以下输出字段由主机的 mxstate -s 报告：

输出数据	描述
Master host	主节点（Master）的主机名
Master postgres process ID	主数据库侦听进程的PID
Master data directory	主数据目录的文件系统位置
Master port	主节点上 postgres 数据库监听器进程的端口
Master current role	dispatch = 常规操作模式，utility = 维护模式
Greenplum initsystem version	系统第一次初始化时的 Greenplum 数据库版本
Greenplum current version	Greenplum 数据库当前的版本
Postgres version	Greenplum 数据库基于的 PostgreSQL 版本
Greenplum mirroring status	物理镜像或无镜像
Master standby	主节点备用节点的主机名
Standby master state	主节点备用节点的状态：活跃或被动

以下输出字段由 mxstate -s 为每个数据节点（Segment）报告：

输出数据	描述
Hostname	系统配置的主机名
Address	网络地址主机名（NIC 名称）
Datadir	数据节点数据目录的文件系统位置
Port	数据节点的 postgres 数据库监听器进程的端口号
Current Role	数据节点的当前角色：Mirror 或 Primary
Preferred Role	系统初始化时的角色：Mirror 或 Primary
Mirror Status	主/镜像数据节点对的状态：Synchronized = 两者上的数据都是最新，Resynchronization = 数据当前正被从一个拷贝到另一个，Change Tracking = 数据节点停止并且活动数据节点正在记录更改
PID	数据节点的进程 ID
Configuration reports status as	系统目录中记录的数据节点状态：Up/Down
Database status	当前数据库的真实状态：Up/Down

以下输出字段由 mxstate -f 为每个主节点备用节点（表中简称“备用节点”）复制状态报告：

输出数据	描述
Standby address	备用节点的主机名
Standby data dir	备用节点的数据目录的文件系统位置
Standby port	备用节点的 postgres 数据库监听器进程的端口
Standby PID	备用节点的进程 ID
Standby status	备用节点的状态：Standby host passive
WAL Sender State	预写式日志（WAL）流状态： streaming、 startup、backup、catchup
Sync state	WAL 发送者同步状态：sync
Sent Location	WAL 发送者事务日志（xlog）记录发送位置
Flush Location	WAL 接收者 xlog 记录刷入位置
Replay Location	后备上 xlog 记录重放位置

4 示例

显示默认数据库集群状态：

mxstate

显示默认数据库集群的详细信息：

mxstate -s

#or

mxstate --detailed-status

显示默认数据库集群的版本：

mxstate -i

#or

mxstate --show-version

显示关于镜像节点的信息：

mxstate -m

#or

mxstate --list-mirrors

显示关于主节点备用节点配置的信息：

mxstate -f

#or

mxstate --show-standby-master-details

注意！ YMatrix 5 部署了全新的数据库架构，启用 mxstate 工具来查看集群状态信息，与 gpstate 不兼容。之前版本可使用 gpstate 工具。

mxstate

1 描述

2 参数选项

3 输出字段定义

4 示例

另见：mxstart，mxstop