mxstop

Остановка или перезапуск системы базы данных YMatrix.

1 Описание

Утилита mxstop используется для остановки, перезапуска или перезагрузки конфигурационных файлов кластера YMatrix. Когда вы останавливаете кластер YMatrix, фактически завершаются несколько процессов сервера базы данных postgres, управляемых службой репликации данных. Инструмент mxstop использует службу репликации данных для выполнения операций завершения на всех экземплярах.

По умолчанию остановка кластера запрещена, если имеются активные клиентские подключения. Используйте опцию -M fast, чтобы откатить все выполняющиеся транзакции и завершить все соединения. Если транзакции выполняются, по умолчанию система будет ожидать их завершения перед остановкой.

Используйте опцию -u, чтобы перезагрузить конфигурационные файлы. Это приведёт к повторной загрузке файла pg_hba.conf и параметров времени выполнения, определённых в файле postgresql.conf, на всех экземплярах postgres.

2 Параметры

Параметр Описание
-c или --db-cluster-id <идентификатор кластера базы данных> Указывает целевой идентификатор кластера базы данных. Если параметр не указан, используется идентификатор по умолчанию.
-m Останавливает мастер-экземпляр, запущенный в режиме утилиты.
-M fast Быстрая остановка. Откатывает все текущие активные транзакции и отключает пользователей.
-M immediate Немедленная остановка. Прерывает все активные транзакции. Данный режим завершает все процессы postgres без возможности выполнения базой данных задач очистки, таких как откат транзакций. Используйте с осторожностью.
-M smart Умная остановка. Команда завершается с предупреждением, если существуют активные подключения. Это режим по умолчанию.
-a или --no-prompt Не запрашивать подтверждение перед выполнением.
-y или --no-standby Не останавливать резервные экземпляры. По умолчанию резервные экземпляры останавливаются.
-q или --quiet Работать в тихом режиме. Вывод подавляется в терминале, но продолжает записываться в файлы журналов.
-u или --reload Перезагружает конфигурационные файлы pg_hba.conf и postgresql.conf на всех экземплярах postgres без остановки кластера. Используйте эту опцию после изменения postgresql.conf или pg_hba.conf для применения новых настроек.
Примечание: Действует только на параметры конфигурации времени выполнения.
-r или --restart Перезапустить весь кластер.
-t или --timeout <таймаут> Задаёт пороговое значение времени ожидания (в секундах) для завершения сегментных экземпляров. Если сегменты не останавливаются в течение указанного времени, mxstop выводит сообщение о том, что один или несколько сегментов всё ещё завершают работу, и кластер не может быть перезапущен до полной остановки всех сегментов. Этот параметр полезен, когда большим транзакциям требуется длительное время для отката, превышающее значение таймаута по умолчанию — 600 секунд.
-h или --help Показать справочную информацию.

3 Примеры

Остановить кластер YMatrix по умолчанию в быстром режиме без запроса подтверждения:

mxstop -a -M fast

Перезапустить кластер YMatrix без запроса подтверждения:

mxstop -ar

Перезагрузить конфигурационные файлы:

mxstop -u

Примечание!
YMatrix 5 представляет новую архитектуру базы данных и использует утилиту mxstop для управления остановкой кластера. Она несовместима с gpstop. В более ранних версиях использовалась gpstop.

См. также: mxstart, mxstate