--help,-?

显示帮助信息并退出。

--auto-rehash

启用自动重新散列。默认情况下启用此选项，启用数据库、表和列名称完成。用于 --disable-auto-rehash 禁用重新散列。这会导致mysql启动得更快，但如果您想使用名称完成，则 必须发出 rehash命令或其 快捷方式。\#

要完成名称，请输入第一部分并按 Tab 键。如果名字是明确的，mysql完成它。否则，您可以再次按 Tab 键查看以您目前键入的内容开头的可能名称。如果没有默认数据库，则不会完成。

--auto-vertical-output

如果结果集对于当前窗口来说太宽，则垂直显示结果集，否则使用正常的表格格式。（这适用于由 ;or终止的语句\G。）

--batch,-B

使用制表符作为列分隔符打印结果，每行另起一行。使用这个选项， mysql不使用历史文件。

批处理模式导致非表格输出格式和特殊字符转义。可以使用原始模式禁用转义；请参阅 --raw选项的说明。

--binary-as-hex

给出此选项时，mysql使用十六进制表示法 ( ) 显示二进制数据。无论整体输出显示格式是表格、垂直、HTML 还是 XML，都会发生这种情况。 0xvalue

--binary-as-hex启用后会影响所有二进制字符串的显示，包括由 和 等函数返回的 CHAR()字符串 UNHEX()。以下示例使用 A（十进制 65，十六进制 41）的 ASCII 代码对此进行了演示：

要编写二进制字符串表达式以使其显示为字符串而不管是否 --binary-as-hex启用，请使用以下技术：

这个选项是在 MySQL 5.7.19 中添加的。

--binary-mode

此选项在处理 可能包含 值的mysqlbinlog输出时有帮助。BLOB默认情况下， mysql将\r\n 语句字符串转换为\n并解释 \0为语句终止符。 --binary-mode禁用这两个功能。它还会禁用所有mysql 命令charset， 但delimiter在非交互模式下（对于通过管道传输到mysql或使用命令加载 的输入source）。

--bind-address=ip_address

在具有多个网络接口的计算机上，使用此选项来选择用于连接到 MySQL 服务器的接口。

--character-sets-dir=dir_name

安装字符集的目录。请参阅 第 10.15 节，“字符集配置”。

--column-names

在结果中写入列名称。

--column-type-info

显示结果集元数据。此信息对应于 C APIMYSQL_FIELD数据结构的内容。请参阅C API 基本数据结构。

--comments, -c

是否去除或保留发送到服务器的语句中的注释。默认是 --skip-comments （去除注释），启用 --comments（保留注释）。

--compress, -C

如果可能，压缩客户端和服务器之间发送的所有信息。请参阅 第 4.2.6 节，“连接压缩控制”。

--connect-expired-password

如果用于连接的帐户密码已过期，则向服务器指示客户端可以处理沙盒模式。这对于 mysql的非交互式调用很有用，因为通常服务器会断开尝试使用具有过期密码的帐户进行连接的非交互式客户端。（请参阅 第 6.2.12 节，“服务器处理过期密码”。）

--connect-timeout=value

连接超时前的秒数。（默认值为0。）

--database=db_name, -D db_name

要使用的数据库。这主要在选项文件中很有用。

--debug[=debug_options], -# [debug_options]

写调试日志。典型的 debug_options字符串是 . 默认值为。 d:t:o,file_named:t:o,/tmp/mysql.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

关于使用哪个客户端身份验证插件的提示。请参阅第 6.2.13 节，“可插入身份验证”。

--default-character-set=charset_name

用作charset_name客户端和连接的默认字符集。

如果操作系统使用一种字符集而mysql客户端默认使用另一种字符集，则此选项很有用。在这种情况下，输出的格式可能不正确。您通常可以通过使用此选项强制客户端改用系统字符集来解决此类问题。

有关详细信息，请参阅 第 10.4 节，“连接字符集和排序规则”和 第 10.15 节，“字符集配置”。

--defaults-extra-file=file_name

在全局选项文件之后但（在 Unix 上）在用户选项文件之前读取此选项文件。如果该文件不存在或无法访问，则会发生错误。如果 file_name不是绝对路径名，则将其解释为相对于当前目录。

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

--defaults-file=file_name

