문서로 건너뛰기

시각화된 당신의 모델

Prisma를 ERD로 가이드

모델, 관계, 매핑된 이름을 포함한 schema.prisma를 시각화하세요. 구문을 이해하고 진단 내용을 해결합니다.

schema.prisma → ER 다이어그램Prisma에서 ERD로 열기

Prisma 스키마의 구조를 확인하세요

schema.prisma를 편집기에 붙여넣어 모델, 스칼라 필드, 키, 열거형, 인덱스 및 관계를 시각화하세요. 변환은 브라우저에서 실행되며 진단이 필요할 때 읽기 쉬운 모델을 유지합니다.

이 도구는 스키마를 시각화합니다. 데이터 소스에 연결하거나, Prisma Client를 실행하거나, 마이그레이션을 적용하지 않습니다.

예제는 Prisma 6 datasource 구문을 사용합니다. Prisma 7에서는 schema.prisma에 provider를 유지하고 prisma.config.ts에서 연결 URL을 구성하십시오. Erd Go는 provider 전용 datasource를 허용합니다. 구성 파일이나 자격 증명이 아닌 스키마를 여기에 붙여넣으십시오.

연결된 스키마 붙여넣기

  1. Prisma에서 ERD로를 열고 샘플 또는 빈 문서를 선택하세요.
  2. 아래에 스키마 또는 본인의 전체 schema.prisma를 붙여넣으세요. 데이터 소스 공급자가 커넥터별 유효성 검사를 제어합니다.
  3. 다이어그램과 진단을 검토한 다음 탐색기에서 모델, 필드 및 관계를 검사하세요. 레이아웃 컨트롤을 사용하여 다이어그램을 정렬하세요.
Prisma / 연결된 Prisma 스키마
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
}

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

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

  @@index([authorId])
}
DATABASE_URL은 스키마 예제의 일부입니다. 시각화 도구는 이를 사용하여 데이터베이스 연결을 설정하지 않습니다.

모델, 필드 및 매핑된 이름

모델, 필드 및 매핑된 이름
구문의미
model User { ... }스칼라 및 관계 필드가 있는 모델입니다.
문자열 / 정수 / 불리언 / 날짜시간 / 소수 / Json / 바이트스칼라 필드 유형. 커넥터 지원은 여전히 적용됩니다.
String? / Post[]선택적 필드 / 리스트 필드.
@id / @@id([a, b])단일 필드 / 복합 기본 키.
@unique / @@unique([a, b])단일 필드 / 복합 고유 제약 조건.
@default(...) / @updatedAt / @db.VarChar(255)기본값, 메타데이터 업데이트 및 공급자별 기본 유형.
@map("user_id") / @@map("users")매핑된 열 / 데이터베이스 테이블 이름.
enum Status { ... } / @@index([field])열거형 값 / 모델 인덱스.
@@schema("public")호환되는 멀티 스키마 데이터 소스에 대한 스키마 멤버십.
서로 다른 커넥터의 네이티브 유형과 기본 함수를 혼합하지 마십시오. 모델 전용 스니펫은 허용되지만, 완전한 데이터 소스는 더 엄격한 공급자 유효성 검사를 가능하게 합니다.

관계 및 키 규칙

명시적 관계는 관계 필드, 스칼라 외래 키 필드 및 @relation(fields: [...], references: [...])를 사용합니다. 다른 모델에 반대쪽 관계 필드를 포함하세요. 호환되는 스칼라 및 네이티브 유형을 가진 기본 키 또는 전역적으로 고유한 키를 참조하세요.

외래 키 스칼라가 선택 사항인 경우, 해당 소유 관계 필드도 선택 사항이어야 합니다. 선택적 관계는 필수 스칼라를 가질 수 있습니다. 일대일 소유자는 외래 키 필드에 @unique 또는 @@unique가 필요하며, 해당 스칼라가 없는 역방향 필드는 선택 사항이어야 합니다.

