第4章MySQL程序

外壳> mysql -h example.com -h localhost

外壳> mysql --column-names --skip-column-names

命令行中指定的程序选项遵循以下规则：

在命令行上给出时，必须引用包含空格的选项值。 例如， --execute （或 -e ）选项可以与 mysql 一起 使用， 以将SQL语句传递给服务器。 使用此选项时， mysql将 执行选项值中的语句并退出。 声明必须用引号括起来。 例如，您可以使用以下命令获取用户帐户列表：

shell> mysql -u root -p --execute="SELECT User, Host FROM mysql.user"
输入密码：******
+ ------ + ----------- +
| 用户| 主持人|
+ ------ + ----------- +
| | 吉甘|
| 根| 吉甘|
| | localhost |
| jon | localhost |
| 根| localhost |
+ ------ + ----------- +
外壳>

如果希望在语句中使用带引号的值，则需要转义内部引号，或者在语句中使用与引用语句本身引用的引号不同的引号。 命令处理器的功能决定了您是否可以使用单引号或双引号以及转义引号字符的语法。 例如，如果命令处理器支持使用单引号或双引号引用，则可以在语句周围使用双引号，并在语句中使用任何引用值的单引号。

可以在命令行的选项值中传递多个SQL语句，用分号分隔：

shell> mysql -u root -p -e "SELECT VERSION();SELECT NOW()"
输入密码：******
+ ------------ +
| 版本（）|
+ ------------ +
| 8.0.11 |
+ ------------ +
+ --------------------- +
| 现在（）|
+ --------------------- +
| 2019-05-17 11:43:57 |
+ --------------------- +

大多数MySQL程序都可以从选项文件（有时称为配置文件）中读取启动选项。 选项文件提供了一种指定常用选项的便捷方式，因此每次运行程序时都无需在命令行中输入这些选项。

要确定程序是否读取选项文件，请使用该 --help 选项 调用它 。 （对于 mysqld ，请使用 --verbose 和 --help 。）如果程序读取选项文件，则帮助消息指示它查找哪些文件以及它识别哪些选项组。

许多选项文件都是纯文本文件，使用任何文本编辑器创建。 例外情况是：

MySQL按照以下讨论中描述的顺序查找选项文件，并读取任何存在的选项。 如果您要使用的选项文件不存在，请使用适当的方法创建它，如上所述。

在Windows上，MySQL程序按照指定的顺序从下表中显示的文件中读取启动选项（首先列出的文件首先读取，后面读取的文件优先）。

在上表中， %WINDIR% 表示Windows目录的位置。 这通常是 C:\WINDOWS 。 使用以下命令从 WINDIR 环境变量 的值确定其确切位置 ：

C：\> echo %WINDIR%

%APPDATA% 表示Windows应用程序数据目录的值。 使用以下命令从 APPDATA 环境变量 的值确定其确切位置 ：

C：\> echo %APPDATA%

BASEDIR 代表MySQL基本安装目录。 当MySQL 8.0已经使用MySQL Installer安装的，这通常是 其中 代表项目目录（通常 在Windows的英语语言版本），参见 2.3.3节，“MySQL的安装程序的Windows” 。 C:\PROGRAMDIR\MySQL\MySQL 8.0 Server PROGRAMDIR Program Files

DATADIR 代表MySQL数据目录。 用于查找时 mysqld-auto.cnf ，其默认值是编译MySQL时内置的数据目录位置，但可以通过 --datadir 指定为处理之前 mysqld-auto.cnf 处理 的选项文件或命令行选项 进行更改 。

在Unix和类Unix系统上，MySQL程序按照指定的顺序从下表中显示的文件中读取启动选项（首先列出的文件首先读取，后面读取的文件优先）。

在上表中， ~ 表示当前用户的主目录（值 $HOME ）。

SYSCONFDIR 表示在 构建MySQL时 SYSCONFDIR 使用 CMake 选项 指定的目录 。 默认情况下，这是 etc 编译安装目录下的目录。

