?
このドキュメントでは、 php中國語ネットマニュアル リリース
目錄
- 4.1. MySQL程序概述
- 4.2. 調用MySQL程序
- 4.3. 指定程序選項
- 4.3.1. 在命令行上使用選項
- 4.3.2. 使用選項文件
- 4.3.3. 用環(huán)境變量指定選項
- 4.3.4. 使用選項設置程序變量
本章簡要概述了MySQL AB提供的命令行程序，并討論了運行這些程序時如何指定選項。大多數(shù)程序具有其操作專用的選項，但指定選項的語法都近似。后面的幾章更加詳細地描述了各個程序，包括它們識別的選項。
MySQL AB還提供了3個GUI客戶程序供MySQL服務器使用：
·???????? MySQL管理器 ：該工具用于管理MySQL服務器、數(shù)據(jù)庫、表以及用戶。
·???????? MySQL查詢?yōu)g覽器 ：該圖形工具由MySQL AB提供，用于創(chuàng)建、執(zhí)行以及優(yōu)化對MySQL數(shù)據(jù)庫的查詢。
·???????? MySQL移植工具包 ：該工具可以幫助你將計劃和數(shù)據(jù)從其它關系數(shù)據(jù)庫管理系統(tǒng)移植到MySQL。
MySQL AB提供了幾種類型的程序：
·???????? MYSQL服務器和服務器啟動腳本：
o??????? mysqld是MySQL服務器
o??????? mysqld_safe、mysql.server和mysqld_multi是服務器啟動腳本
o??????? mysql_install_db初始化數(shù)據(jù)目錄和初始數(shù)據(jù)庫
在第5章：數(shù)據(jù)庫管理中詳細討論了這些程序。
·???????? 訪問服務器的客戶程序：
o??????? mysql是一個命令行客戶程序，用于交互式或以批處理模式執(zhí)行SQL語句。
o??????? mysqladmin是用于管理功能的客戶程序。
o??????? mysqlcheck執(zhí)行表維護操作。
o??????? mysqldump和mysqlhotcopy負責數(shù)據(jù)庫備份。
o??????? mysqlimport導入數(shù)據(jù)文件。?
o??????? mysqlshow顯示信息數(shù)據(jù)庫和表的相關信息。
在第8章：客戶端和實用工具程序 中詳細討論了這些程序。
·???????? 獨立于服務器操作的工具程序：
o??????? myisamchk執(zhí)行表維護操作。
o??????? myisampack產生壓縮、只讀的表。
o??????? mysqlbinlog是處理二進制日志文件的實用工具。
o??????? perror顯示錯誤代碼的含義。
在第5章：數(shù)據(jù)庫管理中詳細討論了myisamchk。在第8章：客戶端和實用工具程序 中詳細討論了其它程序。
大多數(shù)MySQL分發(fā)包括上述的全部程序，只是不包含那些與平臺相關的程序。(例如，在Windows中不使用服務器啟動腳本）。不同的只是RPM分發(fā)更加具體化?？赡芤粋€RPM是服務器分發(fā)，另一個RPM是客戶程序分發(fā)等等。如果你丟失了一個或多個程序，要想查閱關于分發(fā)類型和它們所包含內容的信息，參見第2章：安裝MySQL。也可能需要安裝一些其它內容。
要想從命令行調用MySQL程序(即從shell或命令提示)，應輸入程序名，并隨后輸入指導操作發(fā)的選項或其它參量。下面的命令顯示了一些程序調用的例子。“shell>”表示命令解釋符提示；并不是輸入的部分。你所看見的具體提示取決于命令解釋符。典型提示符：sh或bash為$，csh或tcsh為%，Windows command.com或cmd.exe為C:\>。
shell> mysql test
shell> mysqladmin extended-status variables
shell> mysqlshow --help
shell> mysqldump --user=root personnel
以破折號開始的參數(shù)為選項參量。它們通常指定程序與服務器的連接類型或影響其操作模式。關于選項語法的描述參見4.3節(jié)，“指定程序選項”。
非選項參數(shù)(不以破折號開始的參量)可以為程序提供更詳細的信息。例如，mysql程序將第一個非選項參量解釋為數(shù)據(jù)庫名，因此命令 mysql test表示你想要使用test數(shù)據(jù)庫。
后面的章節(jié)描述了具體的程序，表示程序可以理解的選項，并描述了其它非選項參量的含義。
部分選項對部分程序是通用的。最常用的是指定連接參數(shù)的--host、--user和--password選項。它們指示MySQL服務器運行的主機和MySQL賬戶的用戶名和 密碼。所有MySQL客戶程序可以理解這些選項；它們允許你指定連接哪個服務器，以及在該服務器上使用的 賬戶。
你也許會發(fā)現(xiàn)需要使用MySQL程序安裝的bin目錄的路徑名來調用MySQL程序。如果你試圖不在bin目錄下運行MySQL程序，可能會遇到“程序未找到”錯誤。為了更方便地使用MySQL，可以將bin目錄的路徑名添加到PATH環(huán)境變量中。然后運行程序時只需要輸入程序名，而不需要輸入整個路徑名。
關于設置PATH的指令的命令解釋符請查閱相關文檔。設置環(huán)境變量的語法與解釋符有關。
- 4.3.1. 在命令行上使用選項
- 4.3.2. 使用選項文件
- 4.3.3. 用環(huán)境變量指定選項
- 4.3.4. 使用選項設置程序變量
可以用幾種方式提供MySQL程序的選項：
·???????? 在命令行中在程序名后面提供。這對于具體程序調用時使用的選項很普遍。
·???????? 在程序啟動時讀取的選項文件中設置。這對于每次程序運行時使用的選項很普遍。
·???????? 在環(huán)境變量中設置。這對每次程序運行時所使用的選項很有用，盡管實際上最常用選項文件。(5.12.2節(jié)，“在Unix中運行多個服務器”中討論了環(huán)境變量會很有幫助的一種情況。描述了使用這些變量來指定服務器和客戶程序的TCP/IP端口號和Unix套接字文件的各種技術）。
MySQL程序首先檢查環(huán)境變量，然后檢查選項文件，然后檢查命令行來確定給出了哪些選項。如果多次指定一個選項，最后出現(xiàn)的選項占先。這說明環(huán)境變量具有最低的優(yōu)先級，命令行選項具有最高優(yōu)先級。
可以在選項文件中指定程序選項的默認值來讓MySQL程序處理各選項。不需要在每次運行程序時輸入選項，但可以根據(jù)需要通過命令行選項來覆蓋默認值。
在命令行中指定的程序選項遵從下述規(guī)則：
·???????? 在命令名后面緊跟選項。
·???????? 選項參量以一個和兩個破折號開始，取決于它具有短名還是長名。許多選項有兩種形式。例如，-?和--help是指導MySQL程序顯示幫助消息的選項的短名和長名。
·???????? 選項名對大小寫敏感。-v和-V均有效，但具有不同的含義。(它們是--verbose和--version選項的短名）。
·???????? 部分選項在選項名后面緊隨選項值。例如，-h localhost或--host=localhost表示客戶程序的MySQL服務器主機。選項值可以告訴程序MySQL服務器運行的主機名。
·???????? 對于帶選項值的長選項，通過一個‘=’將選項名和值隔離開來。對于帶選項值的短選項，選項值可以緊隨選項字母后面，或者二者之間可以用一個空格隔開。(-hlocalhost和-h localhost是等效的）。該規(guī)則的例外情況是指定MySQL密碼的選項。該選項的形式可以為--password=pass_val或--password。在后一種情況(未給出 密碼值)，程序將提示輸入密碼。也可以給出密碼選項，短形式為-ppass_val或-p。然而，對于短形式，如果給出了 密碼值，必須緊跟在選項后面，中間不能插入空格。這樣要求的原因是如果選項后面有空格，程序沒有辦法來告知后面的參量是 密碼值還是其它某種參量。因此，下面兩個命令的含義完全不同：
·??????????????? shell> mysql -ptest
·??????????????? shell> mysql -p test
第一個命令讓mysql使用密碼test，但沒有指定默認數(shù)據(jù)庫。第二個命令讓mysql提示輸入 密碼并使用test作為默認數(shù)據(jù)庫。
部分選項控制可以開關的行為。例如，mysql客戶端支持--column-names選項，確定是否在查詢結果開頭顯示一行欄目名。默認情況，該選項被啟用。但是可能在某些情況下你想要禁用它，例如將mysql的輸出發(fā)送到另一個只希望看到數(shù)據(jù)而不希望看到開始的標題行的程序中。
要想禁用列名，可以使用下面的形式來指定選項：
--disable-column-names
--skip-column-names
--column-names=0
--disable和--skip前綴與=0后綴的效果相同：它們均關閉選項。
可以用下述方法“啟用”選項：
--column-names
--enable-column-names
--column-names=1
如果選項有前綴--loose，如果程序未識別出選項不會提示錯誤退出，但是會發(fā)出一條警告：
shell> mysql --loose-no-such-option
mysql: WARNING: unknown option '--no-such-option'
當你從安裝了多個MySQL的同一臺機器上運行程序時，--loose前綴會很有用。當你在一個選項文件中列出選項時，該前綴會特別有用。有可能不能被程序的所有版本識別的選項可以冠以--loose前綴(或在選項文件中用loose)。不能識別選項的程序版本將會發(fā)出一條警告并忽視該選項。
對mysql偶爾有用的另一個選項是-e或--execute選項，可用來將SQL語句傳遞給服務器。該語句必須用引號引起來(單引號或雙引號)。(然而，如果想要在查詢中將值引起來，則對于查詢應使用雙引號，查詢中引用的值應使用單引號）。當使用該選項時，語句被執(zhí)行，然后mysql立即退出命令外殼。
例如，你可以用下面的命令獲得用戶賬戶列表：
shell> mysql -u root -p -e "SELECT User, Host FROM User" mysql
Enter password: ******
+------+-----------+
| User | Host????? |
+------+-----------+
|? ????| gigan???? |
| root | gigan???? |
|????? | localhost |
| jon? | localhost |
| root | localhost |
+------+-----------+
shell>
請注意mysql數(shù)據(jù)庫名作為一個獨立的參量傳遞。然而，相同的查詢可能已經使用mysql -u root -p -e "SELECT User，Host FROM mysql.User"從外殼中執(zhí)行。
可以按這種方式傳遞多個SQL語句，用分號隔開：
shell> mysql -u root -p --execute="SELECT Name FROM Country WHERE Name LIKE 'AU%';SELECT COUNT(*) FROM City" world
Enter password: ******
+-----------+
| Name????? |
+-----------+
| Australia |
| Austria?? |
+-----------+
+----------+
| COUNT(*) |
+----------+
|???? 4079 |
+----------+
請注意長形式(--execute)后面必須緊跟一個等號(=)。
-e選項也可以以類似方式用來將命令傳遞給MySQL簇的ndb_mgm管理客戶端。相關例子參見17.3.6節(jié)，“安全關閉和重啟”。
MySQL程序可以從選項文件(有時也稱為配置文件)讀取啟動選項。選項文件提供了一種很方便的方式來指定常用的選項，因此不需要每次運行程序時從命令行輸入。
下面的程序支持選項文件：myisamchk、myisampack、mysql、mysql.server、mysqladmin、mysqlbinlog、mysqlcc、mysqlcheck、mysqld_safe、mysqldump、mysqld、mysqlhotcopy、mysqlimport和mysqlshow。
注釋：MySQL簇程序使用的選項文件參見17.4節(jié)，“MySQL簇的配置”。
在Windows中，MySQL程序從以下文件讀取啟動選項：
|
文件名 |
目的 |
|
WINDIR\my.ini |
全局選項 |
|
C:\my.cnf |
全局選項 |
|
INSTALLDIR\my.ini |
全局選項 |
|
defaults-extra-file |
用--defaults-extra-file=path指定的文件，如果有 |
WINDIR表示Windows目錄的位置。通常為C:\WINDOWS或C:\WINNT。你可以使用下面的命令通過環(huán)境變量WINDIR的值確定其確切位置：
C:\> echo %WINDIR%
INSTALLDIR表示MySQL的安裝目錄。一般為C:\PROGRAMDIR\MySQL\MySQL 5.1 Server，其中PROGRAMDIR表示程序目錄(通常為Windows英文版的Program Files)，MySQL 5.1的安裝是根據(jù)安裝和配置向導完成的。參見2.3.5.14節(jié)，“my.ini文件的位置”。
在Unix中，MySQL程序從下面的文件讀取啟動選項：
|
文件名 |
目的 |
|
/etc/my.cnf |
全局選項 |
|
$MYSQL_HOME/my.cnf |
服務器相關選項 |
|
defaults-extra-file |
用--defaults-extra-file=path指定的文件，如果有 |
|
~/.my.cnf |
用戶相關選項 |
MYSQL_HOME是一個環(huán)境變量，包含服務器相關的my.cnf文件駐留的目錄路徑。
如果未設置MYSQL_HOME，并且DATADIR中有一個my.cnf文件，BASEDIR中沒有my.cnf文件，mysqld_safe將MYSQL_HOME設置為DATADIR。否則，如果未設置MYSQL_HOME并且在DATADIR中沒有my.cnf，則mysqld_safe將MYSQL_HOME設置為BASEDIR。
典型情況二進制安裝的目錄為/usr/local/mysql/data或源代碼安裝的目錄為/usr/local/var。請注意這是配置時指定的數(shù)據(jù)目錄的位置，而不是 mysqld啟動時用--datadir指定的。運行時使用--datadir對尋找選項文件的服務器沒有效果，因為服務器在處理命令行參量之前尋找這些選項。
MySQL按照上述順序尋找選項文件，并讀存在的選項文件。如果你想要使用的某個選項文件不存在，則用明文文本編輯器創(chuàng)建。如果存在多個選項文件，文件中指定的后讀取的選項要優(yōu)先文件中指定的先讀取的選項。
注釋：在Unix平臺上，MySQL忽略人人可寫的配置文件。這是故意的，是一個安全措施。
任何可以在運行MySQL程序時在命令行給出的長選項也可以在選項文件中給出。要想列出程序的適用選項，用--help選項運行程序。
在選項文件中指定選項的語法類似于命令行語法，例外的是要忽略掉兩個破折號。例如，命令行中的--quick或--host=localhost在選項文件中應指定為quick或host=localhost。要想在選項文件中指定--loose-opt_name形式的選項，應寫為loose-opt_name。
選項文件中的空行被忽略掉。非空行可以采用下面任何形式：
·???????? #注釋，；注釋
注釋行以‘#’或‘；’開頭?！?span>#’注釋也可以從行的中部開始。
·???????? [group]
group是你想要設置選項的程序名或組名。在組行后面，任何opt_name或set-variable行適用于組名，直到選項文件結尾或給出其它組行。
·???????? opt_name
等價于命令行中的--opt_name。
·???????? opt_name=value
等價于命令行中的--opt_name=value。在選項文件中，‘=’字符附近可以有空格，而在命令行中是不允許的。你可以用單引號或雙引號來引用值。如果值包含一個‘#’注釋字符或空格時很有用。
選項名和值前后的空白將自動刪除掉。你可以在選項值中使用轉義序列‘\b’、‘\t’、‘\n’、‘\r’、‘\\’以及‘\s’來表示退格、tab、換行符、回車以及空格字符。
在Windows中，如果某個選項值表示一個路徑名，應使用‘/’而不是‘\’作為路徑名間隔符來指定值。如果使用‘\’，必須用雙斜線‘\\’，因為‘\’在MySQL中為轉義字符。
如果選項組名與程序名相同，則組內的選項專用于該程序。
所有客戶程序(但不能被mysqld)讀取[client]選項組。這樣允許你指定適用于所有客戶端的選項。例如，[client]是用于指定連接服務器的 密碼的理想的組。(但應確保該選項文件只能由你自己讀寫，以便其他人不能發(fā)現(xiàn)你的密碼）。一定不要隨意在[client]組內放置選項，除非它可以被你使用的所有客戶程序識別。如果你試圖運行程序，如果程序不理解選項則會顯示一條錯誤消息后退出。
從5.0系列的MySQL 5.0.4開始，可以在選項文件中使用!include指令來包括具體文件和!includedir來搜索選項文件的具體目錄。例如，要包括文件/home/mydir/myopt.cnf，可以使用：
!include /home/me/myopt.cnf
要搜索所有以.cnf結尾的文件的目錄/home/mydir并作為選項文件讀取，應使用：
!includedir /home/mydir
請注意這些選項與節(jié)有關。例如，假定你想要使用my.cnf中的某些內容，如下所示：
[mysqld]
!include /home/mydir/myopt.cnf
在這種情況下，只為該服務器處理文件myopt.cnf，并且!include指令將被客戶應用程序忽略。然而，如果你使用下面的部分：
[mysqldump]
!includedir /home/mydir/my-dump-option
則只有mysqldump為以.cnf結尾的文件檢查目錄/home/mydir/my-dump-option，服務器或其它客戶應用程序均不檢查。
注釋：目前，在Unix操作系統(tǒng)中，所發(fā)現(xiàn)的使用!includedir指令包括的文件的文件名必須以.cnf為擴展名。在Windows中，該指令也為有.ini擴展名(包括.cnf)的文件做檢查。
如果你想要創(chuàng)建只由一個具體mysqld服務器發(fā)布系列讀取的選項組，選項組可以用[mysqld-5.0]、[mysqld-5.1]等名稱。下面的組表示--new選項只能用于5.1.x 版本的MySQL服務器：
[mysqld-5.1]
new
下面是一個典型的全局選項文件：
[client]
port=3306
socket=/tmp/mysql.sock
?
[mysqld]
port=3306
socket=/tmp/mysql.sock
key_buffer_size=16M
max_allowed_packet=8M
?
[mysqldump]
quick
在上述的選項文件中，設置key_buffer_size和max_allowed_packet變量的行使用了var_name=value語法。
下面是一個典型的用戶選項文件：
[client]
# The following password will be sent to all standard MySQL clients
password="my_password"
?
[mysql]
no-auto-rehash
connect_timeout=2
?
[mysqlhotcopy]
interactive-timeout
?
如果你有一個源代碼分發(fā)，可以從support-file目錄中找到名為my-xxxx.cnf的示例選項文件。如果你有一個二進制分發(fā)，在MySQL安裝目錄的support-file目錄中查找。在Windows中，示例選項文件也可以位于MySQL的安裝目錄(如果你不知道在哪里，查閱本節(jié)前面或第2章：安裝MySQL)。目前有小、中等、大以及非常大的系統(tǒng)的示例選項文件。要想練習這些文件，在Windows中復制到C:\my.cnf或在Unix中復制到根目錄的.my.cnf。
注釋：在Windows中，可以不顯示.cnf選項文件的擴展名。
所有支持選項文件的MySQL程序可以處理下面的命令行選項：
·???????? --no-defaults
不讀取任何選項文件。
·???????? --print-defaults
打印從選項文件中獲得的程序名和所有選項。
·???????? --defaults-file=path_name
只使用給出的選項文件。path_name是文件的全路徑名。
·???????? --defaults-extra-file=path_name
在全局選項文件后但在用戶選項文件前讀該選項文件。path_name是文件的全路徑名。
為了正確工作，每個選項必須緊隨命令行中的命令名后，例外情況是--print-defaults可以緊隨--defaults-file或--defaults-extra-file。
在shell腳本中，可以使用my_print_defaults程序來分析選項文件。下面的例子顯示了當要求顯示[client]和[mysql]組內發(fā)現(xiàn)的選項時my_print_defaults產生的輸出：
shell> my_print_defaults client mysql
--port=3306
--socket=/tmp/mysql.sock
--no-auto-rehash
開發(fā)人員請注意：在C客戶程序庫中，只是通過處理命令行參量前面的所有匹配選項(即相應組內的選項)來處理選項文件。對于使用多次指定的最后的選項實例的程序，可以很好地工作。如果你有一個C或C++程序按這種方式處理多次指定的選項，但不讀取選項文件，只需要添加兩行來實現(xiàn)該功能。檢查標準MySQL客戶程序的源代碼來看看如何做。
其它幾個MySQL語言接口基于C客戶庫，它們中的一部分提供了訪問選項文件的一種方式。包括Perl和Python。關于接口的詳細信息參見相關文檔。
要想用環(huán)境變量指定選項，使用適用注釋處理器的語法來設置變量。例如，在Windows或NetWare中，可以設置USER變量來指定MySQL賬戶名。要想實現(xiàn)，使用語法：
SET USER=your_name
在Unix中的語法取決于你的外殼。假定你想要使用MYSQL_TCP_PORT變量指定TCP/IP端口號。典型的語法為(例如sh、bash、zsh等等)：
MYSQL_TCP_PORT=3306
export MYSQL_TCP_PORT
第1個命令設置變量，export命令將變量導出到外殼環(huán)境，以便其值可供MySQL和其它進程訪問。
csh和tcsh有類似的問題。運行這些外殼時，使用setenv使外殼變量適用環(huán)境：
setenv MYSQL_TCP_PORT 3306
可以在命令提示符下執(zhí)行設置環(huán)境變量的命令，以便立即生效。這些設定值持續(xù)到你注銷。要向讓這些設定值在你每次登錄時生效，將相應命令放入每次啟動時命令解釋符所讀的啟動文件中。在Windows中典型啟動文件為AUTOEXEC.BAT，bash為.bash_profile，或者tcsh為.tcshrc。關于命令解釋符的具體細節(jié)請查閱文檔。
附錄F：環(huán)境變量 了列出影響MySQL程序操作的所有環(huán)境變量。
許多MySQL程序有一些內部變量可以在運行時設置。程序變量的設置與帶有值的其它長選項相同。例如，mysql有一個max_allowed_packet變量，可以控制其通信緩沖區(qū)的最大長度。要想為mysql將max_allowed_packet變量的值設置為16MB，使用下面的任何一個命令：
shell> mysql --max_allowed_packet=16777216
shell> mysql --max_allowed_packet=16M
第1個命令以字節(jié)指定值。第2個命令以兆字節(jié)指定值。變量值可以有一個后綴K、M或者G(可以為大寫或小寫)來表示千字節(jié)、兆字節(jié)或者十億字節(jié)的單位。
在選項文件中，變量設定值沒有引導破折號：
[mysql]
max_allowed_packet=16777216
或：
[mysql]
max_allowed_packet=16M
如果你喜歡，變量名的下劃線可以為破折號。
注釋：MySQL 5.1仍然能識別舊的語法--set-variable = option=value，但現(xiàn)在不贊成使用。
部分服務器變量可以在運行時設置。詳情參見5.3.3.1節(jié)，“動態(tài)系統(tǒng)變量”。
這是MySQL參考手冊的翻譯版本，關于MySQL參考手冊，請訪問dev.mysql.com.。原始參考手冊為英文版，與英文版參考手冊相比，本翻譯版可能不是最新的。