Postgresql 中文操作指南

在你报告错误之前，请阅读并重新阅读文档，以验证你确实可以执行尝试执行的任何操作。如果从文档中无法明确判断你是否可以做某事，请报告该问题；这是文档中的错误。如果某个程序与文档所说的不同，那就是一个错误。这可能包括但不限于以下情况：

此处“程序”指的是任何可执行文件，而不仅仅是后端进程。

运行缓慢或占用大量资源不一定是错误。请阅读文档或在某个邮件列表中提出问题，以获得帮助来调整你的应用程序。如果不符合 SQL 标准也不一定是错误，除非明确声称特定功能的兼容性。

在你继续之前，请查看 TODO 列表和常见问题解答，看看你的错误是否已经知道。如果你无法解码 TODO 列表上的信息，请报告你的问题。我们至少可以明确 TODO 列表。

关于错误报告，要记住的最重要的一点是陈述所有事实，而且只陈述事实。不要猜测你认为出了什么问题，“它似乎做了什么”，或者程序的哪一部分有故障。如果你不熟悉该实施，你可能会猜错，一点儿也帮不了我们。即使你知道，受教育的解释是事实的一个很好补充，但不能代替事实。如果我们要修复该错误，我们仍然必须自己先看到它。报告基本事实相对简单（你或许可以从屏幕上复制粘贴它们），但重要细节经常会被遗漏，因为有人认为它无关紧要或报告会被理解。

以下项目应包含在每个错误报告中：

如果您要报告错误消息，请获取消息的最详细形式。在 psql 中，事先说_\set VERBOSITY verbose_。如果您正在从服务器日志中提取消息，请将运行时参数 log_error_verbosity设置为_verbose_，以便记录所有详细信息。

在发生致命错误的情况下，客户端报告的错误消息可能不包含所有可用信息。请还查看数据库服务器的日志输出。如果您不保留服务器的日志输出，现在是开始这样做的好时机。

如果您的错误报告变得很长，那也没什么可担心的。这是生活中的一个事实。将所有内容都在第一次报告中汇报出来，比我们必须从您那里一点点挤出事实要好。另一方面，如果您的输入文件很大，首先询问一下是否有谁有兴趣对此进行查看到是公平的。以下是一篇 article 提供了更多有关报告错误的提示。

不要花所有时间来弄清楚输入中的哪些更改使问题消失。这可能无助于解决问题。如果事实证明该错误无法立即修复，你仍然有时间找到并分享你的解决方法。同样，不要浪费你的时间猜测为什么存在错误。我们很快就会发现。

在编写错误报告时，请避免混淆术语。软件包称为“PostgreSQL”，有时简称“Postgres”。如果你专门讨论后端进程，请提及它，不要只说“PostgreSQL 崩溃”。单个后端进程崩溃与父“postgres”进程崩溃有很大不同；当你指的是单个后端进程崩溃时，请不要说“服务器崩溃”，反之亦然。此外，客户端程序（如交互式前端“psql”）与后端完全分开。请尝试具体说明问题是在客户端还是在服务器端。

一般来说，将错误报告发送到 < link:mailto:pgsql-bugs@lists.postgresql.org[pgsql-bugs@lists.postgresql.org]> 的错误报告邮件列表。请您为电子邮件信息使用描述性主题，可以是错误消息的一部分。

另一种方法是填写项目 web site 中提供的错误报告网络表单。这样输入错误报告会将其发送到 < link:mailto:pgsql-bugs@lists.postgresql.org[pgsql-bugs@lists.postgresql.org]> 邮件列表。

如果您的错误报告有安全隐患，您希望它不会立即显示在公共存档中，请不要将其发送到 pgsql-bugs 。可以通过电子邮件将安全问题私下报告给 < link:mailto:security@postgresql.org[security@postgresql.org]> 。

不要将错误报告发送到任何用户邮件列表，如 < link:mailto:pgsql-sql@lists.postgresql.org[pgsql-sql@lists.postgresql.org]> 或 < link:mailto:pgsql-general@lists.postgresql.org[pgsql-general@lists.postgresql.org]> 。这些邮件列表用于回答用户问题，并且其订阅者通常不希望收到错误报告。更重要的是，他们不太可能修复它们。

另外，请 not 发送报告到开发人员邮件列表 < link:mailto:pgsql-hackers@lists.postgresql.org[pgsql-hackers@lists.postgresql.org]> 。此列表用于讨论 PostgreSQL 的开发，如果我们能够将错误报告分开，将会很好。如果问题需要更多审查，我们可能会选择在 pgsql-hackers 中讨论您的错误报告。

如果您对文档有任何问题，最好的报告位置是文档邮件列表 < link:mailto:pgsql-docs@lists.postgresql.org[pgsql-docs@lists.postgresql.org]> 。请具体说明您对文档的哪一部分不满意。

如果您的错误是在非受支持平台上的可移植性问题，请发送邮件到 < link:mailto:pgsql-hackers@lists.postgresql.org[pgsql-hackers@lists.postgresql.org]> ，以便我们（以及您）致力于将 PostgreSQL 移植到您的平台。

由于大量垃圾邮件的不幸传播，除非您订阅，否则所有上述列表都将受限。这意味着电子邮件将在交递之前延迟一段时间。如果您希望订阅列表，请访问 https://lists.postgresql.org/获取说明。