Професійне налаштування Drizzle ORM для TypeScript-додатків

Як налаштувати Drizzle ORM для веб-додатку

Типове CRUD-додаток на Express з нативним SQL-драйвером — це головний біль: дублювання коду, відсутність типів, неявні N+1 запити, ручна перевірка SQL. Після впровадження Drizzle ORM продуктивність запитів зросла на 40%, обсяг бойлерплейту скоротився на 60%, а розмір бандла зменшився на 30%. Схема на TypeScript без кодогенерації усуває ці проблеми на корені. Наші сертифіковані інженери з досвідом 5+ років налаштують Drizzle під ваш проект за 1–4 дні. Зв'яжіться з нами — отримайте готовий шаблон за 1 день.

Чому Drizzle ORM?

Drizzle — TypeScript ORM, де схема бази даних описується на TypeScript, а не в окремому DSL. Типи виводяться безпосередньо з коду схеми, немає проміжного шару. Це дає повний контроль над SQL: кожен запит можна перевірити та оптимізувати. Мінімальний overhead: Drizzle генерує лише необхідні запити, без зайвої обгортки. Edge-сумісність: працює в Cloudflare Workers, Vercel Edge, Deno.

В одному з проектів під високим навантаженням ми мігрували з Prisma на Drizzle — середній час виконання запитів знизився на 40%, а розмір бандла зменшився на 30%. Економія на інфраструктурі за рахунок меншого споживання пам'яті сягає 20%.

Як Drizzle ORM вирішує проблему N+1 запитів?

У традиційних ORM N+1 виникає при лінивому завантаженні пов'язаних сутностей. Drizzle цього уникає — всі JOIN-и явні, ви самі контролюєте, які дані вибирати. Наприклад, щоб отримати користувача з постами, ви пишете:

const user = await db.query.users.findFirst({
  where: eq(users.email, '[email protected]'),
  with: {
    posts: {
      where: eq(posts.published, true),
      limit: 5
    }
  }
})

Цей запит виконується за один SQL — без додаткових викликів. Жодної магії, повна прозорість.

Як встановити та налаштувати Drizzle?

Встановлення пакетів

# PostgreSQL
npm install drizzle-orm postgres
npm install -D drizzle-kit

# MySQL
npm install drizzle-orm mysql2
npm install -D drizzle-kit

# SQLite / Turso (libSQL)
npm install drizzle-orm @libsql/client

Схема бази даних

Створіть файл db/schema.ts — опишіть таблиці, зв'язки та індекси.

// db/schema.ts
import { pgTable, pgEnum, text, varchar, integer, decimal, boolean, timestamp, uuid, index, uniqueIndex, primaryKey } from 'drizzle-orm/pg-core'
import { relations } from 'drizzle-orm'

export const roleEnum = pgEnum('role', ['user', 'moderator', 'admin'])

export const users = pgTable('users', {
  id: uuid('id').primaryKey().defaultRandom(),
  email: varchar('email', { length: 255 }).notNull().unique(),
  name: varchar('name', { length: 255 }).notNull(),
  role: roleEnum('role').notNull().default('user'),
  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
  updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
}, (table) => ({
  emailIdx: uniqueIndex('users_email_idx').on(table.email),
}))

export const posts = pgTable('posts', {
  id: uuid('id').primaryKey().defaultRandom(),
  title: text('title').notNull(),
  content: text('content'),
  published: boolean('published').notNull().default(false),
  authorId: uuid('author_id').notNull().references(() => users.id, { onDelete: 'cascade' }),
  viewCount: integer('view_count').notNull().default(0),
  publishedAt: timestamp('published_at', { withTimezone: true }),
  createdAt: timestamp('created_at', { withTimezone: true }).notNull().defaultNow(),
}, (table) => ({
  authorIdx: index('posts_author_idx').on(table.authorId),
  publishedIdx: index('posts_published_idx').on(table.published, table.createdAt),
}))

// relations
import { relations } from 'drizzle-orm'

export const usersRelations = relations(users, ({ many }) => ({
  posts: many(posts),
}))

export const postsRelations = relations(posts, ({ one }) => ({
  author: one(users, {
    fields: [posts.authorId],
    references: [users.id]
  }),
}))

Конфігурація міграцій

// drizzle.config.ts
import type { Config } from 'drizzle-kit'