仅使用给定的选项文件。如果该文件不存在或无法访问，则会发生错误。如果 file_name不是绝对路径名，则将其解释为相对于当前目录。

例外：即使有 --defaults-file，客户端程序也会读取.mylogin.cnf.

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

--defaults-group-suffix=str

不仅要阅读通常的选项组，还要阅读具有通常名称和后缀 str. 例如， mysql通常会读取 [client]和[mysql] 组。如果此选项给出为 --defaults-group-suffix=_other， mysql还会读取 [client_other]和 [mysql_other]组。

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

--delimiter=str

设置语句分隔符。默认值为分号 ( ;)。

--disable-named-commands

禁用命名命令。仅使用\*表格，或仅在以分号 ( ;) 结尾的行的开头使用命名命令。 mysql启动时默认启用此选项 。然而，即使使用这个选项，长格式命令仍然从第一行开始工作。请参阅第 4.5.1.2 节，“mysql 客户端命令”。

--enable-cleartext-plugin

启用mysql_clear_password明文身份验证插件。（请参阅 第 6.4.1.6 节，“客户端明文可插入身份验证”。）

--execute=statement, -e statement

执行语句并退出。默认输出格式类似于使用 --batch. 有关示例，请参见 第 4.2.2.1 节“在命令行上使用选项” 。使用这个选项，mysql不使用历史文件。

--force,-f

即使出现 SQL 错误也继续。

--get-server-public-key

从服务器请求基于 RSA 密钥对的密码交换所需的公钥。此选项适用于使用 caching_sha2_password身份验证插件进行身份验证的客户端。对于该插件，除非请求，否则服务器不会发送公钥。对于未使用该插件进行身份验证的帐户，将忽略此选项。如果不使用基于 RSA 的密码交换，它也会被忽略，就像客户端使用安全连接连接到服务器时的情况一样。

如果 给出并指定一个有效的公钥文件，它优先于 . --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 中添加的。

--histignore

一个或多个以冒号分隔的模式的列表，指定为了记录目的而忽略的语句。这些模式被添加到默认模式列表 ( "*IDENTIFIED*:*PASSWORD*")。为该选项指定的值会影响写入历史文件的语句的日志记录， syslog如果 --syslog给出该选项，也会影响。有关详细信息，请参阅第 4.5.1.3 节，“mysql 客户端日志记录”。

--host=host_name, -h host_name

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

--html,-H

生成 HTML 输出。

--ignore-spaces, -i

忽略函数名称后的空格。IGNORE_SPACE在SQL 模式 的讨论中描述了这种效果 （请参阅第 5.1.10 节，“服务器 SQL 模式”）。

--init-command=str

连接到服务器后执行的 SQL 语句。如果启用了自动重新连接，则在重新连接发生后再次执行该语句。

--line-numbers

写下错误的行号。禁用它 --skip-line-numbers。

--local-infile[={0|1}]

默认情况下，LOCAL功能 LOAD DATA由默认编译到 MySQL 客户端库中确定。要显式启用或禁用LOCAL数据加载，请使用该 --local-infile选项。当没有值时，该选项启用 LOCAL数据加载。当作为 --local-infile=0or 给出时--local-infile=1，该选项禁用或启用LOCAL数据加载。

在mysql 中成功使用LOCAL加载操作还需要服务器允许本地加载；参见 第 6.1.6 节，“LOAD DATA LOCAL 的安全注意事项”

--login-path=name

从登录路径文件中指定的登录路径读取选项 .mylogin.cnf。“ 登录路径”是一个选项组，其中包含指定要连接到哪个 MySQL 服务器以及要以哪个帐户进行身份验证的选项。要创建或修改登录路径文件，请使用 mysql_config_editor实用程序。请参阅 第 4.6.6 节，“mysql_config_editor — MySQL 配置实用程序”。

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

--max-allowed-packet=value

客户端/服务器通信缓冲区的最大大小。默认为 16MB，最大为 1GB。

--max-join-size=value

使用 时连接中行的自动限制 --safe-updates。（默认值为 1,000,000。）

--named-commands, -G

启用命名的mysql命令。允许使用长格式命令，而不仅仅是短格式命令。例如，quit两者\q 都被识别。用于 --skip-named-commands 禁用命名命令。请参阅 第 4.5.1.2 节，“mysql 客户端命令”。

--net-buffer-length=value

