Drizzle ORM

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

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

간단해 보이고 느껴지며, 프로젝트 시작 _1000일째_에도 여전히 뛰어난 성능을 발휘하고,
여러분이 원하는 방식으로 작업할 수 있게 해주며, 필요할 때 항상 함께합니다.

관계형 API와 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

// Access your data
await db
	.select()
	.from(countries)
	.leftJoin(cities, eq(cities.countryId, countries.id))
	.where(eq(countries.id, 10))

// manage your schema
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),
});

-- generate migrations
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가 대부분의 요구사항을 충족하지만, 더 나은 방식으로 데이터를 쿼리할 수 있는 특정한 일반적 시나리오들이 있습니다.

우리는 여러분을 위해 **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 드라이버를 지원하며, 정말 빠르게 새로운 드라이버를 추가하고 있습니다.