1.2 印刷约定和语法约定
本手册使用某些印刷约定:
-
Text in this style
用于 SQL 语句;数据库,table 和列的名称;程序 Lists 和源代码;和环境变量。示例:“要重新加载授权 table,请使用FLUSH PRIVILEGES语句。” -
Text in this style
table 示您在示例中 Importing 的内容。 -
此样式的文本 table 示可执行程序和脚本的名称,示例为mysql(MySQL 命令行 Client 端程序)和mysqld(MySQL 服务器可执行文件)。
-
Text in this style
*用于变量 Importing,您应为其替换自己选择的值。
-
此样式的文本用于强调。
-
此样式的文本 用于 table 格标题,并特别强调。
-
Text in this style
用于指示影响程序执行方式的程序选项,或提供程序以某种方式运行所需的信息。 示例:“--host
选项(缩写为-h
)告诉mysqlClient 端程序应连接的 MySQL 服务器的主机名或 IP 地址。” -
文件名和目录名的写法是这样的:“全局
my.cnf
文件位于/etc
目录中。” -
字符序列的编写方式如下:“要指定通配符,请使用'
%
'字符。”
当显示了要从特定程序中执行的命令时,该命令之前显示的提示指示要使用的命令。例如,shell>
table 示您从登录 Shell 执行的命令,root-shell>
类似,但应作为root
执行,mysql>
table 示您从mysqlClient 端程序执行的语句:
shell> type a shell command here
root-shell> type a shell command as root here
mysql> type a mysql statement here
在某些 locale,不同的系统可能会彼此区分开,以 table 明命令应在两个不同的环境中执行。例如,在进行复制时,命令可能带有master
和slave
前缀:
master> type a mysql command on the replication master here
slave> type a mysql command on the replication slave here
“Shell”是您的命令解释器。在 Unix 上,这通常是诸如 sh , csh 或 bash 之类的程序。在 Windows 上,等效程序是 command.com 或 cmd.exe ,通常在控制台窗口中运行。
Importing 示例中显示的命令或语句时,请勿键入示例中显示的提示。
数据库,table 和列名称必须经常替换为语句。为了 table 示必须进行这种替换,本手册使用* db_name
, tbl_name
和 col_name
*。例如,您可能会看到类似以下的语句:
mysql> SELECT col_name FROM db_name.tbl_name;
这意味着,如果要 Importing 类似的语句,则将提供自己的数据库,table 和列名称,也许像这样:
mysql> SELECT author_name FROM biblio_db.author_list;
SQL 关键字不区分大小写,并且可以用任何大写字母书写。本手册使用大写字母。
在语法描述中,方括号(“ [
”和“ ]
”)table 示可选的单词或从句。例如,在以下语句中,IF EXISTS
是可选的:
DROP TABLE [IF EXISTS] tbl_name
当语法元素由多个替代项组成时,替代项由竖线(“ |
”)分隔。 可以从一组选项中选择一个成员时,替代项列在方括号中(“ [
”和“ ]
”):
TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)
如果必须从一组选择中选择一个成员,则在括号(“ {
”和“ }
”)中列出替代项:
{DESCRIBE | DESC} tbl_name [col_name | wild]
省略号(...
)table 示省略了语句的一部分,通常是为了提供更复杂语法的较短版本。例如,选择...进入外档是SELECT语句形式的简写,该语句在该语句的其他部分之后具有INTO OUTFILE
子句。
省略号还可以指示语句的前面的语法元素可以重复。在下面的示例中,可以给出多个* reset_option
*值,每个值之后的第一个都以逗号开头:
RESET reset_option [,reset_option] ...
使用 Bourne shell 语法显示用于设置 shell 变量的命令。例如,在 Bourne shell 语法中,设置CC
环境变量并运行 configure 命令的 Sequences 如下所示:
shell> CC=gcc ./configure
如果您使用 csh 或 tcsh ,则必须以不同的方式发出命令:
shell> setenv CC gcc
shell> ./configure