TCP/IP 和套接字通信的缓冲区大小。（默认值为 16KB。）

--no-auto-rehash, -A

这与 具有相同的效果 --skip-auto-rehash。请参阅说明 --auto-rehash。

--no-beep,-b

发生错误时不要发出蜂鸣声。

--no-defaults

不要读取任何选项文件。如果程序启动因从选项文件中读取未知选项而失败， --no-defaults可用于防止它们被读取。

例外情况是.mylogin.cnf 文件在所有情况下都会被读取（如果存在）。这允许以比在命令行上更安全的方式指定密码，即使在--no-defaults 使用 时也是如此。要创建.mylogin.cnf，请使用mysql_config_editor实用程序。请参阅 第 4.6.6 节，“mysql_config_editor — MySQL 配置实用程序”。

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

--one-database, -o

忽略那些在默认数据库是在命令行上命名的数据库时出现的语句。这个选项是基本的，应该小心使用。语句过滤仅基于 USE语句。

最初，mysql执行输入中的语句，因为在命令行中指定数据库 db_name相当于 在输入的开头插入。然后，对于遇到 的每个 语句， mysql接受或拒绝以下语句，具体取决于指定的数据库是否是命令行中的数据库。声明的内容无关紧要。 USE db_nameUSE

假设调用mysql来处理这组语句：

DELETE FROM db2.t2;
USE db2;
DROP TABLE db1.t1;
CREATE TABLE db1.t1 (i INT);
USE db1;
INSERT INTO t1 (i) VALUES(1);
CREATE TABLE db2.t1 (j INT);

如果命令行是mysql --force --one-database db1，mysql将按如下方式处理输入：

--pager[=command]

使用给定的命令进行分页查询输出。如果省略该命令，则默认分页器是您的 PAGER环境变量的值。有效的寻呼机有less、more、 cat [> filename]等等。此选项仅适用于 Unix 且仅适用于交互模式。要禁用分页，请使用 --skip-pager. 第 4.5.1.2 节，“mysql 客户端命令”，进一步讨论了输出分页。

--password[=password], -p[password]

用于连接到服务器的 MySQL 帐户的密码。密码值是可选的。如果没有给出， mysql会提示输入一个。如果给定，则后面 的密码之间 不能有空格。如果未指定密码选项，则默认为不发送密码。 --password=-p

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

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

--pipe,-W

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

--plugin-dir=dir_name

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

--port=port_num, -P port_num

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

--print-defaults

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

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

--prompt=format_str

将提示设置为指定格式。默认值为 mysql>。提示可以包含的特殊序列在 第 4.5.1.2 节，“mysql 客户端命令”中进行了描述。

--protocol={TCP|SOCKET|PIPE|MEMORY}

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

--quick,-q

不要缓存每个查询结果，在收到时打印每一行。如果输出被挂起，这可能会降低服务器速度。使用这个选项，mysql不使用历史文件。

--raw,-r

对于表格输出，列周围的“装箱”使一列值能够与另一列值区分开来。对于非表格输出（例如在批处理模式下或在给出--batchor --silent选项时产生），特殊字符在输出中被转义，以便于识别。换行符、制表符、NUL和反斜杠写为\n、 \t、\0和 \\。该 --raw选项禁用此字符转义。

以下示例演示表格输出与非表格输出以及使用原始模式禁用转义：

% mysql
mysql> SELECT CHAR(92);
+----------+
| CHAR(92) |
+----------+
| \        |
+----------+

% mysql -s
mysql> SELECT CHAR(92);
CHAR(92)
\\

% mysql -s -r
mysql> SELECT CHAR(92);
CHAR(92)
\

--reconnect

如果与服务器的连接丢失，自动尝试重新连接。每次连接丢失时都会进行一次重新连接尝试。要抑制重新连接行为，请使用 --skip-reconnect.

--safe-updates, --i-am-a-dummy, -U

如果启用此选项，则 在子句或子句中不使用键的 UPDATE语句 DELETE会产生错误。此外，对产生（或估计会产生）非常大的结果集的语句进行了限制 。如果您在选项文件中设置了此选项，则可以 在命令行上使用来覆盖它。有关此选项的更多信息，请参阅使用安全更新模式 (--safe-updates)。 WHERELIMITSELECT--skip-safe-updates

--secure-auth

