RisingWave数据库2.3版本中主键列名大小写敏感问题分析

问题背景

RisingWave是一款开源的分布式SQL流处理数据库系统。在最新发布的2.3版本中，用户报告了一个与表主键列名大小写处理相关的兼容性问题。具体表现为：当使用双引号定义包含大写字母的列名作为主键时，在创建SINK操作时会报错提示列不存在。

问题现象

用户在使用2.2.6版本时能够正常工作的表定义和SINK创建语句，在升级到2.3.x版本后出现错误。关键表定义如下：

CREATE TABLE accounts_table (
  data jsonb,
  "accountId" string,
  PRIMARY KEY ("accountId")
)
ON CONFLICT OVERWRITE;

创建SINK时系统报错：

ERROR: Failed to run the query
Caused by: Bind error: column "accountid" named in key does not exist

值得注意的是，错误信息中的列名"accountid"被转换为了小写形式。

问题根源

经过分析，这个问题源于2.3版本中引入的一个SQL解析优化。在内部处理过程中，系统对表定义进行了"净化"(purification)处理，导致原本使用双引号定义的大小写敏感列名被错误地转换为小写形式。

具体表现为：

• 原始定义：PRIMARY KEY ("accountId")
• 净化后：PRIMARY KEY (accountId)

这种转换破坏了PostgreSQL/标准SQL中关于标识符大小写敏感的规则。在SQL标准中，未加引号的标识符会被转换为小写处理，而加引号的标识符则保持原样。

影响范围

该问题影响以下场景：

1. 使用双引号定义包含大写字母的列名
2. 该列被用作主键
3. 主键约束使用独立语法定义（非列级约束）

临时解决方案

目前用户可以采用以下两种临时解决方案：

1. 使用列级主键约束定义方式：

CREATE TABLE accounts_table (
  data jsonb,
  "accountId" string PRIMARY KEY
)
ON CONFLICT OVERWRITE;

2. 避免在主键列名中使用大写字母：

CREATE TABLE accounts_table (
  data jsonb,
  accountid string,
  PRIMARY KEY (accountid)
)
ON CONFLICT OVERWRITE;

技术建议

对于依赖列名大小写敏感性的应用，建议：

1. 在升级到2.3版本前，审查所有表定义和查询语句
2. 统一命名规范，要么全部使用小写不加引号，要么一致使用引号保持大小写
3. 对于关键业务系统，建议先在测试环境验证兼容性

总结

RisingWave 2.3版本中引入的SQL解析优化意外破坏了标识符大小写敏感性的处理逻辑，特别是在主键约束定义场景下。开发团队已经定位到问题根源，预计会在后续版本中修复。在此期间，用户可以通过调整表定义方式规避此问题。

这个问题也提醒我们，在数据库系统升级时，即使是小版本更新，也需要充分测试SQL兼容性，特别是涉及对象命名规则等基础功能的部分。