Belgelere geç

MODELLERİNİZ, GÖRSELLEŞTİRİLDİ

Prisma’dan ERD’ye kılavuzu

schema.prisma dosyasını modeller, ilişkiler ve eşlenmiş adlarla görselleştirin. Sözdizimini anlayın ve tanı iletilerini giderin.

schema.prisma → ER diyagramıPrisma’dan ERD’ye aracını aç

Prisma şemanızın yapısını görün

Modelleri, skaler alanları, anahtarları, enumları, indeksleri ve ilişkileri görselleştirmek için schema.prisma dosyasını düzenleyiciye yapıştırın. Dönüştürme tarayıcıda çalışır ve tanılama dikkat gerektirdiğinde okunabilir modelleri korur.

Bu araç şemanızı görselleştirir. Veri kaynağınıza bağlanmaz, Prisma Client çalıştırmaz veya migrasyon uygulamaz.

Örnekler, Prisma 6 veri kaynağı sözdizimini kullanır. Prisma 7'de sağlayıcıyı schema.prisma içinde tutun ve bağlantı URL'sini prisma.config.ts içinde yapılandırın. Erd Go, yalnızca sağlayıcı içeren bir veri kaynağını kabul eder; yapılandırma dosyanızı veya kimlik bilgilerinizi değil, şemayı buraya yapıştırın.

Bağlı bir şema yapıştırın

  1. Prisma to ERD'yi açın ve bir örnek veya boş bir belge seçin.
  2. Şemayı aşağıya veya kendi tam schema.prisma dosyanızı yapıştırın. Veri kaynağı sağlayıcısı, bağlayıcıya özgü doğrulamayı kontrol eder.
  3. Diyagramı ve tanılamaları gözden geçirin, ardından gezgindeki modelleri, alanları ve ilişkileri inceleyin. Diyagramı düzenlemek için düzen kontrollerini kullanın.
Prisma / Bağlı Prisma şeması
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, şema örneğinin bir parçasıdır. Görselleştirici, veritabanı bağlantısı kurmak için bunu kullanmaz.

Modeller, alanlar ve eşlenmiş isimler

Modeller, alanlar ve eşlenmiş isimler
SözdizimiAnlam
model User { ... }Skaler ve ilişki alanlarına sahip bir model.
String / Int / Boolean / DateTime / Decimal / Json / BytesSkaler alan türleri; bağlayıcı desteği hala geçerlidir.
String? / Post[]İsteğe bağlı alan / liste alanı.
@id / @@id([a, b])Tek alanlı / bileşik birincil anahtar.
@unique / @@unique([a, b])Tek alanlı / bileşik benzersiz kısıtlama.
@default(...) / @updatedAt / @db.VarChar(255)Varsayılanlar, meta verileri güncelle ve sağlayıcıya özel yerel türler.
@map("user_id") / @@map("users")Eşlenmiş sütun / veritabanı tablo adı.
enum Status { ... } / @@index([field])Enum değerleri / model dizinleri.
@@schema("public")Uyumlu bir çoklu şema veri kaynağı için şema üyeliği.
Farklı bağlayıcılardan gelen yerel türleri ve varsayılan işlevleri karıştırmayın. Sadece modele ait parçalar esnektir; eksiksiz bir veri kaynağı daha katı sağlayıcı doğrulaması sağlar.

İlişkiler ve anahtar kuralları

Açık bir ilişki; bir ilişki alanı, skaler yabancı anahtar alanları ve @relation(fields: [...], references: [...]) kullanır. Diğer modelde karşıt bir ilişki alanı ekleyin. Uyumlu skaler ve yerel türlerle bir birincil anahtara veya küresel olarak benzersiz bir anahtara başvurun.

Herhangi bir yabancı anahtar (foreign-key) skaları isteğe bağlıysa, ona sahip olan ilişki alanı da isteğe bağlı olmalıdır. İsteğe bağlı bir ilişkinin gerekli skaları olabilir. Bire bir sahiplik, yabancı anahtar alanlarında @unique veya @@unique gerektirir ve bu skalar olmadan ters alan isteğe bağlı olmalıdır.

