附录 A. PostgreSQL 错误代码

PostgreSQL 服务器发出的所有消息都分配有五个字符的错误代码，这些错误代码遵循 SQL 标准对“ SQLSTATE”代码的约定。需要知道发生哪种错误情况的应用程序通常应测试错误代码，而不是查看文本错误消息。错误代码在 PostgreSQL 发行版中不太可能更改，并且也不会由于错误消息的本地化而更改。注意，PostgreSQL 产生的一些但不是全部错误代码是由 SQL 标准定义的。从其他数据库中发明或借用了一些针对该标准未定义的条件的其他错误代码。

根据标准，错误代码的前两个字符表示错误的类别，而后三个字符表示该类别中的特定条件。因此，无法识别特定错误代码的应用程序仍可能能够从错误类中推断出要做什么。

Table A.1列出了 PostgreSQL 10.13 中定义的所有错误代码。 (目前尚不实际使用，但已由 SQL 标准定义.)还显示了错误类。对于每个错误类别，都有一个“标准”错误代码，该代码具有最后三个字符000。该代码仅用于属于该类但没有分配任何更特定代码的错误条件。

“条件名称”列中显示的符号是要在 PL/pgSQL 中使用的条件名称。条件名称可以大写或小写。 (请注意，PL/pgSQL 无法识别警告，而不是错误的条件名称；它们是类 00、01 和 02.)

对于某些类型的错误，服务器报告与该错误关联的数据库对象的名称(表，表列，数据类型或约束)。例如，导致unique_violation错误的唯一约束的名称。这些名称在错误报告消息的单独字段中提供，因此应用程序无需尝试从消息的可能本地化的人类可读文本中提取它们。从 PostgreSQL 9.3 开始，仅针对 SQLSTATE class 23(完整性约束违规)中的错误才存在此功能的完整覆盖范围，但是将来可能会扩大。

表 A.1.PostgreSQL 错误代码