{"Entry":{"collection":"sqlstate","key":"55P04","name":"55P04","aliases":[],"metadata":{"aliases":[],"case_count":0,"class_code":"55","condition_name":"unsafe_new_enum_value_usage","condition_names":["unsafe_new_enum_value_usage"],"content_hash":"0346c9939b6c3f0f401c571fc7c911d2a112de5fcf445e0200f01f0b989e7d55","depth":"reference","editorial_review":"reviewed","evidence_tier":"source_path_confirmed","imported_at":"2026-09-30T17:45:27.89306+08:00","introduced":null,"known_present_by":"12.0","macros":["ERRCODE_UNSAFE_NEW_ENUM_VALUE_USAGE"],"name_zh":"","present_in":["12","13","14","15","16","17","18","19"],"preview_in":["19"],"primary_macro":"ERRCODE_UNSAFE_NEW_ENUM_VALUE_USAGE","removed":null,"runtime_verification":"not_run","severity_classes":["E"],"snippet_count":0,"source_rev":"english-manuals:746a28d1b80c46fde5495338e98da7761a6b4b28687c9c5e41b6a14f698e70b9","sqlstate":"55P04","status":"active","summary_zh":"同一事务中使用了尚未提交的新增 enum 值。"}},"Definition":{"Collection":"sqlstate","Key":"55P04","SourceDatabase":"center","Version":"18","SourceTable":"sqlstate","SourceKey":"55P04","SourceRevision":"english-manuals:746a28d1b80c46fde5495338e98da7761a6b4b28687c9c5e41b6a14f698e70b9","Facts":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"56dacf78e618ff0fd8c533e05db597b80d7ebbad7f8e512a888217d0640aa328","slug":"18"},"lang":"en","sqlstate":"55P04"},"ManualEvidence":{"doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"56dacf78e618ff0fd8c533e05db597b80d7ebbad7f8e512a888217d0640aa328","slug":"18"}},"MeasuredEvidence":{}},"Text":{"Collection":"sqlstate","Key":"55P04","SourceDatabase":"center","Version":"","Locale":"zh-Hans","Title":"55P04 — unsafe_new_enum_value_usage","Summary":"同一事务中使用了尚未提交的新增 enum 值。","BodyHTML":"\u003ch1\u003e55P04\u003c/h1\u003e\n\u003ch2\u003e速览 {#at-a-glance}\u003c/h2\u003e\n\u003cp\u003e\u003ccode\u003e55P04\u003c/code\u003e 保护“新加入的 enum 值必须先提交再使用”的规则。它发生在 PostgreSQL 找到仍未提交且被标记为不安全的 enum tuple 后，不是标签语法错误。\u003c/p\u003e\n\u003ch2\u003e含义 {#meaning}\u003c/h2\u003e\n\u003cp\u003e固定 \u003ccode\u003eenum.c\u003c/code\u003e guard 先接受已经标记为 committed 的 tuple，再直接检查 tuple 的事务 ID；如果该值不在 \u003ccode\u003eEnumUncommitted()\u003c/code\u003e 列表中，也会接受，因为它不可能比所属类型存活更短。只有剩余的未提交新值才会报此码。因此，同一未提交事务中的 \u003ccode\u003eALTER TYPE ... ADD VALUE\u003c/code\u003e 与使用新标签可能触发 \u003ccode\u003e55P04\u003c/code\u003e，已经提交的标签则不会触发这条 guard。\u003c/p\u003e\n\u003ch2\u003e消息 {#messages}\u003c/h2\u003e\n\u003cul\u003e\n\u003cli\u003ePrimary 模板：\u003ccode\u003eunsafe use of new value \u0026#34;%s\u0026#34; of enum type %s\u003c/code\u003e\u003c/li\u003e\n\u003cli\u003eDetail：本调用组没有 detail。\u003c/li\u003e\n\u003cli\u003eHint：\u003ccode\u003eNew enum values must be committed before they can be used.\u003c/code\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e两个 \u003ccode\u003e%s\u003c/code\u003e 分别是 enum 标签和格式化后的 enum 类型名，只提供诊断信息，不是值格式规则。\u003c/p\u003e\n\u003ch2\u003e诊断 {#diagnosis}\u003c/h2\u003e\n\u003cp\u003e保留 enum 标签、类型名、SQLSTATE、severity 和事务状态，检查该值是否由同一仍未提交的事务刚刚加入，以及失败使用是否是 enum input/cast 或解析为该 enum 的其他表达式。把这个 guard 与无效 enum 标签（\u003ccode\u003e22P02\u003c/code\u003e）区分开；\u003ccode\u003e22P04\u003c/code\u003e 是 COPY 文件格式条件，不是这条 enum guard。还要与重复 \u003ccode\u003eADD VALUE\u003c/code\u003e 区分。\u003c/p\u003e\n\u003ch2\u003e处理 {#response}\u003c/h2\u003e\n\u003cp\u003e先从 \u003ccode\u003eERROR\u003c/code\u003e 恢复事务：执行 \u003ccode\u003eROLLBACK\u003c/code\u003e；若 savepoint 的位置合适、能够保留此前的 \u003ccode\u003eADD VALUE\u003c/code\u003e，则执行 \u003ccode\u003eROLLBACK TO SAVEPOINT\u003c/code\u003e。新增值仍未提交时不能使用。如果完整回滚或回滚到 savepoint 已丢弃 \u003ccode\u003eADD VALUE\u003c/code\u003e，就在新事务中重新执行并 \u003ccode\u003eCOMMIT\u003c/code\u003e；若 savepoint 保留了它，也要先提交该事务，再在能看到已提交 catalog 行的事务中使用新标签。autocommit 下修正提交边界后重试输入，不要重复同一未提交流程。\u003c/p\u003e\n\u003ch2\u003e版本 {#versions}\u003c/h2\u003e\n\u003cp\u003e锁定目录从 12.0 记录此条件；固定源码覆盖 PostgreSQL 18.6。目录边界不表示更早不存在私有或未解析实现。\u003c/p\u003e\n\u003ch2\u003e相关 {#related}\u003c/h2\u003e\n\u003cp\u003e\u003ca href=\"/wiki/sqlstate/22P02/\" rel=\"nofollow\"\u003e\u003ccode\u003e22P02\u003c/code\u003e\u003c/a\u003e、\u003ca href=\"/wiki/sqlstate/25006/\" rel=\"nofollow\"\u003e\u003ccode\u003e25006\u003c/code\u003e\u003c/a\u003e、\u003ca href=\"/wiki/sqlstate/23505/\" rel=\"nofollow\"\u003e\u003ccode\u003e23505\u003c/code\u003e\u003c/a\u003e\u003c/p\u003e\n\u003ch2\u003e来源 {#sources}\u003c/h2\u003e\n\u003cp\u003e\u003ca href=\"https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/enum.c#L68\" rel=\"nofollow\"\u003esrc/backend/utils/adt/enum.c#L68-102\u003c/a\u003e\u003c/p\u003e\n\u003cp\u003e结构化\u003ca href=\"#sources\" rel=\"nofollow\"\u003e证据记录\u003c/a\u003e保存精确 guard 和消息组；未声称有自然运行案例。\u003c/p\u003e\n","SourceRevision":"english-manuals:746a28d1b80c46fde5495338e98da7761a6b4b28687c9c5e41b6a14f698e70b9","ContentHash":"ced0a5e6a4e98d7233004286c78ec9db18f9ec52bea1649371f7b4ffcaeb3a40","Payload":{"body_md":"# 55P04\n\n## 速览 {#at-a-glance}\n\n`55P04` 保护“新加入的 enum 值必须先提交再使用”的规则。它发生在 PostgreSQL 找到仍未提交且被标记为不安全的 enum tuple 后，不是标签语法错误。\n\n\n## 含义 {#meaning}\n\n固定 `enum.c` guard 先接受已经标记为 committed 的 tuple，再直接检查 tuple 的事务 ID；如果该值不在 `EnumUncommitted()` 列表中，也会接受，因为它不可能比所属类型存活更短。只有剩余的未提交新值才会报此码。因此，同一未提交事务中的 `ALTER TYPE ... ADD VALUE` 与使用新标签可能触发 `55P04`，已经提交的标签则不会触发这条 guard。\n\n## 消息 {#messages}\n\n- Primary 模板：`unsafe use of new value \"%s\" of enum type %s`\n- Detail：本调用组没有 detail。\n- Hint：`New enum values must be committed before they can be used.`\n\n两个 `%s` 分别是 enum 标签和格式化后的 enum 类型名，只提供诊断信息，不是值格式规则。\n\n## 诊断 {#diagnosis}\n\n保留 enum 标签、类型名、SQLSTATE、severity 和事务状态，检查该值是否由同一仍未提交的事务刚刚加入，以及失败使用是否是 enum input/cast 或解析为该 enum 的其他表达式。把这个 guard 与无效 enum 标签（`22P02`）区分开；`22P04` 是 COPY 文件格式条件，不是这条 enum guard。还要与重复 `ADD VALUE` 区分。\n\n## 处理 {#response}\n\n先从 `ERROR` 恢复事务：执行 `ROLLBACK`；若 savepoint 的位置合适、能够保留此前的 `ADD VALUE`，则执行 `ROLLBACK TO SAVEPOINT`。新增值仍未提交时不能使用。如果完整回滚或回滚到 savepoint 已丢弃 `ADD VALUE`，就在新事务中重新执行并 `COMMIT`；若 savepoint 保留了它，也要先提交该事务，再在能看到已提交 catalog 行的事务中使用新标签。autocommit 下修正提交边界后重试输入，不要重复同一未提交流程。\n\n## 版本 {#versions}\n\n锁定目录从 12.0 记录此条件；固定源码覆盖 PostgreSQL 18.6。目录边界不表示更早不存在私有或未解析实现。\n\n## 相关 {#related}\n\n[`22P02`](/wiki/sqlstate/22P02/)、[`25006`](/wiki/sqlstate/25006/)、[`23505`](/wiki/sqlstate/23505/)\n\n## 来源 {#sources}\n\n[src/backend/utils/adt/enum.c#L68-102](https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/enum.c#L68)\n\n结构化[证据记录](#sources)保存精确 guard 和消息组；未声称有自然运行案例。\n","description":"PostgreSQL SQLSTATE 55P04 的来源与诊断参考。","is_stale":false,"name":"","sections":[{"anchor":"","heading":"","html":"\u0026lt;h1\u0026gt;55P04\u0026lt;/h1\u0026gt;"},{"anchor":"at-a-glance","heading":"速览","html":"\u003cp\u003e\u003ccode\u003e55P04\u003c/code\u003e 保护“新加入的 enum 值必须先提交再使用”的规则。它发生在 PostgreSQL 找到仍未提交且被标记为不安全的 enum tuple 后，不是标签语法错误。\u003c/p\u003e"},{"anchor":"meaning","heading":"含义","html":"\u003cp\u003e固定 \u003ccode\u003eenum.c\u003c/code\u003e guard 先接受已经标记为 committed 的 tuple，再直接检查 tuple 的事务 ID；如果该值不在 \u003ccode\u003eEnumUncommitted()\u003c/code\u003e 列表中，也会接受，因为它不可能比所属类型存活更短。只有剩余的未提交新值才会报此码。因此，同一未提交事务中的 \u003ccode\u003eALTER TYPE ... ADD VALUE\u003c/code\u003e 与使用新标签可能触发 \u003ccode\u003e55P04\u003c/code\u003e，已经提交的标签则不会触发这条 guard。\u003c/p\u003e"},{"anchor":"messages","heading":"消息","html":"\u003cul\u003e\n\u003cli\u003ePrimary 模板：\u003ccode\u003eunsafe use of new value \"%s\" of enum type %s\u003c/code\u003e\u003c/li\u003e\n\u003cli\u003eDetail：本调用组没有 detail。\u003c/li\u003e\n\u003cli\u003eHint：\u003ccode\u003eNew enum values must be committed before they can be used.\u003c/code\u003e\u003c/li\u003e\n\u003c/ul\u003e\n\u003cp\u003e两个 \u003ccode\u003e%s\u003c/code\u003e 分别是 enum 标签和格式化后的 enum 类型名，只提供诊断信息，不是值格式规则。\u003c/p\u003e"},{"anchor":"diagnosis","heading":"诊断","html":"\u003cp\u003e保留 enum 标签、类型名、SQLSTATE、severity 和事务状态，检查该值是否由同一仍未提交的事务刚刚加入，以及失败使用是否是 enum input/cast 或解析为该 enum 的其他表达式。把这个 guard 与无效 enum 标签（\u003ccode\u003e22P02\u003c/code\u003e）区分开；\u003ccode\u003e22P04\u003c/code\u003e 是 COPY 文件格式条件，不是这条 enum guard。还要与重复 \u003ccode\u003eADD VALUE\u003c/code\u003e 区分。\u003c/p\u003e"},{"anchor":"response","heading":"处理","html":"\u003cp\u003e先从 \u003ccode\u003eERROR\u003c/code\u003e 恢复事务：执行 \u003ccode\u003eROLLBACK\u003c/code\u003e；若 savepoint 的位置合适、能够保留此前的 \u003ccode\u003eADD VALUE\u003c/code\u003e，则执行 \u003ccode\u003eROLLBACK TO SAVEPOINT\u003c/code\u003e。新增值仍未提交时不能使用。如果完整回滚或回滚到 savepoint 已丢弃 \u003ccode\u003eADD VALUE\u003c/code\u003e，就在新事务中重新执行并 \u003ccode\u003eCOMMIT\u003c/code\u003e；若 savepoint 保留了它，也要先提交该事务，再在能看到已提交 catalog 行的事务中使用新标签。autocommit 下修正提交边界后重试输入，不要重复同一未提交流程。\u003c/p\u003e"},{"anchor":"versions","heading":"版本","html":"\u003cp\u003e锁定目录从 12.0 记录此条件；固定源码覆盖 PostgreSQL 18.6。目录边界不表示更早不存在私有或未解析实现。\u003c/p\u003e"},{"anchor":"related","heading":"相关","html":"\u003cp\u003e\u003ca href=\"/wiki/sqlstate/22P02/\"\u003e\u003ccode\u003e22P02\u003c/code\u003e\u003c/a\u003e、\u003ca href=\"/wiki/sqlstate/25006/\"\u003e\u003ccode\u003e25006\u003c/code\u003e\u003c/a\u003e、\u003ca href=\"/wiki/sqlstate/23505/\"\u003e\u003ccode\u003e23505\u003c/code\u003e\u003c/a\u003e\u003c/p\u003e"},{"anchor":"sources","heading":"来源","html":"\u003cp\u003e\u003ca href=\"https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/enum.c#L68\"\u003esrc/backend/utils/adt/enum.c#L68-102\u003c/a\u003e\u003c/p\u003e\n\u003cp\u003e结构化\u003ca href=\"#sources\"\u003e证据记录\u003c/a\u003e保存精确 guard 和消息组；未声称有自然运行案例。\u003c/p\u003e"}],"summary":"同一事务中使用了尚未提交的新增 enum 值。","title":"55P04 — unsafe_new_enum_value_usage","translation_source_rev":"77d0e3a214f0bf6387213622f80a65a932d09315d7d01ad68d708d5de6f2a4a0"}},"RequestedLocale":"zh-Hans","Fallback":false,"Versions":["12","13","14","15","16","17","18","19","20"],"Locales":["en","zh-Hans"],"Signatures":null,"Spellings":null,"SQLState":{"aliases":[],"catalogue_notes":{"earliest_observed":"12.0","formal_scope":"9.0.0..18.6","latest_observed":"18.6","matrix_scope":["9.0.23","9.1.24","9.2.24","9.3.25","9.4.26","9.5.25","9.6.24","10.23","11.22","12.22","13.23","14.24","15.19","16.15","17.11","18.6"],"pre9_scope":{"formal_tag_count":191,"maximum_release":"8.4.22","minimum_release":"7.0.0","source_definition_count":153,"source_doc_count":153,"source_file_count":306,"source_scope":"7.4..8.4 definition files; 7.0..7.3 candidate-path source gap probes","source_tag_count":153},"pre9_status":"not_observed","preview_scope":["19beta3"]},"class":"55","class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","condition_names":["unsafe_new_enum_value_usage"],"definition_changes":[],"english_manuals":{"12":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"1444bd6a138537cd75be88a220ee9472ac528f0cfc58758e49636d85455efe98","slug":"12"},"lang":"en","sqlstate":"55P04"},"13":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"4a3ef8af218e5736dfde8660ba609e84233b6b3bac7e0210ff8724cf1b27b2db","slug":"13"},"lang":"en","sqlstate":"55P04"},"14":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"1c12e83304e0f4ff64c9d98ca5e3007df6756932ed19867a4fa0e0650f6c5751","slug":"14"},"lang":"en","sqlstate":"55P04"},"15":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"2161f58f6e87f6535b3b1f3d4661427bb6765f4f6b074fcc16fac97594b50599","slug":"15"},"lang":"en","sqlstate":"55P04"},"16":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"928e705933d7c3d018ae3fba9d800b34e6325746d157339dce878473c519d100","slug":"16"},"lang":"en","sqlstate":"55P04"},"17":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"868135520af87351e3ea1ba42656111cbd2d157d98e1fef05ea158ac5729d8b1","slug":"17"},"lang":"en","sqlstate":"55P04"},"18":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"56dacf78e618ff0fd8c533e05db597b80d7ebbad7f8e512a888217d0640aa328","slug":"18"},"lang":"en","sqlstate":"55P04"},"19":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"63fb8d1aa9f494eeab9d0f8542a2b673f7746ee41ae2689d19403cb3cc425a5c","slug":"19"},"lang":"en","sqlstate":"55P04"},"20":{"aliases":[],"class_name":"Object Not In Prerequisite State","condition_name":"unsafe_new_enum_value_usage","doc":{"anchor":"ERRCODES-APPENDIX","file":"errcodes-appendix.html","lang":"en","sha256":"0d3f602127cd137cf343b32d5fa78f175eeb6cdcb6353b1f6f998ede6cb7b911","slug":"devel"},"lang":"en","sqlstate":"55P04"}},"history_boundary":{"earliest_observed":"12.0","formal_tag_count":351,"gaps":[{"after":"18.6","before":"18.4","reason":"Non-adjacent release tags or a source gap; no removal is inferred."}],"latest_observed":"18.6","pre_range":{"first_observed":null,"known_lower_bound":null,"last_observed":null,"notes":"No occurrence was observed in the locked 7.4..8.4 definition files. Source gaps for 7.0..7.3 prevent a claim that the code was absent before 7.4.","scanned_formal_release_count":153,"scanned_source_scope":"7.4..8.4 definition files; 7.0..7.3 candidate-path source gap probes","source_gap_majors":["7.0","7.1","7.2","7.3"],"status":"partially_scanned"},"preview_snapshots":["19beta3"],"scanned_from":"9.0.0","scanned_to":"18.6"},"introduced":null,"known_present_by":"12.0","macros":["ERRCODE_UNSAFE_NEW_ENUM_VALUE_USAGE"],"manual_presence":["12","13","14","15","16","17","18","19","20"],"pre9_first_observed":null,"pre9_introduction_boundary":null,"pre9_last_observed":null,"pre9_presence_intervals":[],"pre9_status":"not_observed","presence_intervals":[{"end":"12.22","end_major":"12","end_tag":"REL_12_22","evidence_count":23,"position":0,"start":"12.0","start_major":"12","start_tag":"REL_12_0"},{"end":"13.23","end_major":"13","end_tag":"REL_13_23","evidence_count":24,"position":1,"start":"13.0","start_major":"13","start_tag":"REL_13_0"},{"end":"14.24","end_major":"14","end_tag":"REL_14_24","evidence_count":25,"position":2,"start":"14.0","start_major":"14","start_tag":"REL_14_0"},{"end":"15.19","end_major":"15","end_tag":"REL_15_19","evidence_count":20,"position":3,"start":"15.0","start_major":"15","start_tag":"REL_15_0"},{"end":"16.15","end_major":"16","end_tag":"REL_16_15","evidence_count":16,"position":4,"start":"16.0","start_major":"16","start_tag":"REL_16_0"},{"end":"17.11","end_major":"17","end_tag":"REL_17_11","evidence_count":12,"position":5,"start":"17.0","start_major":"17","start_tag":"REL_17_0"},{"end":"18.4","end_major":"18","end_tag":"REL_18_4","evidence_count":5,"position":6,"start":"18.0","start_major":"18","start_tag":"REL_18_0"},{"end":"18.6","end_major":"18","end_tag":"REL_18_6","evidence_count":1,"position":7,"start":"18.6","start_major":"18","start_tag":"REL_18_6"}],"present_in_snapshots":["12.22","13.23","14.24","15.19","16.15","17.11","18.6","19beta3"],"preview_in_snapshots":["19beta3"],"primary_macro":"ERRCODE_UNSAFE_NEW_ENUM_VALUE_USAGE","removed":null,"schema_version":2,"severity_classes":["E"],"sources":[{"blob_id":"sha256:943259f3e36af1343dd0f090f7c7cec0e8c762b038d68c178aaa9b1b11999bfb","channel":"formal","code_count":257,"commit":"ad1f2885b8c82e0c2d56d7974f012cbecce17a17","id":"postgresql:REL_12_0:src/backend/utils/errcodes.txt","major":"12","parsed_path":"raw/definitions/REL_12_0.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_12_0.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/ad1f2885b8c82e0c2d56d7974f012cbecce17a17/src/backend/utils/errcodes.txt","record_count":263,"release":"12.0","release_date":null,"repository":"https://github.com/postgres/postgres.git","sha256":"943259f3e36af1343dd0f090f7c7cec0e8c762b038d68c178aaa9b1b11999bfb","size":33114,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_12_0","url":"https://github.com/postgres/postgres/blob/ad1f2885b8c82e0c2d56d7974f012cbecce17a17/src/backend/utils/errcodes.txt","version":"12.0"},{"blob_id":"sha256:9a464a3c3c99d2488782d4cdd0d46ce261085a944cb0c21e2d884586fbc8204d","channel":"formal","code_count":258,"commit":"29be9983a64c011eac0b9ee29895cce71e15ea77","id":"postgresql:REL_13_0:src/backend/utils/errcodes.txt","major":"13","parsed_path":"raw/definitions/REL_13_0.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_13_0.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/29be9983a64c011eac0b9ee29895cce71e15ea77/src/backend/utils/errcodes.txt","record_count":264,"release":"13.0","release_date":null,"repository":"https://github.com/postgres/postgres.git","sha256":"9a464a3c3c99d2488782d4cdd0d46ce261085a944cb0c21e2d884586fbc8204d","size":33239,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_13_0","url":"https://github.com/postgres/postgres/blob/29be9983a64c011eac0b9ee29895cce71e15ea77/src/backend/utils/errcodes.txt","version":"13.0"},{"blob_id":"sha256:c3c967fa20577f7ded946cb99e1a4706b85bb2476fd32d7e4a133c971a603552","channel":"formal","code_count":259,"commit":"86a4dc1e6f29d1992a2afa3fac1a0b0a6e84568c","id":"postgresql:REL_14_0:src/backend/utils/errcodes.txt","major":"14","parsed_path":"raw/definitions/REL_14_0.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_14_0.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/86a4dc1e6f29d1992a2afa3fac1a0b0a6e84568c/src/backend/utils/errcodes.txt","record_count":265,"release":"14.0","release_date":null,"repository":"https://github.com/postgres/postgres.git","sha256":"c3c967fa20577f7ded946cb99e1a4706b85bb2476fd32d7e4a133c971a603552","size":33337,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_14_0","url":"https://github.com/postgres/postgres/blob/86a4dc1e6f29d1992a2afa3fac1a0b0a6e84568c/src/backend/utils/errcodes.txt","version":"14.0"},{"blob_id":"sha256:a34b5fccd8a27c92817314dd942b79e76896cd1d9a8d4be21c81b02227850b4a","channel":"formal","code_count":260,"commit":"2a7ce2e2ce474504a707ec03e128fde66cfb8b48","id":"postgresql:REL_15_0:src/backend/utils/errcodes.txt","major":"15","parsed_path":"raw/definitions/REL_15_0.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_15_0.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/2a7ce2e2ce474504a707ec03e128fde66cfb8b48/src/backend/utils/errcodes.txt","record_count":266,"release":"15.0","release_date":null,"repository":"https://github.com/postgres/postgres.git","sha256":"a34b5fccd8a27c92817314dd942b79e76896cd1d9a8d4be21c81b02227850b4a","size":33458,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_15_0","url":"https://github.com/postgres/postgres/blob/2a7ce2e2ce474504a707ec03e128fde66cfb8b48/src/backend/utils/errcodes.txt","version":"15.0"},{"blob_id":"sha256:1d1d741b7b7c6dfd8275287e31c79befed75f3b9349e1a42ef0ca147c429ff88","channel":"formal","code_count":260,"commit":"c372fbbd8e911f2412b80a8c39d7079366565d67","id":"postgresql:REL_16_0:src/backend/utils/errcodes.txt","major":"16","parsed_path":"raw/definitions/REL_16_0.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_16_0.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/c372fbbd8e911f2412b80a8c39d7079366565d67/src/backend/utils/errcodes.txt","record_count":266,"release":"16.0","release_date":null,"repository":"https://github.com/postgres/postgres.git","sha256":"1d1d741b7b7c6dfd8275287e31c79befed75f3b9349e1a42ef0ca147c429ff88","size":33458,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_16_0","url":"https://github.com/postgres/postgres/blob/c372fbbd8e911f2412b80a8c39d7079366565d67/src/backend/utils/errcodes.txt","version":"16.0"},{"blob_id":"sha256:bb53279934510355eb4135a807c90d989f07650bd90f87026a4441f11d3296b1","channel":"formal","code_count":260,"commit":"d7ec59a63d745ba74fba0e280bbf85dc6d1caa3e","id":"postgresql:REL_17_0:src/backend/utils/errcodes.txt","major":"17","parsed_path":"raw/definitions/REL_17_0.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_17_0.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/d7ec59a63d745ba74fba0e280bbf85dc6d1caa3e/src/backend/utils/errcodes.txt","record_count":266,"release":"17.0","release_date":null,"repository":"https://github.com/postgres/postgres.git","sha256":"bb53279934510355eb4135a807c90d989f07650bd90f87026a4441f11d3296b1","size":33392,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_17_0","url":"https://github.com/postgres/postgres/blob/d7ec59a63d745ba74fba0e280bbf85dc6d1caa3e/src/backend/utils/errcodes.txt","version":"17.0"},{"blob_id":"sha256:6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba","channel":"formal","code_count":262,"commit":"3d6a828938a5fa0444275d3d2f67b64ec3199eb7","id":"postgresql:REL_18_0:src/backend/utils/errcodes.txt","major":"18","parsed_path":"raw/definitions/REL_18_0.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_18_0.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/3d6a828938a5fa0444275d3d2f67b64ec3199eb7/src/backend/utils/errcodes.txt","record_count":268,"release":"18.0","release_date":null,"repository":"https://github.com/postgres/postgres.git","sha256":"6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba","size":33739,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_18_0","url":"https://github.com/postgres/postgres/blob/3d6a828938a5fa0444275d3d2f67b64ec3199eb7/src/backend/utils/errcodes.txt","version":"18.0"},{"blob_id":"sha256:cadb9e83cde9a8699a7e74448891ca623af8579ccc8e11c7e533fb47cbc42f89","channel":"preview","code_count":262,"commit":"3638289fb57bdabec00deda98ee9624a35f5d66a","id":"postgresql:REL_19_BETA3:src/backend/utils/errcodes.txt","major":"19","parsed_path":"raw/definitions/REL_19_BETA3.parsed.json","path":"src/backend/utils/errcodes.txt","raw_path":"raw/definitions/REL_19_BETA3.txt","raw_url":"https://raw.githubusercontent.com/postgres/postgres/3638289fb57bdabec00deda98ee9624a35f5d66a/src/backend/utils/errcodes.txt","record_count":268,"release":"19beta3","release_date":"2026-08-13","repository":"https://github.com/postgres/postgres.git","sha256":"cadb9e83cde9a8699a7e74448891ca623af8579ccc8e11c7e533fb47cbc42f89","size":33739,"source_format":"errcodes.txt","source_role":"primary_definition","tag":"REL_19_BETA3","url":"https://github.com/postgres/postgres/blob/3638289fb57bdabec00deda98ee9624a35f5d66a/src/backend/utils/errcodes.txt","version":"19beta3"}],"sqlstate":"55P04","status":"active","usage_evidence":[{"evidence_ids":["postgresql:REL_12_0:src/backend/utils/errcodes.txt","postgresql:REL_12_10:src/backend/utils/errcodes.txt","postgresql:REL_12_11:src/backend/utils/errcodes.txt","postgresql:REL_12_12:src/backend/utils/errcodes.txt","postgresql:REL_12_13:src/backend/utils/errcodes.txt","postgresql:REL_12_14:src/backend/utils/errcodes.txt","postgresql:REL_12_15:src/backend/utils/errcodes.txt","postgresql:REL_12_16:src/backend/utils/errcodes.txt","postgresql:REL_12_17:src/backend/utils/errcodes.txt","postgresql:REL_12_18:src/backend/utils/errcodes.txt","postgresql:REL_12_19:src/backend/utils/errcodes.txt","postgresql:REL_12_1:src/backend/utils/errcodes.txt","postgresql:REL_12_20:src/backend/utils/errcodes.txt","postgresql:REL_12_21:src/backend/utils/errcodes.txt","postgresql:REL_12_22:src/backend/utils/errcodes.txt","postgresql:REL_12_2:src/backend/utils/errcodes.txt","postgresql:REL_12_3:src/backend/utils/errcodes.txt","postgresql:REL_12_4:src/backend/utils/errcodes.txt","postgresql:REL_12_5:src/backend/utils/errcodes.txt","postgresql:REL_12_6:src/backend/utils/errcodes.txt","postgresql:REL_12_7:src/backend/utils/errcodes.txt","postgresql:REL_12_8:src/backend/utils/errcodes.txt","postgresql:REL_12_9:src/backend/utils/errcodes.txt","postgresql:REL_13_0:src/backend/utils/errcodes.txt","postgresql:REL_13_10:src/backend/utils/errcodes.txt","postgresql:REL_13_11:src/backend/utils/errcodes.txt","postgresql:REL_13_12:src/backend/utils/errcodes.txt","postgresql:REL_13_13:src/backend/utils/errcodes.txt","postgresql:REL_13_14:src/backend/utils/errcodes.txt","postgresql:REL_13_15:src/backend/utils/errcodes.txt","postgresql:REL_13_16:src/backend/utils/errcodes.txt","postgresql:REL_13_17:src/backend/utils/errcodes.txt","postgresql:REL_13_18:src/backend/utils/errcodes.txt","postgresql:REL_13_19:src/backend/utils/errcodes.txt","postgresql:REL_13_1:src/backend/utils/errcodes.txt","postgresql:REL_13_20:src/backend/utils/errcodes.txt","postgresql:REL_13_21:src/backend/utils/errcodes.txt","postgresql:REL_13_22:src/backend/utils/errcodes.txt","postgresql:REL_13_23:src/backend/utils/errcodes.txt","postgresql:REL_13_2:src/backend/utils/errcodes.txt","postgresql:REL_13_3:src/backend/utils/errcodes.txt","postgresql:REL_13_4:src/backend/utils/errcodes.txt","postgresql:REL_13_5:src/backend/utils/errcodes.txt","postgresql:REL_13_6:src/backend/utils/errcodes.txt","postgresql:REL_13_7:src/backend/utils/errcodes.txt","postgresql:REL_13_8:src/backend/utils/errcodes.txt","postgresql:REL_13_9:src/backend/utils/errcodes.txt","postgresql:REL_14_0:src/backend/utils/errcodes.txt","postgresql:REL_14_10:src/backend/utils/errcodes.txt","postgresql:REL_14_11:src/backend/utils/errcodes.txt","postgresql:REL_14_12:src/backend/utils/errcodes.txt","postgresql:REL_14_13:src/backend/utils/errcodes.txt","postgresql:REL_14_14:src/backend/utils/errcodes.txt","postgresql:REL_14_15:src/backend/utils/errcodes.txt","postgresql:REL_14_16:src/backend/utils/errcodes.txt","postgresql:REL_14_17:src/backend/utils/errcodes.txt","postgresql:REL_14_18:src/backend/utils/errcodes.txt","postgresql:REL_14_19:src/backend/utils/errcodes.txt","postgresql:REL_14_1:src/backend/utils/errcodes.txt","postgresql:REL_14_20:src/backend/utils/errcodes.txt","postgresql:REL_14_21:src/backend/utils/errcodes.txt","postgresql:REL_14_22:src/backend/utils/errcodes.txt","postgresql:REL_14_23:src/backend/utils/errcodes.txt","postgresql:REL_14_24:src/backend/utils/errcodes.txt","postgresql:REL_14_2:src/backend/utils/errcodes.txt","postgresql:REL_14_3:src/backend/utils/errcodes.txt","postgresql:REL_14_4:src/backend/utils/errcodes.txt","postgresql:REL_14_5:src/backend/utils/errcodes.txt","postgresql:REL_14_6:src/backend/utils/errcodes.txt","postgresql:REL_14_7:src/backend/utils/errcodes.txt","postgresql:REL_14_8:src/backend/utils/errcodes.txt","postgresql:REL_14_9:src/backend/utils/errcodes.txt","postgresql:REL_15_0:src/backend/utils/errcodes.txt","postgresql:REL_15_10:src/backend/utils/errcodes.txt","postgresql:REL_15_11:src/backend/utils/errcodes.txt","postgresql:REL_15_12:src/backend/utils/errcodes.txt","postgresql:REL_15_13:src/backend/utils/errcodes.txt","postgresql:REL_15_14:src/backend/utils/errcodes.txt","postgresql:REL_15_15:src/backend/utils/errcodes.txt","postgresql:REL_15_16:src/backend/utils/errcodes.txt","postgresql:REL_15_17:src/backend/utils/errcodes.txt","postgresql:REL_15_18:src/backend/utils/errcodes.txt","postgresql:REL_15_19:src/backend/utils/errcodes.txt","postgresql:REL_15_1:src/backend/utils/errcodes.txt","postgresql:REL_15_2:src/backend/utils/errcodes.txt","postgresql:REL_15_3:src/backend/utils/errcodes.txt","postgresql:REL_15_4:src/backend/utils/errcodes.txt","postgresql:REL_15_5:src/backend/utils/errcodes.txt","postgresql:REL_15_6:src/backend/utils/errcodes.txt","postgresql:REL_15_7:src/backend/utils/errcodes.txt","postgresql:REL_15_8:src/backend/utils/errcodes.txt","postgresql:REL_15_9:src/backend/utils/errcodes.txt","postgresql:REL_16_0:src/backend/utils/errcodes.txt","postgresql:REL_16_10:src/backend/utils/errcodes.txt","postgresql:REL_16_11:src/backend/utils/errcodes.txt","postgresql:REL_16_12:src/backend/utils/errcodes.txt","postgresql:REL_16_13:src/backend/utils/errcodes.txt","postgresql:REL_16_14:src/backend/utils/errcodes.txt","postgresql:REL_16_15:src/backend/utils/errcodes.txt","postgresql:REL_16_1:src/backend/utils/errcodes.txt","postgresql:REL_16_2:src/backend/utils/errcodes.txt","postgresql:REL_16_3:src/backend/utils/errcodes.txt","postgresql:REL_16_4:src/backend/utils/errcodes.txt","postgresql:REL_16_5:src/backend/utils/errcodes.txt","postgresql:REL_16_6:src/backend/utils/errcodes.txt","postgresql:REL_16_7:src/backend/utils/errcodes.txt","postgresql:REL_16_8:src/backend/utils/errcodes.txt","postgresql:REL_16_9:src/backend/utils/errcodes.txt","postgresql:REL_17_0:src/backend/utils/errcodes.txt","postgresql:REL_17_10:src/backend/utils/errcodes.txt","postgresql:REL_17_11:src/backend/utils/errcodes.txt","postgresql:REL_17_1:src/backend/utils/errcodes.txt","postgresql:REL_17_2:src/backend/utils/errcodes.txt","postgresql:REL_17_3:src/backend/utils/errcodes.txt","postgresql:REL_17_4:src/backend/utils/errcodes.txt","postgresql:REL_17_5:src/backend/utils/errcodes.txt","postgresql:REL_17_6:src/backend/utils/errcodes.txt","postgresql:REL_17_7:src/backend/utils/errcodes.txt","postgresql:REL_17_8:src/backend/utils/errcodes.txt","postgresql:REL_17_9:src/backend/utils/errcodes.txt","postgresql:REL_18_0:src/backend/utils/errcodes.txt","postgresql:REL_18_1:src/backend/utils/errcodes.txt","postgresql:REL_18_2:src/backend/utils/errcodes.txt","postgresql:REL_18_3:src/backend/utils/errcodes.txt","postgresql:REL_18_4:src/backend/utils/errcodes.txt","postgresql:REL_18_6:src/backend/utils/errcodes.txt","postgresql:REL_19_BETA3:src/backend/utils/errcodes.txt"],"notes":"Presence in a PostgreSQL release definition file is established; runtime throw/use scanning is maintained separately.","scope":"release-definition-catalogue","status":"definition_only"},{"evidence_ids":[],"notes":"No occurrence was found in the locked 7.4..8.4 definition files; 7.0..7.3 source gaps remain explicit.","scope":"pre9-definition-history","status":"unknown"}]},"Evidence":[{"Kind":"claims","Ordinal":0,"ID":"identity","ServerVersion":null,"Status":null,"Payload":{"claim_id":"identity","limits":"","method":"Read fixed definition.","position":0,"runtime":[],"sources":["src.errcodes.18.6"],"statement":"55P04 is unsafe_new_enum_value_usage in SQLSTATE Class 55."}},{"Kind":"claims","Ordinal":1,"ID":"resolved-paths","ServerVersion":null,"Status":null,"Payload":{"claim_id":"resolved-paths","limits":"Source confirmation is not natural runtime.","method":"Read complete fixed source context.","position":1,"runtime":[],"sources":["src.path.0"],"statement":"The fixed enum tuple commit and EnumUncommitted guards support the stated commit-before-use mechanism and message."}},{"Kind":"claims","Ordinal":2,"ID":"history","ServerVersion":null,"Status":null,"Payload":{"claim_id":"history","limits":"","method":"Use catalogue boundary.","position":2,"runtime":[],"sources":["src.errcodes.18.6"],"statement":"The locked catalogue records 55P04 from 12.0; that boundary does not prove exact implementation introduction."}},{"Kind":"messages","Ordinal":0,"ID":"message.0","ServerVersion":null,"Status":null,"Payload":{"limits":"","message_id":"message.0","path":"","position":0,"raw":{"hint_template":"New enum values must be committed before they can be used.","id":"message.0","primary_template":"unsafe use of new value \"%s\" of enum type %s","severity_source":"ERROR","sources":["src.path.0"],"sqlstate":"55P04"},"severity":"ERROR","sources":["src.path.0"],"templates":[{"kind":"primary","literal":"unsafe use of new value \" \" of enum type","position":0,"role":"","template":"unsafe use of new value \"%s\" of enum type %s"},{"kind":"hint","literal":"New enum values must be committed before they can be used.","position":1,"role":"","template":"New enum values must be committed before they can be used."}]}},{"Kind":"sources","Ordinal":0,"ID":"src.errcodes.18.6","ServerVersion":null,"Status":null,"Payload":{"commit":"724edf9bde9d356724ad384a2e196edc3c9f80f7","docs_url":"","kind":"upstream_source","location":"","path":"src/backend/utils/errcodes.txt","position":0,"sha256":"6e8de346643ba84aa3c9c6a73360acfc7b2dfb89162c06c08ce9bf5bcd5bbcba","source_id":"src.errcodes.18.6","tag":"REL_18_6","url":"https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/errcodes.txt#L428"}},{"Kind":"sources","Ordinal":1,"ID":"src.path.0","ServerVersion":null,"Status":null,"Payload":{"commit":"724edf9bde9d356724ad384a2e196edc3c9f80f7","docs_url":"","kind":"upstream_source","location":"","path":"src/backend/utils/adt/enum.c","position":1,"sha256":"35c0f1f5376a5c2ef3d7ea52fa26faad84b493b485ed3a9ad5bb5b5eb45928b2","source_id":"src.path.0","tag":"REL_18_6","url":"https://github.com/postgres/postgres/blob/724edf9bde9d356724ad384a2e196edc3c9f80f7/src/backend/utils/adt/enum.c#L68"}}]}