Drizzle ORM

Drizzle ORM은 헤드가 있는 헤드리스 TypeScript ORM입니다. 🐲

Drizzle은 필요할 때 곁에 있어주고, 공간이 필요할 때는 방해하지 않는 좋은 친구입니다.

간단해 보이고 실제로도 간단하며, 프로젝트 _1000일차_에도 여전히 뛰어난 성능을 발휘하고,
원하는 방식대로 작업할 수 있게 해주며, 필요할 때 항상 곁에 있습니다.

관계형 및 SQL-like 쿼리 API를 모두 제공하는 유일한 ORM으로, 관계형 데이터에 접근할 때 두 세계의 장점을 모두 제공합니다. Drizzle은 가볍고, 성능이 뛰어나며, 타입 안전하고, 유당 불포함, 글루텐 프리, 맑은 정신, 유연하며 설계상 서버리스 지원됩니다. Drizzle은 단순한 라이브러리가 아니라 경험입니다. 🤩

헤드리스 ORM?

무엇보다도 Drizzle은 라이브러리이자 선택적으로 사용할 수 있는 보완 도구 모음입니다.

ORM은 객체 관계 매핑(object relational mapping) 을 의미하며, 개발자들은 Django나 Spring과 같은 도구를 ORM이라고 부르는 경향이 있습니다. 우리는 이것이 레거시 명명법에 기반한 오해라고 진심으로 믿으며, 이들을 데이터 프레임워크라고 부릅니다.

WARNING

데이터 프레임워크를 사용하면 프로젝트를 그것들을 중심으로 구축해야 하며 그것들과 함께 구축할 수 없습니다.

Drizzle은 프로젝트나 구조를 방해하지 않고 원하는 방식으로 프로젝트를 구축할 수 있게 해줍니다.

Drizzle을 사용하면 TypeScript로 데이터베이스 스키마를 정의하고 관리하며, SQL-like 또는 관계형 방식으로 데이터에 접근하고, 선택적 도구를 활용하여 개발자 경험을 최고 수준으로 끌어올릴 수 있습니다. 🤯

왜 SQL-like인가요?

SQL을 안다면 Drizzle도 아는 것입니다.

다른 ORM과 데이터 프레임워크는 SQL에서 벗어나거나 추상화하는 경향이 있어, 이중 학습 곡선을 초래합니다: SQL과 프레임워크의 API를 모두 알아야 합니다.

Drizzle은 그 반대입니다. 우리는 SQL을 받아들이고 Drizzle을 핵심적으로 SQL-like하게 만들었기 때문에, 학습 곡선이 거의 없거나 전혀 없으며 SQL의 모든 기능에 접근할 수 있습니다.

우리는 친숙한 SQL 스키마, 쿼리, 자동 마이그레이션 그리고 **한 가지 더**를 제공합니다. ✨

index.ts

schema.ts

migration.sql

// 데이터에 접근하기
await db
	.select()
	.from(countries)
	.leftJoin(cities, eq(cities.countryId, countries.id))
	.where(eq(countries.id, 10))

// 스키마 관리하기
export const countries = pgTable('countries', {
  id: serial('id').primaryKey(),
  name: varchar('name', { length: 256 }),
});

export const cities = pgTable('cities', {
  id: serial('id').primaryKey(),
  name: varchar('name', { length: 256 }),
  countryId: integer('country_id').references(() => countries.id),
});

-- 마이그레이션 생성하기
CREATE TABLE IF NOT EXISTS "countries" (
	"id" serial PRIMARY KEY NOT NULL,
	"name" varchar(256)
);

CREATE TABLE IF NOT EXISTS "cities" (
	"id" serial PRIMARY KEY NOT NULL,
	"name" varchar(256),
	"country_id" integer
);

ALTER TABLE "cities" ADD CONSTRAINT "cities_country_id_countries_id_fk" FOREIGN KEY ("country_id") REFERENCES "countries"("id") ON DELETE no action ON UPDATE no action;

왜 SQL-like가 아닌가요?

우리는 항상 완벽하게 균형 잡힌 솔루션을 추구하고 있으며, SQL-like가 100%의 요구사항을 충족하지만, 더 나은 방식으로 데이터를 쿼리할 수 있는 특정한 일반적인 시나리오가 있습니다.

우리는 여러분을 위해 **Queries API**를 구축했습니다. 이를 통해 가장 편리하고 성능 좋은 방식으로 데이터베이스에서 관계형 중첩 데이터를 가져올 수 있으며, 조인과 데이터 매핑에 대해 생각할 필요가 없습니다.

Drizzle은 항상 정확히 1개의 SQL 쿼리를 출력합니다. 서버리스 데이터베이스와 함께 자유롭게 사용하시고 성능이나 왕복 비용에 대해 걱정하지 마세요!

const result = await db.query.users.findMany({
	with: {
		posts: true
	},
});

서버리스?

가장 좋은 부분은 없는 것입니다. Drizzle은 정확히 0개의 의존성을 가집니다!

Drizzle ORM은 방언별로 특화되고, 슬림하며, 고성능이고 설계상 서버리스 지원됩니다.

우리는 Postgres, MySQL 등을 포함한 최고 수준의 SQL 방언 지원을 제공하기 위해 많은 시간을 투자했습니다.

Drizzle은 업계 표준 데이터베이스 드라이버를 통해 기본적으로 작동합니다. 우리는 모든 주요 PostgreSQL, MySQL, SQLite 또는 SingleStore 드라이버를 지원하며, 정말 빠르게 새로운 드라이버를 추가하고 있습니다.