# 1.1 关于本手册

这是 MySQL 数据库系统 8.0 版至 8.0.28 版的参考手册。MySQL 8.0 的次要版本之间的差异在本文中提到了版本号 (8.0.x)。有关许可证信息,请参阅法律声明.

由于 MySQL 8.0 和以前版本之间的许多功能和其他差异,本手册不适用于旧版本的 MySQL 软件。如果您使用的是早期版本的 MySQL 软件,请参阅相应的手册。例如,MySQL 5.7 参考手册 (opens new window)涵盖 5.7 系列 MySQL 软件版本。

由于本手册仅供参考,因此不提供有关 SQL 或关系数据库概念的一般说明。它也没有教你如何使用你的操作系统或命令行解释器。

MySQL 数据库软件正在不断开发中,参考手册也经常更新。该手册的最新版本以可搜索形式在线提供,网址为https://dev.mysql.com/doc/ (opens new window).那里还提供其他格式,包括可下载的 HTML 和 PDF 版本。

MySQL 本身的源代码包含使用 Doxygen 编写的内部文档。生成的 Doxygen 内容可用https://dev.mysql.com/doc/index-other.html (opens new window).也可以使用以下说明从 MySQL 源分发本地生成此内容第 2.9.10 节,“生成 MySQL Doxygen 文档内容”.

如果您对使用 MySQL 有任何疑问,请加入MySQL 社区松弛 (opens new window),或在我们的论坛中提问;看MySQL 论坛上的 MySQL 社区支持.如果您对手册本身的补充或更正有任何建议,请发送至http://www.mysql.com/company/contact/ (opens new window).

# 印刷和语法约定

本手册使用某些印刷约定:

  • 这种风格的文字用于 SQL 语句;数据库、表和列名;程序清单和源代码;和环境变量。示例:“要重新加载授权表,请使用刷新特权陈述。”

  • **这种风格的文字**表示您在示例中键入的输入。

  • 这种风格的文字表示可执行程序和脚本的名称,示例为mysql(MySQL 命令行客户端程序)和mysqld(MySQL 服务器可执行文件)。

  • *这种风格的文字*用于变量输入,您应该用自己选择的值替换它。

  • 这种风格的文字用于强调。

  • 这种风格的文字用于表格标题并表达特别强烈的强调。

  • 这种风格的文字用于指示影响程序执行方式的程序选项,或提供程序以某种方式运行所需的信息。例子: “这- 主持人选项(缩写形式-h) 告诉mysql客户端程序它应该连接到的 MySQL 服务器的主机名或 IP 地址”。

  • 文件名和目录名是这样写的:“全局我的.cnf文件位于/等等目录。”

  • 字符序列是这样写的:“要指定通配符,请使用‘%' 特点。”

    当命令或语句以提示符为前缀时,我们使用这些:

$> type a command here
#> type a command as root here
C:\> type a command here (Windows only)
mysql> type a mysql statement here

命令在您的命令解释器中发出。在 Unix 上,这通常是一个程序,例如,csh, 要么重击.在 Windows 上,等效程序是命令网要么命令文件,通常在控制台窗口中运行。前缀为的语句mysql发行于mysql命令行客户端。

笔记

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

在某些领域,不同的系统可能会相互区分,以表明命令应该在两个不同的环境中执行。例如,在使用复制时,命令可能带有前缀资源复制品

source> type a mysql statement on the replication source here
replica> type a mysql statement on the replica here

数据库、表和列名通常必须替换为语句。为了表明这种替换是必要的,本手册使用*数据库名称,tbl_name, 和col_name*.例如,您可能会看到这样的语句:

mysql> SELECT col_name FROM db_name.tbl_name;

这意味着如果您要输入类似的语句,您将提供自己的数据库、表和列名,可能像这样:

mysql> SELECT author_name FROM biblio_db.author_list;

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

在语法描述中,方括号(“[“ 和 ”]”) 表示可选的词或从句。例如,在以下语句中,如果存在是可选的:

DROP TABLE [IF EXISTS] tbl_name

当一个句法元素由多个备选方案组成时,备选方案由竖线分隔(“|”)。当一组选择中的一个成员可能被选中时,备选方案列在方括号内(“[“ 和 ”]”):

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

当一组选择中的一个成员必须被选中,替代项列在大括号内(“{“ 和 ”}”):

{DESCRIBE | DESC} tbl_name [col_name | wild]

省略号 (...) 表示省略了语句的一部分,通常是为了提供更复杂语法的更短版本。例如,选择...进入文件是形式的简写选择有一个声明进入档案语句其他部分之后的子句。

省略号还可以指示语句的前面的语法元素可以重复。在以下示例中,多个*重置选项*可以给出值,第一个值之后的每个值都以逗号开头:

RESET reset_option [,reset_option] ...

用于设置 shell 变量的命令使用 Bourne shell 语法显示。例如,设置顺序抄送环境变量并运行配置命令在 Bourne shell 语法中如下所示:

$> CC=gcc ./configure

如果您正在使用csh要么tcsh,您必须以不同的方式发出命令:

$> setenv CC gcc
$> ./configure

# 手动署名

参考手册源文件以 DocBook XML 格式编写。HTML 版本和其他格式是自动生成的,主要使用 DocBook XSL 样式表。有关 DocBook 的信息,请参阅http://docbook.org/ (opens new window)

本手册最初由 David Axmark 和 Michael “Monty” Widenius 编写。它由 MySQL 文档团队维护,该团队由 Chris Cole、Margaret Fisher、Edward Gilmore、Stefan Hinz、Philip Olson、Daniel Price、Daniel So 和 Jon Stephens 组成。