--help, -?

Вывести справку и завершить работу.

--base64-output=value

Эта опция определяет, когда события должны отображаться, закодированные как строки base-64, используя операторы BINLOG. Опция имеет следующие допустимые значения (без учёта регистра):

Примеры, показывающие влияние --base64-output и --verbose на вывод событий строк, см. в Разделе 6.6.9.2, «Отображение событий строк mysqlbinlog».

--bind-address=ip_address

На компьютере с несколькими сетевыми интерфейсами используйте эту опцию для выбора интерфейса, который будет использоваться для подключения к серверу MySQL.

--binlog-row-event-max-size=N

Укажите максимальный размер события бинарного журнала на основе строк в байтах. Строки группируются в события меньшего размера, если это возможно. Значение должно быть кратно 256. Значение по умолчанию — 4 ГБ.

--character-sets-dir=dir_name

Каталог, в котором установлены кодировки символов. См. Раздел 12.15, «Настройка кодировки символов».

--compress

Сжимать всю информацию, передаваемую между клиентом и сервером, если это возможно. См. Раздел 6.2.8, «Управление сжатием соединения».

Эта опция устарела. Ожидается, что она будет удалена в будущей версии MySQL. См. Настройка устаревшего сжатия соединения.

--compression-algorithms=value

Допустимые алгоритмы сжатия для соединений с сервером. Доступные алгоритмы такие же, как и для системной переменной protocol_compression_algorithms. Значение по умолчанию — uncompressed.

Для получения дополнительной информации см. Раздел 6.2.8, «Управление сжатием соединения».

--connection-server-id=server_id

--connection-server-id указывает идентификатор сервера, который сообщает mysqlbinlog при подключении к серверу. Его можно использовать для предотвращения конфликта с идентификатором сервера-реплики или другого процесса mysqlbinlog.

Если указана опция --read-from-remote-server, mysqlbinlog сообщает идентификатор сервера 0, который указывает серверу отключиться после отправки последнего файла журнала (поведение без блокировки). Если также указана опция --stop-never для поддержания соединения с сервером, mysqlbinlog по умолчанию сообщает идентификатор сервера 1 вместо 0, и --connection-server-id может использоваться для замены этого идентификатора сервера, если необходимо. См. Раздел 6.6.9.4, «Указание идентификатора сервера mysqlbinlog».

--database=db_name, -d db_name

Этот параметр заставляет mysqlbinlog выводить записи из двоичного журнала (только локальный журнал), которые появляются, когда db_name выбран в качестве базы данных по умолчанию USE.

Параметр --database для mysqlbinlog аналогичен параметру --binlog-do-db для mysqld, но может быть использован для указания только одной базы данных. Если --database задан несколько раз, используется только последнее значение.

Эффекты этого параметра зависят от того, используется ли формат логирования на основе операторов или на основе строк, так же как эффекты --binlog-do-db зависят от использования логирования на основе операторов или на основе строк.

Логирование на основе операторов. Параметр --database работает следующим образом:

Предположим, что двоичный журнал был создан путем выполнения этих операторов с использованием логирования на основе операторов:

INSERT INTO test.t1 (i) VALUES(100);
INSERT INTO db2.t2 (j)  VALUES(200);
USE test;
INSERT INTO test.t1 (i) VALUES(101);
INSERT INTO t1 (i)      VALUES(102);
INSERT INTO db2.t2 (j)  VALUES(201);
USE db2;
INSERT INTO test.t1 (i) VALUES(103);
INSERT INTO db2.t2 (j)  VALUES(202);
INSERT INTO t2 (j)      VALUES(203);

mysqlbinlog --database=test не выводит первые два INSERT оператора, так как нет базы данных по умолчанию. Он выводит три INSERT оператора после USE test, но не три INSERT оператора после USE db2.

mysqlbinlog --database=db2 не выводит первые два INSERT оператора, так как нет базы данных по умолчанию. Он не выводит три INSERT оператора после USE test, но выводит три INSERT оператора после USE db2.

