← Índice de la guía
Guía
Patrones de diseño de software para la obra civil
Parte
V · Datos y tiempo
Capítulo
14
Estado
Borrador
Patrones
Modelo relacional (Relational Model) · Claves primaria y foránea (Primary Key, Foreign Key) · Normalización (Normalization) · Índice (Index) · Transacción (Transaction)

El cuadro de columnas

Cómo guardar cada dato en un solo lugar y encontrarlo sin revisarlo todo.

1Primero, el cuadro de columnas

En este edificio, el calculista dibujó la sección de todas las columnas en un solo lugar, el cuadro de columnas del plano E-04, con una fila por columna (capítulo 4). La regla es que cada dato se escribe una sola vez y los demás papeles remiten a él. Sin ella, la sección de la C-12 estaría escrita en cinco lugares, en el plano estructural, el de encofrados, la planilla de fierros, el cómputo métrico y el de arquitectura.

Con la orden de cambio por el tanque de la terraza, el estructural pasaría a 35 × 35 y el carpintero armaría el encofrado con la medida vieja. Nadie se equivocaría. Nadie sabría cuántos papeles repiten el dato.

Con la regla, la revisión B (capítulo 8) cambió la sección en un solo lugar. Encofrados y arquitectura dicen «C-12, ver plano E-04». El cómputo métrico y la planilla de fierros se calculan desde el cuadro y se rehacen cuando cambia.

Antes: copiada Después: una sola vez Estructural C-12 · 35 × 35 Encofrados 30 × 30 Fierros 30 × 30 Cómputo 30 × 30 Arquitectura 30 × 30 Estructural · E-04 C-12 · 35 × 35 Encofrados ver E-04 Fierros desde E-04 Cómputo desde E-04 Arquitectura ver E-04 dependen cuatro quedan en 30 × 30 se corrige en E-04
Antes, la sección de la C-12 está copiada en cinco documentos y al cambiarla se corrige uno solo. Después, está escrita en el plano E-04, dos remiten a él y dos se calculan desde él.

Cada plano lleva un código (E-04, E-07, A-02) que se asigna una vez y no se reutiliza, como la marca de las columnas (capítulo 4). El E-04 conserva su código en cada revisión. «Ver plano E-04» remite siempre a la vigente, y las anteriores quedan superadas (capítulo 8).

Queda otro problema, el de encontrar. Marta pide a la planoteca «todos los planos del nivel 3» y el dibujante abre las gavetas una por una. Entonces arma un fichero, con una ficha por plano ordenada por código y su gaveta. Para «E-04» va directo, y para buscar por nivel arma otro fichero. Cada fichero acorta la búsqueda, pero cada emisión obliga a corregir las fichas.

Funciona porque cada dato tiene un solo dueño y cada plano se halla sin abrir todas las gavetas.

2El mismo problema, en la app del banco

En la primera versión, cada movimiento es una fila de una sola tabla grande, con la cuenta, el monto, la fecha y el nombre de la titular, repetido.

Dos años después, Rosa avisa que su apellido está mal escrito. Se corrige en su ficha de cliente, pero sigue copiado en cada uno de sus movimientos.

—¿Por qué los movimientos de Rosa, armados hoy, traen dos apellidos? —pregunta la gerente.

—Se corrigió la ficha, pero el nombre estaba en 2.300 filas —responde el programador—. Se corrigieron las que se encontraron.

Es la sección de la C-12 escrita en cinco planos, con dos males más.

3Las cuatro piezas

Titulares código nombre 17 Rosa Cuentas número titular saldo contable 4471 17 1.000 Bs Movimientos código cuenta fecha monto 9001 4471 14 nov −800 Bs apunta a su código apunta a su número clave primaria clave foránea
Tres tablas enlazadas por sus claves. Cada movimiento apunta a su cuenta y cada cuenta a su titular, así que el nombre de Rosa está escrito una sola vez.

1El modelo relacional y sus clavesRelational Model · Primary Key · Foreign Key

Es el cuadro de columnas, con una fila por columna y las mismas casillas en todas. Una base relacional guarda todo en tablas así. A cada casilla del encabezado, repetida en todas las filas, la llama columna. Aquí se dirá campo, para no confundirla con las de la estructura.

La clave primaria es el código de plano, que identifica la fila y no se repite (capítulo 4). La clave foránea es el «ver plano E-04», un campo que guarda la clave primaria de otra tabla, como las referencias entre agregados (capítulo 5). Si se declara la clave foránea, la base comprueba que la fila nombrada exista y, salvo orden contraria, no deja borrarla mientras otras la nombran.

La tabla de movimientos es además el libro de órdenes, donde solo se agregan filas (capítulo 5).

Por lo tanto

cada cosa va en su tabla con una clave que la identifica, y las demás la nombran por esa clave.

2La normalizaciónNormalization · Third Normal Form

