Prisma ORM: JS를 사용하여 프로젝트 시작부터 끝까지

프리즈마란 무엇인가요?

Prisma: Node.js 및 TypeScript용 차세대 ORM

ORM: 객체 관계 매핑은 복잡한 쿼리를 작성할 필요 없이 OOP 언어를 사용하여 데이터베이스와 통신하는 방법입니다.

• Prisma는 개발자가 데이터베이스를 쉽게 사용할 수 있도록 하는 것을 목표로 합니다.
• 유형 안전성과 직관적인 API를 제공하고 개발자 생산성을 높여줍니다.
• 개발자 경험에 중점을 둡니다.

주요 구성 요소

• Prisma 스키마: 데이터베이스 스키마에 대한 단일 정보 소스입니다. 모델과 그 관계를 정의합니다.
• Prisma 클라이언트: 스키마에 맞춰 자동 생성된 쿼리 빌더입니다. 데이터베이스에 대한 유형 안전 액세스를 제공합니다.
• Prisma Migrate: 데이터베이스 스키마 마이그레이션 관리 도구.

---

왜 프리즈마인가?

1. 데이터베이스 상호 작용 단순화: Prisma ORM은 직관적인 쿼리와 스키마 마이그레이션을 제공합니다.
2. 코드 품질 향상: Prisma ORM은 유형이 안전한 쿼리를 생성하고 널리 사용되는 IDE와 통합됩니다.
3. 여러 데이터베이스 지원: Prisma ORM을 사용하면 애플리케이션을 더 쉽게 적용하고 확장할 수 있습니다. (예: MongoDB, MySQL, MariaDB, PostgreSQL, Microsoft SQL 등)
4. 기존 ORM의 문제 완화: Prisma ORM은 비대해진 모델 인스턴스 및 예측할 수 없는 쿼리와 같은 문제를 해결합니다.

프로젝트 설정

1. 프로젝트 설정

새 프로젝트 디렉터리 생성

mkdir prisma-example
cd prisma-example

Node.js 프로젝트 초기화

npm init -y

프리즈마 CLI 설치

npm install prisma dotenv express --save-dev

프리즈마 클라이언트 설치

npm install @prisma/client --save-dev

이렇게 하면 데이터베이스용 Prisma 클라이언트가 설치됩니다.

2. 프리즈마 초기화

npx prisma init

이렇게 하면 다음을 포함하는 prisma 디렉토리가 생성됩니다.

• Schema.prisma: Prisma 스키마 파일.
• .env: 데이터베이스 연결 문자열용.

3. 데이터베이스 연결 구성

데이터베이스 선택

동영상에서는 PostgreSQL을 사용하지만 이를 MySQL, SQLite 등에 적용할 수 있습니다. 이 예에서는 PostgreSQL을 사용하겠습니다.

DATABASE_URL 설정

.env 파일에 연결 문자열을 추가합니다. PostgreSQL의 예:

DATABASE_URL="postgresql://your_user:your_password@localhost:5432/your_database"

your_user, your_password 및 your_database를 실제 자격 증명으로 바꾸세요. 로컬 PostgreSQL 서버가 없으면 서버를 설치하고 구성해야 합니다.

4. 데이터 모델 정의(schema.prisma)

prisma/schema.prisma의 내용을 다음으로 바꿉니다.

mkdir prisma-example
cd prisma-example

5. Prisma 클라이언트 생성

npm init -y

이렇게 하면 node_modules/@prisma/client에 유형이 안전한 Prisma 클라이언트가 생성됩니다.

6. 마이그레이션 생성

npm install prisma dotenv express --save-dev

이렇게 하면 prisma/migrations 디렉터리에 새 마이그레이션 파일이 생성되고 이를 데이터베이스에 적용하여 테이블이 생성됩니다. --name init는 마이그레이션에 설명적인 이름을 제공합니다.

7. Prisma 설정을 위한 별도 파일 생성

루트 디렉터리에 db.config.js 파일을 생성하고 다음 코드를 추가합니다.

npm install @prisma/client --save-dev

이렇게 하면 PrismaClient의 새 인스턴스가 생성되고 다른 파일에서 사용할 수 있도록 내보내집니다. log: ['query'] 옵션은 모든 쿼리를 콘솔에 기록합니다.

8. Prisma 작동을 이해하기 위한 기본 Express API 만들기

1. 컨트롤러

프로젝트 루트에 Controllers.js 파일을 생성합니다. 다음은 Controllers.js 파일의 CRUD 작업을 위한 코드입니다.

npx prisma init

2. 노선