Логирование на основе строк. mysqlbinlog выводит только записи, которые изменяют таблицы, принадлежащие db_name. База данных по умолчанию не влияет на это. Предположим, что двоичный журнал, только что описанный, был создан с использованием логирования на основе строк, а не на основе операторов. mysqlbinlog --database=test выводит только те записи, которые изменяют t1 в базе данных test, независимо от того, был ли выдан USE или какой является базой данных по умолчанию.

Если сервер работает с binlog_format, установленным на MIXED, и вы хотите использовать mysqlbinlog с параметром --database, вы должны убедиться, что измененные таблицы находятся в базе данных, выбранной оператором USE. (В частности, не следует использовать межбазовые обновления.)

При использовании вместе с параметром --rewrite-db, параметр --rewrite-db применяется первым; затем применяется параметр --database, используя переименованное имя базы данных. Порядок предоставления параметров в этом случае не имеет значения.

--debug[=debug_options], -# [debug_options]

Записать журнал отладки. Типичная строка debug_options — d:t:o,file_name. По умолчанию d:t:o,/tmp/mysqlbinlog.trace.

Этот параметр доступен только в том случае, если MySQL был скомпилирован с использованием WITH_DEBUG. Бинарные файлы релизов MySQL, предоставленные Oracle, не скомпилированы с использованием этого параметра.

--debug-check

Вывести некоторую отладочную информацию при завершении программы.

Этот параметр доступен только в том случае, если MySQL был скомпилирован с использованием WITH_DEBUG. Бинарные файлы релизов MySQL, предоставленные Oracle, не скомпилированы с использованием этого параметра.

--debug-info

Выводить отладочную информацию и статистику использования памяти и ЦП при завершении программы.

Этот параметр доступен только в том случае, если MySQL был скомпилирован с использованием WITH_DEBUG. Бинарные файлы релизов MySQL, предоставленные Oracle, не скомпилированы с использованием этого параметра.

--default-auth=plugin

Подсказка о том, какой плагин аутентификации клиента использовать. См. Раздел 8.2.17, «Плагины аутентификации».

--defaults-extra-file=file_name

Прочитать этот файл параметров после глобального файла параметров, но (в Unix) перед файлом параметров пользователя. Если файла не существует или он недоступен, произойдет ошибка. Если file_name не является абсолютным именем файла, оно интерпретируется относительно текущей директории.

Дополнительную информацию об этом и других параметрах файла см. в Разделе 6.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».

--defaults-file=file_name

Используйте только указанный файл параметров. Если файл не существует или недоступен, произойдет ошибка. Если file_name не является абсолютным путем, он интерпретируется относительно текущей директории.

Исключение: даже с --defaults-file, клиентские программы читают .mylogin.cnf.

Дополнительную информацию об этом и других параметрах файла параметров см. в Разделе 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--defaults-group-suffix=str

Читать не только обычные группы параметров, но и группы с обычными именами и суффиксом str. Например, mysqlbinlog обычно читает группы [client] и [mysqlbinlog]. Если этот параметр задан как --defaults-group-suffix=_other, mysqlbinlog также читает группы [client_other] и [mysqlbinlog_other].

Дополнительную информацию об этом и других параметрах файла параметров см. в Разделе 6.2.2.3, «Параметры командной строки, влияющие на обработку файла параметров».

--disable-log-bin, -D

Отключить двоичный лог. Это полезно для предотвращения бесконечного цикла, если вы используете параметр --to-last-log и отправляете вывод на тот же сервер MySQL. Этот параметр также полезен при восстановлении после непредвиденного выхода, чтобы избежать дублирования записанных вами инструкций.

