CRUD 작업

출처 URL: https://docs.prisma.io/docs/orm/prisma-client/queries/relation-queries

CRUD 작업

생성(Create), 조회(Read), 수정(Update), 삭제(Delete) 작업을 수행하는 방법을 알아보세요.

이 페이지에서는 Prisma Client로 CRUD 작업을 수행하는 방법을 설명합니다:

• 생성(Create) - 레코드 삽입
• 조회(Read) - 레코드 조회
• 수정(Update) - 레코드 수정
• 삭제(Delete) - 레코드 제거

자세한 메서드 문서는 Prisma Client API 레퍼런스를 확인하세요.

생성

• 단일 레코드 생성

    const user = await prisma.user.create({
      data: {
        email: "elsa@prisma.io",
        name: "Elsa Prisma",
      },
    });

id는 자동 생성됩니다. 어떤 필드가 필수인지 여부는 스키마에 따라 결정됩니다.

• 여러 레코드 생성

    const createMany = await prisma.user.createMany({
      data: [
        { name: "Bob", email: "bob@prisma.io" },
        { name: "Yewande", email: "yewande@prisma.io" },
      ],
      skipDuplicates: true, // Skip records with duplicate unique fields
    });
    // Returns: { count: 2 }

skipDuplicates는 MongoDB, SQLServer, SQLite에서 지원되지 않습니다.

• 여러 레코드를 생성하고 반환

PostgreSQL, CockroachDB, SQLite에서 지원됩니다.

    const users = await prisma.user.createManyAndReturn({
      data: [
        { name: "Alice", email: "alice@prisma.io" },
        { name: "Bob", email: "bob@prisma.io" },
      ],
    });

관계가 있는 레코드를 생성하려면 Nested writes를 참고하세요.

조회

• ID 또는 고유 필드로 레코드 가져오기

    // By unique field
    const user = await prisma.user.findUnique({
      where: { email: "elsa@prisma.io" },
    });

    // By ID
    const user = await prisma.user.findUnique({
      where: { id: 99 },
    });

• 모든 레코드 가져오기

    const users = await prisma.user.findMany();

• 첫 번째 일치 레코드 가져오기

    const user = await prisma.user.findFirst({
      where: { posts: { some: { likes: { gt: 100 } } } },
      orderBy: { id: "desc" },
    });

• 레코드 필터링

    // Single field filter
    const users = await prisma.user.findMany({
      where: { email: { endsWith: "prisma.io" } },
    });

    // Multiple conditions with OR/AND
    const users = await prisma.user.findMany({
      where: {
        OR: [{ name: { startsWith: "E" } }, { AND: { profileViews: { gt: 0 }, role: "ADMIN" } }],
      },
    });

    // Filter by related records
    const users = await prisma.user.findMany({
      where: {
        email: { endsWith: "prisma.io" },
        posts: { some: { published: false } },
      },
    });

더 많은 예시는 Filtering and sorting를 참고하세요.

• 필드 선택

    const user = await prisma.user.findUnique({
      where: { email: "emma@prisma.io" },
      select: { email: true, name: true },
    });
    // Returns: { email: 'emma@prisma.io', name: "Emma" }

• 관련 레코드 포함

    const users = await prisma.user.findMany({
      where: { role: "ADMIN" },
      include: { posts: true },
    });

자세한 내용은 Select fields와 Relation queries를 참고하세요.

수정

• 단일 레코드 업데이트

    const updateUser = await prisma.user.update({
      where: { email: "viola@prisma.io" },
      data: { name: "Viola the Magnificent" },
    });

• 여러 레코드 업데이트

    const updateUsers = await prisma.user.updateMany({
      where: { email: { contains: "prisma.io" } },
      data: { role: "ADMIN" },
    });
    // Returns: { count: 19 }

• 여러 레코드를 업데이트하고 반환

PostgreSQL, CockroachDB, SQLite에서 지원됩니다.

    const users = await prisma.user.updateManyAndReturn({
      where: { email: { contains: "prisma.io" } },
      data: { role: "ADMIN" },
    });

