Учёт производительности и масштабируемости

Синтаксис вызова

Синтаксис параметров — алфавитный сводный список

Параметры подключения

Параметры файлов параметров

Параметры DDL

Параметры отладки

Параметры справки

Параметры интернационализации

Параметры репликации

Параметры формата

Параметры фильтрации

Параметры производительности

Параметры транзакций

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

Примеры

Ограничения

Если ваши таблицы в основном InnoDB таблицы, или если у вас есть смесь InnoDB и MyISAM таблиц, рассмотрите возможность использования команды mysqlbackup продукта MySQL Enterprise Backup. (Доступен в рамках подписки Enterprise.) Он обеспечивает наилучшую производительность для InnoDB резервных копий с минимальными нарушениями; он также может резервировать таблицы из MyISAM и других движков хранения; и он предоставляет ряд удобных параметров для адаптации к различным сценариям резервного копирования. См. Раздел 28.1, «Обзор MySQL Enterprise Backup».

--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. Например, mysqldump обычно читает группы [client] и [mysqldump]. Если эта опция задана как --defaults-group-suffix=_other, mysqldump также читает группы [client_other] и [mysqldump_other].

Дополнительную информацию об этом и других опциях файлов опций см. в разделе 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, «Командные строки, влияющие на обработку файлов опций».

--print-defaults

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

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

--add-drop-database

Напишите оператор DROP DATABASE перед каждым оператором CREATE DATABASE. Этот параметр обычно используется совместно с параметром --all-databases или --databases, поскольку операторы CREATE DATABASE не записываются, если не указан один из этих параметров.

--add-drop-table

Напишите оператор DROP TABLE перед каждым оператором CREATE TABLE.

--add-drop-trigger

Напишите оператор DROP TRIGGER перед каждым оператором CREATE TRIGGER.

--all-tablespaces, -Y

Добавляет в дамп таблицы все SQL-операторы, необходимые для создания всех табличных пространств, используемых таблицей NDB. Эта информация не включается в вывод из mysqldump. Этот параметр в настоящее время актуален только для таблиц NDB Cluster, которые не поддерживаются в MySQL 5.7.

--no-create-db, -n

Подавляет операторы CREATE DATABASE, которые в противном случае включаются в вывод, если указан параметр --databases или --all-databases.

--no-create-info, -t

Не записывать операторы CREATE TABLE, создающие каждую скопированную таблицу.

--no-tablespaces, -y

Этот параметр подавляет все операторы CREATE LOGFILE GROUP и CREATE TABLESPACE в выводе mysqldump.

--replace

Записывать операторы REPLACE вместо операторов INSERT.

--allow-keywords

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

--comments, -i

Записывает дополнительную информацию в файл выгрузки, такую как версия программы, версия сервера и хост. Этот параметр включён по умолчанию. Чтобы отключить эту дополнительную информацию, используйте --skip-comments.

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

Записывает отладочный журнал. Типичная строка debug_options имеет вид d:t:o,file_name. Значение по умолчанию - d:t:o,/tmp/mysqldump.trace.

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

--debug-check

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

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

--debug-info

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

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

--dump-date

Если указан параметр --comments, mysqldump добавляет комментарий в конце выгрузки следующего вида:

-- Dump completed on DATE

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

--force, -f

Игнорирует все ошибки; продолжает выполнение даже в случае возникновения SQL-ошибки во время выгрузки таблицы.

Одно из применений этого параметра — продолжить выполнение mysqldump даже при встрече представления, ставшее недействительным, потому что его определение ссылается на таблицу, которая была удалена. Без --force, mysqldump завершается с сообщением об ошибке. С --force, mysqldump выводит сообщение об ошибке, но также записывает SQL-комментарий, содержащий определение представления, в вывод выгрузки и продолжает выполнение.

Если параметр --ignore-error также указан для игнорирования определённых ошибок, --force имеет приоритет.

--log-error=file_name

Ведёт журнал предупреждений и ошибок, добавляя их в указанный файл. По умолчанию ведение журнала отключено.

--skip-comments

См. описание параметра --comments.

--verbose, -v

Режим подробного вывода. Выводит больше информации о действиях программы.

--help, -?

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

--version, -V

Выводит информацию о версии и завершает работу.

Настройка каталога символьных наборов

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

Настройка набора символов по умолчанию

Используйте charset_name в качестве набора символов по умолчанию. См. Раздел 10.15, «Настройка наборов символов». Если набор символов не указан, mysqldump использует utf8.

Отключение автоматической установки набора символов, -N

Отключает настройку --set-charset, что эквивалентно указанию --skip-set-charset.

Установка набора символов

Записывает SET NAMES default_character_set в выходные данные. Этот параметр включен по умолчанию. Чтобы подавить SET NAMES, используйте --skip-set-charset.

--all-databases, -A

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

--databases, -B

Выполняет дамп нескольких баз данных. Обычно mysqldump обрабатывает первое имя аргумента в командной строке как имя базы данных, а последующие имена — как имена таблиц. С этой опцией все аргументы имен обрабатываются как имена баз данных. В вывод включаются инструкции CREATE DATABASE и USE перед каждой новой базой данных.

