--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时可用。Oracle提供的MySQL发布版本是不使用该选项构建的。

--debug-check

程序退出时打印一些调试信息。

这个选项只有在MySQL使用WITH_DEBUG进行编译时才可用。Oracle提供的MySQL发布版本是不使用这个选项编译的。

--debug-info, -T

程序退出时打印调试信息和内存和CPU使用统计。

这个选项只有在MySQL使用WITH_DEBUG进行编译时才可用。Oracle提供的MySQL发布版本是不使用这个选项编译的。

--default-auth=plugin

一个提示，指示应该使用哪个客户端认证插件。请参阅第8.2.17节，“可插拔认证”。

--defaults-extra-file=file_name

在全局选项文件之后但在用户选项文件之前读取这个选项文件。如果文件不存在或无法访问，会发生错误。如果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=引擎名称, -e 引擎名称

用于创建表的存储引擎。

--get-server-public-key

从服务器请求RSA公钥，该公钥用于基于密钥对的密码交换。这选项适用于连接到服务器并使用caching_sha2_password身份验证插件进行认证的客户端。对于使用该插件进行认证的连接，除非请求，否则服务器不会将公钥发送给客户端。如果RSA-基于密码交换不需要（例如，当客户端通过安全连接连接到服务器时），则选项被忽略。

如果提供了--server-public-key-path=文件名并指定了一个有效的公钥文件，它将优先于--get-server-public-key。

有关caching_sha2_password插件的信息，请参阅第8.4.1.2节，“Caching SHA-2 Pluggable Authentication”。

--host=主机名, -h 主机名

连接到MySQL服务器的给定主机上。

--iterations=N, -i N

运行测试的次数。

--login-path=名称

从名为.mylogin.cnf的登录路径文件中读取选项。一个“登录路径”是一个包含指定连接到哪个MySQL服务器以及以何种身份验证的选项组。在创建或修改登录路径文件时，请使用mysql_config_editor工具。请参阅第6.6.7节，“mysql_config_editor — MySQL Configuration Utility”。

有关此类以及其他选项文件选项的更多信息，请参阅第6.2.2.3节，“命令行选项影响选项文件处理”。

--no-login-paths

跳过从登录路径文件中读取选项。

查看--login-path的相关信息。

有关此和其他选项文件选项的更多信息，请参阅--no-drop

--no-drop

防止--no-defaults

--no-defaults

不要读取任何选项文件。如果程序启动失败，因为从选项文件中读取了未知选项，--no-...可以防止它们被读取。

The exception is that the .mylogin.cnf file is read in all cases, if it exists. This permits passwords to be specified in a safer way than on the command line even when --no-defaults is used. To create .mylogin.cnf, use the mysql_config_editor utility. See Section 6.6.7, “mysql_config_editor — MySQL Configuration Utility”.

For additional information about this and other option-file options, see Section 6.2.2.3, “Command-Line Options that Affect Option-File Handling”.

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

如果--auto-...指定，则使用的VARCHAR列数。

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

如果--auto-...指定，则使用的INT列数。

--number-of-queries=N

限制每个客户端大约执行此数量的查询。查询计数考虑了语句分隔符。例如，如果您以以下方式调用--only-print

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

--only-print

不要连接数据库。--password[=password]

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

MySQL服务器连接用的帐户密码。密码值是可选的。如果不给出，mysqlslap 会提示输入一个。如果给出，那么在--password=或-p后面不能有空格。如果没有指定密码选项，默认情况下不会发送密码。

在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码，使用选项文件。请参阅第8.1.2.1节，“End-User Guidelines for Password Security”。

要明确指定没有密码，并且mysqlslap 不会提示输入一个，使用--skip-password选项。

--password1[=pass_val]

MySQL服务器连接用的帐户的多因素认证因子1的密码。密码值是可选的。如果不给出，mysqlslap 会提示输入一个。如果给出，那么在--password1=后面不能有空格。如果没有指定密码选项，默认情况下不会发送密码。

在命令行上指定密码应该被认为是不安全的。为了避免在命令行上输入密码，使用选项文件。请参阅第8.1.2.1节，“End-User Guidelines for Password Security”。

要明确指定没有密码，并且mysqlslap 不会提示输入一个，使用--skip-password1选项。

--password1和--password是同义词，--skip-password1和--skip-password也是同义词。

--password2[=pass_val]

MySQL服务器连接用的帐户的多因素认证因子2的密码。这个选项的语义与--password1的语义相同；请参阅该选项的描述。

--password3[=pass_val]