프로젝트 루트에 Routes.js 파일을 생성하세요. 다음은 Routes.js 파일의 CRUD 작업을 위한 코드입니다:

DATABASE_URL="postgresql://your_user:your_password@localhost:5432/your_database"

3. 서버

프로젝트 루트에 server.js 파일을 생성합니다. 다음은 server.js 파일의 CRUD 작업을 위한 코드입니다.

generator client {
    provider = "prisma-client-js"
}

datasource db {
    provider = "postgresql" // Or "mysql", "sqlite", etc.
    url      = env("DATABASE_URL")
}

model Post {
    id        String   @id @default(uuid())
    title     String
    content   String?
    createdAt DateTime @default(now())
    author    User     @relation(fields: [user_id], references: [id])
    user_id   Int
}

model User {
    id    Int     @id @default(autoincrement())
    email String  @unique
    name  String?
    posts Post[]
}

9. 스크립트 실행

npx prisma generate

이렇게 하면 스크립트가 실행되어 데이터베이스에 사용자와 게시물이 생성된 다음 사용자가 업데이트되고 게시물이 삭제됩니다.

Postman을 사용하여 다음 경로로 API를 테스트할 수 있습니다.

• 포스트: http://localhost:5000/api/users
• GET: http://localhost:5000/api/users
• GET: http://localhost:5000/api/users/1
• PUT: http://localhost:5000/api/users/1
• 삭제: http://localhost:5000/api/users/1

POST 요청에 대한 Postman의 본문을 다음 데이터를 사용하여 JSON으로 설정합니다.

npx prisma migrate dev --name init

Prisma 구문에서 고려해야 할 핵심 사항

• findUnique/findFirst - 단일 레코드를 얻으려면 배열을 반환하지 않습니다.
• findMany - 여러 레코드를 얻으려면 배열을 반환합니다.
• include - 관련 데이터를 포함합니다.
• 선택 - 특정 필드를 선택합니다.
• 속성 선택 또는 포함 중 하나만 사용할 수 있습니다.

Prisma 구문의 예

import { PrismaClient } from "@prisma/client";

const prisma = new PrismaClient({
    log: ["query"],
});

export default prisma;

Prisma 집계, 필터링, 정렬 및 관계에 대한 추가 정보

1. Prisma의 집계 함수

Prisma는 데이터베이스 쿼리 내에서 직접 데이터 세트에 대한 계산을 수행할 수 있는 여러 집계 함수를 제공합니다. 이러한 기능은 애플리케이션에 많은 양의 데이터를 가져오지 않고도 데이터를 요약하고 통찰력을 얻는 데 유용합니다.

공통 집계 함수

• _count: 주어진 기준과 일치하는 레코드 수를 계산합니다.
• _avg: 숫자 필드의 평균을 계산합니다.
• _sum: 숫자 필드의 합계를 계산합니다.
• _min: 필드의 최소값을 찾습니다.
• _max: 필드의 최대값을 찾습니다.

집계의 예

다음과 같은 제품 모델이 있다고 가정해 보겠습니다.

mkdir prisma-example
cd prisma-example

각 카테고리의 제품 수 계산

npm init -y

모든 제품의 평균 가격 계산

npm install prisma dotenv express --save-dev

특정 카테고리에 있는 제품의 최소 및 최대 가격 찾기

npm install @prisma/client --save-dev

지난 주에 생성된 제품의 가격 합계

npx prisma init

2. Prisma 필터링

Prisma는 데이터베이스를 정확하게 쿼리할 수 있는 다양한 필터링 옵션 세트를 제공합니다. 다음은 예시가 포함된 포괄적인 개요입니다.

기본 필터링

• 같음(기본값): 정확히 같은지 확인합니다.
  

  DATABASE_URL="postgresql://your_user:your_password@localhost:5432/your_database"
  

• not: 조건을 부정합니다.
  

  generator client {
      provider = "prisma-client-js"
  }
  
  datasource db {
      provider = "postgresql" // Or "mysql", "sqlite", etc.
      url      = env("DATABASE_URL")
  }
  
  model Post {
      id        String   @id @default(uuid())
      title     String
      content   String?
      createdAt DateTime @default(now())
      author    User     @relation(fields: [user_id], references: [id])
      user_id   Int
  }
  
  model User {
      id    Int     @id @default(autoincrement())
      email String  @unique
      name  String?
      posts Post[]
  }
  

비교 연산자

• gt(보다 큼), gte(크거나 같음), lt(보다 작음), lte(작거나 같음): 숫자 및 날짜/시간 비교에 사용됩니다.
  

  npx prisma generate
  

문자열 필터

