mxstate

Отображает состояние запущенной системы базы данных YMatrix.

1 Описание

mxstate используется для получения информации о состоянии кластера базы данных.
Инструмент mxstate отображает информацию о запущенном экземпляре YMatrix DB. Поскольку система базы данных YMatrix состоит из нескольких экземпляров PostgreSQL (сегментов) на множестве машин, может потребоваться дополнительная информация о системе YMatrix. Утилита mxstate предоставляет расширенные сведения о состоянии системы базы данных YMatrix, например:

  • На каком хосте сегмента произошло отключение?
  • Информация о конфигурации мастер- и сегментных узлов (хост, каталог данных и т.д.).
  • Порт, используемый системой.
  • Сопоставление основного сегмента с соответствующим зеркальным сегментом.

2 Параметры

Имя параметра Описание
-c или --db-cluster-id Идентификатор целевого кластера базы данных; если не указан, используется идентификатор по умолчанию.
-s или --detailed-status Отображение подробной информации о состоянии, включая состояние каждого узла данных (сегмента).
-o или --from-etcd-only Отображать только состояние компонентов, считанное из etcd.
-m или --list-mirrors Отображение информации о зеркальных сегментах.
-Q или --quick-status Отображение информации из таблицы каталога.
-f или --show-standby-master-details Отображение информации об узле резервного мастера.
-i или --show-version Отображение версионной информации.
-q или --quiet Режим тихой работы. Вывод команды не отображается на экране, но записывается в файл журнала.
-t или --timeout Задаёт порог времени ожидания (в секундах) при чтении состояния. Если не указано, значение по умолчанию — 60 секунд.
-h или --help Отображение справочной информации.

3 Определение полей вывода

Следующие поля вывода отображаются командой mxstate -s для хоста:

Данные вывода Описание
Master host Имя хоста мастер-узла
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 Версия PostgreSQL, на которой основана база данных Greenplum
Greenplum mirroring status Физическое зеркалирование или его отсутствие
Master standby Имя хоста резервного узла мастера
Standby master state Состояние резервного узла мастера: active или passive

Следующие поля вывода отображаются командой mxstate -s для каждого узла данных (сегмента):

Данные вывода Описание
Hostname Имя хоста, заданное в конфигурации системы
Address Имя хоста сетевого адреса (имя сетевого интерфейса)
Datadir Расположение каталога данных узла в файловой системе
Port Номер порта процесса прослушивания базы данных postgres для узла данных
Current Role Текущая роль узла данных: Mirror или Primary
Preferred Role Роль при инициализации системы: Mirror или Primary
Mirror Status Состояние пары основной/зеркальный узел данных: Synchronized = данные актуальны на обоих, Resynchronization = данные в данный момент копируются с одного на другой, Change Tracking = узел данных останавливается, активный узел записывает изменения
PID Идентификатор процесса узла данных
Configuration reports status as Состояние узла данных, зафиксированное в системном каталоге: Up/Down
Database status Реальное текущее состояние базы данных: Up/Down

Следующие поля вывода отображаются командой mxstate -f для каждого резервного узла основного узла (в таблице указано как «резервный узел»):

Данные вывода Описание
Standby address Имя хоста резервного узла
Standby data dir Расположение каталога данных резервного узла в файловой системе
Standby port Порт процесса прослушивания базы данных postgres резервного узла
Standby PID Идентификатор процесса резервного узла
Standby status Состояние резервного хоста: passive
WAL Sender State Состояние потоковой передачи предварительного журнала записи (WAL): streaming, startup, backup, catchup
Sync state Состояние синхронизации отправителя WAL: sync
Sent Location Позиция отправки записей журнала транзакций (xlog) отправителем WAL
Flush Location Позиция сброса записей xlog получателем WAL
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.

Смотрите также: mxstart, mxstop