This API has been defined to encourage similarity between the Python
modules that are used to access databases. By doing this, we hope to
achieve a consistency leading to more easily understood modules, code
that is generally more portable across databases, and a broader reach
of database connectivity from Python.

这份文档中定义的API鼓励实现相似的访问数据库的Python模块。我们希望这种一致性使得模块更易理解，代码更易于在不同数据库之间移植，最终使得Python语言得以更广泛的连接各种数据库。

建议：
最后一个and并没有递进的意思，"最终使得"云云不太妥当。

T译：
这份文档定义DB API，以鼓励实现相似的访问数据库的Python模块。由此，我们希望这种一致性能使模块更易理解，代码更易在数据库之间移植，并且Python语言得以连接更多数据库。

* Open Issues
建议：
译成"未解决问题"似乎更妥当，因为中文并无"开放问题"这种表达。

Comments and questions about this specification may be directed to the
SIG for Database Interfacing with Python
建议：
"Comments and questions"可以译成"建议和意见"，这种词语组合在中文里也算常见。

This document describes the Python Database API Specification 2.0 and
a set of common optional extensions.

这份文档描述了Python数据库API规范2.0以及一系列的可选公共扩展。

建议：
"a set of common optional extensions"我试译作"一组共同的可选扩展"，不知是否更通顺些。

