3     Threads may share the module, connections and cursors.
3     不同线程可以共享该模块，Connection对象或Cursor对象
建议：
"或"不妥，"and"者"且"也。

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.

"共享"在以上语境中意味着两个线程可以共用同一资源而不需要用互斥信号量来实现外部的锁机制。注意，你无法用互斥量来保证外部资源的线程安全：因为这些资源可能依赖于你无法控制的全局变量或者其它外部资源。

建议：
因为这份文档是写给Python模块作者看的，所以这里的you，指的也应当是模块作者。
"语境"太过庄重。"cannot always"也不是"无法"，是"并非总能"。我试译如下：
上文的"共享"意为两个线程可以共用同一资源而不需要用互斥信号量来锁定资源。注意，你并非总能用互斥量来……

Warning

            Exception raised for important warnings like data
truncations while inserting, etc.
作为严重警告抛出的异常，例如执行插入语句时数据被截断。
意见：
前半句略嫌繁琐。可简单译作"严重错误，例如……"，后面多有这类句式，宜一体改之。

Exception raised for errors that are related to the database's
operation and not necessarily under the control of the programmer...
探讨：
"not necessarily"，我认为是"不是一定"的意思，译成"无法完全"无大碍。

Note: The values of these exceptions are not defined. They should give
the user a fairly good idea of what went wrong, though.
注意：这些异常的值并未定义，但它们应当尽量让用户对哪里出了错心中有数。

试译：
注意：这里没有定义异常的值，它们应当尽量让用户明了何处出错。

pending transaction
未决的事务
探讨：
未提交的事务


Close the connection now (rather than whenever __del__ is called).
The connection will be unusable from this point forward; an Error (or
subclass) exception will be raised if any operation is attempted with
the connection. The same applies to all cursor objects trying to use
the connection.  Note that closing a connection without committing the
changes first will cause an implicit rollback to be performed.

立即关闭连接（而非等待__del__方法被调用）。连接从此刻起将不可用；如果再尝试任何对此连接的操作，将抛出一个Error（或其子类）的异常。任何试图使用此连接的cursor也将如此。注意，在关闭连接前如果有尚未提交的修改将导致一个隐式的回滚。

探讨：
我这样理解第一句：应该在程序里显式地用.close()关闭一个连接，而__del__调用的时候(gc在回收垃圾的时候)不一定会关闭连接。另外，最后一句"implicit"译作"隐式"固然可以，但稍稍显得绕口。我试译如下：
立即关闭连接（而非任何调用__del__时）。该连接从此不可再用，任何该连接上的操作都将抛出一个Error（或其子类）。任何试图使用此连接的cursor也将如此。注意，在关闭连接时，尚未提交的修改将被悄悄地回滚。

Note that if the database supports an auto-commit feature, this must
be initially off.
注意，如果数据库支持auto-commit功能，必须在初始化时将其关闭。

（initially off的意思拿不太准，是指类库作者应该让auto-commit默认关闭？初始化是指初始化连接对象时？）
探讨：
我认为，这两句疑问的答案都是"对"。
试译：
自动提交功能（如果数据库支持）初始一定是关闭的。

.cursor()
If the database does not provide a direct cursor concept, the module
will have to emulate cursors using other means to the extent needed by
this specification.
如果数据库不支持直接的游标概念，规范要求模块必须用其它方式模拟游标。
建议：
这句译得不够通顺，我试译如下：
如果数据库本身没有游标概念，本规范要求模块必须……

在 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
>
>