MYSQL_HOME 是一个环境变量，包含特定于服务器的 my.cnf 文件所在 目录的路径 。 如果 MYSQL_HOME 未设置并使用 mysqld_safe 程序 启动服务器 ，则 mysqld_safe 将其设置 BASEDIR 为MySQL基本安装目录。

DATADIR 代表MySQL数据目录。 用于查找时 mysqld-auto.cnf ，其默认值是编译MySQL时内置的数据目录位置，但可以通过 --datadir 指定为处理之前 mysqld-auto.cnf 处理 的选项文件或命令行选项 进行更改 。

如果找到给定选项的多个实例，则最后一个实例优先，但有一个例外：对于 mysqld ， 该 选项 的 第一个 实例 --user 用作安全预防措施，以防止在选项文件中指定的用户被覆盖在命令行。

选项文件语法的以下说明适用于您手动编辑的文件。 这排除 .mylogin.cnf 了使用 mysql_config_editor 创建 并加密，并且 mysqld-auto.cnf 服务器以JSON格式创建。

运行MySQL程序时可以在命令行上给出的任何长选项也可以在选项文件中给出。 要获取程序的可用选项列表，请使用该 --help 选项 运行它 。 （对于 mysqld ，使用 --verbose 和 --help 。）

在选项文件中指定选项的语法类似于命令行语法（请参见 第4.2.2.1节“在命令行上使用选项” ）。 但是，在选项文件中，省略选项名称中的前两个破折号，并且每行只指定一个选项。 例如， --quick 与 --host=localhost 在命令行上应被指定为 quick 与 host=localhost 上在选项文件单独的行。 要 在选项文件中 指定表单 选项，请将其写为 。 --loose-opt_name loose-opt_name

选项文件中的空行将被忽略。 非空行可以采用以下任何一种形式：

从选项名称和值中自动删除前导和尾随空格。

您可以使用转义序列 \b ， \t ， \n ， \r ， \\ ，并 \s 在选项值来表示退格，制表符，换行符，回车，回车，和空格字符。 在选项文件中，这些转义规则适用：

前面的规则意味着可以给出一个字面反斜杠 \\ ，或者 \ 好像它没有后跟一个有效的转义序列字符。

选项文件中的转义序列规则与SQL语句中字符串文字中的转义序列规则略有不同。 在后一种情况下，如果 “ x ” 不是有效的转义序列字符，则 变为 “ ” 而不是 。 请参见 第9.1.1节“字符串文字” 。 \x x \x

选项文件值的转义规则尤其适用于Windows路径名，它 \ 用作路径名分隔符。 必须写入Windows路径名中的分隔符，就 \\ 好像后面跟一个转义序列字符一样。 它可以写成 \\ 或者 \ 如果它不是。 或者， / 可以在Windows路径名中使用，并将其视为 \ 。 假设您要 C:\Program Files\MySQL\MySQL Server 8.0 在选项文件中 指定基目录 。 这可以通过几种方式完成。 一些例子：

basedir =“C：\ Program Files \ MySQL \ MySQL Server 8.0”
basedir =“C：\\ Program Files \\ MySQL \\ MySQL Server 8.0”
basedir =“C：/ Program Files / MySQL / MySQL Server 8.0”
BASEDIR = C：\\程序\ sFiles \\ \\的MySQL的MySQL \ sServer \ S8.0

如果选项组名称与程序名称相同，则组中的选项将专门应用于该程序。 例如， [mysqld] 和 [mysql] 组分别应用于 mysqld 服务器和 mysql 客户端程序。

该 [client] 选项组是由MySQL分发提供（但所有的客户端程序读取 未 通过 的mysqld ）。 要了解使用C API的第三方客户端程序如何使用选项文件，请参见 第28.7.7.50节“mysql_options（）”中 的C API文档 。

该 [client] 组使您可以指定适用于所有客户端的选项。 例如， [client] 是用于指定连接到服务器的密码的适当组。 （但请确保选项文件只能由您自己访问，以便其他人无法发现您的密码。） [client] 除非 您使用的 所有 客户端程序 都识别 该选项， 否则 请确保不在该 组中添加 选项 。 如果尝试运行错误消息，则在显示错误消息后，不理解该选项的程序将退出。