Es la sección escrita solo en el cuadro. Normalizar es repartir los datos en tablas hasta que cada uno esté escrito en un solo lugar. La regla práctica, llamada tercera forma normal, pide que cada campo dependa de la clave de su fila, de toda la clave y de nada más. El nombre de Rosa depende del movimiento solo a través de la cuenta y su titular, así que vive en titulares. Corregir el apellido de Rosa es tocar una sola fila.

Por lo tanto

cada dato se escribe en un solo lugar, y los demás lo nombran por su clave.

3El índiceIndex

Es el fichero del dibujante. Un índice es una lista ordenada por uno o más campos, con el lugar de cada fila, y la base encuentra un valor en pocos pasos aunque haya millones de filas. Esta es la consulta de «Mis movimientos». Dice qué filas se quieren y la base decide cómo buscarlas.

de «movimientos», las filas de la cuenta 4471
   cuya fecha sea de los últimos 30 días
unir cada fila con su cuenta
   y la cuenta con su titular
ordenarlas de la más nueva a la más vieja
mostrar fecha, monto y nombre del titular

Con un índice por cuenta y fecha, la base va derecho a las filas de la 4471 de ese mes. Sin él, revisa los tres millones. Unir (join) es combinar las filas de dos tablas, casi siempre siguiendo las claves foráneas. Cada índice ocupa espacio y se pone al día cuando se agrega o borra una fila o cambia un campo indexado, como las fichas con cada emisión.

Por lo tanto

se indexa lo que se busca seguido, sabiendo que cada índice encarece las escrituras.

4La transacciónTransaction

Es el paquete de la revisión B (capítulo 8). Con cada dato en su lugar, una operación cambia varias filas de varias tablas, y transferir toca dos cuentas y dos movimientos. La base las agrupa en una transacción, que se confirma entera o se deshace entera, y lo confirmado queda guardado aunque se corte la luz. Qué pasa si dos transacciones chocan se ve en el capítulo 15. En el banco, «transacción» suele ser la operación del cliente, y el glosario del capítulo 28 separa los dos sentidos.

Por lo tanto

los cambios de una operación se confirman todos juntos, o no se confirma ninguno.

4Qué se gana y qué cuesta

Lo que se gana

  • Un dato se corrige en un solo lugar.
  • La base rechaza una referencia a una fila que no existe.
  • Buscar no obliga a revisar todo.
  • Una operación de varias filas se guarda entera o no se guarda.

Lo que cuesta

  • Leer pide juntar tablas siguiendo las claves.
  • Cada índice ocupa espacio y encarece las escrituras.
  • Cambiar la forma de las tablas con datos ya guardados es una migración, que se ve en el capítulo 25.

Cuándo no conviene. Con pocas filas no hace falta índice, como no hace falta fichero para diez planos. Y todo esto rige para una sola base en un solo servidor. Copiarla en otros, para repartir la carga o resistir una caída, se ve en los capítulos 22 y 24.

Con qué se combina. Con el almacenamiento de las capas (capítulo 2), las entidades (capítulo 4), los agregados (capítulo 5), los repositorios (capítulo 8) y la concurrencia (capítulo 15).

5Para llevarse

En el edificioEn la app del bancoPatrón
Cuadro de columnas, una fila por columnaCualquier tabla: titulares, cuentas, movimientosRelational Model
Código de plano y «ver plano E-04»Número de cuenta y cuenta del movimientoPrimary Key · Foreign Key
Sección escrita solo en el cuadroNombre del titular guardado una vezNormalization
Fichero de la planotecaÍndice por cuenta y fechaIndex
Paquete de la revisión BCambios de una operación, todos o ningunoTransaction

¿No es más rápido copiar el dato donde se lee?

A veces sí, a propósito. El saldo contable es la suma de los movimientos y aun así la cuenta lo guarda ya sumado (capítulo 5), con la raíz de la cuenta a cargo de que coincida. Y lo emitido lleva su copia, porque no se corrige (capítulo 3), como el extracto de enero, con el nombre que Rosa tenía entonces. Se copia por velocidad, tras medir, o para guardar lo que valía en una fecha. Nunca por si acaso.

Dónde cojea la analogía

La clave foránea es la equivalencia más floja. «Ver plano E-04» es una nota que una persona sigue o se salta. Si se declara la clave foránea, la base comprueba que la fila exista, pero seguirla (unir) lo pide cada consulta.

El dibujante corrige las fichas a mano y puede olvidar una. La base pone al día cada índice sola, aunque el costo sigue, y decide sola si lo usa o revisa todo. El dibujante elige el fichero.

En la práctica, a noviembre de 2026. PostgreSQL, MySQL, SQL Server y Oracle son bases relacionales que se consultan en SQL y crean índices con CREATE INDEX. Hibernate en Java, EF Core en .NET y SQLAlchemy en Python describen tablas, claves e índices desde las clases del programa. Ver el mapa de tecnologías, en el capítulo 28.

Capítulo 15 · ConcurrenciaDos ingenieros que retiran el mismo plano a la vez.