Drizzle <> Xata

**공식 웹사이트**에 따르면, Xata는 신뢰성, 확장성, 그리고 개발자 경험에 중점을 둔 Postgres 데이터 플랫폼입니다. Xata Postgres 서비스는 현재 베타 버전이며, 계정에서 이를 활성화하는 방법은 Xata 문서를 참고하세요.

Drizzle ORM은 Xata Postgres 데이터베이스에 접근하기 위해 xata 드라이버와 drizzle-orm/xata 패키지를 기본적으로 지원하며, postgres 또는 pg 드라이버도 지원합니다.

1단계 - 패키지 설치

npm i drizzle-orm @xata.io/client
npm i -D drizzle-kit

yarn add drizzle-orm @xata.io/client
yarn add -D drizzle-kit

pnpm add drizzle-orm @xata.io/client
pnpm add -D drizzle-kit

bun add drizzle-orm @xata.io/client
bun add -D drizzle-kit

Drizzle를 Xata와 함께 사용할 때는 HTTP 클라이언트나 TCP 클라이언트를 선택할 수 있습니다. HTTP 클라이언트는 Xata 서버와 지속적인 연결을 생성하지 않지만, TCP 클라이언트는 연결을 유지하며 더 많은 요청을 처리할 때 성능이 더 좋습니다. HTTP 클라이언트는 일반적으로 Cloudflare Workers나 Vercel Edge Functions 같은 서버리스 환경에서 권장됩니다. TCP 클라이언트는 Express.js나 Fastify 같은 장기 실행 서버에서 주로 사용됩니다.

아래 예제는 xata init CLI 커맨드를 실행하여 생성된 Xata 클라이언트를 사용합니다.

import { drizzle } from 'drizzle-orm/xata-http';
import { getXataClient } from './xata'; // 생성된 클라이언트

const xata = getXataClient();
const db = drizzle(xata);

const result = await db.select().from(...);

import { drizzle } from 'drizzle-orm/node-postgres';
import { getXataClient } from './xata'; // 생성된 클라이언트
import { Client } from 'pg';

const xata = getXataClient();
const client = new Client({ connectionString: xata.sql.connectionString });
const db = drizzle(client);

import { drizzle } from 'drizzle-orm/node-postgres';
import { getXataClient } from './xata'; // 생성된 클라이언트
import { Pool } from 'pg';

const xata = getXataClient();
const pool = new Pool({ connectionString: xata.sql.connectionString, max: 10 });
const db = drizzle(pool);

생성된 Xata 클라이언트를 사용하지 않으려면 **postgres**나 pg 드라이버를 사용하여 Xata와 연결할 수도 있습니다. 이 경우 Xata 데이터베이스의 설정 페이지에서 연결 문자열을 복사하면 됩니다. 자세한 내용은 PostgreSQL 연결 섹션을 참고하세요.

Drizzle와 Xata를 함께 사용하는 방법에 대한 더 자세한 내용은 공식 Xata 문서를 확인하세요.

다음 단계는 무엇인가요?