稍后列出更多通用选项组和更具体的组。 例如，一个 [client] 组更通用，因为它被所有客户端程序读取，而一个 [mysqldump] 组只能由 mysqldump 读取 。 后来指定的选项覆盖在此之前指定的选项，所以把该选项组中的顺序 [client] ， [mysqldump] 使 mysqldump的 特异性选项覆盖 [client] 选项。

这是一个典型的全局选项文件：

[客户]
端口= 3306
插座= / TMP /的mysql.sock

的[mysqld]
端口= 3306
插座= / TMP /的mysql.sock
的key_buffer_size = 16M
max_allowed_pa​​cket的= 128M

[mysqldump的]
快

这是一个典型的用户选项文件：

[客户]
＃以下密码将发送给所有标准MySQL客户端
密码=“我的密码”

[MySQL的]
无自动翻版
connect_timeout = 2

要创建仅由 特定MySQL发行版系列中 的 mysqld 服务器 读取的选项组 ，请使用名称为 [mysqld-5.7] ， [mysqld-8.0] 等的组。 以下组表示该 sql_mode 设置仅应由具有8.0.x版本号的MySQL服务器使用：

的[mysqld-8.0]
的sql_mode =繁体

可以 !include 在选项文件中 使用 指令来包含其他选项文件，并 !includedir 在特定目录中搜​​索选项文件。 例如，要包含该 /home/mydir/myopt.cnf 文件，请使用以下指令：

！include /home/mydir/myopt.cnf

要搜索 /home/mydir 目录并读取那里找到的选项文件，请使用以下指令：

！includedir / home / mydir

MySQL不保证读取目录中选项文件的顺序。

像任何其他选项文件一样写入包含的选项文件的内容。 也就是说，它应该包含选项组，每个选项前面都有 一行，表示选项适用的程序。 [group]

在处理包含文件时，仅使用当前程序正在查找的组中的那些选项。 其他组被忽略。 假设一个 my.cnf 文件包含这一行：

！include /home/mydir/myopt.cnf

并假设 /home/mydir/myopt.cnf 看起来像这样：

[中mysqladmin]
力

的[mysqld]
的key_buffer_size = 16M

如果 my.cnf 由 mysqld 处理 ，则仅使用 [mysqld] 组in /home/mydir/myopt.cnf 。 如果文件由 mysqladmin 处理 ，则仅使用该 [mysqladmin] 组。 如果该文件由任何其他程序处理，则不 /home/mydir/myopt.cnf 使用 任何选项 。

!includedir 除了读取指定目录中的所有选项文件外， 该 指令的处理方式类似。

如果选项文件包含 !include 或 !includedir 指令，则只要处理选项文件，就会处理由这些指令命名的文件，无论它们出现在文件中的哪个位置。

大多数支持选项文件的MySQL程序都处理以下选项。 由于这些选项会影响选项文件处理，因此必须在命令行中提供它们，而不是在选项文件中。 要正常工作，必须在其他选项之前给出每个选项，但有以下例外：

将文件名指定为选项值时，请避免使用 ~ shell元字符，因为它可能不会按预期解释。

一些选项是 “ 布尔 ” 和可以打开或关闭的控制行为。 例如， mysql 客户端支持一个 --column-names 选项，用于确定是否在查询结果的开头显示一行列名。 默认情况下，启用此选项。 但是，您可能希望在某些情况下禁用它，例如将 mysql 的输出发送 到另一个期望仅查看数据而不是初始标题行的程序时。

要禁用列名，可以使用以下任何一种形式指定选项：

- 禁用列名
--skip-列名
--column-名称= 0

在 --disable 与 --skip 前缀和 =0 后缀都具有相同的效果：它们均关闭选项。

可以通过以下任何方式指定选项 的 “ 启用 ” 形式：

--column-名
--enable-列名
--column-名称= 1

值 ON ， TRUE ， OFF ，和 FALSE 也被识别为布尔选项（不区分大小写）。

