Drizzle <> Neon Postgres

This guide assumes familiarity with:

Drizzle을 사용한 데이터베이스 연결 기초
Neon 서버리스 데이터베이스 - 웹사이트
Neon 서버리스 드라이버 - 문서 & GitHub
Drizzle PostgreSQL 드라이버 - 문서

Drizzle은 neon-http 및 neon-websockets 드라이버를 통해 Neon 연결을 기본적으로 지원합니다. 이들은 내부적으로 neon-serverless 드라이버를 사용합니다.

neon-http 및 neon-websockets 드라이버를 사용하면 TCP 대신 HTTP 또는 WebSocket을 통해 서버리스 환경에서 Neon 데이터베이스에 접근할 수 있습니다. HTTP를 통한 쿼리는 단일 비대화형 트랜잭션에 더 빠릅니다.

세션 또는 대화형 트랜잭션 지원이 필요하거나 pg 드라이버의 완전 호환 대체제가 필요한 경우 WebSocket 기반 neon-serverless 드라이버를 사용할 수 있습니다. Postgres를 사용하여 Neon 데이터베이스에 직접 연결할 수 있습니다

Cloudflare Worker에서 Neon Serverless 드라이버와 함께 Drizzle ORM을 사용하는 예제는 **여기**를 참조하세요. 서버풀 환경에서 Neon을 사용하려면 Neon의 **공식 Node.js 문서**에 설명된 대로 PostgresJS 드라이버를 사용할 수 있습니다 — 문서 참조.

1단계 - 패키지 설치

npm

yarn

pnpm

bun

npm i drizzle-orm @neondatabase/serverless
npm i -D drizzle-kit

yarn add drizzle-orm @neondatabase/serverless
yarn add -D drizzle-kit

pnpm add drizzle-orm @neondatabase/serverless
pnpm add -D drizzle-kit

bun add drizzle-orm @neondatabase/serverless
bun add -D drizzle-kit

2단계 - 드라이버 초기화 및 쿼리 실행

Neon HTTP

Neon Websockets

node-postgres

postgres.js

import { drizzle } from 'drizzle-orm/neon-http';

const db = drizzle(process.env.DATABASE_URL);

const result = await db.execute('select 1');

import { drizzle } from 'drizzle-orm/neon-serverless';

const db = drizzle(process.env.DATABASE_URL);

const result = await db.execute('select 1');

// For Node.js - make sure to install the 'ws' and 'bufferutil' packages
import { drizzle } from 'drizzle-orm/neon-serverless';
import ws from 'ws';

const db = drizzle({
  connection: process.env.DATABASE_URL,
  ws: ws,
});

const result = await db.execute('select 1');

IMPORTANT

Node.js와 같이 WebSocket 전역이 정의되지 않은 환경에서 WebSocket을 사용하려면 추가 구성이 필요합니다. 프로젝트 의존성에 ws 및 bufferutil 패키지를 추가하고 Drizzle 구성에서 ws를 설정하세요.

// Make sure to install the 'pg' package 
import { drizzle } from 'drizzle-orm/node-postgres';

const db = drizzle(process.env.DATABASE_URL);
 
const result = await db.execute('select 1');

// Make sure to install the 'postgres' package
import { drizzle } from 'drizzle-orm/postgres-js';

const db = drizzle(process.env.DATABASE_URL);

const result = await db.execute('select 1');

기존 드라이버를 제공해야 하는 경우:

Neon HTTP

Neon Websockets

node-postgres

postgres.js

import { neon } from '@neondatabase/serverless';
import { drizzle } from 'drizzle-orm/neon-http';

const sql = neon(process.env.DATABASE_URL!);
const db = drizzle({ client: sql });

const result = await db.execute('select 1');

import { Pool } from '@neondatabase/serverless';
import { drizzle } from 'drizzle-orm/neon-serverless';

const pool = new Pool({ connectionString: process.env.DATABASE_URL });
const db = drizzle({ client: pool })

const result = await db.execute('select 1');

// For Node.js - make sure to install the 'ws' and 'bufferutil' packages
import { Pool, neonConfig } from '@neondatabase/serverless';
import { drizzle } from 'drizzle-orm/neon-serverless';

neonConfig.webSocketConstructor = ws;

const pool = new Pool({ connectionString: process.env.DATABASE_URL });
const db = drizzle({ client: pool })

const result = await db.execute('select 1');

IMPORTANT

// Make sure to install the 'pg' package 
import { drizzle } from "drizzle-orm/node-postgres";
import { Pool } from "pg";

const pool = new Pool({
  connectionString: process.env.DATABASE_URL,
});
const db = drizzle({ client: pool });
 
const result = await db.execute('select 1');

// Make sure to install the 'postgres' package
import { drizzle } from 'drizzle-orm/postgres-js';
import postgres from 'postgres';

const queryClient = postgres(process.env.DATABASE_URL);
const db = drizzle({ client: queryClient });

const result = await db.execute('select 1');

다음 단계는?

Manage schema

Drizzle Schema PostgreSQL data types Indexes and Constraints Database Views Database Schemas Sequences Extensions

Query data

Relational Queries Select Insert Update Delete Filters Joins sql`` operator