Drift数据库：实现不区分大小写的唯一键约束

在数据库设计中，唯一键约束是确保数据完整性的重要机制。然而，当我们需要实现不区分大小写的唯一性检查时，情况会变得稍微复杂一些。本文将以Drift数据库为例，探讨如何在Dart应用中实现这一需求。

问题背景

在Drift（原名Moor）数据库中，开发者通常会使用uniqueKeys属性来定义表的唯一键约束。例如：

@override
List<Set<Column<Object>>>? get uniqueKeys => [
  {name, type}
];

这种标准实现允许插入名称相同但大小写不同的记录（如"Product"和"product"），这往往不是我们想要的行为。

尝试解决方案

开发者首先尝试使用SQL的LOWER()函数创建自定义约束：

@override
List<String> get customConstraints => [
  'UNIQUE (lower(name), type)',
];

但这种方法会抛出SQLite异常："expressions prohibited in PRIMARY KEY and UNIQUE constraints"。这是因为SQLite在设计上不允许在表约束中使用表达式。

正确解决方案

根据SQLite的文档和Drift的特性，我们可以使用生成列（Generated Column）来实现这一需求：

TextColumn get lowercaseName => text().generatedAs(name.lower())();

@override
List<Set<Column<Object>>>? get uniqueKeys => [
  {lowercaseName, type}
];

实现原理

1. 生成列：我们创建了一个名为lowercaseName的虚拟列，它的值自动生成为name列的小写形式
2. 唯一键约束：然后我们将这个生成列与type列一起作为唯一键约束

这种方法巧妙地绕过了SQLite的限制，因为：

• 生成列是表定义的一部分，不是临时表达式
• 唯一键约束只引用列名，不直接包含表达式

性能考虑

使用生成列作为唯一键约束时，需要注意：

1. 存储开销：生成列会占用额外的存储空间
2. 索引效率：小写转换后的字符串比较比原始字符串比较更高效
3. 查询优化：查询时可以直接使用生成列，避免每次计算

替代方案

如果不想使用生成列，还可以考虑：

1. 应用层校验：在插入数据前，手动检查小写形式是否已存在
2. 触发器：创建BEFORE INSERT触发器来检查数据
3. Collation序列：使用自定义的COLLATE序列（但SQLite的默认NOCASE不适用于Unicode）

最佳实践

1. 在设计表结构时，提前考虑大小写敏感性的需求
2. 对于大量数据，生成列方案通常是最佳选择
3. 在迁移现有数据时，确保生成列被正确填充

通过这种技术方案，我们可以在Drift数据库中实现真正不区分大小写的唯一性约束，确保数据的一致性和完整性。