• 포함: 문자열에 하위 문자열이 포함되어 있는지 확인합니다.
  

  npx prisma migrate dev --name init
  

• startsWith: 문자열이 접두어로 시작하는지 확인합니다.
  

  import { PrismaClient } from "@prisma/client";
  
  const prisma = new PrismaClient({
      log: ["query"],
  });
  
  export default prisma;
  

• endsWith: 문자열이 접미사로 끝나는지 확인합니다.
  

  import prisma from "./db.config.js";
  
  // create user
  export const createUser = async (req, res) => {
      const { name, email } = req.body;
  
      const existing_user = await prisma.user.findUnique({
          where: {
              email,
          },
      });
  
      if (existing_user) {
          return res.status(400).json({ message: "User already exists" });
      }
  
      const user = await prisma.user.create({
          data: {
              email,
              name,
          },
      });
  
      return res.status(201).json(user);
  };
  
  // create post
  export const createPost = async (req, res) => {
      const { title, content, user_id } = req.body;
  
      const post = await prisma.post.create({
          data: {
              title,
              content,
              user_id,
          },
      });
  
      return res.status(201).json(post);
  };
  
  // get all users
  export const getUsers = async (req, res) => {
      const users = await prisma.user.findMany({
          include: {
              posts: true,
          },
      });
  
      return res.status(200).json(users);
  };
  
  // read specific user by id
  export const getUserById = async (req, res) => {
      const { id } = req.params;
  
      const user = await prisma.user.findUnique({
          where: {
              id: parseInt(id),
          },
          include: {
              posts: true,
          },
      });
  
      if (!user) {
          return res.status(404).json({ message: "User not found" });
      }
  
      return res.status(200).json(user);
  };
  
  // update user
  export const updateUser = async (req, res) => {
      const { id } = req.params;
      const { name, email } = req.body;
  
      const user = await prisma.user.update({
          where: {
              id: parseInt(id),
          },
          data: {
              name,
              email,
          },
      });
  
      return res.status(200).json(user);
  };
  
  // delete user
  export const deleteUser = async (req, res) => {
      const { id } = req.params;
  
      const user = await prisma.user.delete({
          where: {
              id: parseInt(id),
          },
      });
  
      return res.status(200).json(user);
  };
  
  // create similar for post
  

• 모드: insensitive: 대소문자를 구분하지 않고 검색을 수행합니다.
  

  import express from "express";
  import {
      createUser,
      createPost,
      getUsers,
      getUserById,
      updateUser,
      deleteUser,
  } from "./controllers.js";
  
  const router = express.Router();
  
  router.post("/users", createUser);
  router.get("/users", getUsers);
  router.get("/users/:id", getUserById);
  router.put("/users/:id", updateUser);
  router.delete("/users/:id", deleteUser);
  // create similar for post
  router.post("/posts", createPost);
  // router.get('/posts', getPosts);
  // router.get('/posts/:id', getPostById);
  // router.put('/posts/:id', updatePost);
  // router.delete('/posts/:id', deletePost);
  
  export default router;
  

목록 필터

• in: 목록에 값이 있는지 확인합니다.
  

  import express from "express";
  import dotenv from "dotenv";
  import router from "./routes.js";
  
  dotenv.config();
  
  const app = express();
  
  app.use(express.json());
  app.use("/api", router);
  
  const PORT = process.env.PORT || 5000;
  
  app.listen(PORT, () => {
      console.log(`Server running on port ${PORT}`);
  });
  

• notIn: 목록에 값이 아님 있는지 확인합니다.
  

  node index.js
  

논리 연산자

• AND: 여러 조건을 논리 AND로 결합합니다.
  

  {
      "name": "John Doe",
      "email": "sample@example.com"
  }
  

• OR: 여러 조건을 논리적 OR로 결합합니다.
  

  // get all posts of a user with id
  const user = await prisma.user.findUnique({
      where: {
          id: parseInt(id),
      },
      include: {
          posts: true,
      },
  });
  
  // select specific fields of user with post details
  const user = await prisma.user.findUnique({
      where: {
          id: parseInt(id),
      },
      select: {
          name: true,
          posts: {
              select: {
                  title: true,
                  content: true,
              },
          },
      },
  });
  
  // get all users name with their posts count (Aggregation)
  const req_data = await prisma.user.findMany({
      select: {
          id: true,
          name: true,
          _count: {
              select: {
                  post: true,
              },
          },
      },
  });
  

• NOT: 조건 그룹을 무효화합니다.
  

  model Product {
      id        Int      @id @default(autoincrement())
      name      String
      price     Float
      category  String
      createdAt DateTime @default(now())
  }
  

