{"id":2122,"date":"2026-05-26T07:38:24","date_gmt":"2026-05-26T07:38:24","guid":{"rendered":"https:\/\/www.vpascode.com\/es\/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\/es\/docs\/vpascode-docs\/plantuml-erd-syntax-guide\/","title":{"rendered":"Gu\u00eda de sintaxis de PlantUML para diagramas ER"},"content":{"rendered":"

\u00bfQu\u00e9 es un diagrama de entidad-relaci\u00f3n (ERD)?<\/h2>\n

Un Diagrama de entidad-relaci\u00f3n (ERD)<\/strong> es un plano estructural utilizado para dise\u00f1ar, documentar y analizar bases de datos relacionales. Visualiza las tablas (entidades) dentro de un sistema, las columnas espec\u00edficas (atributos) que contienen y c\u00f3mo esas tablas se relacionan entre s\u00ed. En PlantUML, los ERD se crean utilizando el notaci\u00f3n de Ingenier\u00eda de Informaci\u00f3n (IE)<\/strong>, que implementa la notaci\u00f3n de pie de cuervo<\/strong> est\u00e1ndar para representar restricciones relacionales.<\/p>\n

Ya sea que est\u00e9s dise\u00f1ando un almac\u00e9n de datos de microservicios, optimizando rutas de uni\u00f3n SQL o mapeando una arquitectura de almac\u00e9n de datos a nivel empresarial, un ERD de UML basado en texto garantiza que tus esquemas de base de datos sean perfectamente claros. Con VPasCode<\/strong>, puedes definir tus tablas de base de datos, claves de \u00edndice y relaciones l\u00f3gicas utilizando una sintaxis limpia y declarativa. El motor maneja autom\u00e1ticamente el tama\u00f1o de las cajas de tabla y enruta las cadenas de conectores de clave for\u00e1nea sin l\u00edneas de dise\u00f1o superpuestas.<\/p>\n

Gu\u00eda de sintaxis principal: Elementos y construcciones<\/h2>\n

Construir un ERD robusto de estilo IE en PlantUML depende de bloques de entidades estructurados, designaciones expl\u00edcitas de claves y modificadores de cardinalidad de pie de cuervo.<\/p>\n

1. Declaraci\u00f3n de entidades (tablas de base de datos)<\/h3>\n

Declaras una tabla de base de datos utilizando la entidad<\/code>palabra clave, seguida del nombre de la tabla y un conjunto de corchetes. Dentro de los corchetes, listas las columnas de tu tabla. Para que tu esquema sea limpio y legible, utiliza un separador horizontal (--<\/code>) para separar tus claves primarias\/for\u00e1neas de los atributos de datos est\u00e1ndar:<\/p>\n

\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml en 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 
entidad \"usuarios\" como usuarios_tabla {\r\n    id : INT [PK]\r\n    --\r\n    correo : VARCHAR(255)\r\n    creado_en : 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>
\nEditar Plantuml en VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
2. Designaci\u00f3n de claves primarias y for\u00e1neas<\/h3>\n
Aunque los indicadores de texto como `[PK]` o `[FK]` funcionan bien, el motor IE de PlantUML tambi\u00e9n admite \u00edconos visuales de claves. Colocar un asterisco (*<\/code>) antes de un atributo lo designa como una columna **obligatoria (no nula)**, mientras que una cadena de texto limpia o una etiqueta a\u00f1ade contexto de indexaci\u00f3n expl\u00edcito:<\/p>\n
\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEditar Plantuml en 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                    
entidad \"orders\" {\r\n    * id : INT <<PK>>\r\n    --\r\n    * user_id : INT <<FK>>\r\n    codigo_descuento : 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>
\nEditar Plantuml en VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
3. Mapeo de cardinalidades y relaciones de pie de cuervo<\/h3>\n
Para conectar tablas y aplicar restricciones de integridad referencial, utilice una combinaci\u00f3n de guiones, corchetes y caracteres de tuber\u00eda. En la notaci\u00f3n IE, estos s\u00edmbolos forman cabezas distintas de **pie de cuervo** que representan relaciones de base de datos:<\/p>\n