`drizzle-kit export`

本指南假定您已熟悉：

开始使用 Drizzle 和 drizzle-kit - 在此阅读
Drizzle schema 基础知识 - 在此阅读
数据库连接基础知识 - 在此阅读
Drizzle 迁移基础知识 - 在此阅读
Drizzle Kit 概览和配置文件

drizzle-kit export 可让你导出 Drizzle schema 的 SQL 表示，并在控制台中打印其 SQL DDL 表示。

它在底层是如何工作的？

Drizzle Kit 的 export 命令会触发一系列事件：

它会读取你的 Drizzle schema 文件，并生成该 schema 的 json 快照
基于当前的 json 快照生成 SQL DDL 语句
将 SQL DDL 语句输出到控制台

它旨在支持管理 Drizzle migrations 的 codebase first 方法。你可以导出 Drizzle schema 的 SQL 表示，让 Atlas 等外部工具为你处理所有迁移

drizzle-kit export 命令要求你同时提供 dialect 和 schema 路径选项，你可以通过 drizzle.config.ts 配置文件设置它们，或者通过 CLI 选项设置

使用配置文件

作为 CLI 选项

// drizzle.config.ts
import { defineConfig } from "drizzle-kit";

export default defineConfig({
  dialect: "sqlite",
  schema: "./src/schema.ts",
});

npx drizzle-kit export

npx drizzle-kit export --dialect=sqlite --schema=./src/schema.ts

Schema 文件路径

你可以只有一个 schema.ts 文件，也可以将任意多个 schema 文件分散在整个项目中。 Drizzle Kit 要求你通过 schema 配置项以 glob 的形式指定它们的路径。

Example 1

Example 2

Example 3

Example 4

📦 <project root>
 ├ ...
 ├ 📂 drizzle
 ├ 📂 src
 │ ├ ...
 │ ├ 📜 index.ts
 │ └ 📜 schema.ts 
 ├ 📜 drizzle.config.ts
 └ 📜 package.json

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  schema: "./src/schema.ts",
});

📦 <project root>
 ├ ...
 ├ 📂 drizzle
 ├ 📂 src
 │ ├ 📂 user
 │ │ ├ 📜 handler.ts 
 │ │ └ 📜 schema.ts 
 │ ├ 📂 posts
 │ │ ├ 📜 handler.ts 
 │ │ └ 📜 schema.ts 
 │ └ 📜 index.ts
 ├ 📜 drizzle.config.ts
 └ 📜 package.json

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  schema: "./src/**/schema.ts",
  //or
  schema: ["./src/user/schema.ts", "./src/posts/schema.ts"]
});

📦 <project root>
 ├ ...
 ├ 📂 drizzle
 ├ 📂 src
 │ ├ 📂 schema
 │ │ ├ 📜 user.ts 
 │ │ ├ 📜 post.ts 
 │ │ └ 📜 comment.ts 
 │ └ 📜 index.ts
 ├ 📜 drizzle.config.ts
 └ 📜 package.json

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  schema: "./src/schema/*",
});

📦 <project root>
 ├ ...
 ├ 📂 drizzle
 ├ 📂 src
 │ ├ 📜 userById.ts 
 │ ├ 📜 userByEmail.ts 
 │ ├ 📜 listUsers.ts 
 │ ├ 📜 user.sql.ts 
 │ ├ 📜 postById.ts 
 │ ├ 📜 listPosts.ts 
 │ └ 📜 post.sql.ts 
 │ 📜 index.ts
 ├ 📜 drizzle.config.ts
 └ 📜 package.json

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  schema: "./src/**/*.sql.ts", // Dax's favourite
});

一个项目中的多个配置文件

你可以在项目中使用多个配置文件，当你有多个数据库阶段、多个数据库，或者同一项目中存在不同数据库时，这非常有用：

npm

yarn

pnpm

bun

npx drizzle-kit export --config=drizzle-dev.config.ts
npx drizzle-kit export --config=drizzle-prod.config.ts

yarn drizzle-kit export --config=drizzle-dev.config.ts
yarn drizzle-kit export --config=drizzle-prod.config.ts

pnpm drizzle-kit export --config=drizzle-dev.config.ts
pnpm drizzle-kit export --config=drizzle-prod.config.ts

bunx drizzle-kit export --config=drizzle-dev.config.ts
bunx drizzle-kit export --config=drizzle-prod.config.ts

📦 <project root>
 ├ 📂 drizzle
 ├ 📂 src
 ├ 📜 .env
 ├ 📜 drizzle-dev.config.ts
 ├ 📜 drizzle-prod.config.ts
 ├ 📜 package.json
 └ 📜 tsconfig.json

可用配置的扩展列表

drizzle-kit export 有一组仅 CLI 可用的选项


`--sql`	生成 Drizzle Schema 的 SQL 表示

默认情况下，Drizzle Kit 输出 SQL 文件，但未来我们希望支持不同的格式

npm

yarn

pnpm

bun

npx drizzle-kit export --sql=true

yarn drizzle-kit export --sql=true

pnpm drizzle-kit export --sql=true

bunx drizzle-kit export --sql=true

我们建议通过 drizzle.config.ts 文件来配置 drizzle-kit，但如果有必要，例如在 CI/CD 流水线中等，你也可以通过 CLI 提供所有配置选项。


`dialect`	`required`	数据库方言，以下之一 `postgresql` `mysql` `sqlite` `turso` `singlestore` `mssql` `cockroach`
`schema`	`required`	Typescript schema 文件或包含多个 schema 文件的文件夹路径
`config`		配置文件路径，默认为 `drizzle.config.ts`

示例

示例说明如何将 drizzle schema 导出到控制台，其中 Drizzle schema 位于 ./src/schema.ts

我们还将把 drizzle 配置文件放在 configs 文件夹中。

让我们创建配置文件：

📦 <project root>
 ├ 📂 configs
 │ └ 📜 drizzle.config.ts
 ├ 📂 src
 │ └ 📜 schema.ts
 └ …

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  dialect: "sqlite",
  schema: "./src/schema.ts",
});

import { sqliteTable, integer, text } from 'drizzle-orm/sqlite-core'

export const users = sqliteTable('users', {
	id: integer().primaryKey({ autoIncrement: true }),
	email: text().notNull(),
	name: text()
});

现在我们来运行

npx drizzle-kit export --config=./configs/drizzle.config.ts

它将成功输出 drizzle schema 的 SQL 表示

CREATE TABLE `users` (
        `id` integer PRIMARY KEY AUTOINCREMENT,
        `email` text NOT NULL,
        `name` text
);