Эта опция может быть использована для дампа баз данных INFORMATION_SCHEMA и performance_schema, которые обычно не дампятся даже с опцией --all-databases. (Также используйте опцию --skip-lock-tables.)

--events, -E

Включает события планировщика событий для дампируемых баз данных в выходные данные. Для этих баз данных необходимы привилегии EVENT.

Выходные данные, созданные при использовании --events, содержат инструкции CREATE EVENT для создания событий. Однако эти инструкции не включают атрибуты, такие как метки времени создания и изменения события, поэтому при перезагрузке события создаются с метками времени, равными времени перезагрузки.

Если вам требуется, чтобы события создавались с исходными атрибутами меток времени, не используйте --events. Вместо этого выполните дамп и перезагрузку содержимого таблицы mysql.event напрямую, используя учетную запись MySQL с соответствующими привилегиями для базы данных mysql.

--ignore-error=error[,error]...

Игнорировать указанные ошибки. Значение опции — список номеров ошибок, разделенных запятыми, указывающих на ошибки, которые нужно игнорировать во время выполнения mysqldump. Если также задана опция --force для игнорирования всех ошибок, --force имеет приоритет.

--ignore-table=db_name.tbl_name

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

--no-data, -d

Не записывать информацию о строках таблицы (то есть не выполнять дамп содержимого таблицы). Это полезно, если вы хотите выполнить дамп только инструкции CREATE TABLE для таблицы (например, для создания пустой копии таблицы путем загрузки файла дампа).

--routines, -R

Включать хранимые процедуры (процедуры и функции) для дампируемых баз данных в выходные данные. Для этого требуется привилегия SELECT для таблицы mysql.proc.

Выходные данные, созданные при использовании --routines, содержат инструкции CREATE PROCEDURE и CREATE FUNCTION для создания процедур. Однако эти инструкции не включают атрибуты, такие как метки времени создания и изменения процедуры, поэтому при перезагрузке процедуры создаются с метками времени, равными времени перезагрузки.

Если вам требуется, чтобы процедуры создавались с исходными атрибутами меток времени, не используйте --routines. Вместо этого выполните дамп и перезагрузку содержимого таблицы mysql.proc напрямую, используя учетную запись MySQL с соответствующими привилегиями для базы данных mysql.

--tables

Переопределяет опцию --databases или -B. mysqldump рассматривает все аргументы имен, следующие за опцией, как имена таблиц.

--triggers

Включать триггеры для каждой дампируемой таблицы в выходные данные. Эта опция включена по умолчанию; отключите её с помощью --skip-triggers.

Для возможности выполнить дамп триггеров таблицы, у вас должны быть привилегии TRIGGER для таблицы.

Допускается несколько триггеров. mysqldump выполняет дамп триггеров в порядке активации, чтобы при перезагрузке файла дампа триггеры создавались в том же порядке активации. Однако если файл дампа mysqldump содержит несколько триггеров для таблицы с одинаковым событием и временем действия триггера, при попытке загрузить файл дампа в более старую версию сервера, не поддерживающую несколько триггеров, возникает ошибка. (Для обходного решения см. Раздел 2.11.3, «Примечания по переходу к предыдущим версиям»; вы можете преобразовать триггеры в формат, совместимый со старыми серверами.)

--where='where_condition', -w 'where_condition'

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

Примеры:

--where="user='jimf'"
-w"userid>1"
-w"userid<1"

Непереводимое --disable-keys, Непереводимое -K

Для каждой таблицы заключите операторы INSERT в операторы /*!40000 ALTER TABLE tbl_name DISABLE KEYS */; и /*!40000 ALTER TABLE tbl_name ENABLE KEYS */;. Это ускоряет загрузку файла дампа, поскольку индексы создаются после вставки всех строк. Этот параметр эффективен только для не уникальных индексов таблиц MyISAM.

Непереводимое --extended-insert, Непереводимое -e

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

Непереводимое --insert-ignore

Напишите операторы INSERT IGNORE, а не операторы INSERT.

--max-allowed-packet=value

Максимальный размер буфера для связи клиент/сервер. По умолчанию 24 МБ, максимум 1 ГБ.

--net-buffer-length=value

Начальный размер буфера для связи клиент/сервер. При создании операторов INSERT для нескольких строк (как с параметром --extended-insert или --opt), mysqldump создает строки длиной до --net-buffer-length байт. Если вы увеличиваете эту переменную, убедитесь, что системная переменная MySQL-сервера net_buffer_length имеет значение не меньше этого.

Непереводимое --opt

Этот параметр, включенный по умолчанию, является сокращенной записью для комбинации --add-drop-table --add-locks --create-options --disable-keys --extended-insert --lock-tables --quick --set-charset. Он обеспечивает быструю работу дампинга и создает дамповый файл, который можно быстро загрузить в MySQL-сервер.

Поскольку параметр --opt включен по умолчанию, вы указываете только обратное, параметр --skip-opt, чтобы отключить несколько параметров по умолчанию. См. обсуждение mysqldump групп параметров для получения информации о выборочном включении или отключении подмножества параметров, на которые влияет --opt.