如果选项以前缀为前缀 --loose ，如果程序无法识别该选项，则程序不会退出并显示错误，而是仅发出警告：

外壳> mysql --loose-no-such-option
mysql：警告：未知选项'--loose-no-such-option'

--loose 当您在同一台计算机上运行MySQL的多个安装程序并在选项文件中列出选项时 ， 前缀非常有用。 可以使用 --loose 前缀（或 loose 在选项文件中） 给出可能无法被程序的所有版本识别 的选项。 识别该选项的程序版本正常处理，而不识别它的版本会发出警告并忽略它。

该 --maximum 前缀仅适用于 mysqld， 并允许对大型客户端程序设置会话系统变量的方式进行限制。 为此，请使用 --maximum 带有变量名称 的 前缀。 例如， --maximum-max_heap_table_size=32M 防止任何客户端使堆表大小限制大于32M。

该 --maximum 前缀旨在用于具有会话值的系统变量。 如果应用于仅具有全局值的系统变量，则会发生错误。 例如，使用 --maximum-back_log=200 ，服务器产生此错误：

无法设置'back_log'的最大值

许多MySQL程序都有内部变量，可以使用该 SET 语句 在运行时设置 。 请参见 第13.7.5.1节“变量赋值的SET语法” 和 第5.1.9节“使用系统变量” 。

这些程序变量中的大多数也可以通过使用与指定程序选项相同的语法在服务器启动时设置。 例如， mysql 有一个 max_allowed_packet 控制其通信缓冲区最大大小的变量。 要将 mysql 的 max_allowed_packet 变量 设置 为16MB的值，请使用以下任一命令：

shell> mysql --max_allowed_packet=16777216
shell>mysql --max_allowed_packet=16M

第一个命令指定以字节为单位的值。 第二个指定以兆字节为单位的值。 对于采用数字值的变量，该值可以与一个后缀被给予 K ， M 或者 G 以指示1024一乘法器，1024 ² 或1024 ³ 。 （例如，用于设置时 max_allowed_packet ，后缀表示以千字节，兆字节或千兆字节为单位）。如MySQL的8.0.14的，后缀也可以是 T ， P 和 E 以指示1024乘法器 ⁴ ，1024 ⁵ 或1024 ⁶ 。 后缀字母可以是大写或小写。

在选项文件中，给出的变量设置没有前导破折号：

[MySQL的]
max_allowed_pa​​cket的= 16777216

要么：

[MySQL的]
max_allowed_pa​​cket的= 16M

如果您愿意，可以将变量名称中的下划线指定为破折号。 以下选项组是等效的。 两者都将服务器密钥缓冲区的大小设置为512MB：

的[mysqld]
的key_buffer_size = 512M

的[mysqld]
密钥缓冲器大小= 512M

变量可以通过完整写入或任何明确的前缀来指定。 例如，该 max_allowed_packet 变量可以被设置 的MySQL 为 --max_a ，但不作为 --max ，因为后者是不明确的：

外壳> mysql --max=1000000
mysql：模糊选项' -  max = 1000000'（max_allowed_pa​​cket，max_join_size）

请注意，在为程序实现新变量的情况下，使用变量前缀可能会导致问题。 现在明确无误的前缀可能在将来变得模棱两可。

在服务器启动时设置变量时，可以使用指定值乘数的后缀，但不能 SET 在运行时 设置值 。 另一方面， SET 使用表达式可以指定变量的值，在服务器启动时设置变量时不是这样。 例如，以下第一行在服务器启动时是合法的，但第二行不是：

shell> mysql --max_allowed_packet=16M
shell>mysql --max_allowed_packet=16*1024*1024

相反，以下第二行在运行时是合法的，但第一行不是：

mysql> SET GLOBAL max_allowed_packet=16M;
mysql>SET GLOBAL max_allowed_packet=16*1024*1024;

按照惯例，分配值的长形式选项使用equals（ = ）符号 写入 ，如下所示：

外壳> mysql --host=tonfisk --user=jon

