--help, -?

Отобразить сообщение справки и выйти.

--base64-output=value

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

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

--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.2, «Плагин аутентификации 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 записывает эти временные файлы в каталог, зависящий от операционной системы. Для явного указания каталога, в котором mysqlbinlog должен подготавливать локальные временные файлы, можно использовать параметр --local-load.

Поскольку другие процессы могут записывать файлы в каталог по умолчанию, зависящий от системы, рекомендуется указать параметр --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.3, «Плагин аутентификации SHA-256» и Разделе 8.4.1.2, «Плагин аутентификации кэширования 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

При указании имя передается в библиотеку libmysqlclient C API с использованием опции 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 «Управление сжатием подключений».