• Upsert (업데이트 또는 생성)

    const upsertUser = await prisma.user.upsert({
      where: { email: "viola@prisma.io" },
      update: { name: "Viola the Magnificent" },
      create: { email: "viola@prisma.io", name: "Viola the Magnificent" },
    });

findOrCreate()를 에뮬레이트하려면 update 파라미터를 비운 upsert()를 사용하세요.

• 원자적 숫자 연산

    await prisma.post.updateMany({
      data: {
        views: { increment: 1 },
        likes: { increment: 1 },
      },
    });

관련 레코드 연결 및 연결 해제는 Relation queries를 참고하세요.

삭제

• 단일 레코드 삭제

다음 쿼리는 delete()를 사용해 단일 User 레코드를 삭제합니다:

    const deleteUser = await prisma.user.delete({
      where: {
        email: "bert@prisma.io",
      },
    });

게시물이 하나 이상 있는 사용자를 삭제하려고 하면 오류가 발생합니다. 모든 Post에는 작성자가 필요하기 때문입니다. cascading deletes를 참고하세요.

• 여러 레코드 삭제

다음 쿼리는 deleteMany()를 사용해 email에 prisma.io가 포함된 모든 User 레코드를 삭제합니다:

    const deleteUsers = await prisma.user.deleteMany({
      where: {
        email: {
          contains: "prisma.io",
        },
      },
    });

게시물이 하나 이상 있는 사용자를 삭제하려고 하면 오류가 발생합니다. 모든 Post에는 작성자가 필요하기 때문입니다. cascading deletes를 참고하세요.

• 모든 레코드 삭제

다음 쿼리는 deleteMany()를 사용해 모든 User 레코드를 삭제합니다:

    const deleteUsers = await prisma.user.deleteMany({});

이 쿼리는 사용자에게 관련 레코드(예: 게시물)가 있으면 실패합니다. 이 경우 관련 레코드를 먼저 삭제해야 합니다.

• 연쇄 삭제(관련 레코드 삭제)

referential actions를 사용해 연쇄 삭제를 구성할 수 있습니다.

다음 쿼리는 delete()를 사용해 단일 User 레코드를 삭제합니다:

    const deleteUser = await prisma.user.delete({
      where: {
        email: "bert@prisma.io",
      },
    });

하지만 예시 스키마에는 Post와 User 사이에 필수 관계(required relation) 가 포함되어 있으므로 게시물이 있는 사용자는 삭제할 수 없습니다:

    The change you are trying to make would violate the required relation 'PostToUser' between the `Post` and `User` models.

이 오류를 해결하려면 다음 중 하나를 수행할 수 있습니다:

• 관계를 선택 사항으로 변경:

model Post {
          id       Int   @id @default(autoincrement())
          author   User? @relation(fields: [authorId], references: [id])
          authorId Int?
          author   User  @relation(fields: [authorId], references: [id])
          authorId Int
        }

• 사용자를 삭제하기 전에 게시물의 작성자를 다른 사용자로 변경합니다.

• 트랜잭션에서 두 개의 별도 쿼리로 사용자와 해당 사용자의 모든 게시물을 삭제합니다(모든 쿼리가 성공해야 함):

const deletePosts = prisma.post.deleteMany({
          where: {
            authorId: 7,
          },
        });

        const deleteUser = prisma.user.delete({
          where: {
            id: 7,
          },
        });

        const transaction = await prisma.$transaction([deletePosts, deleteUser]);

• 모든 테이블에서 모든 레코드 삭제

때로는 실제 테이블은 유지하면서 모든 테이블의 모든 데이터를 제거하고 싶을 수 있습니다. 이는 특히 개발 환경과 테스트 중에 유용합니다.

아래에서는 Prisma Client와 Prisma Migrate를 사용해 모든 테이블의 모든 레코드를 삭제하는 방법을 보여줍니다.

• deleteMany()로 모든 데이터 삭제

