Atlas项目中的PostgreSQL UNIQUE约束NULLS NOT DISTINCT语法问题解析

在数据库开发中，PostgreSQL的UNIQUE约束是一个常用的数据完整性保障机制。近期Atlas项目（一个数据库schema管理工具）在处理PostgreSQL的UNIQUE约束时出现了一个语法位置问题，值得开发者关注。

问题背景

PostgreSQL从12版本开始引入了NULLS NOT DISTINCT选项，这个特性改变了UNIQUE约束对NULL值的处理方式。传统上，UNIQUE约束会将多个NULL值视为不冲突（即允许存在多个NULL值），而使用NULLS NOT DISTINCT后，NULL值会被视为彼此相等，从而在UNIQUE约束下只允许存在一个NULL值。

问题现象

在Atlas项目中，当开发者使用以下语法创建表时：

create table my_table (
    my_column text
   constraint my_table_constraint UNIQUE NULLS NOT DISTINCT (my_column)
);

Atlas生成的迁移SQL却将语法结构调整为：

CONSTRAINT "my_table_constraint" UNIQUE ("my_column") NULLS NOT DISTINCT

这种调整导致了PostgreSQL语法错误，因为NULLS NOT DISTINCT选项在PostgreSQL中必须紧跟在UNIQUE关键字之后，而不能放在列名列表之后。

技术分析

这个问题实际上反映了Atlas在SQL语法解析和重构过程中的一个缺陷。PostgreSQL对于NULLS NOT DISTINCT的语法位置有严格要求，正确的语法结构应该是：

UNIQUE NULLS NOT DISTINCT (column_name)

而不是：

UNIQUE (column_name) NULLS NOT DISTINCT

这种语法位置要求是由PostgreSQL的解析器实现决定的。Atlas作为一个schema管理工具，在生成迁移SQL时应该保持原始语法结构，而不是重新排列语法元素的位置。

影响范围

这个问题影响了Atlas从v0.21.1之后的所有版本，包括最新的v0.23.0和v0.25.1-canary版本。对于需要使用NULLS NOT DISTINCT特性的PostgreSQL用户来说，这是一个需要特别注意的问题。

解决方案

Atlas团队已经确认并修复了这个问题，最新版本应该已经解决了这个语法位置问题。开发者可以：

1. 升级到最新版本的Atlas
2. 在升级前，可以暂时手动调整生成的SQL，将NULLS NOT DISTINCT移动到正确位置

最佳实践

在使用数据库schema管理工具时，建议开发者：

1. 仔细检查工具生成的SQL是否符合目标数据库的语法要求
2. 对于新引入的数据库特性，先验证工具的支持情况
3. 保持工具的及时更新，以获取最新的bug修复和功能支持

这个问题也提醒我们，在使用任何数据库迁移工具时，理解底层数据库的实际语法要求是非常重要的，不能完全依赖工具的自动处理。