Sintaxis de Diagrama ER Mermaid
Los diagramas entidad relación mapean visualmente los esquemas de base de datos. Cada entidad es una tabla, cada atributo es una columna y las líneas entre entidades muestran como se relacionan las tablas a través de claves foraneas. La sintaxis ER de Mermaid te permite definir todo esto como texto plano y ver el diagrama renderizado actualizarse mientras escribes.
Entidades y Atributos
Define una entidad con sus atributos entre llaves:
erDiagram
USER {
int id PK
string email UK
string name
string password_hash
timestamp created_at
}
Cada línea de atributo tiene tres partes: tipo nombre restricción. La restricción (PK, FK, UK) es opcional.
Relaciones
Las relaciones conectan entidades y especifican cardinalidad:
CUSTOMER ||--o{ ORDER : "realiza"
Esto significa: un CLIENTE realiza cero o más PEDIDOS. La etiqueta después de los dos puntos define el verbo de la relación.
Símbolos de Cardinalidad
| Lado izquierdo | Símbolo | Significado |
|---|---|---|
| Exactamente uno | ` | |
| Cero o uno | `o | ` |
| Uno o más | `} | ` |
| Cero o más | }o | Opcional, cualquier número |
Patrones Comunes
| Relación | Sintaxis | Ejemplo |
|---|---|---|
| Uno a muchos | ` | |
| Muchos a uno | `}o— | |
| Uno a uno | ` | |
| Muchos a muchos (vía union) | Dos ` |
Consejos para Diagramas ER Legibles
Manten los nombres de entidad en mayusculas y singular (USER, no users). Usa etiquetas de relación cortas y descriptivas. Coloca la entidad “padre” en la relación a la izquierda (la que tiene ||). Para esquemas grandes, divide el diagrama por áreas de dominio en lugar de comprimir todo en un solo diagrama.
Para documentar interacciones API con estas entidades, prueba la herramienta Diagrama de Secuencia Mermaid.