查询性能
说到 Drizzle —— 我们是在 SQL 之上的一层轻量 TypeScript 封装,开销几乎为 0;而要真正做到 0,你可以使用我们的预编译语句 API。
当你在数据库上执行查询时,会发生以下几件事:
- 查询构建器的所有配置都会被拼接到 SQL 字符串中
- 该字符串和参数会发送到数据库驱动
- 驱动将 SQL 查询编译为二进制 SQL 可执行格式,并发送到数据库
使用预编译语句时,你只需在 Drizzle ORM 这一侧进行一次 SQL 拼接,然后数据库驱动就能够复用已预编译的二进制 SQL,而不必每次都解析查询。
这在大型 SQL 查询上具有极其显著的性能优势。
预处理语句
const db = drizzle(...);
const prepared = db.select().from(customers).prepare("statement_name");
const res1 = await prepared.execute();
const res2 = await prepared.execute();
const res3 = await prepared.execute();占位符
每当你需要嵌入一个动态运行时值时 - 你可以使用 sql.placeholder(...) API
import { sql } from "drizzle-orm";
const p1 = db
.select()
.from(customers)
.where(eq(customers.id, sql.placeholder('id')))
.prepare("p1")
await p1.execute({ id: 10 }) // SELECT * FROM customers WHERE id = 10
await p1.execute({ id: 12 }) // SELECT * FROM customers WHERE id = 12
const p2 = db
.select()
.from(customers)
.where(sql`lower(${customers.name}) like ${sql.placeholder('name')}`)
.prepare("p2");
await p2.execute({ name: '%an%' }) // SELECT * FROM customers WHERE lower(name) like '%an%'