MySQL中文参考手册3（MySQL邮件列表及若何发问或报告错误）[MSSQL防范]

译者:晏子 (clyan@sohu.com)主页:http://linuxdb.yeah.net

2 MySQL邮件列表及若何发问或报告错误
2.1  MySQL 邮件列表
要定阅主 MySQL 邮件列表,送一条消息到电子邮件地址 mysql-subscribe@lists.mysql.com .

要退订主 MySQL 邮件列表,送一条消息到电子邮件地址 mysql-unsubscribe@lists.mysql.com . 

只有你发送消息的地址是有意义的,消息的主题行和正文将被忽视.

假如你的答复地址不是有效的,你可以明确地指定地址.把短横加到定阅或退订号令词,随后是你的地址,"@"由一个字符"="替换.比方,要定阅到john@host.domain,送一条消息到mysql-subscribe-john=host.domain@lists.mysql.com. 

邮寄到 mysql-subscribe@lists.mysql.com 或 ezmlm 邮件列表处理器.具体信息可在 ezmlm 网点得到.

要想邮寄一条消息到列肀旧恚?⑺湍愕南?⒌?a href=mailto:mysql@lists.mysql.com> mysql@lists.mysql.com.但是,请千万不要将关于定阅或退订的邮件发到mysql@lists.mysql.com ,因为送到该地址的任何邮件被自动地被披发到上千个其他用户.

你本地的网站大概有很多 mysql@lists.mysql.com 的订户,假如这样,也大概有一个本地邮件列表,以便使从 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 
一个文摘版本developer列表. 
你可用上述的办法定阅或退订全部列表.在你的定阅或退订消息中,只是放入不是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可在源代码分发或二进制分发的 MySQL安装目录下的'bin'目录中的'scripts' 目录下找到.假如你不能利用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/,然后把问题的简短描写发到mysql@lists.mysql.com . 
假如你的问题与权限系统有关.请包含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 情势的浏览器投寄邮件消息!很多用户不用浏览器读邮件!
chin a i t p oe er . co mfemnX