--help, -?

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

--auto-generate-sql, -a

Автоматически генерировать SQL-запросы, если они не указаны в файлах или с помощью опций командной строки.

--auto-generate-sql-add-autoincrement

Добавить столбец AUTO_INCREMENT в автоматически сгенерированные таблицы.

--auto-generate-sql-execute-number=N

Указать, сколько запросов сгенерировать автоматически.

--auto-generate-sql-guid-primary

Добавить первичный ключ на основе GUID в автоматически сгенерированные таблицы.

--auto-generate-sql-load-type=type

Указать тип тестовой нагрузки. Допустимые значения: read (сканирование таблиц), write (вставка в таблицы), key (чтение первичных ключей), update (обновление первичных ключей) или mixed (половина встроек, половина сканирующих выборок). По умолчанию — mixed.

--auto-generate-sql-secondary-indexes=N

Указать, сколько дополнительных индексов добавить в автоматически созданные таблицы. По умолчанию индексы не добавляются.

--auto-generate-sql-unique-query-number=N

Сколько разных запросов генерировать для автоматических тестов. Например, если вы запускаете тест key, который выполняет 1000 выборок, вы можете использовать эту опцию со значением 1000, чтобы запустить 1000 уникальных запросов, или со значением 50, чтобы выполнить 50 различных выборок. По умолчанию — 10.

--auto-generate-sql-unique-write-number=N

Сколько различных запросов сгенерировать для --auto-generate-sql-write-number. По умолчанию — 10.

--auto-generate-sql-write-number=N

Сколько строк вставить. По умолчанию — 100.

--commit=N

Сколько инструкций выполнить перед фиксацией. По умолчанию 0 (фиксаций нет).

--compress, -C

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

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

--compression-algorithms=value

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

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

--concurrency=N, -c N

Количество параллельных клиентов для имитации.

--create=value

Файл или строка, содержащая инструкцию для создания таблицы.

--create-schema=value

Схема, в которой нужно выполнить тесты.

--csv[=file_name]

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

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

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

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

--debug-check

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

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

--debug-info, -T

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

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

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

--delimiter=str, -F str

Разделитель, используемый в операторах SQL, предоставляемых в файлах или с помощью параметров командной строки.

--detach=N

Отключить (закрыть и снова открыть) каждое соединение после каждого N оператора. Значение по умолчанию — 0 (соединения не отключаются).

--enable-cleartext-plugin

Включить плагин аутентификации открытого текста mysql_clear_password. (См. Раздел 8.4.1.3, «Подключаемая аутентификация открытого текста на стороне клиента».)

--engine=engine_name, -e engine_name

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

--get-server-public-key

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

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

Для получения информации о плагине caching_sha2_password см. Раздел 8.4.1.1, «Кэширование SHA-2 подключаемой аутентификации».

--host=host_name, -h host_name

Подключение к серверу MySQL на указанном хосте.

--iterations=N, -i N

Количество раз для выполнения тестов.

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

Запретить mysqlslap удалять любую схему, созданную во время выполнения теста.

--no-defaults

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

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

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

--number-char-cols=N, -x N

Количество столбцов типа VARCHAR для использования, если указан параметр --auto-generate-sql.

--number-int-cols=N, -y N

Количество столбцов типа INT для использования, если указан параметр --auto-generate-sql.

--number-of-queries=N

Ограничение приблизительного количества запросов для каждого клиента. Подсчет запросов учитывает разделитель операторов. Например, если вы вызываете mysqlslap следующим образом, разделитель ; распознается, поэтому каждое вхождение строки запроса учитывается как два запроса. В результате вставляются 5 строк (а не 10).

mysqlslap --delimiter=";" --number-of-queries=10
          --query="use test;insert into t values(null)"

--only-print

Не подключаться к базам данных. mysqlslap только выводит то, что должно было быть выполнено.

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

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

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

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

--password1[=pass_val]

Пароль для фактора многофакторной аутентификации 1 учётной записи MySQL, используемой для подключения к серверу. Значение пароля является необязательным. Если он не указан, mysqlslap запрашивает его. Если указан, между --password1= и последующим паролем не должно быть пробелов. Если параметр пароля не указан, по умолчанию пароль не отправляется.

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

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

--password1 и --password являются синонимами, как и --skip-password1 и --skip-password.

--password2[=pass_val]

Пароль для фактора многофакторной аутентификации 2 учётной записи MySQL, используемой для подключения к серверу. Семантика этого параметра аналогична семантике для --password1; см. описание этого параметра для получения подробной информации.

--password3[=pass_val]

Пароль для фактора многофакторной аутентификации 3 учётной записи MySQL, используемой для подключения к серверу. Семантика этого параметра аналогична семантике для --password1; см. описание этого параметра для получения подробной информации.

--pipe, -W

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

--plugin-dir=dir_name

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

--port=port_num, -P port_num

Для соединений TCP/IP номер порта для использования.

--post-query=value

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

--post-system=str

Строка для выполнения с помощью system() после завершения тестов. Это выполнение не учитывается при измерении времени.

--pre-query=value

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

--pre-system=str

Строка для выполнения с помощью system() перед запуском тестов. Это выполнение не учитывается при измерении времени.

--print-defaults

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

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

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

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

--query=value, -q value

Файл или строка, содержащие оператор SELECT для извлечения данных.

--server-public-key-path=file_name

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

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

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

Для получения информации о подключаемых модулях sha256_password и caching_sha2_password см. Раздел 8.4.1.2, «Подключаемая аутентификация SHA-256» и Раздел 8.4.1.1, «Кэшируемая подключаемая аутентификация SHA-2».

--shared-memory-base-name=name

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

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

--silent, -s

Режим без вывода.

--socket=path, -S path

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

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

--sql-mode=mode

Установка режима SQL для сеанса клиента.

--ssl*

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

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

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

Разрешенные значения параметра --ssl-fips-mode:

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

--tls-ciphersuites=ciphersuite_list

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

--tls-sni-servername=server_name

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

Server Name Indication (SNI) — расширение протокола TLS (OpenSSL должен быть скомпилирован с расширениями TLS, для работы этого параметра). Реализация SNI в MySQL представляет только сторону клиента.

--tls-version=protocol_list

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

--user=user_name, -u user_name

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

--verbose, -v

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

--version, -V

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

--zstd-compression-level=level

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

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