对于需要值的选项（即没有默认值），不需要等号，因此以下内容也有效：

外壳> mysql --host tonfisk --user jon

在这两种情况下， mysql 客户端都尝试 使用用户名为 “ jon ” 的帐户 连接到名为 “ tonfisk ” 的主机上运行的MySQL服务器 。

由于这种行为，当没有为期望的选项提供任何值时，偶尔会出现问题。 看看下面的例子，当用户连接到主机上运行的MySQL服务器 tonfisk 的用户 jon ：

外壳> mysql --host 85.224.35.45 --user jon
欢迎使用MySQL监视器。命令以;结尾; 或\ g。
您的MySQL连接ID是3
服务器版本：8.0.18源代码分发

输入'help;' 或'\ h'寻求帮助。输入'\ c'清除缓冲区。

MySQL的> SELECT CURRENT_USER();
+ ---------------- +
| CURRENT_USER（）|
+ ---------------- +
| jon @％|
+ ---------------- +
1排（0.00秒）

省略其中一个选项所需的值会产生错误，例如此处显示的错误：

shell> mysql：选项'--user'需要一个参数mysql --host 85.224.35.45 --user

在这种情况下， mysql 无法在该 --user 选项 后面找到值， 因为在命令行后没有任何 值 。 但是，如果省略 不是 最后 一个选项的选项的值 ，则会获得您可能不期望的其他错误：

shell> ERROR 2005（HY000）：未知的MySQL服务器主机'--user'（1）mysql --host --user jon

因为 mysql 假定 --host 命令行 后面的任何字符串 是主机名， 所以解释为 ，并且客户端尝试连接到在名为 “ --user ” 的主机上运行的MySQL服务器 。 --host --user --host=--user

具有默认值的选项在分配值时始终需要等号; 如果不这样做会导致错误。 例如，MySQL服务器 --log-error 选项具有默认值 host_name.err ，其中 host_name 是运行MySQL的主机的名称。 假设您在主机名为 “ tonfisk ” 的计算机上运行MySQL ，并考虑以下对 mysqld_safe的 调用 ：

外壳> mysqld_safe &
[1] 11699
shell> 080112 12:53:40 mysqld_safe登录到'/usr/local/mysql/var/tonfisk.err'。
080112 12:53:40 mysqld_safe使用/ usr / local / mysql / var中的数据库启动mysqld守护程序
外壳>

关闭服务器后，按如下所示重新启动它：

外壳> mysqld_safe --log-error &
[1] 11699
shell> 080112 12:53:40 mysqld_safe登录到'/usr/local/mysql/var/tonfisk.err'。
080112 12:53:40 mysqld_safe使用/ usr / local / mysql / var中的数据库启动mysqld守护程序
外壳>

结果是相同的，因为 --log-error 命令行上没有任何其他内容，它提供了自己的默认值。 （该 & 字符告诉操作系统在后台运行MySQL; MySQL本身会忽略它。）现在假设您希望将错误记录到名为的文件中 my-errors.err 。 您可以尝试启动服务器 --log-error my-errors ，但这没有预期的效果，如下所示：

外壳> mysqld_safe --log-error my-errors &
[1] 31357
shell> 080111 22:53:31 mysqld_safe登录到'/usr/local/mysql/var/tonfisk.err'。
080111 22:53:32 mysqld_safe使用/ usr / local / mysql / var中的数据库启动mysqld守护程序
080111 22:53:34来自pid文件/usr/local/mysql/var/tonfisk.pid的mysqld_safe mysqld已结束

[1] +完成./mysqld_safe --log-error my-errors

服务器尝试开始 /usr/local/mysql/var/tonfisk.err 用作错误日志，但随后关闭。 检查此文件的最后几行显示原因：

外壳> tail /usr/local/mysql/var/tonfisk.err
2013-09-24T15：36：22.278034Z 0 [ERROR]参数太多（第一个额外的是'my-errors'）。
2013-09-24T15：36：22.278059Z 0 [注意]使用--verbose --help获取可用选项列表！
2013-09-24T15：36：22.278076Z 0 [ERROR]中止
2013-09-24T15：36：22.279704Z 0 [注意] InnoDB：开始关机......
2013-09-24T15：36：23.777471Z 0 [注意] InnoDB：关机完成; 日志序列号2319086
2013-09-24T15：36：23.780134Z 0 [注意] mysqld：关闭完成

