--help, -?

显示帮助消息并退出。

--auto-generate-sql, -a

如果未在文件中提供或使用命令选项提供 SQL 语句，则自动生成 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

要为自动测试生成多少个不同的查询。例如，如果运行执行 1000 次选择的 key 测试，则可以使用此选项，其值为 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。

仅当使用WITH_DEBUG 构建 MySQL 时，此选项才可用。Oracle 提供的 MySQL 发行版二进制文件不使用此选项构建。

--debug-check

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

仅当使用WITH_DEBUG 构建 MySQL 时，此选项才可用。Oracle 提供的 MySQL 发行版二进制文件不使用此选项构建。

--debug-info, -T

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

仅当使用WITH_DEBUG 构建 MySQL 时，此选项才可用。Oracle 提供的 MySQL 发行版二进制文件不使用此选项构建。

--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 节“缓存 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

如果指定了 --auto-generate-sql，则要使用的 VARCHAR 列数。

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

如果指定了 --auto-generate-sql，则要使用的 INT 列数。

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

用于连接到服务器的 MySQL 帐户的多因素身份验证因素 1 的密码。密码值是可选的。如果未给出，mysqlslap 会提示您输入。如果给出，则 --password1= 与其后的密码之间 不得有空格。如果未指定密码选项，则默认情况下不发送密码。

在命令行上指定密码应被视为不安全。为避免在命令行上提供密码，请使用选项文件。请参阅 第 8.1.2.1 节“最终用户密码安全指南”。

要明确指定没有密码并且 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 系统变量的服务器启动以支持命名管道连接时，此选项才适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

--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=值, -q 值

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

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

PEM 格式文件的路径名，该文件包含服务器所需的用于基于 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 可插拔身份验证”和第 8.4.1.2 节“缓存 SHA-2 可插拔身份验证”。

--shared-memory-base-name=名称

在 Windows 上，用于使用共享内存连接到本地服务器的共享内存名称。默认值为 MYSQL。共享内存名称区分大小写。

仅当使用启用 shared_memory 系统变量启动服务器以支持共享内存连接时，此选项才适用。

--silent, -s

静默模式。无输出。

--socket=路径, -S 路径

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

在 Windows 上，仅当使用启用 named_pipe 系统变量启动服务器以支持命名管道连接时，此选项才适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

--sql-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=密码套件列表

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

--tls-sni-servername=服务器名称

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

服务器名称指示 (SNI) 是 TLS 协议的扩展（必须使用 TLS 扩展编译 OpenSSL 才能使此选项生效）。MySQL 对 SNI 的实现仅代表客户端。

--tls-version=协议列表

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

--user=用户名, -u 用户名

用于连接服务器的 MySQL 帐户的用户名。

--verbose, -v

详细模式。打印有关程序功能的更多信息。此选项可以使用多次以增加信息量。

--version, -V

显示版本信息并退出。

--zstd-compression-level=级别

用于使用 zstd 压缩算法连接到服务器的压缩级别。允许的级别为 1 到 22，值越大表示压缩级别越高。默认的 zstd 压缩级别为 3。压缩级别设置对不使用 zstd 压缩的连接没有影响。

有关更多信息，请参阅第 6.2.8 节“连接压缩控制”。