{"id":2118,"date":"2026-05-26T07:38:24","date_gmt":"2026-05-26T07:38:24","guid":{"rendered":"https:\/\/www.vpascode.com\/pl\/docs\/uncategorized\/plantuml-erd-syntax-guide\/"},"modified":"2026-05-26T07:38:24","modified_gmt":"2026-05-26T07:38:24","slug":"plantuml-erd-syntax-guide","status":"publish","type":"ld_docs","link":"https:\/\/www.vpascode.com\/pl\/docs\/vpascode-docs\/plantuml-erd-syntax-guide\/","title":{"rendered":"Przewodnik po sk\u0142adni PlantUML ERD"},"content":{"rendered":"

Czym jest diagram relacji encji (ERD)?<\/h2>\n

Diagram relacji encji (ERD)<\/strong> to strukturalny szkic u\u017cywany do projektowania, dokumentowania i analizy baz danych relacyjnych. Wizualizuje tabele (encje) w systemie, konkretne kolumny (atrybuty), kt\u00f3re zawieraj\u0105, oraz spos\u00f3b, w jaki te tabele s\u0105 ze sob\u0105 powi\u0105zane. W PlantUML diagramy ERD tworzy si\u0119 przy u\u017cyciu notacji In\u017cynierii Informacji (IE)<\/strong>, kt\u00f3ra implementuje standardowe notacj\u0119 k\u0142ykci kruka<\/strong> w celu przedstawienia ogranicze\u0144 relacyjnych.<\/p>\n

Niezale\u017cnie od tego, czy projektujesz magazyn danych mikroserwisu, optymalizujesz \u015bcie\u017cki po\u0142\u0105cze\u0144 SQL, czy mapujesz architektur\u0119 magazynu danych na skal\u0119 ca\u0142ej organizacji, diagram ERD oparty na tek\u015bcie zapewnia, \u017ce schematy baz danych s\u0105 idealnie czytelne. Dzi\u0119ki VPasCode<\/strong>, mo\u017cesz definiowa\u0107 tabele bazy danych, klucze indeks\u00f3w i relacje logiczne przy u\u017cyciu czystego, deklaratywnego sk\u0142adnia. Silnik automatycznie obs\u0142uguje dopasowanie rozmiar\u00f3w p\u00f3l tabel i kieruje ci\u0105gi po\u0142\u0105cze\u0144 kluczy obcych bez nak\u0142adania si\u0119 linii uk\u0142adu.<\/p>\n

Podstawowy przewodnik sk\u0142adniowy: elementy i konstrukcje<\/h2>\n

Tworzenie solidnego diagramu ERD w stylu IE w PlantUML opiera si\u0119 na zorganizowanych blokach encji, jasnych oznaczeniach kluczy oraz modyfikatorach liczno\u015bci k\u0142ykci kruka.<\/p>\n

1. Deklarowanie encji (tabel bazy danych)<\/h3>\n

Deklarujesz tabel\u0119 bazy danych przy u\u017cyciu s\u0142owa kluczowego entity<\/code>a nast\u0119pnie nazw\u0119 tabeli i zestaw klamr. Wewn\u0105trz klamr wymieniasz kolumny tabeli. Aby schemat by\u0142 czysty i czytelny, u\u017cyj poziomej linii separatora (--<\/code>) w celu oddzielenia kluczy g\u0142\u00f3wnych\/obcych od standardowych atrybut\u00f3w danych:<\/p>\n

\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEdytuj Plantuml w VPasCode<\/span>
\n<\/a>\n<\/div>\n
\n
\r\n
\r\n Plantuml<\/span>\r\n \r\n <\/path><\/path><\/svg>\r\n Edit Plantuml in VPasCode<\/span>\r\n <\/a>\r\n <\/div>\r\n
\r\n 
entity \"users\" as users_table {\r\n    id : INT [PK]\r\n    --\r\n    email : VARCHAR(255)\r\n    created_at : TIMESTAMP\r\n}<\/code><\/pre>                <\/div>\r\n                
\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
\n
\n<\/path><\/path><\/svg>
\nEdytuj Plantuml w VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
2. Oznaczanie kluczy g\u0142\u00f3wnych i obcych<\/h3>\n
Cho\u0107 wska\u017aniki tekstowe takie jak `[PK]` lub `[FK]` dzia\u0142aj\u0105 dobrze, silnik IE w PlantUML obs\u0142uguje r\u00f3wnie\u017c wizualne ikony kluczy. Umieszczaj\u0105c gwiazdk\u0119 (*<\/code>) przed atrybutem oznacza go jako kolumn\u0119 **obowi\u0105zkow\u0105 (nie mo\u017ce by\u0107 pusta)**, podczas gdy czysty ci\u0105g tekstowy lub znacznik dodaje jawne konteksty indeksowania:<\/p>\n
\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEdytuj Plantuml w VPasCode<\/span>
\n<\/a>\n<\/div>\n
\n            
\r\n                                
\r\n                    Plantuml<\/span>\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n                                
\r\n                    
encja \"orders\" {\r\n    * id : INT <<PK>>\r\n    --\r\n    * user_id : INT <<FK>>\r\n    kod_zni\u017ckowy : VARCHAR(50)\r\n}<\/code><\/pre>                <\/div>\r\n                
\r\n                    \r\n                        <\/path><\/path><\/svg>\r\n                        Edit Plantuml in VPasCode<\/span>\r\n                    <\/a>\r\n                <\/div>\r\n            <\/div>\r\n            \n<\/p><\/div>\n
\n
\n<\/path><\/path><\/svg>
\nEdytuj PlantUML w VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
3. Mapowanie kardynalno\u015bci i relacji w stylu Crow\u2019s Foot<\/h3>\n
Aby po\u0142\u0105czy\u0107 tabele i zapewni\u0107 ograniczenia integralno\u015bci referencyjnej, u\u017cyj kombinacji my\u015blnik\u00f3w, nawias\u00f3w i znak\u00f3w pionowej kreski. W notacji IE te symbole tworz\u0105 wyra\u017ane **g\u0142owy koguta** reprezentuj\u0105ce relacje w bazie danych:<\/p>\n