Aynı modeller arasındaki birden fazla bağlantıyı veya bir öz ilişkiyi ayırt etmek için her iki tarafta da aynı tırnak içindeki ilişki adını kullanın. Adlar noktalama işaretleri içerebilir. Alan adları ve anahtar referansları büyük/küçük harfe duyarlıdır; her anahtar alanını bir kez listeleyin ve her bileşik anahtar üyesini dahil edin.

Örtük ilişkisel çoka-çok kenarlar, katılan her modelde bir skaler alan düzeyinde @id gerektirir. Bileşik, blok düzeyinde veya yalnızca benzersiz tanımlayıcılar, yanıltıcı bir sanal ilişki yerine bir tanı üretir. Ek alanlar, karmaşık anahtarlar veya referans eylemleri için açık bir birleştirme (join) modeli kullanın.

Prisma / Bire bir ilişki
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?
}
Kısmi benzersiz indeksler PUQ olarak görünür. Benzersizlikleri yalnızca eşleşen satırlar için geçerlidir, bu nedenle genel kimlik oluşturamazlar veya bire-bir kardinalite ima edemezler.

Enumlar, bileşik anahtarlar ve veritabanı eşlemeleri

Çok sütunlu anahtarlar için @@id ve @@unique, alan adları için @map ve tablo adları için @@map kullanın. Uyumlu bir çoklu şema sağlayıcısı için veri kaynağındaki şemaları listeleyin ve modelleri @@schema ile atayın. Eşlenmiş kimlik veritabanı çıktısı için korunurken, model adı düzenleyicide yararlı kalmaya devam eder.

Aşağıdaki PostgreSQL örneği, bileşik bir birincil anahtara ve kiracı kapsamlı benzersiz bir e-postaya sahiptir. Bu anahtarla açık bir ilişki, uyumlu alan türleriyle aynı sırada tenantId ve accountId sağlamalıdır.

Prisma / Eşlenmiş bileşik anahtar şeması
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")
}

Sağlayıcılar ve kurtarılabilir tanılar

Desteklenen veri kaynağı sağlayıcıları arasında PostgreSQL, MySQL, SQLite, SQL Server, MongoDB ve CockroachDB bulunur. Dönüştürücü, bağlayıcıya özgü kimlikleri, yerel türleri, varsayılanları, ilişki kurallarını ve eşlenmiş ad çakışmalarını kontrol eder.

İlişkisel sağlayıcılar varsayılan olarak relationMode = "foreignKeys" kullanır. MongoDB, relationMode = "prisma" kullanır ve _id eşlemesini ve ObjectId gereksinimlerini doğrular. İlişkisel bir örneğin MongoDB'ye değiştirilmeden kopyalanabileceğini varsaymayın.

Tanılamaları kullanarak eksik karşı ilişki alanlarını, uyumsuz yabancı anahtar türlerini, geçersiz anahtar hedeflerini ve desteklenmeyen sağlayıcı kombinasyonlarını düzeltin. Geçersiz ancak okunabilir alanlar, şemayı yerinde onarabilmeniz için görünür kalır.

Sağlayıcılar ve kurtarılabilir tanılar
SağlayıcıBağlayıcıya özel rehberlik
PostgreSQL / CockroachDBSkaler listeler ve çoklu şema bildirimleri desteklenir; yerel türler ve varsayılanlar seçilen sağlayıcıyla eşleşmelidir.
MySQLSkaler listeler veya veri kaynağı şemaları seçeneği yok. Referans eylem doğrulaması, seçilen relationMode'u takip eder.
SQLitePrisma yerel @db türü öznitelikleri, skaler listeler veya veri kaynağı şemaları seçeneği yok.
SQL ServerEnum blokları, Json alanları veya skaler listeler yok. Çoklu şema bildirimleri desteklenir.
MongoDBrelationMode = "prisma", bir _id eşlemesi ve eşleşen ObjectId skaler/yerel türlerini kullanın. Bileşik tür blokları bu bağlayıcıya aittir.

