4.5.8 mysqlslap-一个负载仿真 Client 端

mysqlslap是一个诊断程序，旨在模拟 MySQL 服务器的 Client 端负载并报告每个阶段的时间。就像多个 Client 端正在访问服务器一样。

像这样调用mysqlslap：

shell> mysqlslap [options]

某些选项(例如--create或--query)使您可以指定包含 SQL 语句的字符串或包含语句的文件。如果指定文件，则默认情况下该文件每行必须包含一个语句。 (也就是说，隐式语句定界符是换行符.)使用--delimiter选项指定其他定界符，使您能够指定跨越多行的语句或将多条语句放在一行上。您不能在文件中包含 Comments； mysqlslap不理解它们。

mysqlslap分三个阶段运行：

  • 创建架构，table 以及可选的任何存储程序或数据以用于测试。此阶段使用单个 Client 端连接。

  • 运行负载测试。此阶段可以使用许多 Client 端连接。

  • 清理(断开连接，如果有指定的话放下桌子)。此阶段使用单个 Client 端连接。

Examples:

提供您自己的 create 和 query SQL 语句，可查询 50 个 Client 端，每个查询 200 个选择(在一行中 Importing 命令)：

mysqlslap --delimiter=";"
  --create="CREATE TABLE a (b int);INSERT INTO a VALUES (23)"
  --query="SELECT * FROM a" --concurrency=50 --iterations=200

让mysqlslap用两个INT列和三个VARCHAR列的 table 构建查询 SQL 语句。使用五个 Client 端，每个 Client 端查询 20 次。不要创建 table 或插入数据(即，使用先前测试的架构和数据)：

mysqlslap --concurrency=5 --iterations=20
  --number-int-cols=2 --number-char-cols=3
  --auto-generate-sql

告诉程序从指定的文件中加载创建，插入和查询 SQL 语句，其中create.sql文件具有多个以';'分隔的 table 创建语句和多个以';'分隔的插入语句。 --query文件将具有多个以';'分隔的查询。运行所有装入语句，然后使用五个 Client 端(每个 Client 端五次)运行查询文件中的所有查询：

mysqlslap --concurrency=5
  --iterations=5 --query=query.sql --create=create.sql
  --delimiter=";"

mysqlslap支持以下选项，可以在命令行或选项文件的[mysqlslap]和[client]组中指定这些选项。有关 MySQL 程序使用的选项文件的信息，请参见第 4.2.2.2 节“使用选项文件”。

table4.19 mysqlslap 选项

Option NameDescriptionIntroducedDeprecated
--auto-generate-sql文件中未提供或使用命令选项时自动生成 SQL 语句
--auto-generate-sql-add-autoincrement将 AUTO_INCREMENT 列添加到自动生成的 table 中
--auto-generate-sql-execute-number指定自动生成多少查询
--auto-generate-sql-guid-primary将基于 GUID 的主键添加到自动生成的 table 中
--auto-generate-sql-load-type指定测试负载类型
--auto-generate-sql-secondary-indexes指定要添加到自动生成的 table 中的二级索引的数量
--auto-generate-sql-unique-query-number自动测试生成多少个不同的查询
--auto-generate-sql-unique-write-number为--auto-generate-sql-write-number 生成多少个不同的查询
--auto-generate-sql-write-number每个线程要执行多少行插入
--commit提交前要执行多少条语句
--compress压缩 Client 端和服务器之间发送的所有信息
--concurrency发出 SELECT 语句时要模拟的 Client 端数量
--create包含用于创建 table 的语句的文件或字符串
--create-schema运行测试的架构
--csv生成以逗号分隔的值格式的输出
--debug编写调试日志
--debug-check程序退出时打印调试信息
--debug-info程序退出时打印调试信息，内存和 CPU 统计信息
--default-auth身份验证插件使用
--defaults-extra-file除常规选项文件外，还读取命名的选项文件
--defaults-file只读命名的选项文件
--defaults-group-suffix选项组后缀值
--delimiter在 SQL 语句中使用的定界符
--detach在每条 N 条语句后分离(关闭并重新打开)每个连接
--enable-cleartext-plugin启用明文身份验证插件
--engine用于创建 table 的存储引擎
--get-server-public-key从服务器请求 RSA 公钥5.7.23
--help显示帮助信息并退出
--hostMySQL 服务器所在的主机
--iterations运行测试的次数
--login-path从.mylogin.cnf 中读取登录路径选项
--no-defaults不读取选项文件
--no-drop不要删除测试运行期间创建的任何架构
--number-char-cols如果指定了--auto-generate-sql，则要使用的 VARCHAR 列数
--number-int-cols如果指定了--auto-generate-sql，则要使用的 INT 列数
--number-of-queries将每个 Client 端限制为大约此查询数量
--only-print不要连接到数据库。 mysqlslap 只打印它会做的事情
--password连接服务器时使用的密码
--pipe使用命名管道连接到服务器(仅 Windows)
--plugin-dir安装插件的目录
--port用于连接的 TCP/IP 端口号
--post-query包含要在测试完成后执行的语句的文件或字符串
--post-system测试完成后使用 system()执行的字符串
--pre-query包含要在运行测试之前执行的语句的文件或字符串
--pre-system在运行测试之前使用 system()执行的字符串
--print-defaults打印默认选项
--protocol使用的传输协议
--query包含用于检索数据的 SELECT 语句的文件或字符串
--secure-auth不要以旧(4.1 之前)格式向服务器发送密码Yes
--server-public-key-path包含 RSA 公钥的文件的路径名5.7.23
--shared-memory-base-name共享内存连接的共享内存名称(仅 Windows)
--silentSilent mode
--socketUnix 套接字文件或 Windows 命名管道使用
--sql-mode设置 Client 端会话的 SQL 模式
--ssl启用连接加密
--ssl-ca包含受信任的 SSL 证书颁发机构列 table 的文件
--ssl-capath包含受信任的 SSL 证书颁发机构证书文件的目录
--ssl-cert包含 X.509 证书的文件
--ssl-cipher连接加密的允许密码
--ssl-crl包含证书吊销列 table 的文件
--ssl-crlpath包含证书吊销列 table 文件的目录
--ssl-key包含 X.509 密钥的文件
--ssl-mode与服务器连接的所需安全状态5.7.11
--ssl-verify-server-cert根据服务器证书的通用名身份验证主机名
--tls-version允许的 TLS 协议进行加密连接5.7.10
--user连接服务器时使用的 MySQL 用户名
--verboseVerbose mode
--version显示版本信息并退出

