4. MySQL程序概述 · mysql5.1參考手冊

### 第4章：MySQL程序概述本章簡要概述了MySQL AB提供的命令行程序，并討論了運行這些程序時如何指定選項。大多數程序具有其操作專用的選項，但指定選項的語法都近似。后面的幾章更加詳細地描述了各個程序，包括它們識別的選項。 MySQL AB還提供了3個GUI客戶程序供MySQL服務器使用： ????????? [ MySQL管理器](http://dev.mysql.com/doc/administrator/en/)：該工具用于管理MySQL服務器、數據庫、表以及用戶。 ????????? [ MySQL查詢瀏覽器](http://dev.mysql.com/doc/query-browser/en/)：該圖形工具由MySQL AB提供，用于創建、執行以及優化對MySQL數據庫的查詢。 ????????? [ MySQL移植工具包](http://dev.mysql.com/doc/migration-toolkit/en/)：該工具可以幫助你將計劃和數據從其它關系數據庫管理系統移植到MySQL。 ### 4.1.?MySQL程序概述 MySQL AB提供了幾種類型的程序： ????????? MYSQL服務器和服務器啟動腳本： o??????? **mysqld**是MySQL服務器 o??????? ** mysqld_safe**、**mysql.server**和**mysqld_multi**是服務器啟動腳本 o??????? ** mysql_install_db**初始化數據目錄和初始數據庫在[第5章：](#)[_數據庫管理_](# "Chapter?5.?Database Administration")中詳細討論了這些程序。 ????????? 訪問服務器的客戶程序： o??????? **mysql**是一個命令行客戶程序，用于交互式或以批處理模式執行SQL語句。 o??????? **mysqladmin**是用于管理功能的客戶程序。 o??????? **mysqlcheck**執行表維護操作。 o??????? **mysqldump**和**mysqlhotcopy**負責數據庫備份。 o??????? ** mysqlimport**導入數據文件。? o??????? **mysqlshow**顯示信息數據庫和表的相關信息。在[第8章：_客戶端和實用工具程序_](# "Chapter?8.?Client and Utility Programs")中詳細討論了這些程序。 ????????? 獨立于服務器操作的工具程序： o??????? **myisamchk**執行表維護操作。 o??????? **myisampack**產生壓縮、只讀的表。 o??????? ** mysqlbinlog**是處理二進制日志文件的實用工具。 o??????? **perror**顯示錯誤代碼的含義。在[第5章：](#)[_數據庫管理_](# "Chapter?5.?Database Administration")中詳細討論了**myisamchk**。在[第8章：_客戶端和實用工具程序_](# "Chapter?8.?Client and Utility Programs")中詳細討論了其它程序。大多數MySQL分發包括上述的全部程序，只是不包含那些與平臺相關的程序。(例如，在Windows中不使用服務器啟動腳本）。不同的只是RPM分發更加具體化。可能一個RPM是服務器分發，另一個RPM是客戶程序分發等等。如果你丟失了一個或多個程序，要想查閱關于分發類型和它們所包含內容的信息，參見[第2章：安裝MySQL](# "Chapter?2.?Installing MySQL")。也可能需要安裝一些其它內容。 ### 4.2.?調用MySQL程序要想從命令行調用MySQL程序(即從shell或命令提示)，應輸入程序名，并隨后輸入指導操作發的選項或其它參量。下面的命令顯示了一些程序調用的例子。“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 以破折號開始的參數為選項參量。它們通常指定程序與服務器的連接類型或影響其操作模式。關于選項語法的描述參見[4.3節，“指定程序選項”](# "4.3.?Specifying Program Options")。非選項參數(不以破折號開始的參量)可以為程序提供更詳細的信息。例如，**mysql**程序將第一個非選項參量解釋為數據庫名，因此命令 mysql test表示你想要使用test數據庫。后面的章節描述了具體的程序，表示程序可以理解的選項，并描述了其它非選項參量的含義。部分選項對部分程序是通用的。最常用的是指定連接參數的--host、--user和--password選項。它們指示MySQL服務器運行的主機和MySQL賬戶的用戶名和密碼。所有MySQL客戶程序可以理解這些選項；它們允許你指定連接哪個服務器，以及在該服務器上使用的賬戶。你也許會發現需要使用MySQL程序安裝的bin目錄的路徑名來調用MySQL程序。如果你試圖不在bin目錄下運行MySQL程序，可能會遇到“程序未找到”錯誤。為了更方便地使用MySQL，可以將bin目錄的路徑名添加到PATH環境變量中。然后運行程序時只需要輸入程序名，而不需要輸入整個路徑名。關于設置PATH的指令的命令解釋符請查閱相關文檔。設置環境變量的語法與解釋符有關。 ### 4.3.?指定程序選項 [ 4.3.1. 在命令行上使用選項](#)[ 4.3.2. 使用選項文件](#)[ 4.3.3. 用環境變量指定選項](#)[ 4.3.4. 使用選項設置程序變量](#) 可以用幾種方式提供MySQL程序的選項： ????????? 在命令行中在程序名后面提供。這對于具體程序調用時使用的選項很普遍。 ????????? 在程序啟動時讀取的選項文件中設置。這對于每次程序運行時使用的選項很普遍。 ????????? 在環境變量中設置。這對每次程序運行時所使用的選項很有用，盡管實際上最常用選項文件。([5.12.2節，“在Unix中運行多個服務器”](# "5.12.2.?Running Multiple Servers on Unix")中討論了環境變量會很有幫助的一種情況。描述了使用這些變量來指定服務器和客戶程序的TCP/IP端口號和Unix套接字文件的各種技術）。 MySQL程序首先檢查環境變量，然后檢查選項文件，然后檢查命令行來確定給出了哪些選項。如果多次指定一個選項，最后出現的選項占先。這說明環境變量具有最低的優先級，命令行選項具有最高優先級。可以在選項文件中指定程序選項的默認值來讓MySQL程序處理各選項。不需要在每次運行程序時輸入選項，但可以根據需要通過命令行選項來覆蓋默認值。 ### 4.3.1.?在命令行上使用選項在命令行中指定的程序選項遵從下述規則： ????????? 在命令名后面緊跟選項。 ????????? 選項參量以一個和兩個破折號開始，取決于它具有短名還是長名。許多選項有兩種形式。例如，-?和--help是指導MySQL程序顯示幫助消息的選項的短名和長名。 ????????? 選項名對大小寫敏感。-v和-V均有效，但具有不同的含義。(它們是--verbose和--version選項的短名）。 ????????? 部分選項在選項名后面緊隨選項值。例如，-h localhost或--host=localhost表示客戶程序的MySQL服務器主機。選項值可以告訴程序MySQL服務器運行的主機名。 ????????? 對于帶選項值的長選項，通過一個‘=’將選項名和值隔離開來。對于帶選項值的短選項，選項值可以緊隨選項字母后面，或者二者之間可以用一個空格隔開。(-hlocalhost和-h localhost是等效的）。該規則的例外情況是指定MySQL密碼的選項。該選項的形式可以為--password=_pass_val_或--password。在后一種情況(未給出密碼值)，程序將提示輸入密碼。也可以給出密碼選項，短形式為-p_pass_val_或-p。然而，對于短形式，如果給出了密碼值，必須緊跟在選項后面，_中間不能插入空格_。這樣要求的原因是如果選項后面有空格，程序沒有辦法來告知后面的參量是密碼值還是其它某種參量。因此，下面兩個命令的含義完全不同： ???????????????? shell> mysql -ptest ???????????????? shell> mysql -p test 第一個命令讓**mysql**使用密碼test，但沒有指定默認數據庫。第二個命令讓**mysql**提示輸入密碼并使用test作為默認數據庫。部分選項控制可以開關的行為。例如，**mysql**客戶端支持--column-names選項，確定是否在查詢結果開頭顯示一行欄目名。默認情況，該選項被啟用。但是可能在某些情況下你想要禁用它，例如將**mysql**的輸出發送到另一個只希望看到數據而不希望看到開始的標題行的程序中。要想禁用列名，可以使用下面的形式來指定選項： --disable-column-names --skip-column-names --column-names=0 --disable和--skip前綴與=0后綴的效果相同：它們均關閉選項。可以用下述方法“啟用”選項： --column-names --enable-column-names --column-names=1 如果選項有前綴--loose，如果程序未識別出選項不會提示錯誤退出，但是會發出一條警告： shell> mysql --loose-no-such-option mysql: WARNING: unknown option '--no-such-option' 當你從安裝了多個MySQL的同一臺機器上運行程序時，--loose前綴會很有用。當你在一個選項文件中列出選項時，該前綴會特別有用。有可能不能被程序的所有版本識別的選項可以冠以--loose前綴(或在選項文件中用loose)。不能識別選項的程序版本將會發出一條警告并忽視該選項。對**mysql**偶爾有用的另一個選項是-e或--execute選項，可用來將SQL語句傳遞給服務器。該語句必須用引號引起來(單引號或雙引號)。(然而，如果想要在查詢中將值引起來，則對于查詢應使用雙引號，查詢中引用的值應使用單引號）。當使用該選項時，語句被執行，然后**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數據庫名作為一個獨立的參量傳遞。然而，相同的查詢可能已經使用**mysql -u root -p -e "SELECT User，Host FROM mysql.User"**從外殼中執行。可以按這種方式傳遞多個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節，“安全關閉和重啟”](# "17.3.6.?Safe Shutdown and Restart")。 ### 4.3.2.?使用選項文件 MySQL程序可以從選項文件(有時也稱為配置文件)讀取啟動選項。選項文件提供了一種很方便的方式來指定常用的選項，因此不需要每次運行程序時從命令行輸入。下面的程序支持選項文件：**myisamchk**、**myisampack**、**mysql**、**mysql.server**、**mysqladmin**、**mysqlbinlog**、**mysqlcc**、**mysqlcheck**、**mysqld_safe**、**mysqldump**、**mysqld**、**mysqlhotcopy**、**mysqlimport**和**mysqlshow**。 **注釋：**MySQL簇程序使用的選項文件參見[17.4節，“MySQL簇的配置”](# "17.4.?MySQL Cluster Configuration")。在Windows中，MySQL程序從以下文件讀取啟動選項： <table border="1" cellpadding="0" id="table1"><tr><td> 文件名</td> <td width="349"> 目的</td> </tr><tr><td> WINDIR\my.ini</td> <td width="349"> 全局選項</td> </tr><tr><td> C:\my.cnf</td> <td width="349"> 全局選項</td> </tr><tr><td> INSTALLDIR\my.ini</td> <td width="349"> 全局選項</td> </tr><tr><td> defaults-extra-file</td> <td width="349"> 用--defaults-extra-file=path指定的文件，如果有</td> </tr></table> _WINDIR_表示Windows目錄的位置。通常為C:\WINDOWS或C:\WINNT。你可以使用下面的命令通過環境變量WINDIR的值確定其確切位置： C:\> echo %WINDIR% _INSTALLDIR_表示MySQL的安裝目錄。一般為C:\_PROGRAMDIR_\MySQL\MySQL 5.1 Server，其中_PROGRAMDIR_表示程序目錄(通常為Windows英文版的Program Files)，MySQL 5.1的安裝是根據安裝和配置向導完成的。參見[2.3.5.14節，“my.ini文件的位置”](# "2.3.5.14.?The Location of the my.ini File")。在Unix中，MySQL程序從下面的文件讀取啟動選項： <table border="1" cellpadding="0" id="table2"><tr><td> 文件名</td> <td> 目的</td> </tr><tr><td> /etc/my.cnf</td> <td> 全局選項</td> </tr><tr><td> $MYSQL_HOME/my.cnf</td> <td> 服務器相關選項</td> </tr><tr><td> defaults-extra-file</td> <td> 用--defaults-extra-file=path指定的文件，如果有</td> </tr><tr><td> ~/.my.cnf</td> <td> 用戶相關選項</td> </tr></table> MYSQL_HOME是一個環境變量，包含服務器相關的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。請注意這是配置時指定的數據目錄的位置，而不是 **mysqld**啟動時用--datadir指定的。運行時使用--datadir對尋找選項文件的服務器沒有效果，因為服務器在處理命令行參量之前尋找這些選項。 MySQL按照上述順序尋找選項文件，并讀存在的選項文件。如果你想要使用的某個選項文件不存在，則用明文文本編輯器創建。如果存在多個選項文件，文件中指定的后讀取的選項要優先文件中指定的先讀取的選項。 **注釋：**在Unix平臺上，MySQL忽略人人可寫的配置文件。這是故意的，是一個安全措施。任何可以在運行MySQL程序時在命令行給出的長選項也可以在選項文件中給出。要想列出程序的適用選項，用--help選項運行程序。在選項文件中指定選項的語法類似于命令行語法，例外的是要忽略掉兩個破折號。例如，命令行中的--quick或--host=localhost在選項文件中應指定為quick或host=localhost。要想在選項文件中指定--loose-_opt_name_形式的選項，應寫為loose-_opt_name_。選項文件中的空行被忽略掉。非空行可以采用下面任何形式： ????????? #_注釋_，；_注釋_ 注釋行以‘#’或‘；’開頭。‘#’注釋也可以從行的中部開始。 ????????? [_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]是用于指定連接服務器的密碼的理想的組。(但應確保該選項文件只能由你自己讀寫，以便其他人不能發現你的密碼）。一定不要隨意在[client]組內放置選項，除非它可以被你使用的所有客戶程序識別。如果你試圖運行程序，如果程序不理解選項則會顯示一條錯誤消息后退出。從5.0系列的MySQL 5.0.4開始，可以在選項文件中使用!include指令來包括具體文件和!includedir來搜索選項文件的具體目錄。例如，要包括文件/home/mydir/myopt.cnf，可以使用： !include /home/me/myopt.cnf 要搜索所有以.cnf結尾的文件的目錄/home/mydir并作為選項文件讀取，應使用： !includedir /home/mydir 請注意這些選項與節有關。例如，假定你想要使用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操作系統中，所發現的使用!includedir指令包括的文件的文件名_必須_以.cnf為擴展名。在Windows中，該指令也為有.ini擴展名(包括.cnf)的文件做檢查。如果你想要創建只由一個具體**mysqld**服務器發布系列讀取的選項組，選項組可以用[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 ? 如果你有一個源代碼分發，可以從support-file目錄中找到名為my-_xxxx_.cnf的示例選項文件。如果你有一個二進制分發，在MySQL安裝目錄的support-file目錄中查找。在Windows中，示例選項文件也可以位于MySQL的安裝目錄(如果你不知道在哪里，查閱本節前面或[第2章：安裝MySQL](# "Chapter?2.?Installing MySQL"))。目前有小、中等、大以及非常大的系統的示例選項文件。要想練習這些文件，在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]組內發現的選項時**my_print_defaults**產生的輸出： shell> my_print_defaults client mysql --port=3306 --socket=/tmp/mysql.sock --no-auto-rehash **開發人員請注意**：在C客戶程序庫中，只是通過處理命令行參量前面的所有匹配選項(即相應組內的選項)來處理選項文件。對于使用多次指定的最后的選項實例的程序，可以很好地工作。如果你有一個C或C++程序按這種方式處理多次指定的選項，但不讀取選項文件，只需要添加兩行來實現該功能。檢查標準MySQL客戶程序的源代碼來看看如何做。其它幾個MySQL語言接口基于C客戶庫，它們中的一部分提供了訪問選項文件的一種方式。包括Perl和Python。關于接口的詳細信息參見相關文檔。 ### 4.3.3.?用環境變量指定選項要想用環境變量指定選項，使用適用注釋處理器的語法來設置變量。例如，在Windows或NetWare中，可以設置USER變量來指定MySQL賬戶名。要想實現，使用語法： SET USER=your_name 在Unix中的語法取決于你的外殼。假定你想要使用MYSQL_TCP_PORT變量指定TCP/IP端口號。典型的語法為(例如**sh**、bash、**zsh**等等)： MYSQL_TCP_PORT=3306 export MYSQL_TCP_PORT 第1個命令設置變量，export命令將變量導出到外殼環境，以便其值可供MySQL和其它進程訪問。 **csh**和**tcsh**有類似的問題。運行這些外殼時，使用**setenv**使外殼變量適用環境： setenv MYSQL_TCP_PORT 3306 可以在命令提示符下執行設置環境變量的命令，以便立即生效。這些設定值持續到你注銷。要向讓這些設定值在你每次登錄時生效，將相應命令放入每次啟動時命令解釋符所讀的啟動文件中。在Windows中典型啟動文件為AUTOEXEC.BAT，**bash**為.bash_profile，或者**tcsh**為.tcshrc。關于命令解釋符的具體細節請查閱文檔。 [附錄](#)[F：_環境變量_](# "Appendix?F.?Environment Variables")了列出影響MySQL程序操作的所有環境變量。 ### 4.3.4.?使用選項設置程序變量許多MySQL程序有一些內部變量可以在運行時設置。程序變量的設置與帶有值的其它長選項相同。例如，**mysql**有一個max_allowed_packet變量，可以控制其通信緩沖區的最大長度。要想為**mysql**將max_allowed_packet變量的值設置為16MB，使用下面的任何一個命令： shell> mysql --max_allowed_packet=16777216 shell> mysql --max_allowed_packet=16M 第1個命令以字節指定值。第2個命令以兆字節指定值。變量值可以有一個后綴K、M或者G(可以為大寫或小寫)來表示千字節、兆字節或者十億字節的單位。在選項文件中，變量設定值沒有引導破折號： [mysql] max_allowed_packet=16777216 或： [mysql] max_allowed_packet=16M 如果你喜歡，變量名的下劃線可以為破折號。 **注釋：**MySQL 5.1仍然能識別舊的語法--set-variable = _option_=_value_，但現在不贊成使用。部分服務器變量可以在運行時設置。詳情參見[5.3.3.1節，“動態系統變量”](# "5.3.3.1.?Dynamic System Variables")。這是MySQL參考手冊的翻譯版本，關于MySQL參考手冊，請訪問[dev.mysql.com.](http://dev.mysql.com/doc/mysql/en)。原始參考手冊為英文版，與英文版參考手冊相比，本翻譯版可能不是最新的。