DB2异常汇总-中文

### DB2异常汇总知识点 #### 一、概述 在日常操作DB2数据库的过程中，经常会遇到各种各样的问题，其中很多问题都与SQLCODE和SQLState有关。为了更好地理解和解决这些问题，下面将详细介绍一些常见的SQLCODE及其对应的SQLState，并解释它们的意义。 #### 二、SQLCODE与SQLState详解 **SQLCODE**：SQLCODE是一个整数，用于表示SQL语句执行的状态。当SQL语句执行后，DB2会返回一个SQLCODE，通过这个值我们可以判断SQL语句是否成功执行，还是遇到了某种错误或警告。 **SQLState**：SQLState是一个五位字符组成的代码，用于进一步细化SQLCODE的信息，帮助我们理解错误的具体情况。 #### 三、具体SQLCODE与SQLState分析 1. **00000 - SQL语句成功完成** - **SQLState**: 00000 - **说明**: 表示SQL语句执行成功，没有任何问题。 2. **01xxx - SQL语句成功完成但有警告** - **SQLState**: 01xxx - **说明**: 表示SQL语句虽然执行成功，但在执行过程中出现了一些警告信息，需要注意。 3. **+01201545 - 未限定的列名被解释为一个有相互关系的引用** - **SQLState**: 01201 - **说明**: 当SQL语句中的列名没有明确指定表时，DB2可能会将其解释为与其他表相关的列。这种情况通常出现在多表联接的情况下。 4. **+09801568 - 动态SQL语句用分号结束** - **SQLState**: 09801 - **说明**: 在动态SQL语句中，如果语句以分号结尾，则会触发此警告。这种情况下，通常建议去掉末尾的分号。 5. **+10002000 - 没有找到满足SQL语句的行** - **SQLState**: 10002 - **说明**: 查询语句没有返回任何结果，可能是由于WHERE条件过于严格导致。 6. **+11001561 - 使用DATACAPTURE定义的表的更新操作不能发送到原来的子系统** - **SQLState**: 11001 - **说明**: 当使用DATACAPTURE功能时，对于某些表的更新操作无法被发送到原始的子系统中。 7. **+11101590 - 为2型索引设置了SUBPAGES语句** - **SQLState**: 11101 - **说明**: 为2型索引设置了SUBPAGES选项，这通常是不允许的，因为2型索引本身就不支持SUBPAGES。 8. **+11701525 - 要插入的值的个数不等于被插入表的列数** - **SQLState**: 11701 - **说明**: 插入操作中提供的值的数量与表中列的数量不匹配。这种情况下需要检查INSERT语句中的列名和值是否对应正确。 9. **+16201514 - 指定的表空间被置为检查挂起状态** - **SQLState**: 16201 - **说明**: 表空间被设置为CHECK PENDING状态，这通常是因为表空间的一些维护操作尚未完成。 10. **+20301552 - 使用非唯一的名字来解决命名的限定列** - **SQLState**: 20301 - **说明**: 当在一个SELECT语句中使用了非唯一的列名时，DB2无法确定应该选择哪个表中的列。 11. **+20401532 - 命名的对象未在DB2中定义** - **SQLState**: 20401 - **说明**: 尝试引用的对象在数据库中不存在，需要确认对象名称是否正确。 12. **+20601533 - 命名的列不在SQL语句中指定的任何表中存在** - **SQLState**: 20601 - **说明**: SQL语句中引用的某一列在所有指定的表中均不存在。 13. **+21801537 - 因为SQL语句引用一个远程对象，不能为该SQL语句执行EXPLAIN** - **SQLState**: 21801 - **说明**: 当SQL语句涉及到远程对象时，无法为其执行EXPLAIN操作，这通常是因为远程对象的信息不可用。 14. **+21901532 - 命名的PLANTABLE不存在** - **SQLState**: 21901 - **说明**: PLANTABLE是一个特殊类型的表，在尝试使用它时发现其并不存在。 15. **+22001546 - 不正确定义PLANTABLE，检查命名列的定义** - **SQLState**: 22001 - **说明**: PLANTABLE的定义存在问题，可能是在创建时列的定义有误。 16. **+23601005 - SQLDA中的SQLN的值至少应于所描述的列的个数一样大** - **SQLState**: 23601 - **说明**: SQLDA（SQL描述区域）中的SQLN字段值必须与描述的列数量一致。 17. **+23701594 - 至少有一个被描述的列应该是单值类型，因此扩展的SQLVAR条目需要另外的空间** - **SQLState**: 23701 - **说明**: 当使用扩展SQLVAR时，其中至少一个列必须是单值类型。 18. **+23801005 - 至少应有一个被描述的列是一个LOB，因此扩展的SQLVAR条目需要另外的空间** - **SQLState**: 23801 - **说明**: 如果使用扩展SQLVAR描述列，其中至少一个列必须是LOB类型。 19. **+23901005 - 至少应有一个被描述的列应是单值类型，因此扩展的SQLVAR条目需要另外的空间** - **SQLState**: 23901 - **说明**: 与+23701594类似，强调至少有一个被描述的列应该是单值类型。 20. **+30401515 - 该值不能被分配给宿主变量，因为该值不再数据类型的范围之内** - **SQLState**: 30401 - **说明**: 尝试将一个超出数据类型范围的值赋给宿主变量。 21. **+33101520 - 不能被翻译的字符串，因此被设置为NULL** - **SQLState**: 33101 - **说明**: 当试图将一个无法翻译的字符串赋给变量时，该变量将被设置为NULL。 22. **+33901569 - 由于与DB22.2版本的子系统连接，所以可能存在字符转换问题** - **SQLState**: 33901 - **说明**: 与旧版本的DB2（如2.2版）连接时，可能会遇到字符转换的问题。 23. **+39401629 - 使用优化提示来选择访问路径** - **SQLState**: 39401 - **说明**: 在执行查询时，使用了优化提示来指导查询优化器选择合适的访问路径。 24. **+39501628 - 设置了无效的优化提示，原因代码指定了为什么，忽略优化提示** - **SQLState**: 39501 - **说明**: 提供的优化提示无效，查询优化器将忽略这些提示。 25. **+40201521 - 未知的位置** - **SQLState**: 40201 - **说明**: 指定的位置无法识别，可能是由于位置参数错误。 26. **+40301522 - 本地不存在CREATALIAS对象** - **SQLState**: 40301 - **说明**: 尝试在本地创建一个别名对象，但该对象在本地数据库中不存在。 27. **+43401608 - 在DB2未来发布的版本中将不支持指定的特性，IBM建议你停止使用这些特性** - **SQLState**: 43401 - **说明**: 指定的功能在未来版本的DB2中将不再支持，建议停止使用。 28. **+44501004 - 值被CAST函数截取** - **SQLState**: 44501 - **说明**: 使用CAST函数时，目标类型无法完全容纳源值，导致值被截取。 29. **+46201Hxx - 由用户定义的函数或存储过程发出的警告** - **SQLState**: 46201 - **说明**: 用户定义的函数或存储过程中产生了警告信息。 30. **+46401609 - 命名的存储过程超出了它可能返回的查询结果集的个数限制** - **SQLState**: 46401 - **说明**: 存储过程返回的结果集数量超出了允许的最大数量。 31. **+46601610 - 指定由命名的存储过程返回的查询结果集的个数。成功完成** - **SQLState**: 46601 - **说明**: 成功指定了由命名的存储过程返回的查询结果集的数量。 32. **+49401614 - 由存储过程返回的结果集的个数超过了由ASSOCIATE LOCATORS语句指定的结果集定位器的个数** - **SQLState**: 49401 - **说明**: 存储过程返回的结果集数量超过ASSOCIATE LOCATORS语句指定的结果集定位器的数量。 33. **+49501616 - 因为倒台SQL的成本估算超出了在ELST中指定的警告阀值，所以发出警告** - **SQLState**: 49501 - **说明**: 当SQL语句的执行成本估计超过ELST中设置的阈值时，会发出警告。 34. **+53501591 - 请求一个主健的定位更新，或请求一个使用自我引出约束的表的删除操作** - **SQLState**: 53501 - **说明**: 对具有主键的表进行定位更新或对使用自我引出约束的表进行删除操作时出现问题。 35. **+54101543 - 命名外健是一个重复的引用约束** - **SQLState**: 54101 - **说明**: 外键约束定义中出现了重复的引用。 36. **+55101548 - 命名的授权ID缺少在命名的DB2对象上执行命名操作的权限** - **SQLState**: 55101 - **说明**: 授权ID没有足够的权限来执行特定的操作。 37. **+55201542 - 命名的授权ID缺少执行命名操作的权限** - **SQLState**: 55201 - **说明**: 类似于+55101548，授权ID缺少执行某操作所需的权限。 38. **+55801516 - 已经被授权该PUBLIC，因此WITH GRANT OPTION不可用** - **SQLState**: 55801 - **说明**: 公共角色已经被授权，因此无法再使用WITH GRANT OPTION。 39. **+56101523 - 对ALTER REFERENCES INDEX和TRIGGER特权，PUBLIC AT ALL LOCATION无效** - **SQLState**: 56101 - **说明**: 在所有位置上对PUBLIC授予ALTER REFERENCES INDEX和TRIGGER特权无效。 40. **+56201560 - 因为GRANTEE已经拥有这些特权，所以一个或更多的特权被忽略** - **SQLState**: 56201 - **说明**: 授予特权时，如果GRANTEE已经拥有这些特权，则这些特权将被忽略。 41. **+58501625 - 模式名指定了不止一次** - **SQLState**: 58501 - **说明**: 在一个SQL语句中多次指定了相同的模式名。 42. **+59901596 - 没有为长字符数据类型（BLOB，CLOB和DBCLOB）建立比较函数** - **SQLState**: 59901 - **说明**: 对于BLOB、CLOB或DBCLOB类型的数据，没有定义相应的比较函数。 43. **+61001566 - 由于建立了一个指定为DEFER YES的索引，指定的对象处于PENDING状态，或者因为使用了ALTER INDEX改变关键值的范围，所以指定的对象处于PENDING状态** - **SQLState**: 61001 - **说明**: 创建DEFER YES索引或使用ALTER INDEX改变索引的关键值范围会导致对象进入PENDING状态。 44. **+62501518 - 因为删除了主健索引，所以表定义被标注为不完整** - **SQLState**: 62501 - **说明**: 删除主键索引后，表的定义被认为是不完整的。 45. **+62601529 - 删除了加强UNIQUE约束的索引，唯一性不在被加强** - **SQLState**: 62601 - **说明**: 删除了加强UNIQUE约束的索引后，唯一性约束将不再被加强。 46. **+64501528 - 因为建立的索引中没有包含NULL，所以WHERE NOT NULL被忽略** - **SQLState**: 64501 - **说明**: 如果索引中不包含NULL值，那么WHERE NOT NULL条件将被忽略。 47. **+65001538 - 不能更改或者建立已命名的表为从属表** - **SQLState**: 65001 - **说明**: 不能将已命名的表更改为从属表。 48. **+65301551 - 在已指定的分区列上，不能建立或更改索引** - **SQLState**: 65301 - **说明**: 不能在分区列上建立或更改索引。 #### 四、总结 通过对上述SQLCODE及其对应的SQLState的详细介绍，我们可以更好地理解DB2在处理不同情况时的行为。当遇到SQL执行问题时，可以根据返回的SQLCODE和SQLState快速定位问题所在，进而采取适当的措施解决问题。同时，了解这些错误码有助于预防潜在的问题，并提高系统的稳定性和可靠性。