MySQL中文参考手册

译者：晏子 ([email protected]）      主页：http://linuxdb.yeah.net

到第一节, 前一节, 下一节, 最后一节，目录.

2 MySQL邮寄表及怎样问问题或报告错误(bugs)

2.1  MySQL 邮寄表

要订阅主要的 MySQL 邮寄表，送一条消息到电子邮件地址 [email protected] 。

要退订主要的 MySQL 邮寄表，送一条消息到电子邮件地址 [email protected] 。

只有你发送消息的地址是重要的，消息的题目行和正文被忽略。

如果你的答复地址不是有效的，你能明确地指定地址。把短横加到订阅或退订命令词，随后是你的地址，“@”由一个字符“=”代替。例如，要订阅到[email protected]，送一条消息到[email protected]。

邮寄到 [email protected] 或 ezmlm 邮寄表处理器。详细信息可在 ezmlm 网点得到。

张贴一条消息到列表本身，发送你的消息到 [email protected] 。然而，请千万不要将关于订阅或退订的邮件发到 [email protected] ，因为送到该地址的任何邮件被自动地被散发到上千个其他用户。

你本地的网站可以有很多 [email protected] 的订户，尽管因此，也可以有一张本地邮寄表，以便使从 lists.mysql.com 发到你的网站的消息被传播到你本地列表。在这样的情况下，请联系你的系统主管从本地 MySQL 列表添加和放弃。

已有下列 MySQL 邮寄表：

announce

这是MySQL新版本和相关程序的发布通知,这是小信息量的列表，我们认为所有的 MySQL 用户应该订阅。

mysql

为一般 MySQL 讨论的主要列表。请注意一些话题最好在更专业的列表上讨论。如果你邮寄到错误的列表，你可能得不到回答！

mysql digest

文摘形式的mysql列表，这意味着你得到所有的单个文摘，作为一个大邮件一天一次地发送。

java 

讨论关于 MySQL 和 Java ，主要关于 JDBC 驱动程序。

java digest

一个文摘版本java 列表。

win32 

有关微软操作系统上例如 Windows NT的 MySQL一切东西。

win32 digest

一个文摘版本win32表。

myodbc 

有关用 ODBC联接 MySQL 的一切东西。

myodbc digest

一个文摘版本 myodbc 列表。

msql-mysql-modules 

关于 MySQL中对Perl支持的一个列表。

msql-mysql-modules-digest 

一个文摘版本 msql-mysql-modules 列表。

developer

为工作于 MySQL 原代码的人的一个列表。

developer digest

一个文摘版本deviloper列表.

你可用上述的方法订阅或退订所有列表。在你的订阅或退订消息中，只要放适当的邮寄表名字而非mysql。例如，订阅或退订myodbc列表，送一条消息到（原文未提供）。

2.2 提问或报告错误

在邮寄一份错误报告或问题前，请按下列步骤做：

• 由寻找 MySQL 联机的手册开始：

   http://www.mysql.com/Manual_chapter/manual_toc.html 

  我们通过经常更新新发现问题的解决方法，努力使使手册是最新的！

• 搜索 MySQL 邮寄表档案：

   http://www.mysql.com/doc.html 

• 你也可使用 http://www.mysql.com/search.html 寻找在http://www.mysql.com/下的网页(包括手册)。

如果你不能在手册或档案发现答案，检查你本地的 MySQL 专家。如果你仍然不能发现你问题的答案，继续读下一节关于怎样发送邮件到 （原文未提供）。

2.3 怎样报告错误或问题

写一份好的错误报告需要耐心，但是第一次正确做到可省去你我的时间。这节将帮助你正确撰写你的报告，以便你不浪费时间，也可能做一些根本不能帮助我们的事情。

如果可能的话，我们鼓励每个人使用 mysqlbug 脚本产生一份错误报告(或关于任何问题的一份报告)。 mysqlbug 可在源代码分发或二进制分发的'scripts' 目录下找到，在你的 MySQL 安装目录下的'bin'目录。如果你不能使用 mysqlbug ,你仍然应该包括在这节列出了的所有必要的信息.

mysqlbug 脚本帮助你通过自动确定下列很多信息来生成一份报告，但是如果一些重要的东西不见了，请在你的消息中包含它！请仔细阅读本节并且保证这里描述的所有信息包含在你的报告中。

要记住得对一条消息的应答可能包含太多的信息，然而不可能包含极少信息，因为人们认为他们知道一个问题的原因并且假设一些细节部重要，所以他们常常忽略事实。一个好原则是：如果你怀疑所说的事情，继续说！在你的报告中写上几行比因为第一次并没有包含足够的信息而被迫追问和等待答案要快上千倍且少些麻烦，

最常见的错误是人们不指出他们正在使用的MySQL分发的版本号，或不指出在什么平台上平台安装了 MySQL (包括平台版本号)。这是高度相关的信息并且没有它99%错误报告是无用的！我们经常得到这样的问题“为什么这不给我工作?”，然后我们发现所需的功能没在该版本的 MySQL 实现，或在一份报告描述的错误了的版本已经在更新的MySQL 版本修正了。有时错误是依赖于平台，在这种下情况，不知道平台操作系统和版本号根本不可能修正任何东西。

还要记住，要提供你的编译器的信息，如果它于问题相关。人们经常发现错在编译器而认为问题是与 MySQL 有关。大多数编译器移植到在开发中并且随版本也逐渐变好。为了确定决定你的问题是否取决于你的编译器，我们需要知道使用什么编译器。注意每个编译器问题应该被认为是一个错误，因此要报告。

在错误报告中包含问题的很好描述是最有用的。即，你做的所有导致这个问题且问题本身可确切描述的事情中的一个好例子。最好的报告是包括显示如何再次产生错误或问题的一个例子的全部内容。

如果一个程序产省一条错误信息，非常重要的是在你的错误报告中包含它！如果我们试着从程序使用的档案中找一些东西，最好是报告的错误消息确切匹配程序所产生的。（甚至注意大小写！)你决不应该试图记住错误消息是什么，相反,将全部消息拷贝并且粘贴进你的报告中！