동일한 모델 간의 여러 링크 또는 셀프 관계를 구분하려면 양쪽에 동일한 따옴표로 묶인 관계 이름을 사용하세요. 이름에는 문장 부호가 포함될 수 있습니다. 필드 이름과 키 참조는 대소문자를 구분합니다. 각 키 필드를 한 번씩 나열하고 모든 복합 키 멤버를 포함하세요.

암시적 관계형 다대다 엣지는 각 참여 모델에 하나의 스칼라 필드 수준 @id가 필요합니다. 복합, 블록 수준 또는 고유 전용 식별자는 오해의 소지가 있는 가상 관계 대신 진단을 생성합니다. 추가 필드, 복합 키 또는 참조 동작의 경우 명시적 조인 모델을 사용하십시오.

Prisma / 일대일 관계
model Profile {
  id     Int  @id @default(autoincrement())
  userId Int  @unique
  user   User @relation(fields: [userId], references: [id])
}

model User {
  id      Int      @id @default(autoincrement())
  profile Profile?
}
부분 고유 인덱스는 PUQ로 표시됩니다. 고유성은 일치하는 행에만 적용되므로 전역 정체성을 설정하거나 일대일 카디널리티를 암시할 수 없습니다.

열거형, 복합 키 및 데이터베이스 매핑

다중 열 키에는 @@id 및 @@unique를, 필드 이름에는 @map을, 테이블 이름에는 @@map을 사용하세요. 호환되는 다중 스키마 공급자의 경우, 데이터 소스에 스키마를 나열하고 @@schema로 모델을 할당하세요. 모델 이름은 편집기에서 계속 유용하게 사용되는 반면, 매핑된 ID는 데이터베이스 출력을 위해 보존됩니다.

아래의 PostgreSQL 예제에는 복합 기본 키와 테넌트 범위의 고유 이메일이 있습니다. 이 키에 대한 명시적 관계는 호환되는 필드 유형과 함께 동일한 순서로 tenantId 및 accountId를 제공해야 합니다.

Prisma / 매핑된 복합 키 스키마
datasource db {
  provider = "postgresql"
  url      = env("DATABASE_URL")
  schemas  = ["identity"]
}

enum AccountState {
  ACTIVE
  DISABLED

  @@schema("identity")
}

model Account {
  tenantId  Int          @map("tenant_id")
  accountId Int          @map("account_id")
  email     String
  state     AccountState @default(ACTIVE)

  @@id([tenantId, accountId])
  @@unique([tenantId, email])
  @@map("accounts")
  @@schema("identity")
}

공급자 및 복구 가능한 진단

지원되는 데이터 소스 공급자에는 PostgreSQL, MySQL, SQLite, SQL Server, MongoDB 및 CockroachDB가 포함됩니다. 변환기는 커넥터별 식별자, 네이티브 유형, 기본값, 관계 규칙 및 매핑된 이름 충돌을 확인합니다.

관계형 공급자는 기본적으로 relationMode = "foreignKeys"로 설정됩니다. MongoDB는 relationMode = "prisma"를 사용하며 _id 매핑 및 ObjectId 요구 사항을 검증합니다. 관계형 예시를 변경 없이 MongoDB에 복사할 수 있다고 가정하지 마십시오.

진단을 사용하여 누락된 반대 관계 필드, 호환되지 않는 외래 키 유형, 유효하지 않은 키 대상 및 지원되지 않는 공급자 조합을 수정하세요. 유효하지 않지만 읽을 수 있는 필드는 그대로 표시되므로 스키마를 즉시 복구할 수 있습니다.

공급자 및 복구 가능한 진단
공급자커넥터 관련 안내
PostgreSQL / CockroachDB스칼라 리스트 및 다중 스키마 선언이 지원됩니다. 기본 유형 및 기본값은 선택한 공급자와 일치해야 합니다.
MySQL스칼라 리스트 또는 datasource schemas 옵션이 없습니다. 참조 동작 유효성 검사는 선택된 relationMode를 따릅니다.
SQLitePrisma 네이티브 @db 유형 속성, 스칼라 리스트 또는 datasource schemas 옵션이 없습니다.
SQL Serverenum 블록, Json 필드 또는 스칼라 리스트가 없습니다. 다중 스키마 선언이 지원됩니다.
MongoDBrelationMode = "prisma", _id 매핑 및 일치하는 ObjectId 스칼라/네이티브 타입을 사용하세요. 복합 타입 블록은 이 커넥터에 속합니다.