在 06-12-31，swordsp<sparas2006在gmail.com> 写道：
> （这封邮件等了两天也能没被approve...只好把附件压缩成zip重发一遍-_-b）
>
> 最近半年给忙坏了，几乎都没时间看邮件列表，之前的啄木鸟条目质量提升计划也搁浅了...
> 年底终于又有了点空闲，总算又可以干点自己的事情了。
>
> 这几天试着翻译了一下这篇PEP249，算是python数据库接口方面的权威文档。
> 说来这还是之前编辑PyDatabase条目时给自己定的计划，也算是COTW的副产品吧。
>
> 目前的成果见附件，中英对照的版本，完成了最主要的几个章节（关于标准API的部分），本着早发布勤发布的原则，先拿出来让大家瞅瞅。
> 顺便申请swordsp的啄木鸟编辑权限，以后就直接更新在wiki上了。
>
> 之前并没有什么翻译的经验，译文中有好些吃不太准或者对原文理解不透的地方，先一并记在下面。
> 因为是比较正式权威的文档，所以希望能尽量少出些错，还请大家帮忙审查一下：
>
> ===
>
> This API has been defined to encourage similarity between the Python modules
> that are used to access databases. By doing this, we hope to achieve a
> consistency leading to more easily understood modules, code that is
> generally more portable across databases, and a broader reach of database
> connectivity from Python.
>
> 这份文档中定义的API鼓励实现相似的访问数据库的Python模块。我们希望这种一致性使得模块更易理解，代码更易于在不同数据库之间移植，最终使得Python语言得以更广泛的连接各种数据库。
>
> （开头第一段就觉得怎么也翻不通顺，改了好几遍还是不太满意）
>
> Access to the database is made available through connection objects. The
> module must provide the following constructor for these:
> 对数据库的访问通过connection对象进行。模块必须提供以下的构造器：
>
> （我把本文中的constructor一律译为构造器，不知道有没有更合适的词）
>
> Sharing in the above context means that two threads may use a resource
> without wrapping it using a mutex semaphore to implement resource locking.
> Note that you cannot always make external resources thread safe by managing
> access using a mutex: the resource may rely on global variables or other
> external sources that are beyond your control.
>
> "共享"在以上语境中意味着两个线程可以共用同一资源而不需要用互斥信号量来实现外部的锁机制。注意，你无法用互斥量来保证外部资源的线程安全：因为这些资源可能依赖于你无法控制的全局变量或者其它外部资源。
>
> （后一句好像和前文有些衔接不上？"你"是指类库的作者还是使用者？）
>
> Exception raised for errors that are related to the database's operation and
> not necessarily under the control of the programmer...
> 无法由程序员完全控制的数据库操作错误所抛出的异常...
>
> （necessarily的含义吃不太准，字面上似乎是"不必"，但"无法"明显通顺一些）
>
> Note: The values of these exceptions are not defined. They should give the
> user a fairly good idea of what went wrong, though.
> 注意：这些异常的值并未定义，但它们应当尽量让用户对哪里出了错心中有数。
>
> （"心中有数"总感觉离原文远了点...但也想不出合适的词了）
>
> Close the connection now (rather than whenever __del__ is called).
> 立即关闭连接（而非等待__del__方法被调用）。
>
> （吃不太准原文的"rather than"到底怎么个语气）
>
> pending transaction
> 未决的事务
>
> （有没有更好的惯用译法？）
>
> Note that if the database supports an auto-commit feature, this must be
> initially off.
> 注意，如果数据库支持auto-commit功能，必须在初始化时将其关闭。
>
> （initially
> off的意思拿不太准，是指类库作者应该让auto-commit默认关闭？初始化是指初始化连接对象时？）
>
> The type_code can be interpreted by comparing it to the Type Objects
> specified in the section below.
> type_code元素可以被解释为与下文中指定的Type对象的比较结果。
>
> （这句译文完全是逐字堆砌出来的...）
>
> Call a stored database procedure with the given name. The sequence of
> parameters must contain one entry for each argument that the procedure
> expects. The result of the
> call is returned as modified copy of the input sequence. Input parameters
> are left untouched, output and input/output parameters replaced with
> possibly new values.
> 调用指定名字的数据库存储过程。参数序列必须为存储过程所期望的每一个参数包含一个入口。调用结果作为输入序列的一个修改过的拷贝返回。输入参数仍然保持不变，输出和"输入/输出"参数可能被替换成新的值。
>
> （我没有在python中使用过存储过程，这一段不是特别理解。是不是说函数本身没有返回值，但传入的sequence可能在执行完后已经被修改了？）
>
> This is most effective for algorithms where the same operation is used, but
> different parameters are bound to it (many times).
> 对于使用不同参数（多次）调用同一操作的算法，这是非常有效的。
>
> It is legal for a parameter to not match the predefined information; the
> implementation should compensate, possibly with a loss of efficiency.
> 实际的参数与预先指定的信息不一致是合法的，实现应当予以兼容（可能会以损失效率的方式）。
>
> ...execute it against all parameter sequences or mappings found in the
> sequence seq_of_parameters.
> 然后使用seq_of_parameters序列中的所有参数序列(或者映射)将其执行
>
> （这几段都翻得很难受...不知道有没有更通顺准确的译文）
>
> The method should try to fetch as many rows as indicated by the size
> parameter. If this is not possible due to the specified number of rows not
> being available, fewer rows may be returned.
> 此方法应当（从结果集中）获取size参数指定数量的若干行。如果无法获得足够数量，应返回尽可能多的行。
>
> （怎么翻都觉得绕口...尽管已经有些意译了）
>
> It defaults to 1 meaning to fetch a single row at a time.
> 默认值为1，表示每次只获取一行。
>
> （是指arraysize属性的默认值应该是1，还是说"如果"是1则如何如何？）
>
>  Implementations must observe this value with respect to the fetchmany()
> method, but are free to interact with the database a single row at a time.
> fetchmany()方法的实现必须遵循这个值,但与数据库的实际交互可以逐行进行。
>
> （还是说arraysize属性，后半句总觉得翻不到位）
>
> .setoutputsize(size[,column])
>  Set a column buffer size for fetches of large columns (e.g. LONGs, BLOBs,
> etc.). The column is specified as an index into the result sequence. Not
> specifying the column will set the default size for all large columns in the
> cursor.
>  设定列缓冲区大小，用于对大体积的列（例如，LONGs，BLOBs等等）
> 的获取。column参数指定了结果序列中的一个索引序号。如果不指定column参数，则对于游标中所有大体积的列，（缓冲区）都将被设置
> 成默认的大小。
>
> （这个概念不太理解，凭感觉翻的，哪位能详细解说一下这个buffer是怎么工作的？）
>
> A Cursor Object's description attribute returns information about each of
> the result columns of a query. The type_code must compare equal to one of
> Type Objects defined below. Type Objects may be equal to more than one type
> code ( e.g. DATETIME could be equal to the type codes for date, time and
> timestamp columns; see the
> Implementation Hints below for details).
> Cursor对象的description属性返回一个查询操作的结果中每一列的信息。其类型代码（type_code值）必须等价于（compare
> equal
> to）以下定义的某一Type对象。同一Type对象可以等价于多种类型代码（例如，DATETIME可以等价于date，time或者
> timestamp列的类型代码；详细说明参见下文中"Implementation Hints"一节）。
>
> （"等价于"感觉还不太到位，有更好的翻法吗？）
>
> ===
> 这些只是最没把握的地方，相信文中还有更多的错误...
>
>
>
> _______________________________________________
> python-chinese
> Post: send python-chinese在lists.python.cn
> Subscribe: send subscribe to
> python-chinese-request在lists.python.cn
> Unsubscribe: send unsubscribe to
> python-chinese-request在lists.python.cn
> Detail Info:
> http://python.cn/mailman/listinfo/python-chinese
>
>