Этот параметр заставляет mysqlbinlog включить инструкцию SET sql_log_bin = 0 в свой вывод для отключения двоичного протоколирования оставшегося вывода. Работа с системной переменной sql_log_bin является ограниченной операцией, поэтому для этого параметра требуется достаточный уровень привилегий для установки ограниченных переменных сессии. См. Раздел 7.1.9.1, «Привилегии на системные переменные».

--exclude-gtids=gtid_set

Не отображать ни одну из групп, перечисленных в gtid_set.

--force-if-open, -F

Читать файлы бинарного журнала, даже если они открыты или не были закрыты должным образом (IN_USE флаг установлен); не завершаться ошибкой, если файл заканчивается усеченным событием.

Флаг IN_USE устанавливается только для бинарного журнала, который в настоящее время записывает сервер; если сервер упал, флаг остается установленным до тех пор, пока сервер не запустится и не восстановит бинарный журнал. Без этого параметра mysqlbinlog откажется от обработки файла с этим флагом. Поскольку сервер может быть в процессе записи файла, усечение последнего события считается нормальным.

--force-read, -f

С этим параметром, если mysqlbinlog считывает событие бинарного журнала, которое он не распознает, он выводит предупреждение, игнорирует событие и продолжает работу. Без этого параметра mysqlbinlog прекращает работу, если читает такое событие.

--get-server-public-key

Запрос у сервера открытого ключа, необходимого для обмена паролем на основе пар ключей RSA. Этот параметр применяется к клиентам, которые аутентифицируются с помощью плагина аутентификации caching_sha2_password. Для этого плагина сервер не отправляет открытый ключ, если его не запросить. Этот параметр игнорируется для учетных записей, которые не аутентифицируются с помощью этого плагина. Он также игнорируется, если обмен паролями на основе RSA не используется, как в случае, когда клиент подключается к серверу с помощью защищенного соединения.

Если задан --server-public-key-path=file_name и указывает допустимый файл открытого ключа, он имеет приоритет над --get-server-public-key.

Дополнительная информация о плагине caching_sha2_password находится в Разделе 8.4.1.1, «Плагин аутентификации Caching SHA-2».

--hexdump, -H

Отображение шестнадцатеричного дампа журнала в комментариях, как описано в Разделе 6.6.9.1, «Формат шестнадцатеричного дампа mysqlbinlog». Шестнадцатеричный вывод может быть полезен для отладки репликации.

--host=host_name, -h host_name

Получить бинарный журнал с сервера MySQL на указанном хосте.

--idempotent

Указать серверу MySQL использовать режим идемпотентности при обработке обновлений; это приводит к подавлению любых ошибок дублирования ключа или отсутствия ключа, которые сервер встречает в текущей сессии при обработке обновлений. Этот параметр может быть полезен всякий раз, когда желательно или необходимо повторно воспроизвести один или несколько бинарных журналов на сервер MySQL, который может не содержать всех данных, на которые ссылаются журналы.

Сфера действия этого параметра включает только текущего клиента mysqlbinlog и сессии.

--include-gtids=gtid_set

Отображать только группы, перечисленные в gtid_set.

--local-load=dir_name, -l dir_name

Для операций загрузки данных, соответствующих операторам LOAD DATA, mysqlbinlog извлекает файлы из событий бинарного журнала, записывает их как временные файлы в локальную файловую систему и записывает операторы LOAD DATA LOCAL, чтобы вызвать загрузку файлов. По умолчанию, mysqlbinlog записывает эти временные файлы в каталог, зависящий от операционной системы. Параметр --local-load можно использовать для явного указания каталога, в котором mysqlbinlog должен подготавливать локальные временные файлы.

Поскольку другие процессы могут записывать файлы в стандартный каталог, зависящий от системы, рекомендуется указать параметр --local-load для mysqlbinlog, чтобы указать другой каталог для файлов данных, а затем указать тот же каталог, указав параметр --load-data-local-dir для mysql при обработке вывода из mysqlbinlog. Например:

mysqlbinlog --local-load=/my/local/data ...
    | mysql --load-data-local-dir=/my/local/data ...

