INTEGRITY Документация

← Hyperdrive (Postgres & MySQL) / hyperdrive / examples / connect-to-mysql / mysql-drivers-and-libraries

Drizzle ORM

Drizzle ORM ↗ представляет собой лёгкую ORM для TypeScript, ориентированную на типобезопасность. В этом примере показано, как использовать Drizzle ORM с MySQL через Cloudflare Hyperdrive в приложении на Workers.

Предварительные требования

1. Установка Drizzle

Установите Drizzle ORM и его зависимости, такие как mysql2 ↗ драйвер:

# mysql2 v3.13.0 or later is required
npm i drizzle-orm mysql2 dotenv
npm i -D drizzle-kit tsx @types/node

Добавьте необходимые флаги совместимости Node.js и привязку Hyperdrive в свой wrangler.jsonc файле:

{
	// required for database drivers to function
	"compatibility_flags": [
		"nodejs_compat"
	],
	// Set this to today's date
	"compatibility_date": "2026-08-28",
	"hyperdrive": [
		{
			"binding": "HYPERDRIVE",
			"id": "<your-hyperdrive-id-here>"
		}
	]
}
compatibility_flags = [ "nodejs_compat" ]
# Set this to today's date
compatibility_date = "2026-08-28"

[[hyperdrive]]
binding = "HYPERDRIVE"
id = "<your-hyperdrive-id-here>"

2. Настройка Drizzle

2.1. Определение схемы

В Drizzle ORM схема определяется на TypeScript, а не написанием SQL-запросов вручную.

  1. Создайте папку /db/ в /src/.

  2. Создайте schema.ts файл.

  3. В schema.ts, определите users таблицу, как показано ниже.

    src/db/schema.ts
    // src/schema.ts
import { mysqlTable, int, varchar, timestamp } from "drizzle-orm/mysql-core";

export const users = mysqlTable("users", {
	id: int("id").primaryKey().autoincrement(),
	name: varchar("name", { length: 255 }).notNull(),
	email: varchar("email", { length: 255 }).notNull().unique(),
	createdAt: timestamp("created_at").defaultNow(),
});

2.2. Подключение Drizzle ORM к базе данных через Hyperdrive

Используйте учётные данные своей конфигурации Hyperdrive для базы данных при работе с Drizzle ORM.

Заполните ваш index.ts файл, как показано ниже.

src/index.ts
// src/index.ts

import { drizzle } from "drizzle-orm/mysql2";
import { createConnection } from "mysql2/promise";
import { users } from "./db/schema";

export interface Env {
	HYPERDRIVE: Hyperdrive;
  }

export default {
	async fetch(request, env, ctx): Promise<Response> {
		// Create a connection using the mysql2 driver with the Hyperdrive credentials (only accessible from your Worker).
		const connection = await createConnection({
			host: env.HYPERDRIVE.host,
			user: env.HYPERDRIVE.user,
			password: env.HYPERDRIVE.password,
			database: env.HYPERDRIVE.database,
			port: env.HYPERDRIVE.port,

			// Required to enable mysql2 compatibility for Workers
			disableEval: true,
		});

		// Create the Drizzle client with the mysql2 driver connection
		const db = drizzle(connection);

		// Sample query to get all users
		const allUsers = await db.select().from(users);

		return Response.json(allUsers);
	},
} satisfies ExportedHandler<Env>;

2.3. Настройка Drizzle-Kit для миграций (необязательно)

С помощью Drizzle Kit CLI можно генерировать и выполнять SQL миграции базы данных на основе вашей схемы. См. Документация Drizzle ORM ↗ с дополнительными рекомендациями.

  1. Создайте .env файл в корневой папке проекта и добавьте в него строку подключения к базе данных. CLI Drizzle Kit будет использовать эту строку подключения для создания и применения миграций.

    .env
    # .env
# Replace with your direct database connection string
DATABASE_URL='mysql://user:[email protected]/database-name'

  2. Создайте drizzle.config.ts файл в корневой папке проекта, чтобы настроить Drizzle Kit, и добавьте в него следующее содержимое:

    drizzle.config.ts
    import 'dotenv/config';
import { defineConfig } from 'drizzle-kit';
export default defineConfig({
out: './drizzle',
schema: './src/db/schema.ts',
dialect: 'mysql',
dbCredentials: {
url: process.env.DATABASE_URL!,
  },
});

  3. Создайте файл миграции для базы данных на основе файлов схемы и примените миграции к базе данных.

    npx drizzle-kit generate
    No config path provided, using default 'drizzle.config.ts'
Reading config file 'drizzle.config.ts'
Reading schema files:
/src/db/schema.ts

1 tables
users 4 columns 0 indexes 0 fks

[✓] Your SQL migration file ➜ drizzle/0000_daffy_rhodey.sql 🚀
    npx drizzle-kit migrate
    No config path provided, using default 'drizzle.config.ts'
Reading config file 'drizzle.config.ts'

3. Развертывание Worker

Разверните Worker.

npx wrangler deploy

Следующие шаги