--help, -?

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

--base64-output=value

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

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

--bind-address=ip_address

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

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

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

--character-sets-dir=dir_name

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

--connection-server-id=server_id

Этот параметр используется для проверки поддержки сервера MySQL флага подключения BINLOG_DUMP_NON_BLOCK. Он не требуется для нормальной работы.

Эффективные значения по умолчанию и минимальные значения для этого параметра зависят от того, выполняется ли mysqlbinlog в режиме блокировки или в режиме без блокировки. При выполнении mysqlbinlog в режиме блокировки значение по умолчанию (и минимальное) равно 1; при выполнении в режиме без блокировки значение по умолчанию (и минимальное) равно 0.

--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

Подсказка о том, какой плагин проверки подлинности клиента использовать. См. Раздел 6.2.13, «Подключаемая аутентификация».

--defaults-extra-file=file_name

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

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

--defaults-file=file_name

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

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

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

--defaults-group-suffix=str

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

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

--disable-log-bin, -D

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

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

--exclude-gtids=gtid_set

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

--force-if-open, -F

Читать файлы бинарного журнала, даже если они открыты или не были закрыты должным образом.

--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 см. в разделе 6.4.1.4, «Плагин аутентификации Caching SHA-2».

Параметр --get-server-public-key был добавлен в MySQL 5.7.23.

--hexdump, -H

Отобразить шестнадцатеричный дамп журнала в комментариях, как описано в разделе 4.6.7.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 должен подготавливать локальные временные файлы.

--login-path=name

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

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

--no-defaults

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

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

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

--offset=N, -o N

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

--open-files-limit=N

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

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

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

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

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

--plugin-dir=dir_name

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

--port=port_num, -P port_num

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

--print-defaults

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

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

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

Транспортный протокол, используемый для подключения к серверу. Он полезен, когда другие параметры подключения обычно приводят к использованию протокола, отличного от того, который вам нужен. Подробные сведения о допустимых значениях см. в Разделе 4.2.5, «Транспортные протоколы подключения».

--raw

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

--read-from-remote-master=type

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

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

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

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

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

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

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

Эта опция аналогична --read-from-remote-master=BINLOG-DUMP-NON-GTIDS.

--result-file=name, -r name

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

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

При чтении из журнала на основе строк или операторов, перепишите все вхождения from_name на to_name. Переписывание выполняется для строк, в журналах на основе строк, а также для предложений USE в журналах на основе операторов. В версиях MySQL до 5.7.8 эта опция использовалась только при восстановлении таблиц, записанных в формате на основе строк.

Правило переписывания, используемое в качестве значения для этой опции, представляет собой строку вида '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.

--secure-auth

Не отправляйте пароли на сервер в старом формате (до 4.1). Это предотвращает подключения, за исключением серверов, использующих новый формат паролей.

Начиная с MySQL 5.7.5, этот параметр устарел; ожидается его удаление в будущих выпусках MySQL. Он всегда включен, и попытка отключить его (--skip-secure-auth, --secure-auth=0) приводит к ошибке. До MySQL 5.7.5 этот параметр включён по умолчанию, но может быть отключён.

--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 см. в Разделе 6.4.1.5, «Плагиновая аутентификация SHA-256» и Разделе 6.4.1.4, «Кеширование плагиновой аутентификации SHA-2».

Параметр --server-public-key-path был добавлен в MySQL 5.7.23.

--set-charset=charset_name

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

--shared-memory-base-name=name

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

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

--short-form, -s

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

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

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

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

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

--socket=path, -S path

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

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

--ssl*

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

--start-datetime=datetime

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

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

Этот параметр полезен для восстановления по состоянию на определённую точку времени. См. Раздел 7.5, «Восстановление по состоянию на определённую точку времени (инкрементное)».

--start-position=N, -j N

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

Этот параметр полезен для восстановления по состоянию на определённую точку времени. См. Раздел 7.5, «Восстановление по состоянию на определённую точку времени (инкрементное)».

--stop-datetime=datetime

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

Этот параметр полезен для восстановления по состоянию на определённую точку времени. См. Раздел 7.5, «Восстановление по состоянию на определённую точку времени (инкрементное)».

--stop-never

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

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

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

При использовании --stop-never, mysqlbinlog сообщает об идентификаторе сервера 65535 при подключении к серверу. --stop-never-slave-server-id явно указывает идентификатор сервера для отчёта. Его можно использовать для предотвращения конфликта с идентификатором сервера реплики или другого процесса mysqlbinlog. См. Раздел 4.6.7.4, «Указание идентификатора сервера mysqlbinlog».

--stop-position=N

Остановиться на первом событии в двоичном логе с позицией, равной или большей N. Этот параметр применяется к последнему файлу лога, указанному в командной строке.

Этот параметр полезен для восстановления по состоянию на определённую точку времени. См. Раздел 7.5, «Восстановление по состоянию на определённую точку времени (инкрементное)».

--version, -V

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

В MySQL 5.7, номер версии, отображаемый mysqlbinlog при использовании этого параметра, составляет 3.4.