{"id":2118,"date":"2026-05-26T07:38:24","date_gmt":"2026-05-26T07:38:24","guid":{"rendered":"https:\/\/www.vpascode.com\/pt\/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\/pt\/docs\/vpascode-docs\/plantuml-erd-syntax-guide\/","title":{"rendered":"Guia de Sintaxe de ERD do PlantUML"},"content":{"rendered":"

O que \u00e9 um Diagrama de Relacionamento de Entidades (ERD)?<\/h2>\n

Um Diagrama de Relacionamento de Entidades (ERD)<\/strong> \u00e9 um plano estrutural usado para projetar, documentar e analisar bancos de dados relacionais. Ele visualiza as tabelas (entidades) dentro de um sistema, as colunas espec\u00edficas (atributos) que cont\u00eam e como essas tabelas se conectam. No PlantUML, os ERDs s\u00e3o criados usando o nota\u00e7\u00e3o de Engenharia de Informa\u00e7\u00e3o (IE)<\/strong>, que implementa o padr\u00e3o nota\u00e7\u00e3o de p\u00e9 de corvo<\/strong> para representar restri\u00e7\u00f5es relacionais.<\/p>\n

Seja voc\u00ea projetando um armazenamento de dados de microsservi\u00e7o, otimizando caminhos de jun\u00e7\u00e3o SQL ou mapeando uma arquitetura de data warehouse em escala empresarial, um ERD UML baseado em texto garante que seus esquemas de banco de dados sejam perfeitamente claros. Com VPasCode<\/strong>, voc\u00ea pode definir suas tabelas de banco de dados, chaves de \u00edndice e relacionamentos l\u00f3gicos usando uma sintaxe limpa e declarativa. O motor manipula automaticamente o dimensionamento das caixas de tabela e roteia suas strings de conex\u00e3o de chave estrangeira sem linhas de layout sobrepostas.<\/p>\n

Guia de Sintaxe Principal: Elementos e Constru\u00e7\u00f5es<\/h2>\n

Construir um ERD robusto no estilo IE no PlantUML depende de blocos de entidades estruturados, designa\u00e7\u00f5es expl\u00edcitas de chaves e modificadores de cardinalidade de p\u00e9 de corvo.<\/p>\n

1. Declarando Entidades (Tabelas de Banco de Dados)<\/h3>\n

Voc\u00ea declara uma tabela de banco de dados usando a entity<\/code>palavra-chave, seguida pelo nome da tabela e um conjunto de chaves. Dentro das chaves, voc\u00ea lista as colunas da tabela. Para tornar seu esquema limpo e leg\u00edvel, use um separador horizontal (--<\/code>) para separar suas chaves prim\u00e1rias\/estrangeiras dos atributos de dados padr\u00e3o:<\/p>\n

\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEdite o Plantuml no 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>
\nEdite o Plantuml no VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
2. Designando Chaves Prim\u00e1rias e Estrangeiras<\/h3>\n
Embora indicadores de texto como `[PK]` ou `[FK]` funcionem bem, o motor IE do PlantUML tamb\u00e9m suporta \u00edcones visuais de chaves. Colocar um asterisco (*<\/code>) antes de um atributo o designa como uma coluna **obrigat\u00f3ria (n\u00e3o nula)**, enquanto uma string de texto limpa ou uma tag adiciona contexto expl\u00edcito de indexa\u00e7\u00e3o:<\/p>\n
\n
\nPlantuml<\/span>
\n
\n<\/path><\/path><\/svg>
\nEdite o Plantuml no 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                    
entidade \"pedidos\" {\r\n    * id : INT <<PK>>\r\n    --\r\n    * user_id : INT <<FK>>\r\n    codigo_desconto : 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>
\nEdite o PlantUML no VPasCode<\/span>
\n<\/a>\n<\/div>\n<\/div>\n
\"\"<\/p>\n
3. Mapeamento da cardinalidade e rela\u00e7\u00f5es de Pata de Corvo<\/h3>\n
Para conectar tabelas e garantir restri\u00e7\u00f5es de integridade referencial, use uma combina\u00e7\u00e3o de tra\u00e7os, colchetes e caracteres de pipe. Na nota\u00e7\u00e3o IE, esses s\u00edmbolos formam cabe\u00e7as distintas de **pata de corvo** que representam relacionamentos de banco de dados:<\/p>\n