如果你有一个MyODBC问题，你应该尝试产生一个 MyODBC 跟踪文件，详见16.6 报告 MyODBC的问题.

请记住，将要阅读你报告的人有许多使用80列显示。在产生报告或使用mysql命令行工具的例子时，你应该因此为那些可能超出显示可用宽度的输出(例如，EXPLAIN SELECT语句，见下面的例子)使用--vertical选项(或\G语句终止符)，.

请在你的报告包括下列信息：

• 你正在使用的 MySQL 分发版本号(例如， MySQL  3.22.22 )。你可以执行mysqladmin version找到你正在运型哪个版本。mysqladmin 可在你的 MySQL 安装目录的'bin'目录下面找到。
• 你正在工作的机器的制造商和型号。
• 操作系统名字和版本。对大多数操作系统，你可以通过执行一条Unix命令uname -a 能得到信息。
• 有时与存储器的数量(物理和虚拟的)相关，如果有疑问，包含这些值。
• 如果你正在使用一个源代码分发的 MySQL ，则需要使用的编译器的名称和版本号。如果你有一个二进制代码的分发，就需要该分发的名字。
• 如果问题在编译期间发生，则包含准确的错误消息，并且也包含问题发生的文件中出错代码周围的一些上下文。
• 如果任何数据库表与问题有关，包含从 mysqldump --db_name  tbl_name1  tbl_name2 …的输出结果。这是很容易做到，并且它是一个获得有关任何数据库表信息的有效方法，将帮助我们创造一个匹配你遇到问题的环境。
• 对于与速度或SELECT语句有关的问题，你总是应该包括EXPLAIN SELECT．．．的输出和至少SELECT语句产生的行数。你给出的有关你的情况的的信息越多，某些人越能帮助你。例如，下列的例子是一份很好的错误报告(当然它应该用与 mysqlbug 脚本投递)：运行 mysql 命令行工具的例子(注意对其输出超过80列显示设备的语句使用\G终止符)：

  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>
  

