Relaciones 1 a 1 en Bases de Datos con TimeORM

¿Cómo manejar relaciones en bases de datos relacionales con TypeORM?

En el mundo de las bases de datos relacionales, es crucial entender cómo gestionar las diferentes relaciones que pueden ocurrir entre tablas, tales como uno a uno, uno a muchos, y muchos a muchos. En esta clase vamos a explorar cómo se puede utilizar TypeORM para manejar estas relaciones, enfocándonos en la relación uno a uno, específicamente entre un usuario y un cliente (user y customer).

¿Cómo se establece la relación uno a uno?

Vamos a crear las entidades necesarias, siguiendo buenas prácticas en su estructuración:

1. Entidad Customer:

   • Llave primaria (ID).
   • Atributos como name, lastName, y phone, todos de tipo Varchar.
   • Timestamps para created_at y updated_at.

2. Entidad User:

   • Llave primaria (ID).
   • Atributos como email, password (encriptado en futuras implementaciones), y role.
   • Timestamps para created_at y updated_at.

Ambas entidades deben ser declaradas en el User Module, donde se configurarán como entidades gestionadas por TypeORM.

¿Cómo crear la relación uno a uno?

Para implementar la relación uno a uno, se deben importar y utilizar dos decoradores de TypeORM: @OneToOne y @JoinColumn. Nuestra relación, en este escenario, será opcional, permitiendo que algunos usuarios no tengan clientes asociados (usuarios administrativos, por ejemplo).

// En User Entity
@OneToOne(() => CustomerEntity, { nullable: true })
@JoinColumn()
customer: CustomerEntity;

Usamos @OneToOne para declarar la relación y @JoinColumn exclusivamente en una de las entidades, designando la entidad "dueña" de la relación.

¿Cómo manejar relaciones bidireccionales?

TypeORM admite relaciones bidireccionales, lo que significa que cualquier entidad puede conocer su contraparte asociada:

// En Customer Entity
@OneToOne(() => UserEntity, user => user.customer, { nullable: true })
user: UserEntity;

Aquí especificamos el decorador @OneToOne con una row function, resolviendo la relación desde ambas entidades. Sin embargo, @JoinColumn solo se especifica en un lado, en este caso en User, para establecer quién tiene la relación en la base de datos.

¿Cómo crear y ejecutar migraciones?

Para establecer nuestras entidades en la base de datos, es indispensable generar y ejecutar migraciones:

1. Crear migración:

   npm run typeorm migration:generate -- create-user-and-customer
   

2. Ejecutar migración:

   npm run typeorm migration:run
   

Estas acciones se traducen en la creación física de las tablas y relaciones en la base de datos. Puedes verificar la ejecución accediendo a pgAdmin y revisando los esquemas generados.

¿Cómo verificar estructuras de tablas desde el terminal?

Puedes inspeccionar las estructuras y relaciones creadas por TypeORM conectándote directamente al contenedor de PostgreSQL:

docker-compose exec postgres-container bash

psql -h localhost -d mydb -U root

\d+ users  // Consultar detalles de la tabla users

Esta metodología te permite verificar la estructura de las tablas y sus llaves foráneas de manera detallada.

Atrévete a implementar esta configuración en tus proyectos, experimentando con las poderosas funcionalidades que te ofrece TypeORM para manejar relaciones complejas en tus bases de datos. ¡Sigue explorando y aprendiendo nuevas herramientas para llevar tus habilidades de desarrollo al siguiente nivel!