书写格式约定和语法约定

本手册使用某些书写格式约定：

• 此样式的文本用于SQL语句；数据库，表和列的名称；程序清单和源代码；和环境变量。示例：“要重新加载授权表，请使用以下FLUSH PRIVILEGES语句。”

• 此样式的文本表示您在示例中输入的输入。
• 此样式的文本表示可执行程序和脚本的名称，例如mysql（MySQL命令行客户端程序）和 mysqld（MySQL服务器可执行文件）。
• 此样式的文本用于变量输入，您应为其替换自己选择的值。
• 此样式的文本用于强调。
• 此样式的文本用于表格标题，并特别强调。
• 用于表示影响程序执行方式或提供程序以某种方式运行所需的信息的程序选项。示例：“该--host选项（简写形式-h）告诉mysql客户端程序应连接到的MySQL服务器的主机名或IP地址”。
• 文件名和目录名的写法如下：“全局my.cnf文件位于/etc目录中。”
• 字符序列的编写方式如下：“要指定通配符，请使用'%'字符。”

当显示了要从特定程序中执行的命令时，该命令之前显示的提示指示要使用的命令。例如，shell>表示您从登录外壳执行的命令，root-shell>与之类似，但应作为来执行root，并mysql>表示您从mysql客户端程序执行的语句：

shell>type a shell command here
root-shell>type a shell command as root here
mysql>type a mysql statement here

在某些地区，可能会将不同的系统区分开来，以表明应在两个不同的环境中执行命令。例如，复制工作时的命令可能与前缀master和slave：

master>type a mysql command on the replicationmaster here
slave>type a mysql command on the replicationslave here

该“壳”是您的命令解释器。在Unix上，这通常是诸如sh，csh或bash之类的程序。在Windows上，等效程序是command.com或cmd.exe，通常在控制台窗口中运行。

输入示例中显示的命令或语句时，请勿键入示例中显示的提示。

数据库，表和列的名称通常必须替换为语句。为了指示这样的取代是必要的，本说明书的用途db_name，tbl_name和col_name。例如，您可能会看到类似以下的语句：

mysql>SELECTcol_nameFROMdb_name.tbl_name;

这意味着，如果要输入类似的语句，则将提供自己的数据库，表和列名称，也许像这样：

mysql>SELECTauthor_nameFROMbiblio_db.author_list;

SQL关键字不区分大小写，可以用任何大写字母书写。本手册使用大写字母。

在语法描述中，方括号（“[”和“]”）表示可选的单词或从句。例如，在以下语句中，它IF EXISTS是可选的：

DROPTABLE [IFEXISTS] tbl_name 

当一个语法元素由许多替代方案中，替代由垂直条分离（“|”）。当从一组的一个选择部件可以被选择，则将替换方括号（内列出的“[”和“]”）：

TRIM([[BOTH | LEADING | TRAILING] [remstr] FROM] str)

当必须从一组选项中选择一个成员时，这些替代项会在大括号（“{”和“}”）中列出：

{DESCRIBE | DESC}tbl_name [col_name | wild]

省略号（...）表示语句部分的省略，通常是为了提供更复杂语法的较短版本。例如，SELECT ... INTO OUTFILE是SELECT语句形式的简写，该语句的INTO OUTFILE后面还有一个子句。

省略号还可以指示语句的前面的语法元素可以重复。在下面的示例中，reset_option可以给出多个值，每个值之后的第一个值前面都带有逗号：

RESETreset_option [,reset_option]...

使用Bourne shell语法显示用于设置shell变量的命令。例如，在Bourne shell语法中，设置CC环境变量和运行configure命令的顺序如下所示：

shell>CC=gcc./configure

如果使用csh或tcsh，则必须以不同的方式发出命令：

shell>setenv CC gcc
shell>./configure