website

Drizzle ORM Docs

所属分类:开发者在线工具箱

Drizzle ORM 官方文档:数据库结构、查询方式与迁移说明

Drizzle ORM Docs 是 Drizzle ORM 的官方文档站,说明如何在 TypeScript 项目中定义数据库结构、用接近 SQL 或关系式的接口查询数据,并管理数据库迁移。正在选择 TypeScript 数据库访问层的读者,可以先从首页的设计说明判断它是否符合自己的项目结构。

Drizzle ORM Docs:按数据库、查询方式与迁移工具查阅 TypeScript ORM 文档

发布于 2026年10月18日更新于 2026年10月29日

定位:可按需选用的轻量库

首页称 Drizzle 是一个 headless 的 TypeScript ORM,本身是一个库,同时附带一组可选用的工具。页面把 Django、Spring 一类工具称为数据框架,并强调 Drizzle 让开发者按自己的方式组织项目,而不是围绕框架搭建项目。

Drizzle ORM 文档首页,左侧为文档目录,正文以 Drizzle ORM 简介开头,中部配有一幅按月份列出 GitHub 星标增长数的插图

两种查询方式

Drizzle 同时提供接近 SQL 的查询写法和关系式查询接口。前者用 select、from、leftJoin、where 等写法直接表达 SQL 语句;后者通过 db.query 下的 with 参数,一次取回带嵌套关系的数据。首页称,关系式查询每次只生成一条 SQL 语句,并适合用于无服务器数据库。

数据库与连接

文档顶部可以切换 PostgreSQL、MySQL、SQLite、SingleStore、MSSQL 和 CockroachDB 等数据库。左侧的 Connect 分区列出 Neon、Supabase、PlanetScale Postgres 等 PostgreSQL 服务的连接页面,读者可先确定自己使用的数据库,再进入对应说明。

入门页的分支

入门页分为 New database 与 Existing database 两个部分,分别按 PostgreSQL、MySQL、SQLite、MSSQL 与 CockroachDB 列出驱动和服务,其中 SQLite 下包括 Bun SQLite、Expo SQLite 与 Cloudflare Durable Objects 等条目。

页面加载中的截图

迁移与参数校验

左侧 Migrations 下列出 Overview、generate、migrate、push、pull、export、check、up 和 studio 等页面,另有 Custom migrations 与 Migrations for teams,说明迁移相关操作分为生成、执行、推送、拉取、导出、检查和可视化等几类。Goodies 分区另列出 zod、valibot、typebox、arktype 和 effect-schema 等校验库的集成页,以及 ESLint Plugin、drizzle-graphql 等扩展。读者若要把数据库结构与输入校验连接起来,可以在这些页面中选择对应的库。