테이블을 어떤 순서로 삭제해야 하는지 알고 있다면 deleteMany 함수를 사용할 수 있습니다. 이 함수는 $transaction에서 동기적으로 실행되며 모든 유형의 데이터베이스에서 사용할 수 있습니다.

    const deletePosts = prisma.post.deleteMany();
    const deleteProfile = prisma.profile.deleteMany();
    const deleteUsers = prisma.user.deleteMany();

    // The transaction runs synchronously so deleteUsers must run last.
    await prisma.$transaction([deleteProfile, deletePosts, deleteUsers]);

✅ 장점 :

• 스키마 구조를 미리 알고 있을 때 잘 동작함
• 각 테이블의 데이터를 동기적으로 삭제함

❌ 단점 :

• 관계형 데이터베이스에서 이 함수는, 관계 제약과 무관하게 테이블을 조회하고 TRUNCATE하는 더 일반적인 솔루션에 비해 확장성이 떨어집니다. 이 확장성 문제는 MongoDB 커넥터 사용 시에는 해당되지 않습니다.

참고 : $transaction은 각 모델의 테이블에 대해 연쇄 삭제를 수행하므로 순서대로 호출해야 합니다.

• raw SQL / TRUNCATE로 모든 데이터 삭제

raw SQL 작업에 익숙하다면 $executeRawUnsafe를 사용해 테이블에 TRUNCATE 쿼리를 수행할 수 있습니다.

다음 예시에서 첫 번째 탭은 $queryRaw 조회를 사용해 테이블을 순회하고 단일 쿼리에서 모든 테이블을 TRUNCATE하여 Postgres 데이터베이스에서 TRUNCATE를 수행하는 방법을 보여줍니다.

두 번째 탭은 MySQL 데이터베이스에서 동일한 작업을 수행하는 방법을 보여줍니다. 이 경우 TRUNCATE를 실행하기 전에 제약 조건을 제거하고, 완료 후 다시 복원해야 합니다. 전체 과정은 $transaction으로 실행됩니다.

PostgreSQL

MySQL

    const tablenames = await prisma.$queryRaw<
      Array<{ tablename: string }>
    >`SELECT tablename FROM pg_tables WHERE schemaname='public'`;

    const tables = tablenames
      .map(({ tablename }) => tablename)
      .filter((name) => name !== "_prisma_migrations")
      .map((name) => `"public"."${name}"`)
      .join(", ");

    try {
      await prisma.$executeRawUnsafe(`TRUNCATE TABLE ${tables} CASCADE;`);
    } catch (error) {
      console.log({ error });
    }

✅ 장점 :

• 확장 가능
• 매우 빠름

❌ 단점 :

• 작업을 되돌릴 수 없음
• 예약 SQL 키워드를 테이블 이름으로 사용하면 raw query 실행 시 문제가 발생할 수 있음

• Prisma Migrate로 모든 레코드 삭제

Prisma Migrate를 사용한다면 migrate reset을 사용할 수 있으며, 이 명령은 다음을 수행합니다:

1. 데이터베이스 삭제
2. 새 데이터베이스 생성
3. 마이그레이션 적용
4. 데이터로 데이터베이스 시드

고급 쿼리 예시

• 깊게 중첩된 레코드 트리 생성
  • 단일 User
  • 새로 연결된 Post 레코드 2개
  • 게시물별로 Category 연결 또는 생성

    const u = await prisma.user.create({
      include: {
        posts: {
          include: {
            categories: true,
          },
        },
      },
      data: {
        email: "emma@prisma.io",
        posts: {
          create: [
            {
              title: "My first post",
              categories: {
                connectOrCreate: [
                  {
                    create: { name: "Introductions" },
                    where: {
                      name: "Introductions",
                    },
                  },
                  {
                    create: { name: "Social" },
                    where: {
                      name: "Social",
                    },
                  },
                ],
              },
            },
            {
              title: "How to make cookies",
              categories: {
                connectOrCreate: [
                  {
                    create: { name: "Social" },
                    where: {
                      name: "Social",
                    },
                  },
                  {
                    create: { name: "Cooking" },
                    where: {
                      name: "Cooking",
                    },
                  },
                ],
              },
            },
          ],
        },
      },
    });