--login-path=name

Читает параметры из указанного пути входа в файл пути входа .mylogin.cnf. “Путь входа” — это группа параметров, содержащая параметры, указывающие, к какому серверу MySQL подключаться и под каким аккаунтом выполнять аутентификацию. Для создания или изменения файла пути входа используйте утилиту mysql_config_editor. См. Раздел 6.6.7, «mysql_config_editor — Утилита конфигурации MySQL».

Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».

--no-login-paths

Пропускает чтение параметров из файла пути входа.

См. --login-path для получения дополнительной информации.

Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».

--no-defaults

Не читать никакие файлы параметров. Если запуск программы завершается ошибкой из-за чтения неизвестных параметров из файла параметров, --no-defaults можно использовать, чтобы предотвратить их чтение.

Исключением является то, что файл .mylogin.cnf читается во всех случаях, если он существует. Это позволяет указывать пароли более безопасным способом, чем в командной строке, даже когда используется --no-defaults. Для создания .mylogin.cnf используйте утилиту mysql_config_editor. См. Раздел 6.6.7, «mysql_config_editor — Утилита конфигурации MySQL».

Для получения дополнительной информации об этом и других параметрах файла параметров см. Раздел 6.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».

--offset=N, -o N

Пропускает первые N записи в журнале.

--open-files-limit=N

Указывает количество дескрипторов открытых файлов для резервирования.

--password[=password], -p[password]

Пароль учетной записи MySQL, используемой для подключения к серверу. Значение пароля является необязательным. Если он не указан, mysqlbinlog запрашивает его. Если указан, не должно быть пробела между --password= или -p и последующим паролем. Если параметр пароля не указан, по умолчанию пароль не отправляется.

Указание пароля в командной строке следует считать небезопасным. Чтобы избежать указания пароля в командной строке, используйте файл параметров. См. Раздел 8.1.2.1, «Рекомендации для конечных пользователей по безопасности паролей».

Чтобы явно указать, что пароля нет и что mysqlbinlog не должен запрашивать его, используйте параметр --skip-password.

--plugin-dir=dir_name

Каталог, в котором следует искать подключаемые модули. Укажите этот параметр, если параметр --default-auth используется для указания подключаемого модуля аутентификации, но mysqlbinlog не находит его. См. Раздел 8.2.17, «Подключаемая аутентификация».

--port=port_num, -P port_num

Номер порта TCP/IP, используемый для подключения к удаленному серверу.

--print-defaults

Выводит имя программы и все опции, полученные из файлов параметров.

Дополнительную информацию об этом и других параметрах файла см. в разделе 6.2.2.3, «Параметры командной строки, влияющие на обработку файлов параметров».

--print-table-metadata

Выводит метаданные, относящиеся к таблицам, из двоичного журнала. Настройте количество метаданных, относящихся к таблицам, залогированных в двоичном журнале, с помощью binlog-row-metadata.

--protocol={TCP|SOCKET|PIPE|MEMORY}

Протокол передачи для подключения к серверу. Это полезно, когда другие параметры подключения приводят к использованию протокола, отличного от желаемого. Подробную информацию о допустимых значениях см. в разделе 6.2.7, «Протоколы передачи соединения».

--raw

По умолчанию, mysqlbinlog считывает двоичные файлы журналов и записывает события в текстовом формате. Параметр --raw сообщает mysqlbinlog записать их в их исходном двоичном формате. Для этого также необходимо использовать --read-from-remote-server, поскольку файлы запрашиваются у сервера. mysqlbinlog записывает один выходной файл для каждого файла, считанного с сервера. Параметр --raw можно использовать для создания резервной копии двоичного журнала сервера. С параметром --stop-never резервная копия является «живой», так как mysqlbinlog остается подключенным к серверу. По умолчанию выходные файлы записываются в текущей директории с теми же именами, что и исходные файлы журналов. Имена выходных файлов можно изменить с помощью параметра --result-file. Дополнительная информация приведена в разделе 6.6.9.3, «Использование mysqlbinlog для резервного копирования двоичных журналов».

