MySQL實用程序

MySQL實用程序

所有使用mysqlclient客戶庫與服務器通信的MySQL客戶使用下列環境變量：

名字	說明
MYSQL_UNIX_PORT	缺省套接字；用于連接localhost
MYSQL_TCP_PORT	缺省 TCP/IP 端口
MYSQL_PWD	缺省口令
MYSQL_DEBUG	調試時調試-蹤跡選項
TMPDIR	臨時表/文件被創建的目錄

使用MYSQL_PWD是不安全的。見。

“mysql”客戶使用MYSQL_HISTFILE環境變量中命名的文件來保存命令行歷史，歷史文件的缺省值是“$HOME/.mysql_history”，這里$HOME是HOME環境變量的值。

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

你能用一個選項文件覆蓋所有的標准客戶程序的缺省選項。見。

下表簡單地描述MySQL程序：

myisamchk

描述、檢查、優化和修複MySQL表的使用程序。因為myisamchk有許多功能，它在其自己的章節中描述。見。

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也可以被用來從服務器檢索版本，進程和狀態信息。見。

mysqlbug

MySQL錯誤報告腳本。當填寫一份錯誤報告到MySQL郵件列表時，應該總是使用該腳本。

mysqld

SQL守護進程。它應該一直在運行。

mysqldump

以SQL語句或定位符分隔的文本文件將一個MySQL數據庫傾倒一個文件中。這是最早由Igor Romanenko編寫的自由軟件的增強版本。見。

mysqlimport

使用LOAD DATA INFILE將文本文件倒入其各自的表中。見。

mysqlshow

顯示數據庫，表，列和索引的信息。

mysql_install_db

以缺省權限創建MySQL授權表。這通常僅被執行一次。就是在系統上第一次安裝MySQL時。

replace

一個實用程序，由msql2mysql使用，但是有更一般的適用性。replace改變文件中或標准輸入上的字符串。使用一台有限狀態機首先匹配更長的字符串，能被用來交換字符串。例如，這個命令在給定的文件中交換a和b：

shell> replace a b b a -- file1 file2 ...

safe_mysqld

一個腳本，用某些更安全的特征啟動mysqld守護進程，例如當一個錯誤發生時，重啟服務器並且記載運行時刻信息到一個日志文件中。

用于執行管理性操作。語法是：

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 ..., refresh和reload命令數量
Open tables	現在被打開的表數量
Memory in use	由mysqld代碼直接分配的內存(只有在MySQL用--with-debug編譯時可用)
Max memory used	由mysqld代碼直接分配的最大內存(只有在MySQL用--with-debug編譯時可用)

實用程序，為備份或為把數據轉移到另外的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子句相同的含義。見。

-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

mysqlimport提供一個到LOAD DATA INFILESQL語句的命令行接口。mysqlimport的大多數選項直接對應于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的子句相同的含義。見。

-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 |
+------+---------------+
 

myisampack被用來壓縮MyISAM表，而pack_isam被用來壓縮ISAM表。由于ISAM表被淘汰，這里我們將只討論myisampack。

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

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

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

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

當前myisampack有2個限制：

• 在壓縮後，表只能讀。
• myisampack也能壓縮BLOB或TEXT列。較老的pack_isam不能做到。

修正這些限制以在我們的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”存在，它以一個錯誤退出。用--force，myisampack不管怎樣都壓縮表。

-?, --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

在哈夫曼樹里使用的位數。