Drizzle ORM 中 SQLite 不区分大小写查询的解决方案

在开发过程中，使用 Drizzle ORM 进行数据库操作时，开发者可能会遇到一个常见问题：尝试在 SQLite 数据库上使用 ilike 操作符时出现语法错误。本文将深入探讨这一问题的原因，并提供几种实用的解决方案。

问题背景

当开发者尝试在 Drizzle ORM 中使用 ilike 操作符对 SQLite 数据库执行不区分大小写的模糊查询时，会遇到如下错误：

SqliteError: near "ilike": syntax error

这是因为 SQLite 数据库引擎本身并不原生支持 ilike 操作符。与 PostgreSQL 等数据库系统不同，SQLite 采用了不同的方式来实现不区分大小写的字符串匹配。

技术原理

SQLite 实现不区分大小写查询的标准方法是使用 COLLATE NOCASE 子句。这个子句可以附加在 LIKE 操作符后面，指示数据库在比较字符串时忽略大小写差异。

解决方案

1. 使用原生 SQL 语法

最直接的解决方案是使用 Drizzle ORM 的 sql 标签模板来编写原生 SQL 查询：

import { sql } from 'drizzle-orm';

await db.select()
  .from(userTable)
  .where(sql`${userTable.contact} LIKE ${'%keyword%'} COLLATE NOCASE`);

需要注意的是，字符串拼接应该使用参数化查询的方式，而不是直接拼接字符串，以避免 SQL 注入风险。

2. 创建自定义 ilike 函数

为了保持代码的整洁性和可重用性，可以创建一个自定义的 ilike 函数：

import { sql } from 'drizzle-orm';

function ilike(column: any, value: string) {
  return sql`${column} LIKE ${value} COLLATE NOCASE`;
}

// 使用示例
await db.select()
  .from(userTable)
  .where(ilike(userTable.contact, '%keyword%'));

3. 使用 like 操作符配合大小写转换

另一种替代方案是在应用层处理大小写问题：

import { like } from 'drizzle-orm';

await db.select()
  .from(userTable)
  .where(like(userTable.contact.toLowerCase(), '%keyword%'.toLowerCase()));

最佳实践建议

1. 参数化查询：始终使用参数化查询来防止 SQL 注入攻击。
2. 代码一致性：在项目中统一使用一种解决方案，保持代码风格一致。
3. 性能考虑：对于大型数据集，COLLATE NOCASE 可能比应用层的大小写转换更高效。
4. 文档记录：在项目文档中明确记录 SQLite 的特殊处理方式，方便团队协作。

总结

虽然 Drizzle ORM 提供了 ilike 操作符，但在 SQLite 环境下需要特殊处理。理解数据库引擎的特性差异并选择合适的解决方案，是开发高质量应用的关键。本文提供的几种方法各有优劣，开发者可以根据项目需求和团队习惯选择最适合的方案。