탐색, 내보내기 및 저장

  1. 모델, 필드, 매핑된 이름, 열거형 또는 관계로 탐색기를 검색하세요. 관계를 선택하여 관계 인스펙터에서 필드, 참조, 카디널리티 및 참조 동작을 검토하고, 거기에서 양쪽 끝점 중 하나에 집중하세요.
  2. 진단 위치를 사용하여 주의가 필요한 소스로 이동하세요. ERD에서 레이아웃 및 표시 기본 설정을 조정하세요.
  3. 문서나 프레젠테이션을 위해 다이어그램을 PNG, 이미지가 포함된 SVG 또는 PDF로 내보내기 하십시오.
  4. 소스 및 렌더러 컨텍스트와 함께 Prisma 파일을 저장하려면 로그인하십시오. 읽기 전용 공개 링크를 공유하기 전에 편집 내용을 저장하십시오. 공유된 뷰어는 소스 편집 권한을 받지 못합니다.

Prisma 스키마 문제 해결

Prisma 스키마 문제 해결
증상확인할 사항
관계에 경고가 있습니다.일치하는 반대쪽 필드 및 관계 이름, 호환되는 스칼라/네이티브 유형, 전역적으로 고유한 참조 키, 소유하는 쪽에만 있는 필드/참조를 확인하세요.
일대일 관계에 경고가 있습니다.소유 외래 키 그룹을 전역적으로 고유하게 만들고 역관계를 선택 사항으로 만듭니다. 소유 스칼라가 null 허용인 경우 해당 관계도 선택 사항으로 만듭니다.
복합 키가 전역적으로 고유하게 표시되지 않습니다.누락되거나 반복되거나 선택 사항이거나 대소문자가 다른 필드 이름이 있는지 확인하세요. 부분 고유 서술어는 전역 UQ 대신 PUQ로 표시됩니다.
암시적 다대다 엣지가 없습니다.각 모델에는 하나의 스칼라 필드 수준 @id가 필요합니다. 복합 식별자 또는 관계 속성에는 명시적 조인 모델을 사용하세요.
다이어그램이 오류와 함께 렌더링됩니다.읽기 가능한 필드는 의도적으로 유지됩니다. 스키마를 해당 데이터베이스 공급자에 대해 유효한 것으로 처리하기 전에 진단 내용을 수정하세요.
저장된 레이아웃에 새로운 편집 사항이 반영되지 않았습니다공유하거나 다시 로드하기 전에 현재 소스 및 렌더러 컨텍스트를 저장하세요. 공개 뷰어는 저장된 버전을 보게 됩니다.
소스 편집이 비활성화되었습니다문서 소유권, 로그인 여부 및 클라우드 로딩이 완료되었는지 확인하세요. 복구 가능한 로드 오류는 다시 시도 및 파일 열기를 제공합니다.

올바른 제공자로 Prisma 생성

이 가이드를 AI 프롬프트로 복사하고, Prisma 버전과 프로바이더를 지정한 다음, 모델과 비즈니스 규칙을 명시하세요. 스키마를 변경하는 동안 기존 @map 및 @@map 이름을 유지하도록 어시스턴트에게 요청하세요.

반환된 Prisma를 편집기에 붙여넣고 다른 곳에서 사용하기 전에 진단을 검토하세요. 렌더링된 다이어그램은 공급자 유효성 검사나 마이그레이션 검토를 대체하지 않습니다.

AI request / Prisma AI 요청
Generate a PostgreSQL Prisma schema for User, Project, and Membership.
Use an explicit Membership join model with a composite key.
Include both sides of every relation and compatible foreign-key types.
Preserve these database table names: users, projects, memberships.