> ## Documentation Index > Fetch the complete documentation index at: https://villagesql.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # Next.js와 Drizzle로 MySQL 사용하기 > Drizzle ORM과 mysql2 드라이버를 사용해 Next.js App Router 애플리케이션을 MySQL에 연결하는 방법: 스키마 정의, drizzle-kit을 이용한 마이그레이션, Server Component, Server Action, 그리고 오래된 데이터베이스 행을 제공하는 정적 렌더링 함정입니다. > [card] [VillageSQL is a drop-in replacement for MySQL with extensions.](https://villagesql.com/docs/en/8.4/stable/install-server.md) > > All examples on this page work on VillageSQL. Install Now → Drizzle ORM은 스키마 파일에서 SQL 마이그레이션을 생성하고 타입이 지정된 쿼리 API를 제공하는 TypeScript 쿼리 빌더이며, 자체 중간 쿼리 언어가 없습니다. 이 가이드는 Drizzle과 `mysql2` 드라이버를 통해 Next.js App Router 애플리케이션을 MySQL에 연결하며, 스키마, 마이그레이션, Server Component에서의 읽기, Server Action에서의 쓰기를 다룹니다. `create-next-app --src-dir`로 스캐폴딩한 기존 앱을 전제로 하며, 이 옵션이 코드 예제가 사용하는 `@/*` 임포트 별칭을 설정합니다. ## Drizzle과 MySQL 드라이버 설치 Drizzle은 MySQL과 통신하기 위해 `mysql2` 드라이버가 필요하고, 마이그레이션을 생성하고 실행하기 위해 `drizzle-kit`이 필요합니다: ```bash theme={null} npm install drizzle-orm mysql2 npm install -D drizzle-kit tsx dotenv ``` `drizzle-kit`은 빠르게 변하며, `latest`와 함께 `dist-tags` 아래에 사전 릴리스 태그(`beta`, `rc`)를 게시해 왔습니다. 설치하기 전에 `npm view drizzle-orm dist-tags`와 `npm view drizzle-kit dist-tags`를 확인해 `latest`가 릴리스 후보가 아니라 실제로 안정 릴리스를 가리키는지 확인하세요. `.env`에 연결 문자열을 설정하세요: ```bash theme={null} DATABASE_URL="mysql://drizzle_app:your_password@127.0.0.1:3306/your_database" ``` ## 데이터베이스 사용자 만들기 애플리케이션을 `root`로 연결하는 대신, 전용 데이터베이스와 그 범위로 제한된 사용자를 만드세요: ```sql theme={null} CREATE DATABASE drizzle_guide; CREATE USER 'drizzle_app'@'127.0.0.1' IDENTIFIED BY 'your_password'; GRANT ALL PRIVILEGES ON drizzle_guide.* TO 'drizzle_app'@'127.0.0.1'; ``` Unix 소켓을 통한 연결은 어떤 IP 기반 권한이 있든 항상 `'localhost'` 호스트와 대조됩니다. `'drizzle_app'@'127.0.0.1'`로만 만든 사용자는 소켓을 통해 인증할 수 없습니다. `127.0.0.1`로의 TCP 연결은 역방향 DNS 조회로 대조되므로, 그 연결이 `'localhost'` 권한도 만족하는지는 고정된 MySQL 규칙이 아니라 서버가 `127.0.0.1`을 어떻게 해석하느냐에 달려 있습니다. 애플리케이션이 실제로 사용하는 호스트에 권한을 부여하고, `127.0.0.1`과 `localhost`가 서로 바꿔 쓸 수 있다고 믿지 마세요. ## 스키마 정의 Drizzle의 MySQL 스키마는 `drizzle-orm/mysql-core`의 함수를 사용해 각 열을 기술합니다: ```typescript src/db/schema.ts theme={null} import { int, mysqlTable, text, timestamp, varchar } from "drizzle-orm/mysql-core"; export const posts = mysqlTable("posts", { id: int("id").autoincrement().primaryKey(), title: varchar("title", { length: 255 }).notNull(), body: text("body").notNull(), createdAt: timestamp("created_at").defaultNow().notNull(), }); ``` `varchar`는 명시적인 `length`가 필요합니다. MySQL은 PostgreSQL과 달리 열 타입에 최대 길이를 박아 넣은 채로 `VARCHAR`를 저장하므로, Drizzle에는 의지할 기본값이 없고 값을 미리 받아야 합니다. ## drizzle-kit 설정 `drizzle-kit`은 스키마가 어디에 있고 데이터베이스에 어떻게 접근하는지 알기 위해 설정 파일을 읽습니다: ```typescript drizzle.config.ts theme={null} import { defineConfig } from "drizzle-kit"; if (!process.env.DATABASE_URL) { throw new Error("DATABASE_URL is not set"); } export default defineConfig({ out: "./drizzle", schema: "./src/db/schema.ts", dialect: "mysql", dbCredentials: { url: process.env.DATABASE_URL, }, }); ``` `drizzle-kit`은 설정 파일이 실행되기 전에 스스로 `.env`를 읽으므로, 여기서는 `dotenv` 임포트 없이도 `process.env.DATABASE_URL`이 이미 채워져 있습니다. 이것은 `drizzle-kit`에만 해당합니다: 이 가이드 뒷부분의 검증 스크립트가 보여주듯이, 일반 Node나 `tsx` 스크립트에는 그런 로더가 내장되어 있지 않습니다. `package.json`에 마이그레이션 스크립트를 추가하세요: ```json package.json theme={null} { "scripts": { "db:generate": "drizzle-kit generate", "db:migrate": "drizzle-kit migrate" } } ``` ## 마이그레이션 생성 및 실행 `drizzle-kit generate`는 스키마 파일을 마지막으로 생성된 마이그레이션과 비교해 새 SQL 파일을 씁니다: ```bash theme={null} npm run db:generate ``` ``` No config path provided, using default 'drizzle.config.ts' Reading config file '/path/to/your-app/drizzle.config.ts' Reading schema files: /path/to/your-app/src/db/schema.ts 1 tables posts 4 columns 0 indexes 0 fks [✓] Your SQL migration file ➜ drizzle/0000_premium_tiger_shark.sql 🚀 ``` `drizzle-kit`은 설정과 스키마 경로를 절대 경로로 출력합니다. 위의 `/path/to/your-app`은 여러분의 프로젝트 디렉터리를 대신합니다. 생성된 파일 이름에는 무작위 두 단어 접미사가 포함되므로 여러분의 것은 다를 것입니다. 순서에 의미가 있는 것은 숫자 접두사(`0000`)뿐입니다. 스키마 변경 없이 `db:generate`를 다시 실행하면 두 번째 파일을 쓰는 대신 `No schema changes, nothing to migrate`를 보고합니다. 마이그레이션 자체는 일반 SQL입니다: ```sql drizzle/0000_premium_tiger_shark.sql theme={null} CREATE TABLE `posts` ( `id` int AUTO_INCREMENT NOT NULL, `title` varchar(255) NOT NULL, `body` text NOT NULL, `created_at` timestamp NOT NULL DEFAULT (now()), CONSTRAINT `posts_id` PRIMARY KEY(`id`) ); ``` 적용하세요: ```bash theme={null} npm run db:migrate ``` `drizzle-kit migrate`는 처음 실행될 때 어떤 마이그레이션 파일이 이미 적용되었는지 추적하기 위해 `__drizzle_migrations` 테이블을 만듭니다. 두 테이블이 모두 존재하는지 확인하세요: ```bash theme={null} mysql -h 127.0.0.1 -P 3306 -u drizzle_app -p drizzle_guide -e "SHOW TABLES;" ``` ``` Tables_in_drizzle_guide __drizzle_migrations posts ``` ## 데이터베이스 클라이언트 만들기 `mysql2` 드라이버는 풀을 통해 연결하고, Drizzle은 그 풀을 감쌉니다: ```typescript src/db/index.ts theme={null} import { drizzle } from "drizzle-orm/mysql2"; import mysql from "mysql2/promise"; import * as schema from "./schema"; if (!process.env.DATABASE_URL) { throw new Error("DATABASE_URL is not set"); } const poolConnection = mysql.createPool(process.env.DATABASE_URL); export const db = drizzle(poolConnection, { schema, mode: "default" }); ``` `mode: "default"` 옵션은 `mysql2` 드라이버에만 있으며, Drizzle의 PostgreSQL이나 SQLite 드라이버에는 대응하는 것이 없습니다. 생략하면 조용한 기본값이 아니라 타입 오류입니다. ## Server Component에서 게시물 읽기 Server Component는 중간에 API 라우트 없이 렌더링 중에 `db.select()`를 직접 호출할 수 있습니다: ```typescript src/app/page.tsx theme={null} import { db } from "@/db"; import { posts } from "@/db/schema"; import { desc } from "drizzle-orm"; import { createPost } from "./actions"; export const dynamic = "force-dynamic"; export default async function Home() { const allPosts = await db.select().from(posts).orderBy(desc(posts.createdAt)); return (

Posts