• 如果在运行 MySQL 时是发生问题，尝试一下提供重现问题的一个输入脚本，该脚本应该包括任何必要的源文件，重现你的情况的脚本越准确越好。如果你不能提供脚本，你至少应该在你的邮件中包括从 mysqladmin variables extended-status processlist以提供你的系统怎样正在运行！
• 如果你认为 MySQL 产生一个奇怪查询结果，不仅要包含结果,而且也要包含你的应该是什么结果的意见和描述你的意见依据的原因。
• 当给问题的一个例子时，最好使用在你的真实情况下而不是一个新的变量名、表名字等等。这个问题应该与一个变量的名字、表等有关！也许这些条件是苛刻的，但是安全比担心更好。不管怎么说，提供使用你的实际情况的例子应该比较容易，并且各方面来讲它对我们更好一些。如果你有不想显示给别人看的数据，你可使用ftp把它转移到ftp://www.mysql.com/pub/mysql/secret/。如果数据确实是高度机密的，甚至不想让我们看到它们，那么继续，并提供使用其它名字的例子，但是请注意这是最后选择。
• 如果可能，包括相关程序的所有选项，例如，指明你启动 mysqld 守护程序和运行任何 MySQL 客户程序所使用的选项，对象mysqld 和 mysql等程序和configure 的选项常常是答案的关键和至关重要的！包括他们绝对不是一个坏主意！如果你使用任何模块，例如Perl或PHP，请也包括它们的版本号。
• 如果你不能产生一个行数少的测试，或如果测试表太大，不能寄给邮寄表(超过10行),你应该使用mysqldump倒出(dump)数据库表并且创建“README”文件描述你的问题，用tar和gzip造创建你的文件的一个压缩的档案，并且使用ftp把档案文件转移到ftp://www.mysql.com/pub/mysql/secret/，然后问题的简短描述发到[email protected] 。
• 如果你的问题与权限系统有关。请包括mysqlaccess 、mysqladmin reload的输出和所有尝试连接时得到的错误消息！当你测试你的权限时，你应该首先运行mysqlaccess。在这以后，执行 mysqladmin reload version，最后你应该尝试用给你麻烦程序进行连接。 mysqlaccess 可在你的 MySQL 安装目录下的“bin”目录找到。
• 如果你有一个错误的补丁程序，那最好，但是千万别假设补丁程序是我们需要的一切，或即使你不提供一些必要信息如补丁能修正的错误的测试条件，就可使用它。我们可能发现你的补丁程序的问题，或者我们可能根本不理解它。如果是这样，我们不能使用它。在这里测试条件将帮组我们，这意味着补丁程序将处理一切可能出现的情况。如果我们发现了补丁不能工作的边界条件（即使很怪），它可能毫无用处。
• 对错误是什么、为什么发生或它依赖什么的猜测通常是错误的。我们甚至不能在没有首先使用一个调试器以确定一个错误的真正原因时做这种猜测。
• 在你的邮件消息说明你已经检查了参考手册和邮件归档，以便让其他人知道你自己尝试解决你的问题。
• 如果你得到一个parse error，请仔细检查你的语法！如果你不能它发现有什么不对，极其可能是你当前 MySQL 版本不支持如果你正在使用的查询。如果你正在使用最新版而且 http://www.mysql.com/doc.html 的参考手册没有涉及你正在使用的语法， MySQL 就不支持你的查询。在这种情况下，你唯一的选择是自己实现语法并邮寄过来。如果手册涉及你正在使用的语法，但是你有一个更旧版本的 MySQL ，你应该检查 MySQL 的更新历史来找出语法句法何时时候被实现。见D MySQL 变迁的历史记录。这时你有升级到一个更新的版本的 MySQL 选择.。
• 如果你有一个这样的问题：当你存取某些特定数据库表时，你的数据好像已破坏或出错，你应该首先用myisamchk检查然后尝试修复你的数据库表。见 13 维护 MySQL 安装.
• 你经常得到破坏了的数据库表，你应该尝试发现这何时和为何发生！此时“ mysql-data-directory/'hostname'.err ”文件可能包含所发生事情的一些信息。请在你的错误报告包含这个文件的任何有用信息！如果没有在更新当中杀死了mysqld，通常应该绝对不破坏数据库表！如果你能发现为什么 mysqld 死掉的原因，对于我们更容易向你提供我问题的修正！
• 如果可能，下载最新的版本的 MySQL ，并且检查它是否解决你的问题。MySQL的所有版本都被彻底地测试并且应该毫无问题地运行！我们相信使任何事情尽可能向后兼容，并且你应该能在数分钟内切换 MySQL 版本！见 4.3 要使用 MySQL 哪个版本。

如果你是一个支持顾客，请直接邮寄错误报告到适当的邮寄表，看看是否有其他人有这个问题经验（或许已经解决）。

对于报导MyODBC错误的信息，见 16.2 怎样报告 MyODBC 问题。

一些常见问题的答案，见 18   问题和常见的错误。

当答案个别发给你时而不是邮寄表，总结答案并且将总结发到邮寄表以便其它人可以从你收到的帮助你解决问题的答案中受益，这被认为是一个很好的规矩。

2.4 在邮寄表上回答问题的指南

如果你认为比的答案引起广泛的兴趣，你可能想要把它寄到邮寄表中而不是直接答复问问题人。试着让你的答案足够普便，让不是投寄者的其他人可从它获益。当你投寄到邮寄表时，请保证你的回答不与以前的答案重复。

尝试总结在你的答复中的问题的主要部分，别感觉不好意思引用全部原文消息。

请不要从有 HTML 模式的浏览器投寄邮件消息！许多用户不用浏览器读邮件！

到第一节, 前一节, 下一节, 最后一节，目录.