Drizzle 쿼리 + CRUD

Drizzle은 데이터베이스를 쿼리하는 여러 가지 방법을 제공하며, 다음 프로젝트에서 어떤 방법을 사용할지는 여러분이 결정할 수 있습니다. SQL-like 문법 또는 Relational 문법 중 선택할 수 있습니다. 살펴보겠습니다:

왜 SQL-like인가?

SQL을 알면 Drizzle을 알 수 있습니다.

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

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

// 데이터 접근하기
await db
  .select()
	.from(posts)
	.leftJoin(comments, eq(posts.id, comments.post_id))
	.where(eq(posts.id, 10))

SELECT * 
FROM posts
LEFT JOIN comments ON posts.id = comments.post_id
WHERE posts.id = 10

SQL-like 문법을 사용하면 순수 SQL로 할 수 있는 대부분의 작업을 재현할 수 있으며, Drizzle이 무엇을 수행하고 어떤 쿼리가 생성될지 정확히 알 수 있습니다. select, insert, update, delete를 포함한 다양한 쿼리를 수행할 수 있으며, 별칭(alias), WITH 절, 서브쿼리, prepared statement 등도 사용할 수 있습니다. 더 많은 예제를 살펴보겠습니다

await db.insert(users).values({ email: 'user@gmail.com' })

INSERT INTO users (email) VALUES ('user@gmail.com')

await db.update(users)
        .set({ email: 'user@gmail.com' })
        .where(eq(users.id, 1))

UPDATE users 
SET email = 'user@gmail.com'
WHERE users.id = 1

await db.delete(users).where(eq(users.id, 1))

DELETE FROM users WHERE users.id = 1

왜 SQL-like가 아닌가?

우리는 항상 완벽하게 균형 잡힌 솔루션을 위해 노력합니다. SQL-like 쿼리가 여러분의 모든 요구사항을 100% 충족시키지만, 데이터를 더 효율적으로 쿼리할 수 있는 특정한 일반적인 시나리오가 있습니다.

우리는 조인이나 데이터 매핑을 걱정하지 않고 가장 편리하고 성능이 좋은 방식으로 데이터베이스에서 관계형, 중첩 데이터를 가져올 수 있도록 Queries API를 구축했습니다.

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

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

고급

Drizzle을 사용하면 원하는 방식으로 쿼리를 구성하고 분할할 수 있습니다. 메인 쿼리와 독립적으로 필터를 구성하거나, 서브쿼리 또는 조건문을 분리하는 등 다양한 작업이 가능합니다. 몇 가지 고급 예제를 살펴보겠습니다:

WHERE 문을 구성한 다음 쿼리에서 사용하기

async function getProductsBy({
  name,
  category,
  maxPrice,
}: {
  name?: string;
  category?: string;
  maxPrice?: string;
}) {
  const filters: SQL[] = [];

  if (name) filters.push(ilike(products.name, name));
  if (category) filters.push(eq(products.category, category));
  if (maxPrice) filters.push(lte(products.price, maxPrice));

  return db
    .select()
    .from(products)
    .where(and(...filters));
}

서브쿼리를 다른 변수로 분리한 다음 메인 쿼리에서 사용하기

const subquery = db
	.select()
	.from(internalStaff)
	.leftJoin(customUser, eq(internalStaff.userId, customUser.id))
	.as('internal_staff');

const mainQuery = await db
	.select()
	.from(ticket)
	.leftJoin(subquery, eq(subquery.internal_staff.userId, ticket.staffId));

다음 단계는?