Firebird 5.0添加列时触发字符串转时间戳转换错误求助

问题背景 #

现有Firebird 5.0表的DDL如下：

CREATE TABLE KASSE_DETAILEDSTATISTICS 
(ORDERDATE KASSE_ORDERTIMESTAMP NOT NULL,
 PRODUCTID KASSE_PRODUCTID NOT NULL,
 CONSUMPTIONPLACE KASSE_INHAUS NOT NULL,
 ORDERTYPE KASSE_ORDERTYPE NOT NULL,
 QUANTITY KASSE_QUANTITY NOT NULL,
 PRICESUM KASSE_PRICE,
 TRAININGPURCHASE KASSE_BOOLEAN NOT NULL,
 KASSE_ID KASSE_Z_KASSE_ID);

ALTER TABLE KASSE_DETAILEDSTATISTICS ADD PRIMARY KEY (ORDERDATE,PRODUCTID,CONSUMPTIONPLACE);

CREATE UNIQUE INDEX IDX_KASSE_DETAILEDSTATISTICS ON KASSE_DETAILEDSTATISTICS(ORDERDATE,PRODUCTID,CONSUMPTIONPLACE);

执行添加列语句时触发错误：

ALTER TABLE KASSE_DETAILEDSTATISTICS ADD TEST INTEGER;

错误信息：

Conversion error from string "  .  .       :  :  ".

SQL Code: -413
IB Error Number: 335544334

明明只是添加列操作，且表中ORDERDATE列均为有效时间戳值，却出现日期转换错误。

原因分析 #

这个错误的核心是自定义域KASSE_ORDERTIMESTAMP的校验逻辑存在问题。Firebird在执行ALTER TABLE添加列时，会隐式触发对表中所有使用自定义域的列的重新校验。如果该域的定义包含错误的转换规则（比如无效的字符串转时间戳逻辑、错误的默认值或校验约束），就会导致现有数据在重新校验时触发转换错误。

解决方案 #

1. 检查自定义域的定义 #

先查看KASSE_ORDERTIMESTAMP域的具体配置，确认是否存在错误逻辑：

SELECT RDB$FIELD_NAME, RDB$FIELD_TYPE, RDB$VALIDATION_SOURCE, RDB$DEFAULT_SOURCE 
FROM RDB$FIELDS 
WHERE RDB$FIELD_NAME = 'KASSE_ORDERTIMESTAMP';

重点关注RDB$VALIDATION_SOURCE（校验规则）和RDB$DEFAULT_SOURCE（默认值）字段，排查是否有错误的日期转换逻辑。

2. 修改域的错误定义 #

如果发现域的校验规则或默认值存在问题，直接修改域的定义，确保其能正确兼容现有数据：

-- 示例：修改域的校验规则（根据实际情况调整）
ALTER DOMAIN KASSE_ORDERTIMESTAMP SET VALIDATION ...;

3. 临时禁用约束校验后添加列 #

如果修改域有困难，可以临时禁用表的所有约束校验，添加列后再恢复：

-- 临时延迟所有约束校验
ALTER TABLE KASSE_DETAILEDSTATISTICS SET CONSTRAINTS ALL DEFERRED;
-- 执行添加列操作
ALTER TABLE KASSE_DETAILEDSTATISTICS ADD TEST INTEGER;
-- 恢复即时校验
ALTER TABLE KASSE_DETAILEDSTATISTICS SET CONSTRAINTS ALL IMMEDIATE;

4. 备份重建表（终极方案） #

如果以上方法都无效，可通过备份数据、重建表的方式解决：

-- 1. 创建临时表备份数据
CREATE TABLE TEMP_STATS AS SELECT * FROM KASSE_DETAILEDSTATISTICS;
-- 2. 删除原表
DROP TABLE KASSE_DETAILEDSTATISTICS;
-- 3. 重新创建表（包含新的TEST列）
CREATE TABLE KASSE_DETAILEDSTATISTICS 
(ORDERDATE KASSE_ORDERTIMESTAMP NOT NULL,
 PRODUCTID KASSE_PRODUCTID NOT NULL,
 CONSUMPTIONPLACE KASSE_INHAUS NOT NULL,
 ORDERTYPE KASSE_ORDERTYPE NOT NULL,
 QUANTITY KASSE_QUANTITY NOT NULL,
 PRICESUM KASSE_PRICE,
 TRAININGPURCHASE KASSE_BOOLEAN NOT NULL,
 KASSE_ID KASSE_Z_KASSE_ID,
 TEST INTEGER);
-- 4. 重建主键和索引
ALTER TABLE KASSE_DETAILEDSTATISTICS ADD PRIMARY KEY (ORDERDATE,PRODUCTID,CONSUMPTIONPLACE);
CREATE UNIQUE INDEX IDX_KASSE_DETAILEDSTATISTICS ON KASSE_DETAILEDSTATISTICS(ORDERDATE,PRODUCTID,CONSUMPTIONPLACE);
-- 5. 导入备份数据
INSERT INTO KASSE_DETAILEDSTATISTICS SELECT *, NULL FROM TEMP_STATS;
-- 6. 删除临时表
DROP TABLE TEMP_STATS;

内容的提问来源于stack exchange，提问作者Markus