MySQL中文參考手冊

oraclelang

寫一份好的錯誤報告需要耐心，但是第一次就做得正確可節省你我的時間。本節將幫助你正確撰寫你的報告，以使你不浪費時間，也可能做一些根本不能幫助我們的事情。

如果可能的話，我們鼓勵每個人使用 mysqlbug 腳本產生一份錯誤報告(或關于任何問題的一份報告)。mysqlbug可在源代碼分發或二進制分發的 MySQL安裝目錄下的'bin'目錄中的'scripts' 目錄下找到。如果你不能使用mysqlbug，你仍然應該包括在本節列出的所有必要的信息。

mysqlbug 腳本通過自動確定下列很多信息來幫助你生成一份報告，但是如果一些重要的東西不見了，請在你的消息中包含它！請仔細閱讀本節並且保証這里描述的所有信息包含在你的報告中。

oraclelang

要記住，有可能回複一條包含太多的信息消息，但不回複包含極少信息的消息，因為人們認為他們知道一個問題的原因並且假設某些細節無所謂，所以他們常常忽略事實。一個好的原則是：如果你懷疑所說的事情，繼續說！在你的報告中寫上幾行，比因為第一次沒有包含足夠的信息而被迫追問和等待答案要快上千倍，而且少些麻煩。

最常見的錯誤是人們不指出他們正在使用的MySQL分發的版本號，或不指出在什麼平台上平台安裝了 MySQL (包括平台版本號)。這是極其相關的信息，並且沒有它99%錯誤報告是無用的！我們經常得到這樣的提問“為什麼它不給我工作?”，然後我們發現所需的功能還沒有在該版本的 MySQL 中實現，或在一份報告中描述的一個錯誤已經在更新的MySQL 版本修正了。有時錯誤是依賴于平台，在這種情況下，不知道平台操作系統和版本號根本不可能修正任何東西。

還要記住，要提供你的編譯器信息，如果它與問題有

oraclelang

還要記住，要提供你的編譯器信息，如果它與問題有關。人們經常發現錯在編譯器而認為MySQL的問題。大多數編譯器始終都在開發中並且隨版本也逐漸變得更好。為了確定決定你的問題是否依賴于你的編譯器，我們需要知道使用什麼編譯器。注意每個編譯器得問題應該被認為是一個錯誤，因此要報告。

在錯誤報告中包含一個問題的完好描述是最有幫助的。即，你所做的導致這個問題的一個好的例子和確切描述的問題本身。最好的報告是包括顯示如何再次產生錯誤或問題的一個完整例子。

如果一個程序產生一條錯誤信息，非常重要的是在你的錯誤報告中要包含它！如果我們試著從使用程序的檔案中找一些東西，最好是報告的錯誤消息精確地匹配程序所產生的。（甚至注意大小寫！)你決不應該試圖記住錯誤消息是什麼，相反，將全部消息拷貝並且粘貼進你的報告中！

oraclelang

如果你有一個MyODBC問題，你應該嘗試產生一個 MyODBC 跟蹤文件，詳見16.6 報告 MyODBC的問題.

請記住，將要閱讀你報告的人有很多使用80列顯示。在產生報告或使用mysql命令行工具的例子時，你應該為那些可能超出顯示可用寬度的輸出(例如，EXPLAIN SELECT語句，見下面的例子)使用--vertical選項(或\G語句終止符)。

請在你的報告中包括下列信息：

oraclelang

你正在使用的 MySQL 分發的版本號(例如， MySQL  3.22.22 )。你可以執行mysqladmin version找到你正在咝心膫

oraclelang

mysql> SHOW VARIABLES;
mysql> SHOW COLUMNS FROM ...\G
       <output-from-SHOW-COLUMNS>
mysql> EXPLAIN SELECT ...\G
       <output-from-EXPLAIN>
mysql> FLUSH STATUS;
mysql> SELECT ...;
       <A short version of the output from SELECT,
       including the time taken to run the query>
mysql> SHOW STATUS;
       <output from SHOW STATUS>

oraclelang

如果在咝

oraclelang

如果你不能產生一個行數少的測試，或如果測試表太大，不能寄給郵件列表(超過10行),你應該使用mysqldump倒出(dump)數據庫表並且創建“README”文件描述你的問題，用tar和gzip造創建你的文件的一個壓縮的檔案，並且使用ftp把檔案文件轉移到ftp://www.mysql.com/pub/mysql/secret/，然後把問�}的簡短描述發到mysql@lists.mysql.com 。
如果你的問題與權限系統有關。請包括mysqlaccess 、mysqladmin reload的輸出和所有嘗試連接時得到的錯誤消息！當你測試你的權限時，你應該首先咝衜ysqlaccess。在這以後，執行 mysqladmin reload version，最後你應該嘗試用你有問題的程序進行連接。 mysqlaccess 可在你的 MySQL 安裝目錄下的“bin”目錄找到。

oraclelang

如果你有一個對錯誤的補丁程序，那最好，但是千萬別假設補丁程序是我們需要的一切，或即使你不提供一些必要信息如補丁能修正的錯誤的前提條件，就可使用它。我們可能發現你的補丁程序問題，或者我們可能根本不理解它。如果是這樣，我們不能使用它。在這里測試條件將幫助我們，這意味著補丁程序將處理一切可能出現的情況。如果我們發現了補丁不能工作的邊界條件（即使很怪），它可能毫無用處。
對錯誤是什麼、為什麼發生或它依賴什麼的猜測通常是錯誤的。我們甚至不能在沒有首先使用一個調試器以確定一個錯誤的真正原因時做這種猜測。
在你的郵件消息說明你已經檢查了參考手冊和郵件歸檔，以便讓其他人知道你自己嘗試解決你的問題。
如果你得到一個parse error，請仔細檢查你的語法！如果你不能它發現有什麼不對，極有可能是你當前 MySQL 版本不支持你正在使用的查詢。如果你正在使用最新版而且 http://www.mysql.com/doc.html 的參考手冊沒有涉及你正在使用的語法， MySQL 就不支持你的查詢。在這種情況下，你唯一的選擇是自己實現語法並郵寄過來。如果手冊涉及你正在使用的語法，但是你有一個更舊版本的 MySQL ，你應該檢查 MySQL 的更新歷史來找出語法何時被實現。見D MySQL 變遷歷史。這時你有升級到一個更新 MySQL版本的選擇。
如果你有一個這樣的問題：當你存取某些特定數據庫表時，你的數據好像已破壞或出錯，你應該首先用myisamchk檢查然後嘗試修複你的數據庫表。見 13 維護 MySQL 安裝.

oraclelang

數據庫表。見 13 維護 MySQL 安裝.
你經常得到破壞了的數據庫表，你應該嘗試發現這何時和為何發生！此時“mysql-data-directory/'hostname'.err”文件可能包含所發生事情的一些信息。請在你的錯誤報告包含這個文件的任何有用信息！如果沒有在更新當中殺死了mysqld，通常應該絕對不破壞數據庫表！如果你能找出mysqld為什麼死掉的原因，對于我們，更容易向你提供對問題的修正！
如果可能，下載最新版本的 MySQL ，並且檢查它是否解決你的問題。MySQL的所有版本都被徹底地測試並且應該毫無問題地咝校∥覀兿嘈攀挂磺斜M可能向後兼容，並且你應該能在數分鐘內切換 MySQL 版本！見 4.3 要使用 MySQL 哪個版本