不要以旧的（pre-4.1）格式向服务器发送密码。这会阻止除使用较新密码格式的服务器之外的连接。

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

--select-limit=value

SELECT使用时语句 的自动限制 --safe-updates。（默认值为 1,000。）

--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插件的信息，请参阅 第 6.4.1.5 节，“SHA-256 可插入身份验证”和 第 6.4.1.4 节，“缓存 SHA-2 可插入身份验证”。

--shared-memory-base-name=name

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

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

--show-warnings

如果有任何语句，则在每个语句之后显示警告。此选项适用于交互和批处理模式。

--sigint-ignore

忽略SIGINT信号（通常是键入Control+C的结果）。

如果没有此选项，则键入Control+C 会中断当前语句（如果有的话），否则会取消任何部分输入行。

--silent,-s

静音模式。产生更少的输出。可以多次给出此选项以产生越来越少的输出。

此选项导致非表格输出格式和特殊字符转义。可以使用原始模式禁用转义；请参阅 --raw选项的说明。

--skip-column-names, -N

不要在结果中写列名。

--skip-line-numbers, -L

不要为错误写行号。当您想要比较包含错误消息的结果文件时很有用。

--socket=path, -S path

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

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

--ssl*

以 开头的选项--ssl指定是否使用加密连接到服务器并指示在哪里可以找到 SSL 密钥和证书。请参阅 加密连接的命令选项。

--syslog,-j

此选项使mysql将交互式语句发送到系统日志记录工具。在 Unix 上，这是syslog; 在 Windows 上，它是 Windows 事件日志。记录消息出现的目的地取决于系统。在 Linux 上，目的地通常是/var/log/messages文件。

下面是在 Linux 上使用 --syslog. 此输出经过格式化以提高可读性；每个记录的消息实际上只占一行。

Mar  7 12:39:25 myhost MysqlClient[20824]:
  SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23,
  DB_SERVER:'127.0.0.1', DB:'--', QUERY:'USE test;'
Mar  7 12:39:28 myhost MysqlClient[20824]:
  SYSTEM_USER:'oscar', MYSQL_USER:'my_oscar', CONNECTION_ID:23,
  DB_SERVER:'127.0.0.1', DB:'test', QUERY:'SHOW TABLES;'

有关详细信息，请参阅第 4.5.1.3 节，“mysql 客户端日志记录”。

--table,-t

以表格格式显示输出。这是交互使用的默认设置，但可用于以批处理模式生成表输出。

--tee=file_name

将输出副本附加到给定文件。此选项仅适用于交互模式。第 4.5.1.2 节，“mysql 客户端命令”，进一步讨论了 tee 文件。

--tls-version=protocol_list

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

这个选项是在 MySQL 5.7.10 中添加的。

--unbuffered, -n

每次查询后刷新缓冲区。

--user=user_name, -u user_name

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

--verbose,-v

详细模式。产生更多关于程序做什么的输出。可以多次给出此选项以产生越来越多的输出。（例如，-v -v -v即使在批处理模式下也能生成表格输出格式。）

--version,-V

显示版本信息并退出。

--vertical, -E

垂直打印查询输出行（每列值一行）。如果没有此选项，您可以通过以 . 结尾来为单个语句指定垂直输出 \G。

--wait,-w

如果无法建立连接，请等待并重试，而不是中止。

--xml,-X

生成 XML 输出。

<field name="column_name">NULL</field>

--xml与mysql一起使用 时的输出与mysqldump 的输出相匹配 --xml。有关详细信息，请参阅 第 4.5.4 节，“mysqldump — 数据库备份程序”。

XML 输出还使用 XML 命名空间，如下所示：

$> mysql --xml -uroot -e "SHOW VARIABLES LIKE 'version%'"
<?xml version="1.0"?>

<resultset statement="SHOW VARIABLES LIKE 'version%'" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<row>
<field name="Variable_name">version</field>
<field name="Value">5.0.40-debug</field>
</row>

<row>
<field name="Variable_name">version_comment</field>
<field name="Value">Source distribution</field>
</row>

<row>
<field name="Variable_name">version_compile_machine</field>
<field name="Value">i686</field>
</row>

<row>
<field name="Variable_name">version_compile_os</field>
<field name="Value">suse-linux-gnu</field>
</row>
</resultset>