Mermaid ER Diyagram Sözdizimi
Varlık ilişki diyagramları veritabanı şemalarını görsel olarak haritalar. Her varlık bir tablo, her özellik bir sütundur ve varlıklar arasındaki çizgiler, tabloların yabancı anahtarlar aracılığıyla nasıl ilişkili olduğunu gösterir. Mermaid’in ER sözdizimi, tüm bunları düz metin olarak tanımlamanıza ve yazdıkça güncellenen işlenmiş diyagramı görmenize olanak tanır.
Varlıklar ve Özellikler
Bir varlığı özellikleriyle birlikte küme parantezleri içinde tanımlayın:
erDiagram
USER {
int id PK
string email UK
string name
string password_hash
timestamp created_at
}
Her özellik satırının üç bölümü vardır: tür ad kısıtlama. Kısıtlama (PK, FK, UK) isteğe bağlıdır.
İlişkiler
İlişkiler varlıkları birbirine bağlar ve kardinaliteyi belirtir:
CUSTOMER ||--o{ ORDER : "verir"
Bu şu anlama gelir: bir MÜŞTERİ sıfır veya daha fazla SİPARİŞ verir. İki noktadan sonraki etiket ilişki fiilini tanımlar.
Kardinalite Sembolleri
| Sol taraf | Sembol | Anlamı |
|---|---|---|
| Tam olarak bir | ` | |
| Sıfır veya bir | `o | ` |
| Bir veya daha fazla | `} | ` |
| Sıfır veya daha fazla | }o | İsteğe bağlı, herhangi bir sayı |
Yaygın Desenler
| İlişki | Sözdizimi | Örnek |
|---|---|---|
| Bire çok | ` | |
| Çoka bir | `}o— | |
| Bire bir | ` | |
| Çoka çok (birleşim yoluyla) | İki ` |
Okunabilir ER Diyagramları İçin İpuçları
Varlık adlarını büyük harf ve tekil tutun (USER, users değil). Kısa, tanımlayıcı ilişki etiketleri kullanın. İlişkide “ebeveyn” varlığı sol tarafa koyun (|| olan). Büyük şemalar için her şeyi tek bir diyagrama sıkıştırmak yerine diyagramı alana özel bölümlere ayırın.
Bu varlıklarla API etkileşimlerini belgelemek için Mermaid Sıra Diyagramı aracını deneyin.