2009-09-16 14:03:18 +02:00
'\" t
2009-05-25 11:59:47 +02:00
. \"
2019-07-01 17:21:57 +02:00
.TH "\FBMYSQLSLAP\FR" "1" "27 June 2019" "MariaDB 10\&.5" "MariaDB Database System"
2009-09-16 14:03:18 +02:00
. \" -----------------------------------------------------------------
. \" * set default formatting
. \" -----------------------------------------------------------------
2009-05-25 11:59:47 +02:00
. \" disable hyphenation
.nh
. \" disable justification (adjust text to left margin only)
.ad l
2009-09-16 14:03:18 +02:00
. \" -----------------------------------------------------------------
. \" * MAIN CONTENT STARTS HERE *
. \" -----------------------------------------------------------------
. \" mysqlslap
. \" load emulation
2009-05-25 11:59:47 +02:00
.SH "NAME"
mysqlslap \- load emulation client
.SH "SYNOPSIS"
2009-09-16 14:03:18 +02:00
.HP \w '\fBmysqlslap\ [\fR\fB\fIoptions\fR\fR\fB]\fR\ 'u
2009-05-25 11:59:47 +02:00
\fB mysqlslap [\fR \fB \fI options\fR \fR \fB ]\fR
.SH "DESCRIPTION"
.PP
\fB mysqlslap\fR
2015-09-09 14:32:52 +02:00
is a diagnostic program designed to emulate client load for a MariaDB server and to report the timing of each stage\& . It works as if multiple clients are accessing the server\& .
2009-05-25 11:59:47 +02:00
.PP
Invoke
\fB mysqlslap\fR
like this:
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
shell> \fB mysqlslap [\fR \fB \fI options\fR \fR \fB ]\fR
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
2009-05-25 11:59:47 +02:00
.PP
Some options such as
\fB \- \- create\fR
or
\fB \- \- query\fR
2009-09-16 14:03:18 +02:00
enable you to specify a string containing an SQL statement or a file containing statements\& . If you specify a file, by default it must contain one statement per line\& . (That is, the implicit statement delimiter is the newline character\& .) Use the
2009-05-25 11:59:47 +02:00
\fB \- \- delimiter\fR
2009-09-16 14:03:18 +02:00
option to specify a different delimiter, which enables you to specify statements that span multiple lines or place multiple statements on a single line\& . You cannot include comments in a file;
2009-05-25 11:59:47 +02:00
\fB mysqlslap\fR
2009-09-16 14:03:18 +02:00
does not understand them\& .
2009-05-25 11:59:47 +02:00
.PP
\fB mysqlslap\fR
runs in three stages:
.sp
2009-09-16 14:03:18 +02:00
.RS 4
.ie n \{ \
\h '-04' 1.\h '+01'\c
. \}
.el \{ \
.sp -1
.IP " 1." 4 .2
. \}
Create schema, table, and optionally any stored programs or data you want to using for the test\& . This stage uses a single client connection\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04' 2.\h '+01'\c
. \}
.el \{ \
.sp -1
.IP " 2." 4 .2
. \}
Run the load test\& . This stage can use many client connections\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04' 3.\h '+01'\c
. \}
.el \{ \
.sp -1
.IP " 3." 4 .2
. \}
Clean up (disconnect, drop table if specified)\& . This stage uses a single client connection\& .
2009-05-25 11:59:47 +02:00
.RE
.PP
Examples:
.PP
Supply your own create and query SQL statements, with 50 clients querying and 200 selects for each:
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
2009-09-16 14:03:18 +02:00
mysqlslap \- \- delimiter=";" \e
\- \- create="CREATE TABLE a (b int);INSERT INTO a VALUES (23)" \e
2009-05-25 11:59:47 +02:00
\- \- query="SELECT * FROM a" \- \- concurrency=50 \- \- iterations=200
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
2009-05-25 11:59:47 +02:00
.PP
Let
\fB mysqlslap\fR
build the query SQL statement with a table of two
INT
columns and three
VARCHAR
2009-09-16 14:03:18 +02:00
columns\& . Use five clients querying 20 times each\& . Do not create the table or insert the data (that is, use the previous test\' s schema and data):
2009-05-25 11:59:47 +02:00
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
2009-09-16 14:03:18 +02:00
mysqlslap \- \- concurrency=5 \- \- iterations=20 \e
\- \- number\- int\- cols=2 \- \- number\- char\- cols=3 \e
2009-05-25 11:59:47 +02:00
\- \- auto\- generate\- sql
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
2009-05-25 11:59:47 +02:00
.PP
Tell the program to load the create, insert, and query SQL statements from the specified files, where the
2009-09-16 14:03:18 +02:00
create\& .sql
2009-05-25 11:59:47 +02:00
file has multiple table creation statements delimited by
2009-09-16 14:03:18 +02:00
\' ;\'
2009-05-25 11:59:47 +02:00
and multiple insert statements delimited by
2009-09-16 14:03:18 +02:00
\' ;\' \& . The
2009-05-25 11:59:47 +02:00
\fB \- \- query\fR
file will have multiple queries delimited by
2009-09-16 14:03:18 +02:00
\' ;\' \& . Run all the load statements, then run all the queries in the query file with five clients (five times each):
2009-05-25 11:59:47 +02:00
.sp
2009-09-16 14:03:18 +02:00
.if n \{ \
.RS 4
. \}
2009-05-25 11:59:47 +02:00
.nf
2009-09-16 14:03:18 +02:00
mysqlslap \- \- concurrency=5 \e
\- \- iterations=5 \- \- query=query\& .sql \- \- create=create\& .sql \e
2009-05-25 11:59:47 +02:00
\- \- delimiter=";"
.fi
2009-09-16 14:03:18 +02:00
.if n \{ \
2009-05-25 11:59:47 +02:00
.RE
2009-09-16 14:03:18 +02:00
. \}
2009-05-25 11:59:47 +02:00
.PP
\fB mysqlslap\fR
2010-04-28 15:06:11 +02:00
supports the following options, which can be specified on the command line or in the
[mysqlslap]
and
[client]
option file groups\& .
\fB mysqlslap\fR
2015-09-09 14:32:52 +02:00
also supports the options for processing option files\& .
2009-09-16 14:03:18 +02:00
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: help option
. \" help option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- help\fR ,
\fB \- ?\fR
.sp
2009-09-16 14:03:18 +02:00
Display a help message and exit\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql option
. \" auto-generate-sql option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\fR ,
\fB \- a\fR
.sp
2009-09-16 14:03:18 +02:00
Generate SQL statements automatically when they are not supplied in files or via command options\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-add-autoincrement option
. \" auto-generate-sql-add-autoincrement option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- add\- autoincrement\fR
.sp
Add an
AUTO_INCREMENT
2015-09-09 14:32:52 +02:00
column to automatically generated tables\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-execute-number option
. \" auto-generate-sql-execute-number option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- execute\- number=\fR \fB \fI N\fR \fR
.sp
2015-09-09 14:32:52 +02:00
Specify how many queries to generate automatically\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-guid-primary option
. \" auto-generate-sql-guid-primary option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- guid\- primary\fR
.sp
2015-09-09 14:32:52 +02:00
Add a GUID\- based primary key to automatically generated tables\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-load-type option
. \" auto-generate-sql-load-type option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- load\- type=\fR \fB \fI type\fR \fR
.sp
2009-09-16 14:03:18 +02:00
Specify the test load type\& . The allowable values are
2009-05-25 11:59:47 +02:00
read
(scan tables),
write
(insert into tables),
key
(read primary keys),
update
(update primary keys), or
mixed
2009-09-16 14:03:18 +02:00
(half inserts, half scanning selects)\& . The default is
2015-09-09 14:32:52 +02:00
mixed\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-secondary-indexes option
. \" auto-generate-sql-secondary-indexes option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- secondary\- indexes=\fR \fB \fI N\fR \fR
.sp
2015-09-09 14:32:52 +02:00
Specify how many secondary indexes to add to automatically generated tables\& . By default, none are added\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-unique-query-number option
. \" auto-generate-sql-unique-query-number option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- unique\- query\- number=\fR \fB \fI N\fR \fR
.sp
2009-09-16 14:03:18 +02:00
How many different queries to generate for automatic tests\& . For example, if you run a
2009-05-25 11:59:47 +02:00
key
2015-09-09 14:32:52 +02:00
test that performs 1000 selects, you can use this option with a value of 1000 to run 1000 unique queries, or with a value of 50 to perform 50 different selects\& . The default is 10\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-unique-write-number option
. \" auto-generate-sql-unique-write-number option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- unique\- write\- number=\fR \fB \fI N\fR \fR
.sp
How many different queries to generate for
2015-09-09 14:32:52 +02:00
\fB \- \- auto\- generate\- sql\- write\- number\fR \& . The default is 10\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: auto-generate-sql-write-number option
. \" auto-generate-sql-write-number option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- auto\- generate\- sql\- write\- number=\fR \fB \fI N\fR \fR
.sp
2015-09-09 14:32:52 +02:00
How many row inserts to perform on each thread\& . The default is 100\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: commit option
. \" commit option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- commit=\fR \fB \fI N\fR \fR
.sp
2015-09-09 14:32:52 +02:00
How many statements to execute before committing\& . The default is 0 (no commits are done)\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: compress option
. \" compress option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- compress\fR ,
\fB \- C\fR
.sp
2009-09-16 14:03:18 +02:00
Compress all information sent between the client and the server if both support compression\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: concurrency option
. \" concurrency option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- concurrency=\fR \fB \fI N\fR \fR ,
\fB \- c \fR \fB \fI N\fR \fR
.sp
The number of clients to simulate when issuing the
SELECT
2009-09-16 14:03:18 +02:00
statement\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: create option
. \" create option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- create=\fR \fB \fI value\fR \fR
.sp
2009-09-16 14:03:18 +02:00
The file or string containing the statement to use for creating the table\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: create-schema option
. \" create-schema option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- create\- schema=\fR \fB \fI value\fR \fR
.sp
2015-09-09 14:32:52 +02:00
The schema in which to run the tests\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: csv option
. \" csv option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- csv[=\fR \fB \fI file_name\fR \fR \fB ]\fR
.sp
2015-09-09 14:32:52 +02:00
Generate output in comma\- separated values format\& . The output goes to the named file, or to the standard output if no file is given\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: debug option
. \" debug option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- debug[=\fR \fB \fI debug_options\fR \fR \fB ]\fR ,
\fB \- # [\fR \fB \fI debug_options\fR \fR \fB ]\fR
.sp
2009-09-16 14:03:18 +02:00
Write a debugging log\& . A typical
2009-05-25 11:59:47 +02:00
\fI debug_options\fR
2009-09-16 14:03:18 +02:00
string is
\' d:t:o,\fI file_name\fR \' \& . The default is
\' d:t:o,/tmp/mysqlslap\& .trace\' \& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: debug-check option
. \" debug-check option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- debug\- check\fR
.sp
2015-09-09 14:32:52 +02:00
Print some debugging information when the program exits\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: debug-info option
. \" debug-info option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- debug\- info\fR ,
\fB \- T\fR
.sp
2015-09-09 14:32:52 +02:00
Print debugging information and memory and CPU usage statistics when the program exits\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: default-auth option
. \" default-auth option: mysqlslap
\fB \- \- default\- auth=\fR \fB \fI name\fR
.sp
Default authentication client-side plugin to use\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2013-06-13 00:13:23 +02:00
. \" mysqlslap: defaults-extra-file option
. \" defaults-extra-file option: mysqlslap
\fB \- \- defaults\- extra\- file=\fR \fB \fI filename\fR \fR
.sp
Set \fB \fI filename\fR \fR as the file to read default options from after the global defaults files has been
read\& . Must be given as first option\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: defaults-file option
. \" defaults-file option: mysqlslap
\fB \- \- defaults\- file=\fR \fB \fI filename\fR \fR
.sp
Set \fB \fI filename\fR \fR as the file to read default options from, override global defaults files\& .
Must be given as first option\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlslap: delimiter option
. \" delimiter option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- delimiter=\fR \fB \fI str\fR \fR ,
\fB \- F \fR \fB \fI str\fR \fR
.sp
2009-09-16 14:03:18 +02:00
The delimiter to use in SQL statements supplied in files or via command options\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: detach option
. \" detach option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- detach=\fR \fB \fI N\fR \fR
.sp
Detach (close and reopen) each connection after each
\fI N\fR
2015-09-09 14:32:52 +02:00
statements\& . The default is 0 (connections are not detached)\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: engine option
. \" engine option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- engine=\fR \fB \fI engine_name\fR \fR ,
\fB \- e \fR \fB \fI engine_name\fR \fR
.sp
2015-09-09 14:32:52 +02:00
Comma separated list of storage engines to use for creating the table\& . The test is run for
each engine\& . You can also specify an option for an engine after a colon, for example
\fB memory:max_row=2300\fR \& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: host option
. \" host option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- host=\fR \fB \fI host_name\fR \fR ,
\fB \- h \fR \fB \fI host_name\fR \fR
.sp
2015-09-09 14:32:52 +02:00
Connect to the MariaDB server on the given host\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2013-09-17 16:51:14 +02:00
. \" mysqlslap: init-command option
. \" init-command option: mysqlslap
\fB \- \- init\- command=str\fR
.sp
2015-09-09 14:32:52 +02:00
SQL Command to execute when connecting to MariaDB server\& . Will automatically be re\- executed when reconnecting\& .
2013-09-17 16:51:14 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlslap: iterations option
. \" iterations option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- iterations=\fR \fB \fI N\fR \fR ,
\fB \- i \fR \fB \fI N\fR \fR
.sp
2009-09-16 14:03:18 +02:00
The number of times to run the tests\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2013-06-13 00:13:23 +02:00
. \" mysqlslap: no-defaults option
. \" no-defaults option: mysqlslap
\fB \- \- no\- defaults\fR
.sp
Do not read default options from any option file\& . This must be given as the
first argument\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: no-drop option
. \" no-drop option: mysqlslap
\fB \- \- no\- drop\fR
.sp
2015-09-09 14:32:52 +02:00
Do not drop any schema created during the test after the test is complete\& .
2013-06-13 00:13:23 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlslap: number-char-cols option
. \" number-char-cols option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- number\- char\- cols=\fR \fB \fI N\fR \fR ,
\fB \- x \fR \fB \fI N\fR \fR
.sp
The number of
VARCHAR
columns to use if
\fB \- \- auto\- generate\- sql\fR
2009-09-16 14:03:18 +02:00
is specified\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: number-int-cols option
. \" number-int-cols option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- number\- int\- cols=\fR \fB \fI N\fR \fR ,
\fB \- y \fR \fB \fI N\fR \fR
.sp
The number of
INT
columns to use if
\fB \- \- auto\- generate\- sql\fR
2009-09-16 14:03:18 +02:00
is specified\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: number-of-queries option
. \" number-of-queries option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- number\- of\- queries=\fR \fB \fI N\fR \fR
.sp
2010-04-28 15:06:11 +02:00
Limit each client to approximately this many queries\& . Query counting takes into account the statement delimiter\& . For example, if you invoke
\fB mysqlslap\fR
as follows, the
;
delimiter is recognized so that each instance of the query string counts as two queries\& . As a result, 5 rows (not 10) are inserted\& .
.sp
.if n \{ \
.RS 4
. \}
.nf
shell> \fB mysqlslap \- \- delimiter=";" \- \- number\- of\- queries=10\fR
\fB \- \- query="use test;insert into t values(null)"\fR
.fi
.if n \{ \
.RE
. \}
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: only-print option
. \" only-print option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- only\- print\fR
.sp
2009-09-16 14:03:18 +02:00
Do not connect to databases\& .
2009-05-25 11:59:47 +02:00
\fB mysqlslap\fR
2015-09-09 14:32:52 +02:00
only prints what it would have done\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: password option
. \" password option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- password[=\fR \fB \fI password\fR \fR \fB ]\fR ,
\fB \- p[\fR \fB \fI password\fR \fR \fB ]\fR
.sp
2009-09-16 14:03:18 +02:00
The password to use when connecting to the server\& . If you use the short option form (\fB \- p\fR ), you
2009-05-25 11:59:47 +02:00
\fI cannot\fR
2009-09-16 14:03:18 +02:00
have a space between the option and the password\& . If you omit the
2009-05-25 11:59:47 +02:00
\fI password\fR
value following the
\fB \- \- password\fR
or
\fB \- p\fR
2010-04-28 15:06:11 +02:00
option on the command line,
\fB mysqlslap\fR
prompts for one\& .
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
Specifying a password on the command line should be considered insecure\& . You can use an option file to avoid giving the password on the command line\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: pipe option
. \" pipe option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- pipe\fR ,
\fB \- W\fR
.sp
2010-04-28 15:06:11 +02:00
On Windows, connect to the server via a named pipe\& . This option applies only if the server supports named\- pipe connections\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlslap: plugin-dir option
. \" plugin-dir option: mysqlslap
\fB \- \- plugin\- dir=\fI dir_name\fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
Directory for client-side plugins\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlslap: port option
. \" port option: mysqlslap
\fB \- \- port=\fR \fB \fI port_num\fR \fR ,
\fB \- P \fR \fB \fI port_num\fR \fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
The TCP/IP port number to use for the connection\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlslap: post-query option
. \" post-query option: mysqlslap
\fB \- \- post\- query=\fR \fB \fI value\fR \fR
2013-06-13 00:13:23 +02:00
.sp
2015-09-09 14:32:52 +02:00
The file or string containing the statement to execute after the tests have completed\& . This execution is not counted for timing purposes\& .
2013-06-13 00:13:23 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2009-09-16 14:03:18 +02:00
. \" mysqlslap: post-system option
. \" post-system option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- post\- system=\fR \fB \fI str\fR \fR
.sp
The string to execute via
system()
2015-09-09 14:32:52 +02:00
after the tests have completed\& . This execution is not counted for timing purposes\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: pre-query option
. \" pre-query option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- pre\- query=\fR \fB \fI value\fR \fR
.sp
2015-09-09 14:32:52 +02:00
The file or string containing the statement to execute before running the tests\& . This execution is not counted for timing purposes\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: pre-system option
. \" pre-system option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- pre\- system=\fR \fB \fI str\fR \fR
.sp
The string to execute via
system()
2015-09-09 14:32:52 +02:00
before running the tests\& . This execution is not counted for timing purposes\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlslap: print-defaults option
. \" print-defaults option: mysqlslap
\fB \- \- print\- defaults\fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
Print the program argument list and exit\& .
This must be given as the first argument\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: protocol option
. \" protocol option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- protocol={TCP|SOCKET|PIPE|MEMORY}\fR
.sp
2015-09-09 14:32:52 +02:00
The connection protocol to use for connecting to the server\& . It is useful when the other connection parameters normally would cause a protocol to be used other than the one you want\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: query option
. \" query option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- query=\fR \fB \fI value\fR \fR ,
\fB \- q \fR \fB \fI value\fR \fR
.sp
The file or string containing the
SELECT
2009-09-16 14:03:18 +02:00
statement to use for retrieving data\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlslap: shared-memory-base-name option
. \" shared-memory-base-name option: mysqlslap
\fB \- \- shared\- memory\- base\- name=\fR \fB \fI name\fR \fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
On Windows, the shared\- memory name to use, for connections made via shared memory to a local server\& . This option applies only if the server supports shared\- memory connections\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlslap: silent option
. \" silent option: mysqlslap
\fB \- \- silent\fR ,
\fB \- s\fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
Silent mode\& . No output\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: socket option
. \" socket option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- socket=\fR \fB \fI path\fR \fR ,
\fB \- S \fR \fB \fI path\fR \fR
.sp
For connections to
2009-09-16 14:03:18 +02:00
localhost, the Unix socket file to use, or, on Windows, the name of the named pipe to use\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlshow: SSL options
. \" SSL options: mysqlshow
2009-05-25 11:59:47 +02:00
\fB \- \- ssl\fR
2015-09-09 14:32:52 +02:00
.sp
Enable SSL for connection (automatically enabled with other flags). Disable with
\fB \- \- skip-ssl\fR \& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlshow: SSL CA option
. \" SSL CA option: mysqlshow
\fB \- \- ssl\- ca=\fI name\fR
.sp
CA file in PEM format (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlshow: SSL CA Path option
. \" SSL CA Path option: mysqlshow
\fB \- \- ssl\- capath=\fI name\fR
.sp
CA directory (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlshow: SSL Cert option
. \" SSL Cert option: mysqlshow
\fB \- \- ssl\- cert=\fI name\fR
.sp
X509 cert in PEM format (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlshow: SSL Cipher option
. \" SSL Cipher option: mysqlshow
\fB \- \- ssl\- cipher=\fI name\fR
.sp
SSL cipher to use (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlshow: SSL Key option
. \" SSL Key option: mysqlshow
\fB \- \- ssl\- key=\fI name\fR
.sp
X509 key in PEM format (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlshow: SSL Crl option
. \" SSL CRL option: mysqlshow
\fB \- \- ssl\- crl=\fI name\fR
.sp
Certificate revocation list (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlshow: SSL Crlpath option
. \" SSL Crlpath option: mysqlshow
\fB \- \- ssl\- crlpath=\fI name\fR
.sp
Certificate revocation list path (check OpenSSL docs, implies
\fB \- \- ssl\fR )\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
2015-09-09 14:32:52 +02:00
. \" mysqlshow: SSL Verify Server Cert option
. \" SSL Verify Server Cert option: mysqlshow
\fB \- \- ssl\- verify\- server\- cert\fR
2009-05-25 11:59:47 +02:00
.sp
2015-09-09 14:32:52 +02:00
Verify server's "Common Name" in its cert against hostname used when connecting. This option is disabled by default\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: user option
. \" user option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- user=\fR \fB \fI user_name\fR \fR ,
\fB \- u \fR \fB \fI user_name\fR \fR
.sp
2015-09-09 14:32:52 +02:00
The MariaDB user name to use when connecting to the server\& .
2009-09-16 14:03:18 +02:00
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: verbose option
. \" verbose option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- verbose\fR ,
\fB \- v\fR
.sp
2009-09-16 14:03:18 +02:00
Verbose mode\& . Print more information about what the program does\& . This option can be used multiple times to increase the amount of information\& .
.RE
.sp
.RS 4
.ie n \{ \
\h '-04'\(bu \h '+03'\c
. \}
.el \{ \
.sp -1
.IP \(bu 2 .3
. \}
. \" mysqlslap: version option
. \" version option: mysqlslap
2009-05-25 11:59:47 +02:00
\fB \- \- version\fR ,
\fB \- V\fR
.sp
2009-09-16 14:03:18 +02:00
Display version information and exit\& .
.RE
2009-05-25 11:59:47 +02:00
.SH "COPYRIGHT"
2009-09-16 14:03:18 +02:00
.br
2009-05-25 11:59:47 +02:00
.PP
2019-07-01 17:21:57 +02:00
Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc., 2010-2019 MariaDB Foundation
2009-05-25 11:59:47 +02:00
.PP
This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
.PP
This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
.PP
2019-05-11 20:29:06 +02:00
You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1335 USA or see http://www.gnu.org/licenses/.
2009-09-16 14:03:18 +02:00
.sp
2009-05-25 11:59:47 +02:00
.SH "SEE ALSO"
2015-09-09 14:32:52 +02:00
For more information, please refer to the MariaDB Knowledge Base, available online at https://mariadb.com/kb/
2009-05-25 11:59:47 +02:00
.SH AUTHOR
2015-09-09 14:32:52 +02:00
MariaDB Foundation (http://www.mariadb.org/).