Почему Drizzle?

Drizzle ORM ориентирован на типобезопасность и генерацию типов на базе схемы базы данных, что упрощает работу с TypeScript в backend-части приложений. В 2025–2026 годах Drizzle активно развивается и предлагает низкоуровневые инструменты для работы с SQL без лишней абстракции. Кратко: Drizzle даёт явные типы для запросов и результатов, небольшую runtime-надстройку и удобные утилиты для миграций (drizzle-kit). Подходит, если нужна строгая типизация и контроль SQL.

Что лучше Prisma?

Prisma — зрелая ORM с мощным генератором миграций и широким экосистемным покрытием; она предоставляет удобный DSL и генерацию клиентского API. Drizzle фокусируется на минимальной runtime-слое и прямой работе с SQL, выдавая строгие TypeScript-типы на уровне схемы и запросов. Короткое сравнение по критериям: Типобезопасность: обе библиотеки дают статическую типизацию; Drizzle ближе к SQL и даёт явные типы по колонкам, Prisma предлагает удобный типизированный клиент на основе schema.prisma. Контроль SQL: Drizzle менее абстрагирует SQL и оставляет больше контроля, Prisma генерирует SQL за вас через клиент. Миграции: Prisma имеет зрелую систему миграций; Drizzle использует drizzle-kit, которая в 2025–2026 годах догоняет по функционалу и отлично подходит для проектов, где важна прозрачность SQL. Продуктивность и поверхность API: Prisma предлагает более дружелюбный DSL для быстрого старта; Drizzle предпочтительнее, если нужен контроль и минимальный runtime. Выбор зависит от приоритетов:...

Как подключить Drizzle к существующей базе данных?

Создайте схему в виде таблиц Drizzle, но если у вас уже есть структура в базе, используйте drizzle-kit в режиме сравнения схемы или создайте миграцию вручную, экспортируя текущую структуру как первый миграционный скрипт. Для минимального риска снимите дамп структуры с помощью pg_dump -s, сохраните в каталог миграций и примените на тестовом окружении. Перед применением миграций на проде всегда проверяйте SQL и выполняйте backup.

Что делать при ошибке permission denied for relation?

Эта ошибка указывает, что пользователь БД не имеет прав на таблицу. Проверьте пользователя, указанный в DATABASE_URL, и назначьте права: подключитесь от суперпользователя и выполните GRANT ALL PRIVILEGES ON TABLE public.users TO your_user; или назначьте роль с соответствующими правами. Также проверьте схему (namespace) таблиц — возможно, таблицы созданы в другой схеме.

Почему запросы Drizzle медленнее на CI, чем локально?

Частые причины: сеть (CI может иметь ограниченную пропускную способность), отсутствие кэша зависимостей и медленный диск. Для ускорения на CI используйте кэширование слоя node_modules, используйте контейнеры с SSD, настройте пул соединений и уменьшите время создания БД(instance) на CI, например, используйте подготовленные снимки базы или тестовые контейнеры с предзаполненной схемой.

Где лучше хранить инстанс db в Next.js?

Храните экземпляр DB в файловой области сервера (например, src/db/client.ts) и импортируйте только в server actions или server components. Не передавайте объект DB в клиентские компоненты и не сериализуйте его. В случае серверлесс-среды используйте ленивую инициализацию и пул соединений вместе с библиотеками, адаптированными под serverless (но при использовании postgres/drizzle предпочтительнее держать одно соединение-пул при долгоживущих процессах). Смотрите также: Проекты и Топ статей на ресурсе для примеров развёртывания и CI/CD.

Drizzle ORM + Next.js: типобезопасный backend

# 1) Создать проект Next.js (CLI Next 14)
npm init next@14 my-app --typescript
cd my-app

# 2) Установить Drizzle, drizzle-kit, драйвер pg и типы
npm install drizzle-orm drizzle-kit pg @types/pg

# 3) Установить дополнительные утилиты для разработки
npm install -D ts-node dotenv

