## 1.1 关于本手册

[](<>)[](<>)

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

由于 MySQL 8.0 和以前版本之间的许多功能和其他差异，本手册不适用于旧版本的 MySQL 软件。如果您使用的是早期版本的 MySQL 软件，请参阅相应的手册。例如，[*MySQL 5.7 参考手册*](https://dev.mysql.com/doc/refman/5.7/en/)涵盖 5.7 系列 MySQL 软件版本。

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

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

[](<>)

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

如果您对使用 MySQL 有任何疑问，请加入[MySQL 社区松弛](https://mysqlcommunity.slack.com/)，或在我们的论坛中提问；看[MySQL 论坛上的 MySQL 社区支持](information-sources.html#forums).如果您对手册本身的补充或更正有任何建议，请发送至<http://www.mysql.com/company/contact/>.

### 印刷和语法约定

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

[](<>)[](<>)[](<>)[](<>)[](<>)[](<>)

-   `这种风格的文字`用于 SQL 语句；数据库、表和列名；程序清单和源代码；和环境变量。示例：“要重新加载授权表，请使用[`刷新特权`](flush.html#flush-privileges)陈述。”

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

-   **这种风格的文字**表示可执行程序和脚本的名称，示例为[**mysql**](mysql.html)（MySQL 命令行客户端程序）和[**mysqld**](mysqld.html)（MySQL 服务器可执行文件）。

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

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

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

-   `这种风格的文字`用于指示影响程序执行方式的程序选项，或提供程序以某种方式运行所需的信息。*例子*： “这`- 主持人`选项（缩写形式`-h`) 告诉[**mysql**](mysql.html)客户端程序它应该连接到的 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**](mysql.html)命令行客户端。

笔记

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

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

```
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]
```

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

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

```
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/>

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