MySQL :: MySQL 9.0 参考手册 :: 6.2.2.1 在命令行中使用选项

版本 9.0

8.4 当前
8.0
5.7

8.0 日语

MySQL 9.0 参考手册 / ... / 在命令行中使用选项

6.2.2.1 在命令行中使用选项

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

选项在命令名称之后给出。
选项参数以一个破折号或两个破折号开头，具体取决于它是选项名称的简短形式还是长形式。许多选项都有简短形式和长形式。例如，-? 和 --help 是指示 MySQL 程序显示其帮助消息的选项的简短形式和长形式。
选项名称区分大小写。-v 和 -V 都是合法的，但具有不同的含义。（它们分别是 --verbose 和 --version 选项的相应简短形式。）
某些选项在选项名称之后取一个值。例如，-h localhost 或 --host=localhost 向客户端程序指示 MySQL 服务器主机。选项值告诉程序 MySQL 服务器运行的主机名称。
对于取值的长选项，用 = 符号分隔选项名称和值。对于取值的短选项，选项值可以紧跟在选项字母之后，也可以在选项字母之后留一个空格：-hlocalhost 和 -h localhost 等效。此规则的例外情况是用于指定 MySQL 密码的选项。此选项可以长形式给出，例如 --password=pass_val 或 --password。在后一种情况下（未给出密码值），程序将以交互方式提示您输入密码。密码选项也可以简短形式给出，例如 -ppass_val 或 -p。但是，对于简短形式，如果给出了密码值，它必须紧跟在选项字母之后，之间没有空格：如果在选项字母之后留有空格，程序将无法判断后续参数是密码值还是其他类型的参数。因此，以下两个命令具有完全不同的含义
```
mysql -ptest
mysql -p test
```
第一个命令指示 mysql 使用 test 作为密码值，但不指定默认数据库。第二个命令指示 mysql 提示输入密码值，并使用 test 作为默认数据库。
在选项名称中，破折号 (-) 和下划线 (_) 在大多数情况下可以互换使用，尽管不能将下划线用作开头破折号。例如，--skip-grant-tables 和 --skip_grant_tables 等效。
在本手册中，我们使用破折号作为选项名称，除非下划线具有特殊意义。例如，--log-bin 和 --log_bin 属于不同的选项。我们也鼓励您这样做。
MySQL 服务器有一些命令选项，这些选项只能在启动时指定，还有一组系统变量，其中一些可以在启动时、运行时或两者都设置。系统变量名称使用下划线而不是破折号，并且在运行时引用时（例如，使用 SET 或 SELECT 语句），必须使用下划线书写
```
SET GLOBAL general_log = ON;
SELECT @@GLOBAL.general_log;
```
在服务器启动时，系统变量的语法与命令选项相同，因此在变量名称内，破折号和下划线可以互换使用。例如，--general_log=ON 和 --general-log=ON 等效。（这也适用于在选项文件中设置的系统变量。）
对于取数值的选项，可以使用 K、M 或 G 后缀来指定值，分别表示 1024、1024² 或 1024³ 的倍数。从 MySQL 8.0.14 开始，后缀也可以是 T、P 和 E，分别表示 1024⁴、1024⁵ 或 1024⁶ 的倍数。后缀字母可以是大写或小写。
例如，以下命令告诉 mysqladmin ping 服务器 1024 次，每次 ping 之间睡眠 10 秒
```
mysqladmin --count=1K --sleep=10 ping
```
在指定文件名作为选项值时，避免使用 ~ Shell 元字符。它可能不会按预期解释。

在命令行上给出时，包含空格的选项值必须用引号括起来。例如，--execute（或 -e）选项可与 mysql 一起使用，将一个或多个以分号分隔的 SQL 语句传递给服务器。使用此选项时，mysql 将执行选项值中的语句并退出。语句必须用引号括起来。例如

$> mysql -u root -p -e "SELECT VERSION();SELECT NOW()"
Enter password: ******
+------------+
| VERSION()  |
+------------+
| 8.0.19     |
+------------+
+---------------------+
| NOW()               |
+---------------------+
| 2019-09-03 10:36:48 |
+---------------------+
$>

注意

长形式 (--execute) 后面跟着一个等号 (=)。

要在语句中使用带引号的值，您必须对内部引号进行转义，或者在语句中使用与用于引用语句本身的引号不同的引号类型。您的命令处理器的功能决定了您可以使用单引号还是双引号以及转义引号字符的语法。例如，如果您的命令处理器支持使用单引号或双引号进行引用，您可以在语句周围使用双引号，并使用单引号来引用语句内的任何带引号的值。