显示帮助消息并退出。

文件中未提供或使用命令选项时，会自动生成 SQL 语句。

将AUTO_INCREMENT列添加到自动生成的 table 中。

指定要自动生成的查询数。

将基于 GUID 的主键添加到自动生成的 table 中。

指定测试负载类型。允许的值为read(扫描 table)，write(插入 table)，key(读取主键)，update(更新主键)或mixed(半插入，半扫描选择)。默认值为mixed。

指定要添加到自动生成的 table 中的二级索引的数量。默认情况下，不添加任何内容。

为自动测试生成多少个不同的查询。例如，如果您运行执行 1000 个选择的key测试，则可以将该值设置为 1000 来运行 1000 个唯一查询，或者使用值 50 来执行 50 个不同的选择。预设值为 10.

为--auto-generate-sql-write-number生成多少个不同的查询。预设值为 10.

要执行多少行插入。默认值为 100.

提交前要执行多少条语句。默认值为 0(不执行任何提交)。

尽可能压缩 Client 端和服务器之间发送的所有信息。参见第 4.2.6 节“连接压缩控制”。

要模拟的并行 Client 端的数量。

包含用于创建 table 的语句的文件或字符串。

运行测试的模式。

Note

如果还提供了--auto-generate-sql选项，则mysqlslap在测试运行结束时删除架构。为避免这种情况，也请使用--no-drop选项。

生成以逗号分隔的值格式的输出。输出将转到指定的文件，如果未提供文件，则转到标准输出。

编写调试日志。典型的* debug_options *字符串是d:t:o,file_name。默认值为d:t:o,/tmp/mysqlslap.trace。

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

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

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

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

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

有关使用哪个 Client 端身份验证插件的提示。参见第 6.2.13 节“可插入身份验证”。

在全局选项文件之后但在用户选项文件之前(在 Unix 上)读取此选项文件。如果该文件不存在或无法访问，则发生错误。 * file_name *如果是相对路径名而不是完整路径名，则相对于当前目录进行解释。

有关此选项和其他选项文件选项的更多信息，请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。

仅使用给定的选项文件。如果该文件不存在或无法访问，则发生错误。 * file_name *如果是相对路径名而不是完整路径名，则相对于当前目录进行解释。

exception：即使使用--defaults-file，Client 端程序也读取.mylogin.cnf。

有关此选项和其他选项文件选项的更多信息，请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。

不仅阅读常规选项组，还阅读具有常规名称和后缀* str *的组。例如，mysqlslap通常读取[client]和[mysqlslap]组。如果提供了--defaults-group-suffix=_other选项，则mysqlslap也会读取[client_other]和[mysqlslap_other]组。

有关此选项和其他选项文件选项的更多信息，请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。

在文件或使用命令选项提供的 SQL 语句中使用的定界符。

在每个* N *语句之后分离(关闭并重新打开)每个连接。缺省值为 0(连接不分离)。

启用mysql_clear_password明文身份验证插件。 (请参阅第 6.4.1.6 节“Client 端明文可插入身份验证”。)

用于创建 table 的存储引擎。

从服务器请求用于基于密钥对的密码交换的 RSA 公钥。此选项适用于使用使用caching_sha2_password身份验证插件进行身份验证的帐户连接到服务器的 Client 端。对于通过此类帐户进行的连接，除非请求，否则服务器不会将公钥发送给 Client 端。对于未使用该插件进行身份验证的帐户，该选项将被忽略。如果不需要基于 RSA 的密码交换(如 Client 端使用安全连接连接到服务器的情况)，也会被忽略。

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

