`drizzle-kit pull`

本指南假定您已熟悉：

开始使用 Drizzle 和 drizzle-kit - 请阅读这里
Drizzle schema 基础知识 - 请阅读这里
数据库连接基础知识 - 请阅读这里
Drizzle migrations 基础知识 - 请阅读这里
Drizzle Kit 概览和配置文件文档

drizzle-kit pull 允许你直接拉取（introspect）现有数据库的 schema，并生成 schema.ts drizzle schema 文件，
它旨在支持 Drizzle migrations 的 database first 方法。

底层是如何工作的？

当你运行 Drizzle Kit pull 命令时，它会：

拉取你现有数据库的 schema（DDL）
生成 schema.ts drizzle schema 文件并保存到 out 文件夹

                                  ┌────────────────────────┐      ┌─────────────────────────┐ 
                                  │                        │ <---  CREATE TABLE `users` (
┌──────────────────────────┐      │                        │        `id` int auto_increment primary key,
│ ~ drizzle-kit pull       │      │                        │        `name` varchar(255),
└─┬────────────────────────┘      │        DATABASE        │        `email` varchar(255) unique
  │                               │                        │       );
  └ 拉取数据库 schema -------> │                        │
  ┌ 生成 Drizzle         <----- │                        │
  │ schema TypeScript 文件       └────────────────────────┘
  │
  v

import * as p from "drizzle-orm/mysql-core";

export const users = p.mysqlTable(
  "users",
  {
    id: p.int().autoincrement().primaryKey(),
    name: p.varchar({ length: 255 }),
    email: p.varchar({ length: 255 }),
  },
  (table) => [p.uniqueIndex("email").on(table.email)]
);

如果你需要在 TypeScript 项目之外管理数据库 schema，或者你使用的是由他人管理的数据库，这是一种很好的方式。

drizzle-kit pull 需要你指定 dialect，以及数据库连接 url 或 user:password@host:port/db 参数；你可以通过 drizzle.config.ts 配置文件或 CLI 选项来提供它们：

使用配置文件

使用 CLI 选项

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

export default defineConfig({
  dialect: "mysql",
  dbCredentials: {
    url: "mysql://user:password@host:3306/dbname",
  },
});

npx drizzle-kit pull

npx drizzle-kit pull --dialect=mysql --url=mysql://user:password@host:3306/dbname

一个项目中使用多个配置文件

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

npm

yarn

pnpm

bun

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

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

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

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

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

初始 pull

你可以使用 --init 标志将拉取到的 schema 标记为数据库中一个已应用的 migration，
这样后续所有 migrations 都会基于这个初始 migration 进行 diff。

npx drizzle-kit pull --init

包含表

drizzle-kit pull 默认会 introspect 所有 MySQL 表。你可以通过 tablesFilter 配置表列表。


`tablesFilter`	基于 `glob` 的表名过滤器，例如 `["users", "user_info"]` 或 `"user"`。默认值是 `""`

让我们配置 drizzle-kit 去 introspect 连接的 MySQL 数据库中的所有表。

import { defineConfig } from "drizzle-kit";

export default defineConfig({
  dialect: "mysql",
  dbCredentials: {
    url: "mysql://user:password@host:3306/dbname",
  },
  tablesFilter: ["*"],
});

npx drizzle-kit pull

扩展配置列表

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


`dialect`	`required`	数据库方言，取值为 `postgresql` `mysql` `sqlite` `turso` `singlestore` `mssql` `cockroach` 之一
`out`		migrations 输出文件夹路径，默认是 `./drizzle`
`url`		数据库连接字符串
`user`		数据库用户
`password`		数据库密码
`host`		主机
`port`		端口
`database`		数据库名
`config`		配置文件路径，默认是 `drizzle.config.ts`
`introspect-casing`		用于为列、表等创建 JS key 的策略。`preserve` `camel`
`tablesFilter`		表名过滤器

npm

yarn

pnpm

bun

npx drizzle-kit pull --dialect=mysql --url=mysql://user:password@host:3306/dbname
npx drizzle-kit pull --dialect=mysql --tablesFilter=‘user*’ url=mysql://user:password@host:3306/dbname

yarn drizzle-kit pull --dialect=mysql --url=mysql://user:password@host:3306/dbname
yarn drizzle-kit pull --dialect=mysql --tablesFilter=‘user*’ url=mysql://user:password@host:3306/dbname

pnpm drizzle-kit pull --dialect=mysql --url=mysql://user:password@host:3306/dbname
pnpm drizzle-kit pull --dialect=mysql --tablesFilter=‘user*’ url=mysql://user:password@host:3306/dbname

bunx drizzle-kit pull --dialect=mysql --url=mysql://user:password@host:3306/dbname
bunx drizzle-kit pull --dialect=mysql --tablesFilter=‘user*’ url=mysql://user:password@host:3306/dbname