--read-from-remote-source=type

Этот параметр считывает двоичные журналы с MySQL-сервера с использованием команд COM_BINLOG_DUMP или COM_BINLOG_DUMP_GTID, соответственно устанавливая значение параметра на BINLOG-DUMP-NON-GTIDS или BINLOG-DUMP-GTIDS. Если --read-from-remote-source=BINLOG-DUMP-GTIDS используется совместно с --exclude-gtids, транзакции могут быть отфильтрованы на источнике, избегая ненужного сетевого трафика.

Параметры подключения используются с этими параметрами или с параметром --read-from-remote-server. Эти параметры — --host, --password, --port, --protocol, --socket и --user. Если ни один из параметров удаленного подключения не указан, параметры подключения игнорируются.

Для использования этих параметров требуется привилегия REPLICATION SLAVE.

--read-from-remote-master=type

Устаревшее синоним для --read-from-remote-source.

--read-from-remote-server=file_name, -R

Считывает двоичный журнал с MySQL-сервера, а не из локального файла журнала. Для этого параметра необходимо, чтобы удаленный сервер работал. Он работает только с двоичными файлами журналов на удаленном сервере, а не с файлами релейных журналов. Принимает имя двоичного файла журнала (включая числовой суффикс) без пути к файлу.

Параметры подключения используются с этим параметром или с параметром --read-from-remote-source. Эти параметры — --host, --password, --port, --protocol, --socket и --user. Если ни один из параметров удаленного подключения не указан, параметры подключения игнорируются.

Для использования этого параметра требуется привилегия REPLICATION SLAVE.

Этот параметр похож на --read-from-remote-source=BINLOG-DUMP-NON-GTIDS.

--result-file=name, -r name

Без параметра --raw этот параметр указывает файл, в который mysqlbinlog записывает текстовый вывод. С параметром --raw mysqlbinlog записывает один двоичный выходной файл для каждого файла журнала, переданного с сервера, записывая их по умолчанию в текущей директории с теми же именами, что и исходный файл журнала. В этом случае значение параметра --result-file обрабатывается как префикс, изменяющий имена выходных файлов.

--require-row-format

Требовать формат двоичного журналирования на основе строк для событий. Этот параметр навязывает события репликации на основе строк для вывода mysqlbinlog. Поток событий, полученный с этим параметром, будет принят каналом репликации, защищённым с помощью параметра REQUIRE_ROW_FORMAT инструкции CHANGE REPLICATION SOURCE TO. binlog_format=ROW должен быть установлен на сервере, где был записан двоичный журнал. При указании этого параметра mysqlbinlog завершает работу с сообщением об ошибке, если встречает какие-либо события, запрещённые ограничениями REQUIRE_ROW_FORMAT, включая инструкции LOAD DATA INFILE, создание или удаление временных таблиц, INTVAR, RAND или USER_VAR событий, а также события, не основанные на строках, в рамках транзакции DML. mysqlbinlog также выводит инструкцию SET @@session.require_row_format в начале своего вывода, чтобы применить ограничения при выполнении вывода, и не выводит инструкцию SET @@session.pseudo_thread_id.

--rewrite-db='from_name->to_name'

При чтении из журнала на основе строк или инструкций, переписывать все вхождения from_name на to_name. Переписывание выполняется для строк в журналах на основе строк, а также для клаузов USE в журналах на основе инструкций.

Правило переписывания, используемое в качестве значения для этого параметра, является строкой, имеющей форму 'from_name->to_name', как показано ранее, и по этой причине должна быть заключена в кавычки.

Для использования нескольких правил переписывания укажите параметр несколько раз, как показано здесь:

mysqlbinlog --rewrite-db='dbcurrent->dbold' --rewrite-db='dbtest->dbcurrent' \
    binlog.00001 > /tmp/statements.sql

