# @funcd-dev/drizzle 中文文档

规范地址：https://npmcn.com/package/%40funcd-dev/drizzle/

版本：0\.29\.0
npm 元数据更新时间：2026-11-14T12:32:15.767Z
中文译文更新时间：2026-11-15T17:02:15.273Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40funcd-dev/drizzle
原文对照：https://npmcn.com/package/%40funcd-dev/drizzle/?lang=original
项目主页：https://github.com/pyvvo/funcd-typescript/tree/main/drizzle#readme
源码仓库：https://github.com/pyvvo/funcd-typescript

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：8.2 kB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22
- 运行依赖：0 个
- peer 依赖：drizzle-orm \>=0\.45\.0 \<1\.0\.0
- 首次发布：2026-10-21T20:38:46.937Z
- 最新版本发布：2026-11-14T12:32:15.450Z
- 近 30 天下载量：2118（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：12（近 12 个月 12 个）

## 中文简介

Dizzle over funcd 上下文. sql:一个执行中应用的 sqlite- proxy 数据库和 dryzzle- kit 迁移

## 安装

```sh
npm install @funcd-dev/drizzle
```

也可以使用：`pnpm add @funcd-dev/drizzle`、`yarn add @funcd-dev/drizzle`、`bun add @funcd-dev/drizzle`

## README

# @ funcd- dev/ 细雨

[滴水龙头](https://orm.drizzle.team/) 过funcd's `context.sql` (已失效 ADR-0258): 一个包而不是一个复制的适配器 每个应用程序.

```ts
import { applyMigrations, funcdDrizzle } from '@funcd-dev/drizzle';
import type { FunctionContext } from '@funcd-dev/shim';

import * as schema from './db/schema.ts';

export const db = (ctx: FunctionContext) => funcdDrizzle(ctx, { schema });

// the migrate function, or an App's preApply hook: the drizzle-kit folder the bundle carries
const migrations: Record<string, string> = import.meta.glob(['../../drizzle/*.sql', '../../drizzle/meta/_journal.json'], {
  query: '?raw',
  import: 'default',
  eager: true,
});
export const handle = async (ctx: FunctionContext) => ({ applied: await applyMigrations(ctx, migrations) });
```

-   `funcdDrizzle(ctx, { alias = 'app', schema })` 是Drizzle的吗 `sqlite-proxy` 数据库。 A 类 `SELECT` 或者说 `WITH` 转到 `context.sql.queryValues`,任何其他声明 `execute`自从德瑞兹送来 `insert … returning()` 作为读取. A 类 `batch` 是一个 `execute`, 全部或无, 用于写作 : 里面的一个选择没有行 。 A 类 `WITH` 写着 (单位:千美元)`db.with(cte).insert(…)`)也走读取的路径,所以不写 `WITH`。 。 。 .
-   `applyMigrations(ctx, files, { alias = 'app', table = '_migrations' })` 应用表格中的细雨- kit 迁移 缺乏,与他们的行,在一个 `execute`,并返回应用了多少。 它读他们从 `files`,路径 内容映射,并将表格保留为 Drizzle 自己的 `sqlite-proxy` {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}所以任何人都可以接手 {\\fn黑体\\fs22\\bord1\\shad0\\3ahbe\\4ah00\\fscx67\\fscy66\\2chffffff\\3ch808080}你应该知道 另一个.
-   `drizzle-orm` 是一个对等依赖: App 选择其版本 (`>=0.45.0 <1.0.0`) (中文(简体) ).

## 常见问题

### @funcd-dev/drizzle 是什么？

Dizzle over funcd 上下文\. sql:一个执行中应用的 sqlite- proxy 数据库和 dryzzle- kit 迁移

### 如何安装 @funcd-dev/drizzle？

在项目目录运行 npm install @funcd-dev/drizzle，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：drizzle-orm（\>=0\.45\.0 \<1\.0\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @funcd-dev/drizzle 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @funcd-dev/drizzle 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @funcd-dev/drizzle 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @funcd-dev/drizzle 可以商用吗？

@funcd-dev/drizzle 使用 Apache-2\.0 许可。宽松许可：允许商业使用、修改和再分发，并附带明确的专利授权；分发时需保留许可与 NOTICE 文件，修改过的文件要注明改动。以上为概括，不构成法律意见，请以许可原文为准。

### @funcd-dev/drizzle 的下载量有多少？

根据 npm 官方下载统计，@funcd-dev/drizzle 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,118 次，日均约 71 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @funcd-dev/drizzle 还在维护吗？

最新版本 0\.29\.0 发布于 2026/11/14（1 天前）；至今共发布 12 个版本，其中过去 12 个月发布了 12 个；首次发布于 2026/10/22。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。