這是 MySQL 資料庫系統 9.0 版,直到 9.0.0 版本的參考手冊。MySQL 9.0 的次要版本之間的差異在本文件中會參考版本號 (9.0.x
) 進行說明。有關授權資訊,請參閱法律聲明。
由於 MySQL 9.0 和先前版本之間在功能和其他方面存在許多差異,因此本手冊不適用於較舊版本的 MySQL 軟體。如果您使用的是較早版本的 MySQL 軟體,請參閱適當的手冊。例如,MySQL 8.0 參考手冊涵蓋 MySQL 軟體版本的 8.0 修補程式系列。
由於本手冊作為參考,因此不提供有關 SQL 或關聯式資料庫概念的一般說明。它也不會教您如何使用您的作業系統或命令列解譯器。
MySQL 資料庫軟體處於持續開發中,參考手冊也會經常更新。最新版本的手冊可以透過 https://mysqldev.dev.org.tw/doc/ 在線上搜尋。其他格式也在此提供,包括可下載的 HTML 和 PDF 版本。
MySQL 本身的原始碼包含使用 Doxygen 撰寫的內部文件。產生的 Doxygen 內容可從 https://mysqldev.dev.org.tw/doc/index-other.html 取得。也可以使用 第 2.8.10 節,「產生 MySQL Doxygen 文件內容」 中的說明,從 MySQL 原始碼發行版本在本機產生此內容。
如果您對使用 MySQL 有疑問,請加入 MySQL 社群 Slack。如果您對手冊本身的補充或更正有任何建議,請將其傳送至 https://mysql.dev.org.tw/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 上,這通常是諸如 sh、csh 或 bash 之類的程式。在 Windows 上,對應的程式是 command.com 或 cmd.exe,通常在主控台視窗中執行。以 mysql
為首的陳述式會在 mysql 命令列用戶端中發出。
當您輸入範例中顯示的命令或陳述式時,請勿輸入範例中顯示的提示字元。
在某些區域,不同的系統可能會彼此區分,以顯示命令應在兩個不同的環境中執行。例如,在使用複寫時,命令可能會以 source
和 replica
為首
source> type a mysql statement on the replication source here
replica> type a mysql statement on the replica here
資料庫、表格和欄位名稱通常必須取代到陳述式中。為了表示必須進行這種取代,本手冊會使用 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] ...
設定 shell 變數的指令會使用 Bourne shell 語法顯示。例如,設定 CC
環境變數並執行 configure 指令的順序在 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 文件團隊維護,成員包括 Edward Gilmore、Stefan Hinz、David Hollis、Philip Olson、Daniel So 和 Jon Stephens。