При совместном использовании с параметром --database, параметр --rewrite-db применяется первым; затем параметр --database применяется, используя изменённое имя базы данных. Порядок предоставления параметров в этом отношении не имеет значения.

Это означает, что, например, если mysqlbinlog запускается с --rewrite-db='mydb->yourdb' --database=yourdb, то все обновления любых таблиц в базах данных mydb и yourdb включаются в вывод. С другой стороны, если он запускается с --rewrite-db='mydb->yourdb' --database=mydb, то mysqlbinlog не выводит никаких инструкций: поскольку все обновления mydb сначала переписываются как обновления yourdb перед применением параметра --database, не остаётся обновлений, соответствующих --database=mydb.

--server-id=id

Отобразить только те события, созданные сервером с заданным идентификатором сервера.

--server-id-bits=N

Использовать только первые N битов server_id для идентификации сервера. Если двоичный журнал был записан mysqld с установленным server-id-bits меньше 32 и пользовательские данные хранятся в старшем бите, запуск mysqlbinlog с установленным --server-id-bits на 32 позволит увидеть эти данные.

Этот параметр поддерживается только версией mysqlbinlog, поставляемой с дистрибутивом NDB Cluster или с поддержкой NDB Cluster.

--server-public-key-path=file_name

Имя пути к файлу в формате PEM, содержащему копию открытого ключа клиента, необходимую серверу для обмена паролями на основе пары ключей RSA. Этот параметр применяется к клиентам, которые аутентифицируются с помощью плагина аутентификации sha256_password или caching_sha2_password. Этот параметр игнорируется для учетных записей, которые не аутентифицируются с помощью одного из этих плагинов. Он также игнорируется, если обмен паролями на основе RSA не используется, как в случае, когда клиент подключается к серверу по защищённому соединению.

Если --server-public-key-path=file_name указан и указывает на действительный файл открытого ключа, он имеет приоритет над --get-server-public-key.

Для sha256_password этот параметр применяется только в том случае, если MySQL был скомпилирован с использованием OpenSSL.

Сведения о плагинах sha256_password и caching_sha2_password см. в разделе 8.4.1.2, «Плагин аутентификации SHA-256» и разделе 8.4.1.1, «Плагин аутентификации кэширования SHA-2».

--set-charset=charset_name

Добавить инструкцию SET NAMES charset_name в вывод для указания кодировки символов, которая будет использоваться для обработки файлов журналов.

--shared-memory-base-name=name

В Windows, имя разделяемой памяти для подключений, использующих разделяемую память с локальным сервером. Значение по умолчанию — MYSQL. Имя разделяемой памяти чувствительно к регистру.

Этот параметр применяется только в том случае, если сервер был запущен с включённой переменной системы shared_memory для поддержки подключений через разделяемую память.

--short-form, -s

Отобразить только инструкции, содержащиеся в журнале, без дополнительной информации или событий на основе строк. Только для тестирования и не должно использоваться в производственных системах. Устарело и ожидается удаление в будущих версиях.

--skip-gtids[=(true|false)]

Не включайте GTIDs из файлов бинарного журнала в файл вывода дампа. Например:

mysqlbinlog --skip-gtids binlog.000001 >  /tmp/dump.sql
mysql -u root -p -e "source /tmp/dump.sql"

Обычно этот параметр не следует использовать в рабочей среде или при восстановлении, за исключением особых, редких случаев, когда GTIDs активно нежелательны. Например, администратор может захотеть дублировать выбранные транзакции (например, определения таблиц) из одного развертывания в другое не связанное развертывание, которое не будет осуществлять репликацию к или из оригинального. В таком случае, --skip-gtids можно использовать, чтобы позволить администратору применить транзакции так, как если бы они были новыми, и гарантировать, что развертывания останутся не связанными. Однако этот параметр следует использовать только в том случае, если включение GTIDs вызывает известную проблему для вашего варианта использования.