Непереводимое --quick, Непереводимое -q

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

Непереводимое --skip-opt

См. описание параметра --opt.

--add-locks

Окружите каждый сброс таблицы операторами LOCK TABLES и UNLOCK TABLES. Это ускоряет вставки при повторном загрузке файла сброса. См. Раздел 8.2.4.1, «Оптимизация операторов INSERT».

--flush-logs, -F

Очистите файлы журналов сервера MySQL перед началом сброса. Для этой опции требуется привилегия RELOAD. Если вы используете эту опцию в сочетании с опцией --all-databases, журналы очищаются для каждой сбрасываемой базы данных. Исключением являются случаи использования --lock-all-tables, --master-data или --single-transaction: в этих случаях журналы очищаются только один раз, что соответствует моменту блокировки всех таблиц с помощью FLUSH TABLES WITH READ LOCK. Если вы хотите, чтобы сброс и очистка журнала происходили в один момент, используйте --flush-logs вместе с --lock-all-tables, --master-data или --single-transaction.

--flush-privileges

Добавьте оператор FLUSH PRIVILEGES в выходные данные сброса после сброса базы данных mysql. Эта опция должна использоваться всякий раз, когда сброс содержит базу данных mysql и любые другие базы данных, зависящие от данных в базе данных mysql для правильного восстановления.

Поскольку файл сброса содержит оператор FLUSH PRIVILEGES, для загрузки файла требуются привилегии, достаточные для выполнения этого оператора.

--lock-all-tables, -x

Блокировать все таблицы во всех базах данных. Это достигается путем получения глобальной блокировки для чтения на период всего сброса. Эта опция автоматически отключает --single-transaction и --lock-tables.

--lock-tables, -l

Для каждой сбрасываемой базы данных заблокировать все таблицы перед их сбросом. Таблицы блокируются с помощью READ LOCAL для разрешения одновременных вставок в случае MyISAM таблиц. Для транзакционных таблиц, таких как InnoDB, --single-transaction — намного лучший вариант, чем --lock-tables, так как он вообще не требует блокировки таблиц.

Поскольку --lock-tables блокирует таблицы для каждой базы данных отдельно, эта опция не гарантирует логической непротиворечивости таблиц в файле сброса между базами данных. Таблицы в разных базах данных могут быть сброшены в совершенно разных состояниях.

Некоторые опции, такие как --opt, автоматически включают --lock-tables. Если вы хотите переопределить это, используйте --skip-lock-tables в конце списка опций.

--no-autocommit

Заключите операторы INSERT для каждой сбрасываемой таблицы в операторы SET autocommit = 0 и COMMIT.

--order-by-primary

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

--shared-memory-base-name=name

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

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

--single-transaction

Эта опция устанавливает режим изоляции транзакций в REPEATABLE READ и отправляет оператор SQL START TRANSACTION на сервер перед сбросом данных. Он полезен только с транзакционными таблицами, такими как InnoDB, так как тогда он сбрасывает согласованное состояние базы данных на момент выполнения START TRANSACTION без блокировки каких-либо приложений.

Привилегия RELOAD или FLUSH_TABLES требуется с --single-transaction, если gtid_mode=ON и --set-gtid=purged=ON|AUTO. Это требование было добавлено в MySQL 8.0.32.

При использовании этой опции следует помнить, что только InnoDB таблицы сбрасываются в согласованном состоянии. Например, любые MyISAM или MEMORY таблицы, сброшенные при использовании этой опции, могут по-прежнему изменять состояние.

Во время сброса с помощью --single-transaction, для обеспечения корректного файла сброса (правильное содержимое таблиц и координаты двоичного журнала) ни одно другое подключение не должно использовать следующие операторы: ALTER TABLE, CREATE TABLE, DROP TABLE, RENAME TABLE, TRUNCATE TABLE. Согласованный доступ не изолирован от этих операторов, поэтому их использование в отношении таблицы, подлежащей сбросу, может привести к тому, что операция SELECT, выполняемая mysqldump для получения содержимого таблицы, выдаст некорректное содержимое или завершится ошибкой.

Опция --single-transaction и опция --lock-tables взаимно исключают друг друга, так как LOCK TABLES приводит к неявной фиксации всех ожидающих транзакций.

Использование --single-transaction вместе с опцией --set-gtid-purged не рекомендуется; это может привести к несогласованности вывода mysqldump.

Для сброса больших таблиц объедините опцию --single-transaction с опцией --quick.

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

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

Чтобы выбрать эффект опции --opt, за исключением некоторых функций, используйте опцию --skip для каждой функции. Чтобы отключить расширенные вставки и кэширование памяти, используйте --opt --skip-extended-insert --skip-quick. (На самом деле, --skip-extended-insert --skip-quick достаточно, так как --opt включена по умолчанию.)

Чтобы отменить --opt для всех функций, кроме отключения индексов и блокировки таблиц, используйте --skip-opt --disable-keys --lock-tables.