MySQL 8.4 Reference Manual  /  General Information  /  About This Manual

1.1 关于本手册

这是 MySQL 数据库系统参考手册,版本 8.4,直到发布 8.4.0。MySQL 8.4 的不同小版本之间的差异在文本中以 release 号 (8.4.x) 作为参考。关于许可信息,请参阅法律通知

本手册不适用于使用 MySQL 8.4 之前的版本,因为 MySQL 8.4 和之前版本之间有许多功能和其他差异。如果您正在使用 MySQL 软件的更早版本,请参阅相应的手册。例如,MySQL 8.0 参考手册涵盖了 MySQL 软件的 8.0 bugfix 系列发布版本。

由于本手册作为参考,故不提供 SQL 或关系数据库概念的基本指导,也不教您如何使用操作系统或命令行解释器。

MySQL 数据库软件正在不断开发,本手册也将频繁更新。最新版本的手册可以在线搜索形式获得在https://dev.mysql.com/doc/。其他格式也可从那里下载,包括可下载的 HTML 和 PDF 版本。

MySQL 自身源代码中包含使用 Doxygen 编写的内部文档。生成的 Doxygen 内容可以从 https://dev.mysql.com/doc/index-other.html 获得。也可以使用 MySQL 源代码分发中的 instructions 在本地生成该内容,详见 第 2.8.10 节,“Generating MySQL Doxygen Documentation Content”

如果您对使用 MySQL 有疑问,请加入 MySQL Community Slack。如果您有关于本手册的添加或修改建议,请将其发送到 http://www.mysql.com/company/contact/

本手册使用以下标记符号:

  • 在这个样式中显示的文本 用于 SQL 语句、数据库、表和列名、程序清单和源代码、环境变量。例如:“使用 FLUSH PRIVILEGES 语句重新加载授权表。

  • 在这个样式中显示的文本 表示输入的示例。

  • 命令行程序或脚本的名称表示可执行程序和脚本的名称,例如mysql(MySQL 命令行客户端程序)和mysqld(MySQL 服务器可执行文件)

  • 需要用户输入的变量用于表示需要用户自行选择的值。

  • 强调文本用于强调文本。

  • 标题或强调文本用于表格标题和强调文本。

  • 程序选项用于表示影响程序执行方式的程序选项或提供必要信息以便程序在特定方式下运行。例如:使用 --host 选项(简写为 -h)可以告诉 mysql 客户端程序连接到 MySQL 服务器的主机名或 IP 地址”

  • 文件名称和目录名称写作如下:全局 my. cnf 文件位于 /etc 目录中”

  • 字符序列写作如下:要指定通配符,请使用%"字符。

当命令或语句以提示符开头,我们使用这些:

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

命令在您的命令解释器中发布。Unix 上通常是程序,如shcshbash。Windows 上的等价程序是command.comcmd.exe,通常在控制台窗口中运行。以mysql开头的语句在mysql命令行客户端中发布。

Note

当您输入示例中的命令或语句时,不要输入示例中的提示符。

在某些地区,可能会使用不同的系统来区分彼此,以显示应该在两个不同环境中执行命令。例如,在工作 replication 时,命令可能以sourcereplica开头:

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

数据库、表和列名必须经常被替换到语句中。为了表示需要这样替换,这个手册使用db_nametbl_namecol_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 是对具有 INTO OUTFILE 子句的更复杂语句的简写形式。

省略号也可以表示语句中的前一个语法元素可能被重复。以下示例中,多个reset_option值可以给出,每个后续的都以逗号开头:

RESET reset_option [,reset_option] ...

设置 shell 变量的命令使用 Bourne shell 语法。例如,在 Bourne shell 语法中,设置CC环境变量并运行configure命令的序列如下:

$> CC=gcc ./configure

如果您使用cshtcsh,则必须以不同方式发出命令:

$> setenv CC gcc
$> ./configure

参考手册源文件使用 DocBook XML 格式编写。HTML 版本和其他格式主要使用 DocBook XSL 样式表生成。关于 DocBook 的信息,请参阅http://docbook.org/

这个手册最初由 David Axmark 和 Michael “Monty” Widenius 编写。它由 MySQL 文档团队维护,该团队包括 Edward Gilmore、Stefan Hinz、David Hollis、Philip Olson、Daniel So 和 Jon Stephens。