跳至主要内容

大小写敏感

大小写敏感性会影响数据的**过滤**和**排序**，并由你的数据库排序规则决定。根据你的设置，排序和过滤数据会产生不同的结果。

操作区分大小写不区分大小写
升序排序Apple, Banana, apple pie, banana pieApple, apple pie, Banana, banana pie
匹配"apple"appleApple, apple

如果你使用的是**关系型数据库连接器**，Prisma Client 会尊重你的数据库排序规则。支持使用 Prisma Client 进行**不区分大小写**过滤和排序的选项和建议取决于你的数据库提供商。

如果你使用的是 MongoDB 连接器，Prisma Client 使用正则表达式规则来启用不区分大小写的过滤。该连接器**不**使用MongoDB 排序规则。

注意：关注GitHub 上的不区分大小写排序的进展。

数据库排序规则和大小写敏感性​

信息

在 Prisma Client 的上下文中，以下部分仅指关系型数据库连接器。

排序规则指定了如何在数据库中**排序和比较**数据，包括大小写。排序规则是在你设置数据库时选择的。

以下示例演示了如何查看 MySQL 数据库的排序规则

SELECT @@character_set_database, @@collation_database;
显示CLI结果
  +--------------------------+----------------------+
  | @@character_set_database | @@collation_database |
  +--------------------------+----------------------+
  | utf8mb4                  | utf8mb4_0900_ai_ci   |
  +--------------------------+----------------------+

示例排序规则，utf8mb4_0900_ai_ci，是

  • 不区分重音符号 (ai)
  • 不区分大小写 (ci)。

这意味着prisMa将匹配prisma、PRISMA、priSMA等。

SELECT id, email FROM User WHERE email LIKE "%prisMa%"
显示CLI结果
 +----+-----------------------------------+
 | id | email                             |
 +----+-----------------------------------+
 | 61 | [email protected]                   |
 | 49 | [email protected]                |
 +----+-----------------------------------+

使用 Prisma Client 的相同查询

const users = await prisma.user.findMany({
  where: {
    email: {
      contains: 'prisMa',
    },
  },
  select: {
    id: true,
    name: true,
  },
})

不区分大小写过滤的选项​

使用 Prisma Client 支持不区分大小写过滤的推荐方法取决于你的底层提供程序。

PostgreSQL 提供程序​

PostgreSQL 默认使用确定性排序规则，这意味着过滤是**区分大小写**的。要支持不区分大小写过滤，请在每个字段的基础上使用mode: 'insensitive'属性。

如所示在过滤器上使用mode属性

const users = await prisma.user.findMany({
  where: {
    email: {
      endsWith: 'prisma.io',
      mode: 'insensitive', // Default value: default
    },
  },
})

另请参阅：过滤（不区分大小写过滤）

注意事项​

  • 你不能将不区分大小写过滤与 C 排序规则一起使用
  • citext列始终不区分大小写，不受mode的影响。

性能​

如果你严重依赖不区分大小写过滤，请考虑在 PostgreSQL 数据库中创建索引以提高性能。

MySQL 提供程序​

MySQL 默认使用**不区分大小写排序规则**。因此，使用 Prisma Client 和 MySQL 进行过滤默认是不区分大小写的。

mode: 'insensitive'属性不是必需的，因此在生成的 Prisma Client API 中不可用。

注意事项​

  • 你**必须**使用不区分大小写 (_ci) 排序规则才能支持不区分大小写过滤。Prisma Client 不支持 MySQL 提供程序的mode过滤器属性。

MongoDB 提供程序​

要支持不区分大小写过滤，请在每个字段的基础上使用mode: 'insensitive'属性。

const users = await prisma.user.findMany({
  where: {
    email: {
      endsWith: 'prisma.io',
      mode: 'insensitive', // Default value: default
    },
  },
})

MongoDB 使用正则表达式规则进行不区分大小写过滤。

SQLite 提供程序​

默认情况下，Prisma Client 在 SQLite 数据库中创建的文本字段不支持不区分大小写过滤。在 SQLite 中，只支持ASCII 字符的不区分大小写比较。

要为每个列启用有限的支持（仅限 ASCII）以进行不区分大小写过滤，你需要在定义文本列时添加COLLATE NOCASE。

向新列添加不区分大小写过滤。​

要向新列添加不区分大小写过滤，你需要修改 Prisma Client 创建的迁移文件。

以以下 Prisma 模式模型为例

model User {
  id    Int    @id
  email String
}

并使用prisma migrate dev --create-only创建以下迁移文件

-- CreateTable
CREATE TABLE "User" (
    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
    "email" TEXT NOT NULL
);

你需要在email列中添加COLLATE NOCASE才能使不区分大小写过滤成为可能。

-- CreateTable
CREATE TABLE "User" (
    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
    //highlight-next-line
    "email" TEXT NOT NULL COLLATE NOCASE
);

为现有列添加不区分大小写的过滤。​

由于 SQLite 中无法更新列，因此只能通过创建空白迁移文件并将数据迁移到新表来为现有列添加 COLLATE NOCASE。

以以下 Prisma 模式模型为例

model User {
  id    Int    @id
  email String
}

并使用 prisma migrate dev --create-only 创建一个空的迁移文件，您需要重命名当前的 User 表并创建一个新的 User 表，其中包含 COLLATE NOCASE。

-- UpdateTable
ALTER TABLE "User" RENAME TO "User_old";

CREATE TABLE "User" (
    "id" INTEGER NOT NULL PRIMARY KEY AUTOINCREMENT,
    "email" TEXT NOT NULL COLLATE NOCASE
);

INSERT INTO "User" (id, email)
SELECT id, email FROM "User_old";

DROP TABLE "User_old";

Microsoft SQL Server 提供程序​

Microsoft SQL Server 默认使用不区分大小写的排序规则。因此，使用 Prisma Client 和 Microsoft SQL Server 进行过滤默认情况下是不区分大小写的。

mode: 'insensitive'属性不是必需的，因此在生成的 Prisma Client API 中不可用。