Професійне налаштування 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.