MySQL服务器连接用的帐户的多因素认证因子3的密码。这个选项的语义与--password1的语义相同；请参阅该选项的描述。

--pipe, -W

在Windows上，使用命名管道连接到服务器。这一选项仅适用于服务器以支持命名管道连接的方式启动，并且执行连接的用户必须是指定由named_ pipe系统变量启用的Windows组成员。

--plugin-dir=dir_name

指定插件目录。只有当使用--default- auth选项来指定认证插件，但mysqlslap无法找到它时，需要指定这个选项。请参阅第8.2.17节，“可插拔认证”。

--port=端口号, -P 端口号

用于TCP/IP连接的端口号。

--post-query=值

包含测试完成后执行的语句的文件或字符串。这次执行不计入时间。

--post-system=字符串

在测试完成后使用system()执行的字符串。这次执行不计入时间。

--pre-query=值

包含在运行测试之前执行的语句的文件或字符串。这次执行不计入时间。

--pre-system=字符串

在运行测试之前使用system()执行的字符串。这次执行不计入时间。

--print-defaults

打印程序名称及其来自选项文件的所有选项。

有关此类以及其他影响选项文件处理的命令行选项的更多信息，请参阅第6.2.2.3节，“影响选项文件处理的命令行选项”。

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

用于连接到服务器的传输协议。它在其他连接参数通常导致使用不同于您想要的协议时非常有用。在可接受值的详细信息上，请参阅第6.2.7节，“连接传输协议”。

--query=值, -q 值

包含用于检索数据的SELECT语句的文件或字符串。

--server-public-key-path=文件名

到一个包含服务器所需的客户端公钥副本的文件路径，该公钥用于RSA密钥对密码交换。这项选项适用于使用sha256_password或caching_sha2_password身份验证插件的客户端。对于不使用这些插件进行身份验证的账户，这项选项将被忽略。此外，如果客户端通过安全连接与服务器通信时不使用RSA密码交换，那么这项选项也会被忽略。

如果给定--server-public-key-path=file_name并指定了一个有效的公钥文件，它将优先于--get-server-public-key。

对于sha256_password，这项选项仅适用于使用OpenSSL编译的MySQL版本。

有关sha256_password和caching_sha2_password插件的信息，请参阅第8.4.1.3节，“SHA-256 Pluggable Authentication”和第8.4.1.2节，“Caching SHA-2 Pluggable Authentication”。

--shared-memory-base-name=name

在Windows上，用于通过共享内存连接到本地服务器的共享内存名称。默认值为MYSQL。共享内存名称是大小写敏感的。

这项选项仅适用于服务器以支持共享内存连接的方式启动时启用了shared_系统变量。

--silent, -s

静默模式。没有输出。

--socket=path, -S path

对于localhost，要使用的Unix套接字文件路径，或在Windows上，要使用的命名管道名称。

在Windows上，这项选项仅适用于服务器以支持命名管道连接的方式启动时启用了named_系统变量。此外，执行连接的用户必须是指定在named_pipe_full_access_group系统变量中定义的Windows组成员。

--sql-mode=mode

为客户端会话设置SQL模式。

--ssl*

以--ssl开头的选项指定是否使用加密连接以及SSL密钥和证书的位置。请参阅命令行选项：加密连接。

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

控制是否在客户端上启用FIPS模式。与其他以--ssl-xxx开头的选项不同，--ssl-fips-mode用于控制哪些加密操作是允许的，而不是用于建立加密连接。请参阅第8.8节，“FIPS支持”。

以下是--ssl-fips-mode允许的值:

此选项已被弃用。预计它将在MySQL的未来版本中被移除。

--tls-ciphersuites=ciphersuite_list

用于TLSv1.3加密连接的允许密码套件。值是一个或多个由冒号分隔的密码套件名称列表。可以为此选项命名的密码套件取决于用来编译MySQL的SSL库。有关详细信息，请参阅第8.3.2节，“加密连接TLS协议和密码”。

--tls-sni-servername=server_name

当指定时，该名称将传递给libmysqlclient C API库，使用mysql_options()的MYSQL_OPT_TLS_SNI_SERVERNAME选项。服务器名称不区分大小写。要查看客户端为当前会话指定的服务器名称（如果有），请检查Tls_sni_server_name状态变量。

Server Name Indication (SNI) 是TLS协议的一个扩展（OpenSSL必须使用TLS扩展编译，以便此选项可用）。MySQL对SNI的实现仅限于客户端侧。

--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节，“连接压缩控制”。