使用.NET OdbcCommand向Snowflake插入含非零毫秒DateTime遇字段溢出错误

问题说明 #

• Snowflake表包含TEST_TIMESTAMP_NTZ、TEST_TIMESTAMP_LTZ、TEST_TIMESTAMP_TZ三种Timestamp类型字段
• 用.NET OdbcCommand插入带非零毫秒的DateTime对象时，抛出错误：

  System.Data.Odbc.OdbcException : ERROR [22008] [Snowflake][Support] (40520) Datetime field overflow resulting from invalid datetime.

• NUnit测试验证：毫秒为0的插入成功，非0则失败；修改TEST_TEXT列为NVARCHAR(100)后仍报错，但Snowflake查询历史显示语句执行成功，数据却未写入表中

可能原因 #

• ODBC驱动对DateTime精度处理存在兼容问题：Snowflake默认支持9位纳秒精度，但旧版驱动可能无法正确解析.NET DateTime的非零毫秒部分，触发溢出错误
• 参数绑定的自动转换逻辑缺陷：直接传递DateTime对象时，驱动未将其正确转换为Snowflake兼容的Timestamp格式，导致格式校验失败
• 事务未提交：查询历史显示执行成功但无数据，大概率是代码中开启了事务却未提交，最终数据被回滚

解决办法 #

1. 显式格式化DateTime为字符串参数 #

把DateTime转成Snowflake支持的带毫秒的字符串格式，绕过驱动的自动转换逻辑，示例代码：

var targetDate = new DateTime(2024, 5, 20, 10, 20, 30, 456);
// 格式保留6位毫秒（对应Snowflake的纳秒精度前6位）
var formattedDate = targetDate.ToString("yyyy-MM-dd HH:mm:ss.ffffff");
command.Parameters.AddWithValue("@timestampVal", formattedDate);

2. 升级Snowflake ODBC驱动 #

旧版驱动存在DateTime精度处理的已知bug，直接升级到官方最新版驱动，修复兼容性问题

3. 检查事务提交逻辑 #

确认代码中是否开启了事务，若有则必须在插入操作后执行command.Connection.Commit()；如果不需要事务，确保连接处于自动提交模式

4. 替换为Snowflake专用.NET驱动 #

放弃ODBC，改用Snowflake官方的.NET SDK（NuGet包：Snowflake.Data），它对.NET原生类型的支持更完善，能直接处理DateTime的毫秒/纳秒精度

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