DrizzleORM v0.28.6 发布
Sep 6, 2023

变更

注意：MySQL datetime 和 mode: 'date' 现在将以 UTC 字符串存储日期，并以 UTC 格式检索数据，以与 MySQL datetime 的行为保持一致。如果你需要不同的行为并希望以不同的方式处理 datetime 映射，请使用 mode: 'string' 或 自定义类型 实现。

查看 修复 MySQL 的日期时间映射 了解实现细节

新功能

🎉 LibSQL 批处理 API 支持

参考：https://docs.turso.tech/reference/client-access/javascript-typescript-sdk#execute-a-batch-of-statements

批处理 API 使用示例：

const batchResponse = await db.batch([
	db.insert(usersTable).values({ id: 1, name: 'John' }).returning({
		id: usersTable.id,
	}),
	db.update(usersTable).set({ name: 'Dan' }).where(eq(usersTable.id, 1)),
	db.query.usersTable.findMany({}),
	db.select().from(usersTable).where(eq(usersTable.id, 1)),
	db.select({ id: usersTable.id, invitedBy: usersTable.invitedBy }).from(
		usersTable,
	),
]);
type BatchResponse = [
	{
		id: number;
	}[],
	ResultSet,
	{
		id: number;
		name: string;
		verified: number;
		invitedBy: number | null;
	}[],
	{
		id: number;
		name: string;
		verified: number;
		invitedBy: number | null;
	}[],
	{
		id: number;
		invitedBy: number | null;
	}[],
];

所有可在 db.batch 中使用的构建器：

`db.all()`,
`db.get()`,
`db.values()`,
`db.run()`,
`db.query.<table>.findMany()`,
`db.query.<table>.findFirst()`,
`db.select()...`,
`db.update()...`,
`db.delete()...`,
`db.insert()...`,

更多使用示例：integration-tests/tests/libsql-batch.test.ts 和 docs 中

🎉 为 SQLite 中的文本添加 json 模式

在 docs 中阅读更多内容

const test = sqliteTable('test', {
	dataTyped: text('data_typed', { mode: 'json' }).$type<{ a: 1 }>().notNull(),
});

🎉 将 .toSQL() 添加到关系查询 API 调用

const query = db.query.usersTable.findFirst().toSQL();

🎉 为数组添加了新的 PostgreSQL 运算符

运算符和使用示例列表：arrayContains、arrayContained、arrayOverlaps

在 docs 中阅读更多内容

const contains = await db.select({ id: posts.id }).from(posts)
	.where(arrayContains(posts.tags, ['Typescript', 'ORM']));

const contained = await db.select({ id: posts.id }).from(posts)
	.where(arrayContained(posts.tags, ['Typescript', 'ORM']));

const overlaps = await db.select({ id: posts.id }).from(posts)
	.where(arrayOverlaps(posts.tags, ['Typescript', 'ORM']));

const withSubQuery = await db.select({ id: posts.id }).from(posts)
	.where(arrayContains(
		posts.tags,
		db.select({ tags: posts.tags }).from(posts).where(eq(posts.id, 1)),
	));

🎉 为关系查询中的 where 过滤函数添加更多 SQL 运算符

你可以在 docs 中找到更多示例。

// Before
import { inArray } from "drizzle-orm/pg-core";

await db.users.findFirst({
  where: (table, _) => inArray(table.id, [ ... ])
})
// After
await db.users.findFirst({
  where: (table, { inArray }) => inArray(table.id, [ ... ])
})

修复