Appendix A. PostgreSQL 错误码

PostgreSQL 服务器发出的所有消息都赋予了五个字符 的错误代码, 这些代码遵循 SQL 的 "SQLSTATE" 代码的习惯。需要知道发生了什么错误条件的应用通常应该测试错误代码, 而不是查看文本错误信息。这些错误 代码轻易不会随着 PostgreSQL 的版本更新而修改, 并且一般也不会随着错误信息的本地化而发生修改。 请注意有些,但不是全部,PostgreSQL 生成的错误代码是由 SQL 标准定义的; 有些标准没有定义的错误条件是我们发明的或者是从其它数据库借来的。

根据标准,错误代码的头两个字符表示错误类别,而后三个字符表示在该 类别内特定的条件。 因此,那些不能识别特定错误代码的应用仍然可以从错误类别中推断要做什么。

Table A-1 里面列出了 PostgreSQL 8.1 定义的所有错误代码。(有些实际上目前并没有使用,但是 SQL 标准定义了。) 错误类别也列出在此。对于每个错误类别都有个"标准"的错误代码, 它的最后三个字符是 000。这个代码只用于那些落在该类别内, 但是没有赋予任何更准确的代码的错误条件。

PL/pgSQL 用于每个错误代码的条件名和表中显示的措辞相同, 只是用下划线代替了空白。比如,代码 22012,DIVISION BY ZERO, 它的条件名是 DIVISION_BY_ZERO。条件名可以用大写或者小写来写都可以。 (请注意 PL/pgSQL 并不识别警告,这一点和错误,条件名正相反; 那些类别是 00,01,和 02。)

Table A-1. PostgreSQL 错误代码