Keşfet, dışa aktar ve kaydet

  1. Gezgini modele, alana, eşlenmiş ada, numaralandırmaya veya ilişkiye göre arayın. İlişki Denetçisi'nde alanlarını, referanslarını, kardinalitesini ve referans eylemlerini incelemek için bir ilişki seçin; oradan her iki uç noktaya da odaklanın.
  2. Dikkat gerektiren kaynağa atlamak için tanılama konumlarını kullanın. ERD üzerindeki düzen ve görüntüleme tercihlerini ayarlayın.
  3. Diyagramı bir belge veya sunum için PNG, resim destekli SVG veya PDF olarak dışa aktarın.
  4. Kaynak ve oluşturucu bağlamıyla bir Prisma dosyasını kaydetmek için oturum açın. Salt okunur bir genel bağlantı paylaşmadan önce düzenlemeleri kaydedin. Paylaşılan bir görüntüleyici, kaynak düzenleme erişimi almaz.

Bir Prisma şemasında sorun giderme

Bir Prisma şemasında sorun giderme
SemptomNeler kontrol edilmeli
Bir ilişkinin bir uyarısı varEşleşen karşı alan ve ilişki adını, uyumlu skaler/yerel türleri, küresel olarak benzersiz referanslı anahtarı ve yalnızca sahip taraftaki alanları/referansları kontrol edin.
Bire bir ilişkinin bir uyarısı varSahip olunan yabancı anahtar grubunu küresel olarak benzersiz ve ters ilişkiyi isteğe bağlı yapın. Eğer sahip olunan bir skaler boş değer alabiliyorsa, ilişkisini de isteğe bağlı yapın.
Bir bileşik anahtar küresel olarak benzersiz olarak gösterilmezEksik, tekrarlanan, isteğe bağlı veya farklı büyük/küçük harf içeren alan adlarını kontrol edin. Kısmi benzersiz yüklem, küresel UQ yerine PUQ olarak gösterilir.
Örtük bir çok-çok kenarı eksikHer modelin bir skaler alan düzeyinde @id'ye ihtiyacı vardır. Bileşik tanımlayıcılar veya ilişki öznitelikleri için açık bir birleştirme modeli kullanın.
Diyagram hatalarla oluşturuluyorOkunabilir alanlar kasıtlı olarak tutulur. Şemayı veritabanı sağlayıcısı için geçerli kabul etmeden önce tanılamaları onarın.
Kaydedilmiş düzen yeni düzenlemeleri yansıtmazPaylaşmadan veya yeniden yüklemeden önce mevcut kaynak ve oluşturucu bağlamını Kaydedin; herkese açık görüntüleyenler kaydedilmiş sürümü görür.
Kaynak düzenleme devre dışıBelge sahipliğini, oturum açma durumunu ve bulut yüklemesinin bitip bitmediğini kontrol edin. Kurtarılabilir yükleme hataları Yeniden Dene ve Dosyaları Aç seçeneklerini sunar.

Doğru sağlayıcı ile Prisma oluşturun

Bu kılavuzu bir yapay zeka istemi olarak kopyalayın, Prisma sürümünüzü ve sağlayıcınızı adlandırın, ardından modellerinizi ve iş kurallarınızı belirtin. Asistanın şemayı değiştirirken mevcut @map ve @@map isimlerini korumasını isteyin.

Döndürülen Prisma'yı düzenleyiciye yapıştırın ve başka bir yerde kullanmadan önce tanılamaları gözden geçirin. Oluşturulan bir diyagram, sağlayıcı doğrulamasının veya geçiş incelemesinin yerini tutmaz.

AI request / Prisma AI isteği
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.