> 웹 프론트엔드 > JS 튜토리얼 > Prisma ORM: JS를 사용하여 프로젝트 시작부터 끝까지

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

Linda Hamilton
풀어 주다: 2025-01-16 18:43:15
원래의
835명이 탐색했습니다.

Prisma ORM: Start to End With Project using 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 중국어 웹사이트의 기타 관련 기사를 참조하세요!

원천:dev.to
본 웹사이트의 성명
본 글의 내용은 네티즌들의 자발적인 기여로 작성되었으며, 저작권은 원저작자에게 있습니다. 본 사이트는 이에 상응하는 법적 책임을 지지 않습니다. 표절이나 침해가 의심되는 콘텐츠를 발견한 경우 admin@php.cn으로 문의하세요.
저자별 최신 기사
인기 튜토리얼
더>
최신 다운로드
더>
웹 효과
웹사이트 소스 코드
웹사이트 자료
프론트엔드 템플릿