由于该 --log-error 选项提供默认值，因此必须使用等号为其指定不同的值，如下所示：

外壳> mysqld_safe --log-error=my-errors &
[1] 31437
shell> 080111 22:54:15 mysqld_safe登录到'/usr/local/mysql/var/my-errors.err'。
080111 22:54:15 mysqld_safe使用/ usr / local / mysql / var中的数据库启动mysqld守护程序

外壳>

现在服务器已成功启动，并将错误记录到文件中 /usr/local/mysql/var/my-errors.err 。

在选项文件中指定选项值时可能会出现类似问题。 例如，考虑 my.cnf 包含以下内容 的 文件：

[MySQL的]

主办
用户

当 mysql 客户端读取此文件时，这些条目将被解析为 或 ，结果如下所示： --host --user --host=--user

shell> ERROR 2005（HY000）：未知的MySQL服务器主机'--user'（1）mysql

但是，在选项文件中，不会假定等号。 假设 my.cnf 文件如下所示：

[MySQL的]

用户jon

在这种情况下 尝试启动 mysql 会导致不同的错误：

shell> mysql：未知选项'--user jon'mysql

如果您要 host tonfisk 在选项文件中而不是 写入 ， 则会发生类似的错误 host=tonfisk 。 相反，您必须使用等号：

[MySQL的]

用户=乔恩

现在登录尝试成功：

外壳> mysql
欢迎使用MySQL监视器。命令以;结尾; 或\ g。
您的MySQL连接ID是5
服务器版本：8.0.18源代码分发

输入'help;' 或'\ h'寻求帮助。输入'\ c'清除缓冲区。

MySQL的> SELECT USER();
+ --------------- +
| USER（）|
+ --------------- +
| jon @ localhost |
+ --------------- +
1排（0.00秒）

这与命令行的行为不同，其中不需要等号：

外壳> mysql --user jon --host tonfisk
欢迎使用MySQL监视器。命令以;结尾; 或\ g。
您的MySQL连接ID是6
服务器版本：8.0.18源代码分发

输入'help;' 或'\ h'寻求帮助。输入'\ c'清除缓冲区。

MySQL的> SELECT USER();
+ --------------- +
| USER（）|
+ --------------- +
| jon @ tonfisk |
+ --------------- +
1排（0.00秒）

指定需要在选项文件中没有值的值的选项会导致服务器因错误而中止。 假设 my.cnf 包含以下内容：

的[mysqld]
的log_error
relay_log
relay_log_index

这会导致服务器在启动时失败，如下所示：

外壳> mysqld_safe &

130924 10:41:46 mysqld_safe登录到'/home/jon/bin/mysql/var/tonfisk.err'。
130924 10:41:46 mysqld_safe使用/ home / jon / bin / mysql / var中的数据库启动mysqld守护程序
130924 10:41:47来自pid文件/home/jon/bin/mysql/var/tonfisk.pid的mysqld_safe mysqld已结束

该 --log-error 选项不需要参数; 但是，该 --relay-log 选项需要一个，如错误日志中所示（在没有指定值的情况下，默认为 ）： datadir/hostname.err

外壳> tail -n 3 ../var/tonfisk.err

130924 10:41:46 mysqld_safe使用/ home / jon / bin / mysql / var中的数据库启动mysqld守护程序
2013-09-24T15：41：47.217180Z 0 [错误] / home / jon / bin / mysql / libexec / mysqld：选项'--relay-log'需要参数
2013-09-24T15：41：47.217479Z 0 [错误]中止

这是对先前行为的更改，其中服务器将示例 my.cnf 文件中 的最后两行解释 为， --relay-log=relay_log_index 并使用 “ relay_log_index ” 作为基本名称 创建中继日志文件 。 （缺陷号25192）