--socket=path, -S path

Для соединений с localhost, используемый файл сокета Unix или, в Windows, имя именованной трубы.

В Windows этот параметр применим только в том случае, если сервер был запущен с системной переменной named_pipe, чтобы поддерживать подключения через именованные трубы. Кроме того, пользователь, устанавливающий соединение, должен быть членом группы Windows, указанной в системной переменной named_pipe_full_access_group.

--ssl*

Параметры, начинающиеся с --ssl, указывают, следует ли подключаться к серверу с шифрованием, и указывают, где найти ключи и сертификаты SSL. См. Параметры командной строки для шифрованных соединений.

--ssl-fips-mode={OFF|ON|STRICT}

Управляет включением режима FIPS на стороне клиента. Параметр --ssl-fips-mode отличается от других параметров --ssl-xxx тем, что он не используется для установления шифрованных соединений, а для определения, какие криптографические операции разрешить. См. Раздел 8.8, “Поддержка FIPS”.

Разрешены следующие значения --ssl-fips-mode:

Этот параметр устарел. Ожидайте его удаления в будущих версиях MySQL.

--start-datetime=datetime

Начать чтение бинарного журнала с первого события, имеющего метку времени, равную или более позднюю, чем аргумент datetime. Значение datetime относится к часовому поясу локальной машины, где вы выполняете mysqlbinlog. Значение должно быть в формате, принятом для типов данных DATETIME или TIMESTAMP. Например:

mysqlbinlog --start-datetime="2005-12-25 11:25:56" binlog.000003

Этот параметр полезен для восстановления по состоянию на определенный момент времени. См. Раздел 9.5, “Восстановление по состоянию на определенный момент времени (инкрементное)”.

--start-position=N, -j N

Начать декодирование бинарного журнала с позиции лога N, включая в вывод все события, начинающиеся с позиции N или позже. Позиция — это байтовая позиция в файле журнала, а не счетчик событий; она должна указывать на начальную позицию события, чтобы получить полезный вывод. Этот параметр относится к первому файлу журнала, указанному в командной строке.

Максимальное значение, поддерживаемое для этого параметра, составляет 18446744073709551616 (2⁶⁴-1), если также не используются --read-from-remote-server или --read-from-remote-source, в противном случае максимальное значение равно 4294967295.

Этот параметр полезен для восстановления по состоянию на определенный момент времени. См. Раздел 9.5, “Восстановление по состоянию на определенный момент времени (инкрементное)”.

--stop-datetime=datetime

Останов чтения бинарного журнала на первом событии, имеющем метку времени, равную или более позднюю, чем аргумент datetime. См. описание параметра --start-datetime для информации о значении datetime.

Этот параметр полезен для восстановления по состоянию на определенный момент времени. См. Раздел 9.5, “Восстановление по состоянию на определенный момент времени (инкрементное)”.

--stop-never

Эта опция используется с --read-from-remote-server. Она указывает mysqlbinlog оставаться подключенным к серверу. В противном случае mysqlbinlog завершается, когда последний файл журнала был передан с сервера. --stop-never подразумевает --to-last-log, поэтому в командной строке необходимо указать только первый файл журнала для передачи.

--stop-never обычно используется с --raw для создания резервной копии бинарного журнала в режиме реального времени, но также может использоваться без --raw для поддержания непрерывного текстового отображения событий журнала по мере их генерации сервером.

С --stop-never, по умолчанию, mysqlbinlog сообщает идентификатор сервера 1 при подключении к серверу. Используйте --connection-server-id, чтобы явно указать альтернативный идентификатор для сообщения. Это может быть использовано для предотвращения конфликта с идентификатором сервера-реплики или другого процесса mysqlbinlog. См. Раздел 6.6.9.4, «Указание идентификатора сервера mysqlbinlog».

--stop-never-slave-server-id=id

