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
所有使用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”,這裡$HOME是HOME環境變數的值。
所有MySQL程式取許多不同的選項,然而,每個MySQL程式提供一個--help選項,你可以使用它得到程式不同選項的完整描述。例如,試一試mysql
--help。
你能用一個選項文件覆蓋所有的標準客戶程式的內定選項。見4.15.4 選擇文件。
下表簡單地描述MySQL程式:
myisamchk myisamchk有許多功能,它在其自己的章節中描述。見13 維護MySQL安裝。
make_binary_release 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 mysqld mysqldump mysqlimport LOAD DATA INFILE將文本文件倒入其各自的表中。見12.4 從文本文件導入數據。 mysqlshow mysql_install_db 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子句相同的含義。見7.16
LOAD DATA INFILE語法。 -F, --flush-logs -f, --force, -h, --host=.. 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] mysqldump需要來自終端的密碼。
-P port_num, --port=port_num localhost以外的主機,因為它使用
Unix套接字。)-q, --quick 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 -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的相同選項。見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 localhost。
-i, --ignore --replace選項的描述。 -l, --lock-tables -L, --local localhost(它是內定主機),文本文件被假定在伺服器上。
-pyour_pass, --password[=your_pass] mysqlimport要求來自終端的密碼。
-P port_num, --port=port_num 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 -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=# 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 empty-zero 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 Huff tree Bits