mysql-logo.gif (3082 bytes)MySQL中文參考手冊

譯者:晏子 (clyan@sohu.com
GB 碼主頁:http://linuxdb.yeah.net

Big5 轉碼者:statue (statue@bbs.yzu.edu.tw
詞彙轉換:彭武興 (wilson@mailbox.com.tw)
Big5 碼主頁: http://cnpa.yzu.edu.tw/~cfc/docs/mysqldoc_big5/manual_toc.html
Big5 碼分站: http://php.wilson.gs/mysqldoc/big5/manual_toc.html


第一章, 前一章, 下一章, 最後一章目錄.


12 MySQL實用程式

12.1 各種MySQL程式概述

所有使用mysqlclient客戶庫與伺服器通信的MySQL客戶使用下列環境變數:

名字 說明
MYSQL_UNIX_PORT 內定套接字﹔用於連接localhost
MYSQL_TCP_PORT 內定 TCP/IP 端口
MYSQL_PWD 內定密碼
MYSQL_DEBUG 調試時調試-蹤跡選項
TMPDIR 臨時表/文件被創建的目錄

使用MYSQL_PWD是不安全的。見6.3 與MySQL伺服器連接

“mysql”客戶使用MYSQL_HISTFILE環境變數中命名的文件來保存命令行歷史,歷史文件的內定值是“$HOME/.mysql_history”,這裡$HOMEHOME環境變數的值。

所有MySQL程式取許多不同的選項,然而,每個MySQL程式提供一個--help選項,你可以使用它得到程式不同選項的完整描述。例如,試一試mysql --help

你能用一個選項文件覆蓋所有的標準客戶程式的內定選項。見4.15.4 選擇文件

下表簡單地描述MySQL程式:

myisamchk
描述、檢查、最佳化和修復MySQL表的使用程式。因為myisamchk有許多功能,它在其自己的章節中描述。見13 維護MySQL安裝
make_binary_release
制作一個編譯MySQL的一個二進制的版本。這能用FTP傳送到在ftp.tcx.se網站的“/pub/mysql/Incoming”以方便其它MySQL用戶。
msql2mysql
一個外殼腳本,轉換mSQL程式到MySQL。它不能處理所有的情況,但是當轉換時,它給出一個好起點。
mysql
mysql是一個簡單的SQL外殼(具有GNU readline 能力),它支援交互式和非交互式使用。當交互地使用時,查詢結果以ASCII表的格式被表示。當非交互地使用時(例如,作為一個過濾器),結果是以定位符分隔的格式表示。(輸出格式可以使用命令行選項改變)你可以簡單地像這樣運行腳本:
shell> mysql database < script.sql > output.tab

如果你在客戶刈豽於內存不足造成問題,使用--quick選項!這迫使mysql使用mysql_use_result()而非mysql_store_result()來檢索結果集合。

mysqlaccess
一個腳本,檢查對主機、用戶和資料庫組合的存取權限。
mysqladmin
執行管理操作的實用程式,例如創建或拋棄資料庫,再裝載授權表,清洗表到磁碟中和再打開日誌文件。mysqladmin也可以被用來從伺服器檢索版本,進程和狀態資訊。見12.2 管理一個 MySQL 伺服器
mysqlbug
MySQL錯誤報告腳本。當填寫一份錯誤報告到MySQL郵件列表時,應該總是使用該腳本。
mysqld
SQL背景執行程式。它應該一直在運行。
mysqldump
以SQL語句或定位符分隔的文本文件將一個MySQL資料庫傾倒一個文件中。這是最早由Igor Romanenko編寫的自由軟件的增強版本。見12.3 從MySQL資料庫和表傾倒結構和數據
mysqlimport
使用LOAD DATA INFILE將文本文件倒入其各自的表中。見12.4 從文本文件導入數據
mysqlshow
顯示資料庫,表,列和索引的資訊。
mysql_install_db
以內定權限創建MySQL授權表。這通常僅被執行一次。就是在系統上第一次安裝MySQL時。
replace
一個實用程式,由msql2mysql使用,但是有更一般的適用性。replace改變文件中或標準輸入上的字符串。使用一台有限狀態機首先匹配更長的字符串,能被用來交換字符串。例如,這個命令在給定的文件刈逌換ab
shell> replace a b b a -- file1 file2 ...
safe_mysqld
一個腳本,用某些更安全的特徵啟動mysqld背景執行程式,例如當一個錯誤發生時,重啟伺服器並且記載運行時刻資訊到一個日誌文件中。

12.2 管理一個MySQL伺服器

用於執行管理性操作。語法是:

shell> mysqladmin [OPTIONS] command [command-option] command ...

通過執行mysqladmin --help,你可以得到你mysqladmin的版本所支援的一個選項列表。

目前mysqladmin支援下列命令:

create databasename 創建一個新資料庫
drop databasename 刪除一個資料庫及其所有表
extended-status 給出伺服器的一個擴展狀態消息
flush-hosts 洗掉所有緩存的主機
flush-logs 洗掉所有日誌
flush-tables 洗掉所有表
flush-privileges 再次裝載授權表(同reload)
kill id,id,... 殺死mysql執行緒
password 新密碼,將老密碼改為新密碼
ping 檢查mysqld是否活著
processlist 顯示服務其中活躍執行緒列表
reload 重載授權表
refresh 洗掉所有表並關閉和打開日誌文件
shutdown 關掉伺服器
status 給出伺服器的簡短狀態消息
variables 列印出可用變數
version 得到伺服器的版本資訊

所有命令可以被縮短為其唯一的前綴。例如:

shell> mysqladmin proc stat
+----+-------+-----------+----+-------------+------+-------+------+
| Id | User  | Host      | db | Command     | Time | State | Info |
+----+-------+-----------+----+-------------+------+-------+------+
| 6  | monty | localhost |    | Processlist | 0    |       |      |
+----+-------+-----------+----+-------------+------+-------+------+
Uptime: 10077  Threads: 1  Questions: 9  Slow queries: 0  Opens: 6  Flush tables: 1  
Open tables: 2  Memory in use: 1092K  Max memory used: 1116K

mysqladmin status命令結果有下述列:

Uptime MySQL伺服器已經運行的秒數
Threads 活躍執行緒(客戶)的數量
Questions mysqld啟動起來自客戶問題的數量
Slow queries 已經超過long_query_time秒的查詢數量
Opens mysqld已經打開了多少表
Flush tables flush ..., refreshreload命令數量
Open tables 現在被打開的表數量
Memory in use 由mysqld代碼直接分配的內存(只有在MySQL用--with-debug編譯時可用)
Max memory used 由mysqld代碼直接分配的最大內存(只有在MySQL用--with-debug編譯時可用)

12.3 從MySQL資料庫和表中倒出結構和數據

實用程式,為備份或為把數據轉移到另外的SQL伺服器上傾倒一個資料庫或許多資料庫。傾倒將包含 創建表或充實表的SQL語句。

shell> mysqldump [OPTIONS] database [tables]

如果你不給定任何表,整個資料庫將被傾倒。

通過執行mysqldump --help,你能得到你mysqldump的版本支援的選項表。

注意,如果你運行mysqldump沒有--quick--opt選項,mysqldump將在傾倒結果前裝載整個結果集到內存中,如果你正在傾倒一個大的資料庫,這將可能是一個問題。

mysqldump支援下列選項:

--add-locks
在每個表傾倒之前增加LOCK TABLES並且之後UNLOCK TABLE。(為了使得更快地插入到MySQL)。
--add-drop-table
在每個create語句之前增加一個drop table
--allow-keywords
允許創建是關鍵詞的列名字。這由表名前綴於每個列名做到。
-c, --complete-insert
使用完整的insert語句(用列名字)。
-C, --compress
如果客戶和伺服器均支援壓縮,壓縮兩者間所有的資訊。
--delayed
INSERT DELAYED命令插入行。
-e, --extended-insert
使用全新多行INSERT語法。(給出更緊縮並且更快的插入語句)
-#, --debug[=option_string]
跟蹤程式的使用(為了調試)。
--help
顯示一條幫助消息並且退出。
--fields-terminated-by=...
 
--fields-enclosed-by=...
 
--fields-optionally-enclosed-by=...
 
--fields-escaped-by=...
 
--fields-terminated-by=...
這些選擇與-T選擇一起使用,並且有相應的LOAD DATA INFILE子句相同的含義。見7.16 LOAD DATA INFILE語法
-F, --flush-logs
在開始傾倒前,洗掉在MySQL伺服器中的日誌文件。
-f, --force,
即使我們在一個表傾倒期間得到一個SQL錯誤,繼續。
-h, --host=..
從命名的主機上的MySQL伺服器傾倒數據。內定主機是localhost
-l, --lock-tables.
為開始傾倒鎖定所有表。
-t, --no-create-info
不寫入表創建資訊(CREATE TABLE語句)
-d, --no-data
不寫入表的任何行資訊。如果你只想得到一個表的結構的傾倒,這是很有用的!
--opt
--quick --add-drop-table --add-locks --extended-insert --lock-tables。應該給你為讀入一個MySQL伺服器的盡可能最快的傾倒。
-pyour_pass, --password[=your_pass]
與伺服器連接時使用的密碼。如果你不指定“=your_pass”部分,mysqldump需要來自終端的密碼。
-P port_num, --port=port_num
與一台主機連接時使用的TCP/IP端口號。(這用於連接到localhost以外的主機,因為它使用 Unix套接字。)
-q, --quick
不緩沖查詢,直接傾倒至stdout﹔使用mysql_use_result()做它。
-S /path/to/socket, --socket=/path/to/socket
localhost連接時(它是內定主機)使用的套接字文件。
-T, --tab=path-to-some-directory
對於每個給定的表,創建一個table_name.sql文件,它包含SQL CREATE 命令,和一個table_name.txt文件,它包含數據。 注意:這只有在mysqldump運行在mysqld背景執行程式運行的同一台機器上的時候才工作。.txt文件的格式根據--fields-xxx--lines--xxx選項來定。
-u user_name, --user=user_name
與伺服器連接時,MySQL使用的用戶名。內定值是你的Unix登錄名。
-O var=option, --set-variable var=option
設置一個變數的值。可能的變數被列在下面。
-v, --verbose
冗長模式。列印出程式所做的更多的資訊。
-V, --version
列印版本資訊並且退出。
-w, --where='where-condition'
只傾倒被選擇了的記錄﹔注意引號是強制的!
"--where=user='jimf'" "-wuserid>1" "-wuserid<1"

最常見的mysqldump使用可能制作整個資料庫的一個備份:

mysqldump --opt database > backup-file.sql 

但是它對用來自於一個資料庫的資訊充實另外一個MySQL資料庫也是有用的:

mysqldump --opt database | mysql --host=remote-host -C database

12.4 從文本文件導入數據

mysqlimport提供一個到LOAD DATA INFILESQL語句的命令行介面。mysqlimport的大多數選項直接對應於LOAD DATA INFILE的相同選項。見7.16 LOAD DATA INFILE語法

mysqlimport像這樣調用:

shell> mysqlimport [options] filename ...

對於在命令行上命名的每個文本文件,mysqlimport剝去文件名的擴展名並且使用它決定哪個表導入文件的內容。例如,名為“patient.txt”“patient.text”“patient”將全部被導入名為patient的一個表中。

mysqlimport支援下列選項:

-C, --compress
如果客戶和伺服器均支援壓縮,壓縮兩者之間的所有資訊。
-#, --debug[=option_string]
跟蹤程式的使用(為調試)。
-d, --delete
在導入文本文件前倒空表格。
--fields-terminated-by=...
 
--fields-enclosed-by=...
 
--fields-optionally-enclosed-by=...
 
--fields-escaped-by=...
 
--fields-terminated-by=...
這些選項與對應於LOAD DATA INFILE的子句相同的含義。見7.16 LOAD DATA INFILE語法
-f, --force
忽略錯誤。例如,如果對於一個文本文件的一個表不存在,繼續處理任何餘下的文件。沒有--force,如果表不存在,mysqlimport退出。
--help
顯示一條幫助消息並且退出。
-h host_name, --host=host_name
導入數據到命名的主機上的MySQL伺服器。內定主機是localhost
-i, --ignore
見為--replace選項的描述。
-l, --lock-tables
在處理任何文本文件前為寫入所定所有的表。這保証所有的表在伺服器上被同步。
-L, --local
從客戶讀取輸入文件。內定地,如果你連接localhost(它是內定主機),文本文件被假定在伺服器上。
-pyour_pass, --password[=your_pass]
與伺服器連接時使用的密碼。如果你不指定“=your_pass”部分,mysqlimport要求來自終端的密碼。
-P port_num, --port=port_num
與一台主機連接時使用的TCP/IP端口號。(這被用於連接到除localhost以外的主機,因為它使用Unix套接字。)
-r, --replace
--replace--ignore選項控制對輸入在唯一鍵值上有重複的現有記錄的輸入處理。如果你指定--replace,新行將代替有相同唯一鍵的存在的行。如果你指定--ignore,跳過輸入在唯一鍵值上有重複的現有記錄。如果你不指定任何一個選項,當找到一個重複的鍵值,出現一個錯誤,並且文本文件餘下部分被忽略。
-s, --silent
安靜模式。只有在錯誤發生時,寫出輸出。
-S /path/to/socket, --socket=/path/to/socket
localhost(它是內定主機)連接時使用的套接字文件。
-u user_name, --user=user_name
MySQL使用的用戶名字當與服務者聯接時。內定價值是你的 Unix 登錄名字。
-v, --verbose
冗長模式。列印程式所做的更多資訊。
-V, --version
列印版本資訊並且退出。

以下是使用mysqlimport運行的一個樣本:

$ mysql --version
mysql  Ver 9.33 Distrib 3.22.25, for pc-linux-gnu (i686)
$ uname -a
Linux xxx.com 2.2.5-15 #1 Mon Apr 19 22:21:09 EDT 1999 i586 unknown
$ mysql -e 'CREATE TABLE imptest(id INT, n VARCHAR(30))' test
$ ed
a
100     Max Sydow
101     Count Dracula
.
w imptest.txt
32
q
$ od -c imptest.txt
0000000   1   0   0  \t   M   a   x       S   y   d   o   w  \n   1   0
0000020   1  \t   C   o   u   n   t       D   r   a   c   u   l   a  \n
0000040
$ mysqlimport --local test imptest.txt
test.imptest: Records: 2  Deleted: 0  Skipped: 0  Warnings: 0
$ mysql -e 'SELECT * FROM imptest' test
+------+---------------+
| id   | n             |
+------+---------------+
|  100 | Max Sydow     |
|  101 | Count Dracula |
+------+---------------+
 

12.5 MySQL壓縮只讀表產生器

myisampack被用來壓縮MyISAM表,而pack_isam被用來壓縮ISAM表。由於ISAM表被淘汰,這裡我們將只討論myisampack

myisampack是當你訂購超過10個使用授權或擴展的支援時,你得到的一個額外的實用程式。因為這些僅以二進制形式被分發,他們僅在某些平台上可用。

下面我們僅談論myisampack, 但是每件事情對pack_isam也是持有的。

myisampack通過單獨壓縮表中的每個列來工作。當表被打開時,需要加壓縮的資訊被讀進內存,這使得在存取單個記錄時能得到更好的性能,因為你只需要解壓縮一個記錄,不是更大的磁碟塊,像在 MSDOS上使用Stacker時一樣。通常,myisampack壓縮數據文件40%-70%。

MySQL使用內存映射(mmap())在壓縮表上而如果mmap()的使用不工作,倒回到正常的讀/寫文件。

當前myisampack有2個限制:

修正這些限制以在我們的TODO表上,但是具有低優先級。

myisampack像這樣調用:

shell> myisampack [options] filename ...

每個文件名應該是一個索引(“.MYI”) 文件名。如果你不在資料庫目錄下,你應該指定文件的路徑名。允許省略“.MYI”擴展名。

myisampack支援下列選項:

-b, --backup
制作表的一個備份,為tbl_name.OLD
-#, --debug=debug_options
輸出調試日誌。debug_options串經常是'd:t:o,filename'
-f, --force
即使它變得更大或如果臨時文件存在,強制表的壓縮。(myisampack在壓縮表時創建一個名位“tbl_name.TMD”的臨時文件。如果你殺死myisampack“.TMD”文件不能被刪除。通常,如果myisampack發現“tbl_name.TMD”存在,它以一個錯誤退出。用--forcemyisampack不管怎樣都壓縮表。
-?, --help
顯示一條幫助消息並且退出。
-j big_tbl_name, --join=big_tbl_name
聯結所有在命令行上被命名的表到一個單獨的表big_tbl_name中。所有要被合並的表必須是相同的(同樣的列名字和類型,同樣的索引,等等。)
-p #, --packlength=#
指定記錄長度儲存尺寸,按字節。值應該是1、2或3。(myisampack用1、2或3字節的長度指針儲存所有行。在最一般的情況下,myisampack在它開始包裝文件以前,能確定正確的長度值,但是它可能注意到在包裝程序期間,它能使用了更短的長度。在這種情況下,myisampack在下一次你包裝同樣文件時間列印出一條提示,你可以使用更短的記錄長度。)
-s, --silent
安靜模式。只有當錯誤發生時,寫出輸出。
-t, --test
不壓縮表,僅僅測試壓縮它。
-T dir_name, --tmp_dir=dir_name
使用命名的目錄作為寫入臨時表的位置。
-v, --verbose
冗長模式。寫出有關進展和包裝結果的資訊。
-V, --version
顯示版本資訊和出口。
-w, --wait
如果表正在使用,等待並且再試。如果mysqld伺服器以--skip-locking選項被調用,如果表可能在包裝程序中被更新,調用myisampack不是一個好主意。

下面顯示的命令順序說明了一個典型的表壓縮桌子壓縮程序:

shell> ls -l station.*
-rw-rw-r--   1 monty    my         994128 Apr 17 19:00 station.MYD
-rw-rw-r--   1 monty    my          53248 Apr 17 19:00 station.MYI
-rw-rw-r--   1 monty    my           5767 Apr 17 19:00 station.frm

shell> myisamchk -dvv station

MyISAM file:     station
Isam-version:  2
Creation time: 1996-03-13 10:08:58
Recover time:  1997-02-02  3:06:43
Data records:              1192  Deleted blocks:              0
Datafile: Parts:           1192  Deleted data:                0
Datafile pointer (bytes):     2  Keyfile pointer (bytes):     2
Max datafile length:   54657023  Max keyfile length:   33554431
Recordlength:               834
Record format: Fixed length

table description:
Key Start Len Index   Type                       Root  Blocksize    Rec/key
1   2     4   unique  unsigned long              1024       1024          1
2   32    30  multip. text                      10240       1024          1

Field Start Length Type
1     1     1
2     2     4
3     6     4
4     10    1
5     11    20
6     31    1
7     32    30
8     62    35
9     97    35
10    132   35
11    167   4
12    171   16
13    187   35
14    222   4
15    226   16
16    242   20
17    262   20
18    282   20
19    302   30
20    332   4
21    336   4
22    340   1
23    341   8
24    349   8
25    357   8
26    365   2
27    367   2
28    369   4
29    373   4
30    377   1
31    378   2
32    380   8
33    388   4
34    392   4
35    396   4
36    400   4
37    404   1
38    405   4
39    409   4
40    413   4
41    417   4
42    421   4
43    425   4
44    429   20
45    449   30
46    479   1
47    480   1
48    481   79
49    560   79
50    639   79
51    718   79
52    797   8
53    805   1
54    806   1
55    807   20
56    827   4
57    831   4

shell> myisampack station.MYI
Compressing station.MYI: (1192 records)
- Calculating statistics

normal:     20  empty-space:      16  empty-zero:        12  empty-fill:  11
pre-space:   0  end-space:        12  table-lookups:      5  zero:         7
Original trees:  57  After join: 17
- Compressing file
87.14%

shell> ls -l station.*
-rw-rw-r--   1 monty    my         127874 Apr 17 19:00 station.MYD
-rw-rw-r--   1 monty    my          55296 Apr 17 19:04 station.MYI
-rw-rw-r--   1 monty    my           5767 Apr 17 19:00 station.frm

shell> myisamchk -dvv station

MyISAM file:     station
Isam-version:  2
Creation time: 1996-03-13 10:08:58
Recover time:  1997-04-17 19:04:26
Data records:              1192  Deleted blocks:              0
Datafile: Parts:           1192  Deleted data:                0
Datafilepointer (bytes):      3  Keyfile pointer (bytes):     1
Max datafile length:   16777215  Max keyfile length:     131071
Recordlength:               834
Record format: Compressed

table description:
Key Start Len Index   Type                       Root  Blocksize    Rec/key
1   2     4   unique  unsigned long             10240       1024          1
2   32    30  multip. text                      54272       1024          1

Field Start Length Type                         Huff tree  Bits
1     1     1      constant                             1     0
2     2     4      zerofill(1)                          2     9
3     6     4      no zeros, zerofill(1)                2     9
4     10    1                                           3     9
5     11    20     table-lookup                         4     0
6     31    1                                           3     9
7     32    30     no endspace, not_always              5     9
8     62    35     no endspace, not_always, no empty    6     9
9     97    35     no empty                             7     9
10    132   35     no endspace, not_always, no empty    6     9
11    167   4      zerofill(1)                          2     9
12    171   16     no endspace, not_always, no empty    5     9
13    187   35     no endspace, not_always, no empty    6     9
14    222   4      zerofill(1)                          2     9
15    226   16     no endspace, not_always, no empty    5     9
16    242   20     no endspace, not_always              8     9
17    262   20     no endspace, no empty                8     9
18    282   20     no endspace, no empty                5     9
19    302   30     no endspace, no empty                6     9
20    332   4      always zero                          2     9
21    336   4      always zero                          2     9
22    340   1                                           3     9
23    341   8      table-lookup                         9     0
24    349   8      table-lookup                        10     0
25    357   8      always zero                          2     9
26    365   2                                           2     9
27    367   2      no zeros, zerofill(1)                2     9
28    369   4      no zeros, zerofill(1)                2     9
29    373   4      table-lookup                        11     0
30    377   1                                           3     9
31    378   2      no zeros, zerofill(1)                2     9
32    380   8      no zeros                             2     9
33    388   4      always zero                          2     9
34    392   4      table-lookup                        12     0
35    396   4      no zeros, zerofill(1)               13     9
36    400   4      no zeros, zerofill(1)                2     9
37    404   1                                           2     9
38    405   4      no zeros                             2     9
39    409   4      always zero                          2     9
40    413   4      no zeros                             2     9
41    417   4      always zero                          2     9
42    421   4      no zeros                             2     9
43    425   4      always zero                          2     9
44    429   20     no empty                             3     9
45    449   30     no empty                             3     9
46    479   1                                          14     4
47    480   1                                          14     4
48    481   79     no endspace, no empty               15     9
49    560   79     no empty                             2     9
50    639   79     no empty                             2     9
51    718   79     no endspace                         16     9
52    797   8      no empty                             2     9
53    805   1                                          17     1
54    806   1                                           3     9
55    807   20     no empty                             3     9
56    827   4      no zeros, zerofill(2)                2     9
57    831   4      no zeros, zerofill(1)                2     9

myisampack列印的資訊在下面描述:

normal
不是用額外壓縮的列數。
empty-space
僅包含空格值的列數﹔這些將占據1位。
empty-zero
只包含二進制0值的列數﹔這些將占據1位。
empty-fill
不占據其類型全部字節範圍的整形列數﹔這些被改變為一種更小的類型(例如,一個INTEGER列可以被改變為MEDIUMINT)。
pre-space
用前導空間儲存的小數的列數。在這種情況下,每個值將包含一個前導空格的數量的計數。
end-space
有很多拖後空格的列數。在這種情況下,每個值將包含一個拖後空格的數量的計數。
table-lookup
列只有少數不同的值,並且它在哈夫曼壓縮前被變換一個ENUM
zero
所有值為零的列數。
Original trees
哈夫曼樹的初始數目。
After join
在聯結哈夫曼樹以節省一些表頭空間後餘下的不同樹的數量。

在一張表被壓縮以後,myisamchk -dvv列印出每個字段的額外資訊:

Type
字段類型可以包含下列描述符:
constant
所有行有相同的值。
no endspace
不儲存尾空格。
no endspace, not_always
不儲存尾空格而且不對所有值做尾空格壓縮。
no endspace, no empty
不儲存尾空格。不儲存空值。
table-lookup
列被變換到一個ENUM
zerofill(n)
值中最高n位總是0並且不被儲存。
no zeros
不儲存零。
always zero
0值以1位被儲存。
Huff tree
與字段相關的哈夫曼樹
Bits
在哈夫曼樹裡使用的位數。

第一章, 前一章, 下一章, 最後一章目錄.