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

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

--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.4, «Подключаемые модули аутентификации в формате открытого текста на стороне клиента».)

--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.2, «Подключаемые модули аутентификации Caching 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.3, «Подключаемая аутентификация SHA-256», и Раздел 8.4.1.2, «Кэшируемая подключаемая аутентификация 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. Значение представляет собой список из одного или нескольких имен наборов шифров, разделенных двоеточием. Наборы шифров, которые можно указать для этого параметра, зависят от библиотеки SSL, используемой для компиляции MySQL. Подробнее см. Раздел 8.3.2, «Шифрованные протоколы и шифры соединения TLS».

--tls-sni-servername=server_name

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

--user=user_name, -u user_name

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

--verbose, -v

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

--version, -V

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

--zstd-compression-level=level

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

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