Delta表自增ID配置START WITH、INCREMENT BY报错求助（DB 11.3）

可能的错误原因及对应解决方案 #

• 语法格式错误
  Delta Lake的IDENTITY列带START WITH和INCREMENT BY的正确语法必须包含括号，且参数用逗号分隔。多数报错源于省略括号，正确写法示例：

  CREATE TABLE user_info (
    user_id BIGINT GENERATED ALWAYS AS IDENTITY (START WITH 1000, INCREMENT BY 10),
    user_name STRING
  ) USING DELTA;
  

  避免写成GENERATED ALWAYS AS IDENTITY START WITH 1 INCREMENT BY 1这类无括号的格式。

• Delta Lake版本不匹配
  虽然Databricks Runtime 11.3理论上对应Delta Lake 2.2.0（支持IDENTITY的START/INCREMENT参数），但实际环境可能存在版本不一致。可以通过以下命令确认当前Delta版本：

  println(org.apache.spark.sql.delta.DeltaLog.currentVersion)
  

  如果版本低于2.2.0，需升级Delta Lake版本或确认Runtime环境配置。

• 外部表限制
  IDENTITY列的START WITH/INCREMENT BY参数仅支持内部托管表（Managed Table），如果是创建外部表会触发报错。需将表改为内部表，或放弃使用这两个参数。

• 列属性冲突
  IDENTITY列必须为整数类型（BIGINT、INT等），且不能同时设置DEFAULT属性。如果给自增列加了默认值，会导致参数解析报错，需移除DEFAULT配置。

内容的提问来源于stack exchange，提问作者Daniel Doboș