mariadb-admin

mariadb-admin — это программа администрирования демона mysqld. Она может использоваться для:

• Мониторинга активности клиентов MariaDB (процессы)
• Получения статистических данных и переменных сервера MariaDB
• Создание/удаление баз данных
• Очистки (сброса) логов, статистики и таблиц
• Прерывания выполнения запросов.
• Остановки сервера (выключение)
• Запуска/остановки реплик
• Проверки работоспособности сервера (ping)

Использование mariadb-admin

Команда для использования mariadb-admin и общий синтаксис:

mariadb-admin [options] command [command-arg] [command [command-arg]] ...

Параметры

mariadb-admin поддерживает следующие параметры:

Файлы параметров

Помимо чтения параметров из командной строки, mariadb-admin также может читать параметры из файлов параметров. Если в файле параметров для mariadb-admin указана неизвестная опция, она игнорируется.

Следующие параметры относятся к обработке файлов параметров MariaDB-инструментами командной строки. Они должны быть указаны в качестве первого аргумента в командной строке:

mariadb-admin связан с MariaDB Connector/C. Однако MariaDB Connector/C пока не обрабатывает разбор файлов параметров для этого клиента. Это всё ещё выполняется кодом разбора файла параметров сервера. См. MDEV-19035 для получения дополнительной информации.

Группы параметров

mariadb-admin считывает параметры из следующих групп параметров из файлов параметров:

Переменные mariadb-admin

Переменные можно установить с помощью --variable-name=value.

Команды mariadb-admin

mariadb-admin [options] command [command-arg] [command [command-arg]] ...

Команда — это одна или несколько из следующих команд. Команды могут быть сокращены до уникального префикса.

Команда shutdown и опция --wait-for-all-slaves

Опция --wait-for-all-slaves была добавлена впервые в MariaDB 10.4.4. При выключении первичного сервера и выполнении нормальной процедуры остановки, первичный сервер убивает потоки клиентов в случайном порядке. По умолчанию первичный сервер также рассматривает свои потоки для выгрузки бинарного лога как обычные клиентские потоки. В результате потоки выгрузки бинарного лога могут быть убиты, пока клиентские потоки всё ещё существуют, и это означает, что данные могут быть записаны на первичном сервере во время обычной остановки, которые не будут реплицированы. Это верно даже если используется полусинхронная репликация.

В MariaDB 10.4 и более поздних версиях эту проблему можно решить, остановив сервер с помощью утилиты mariadb-admin и указав опцию --wait-for-all-slaves утилите и выполнив команду shutdown с помощью утилиты. Например:

mariadb-admin --wait-for-all-slaves shutdown

Когда предоставляется опция --wait-for-all-slaves, сервер убивает свои потоки выгрузки бинарного лога только после того, как все клиентские потоки будут убиты, и завершает остановку только после того, как последний бинарный журнал будет отправлен всем подключённым репликам.

См. Потоки репликации: Потоки выгрузки бинарного лога и процесс остановки для получения дополнительной информации.

Примеры

Быстрая проверка того, что делает сервер:

shell> mariadb-admin status
Uptime: 8023 Threads: 1 Questions: 14 Slow queries: 0 Opens: 15 Flush tables: 1 Open tables: 8 Queries per second avg: 0.1
shell> mariadb-admin processlist
+----+-------+-----------+----+---------+------+-------+------------------+
| Id | User | Host | db | Command | Time | State | Info |
+----+-------+-----------+----+---------+------+-------+------------------+
....
+----+-------+-----------+----+---------+------+-------+------------------+

Более подробная информация о происходящих 'прямо сейчас' изменениях (полезно для устранения неполадок на медленном сервере):

shell> mariadb-admin --relative --sleep=1 extended-status | grep -v " 0 "

Проверьте переменные работающего сервера:

shell> mariadb-admin variables | grep datadir
| datadir | /my/data/ |

Использование сокращённого префикса для команды version:

shell> mariadb-admin ver
mariadb-admin from 11.1.0-preview-MariaDB, client 9.1 for linux-systemd (x86_64)
Copyright (c) 2000, 2018, Oracle, MariaDB Corporation Ab and others.

Server version		11.1.0-preview-MariaDB
Protocol version	10
Connection		localhost via TCP/IP
TCP port		11100
Uptime:			3 min 21 sec

Threads: 1  Questions: 1  Slow queries: 0  Opens: 17  Open tables: 10  Queries per second avg: 0.004

Другие способы остановки mysqld (Unix)

Если вы получаете ошибку:

mariadb-admin: shutdown failed; error: 'Access denied; you need (at least one of) the SHUTDOWN privilege(s) for this operation'

Это означает, что вы не использовали mariadb-admin с пользователем, обладающим привилегией SUPER или SHUTDOWN.

Если вы не знаете пароль пользователя, вы всё ещё можете остановить процесс mysqld с помощью системной kill команды:

kill -SIGTERM pid-of-mysqld-process

Вышеприведённое идентично mariadb-admin shutdown.

В Windows следует использовать:

NET STOP MySQL

Вы можете использовать команду SHUTDOWN с любого клиента.

См. также

• Команда SHUTDOWN
• mytop, программа типа 'top' для MariaDB/MySQL, которая позволяет увидеть, что делает сервер. Оптимизированный для MariaDB mytop включён в MariaDB 5.3