4.6.8. mysqlbinlog — Утилита для Обработки Двоичных Файлов журнала

--help, -?

Выведите на экран сообщение справки и выход.

--base64-output=value

Эта опция определяет, когда события должны быть выведены на экран закодированные как основа 64 строковых использования BINLOG операторы. У опции есть эти допустимые значения (не чувствительный к регистру):

Для примеров, которые показывают эффект --base64-output и --verbose на выводе события строки см. Раздел 4.6.8.2, "mysqlbinlog Дисплей События Строки" .

--bind-address=ip_address

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

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

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

--character-sets-dir=path

Каталог, где наборы символов устанавливаются. См. Раздел 10.5, "Конфигурация Набора символов".

--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 в тестовой базе данных, независимо от ли USE был выпущен или какова база данных значения по умолчанию.

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

До MySQL 5.7.1, --database опция не работала правильно с журналом, записанным сервером MySQL GTID-enabled. (Ошибка #15912728)

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

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

--debug-check

Напечатайте некоторую отладочную информацию, когда программа выходит.

--debug-info

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

--default-auth=plugin

Клиентский плагин аутентификации, чтобы использовать. См. Раздел 6.3.7, "Сменная Аутентификация".

--disable-log-bin, -D

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

Эта опция требует, чтобы Вы имели SUPER полномочие. Это заставляет mysqlbinlog включать a SET sql_log_bin = 0 оператор в его выводе, чтобы отключить двоичное журналирование остающегося вывода. SET оператор неэффективен, если Вы не имеете SUPER полномочие.

--exclude-gtids=gtid_set

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

--force-if-open, -F

Считайте двоичные файлы журнала, даже если они открыты или не были закрыты должным образом.

--force-read, -f

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

--hexdump, -H

Выведите на экран шестнадцатеричный дамп журнала в комментариях, как описано в Разделе 4.6.8.1, "mysqlbinlog Шестнадцатеричный Формат Дампа". Шестнадцатеричный вывод может быть полезным для отладки репликации.

--host=host_name, -h host_name

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

--idempotent

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

Контекст эффекта для этой опции включает ток mysqlbinlog клиент и сеанс только.

--idempotent опция была представлена в MySQL 5.7.0.

--include-gtids=gtid_set

Выведите на экран только группы, перечисленные в gtid_set.

--local-load=path, -l path

Подготовьте локальные временные файлы к LOAD DATA INFILE в указанном каталоге.

--offset=N, -o N

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

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

Пароль, чтобы использовать, соединяясь с сервером. Если Вы используете короткую форму опции (-p), у Вас не может быть пространства между опцией и паролем. Если Вы опускаете password значение после --password или -p опция на командной строке, mysqlbinlog запрашивает одного.

Определение пароля на командной строке нужно считать небезопасным. См. Раздел 6.1.2.1, "Направляющие линии Конечного пользователя для Безопасности Пароля". Можно использовать файл опции, чтобы избежать давать пароль на командной строке.

--plugin-dir=path

Каталог, в котором можно искать плагины. Может быть необходимо определить эту опцию если --default-auth опция используется, чтобы определить плагин аутентификации, но mysqlbinlog не находит это. См. Раздел 6.3.7, "Сменная Аутентификация".

--port=port_num, -P port_num

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

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

Протокол соединения, чтобы использовать для того, чтобы соединиться с сервером. Полезно, когда другие параметры соединения обычно заставляли бы протокол использоваться кроме того, Вы хотите. Для получения дополнительной информации на допустимых значениях, см. Раздел 4.2.2, "Соединяясь с MySQL Server".

--raw

По умолчанию mysqlbinlog читает двоичные файлы журнала и события записей в текстовом формате. --raw опция говорит mysqlbinlog писать им в их исходном двоичном формате. Его использование требует этого --read-from-remote-server также используйтесь, потому что файлы требуют от сервера. mysqlbinlog пишет один выходной файл для каждого файла, считанного из сервера. --raw опция может использоваться, чтобы сделать резервное копирование двоичного журнала сервера. С --stop-never опция, резервное копирование "живо", потому что mysqlbinlog остается соединенным с сервером. По умолчанию выходные файлы пишутся в текущем каталоге с теми же самыми именами как исходные файлы журнала. Имена выходного файла могут быть изменены, используя --result-file опция. Для получения дополнительной информации см. Раздел 4.6.8.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.

--read-from-remote-server, -R

Считайте двоичный журнал из сервера MySQL вместо того, чтобы читать локальный файл журнала. Любые опции параметра соединения игнорируются, если эта опция не дается также. Эти опции --host, --password, --port, --protocol, --socket, и --user.

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

Эта опция походит --read-from-remote-master=BINLOG-DUMP-NON-GTIDS.

--result-file=name, -r name

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

--rewrite-db='dboldname->dbnewname'

Читая из основанного на строке журнала, перепишите все возникновения dboldname к dbnewname. Для использования, восстанавливая таблицы зарегистрировал использование основанного на строке формата к базе данных, имеющей другое имя от исходной базы данных.

Правило подстановки, используемое как значение для этой опции, является строкой, имеющей форму 'dboldname->dbnewname', как показано ранее, и по этой причине должен быть включен кавычками. Они могут быть единственными или двойными кавычками (' или ").

Чтобы использовать многократные правила подстановки, определите опцию многократно, как показано здесь:

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

Эта опция была добавлена в MySQL 5.7.1.

--server-id=id

Выведите на экран только те события, создаваемые сервером, имеющим данный ID сервера.

--set-charset=charset_name

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

--short-form, -s

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

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

Не выводите на экран GTIDs. Не рекомендуемый в производстве.

--socket=path, -S path

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

--start-datetime=datetime

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

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

Эта опция полезна для восстановления момента времени. См. Раздел 7.3, "Стратегия резервного копирования и восстановления в качестве примера".

--start-position=N, -j N

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

Эта опция полезна для восстановления момента времени. См. Раздел 7.3, "Стратегия резервного копирования и восстановления в качестве примера".

--stop-datetime=datetime

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

Эта опция полезна для восстановления момента времени. См. Раздел 7.3, "Стратегия резервного копирования и восстановления в качестве примера".

--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 сообщает о ID сервера 65535, когда он соединяется с сервером. --stop-never-slave-server-id явно определяет ID сервера, чтобы сообщить. Это может использоваться, чтобы избежать конфликта с ID ведомого сервера или другого процесса mysqlbinlog. См. Раздел 4.6.8.4, "Определение mysqlbinlog ID Сервера" .

--stop-position=N

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

Эта опция полезна для восстановления момента времени. См. Раздел 7.3, "Стратегия резервного копирования и восстановления в качестве примера".

--to-last-log, -t

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

--user=user_name, -u user_name

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

--verbose, -v

Восстановите события строки и выведите на экран их как прокомментированные SQL-операторы. Если эта опция дается дважды, вывод включает комментарии, чтобы указать на типы данных столбца и некоторые метаданные.

Для примеров, которые показывают эффект --base64-output и --verbose на выводе события строки см. Раздел 4.6.8.2, "mysqlbinlog Дисплей События Строки" .

--verify-binlog-checksum, -c

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

--version, -V

Выведите на экран информацию о версии и выход.

В MySQL 5.7.1 и позже, mysqlbinlog номер версии, показанный при использовании этой опции, 3.4. (Ошибка #15894381, Ошибка #67643)

open_files_limit

Определите число открытых дескрипторов файлов, чтобы зарезервировать.