mysqlslap 负载仿真客户端
mysqlslap是一个诊断程序,旨在模拟MySQL服务器的客户端负载并报告每个阶段的时间。就像多个客户端正在访问服务器一样。
像这样调用mysqlslap:
shell>mysqlslap [options]
一些选项,例如--create
或--query
使您能够指定包含SQL语句的字符串或包含语句的文件。如果指定文件,则默认情况下该文件每行必须包含一个语句。(也就是说,隐式语句定界符是换行符。)使用该--delimiter
选项可以指定其他定界符,这使您可以指定跨多行的语句或将多条语句放在一行上。您不能在文件中包含注释;mysqlslap无法理解它们。
mysqlslap的运行分为三个阶段:
- 创建架构,表以及可选的任何存储程序或数据以用于测试。此阶段使用单个客户端连接。
- 运行负载测试。此阶段可以使用许多客户端连接。
- 清理(断开连接,如果有指定的话放下桌子)。此阶段使用单个客户端连接。
例子:
提供您自己的create和query SQL语句,可查询50个客户端,每个查询200个选择(在一行中输入命令):
mysqlslap --delimiter=";" --create="CREATE TABLE a (b int);INSERT INTO a VALUES (23)" --query="SELECT * FROM a" --concurrency=50 --iterations=200
让mysqlslap用两INT
列和三VARCHAR
列的表构建查询SQL语句。使用五个客户端,每个客户端查询20次。不要创建表或插入数据(即,使用先前测试的架构和数据):
mysqlslap --concurrency=5 --iterations=20 --number-int-cols=2 --number-char-cols=3 --auto-generate-sql
告诉程序从指定的文件加载创建,插入和查询SQL语句,其中该create.sql
文件包含多个以分隔的表创建语句';'
和多个以分隔的插入语句';'
。该--query
文件将包含多个以分隔的查询';'
。运行所有装入语句,然后使用五个客户端(每个客户端五次)运行查询文件中的所有查询:
mysqlslap --concurrency=5 --iterations=5 --query=query.sql --create=create.sql --delimiter=";"
mysqlslap支持以下选项,可以在命令行或选项文件的[mysqlslap]
和[client]
组中指定这些选项。有关MySQL程序使用的选项文件的信息,请参见“使用选项文件”。
--help
,-?
显示帮助消息并退出。
--auto-generate-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
为自动测试生成多少个不同的查询。例如,如果您运行
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
如果可能,压缩客户端和服务器之间发送的所有信息。
从MySQL 8.0.18开始,不推荐使用此选项。它将在将来的MySQL版本中删除。请参阅旧版连接压缩配置。
--compression-algorithms=value
用于连接到服务器的允许的压缩算法。可用算法与
protocol_compression_algorithms
系统变量相同。默认值为uncompressed
。该选项是在MySQL 8.0.18中添加的。
--concurrency=N
,-c N
要模拟的并行客户端的数量。
--create=value
包含用于创建表的语句的文件或字符串。
--create-schema=value
运行测试的模式。
注意
如果
--auto-generate-sql
还提供了该选项,则mysqlslap将在测试运行结束时删除该架构。为了避免这种情况,请同时使用该--no-drop
选项。--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
有关使用哪个客户端身份验证插件的提示。
--defaults-extra-file=file_name
在全局选项文件之后但在用户选项文件之前(在Unix上)读取此选项文件。如果该文件不存在或无法访问,则发生错误。
file_name
如果给出为相对路径名而不是完整路径名,则相对于当前目录解释。有关此选项和其他选项文件选项的更多信息,请参见“影响选项文件处理的命令行选项”。
--defaults-file=file_name
仅使用给定的选项文件。如果该文件不存在或无法访问,则发生错误。
file_name
如果给出为相对路径名而不是完整路径名,则相对于当前目录解释。例外:即使这样
--defaults-file
,客户端程序也会读取.mylogin.cnf
。有关此选项和其他选项文件选项的更多信息,请参见“影响选项文件处理的命令行选项”。
--defaults-group-suffix=str
不仅阅读常规选项组,而且阅读具有常规名称和后缀的组
str
。例如,mysqlslap通常读取[client]
和[mysqlslap]
组。如果--defaults-group-suffix=_other
给出了该选项,mysqlslap也会读取[client_other]
和[mysqlslap_other]
组。有关此选项和其他选项文件选项的更多信息,请参见“影响选项文件处理的命令行选项”。
--delimiter=str
,-F str
在文件或使用命令选项提供的SQL语句中使用的定界符。
--detach=N
在每个
N
语句之后分离(关闭并重新打开)每个连接。默认值为0(连接未分离)。--enable-cleartext-plugin
启用
mysql_clear_password
明文身份验证插件。(请参见“客户端明文可插入身份验证”。)--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
插件的信息,请参见“缓存SHA-2可插拔身份验证”。--host=host_name
,-h host_name
连接到给定主机上的MySQL服务器。
--iterations=N
,-i N
运行测试的次数。
--login-path=name
从
.mylogin.cnf
登录路径文件中的命名登录路径读取选项。阿“登录路径”是含有指定要连接到哪个MySQL服务器和选项哪个帐户作为认证选项组。要创建或修改登录路径文件,请使用mysql_config_editor实用程序。请参见“mysql_config_editor-MySQL配置实用程序”。有关此选项和其他选项文件选项的更多信息,请参见“影响选项文件处理的命令行选项”。
--no-drop
防止mysqlslap删除在测试运行期间创建的任何模式。
--no-defaults
不要读取任何选项文件。如果由于从选项文件中读取未知选项而导致程序启动失败,
--no-defaults
则可以使用该选项来防止读取它们。唯一的例外是,
.mylogin.cnf
在所有情况下都会读取该文件(如果存在)。这样,即使--no-defaults
使用密码,也可以通过比命令行更安全的方式指定密码。(.mylogin.cnf
由mysql_config_editor实用程序创建。请参见“mysql_config_editor-MySQL配置实用程序”。)有关此选项和其他选项文件选项的更多信息,请参见“影响选项文件处理的命令行选项”。
--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行)。shell>
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
在命令行上指定密码应该被认为是不安全的。为避免在命令行上输入密码,请使用选项文件。请参见“最终用户密码安全准则”。
要明确指定没有密码,并且mysqlslap不应提示输入密码,请使用该
--skip-password
选项。--pipe
,-W
在Windows上,使用命名管道连接到服务器。仅当在
named_pipe
启用了支持命名管道连接的系统变量的情况下启动服务器时,此选项才适用。另外,建立连接的用户必须是named_pipe_full_access_group
系统变量指定的Windows组的成员。--plugin-dir=dir_name
在其中查找插件的目录。如果该
--default-auth
选项用于指定身份验证插件,但mysqlslap找不到,请指定此选项。--port=port_num
,-P port_num
对于TCP / IP连接,使用的端口号。
--post-query=value
测试完成后包含要执行的语句的文件或字符串。此执行不计入计时目的。
--post-system=str
system()
测试完成后要使用的字符串。此执行不计入计时目的。--pre-query=value
包含要在运行测试之前执行的语句的文件或字符串。此执行不计入计时目的。
--pre-system=str
system()
运行测试之前要使用的字符串。此执行不计入计时目的。--print-defaults
打印程序名称及其从选项文件中获取的所有选项。
有关此选项和其他选项文件选项的更多信息,请参见“影响选项文件处理的命令行选项”。
--protocol={TCP|SOCKET|PIPE|MEMORY}
用于连接到服务器的连接协议。当其他连接参数通常导致使用您想要的协议以外的协议时,此功能很有用。有关允许值的详细信息,请参见“使用命令选项连接到MySQL服务器”。
--query=value
,-q value
包含
SELECT
用于检索数据的语句的文件或字符串。--server-public-key-path=file_name
包含服务器用于基于RSA密钥对的密码交换所需的公用密钥的客户端副本的文件的路径名。该文件必须为PEM格式。此选项适用于使用
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
插件的信息,请参见“ SHA-256可插拔身份验证”和“缓存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密钥和证书。请参阅加密连接的命令选项。--ssl-fips-mode={OFF|ON|STRICT}
控制是否在客户端上启用FIPS模式。该
--ssl-fips-mode
选项与其他选项的不同之处在于,该选项不用于建立加密连接,而是影响允许的加密操作。请参见“ FIPS支持”。--ssl-xxx
这些
--ssl-fips-mode
值是允许的:OFF
:禁用FIPS模式。ON
:启用FIPS模式。STRICT
:启用“严格” FIPS模式。
注意
如果OpenSSL的FIPS对象模块不可用时,对于唯一的允许值
--ssl-fips-mode
是OFF
。在这种情况下,设置--ssl-fips-mode
为ON
或STRICT
导致客户端在启动时发出警告并以非FIPS模式运行。--tls-ciphersuites=ciphersuite_list
使用TLSv1.3的加密连接的允许密码套件。该值是一个或多个以冒号分隔的密码套件名称的列表。可以为此选项命名的密码套件取决于用于编译MySQL的SSL库。有关详细信息,请参见“加密的连接TLS协议和密码”。
该选项是在MySQL 8.0.16中添加的。
--tls-version=protocol_list
加密连接允许的TLS协议。该值是一个或多个逗号分隔的协议名称的列表。可以为此选项命名的协议取决于用于编译MySQL的SSL库。有关详细信息,请参见“加密的连接TLS协议和密码”。
--user=user_name
,-u user_name
用于连接到服务器的MySQL帐户的用户名。
--verbose
,-v
详细模式。打印有关程序功能的更多信息。可以多次使用此选项以增加信息量。
--version
,-V
显示版本信息并退出。
--zstd-compression-level=level
用于与使用
zstd
压缩算法的服务器的连接的压缩级别。允许的级别为1到22,更大的值表示压缩级别增加。默认zstd
压缩级别为3。压缩级别设置对不使用zstd
压缩的连接无效。该选项是在MySQL 8.0.18中添加的。