1.2排版和语法约定
本手册使用某些印刷约定:
Text in this style用于SQL语句;数据库,表和列名称;程序列表和源代码;和环境变量。示例:“要重新加载授予表,请使用该FLUSH PRIVILEGES语句。“Text in this style表示您输入示例的输入。此样式的文本表示可执行程序和脚本的名称,例如mysql(MySQL命令行客户端程序)和mysqld(MySQL服务器可执行文件)。
Text in this style用于变量输入,您应该替换自己选择的值。这种风格的文字用于强调。
这种风格的文字用于表格标题,并特别强调。
Text in this style用于指示影响程序执行的程序选项,或者提供程序以某种方式运行所需的信息。例如:“该--host选项(缩写形式-h)告诉MySQL的客户端程序,它应该连接到MySQL服务器的主机名或IP地址”。文件名和目录名称如下:“全局
my.cnf文件位于/etc目录中。“字符序列如下所示:“要指定通配符,请使用”
%“字符。“
当显示要从特定程序中执行的命令时,该命令前面的提示指示使用哪个命令。例如,shell>表示从您的登录shell执行的命令,root-shell>类似但应该被执行root,并且mysql>指示您从mysql客户机程序执行的语句:
shell>type a shell command here
root-shell>
mysql>type a shell command as root here type a mysql statement here
在一些区域中,不同的系统可以彼此区分,以示出在两个不同的环境中执行命令。例如,在使用复制时,命令可能是前缀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,通常在控制台窗口中运行。
当您输入示例中显示的命令或语句时,请勿键入示例中显示的提示。
数据库,表和列名称必须经常被替换为语句。为了指示这样的取代是必要的,本手册使用db_name,tbl_name和col_name。例如,您可能会看到如下语句:
mysql> SELECT col_name FROM db_name.tbl_name;
这意味着如果要输入类似的语句,则可以提供自己的数据库,表和列名称,也许是这样的:
mysql> SELECT author_name FROM biblio_db.author_list;
SQL关键字不区分大小写,可能会写入任何字母。本手册使用大写字母。
在语法描述中,方括号(“[”和“]”)表示可选词或子句。例如,在以下语句中,IF EXISTS是可选的:
DROP TABLE [IF EXISTS] tbl_name
当语法元素由多个替代方法组成时,替代方法由垂直条(“|”)分隔。当从一组的一个选择部件可以被选择,则将替换方括号内所列的(“[”和“]”):
TRIM([[BOTH | LEADING | TRAILING] [ remstr] FROM] str)
当从一组的一个选择构件必须被选择,则将替换列在大括号(“{”和“}”):
{DESCRIBE | DESC} tbl_name[ col_name| wild]
省略号(...)表示省略了一段语句,通常提供较复杂语法的较短版本。例如,SELECT ... INTO OUTFILE语句形式的SELECT缩写是在INTO OUTFILE语句的其他部分之后有一个子句。
省略号还可以指示可以重复语句的前面的语法元素。在下面的示例中,reset_option可以给出多个值,其中每个值先在前面加逗号:
RESET reset_option[,reset_option] ...
使用Bourne shell语法显示用于设置shell变量的命令。例如,设置CC环境变量并运行configure命令的顺序如下所示:Bourne shell语法:
shell> CC=gcc ./configure
如果您使用csh或tcsh,则必须以不同的方式发出命令:
shell> setenv CC gcc
shell> ./configure