错误代码含义
00 类成功完成
00000成功完成(SUCCESSFUL COMPLETION)
01 类警告
01000警告(WARNING)
0100C返回了动态结果(DYNAMIC RESULT SETS RETURNED)
01008警告,隐含补齐了零比特位(IMPLICIT ZERO BIT PADDING)
01003在集合函数里消除了空值(NULL VALUE ELIMINATED IN SET FUNCTION)
01007没有赋予权限(PRIVILEGE NOT GRANTED)
01006没有撤销权限(PRIVILEGE NOT REVOKED)
01004字串数据在右端截断(STRING DATA RIGHT TRUNCATION)
01P01废弃的特性(DEPRECATED FEATURE)
02 类没有数据 — 按照 SQL 标准的要求,这也是警告类
02000没有数据(NO DATA)
02001返回了没有附加动态结果集(NO ADDITIONAL DYNAMIC RESULT SETS RETURNED)
03 类SQL 语句尚未结束
03000SQL 语句尚未结束(SQL STATEMENT NOT YET COMPLETE)
08 类连接例外
08000连接例外(CONNECTION EXCEPTION)
08003连接不存在(CONNECTION DOES NOT EXIST)
08006连接失败(CONNECTION FAILURE)
08001SQL 客户端不能建立 SQL 连接(SQLCLIENT UNABLE TO ESTABLISH SQLCONNECTION)
08004SQL 服务器拒绝建立 SQL 连接(SQLSERVER REJECTED ESTABLISHMENT OF SQLCONNECTION)
08007未知的事务解析(TRANSACTION RESOLUTION UNKNOWN)
08P01违反协议(PROTOCOL VIOLATION)
09 类触发器动作列外
09000触发的动作例外(TRIGGERED ACTION EXCEPTION)
0A 类不支持特性
0A000不支持此特性(FEATURE NOT SUPPORTED)
0B 类非法事务初始化
0B000非法事务初始化(INVALID TRANSACTION INITIATION)
0F 类指示器例外
0F000指示器例外(LOCATOR EXCEPTION)
0F001非法的定位器声明(INVALID LOCATOR SPECIFICATION)
0L 类非法赋权人
0L000非法赋权人(INVALID GRANTOR)
0LP01非法赋权操作(INVALID GRANT OPERATION)
0P 类非法角色声明
0P000非法角色声明(INVALID ROLE SPECIFICATION)
21 类势违反
21000势违反(CARDINALITY VIOLATION)
22 类数据例外
22000数据例外(DATA EXCEPTION)
2202E数组下标错误(ARRAY SUBSCRIPT ERROR)
22021字符不在准备好的范围内(CHARACTER NOT IN REPERTOIRE)
22008日期时间字段溢出(DATETIME FIELD OVERFLOW)
22012被零除(DIVISION BY ZERO)
22005赋值中出错(ERROR IN ASSIGNMENT)
2200B逃逸字符冲突(ESCAPE CHARACTER CONFLICT)
22022指示器溢出(INDICATOR OVERFLOW)
22015内部字段溢出(INTERVAL FIELD OVERFLOW)
2201E对数运算的非法参数(INVALID ARGUMENT FOR LOGARITHM)
2201F指数函数的非法参数(INVALID ARGUMENT FOR POWER FUNCTION)
2201G宽桶函数的非法参数(INVALID ARGUMENT FOR WIDTH BUCKET FUNCTION)
22018类型转换时非法的字符值(INVALID CHARACTER VALUE FOR CAST)
22007非法日期时间格式(INVALID DATETIME FORMAT)
22019非法的逃逸字符(INVALID ESCAPE CHARACTER)
2200D非法的逃逸字节(INVALID ESCAPE OCTET)
22025非法逃逸序列(INVALID ESCAPE SEQUENCE)
22P06非标准使用逃逸字符(NONSTANDARD USE OF ESCAPE CHARACTER)
22010非法指示器参数值(INVALID INDICATOR PARAMETER VALUE)
22020非法限制值(INVALID LIMIT VALUE)
22023非法参数值(INVALID PARAMETER VALUE)
2201B非法正则表达式(INVALID REGULAR EXPRESSION)
22009非法时区显示值(INVALID TIME ZONE DISPLACEMENT VALUE)
2200C非法使用逃逸字符(INVALID USE OF ESCAPE CHARACTER)
2200G最相关类型不匹配(MOST SPECIFIC TYPE MISMATCH)
22004不允许 NULL 值(NULL VALUE NOT ALLOWED)
22002NULL 值不能做指示器参数(NULL VALUE NO INDICATOR PARAMETER)
22003数字值超出范围(NUMERIC VALUE OUT OF RANGE)
22026字串数据长度不匹配(STRING DATA LENGTH MISMATCH)
22001字串数据右边被截断(STRING DATA RIGHT TRUNCATION)
22011抽取子字串错误(SUBSTRING ERROR)
22027截断错误(TRIM ERROR)
22024未结束的 C 字串(UNTERMINATED C STRING)
2200F零长度的字符串(ZERO LENGTH CHARACTER STRING)
22P01浮点例外(FLOATING POINT EXCEPTION)
22P02非法文本表现形式(INVALID TEXT REPRESENTATION)
22P03非法二进制表现形式(INVALID BINARY REPRESENTATION)
22P04错误的 COPY 格式(BAD COPY FILE FORMAT)
22P05不可翻译字符(UNTRANSLATABLE CHARACTER)
23 类违反完整性约束
23000违反完整性约束(INTEGRITY CONSTRAINT VIOLATION)
23001违反限制(RESTRICT VIOLATION)
23502违反非空(NOT NULL VIOLATION)
23503违反外键约束(FOREIGN KEY VIOLATION)
23505违反唯一约束(UNIQUE VIOLATION)
23514违反检查(CHECK VIOLATION)
24 类非法游标状态
24000非法游标状态(INVALID CURSOR STATE)
25 类非法事务状态
25000非法事务状态(INVALID TRANSACTION STATE)
25001活跃的 SQL 状态(ACTIVE SQL TRANSACTION)
25002分支事务已经激活(BRANCH TRANSACTION ALREADY ACTIVE)
25008持有的游标要求同样的隔离级别(HELD CURSOR REQUIRES SAME ISOLATION LEVEL)
25003对分支事务的不恰当的访问方式(INAPPROPRIATE ACCESS MODE FOR BRANCH TRANSACTION)
25004对分支事务的不恰当的隔离级别(INAPPROPRIATE ISOLATION LEVEL FOR BRANCH TRANSACTION)
25005分支事务没有活跃的 SQL 事务(NO ACTIVE SQL TRANSACTION FOR BRANCH TRANSACTION)
25006只读的 SQL 事务(READ ONLY SQL TRANSACTION)
25007不支持混和的模式和数据语句(SCHEMA AND DATA STATEMENT MIXING NOT SUPPORTED)
25P01没有活跃的 SQL 事务(NO ACTIVE SQL TRANSACTION)
25P02在失败的 SQL 事务中(IN FAILED SQL TRANSACTION)
26 类非法 SQL 语句名
26000非法 SQL 语句名(INVALID SQL STATEMENT NAME)
27 类触发的数据改变违规
27000触发的数据改变违规(TRIGGERED DATA CHANGE VIOLATION)
28 类非法授权声明
28000非法授权声明(INVALID AUTHORIZATION SPECIFICATION)
2B 类依然存在依赖的优先级描述符
2B000依然存在依赖的优先级描述符(DEPENDENT PRIVILEGE DESCRIPTORS STILL EXIST)
2BP01依赖性对象仍然存在(DEPENDENT OBJECTS STILL EXIST)
2D 类非法的事务终止
2D000非法的事务终止(INVALID TRANSACTION TERMINATION)
2F 类SQL 过程例外
2F000SQL 过程例外(SQL ROUTINE EXCEPTION)
2F005执行的函数没有返回语句(FUNCTION EXECUTED NO RETURN STATEMENT)
2F002不允许修改 SQL 数据(MODIFYING SQL DATA NOT PERMITTED)
2F003企图使用禁止的 SQL 语句(PROHIBITED SQL STATEMENT ATTEMPTED)
2F004不允许读取 SQL 数据(READING SQL DATA NOT PERMITTED)
34 类非法游标名
34000非法游标名(INVALID CURSOR NAME)
38 类外部过程例外
38000外部过程例外(EXTERNAL ROUTINE EXCEPTION)
38001不允许包含的 SQL (CONTAINING SQL NOT PERMITTED)
38002不允许修改 SQL 数据(MODIFYING SQL DATA NOT PERMITTED)
38003企图使用禁止的 SQL 语句(PROHIBITED SQL STATEMENT ATTEMPTED)
38004不允许读取 SQL 数据(READING SQL DATA NOT PERMITTED)
39 类外部过程调用例外
39000外部过程调用例外(EXTERNAL ROUTINE INVOCATION EXCEPTION)
39001返回了非法的 SQLSTATE(INVALID SQLSTATE RETURNED)
39004不允许空值(NULL VALUE NOT ALLOWED)
39P01违反触发器协议(TRIGGER PROTOCOL VIOLATED)
39P02违反SRF协议(SRF PROTOCOL VIOLATED)
3B 类保存点例外
3B000保存点例外(SAVEPOINT EXCEPTION)
3B001无效的保存点声明(INVALID SAVEPOINT SPECIFICATION)
3D 类非法数据库名
3D000非法数据库名(INVALID CATALOG NAME)
3F 类非法模式名
3F000非法模式名(INVALID SCHEMA NAME)
40 类事务回滚
40000事务回滚(TRANSACTION ROLLBACK)
40002违反事务完整性约束(TRANSACTION INTEGRITY CONSTRAINT VIOLATION)
40001串行化失败(SERIALIZATION FAILURE)
40003不知道语句是否结束(STATEMENT COMPLETION UNKNOWN)
40P01侦测到死锁(DEADLOCK DETECTED)
42 类语法错误或者违反访问规则
42000语法错误或者违反访问规则(SYNTAX ERROR OR ACCESS RULE VIOLATION)
42601语法错误(SYNTAX ERROR)
42501权限不够(INSUFFICIENT PRIVILEGE)
42846无法进行类型转换(CANNOT COERCE)
42803分组错误(GROUPING ERROR)
42830非法的外键(INVALID FOREIGN KEY)
42602非法名字(INVALID NAME)
42622名字太长(NAME TOO LONG)
42939保留名字(RESERVED NAME)
42804数据类型不匹配(DATATYPE MISMATCH)
42P18未决的数据类型(INDETERMINATE DATATYPE)
42809错误的对象类型(WRONG OBJECT TYPE)
42703未定义的字段(UNDEFINED COLUMN)
42883未定义的函数(UNDEFINED FUNCTION)
42P01未定义的表(UNDEFINED TABLE)
42P02未定义的参数(UNDEFINED PARAMETER)
42704未定义对象(UNDEFINED OBJECT)
42701重复的字段(DUPLICATE COLUMN)
42P03重复的游标(DUPLICATE CURSOR)
42P04重复的数据库(DUPLICATE DATABASE))
42723重复的函数(DUPLICATE FUNCTION)
42P05重复的准备好语句(DUPLICATE PREPARED STATEMENT)
42P06重复的模式(DUPLICATE SCHEMA)
42P07重复的表(DUPLICATE TABLE)
42712重复的别名(DUPLICATE ALIAS)
42710重复的对象(DUPLICATE OBJECT)
42702模糊的字段(AMBIGUOUS COLUMN)
42725模糊的函数(AMBIGUOUS FUNCTION)
42P08模糊的参数(AMBIGUOUS PARAMETER)
42P09模糊的别名(AMBIGUOUS ALIAS)
42P10非法字段引用(INVALID COLUMN REFERENCE)
42611非法字段定义(INVALID COLUMN DEFINITION)
42P11非法游标定义(INVALID CURSOR DEFINITION)
42P12非法的数据库定义(INVALID DATABASE DEFINITION)
42P13非法函数定义(INVALID FUNCTION DEFINITION)
42P14非法准备好语句定义(INVALID PREPARED STATEMENT DEFINITION)
42P15非法模式定义(INVALID SCHEMA DEFINITION)
42P16非法表定义(INVALID TABLE DEFINITION)
42P17非法对象定义(INVALID OBJECT DEFINITION)
44 类违反 WITH CHECK 选项
44000违反 WITH CHECK 选项(WITH CHECK OPTION VIOLATION)
53 类资源不够
53000资源不够(INSUFFICIENT RESOURCES)
53100磁盘满(DISK FULL)
53200内存耗尽(OUT OF MEMORY)
53300太多连接(TOO MANY CONNECTIONS)
54 类超过程序限制
54000超过程序限制(PROGRAM LIMIT EXCEEDED)
54001语句太复杂(STATEMENT TOO COMPLEX)
54011太多字段(TOO MANY COLUMNS)
54023参数太多(TOO MANY ARGUMENTS)
55 类对象不在预先要求的状态
55000对象不在预先要求的状态(OBJECT NOT IN PREREQUISITE STATE)
55006对象在使用中(OBJECT IN USE)
55P02无法修改运行时参数(CANT CHANGE RUNTIME PARAM)
55P03锁不可获得(LOCK NOT AVAILABLE)
57 类操作者干涉
57000操作者干涉(OPERATOR INTERVENTION)
57014查询被取消(QUERY CANCELED)
57P01管理员关机(ADMIN SHUTDOWN)
57P02崩溃关机(CRASH SHUTDOWN)
57P03现在无法连接(CANNOT CONNECT NOW)
58 类系统错误( PostgreSQL 自己内部的错误)
58030IO 错误(IO ERROR)
58P01未定义的文件(UNDEFINED FILE)
58P02重复的文件(DUPLICATE FILE)
F0 类配置文件错误
F0000配置文件错误(CONFIG FILE ERROR)
F0001锁文件存在(LOCK FILE EXISTS)
P0 类PL/pgSQL 错误
P0000PLPGSQL 错误(PLPGSQL ERROR)
P0001抛出例外(RAISE EXCEPTION)
XX 类内部错误
XX000内部错误(INTERNAL ERROR)
XX001数据损坏(DATA CORRUPTED)
XX002索引损坏(INDEX CORRUPTED)