중첩 필터(관계 필터링)

관련 모델을 기준으로 필터링할 수 있습니다.

mkdir prisma-example
cd prisma-example

선택적 관계 필터링

npm init -y

필터 결합

복잡한 필터링 논리를 위해 이러한 연산자를 결합할 수 있습니다.

npm install prisma dotenv express --save-dev

이러한 예는 Prisma의 가장 일반적인 필터링 시나리오를 다룹니다. 이러한 연산자와 중첩된 필터를 결합하면 필요한 정확한 데이터를 검색하는 매우 정확한 쿼리를 만들 수 있습니다. 가장 최신의 자세한 정보는 공식 Prisma 문서를 참조하세요.

Prisma의 주문 기록

Prisma의 orderBy 옵션을 사용하면 쿼리 결과를 정렬할 수 있습니다. 다음은 사용법을 보여주는 몇 가지 예입니다.

기본 주문

• 오름차순(기본값):
  

  npm install @prisma/client --save-dev
  

• 내림차순:
  

  npx prisma init
  

여러 필드로 정렬

주문할 여러 필드를 각각 다른 방향으로 지정할 수 있습니다. Prisma는 먼저 첫 번째 필드를 기준으로 정렬한 다음 첫 번째 필드의 동일한 값 그룹 내에서 두 번째 필드를 기준으로 정렬합니다.

DATABASE_URL="postgresql://your_user:your_password@localhost:5432/your_database"

이 예에서는 게시물이 주로 작성자 이름을 기준으로 오름차순으로 정렬됩니다. 여러 게시물의 작성자가 동일한 경우 제목을 기준으로 내림차순으로 정렬됩니다.

중첩 필드별 정렬(관계)

앞의 예와 같이 관련 모델에 대해 필드별로 정렬할 수 있습니다.

generator client {
    provider = "prisma-client-js"
}

datasource db {
    provider = "postgresql" // Or "mysql", "sqlite", etc.
    url      = env("DATABASE_URL")
}

model Post {
    id        String   @id @default(uuid())
    title     String
    content   String?
    createdAt DateTime @default(now())
    author    User     @relation(fields: [user_id], references: [id])
    user_id   Int
}

model User {
    id    Int     @id @default(autoincrement())
    email String  @unique
    name  String?
    posts Post[]
}

작성자의 이메일 주소를 기준으로 게시물을 정렬합니다.

날짜/시간 필드별 정렬

날짜별, 시간별 정렬도 가능합니다.

npx prisma generate

필터링 필드와 다른 필드로 정렬

한 필드를 기준으로 필터링하고 다른 필드를 기준으로 정렬할 수 있습니다. 예를 들어, 이름에 "test"가 포함된 모든 사용자를 찾고 이메일 주소로 정렬할 수 있습니다.

npx prisma migrate dev --name init

null 옵션 사용

정렬 시 null 값이 처리되는 방식을 제어할 수 있습니다. nulls 옵션은 first 또는 last로 설정할 수 있습니다.

import { PrismaClient } from "@prisma/client";

const prisma = new PrismaClient({
    log: ["query"],
});

export default prisma;

기본적으로 null 값은 오름차순으로 정렬할 때 마지막에 배치되고, 내림차순으로 정렬할 때 가장 먼저 배치됩니다. nulls 옵션을 사용하면 이 기본 동작을 재정의할 수 있습니다.

Prisma의 관계 함수

Prisma는 데이터베이스 관계를 우아하게 처리하는 데 탁월합니다. 주요 측면은 다음과 같습니다.

• 스키마에서 관계 정의: @relation 속성을 사용하여 Schema.prisma 파일에서 직접 모델 간 관계를 정의합니다.

• 관계 유형: Prisma가 지원하는 것:

  • 일대일: 모델 A의 하나의 레코드는 정확히 모델 B의 하나의 레코드와 관련됩니다.
  • 일대다: 모델 A의 하나의 레코드는 모델 B의 여러 레코드와 관련됩니다.
  • 다대다: 모델 A의 여러 레코드가 모델 B의 여러 레코드와 관련됩니다(조인 테이블 필요).

관계의 예

이전 예제의 User 및 Post 모델을 사용해 보겠습니다.

mkdir prisma-example
cd prisma-example

Prisma ORM을 더 잘 이해하는 데 도움이 되기를 바랍니다.
피드백과 제안을 자유롭게 보내주세요.

읽어주셔서 감사합니다! ?

위 내용은 Prisma ORM: JS를 사용하여 프로젝트 시작부터 끝까지의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!