1. 问题现象与根源分析
在数据库系统中，当执行大量数据插入操作时，如通过 pim:completeness:calculate 等命令高频次地向 pim_catalog_completeness 表插入数据，可能会遇到 sqlstate[23000]: integrity constraint violation: 1062 duplicate entry '2147483647' for key 'pim_catalog_completeness.primary' 这样的错误。
此错误的核心在于 Duplicate entry '2147483647'。数值 2147483647 是一个关键的阈值，它代表了有符号 32 位整数（INT）类型所能存储的最大正整数。当数据库表的自增主键（通常为 INT 类型）达到这个上限后，系统将无法生成新的、唯一的自增 ID。此时，如果尝试插入新记录，数据库会因为无法生成有效的唯一主键而抛出 Integrity constraint violation 错误，并报告试图插入的值（通常是 2147483647，因为它已是最大值且可能已被占用，或者系统无法生成比它更大的值）为重复项。这并非真正意义上的数据重复，而是由于主键字段的数据类型容量不足导致的“溢出”问题。
2. 解决方案：升级主键类型至 BIGINT
解决此问题的最直接且最有效的方法是将受影响表的主键字段的数据类型从 INT 升级为 BIGINT。
BIGINT 类型能够存储更大范围的整数值。对于有符号 BIGINT，其最大值可达 9,223,372,036,854,775,807，这比 INT 的最大值高出数万亿倍，足以应对绝大多数高并发、大数据量场景下的 ID 生成需求。
2.1 执行 SQL 语句
针对 pim_catalog_completeness 表的 id 列，可以使用以下 SQL 命令进行修改：
ALTER TABLE pim_catalog_completeness MODIFY COLUMN id BIGINT AUTO_INCREMENT;
代码解析：
- ALTER TABLE pim_catalog_completeness: 指定要修改的表名。
- MODIFY COLUMN id: 指示要修改的列名。
- BIGINT: 将列的数据类型更改为 BIGINT。
- AUTO_INCREMENT: 确保该列继续保持自增属性，并在修改类型后，自增计数器会根据当前表中最大的 BIGINT 值进行调整，从而避免再次从 INT 的最大值开始计数。
2.2 操作注意事项
在执行此类数据库结构变更时，务必注意以下几点：
- 数据备份： 在执行任何 ALTER TABLE 操作之前，强烈建议对相关数据库进行完整备份。尽管 MODIFY COLUMN 通常是安全的，但在极端情况下，不当操作或系统故障可能导致数据丢失。
- 业务影响： 对于生产环境中的大型表，修改列类型可能是一个耗时操作，可能导致表被锁定，从而影响应用程序的读写性能。建议在业务低峰期或维护窗口执行此操作。
-
无符号 BIGINT： 如果确定主键 ID 永远不会是负数，并且需要更大的正整数范围，可以考虑使用 BIGINT UNSIGNED。BIGINT UNSIGNED 的最大值约为 1.8 x 10^19，是 BIGINT 的两倍。
ALTER TABLE pim_catalog_completeness MODIFY COLUMN id BIGINT UNSIGNED AUTO_INCREMENT;
- 应用程序兼容性： 大多数现代应用程序框架和 ORM（对象关系映射）工具都能很好地处理 BIGINT 类型的主键，但仍建议在修改后进行全面的功能测试，以确保应用程序逻辑不受影响。
3. 总结
1062 Duplicate entry for key 'PRIMARY' 错误，特别是当其指向 2147483647 时，明确指示了 INT 类型主键的溢出问题。通过将主键字段的数据类型升级为 BIGINT，可以有效解决这一瓶颈，为数据库提供更广阔的 ID 空间，确保系统在高并发和大数据量场景下的稳定运行和数据完整性。在执行此类关键的数据库结构变更时，务必遵循最佳实践，包括数据备份和在适当时间执行操作，以最大程度地降低潜在风险。