有关caching_sha2_password插件的信息，请参见第 6.4.1.4 节“缓存 SHA-2 可插入身份验证”。

--get-server-public-key选项已添加到 MySQL 5.7.23 中。

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

运行测试的次数。

从.mylogin.cnf登录路径文件中的命名登录路径中读取选项。 “登录路径”是一个选项组，其中包含一些选项，这些选项指定要连接到哪个 MySQL 服务器以及要作为身份验证的帐户。要创建或修改登录路径文件，请使用mysql_config_editorUtil。参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”。

有关此选项和其他选项文件选项的更多信息，请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。

防止mysqlslap删除其在测试运行期间创建的任何架构。

不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败，则可以使用--no-defaults来防止读取它们。

exception 是在所有情况下都读取.mylogin.cnf文件(如果存在)。这样即使在使用--no-defaults的情况下，也可以通过比命令行更安全的方式指定密码。 (.mylogin.cnf由mysql_config_editorUtil 创建。请参见第 4.6.6 节“ mysql_config_editor-MySQL 配置 Util”。)

有关此选项和其他选项文件选项的更多信息，请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。

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

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

将每个 Client 端限制为大约这么多查询。查询计数考虑了语句定界符。例如，如果您按以下方式调用mysqlslap，则会识别;分隔符，以便查询字符串的每个实例都计为两个查询。结果，插入了 5 行(不是 10 行)。

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

不要连接到数据库。 mysqlslap仅打印将要执行的操作。

用于连接服务器的 MySQL 帐户的密码。密码值是可选的。如果未给出，mysqlslap提示 Importing 一个。如果提供，则--password=或-p与后面的密码之间必须没有空格。如果未指定密码选项，则默认为不发送密码。

在命令行上指定密码应该被认为是不安全的。为避免在命令行上 Importing 密码，请使用选项文件。参见第 6.1.2.1 节，“最终用户密码安全准则”。

要明确指定没有密码并且mysqlslap不应提示 Importing 密码，请使用--skip-password选项。

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

在其中查找插件的目录。如果--default-auth选项用于指定身份验证插件，但mysqlslap找不到它，请指定此选项。参见第 6.2.13 节“可插入身份验证”。

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

测试完成后包含要执行的语句的文件或字符串。此执行不计入计时目的。

测试完成后使用system()执行的字符串。此执行不计入计时目的。

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

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

打印程序名称及其从选项文件中获取的所有选项。

有关此选项和其他选项文件选项的更多信息，请参见第 4.2.2.3 节“影响选项文件处理的命令行选项”。

用于连接到服务器的传输协议。当其他连接参数通常导致使用您想要的协议以外的协议时，此功能很有用。有关允许值的详细信息，请参见第 4.2.5 节“连接传输协议”。

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

不要以旧(4.1 之前)格式向服务器发送密码。这样可以防止除使用较新密码格式的服务器以外的其他连接。

从 MySQL 5.7.5 开始，此选项已被弃用，并将在以后的 MySQL 版本中删除。它始终处于启用状态，尝试禁用它(--skip-secure-auth，--secure-auth=0)会产生错误。在 MySQL 5.7.5 之前，此选项默认为启用，但可以禁用。

Note

使用 4.1 之前的哈希方法的密码比使用本地密码哈希方法的密码安全性较低，应避免使用。不建议使用 4.1 之前的密码，并在 MySQL 5.7.5 中删除了对它们的支持。有关帐户升级的说明，请参阅第 6.4.1.3 节“迁移到 4.1 版之前的密码哈希和 mysql_old_password 插件”。

PEM 格式的文件的路径名，其中包含服务器用于基于 RSA 密钥对的密码交换所需的公用密钥的 Client 端副本。此选项适用于使用sha256_password或caching_sha2_password身份验证插件进行身份验证的 Client 端。对于未通过这些插件之一进行身份验证的帐户，将忽略此选项。如果不使用基于 RSA 的密码交换，也将被忽略，例如 Client 端使用安全连接连接到服务器时。

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

对于sha256_password，仅当使用 OpenSSL 构建 MySQL 时，此选项才适用。

有关sha256_password和caching_sha2_password插件的信息，请参见第 6.4.1.5 节“ SHA-256 可插拔身份验证”和第 6.4.1.4 节“缓存 SHA-2 可插入身份验证”。

--server-public-key-path选项已添加到 MySQL 5.7.23 中。

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

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

静音模式。无输出。

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

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

设置 Client 端会话的 SQL 模式。

  • --ssl*

以--ssl开头的选项指定是否使用 SSL 连接到服务器，并指示在何处查找 SSL 密钥和证书。参见加密连接的命令选项。

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

MySQL 5.7.10 中添加了此选项。

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

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

显示版本信息并退出。

Name MySql 中文文档
Version
Language
Badge
Last Updated 2021-07-03T12:24:35