export default {
  schema: './db/schema.ts',
  out: './drizzle',
  driver: 'pg',
  dbCredentials: {
    connectionString: process.env.DATABASE_URL!,
  },
  verbose: true,
  strict: true,
} satisfies Config

Запустіть npx drizzle-kit generate:pg для генерації SQL та npx drizzle-kit push:pg для застосування (або npx drizzle-kit migrate).

Ініціалізація та приклади запитів

// db/index.ts
import { drizzle } from 'drizzle-orm/postgres-js'
import postgres from 'postgres'
import * as schema from './schema'

const connectionString = process.env.DATABASE_URL!

// Для міграцій — один коннект
const migrationClient = postgres(connectionString, { max: 1 })

// Для додатку — пул
const queryClient = postgres(connectionString, {
  max: 20,
  idle_timeout: 30,
  connect_timeout: 10,
})

export const db = drizzle(queryClient, {
  schema,
  logger: process.env.NODE_ENV === 'development',
})

// Приклади запитів
import { eq, and, desc, ilike, count } from 'drizzle-orm'

// Отримати користувача з постами
const user = await db.query.users.findFirst({
  where: eq(users.email, '[email protected]'),
  with: {
    posts: {
      where: eq(posts.published, true),
      limit: 5,
    },
  },
})

// Вставити пост
const [newPost] = await db
  .insert(posts)
  .values({ title: 'Hello', content: 'World', authorId: user.id })
  .returning()

// Оновити
await db.update(posts).set({ published: true }).where(eq(posts.id, newPost.id))

// Агрегація: кількість постів у користувача
const [stats] = await db
  .select({ count: count() })
  .from(posts)
  .where(eq(posts.authorId, user.id))

// Пагінація
const page = 1,
  pageSize = 10
const paginatedPosts = await db
  .select()
  .from(posts)
  .where(eq(posts.authorId, user.id))
  .orderBy(desc(posts.createdAt))
  .limit(pageSize)
  .offset((page - 1) * pageSize)

Які типи запитів підтримує Drizzle?

Drizzle підтримує всі стандартні SQL-операції: SELECT, INSERT, UPDATE, DELETE, JOINи, агрегації, підзапити, віконні функції. Бібліотека надає як Query Builder з ланцюжком методів, так і Relational Query API для зв'язків. Завдяки TypeScript-інференсу всі типи виводяться автоматично, що виключає помилки невідповідності полів.

Як оптимізувати запити з Drizzle?

Використовуйте явні індекси в схемі, пагінацію через LIMIT/OFFSET або курсори, уникайте SELECT *. Для складних звітів застосовуйте віконні функції. Drizzle не генерує неоптимальні запити — ви повністю контролюєте SQL. В одному проекті ми знизили навантаження на БД на 30% за рахунок правильної індексації та денормалізації.

Що входить в роботу

• Типізована схема бази даних
• Налаштування міграцій (безпечні apply/rollback)
• Ініціалізація пулу з'єднань з оптимізацією
• Написання типових запитів (CRUD, пагінація, пошук)
• Документація по схемі та API
• Навчання команди (2 сесії по 2 години)
• Підтримка 2 тижні після здачі

Порівняння Drizzle і Prisma

Типові команди міграції Drizzle

Процес налаштування

1. Аналіз — вивчаємо поточну схему БД, навантаження та вимоги.
2. Проектування — створюємо типізовану схему на TypeScript.
3. Міграції — генеруємо та тестуємо SQL-міграції на staging.
4. Інтеграція — підключаємо Drizzle до проекту, налаштовуємо пул та лог.
5. Деплой — розгортаємо з гарантією rollback.

Строки та гарантії

Базове налаштування — від 1 дня. Повна інтеграція з тестами — 1–2 дні. Портування з іншої ORM — 2–4 дні. Гарантуємо якість: всі міграції та запити тестуються на staging перед деплоєм. У нас понад 50 успішних проектів з Drizzle. Замовте налаштування Drizzle ORM — ми реалізуємо міграції та типізацію за 1–2 дні. Отримайте консультацію щодо міграції з Prisma на Drizzle — ми підготуємо план за один день. Зв'яжіться з нами — оцінимо ваш проект і запропонуємо оптимальне рішення.

Детальніше про Drizzle ORM читайте на GitHub.