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

如果指定了 --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=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，此选项仅在使用 OpenSSL 构建 MySQL 时适用。

有关 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 系统变量以支持命名管道连接的方式启动时适用。此外，进行连接的用户必须是 named_pipe_full_access_group 系统变量指定的 Windows 组的成员。

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

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

服务器名称指示 (SNI) 是 TLS 协议的扩展（必须使用 TLS 扩展编译 OpenSSL 才能使此选项起作用）。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 节，“连接压缩控制”.