Эта опция устарела; ожидается, что она будет удалена в будущей версии. Вместо этого используйте опцию --connection-server-id для указания идентификатора сервера для mysqlbinlog для сообщения.

--stop-position=N

Остановите декодирование бинарного журнала в позиции журнала N, исключив из вывода любые события, которые начинаются в позиции N или после. Позиция представляет собой байтовую точку в файле журнала, а не счетчик событий; она должна указывать на место после начальной позиции последнего события, которое вы хотите включить в вывод. Событие, начинающееся до позиции N и заканчивающееся в указанной позиции или после нее, является последним обработанным событием. Эта опция применяется к последнему файлу журнала, указанному в командной строке.

Эта опция полезна для восстановления в определенный момент времени. См. Раздел 9.5, «Восстановление в определенный момент времени (инкрементное)».

--tls-ciphersuites=ciphersuite_list

Допустимые наборы шифров для зашифрованных соединений, использующих TLSv1.3. Значение представляет собой список из одного или нескольких имен наборов шифров, разделенных двоеточием. Наборы шифров, которые можно указать для этой опции, зависят от библиотеки SSL, используемой для компиляции MySQL. Подробнее см. Раздел 8.3.2, «Зашифрованные протоколы соединений TLS и шифры».

--tls-sni-servername=server_name

При указании имя передается в библиотеку API libmysqlclient C с помощью опции MYSQL_OPT_TLS_SNI_SERVERNAME . Имя сервера не чувствительно к регистру. Чтобы узнать, какое имя сервера указал клиент для текущего сеанса (если таковое имеется), проверьте переменную состояния Tls_sni_server_name.

Указание имени сервера (SNI) является расширением протокола TLS (OpenSSL должен быть скомпилирован с использованием расширений TLS, чтобы эта опция работала). Реализация SNI в MySQL представлена только на стороне клиента.

--tls-version=protocol_list

Допустимые протоколы TLS для зашифрованных соединений. Значение представляет собой список из одного или нескольких имен протоколов, разделенных запятыми. Протоколы, которые можно указать для этой опции, зависят от библиотеки SSL, используемой для компиляции MySQL. Подробнее см. Раздел 8.3.2, «Зашифрованные протоколы соединений TLS и шифры».

--to-last-log, -t

Не останавливайтесь в конце запрошенного бинарного журнала от сервера MySQL, а продолжайте печать до конца последнего бинарного журнала. Если вы отправляете вывод на тот же сервер MySQL, это может привести к бесконечному циклу. Для этой опции требуется --read-from-remote-server.

--user=user_name, -u user_name

Имя пользователя учетной записи MySQL, используемое при подключении к удаленному серверу.

Если вы используете плагин Rewriter, вы должны предоставить этому пользователю привилегию SKIP_QUERY_REWRITE.

--verbose, -v

Восстановите события строк и отобразите их в виде закомментированных операторов SQL, с информацией о разделах таблиц, если применимо. Если эта опция указана дважды (путем передачи либо "-vv", либо "--verbose --verbose"), вывод включает комментарии для указания типов данных столбцов и некоторых метаданных, а также информационные события журнала, такие как события журнала запросов строк, если системная переменная binlog_rows_query_log_events установлена в TRUE.

Примеры, показывающие влияние --base64-output и --verbose на вывод событий строк, см. Раздел 6.6.9.2, «Отображение событий строк mysqlbinlog».

--verify-binlog-checksum, -c

Проверить контрольные суммы в файлах бинарного журнала.

--version, -V

Отобразить информацию о версии и завершить работу.

--zstd-compression-level=level

Уровень сжатия для подключений к серверу, использующих алгоритм сжатия zstd. Разрешённые значения — от 1 до 22, причём большие значения означают более высокий уровень сжатия. По умолчанию используется уровень сжатия zstd 3. Настройка уровня сжатия не влияет на подключения, не использующие сжатие zstd.

Дополнительную информацию см. в разделе 6.2.8 «Управление сжатием подключений».