+ drizzle-orm@2.x
+ drizzle-kit@2.x
+ pg@8.x
added 120 packages, and audited 121 packages in 2s

import { pgTable, serial, text, varchar, timestamp } from 'drizzle-orm/pg-core'

export const users = pgTable('users', {
  id: serial('id').primaryKey(),
  email: varchar('email', { length: 255 }).notNull(),
  name: varchar('name', { length: 100 }).notNull(),
  created_at: timestamp('created_at').defaultNow().notNull(),
})

export const posts = pgTable('posts', {
  id: serial('id').primaryKey(),
  author_id: users.id, // foreign key-like reference for types
  title: varchar('title', { length: 200 }).notNull(),
  body: text('body').notNull(),
  published_at: timestamp('published_at'),
})

Found 0 errors in 42 files.

# 1) Конфигурация drizzle-kit: drizzle.config.mjs
export default {
  schema: './src/db/schema.ts',
  out: './drizzle/migrations',
  driver: 'pg',
  dbCredentials: process.env.DATABASE_URL,
}

# 2) Сгенерировать миграцию
npx drizzle-kit generate

# 3) Применить миграции
npx drizzle-kit push

✅ Migration created: 20260101_create_users_and_posts.sql

Applying migration 20260101_create_users_and_posts.sql
✔ Migration applied

// src/db/client.ts
import { drizzle } from 'drizzle-orm/node-postgres'
import postgres from 'postgres'
import { env } from 'process'

const sql = postgres(env.DATABASE_URL!)
export const db = drizzle(sql)

// src/app/actions/postActions.ts
'use server'
import { db } from '@/db/client'
import { posts } from '@/db/schema'

export async function createPost(data: { title: string; body: string; authorId: number }) {
  const res = await db.insert(posts).values({
    title: data.title,
    body: data.body,
    author_id: data.authorId,
  }).returning()
  return res[0]
}

import { createPost } from './actions/postActions'

export default async function Page() {
  const newPost = await createPost({ title: 'Hello', body: 'World', authorId: 1 })
  // newPost типизирован как RowType для posts
  return {JSON.stringify(newPost)}
}

{
  "id": 1,
  "author_id": 1,
  "title": "Hello",
  "body": "World",
  "published_at": null
}

# Dockerfile (multi-stage)
FROM node:20-alpine AS builder
WORKDIR /app
COPY package*.json pnpm-lock.yaml* ./
RUN npm ci --prefer-offline
COPY . .
RUN npm run build

FROM node:20-alpine AS runner
WORKDIR /app
ENV NODE_ENV=production
COPY --from=builder /app/.next .next
COPY --from=builder /app/node_modules ./node_modules
COPY --from=builder /app/package.json ./package.json
EXPOSE 3000
CMD ["node", ".next/server/app.js"]

version: '3.8'
services:
  db:
    image: postgres:16-alpine
    environment:
      POSTGRES_PASSWORD: example
    ports:
      - "5432:5432"
    volumes:
      - pgdata:/var/lib/postgresql/data
  app:
    build: .
    environment:
      DATABASE_URL: postgres://postgres:example@db:5432/postgres
    ports:
      - "3000:3000"
    depends_on:
      - db
volumes:
  pgdata:

Building app
Step 1/10 : FROM node:20-alpine AS builder
 ---> 2a3b... (image id)
Successfully built 5f3c...
Creating project_db_1 ... done
Creating project_app_1 ... done

Drizzle ORM + Next.js: типобезопасный backend | KtoHto

Drizzle ORM + Next.js: типобезопасный backend

Комментарии (0)

Почему Drizzle?

Что вы изучите

Требования

Шаг 1: установка

Шаг 2: схема таблиц

Шаг 3: миграции

Шаг 4: queries в server actions

Шаг 5: тестирование и развёртывание (Docker)

Что лучше Prisma?

Частые вопросы

Как подключить Drizzle к существующей базе данных?

Что делать при ошибке `permission denied for relation`?

Почему запросы Drizzle медленнее на CI, чем локально?

Где лучше хранить инстанс `db` в Next.js?