¿Cómo conectar nuestra aplicación en Node con PostgreSQL utilizando Node PostgreSQL?
Conectar tu aplicación de Node.js con PostgreSQL es un paso fundamental para manejar bases de datos de manera eficiente y asíncrona. Node PostgreSQL (PG) es un driver nativo que permitirá que nuestras aplicaciones puedan interactuar con bases de datos PostgreSQL mediante promesas y callbacks, lo cual resulta indispensable cuando se trabaja con arquitectura Clean. A continuación, te explicamos cómo lograr esta conexión de manera efectiva y ordenada.
Instalación de PG y configuración del cliente
Para comenzar a conectar nuestra aplicación Node con una base de datos PostgreSQL, es esencial instalar el driver PG. Este se encarga de gestionar las conexiones y ejecutar consultas usando promesas. La instalación se realiza desde la terminal usando el siguiente comando:
npminstall pg
Una vez instalado el driver, procederemos a configurar el cliente, que será el intermediario entre nuestra aplicación y la base de datos.
Creación de una capa de librerías
En la arquitectura Clean, es vital organizar el código en diferentes capas según su funcionalidad. Las librerías se utilizan para manejar conexiones con terceros, como bases de datos o APIs. Vamos a crear una nueva carpeta denominada libs para gestionar estas conexiones.
// Require del módulo PGconst{Client}=require('pg');// Configuración de la conexión con PostgreSQLconst client =newClient({host:'localhost',port:5432,user:'Nico',password:'admin123',database:'MyStore'});
Implementación de una función asíncrona para conectar
Gestionar nuestras conexiones de manera asíncrona es fundamental para el rendimiento y la estabilidad de la aplicación. Creamos una función asíncrona getConnection que devuelve una instancia del cliente conectada a PostgreSQL.
asyncfunctiongetConnection(){await client.connect();// Conectamos el clientereturn client;// Retornamos el cliente para su uso posterior}// Exportamos la función para usarla en otras partes de la aplicaciónmodule.exports={ getConnection };
Implementación dentro del servicio de la aplicación
Para aprovechar la conexión, integramos la función getConnection en nuestros servicios. En este caso, se implementa dentro de UserService para realizar consultas sobre tablas específicas.
// Importación de la función de conexiónconst{ getConnection }=require('../libs/PostgresJS');asyncfunctionfindUsers(){const client =awaitgetConnection();// Esperamos a que se conecteconst res =await client.query('SELECT * FROM tags');// Hacemos consulta SQLreturn res.rows;// Devolvemos los resultados}
Probar la conexión y ejecución de consultas
Con la conexión establecida, podemos ejecutar consultas SQL a través de nuestro servicio y verificar que los datos se devuelven correctamente. Usando herramientas como Insomnia, se puede solicitar datos y observar la respuesta obtenida del servicio.
Inserción y consulta de datos con PG Admin
Es vital verificar que nuestra tabla de pruebas esté poblada. Usando PG Admin, podemos insertar datos y ejecución de consultas para verificar la correcta funcionalidad de nuestro setup.
INSERTINTO tasks (title, completed)VALUES('Completar los cursos de Nicolás',false);
Después de la inserción, verificamos que los datos estén disponibles al realizar un request con nuestra API bien configurada, que conecta todas las capas desde controladores hasta la base de datos.
Aplicación de la arquitectura Clean
Al incluir esta conexión, no solo incrementamos las funcionalidades de nuestra aplicación, sino que también mantenemos una estructura organizada y sostenible mediante el uso de la arquitectura Clean, que segmenta las distintas estructuras de lógica y data. Esto resalta la importancia de gestionar adecuadamente la conexión a terceros manteniendo una arquitectura clara y eficiente.
¡Anímate a seguir explorando nuevas funcionalidades y mejorar tu aplicación! Con cada conexión establecida y cada consulta correcta, tu entendimiento de Node y PostgreSQL se fortalece, brindándote las herramientas necesarias para crear aplicaciones poderosas y bien estructuradas.
Conexión de Node.js a PostgreSQL usando Node PostgreSQL Driver
Conexión de Node.js a PostgreSQL usando Node PostgreSQL Driver
Recursos
Resumen
¿Cómo conectar nuestra aplicación en Node con PostgreSQL utilizando Node PostgreSQL?
Conectar tu aplicación de Node.js con PostgreSQL es un paso fundamental para manejar bases de datos de manera eficiente y asíncrona. Node PostgreSQL (PG) es un driver nativo que permitirá que nuestras aplicaciones puedan interactuar con bases de datos PostgreSQL mediante promesas y callbacks, lo cual resulta indispensable cuando se trabaja con arquitectura Clean. A continuación, te explicamos cómo lograr esta conexión de manera efectiva y ordenada.
Instalación de PG y configuración del cliente
Para comenzar a conectar nuestra aplicación Node con una base de datos PostgreSQL, es esencial instalar el driver PG. Este se encarga de gestionar las conexiones y ejecutar consultas usando promesas. La instalación se realiza desde la terminal usando el siguiente comando:
npm install pg
Una vez instalado el driver, procederemos a configurar el cliente, que será el intermediario entre nuestra aplicación y la base de datos.
Creación de una capa de librerías
En la arquitectura Clean, es vital organizar el código en diferentes capas según su funcionalidad. Las librerías se utilizan para manejar conexiones con terceros, como bases de datos o APIs. Vamos a crear una nueva carpeta denominada libs para gestionar estas conexiones.
// Require del módulo PG
const { Client } = require('pg');
// Configuración de la conexión con PostgreSQL
const client = new Client({
host: 'localhost',
port: 5432,
user: 'Nico',
password: 'admin123',
database: 'MyStore'
});
Implementación de una función asíncrona para conectar
Gestionar nuestras conexiones de manera asíncrona es fundamental para el rendimiento y la estabilidad de la aplicación. Creamos una función asíncrona getConnection que devuelve una instancia del cliente conectada a PostgreSQL.
async function getConnection() {
await client.connect(); // Conectamos el cliente
return client; // Retornamos el cliente para su uso posterior
}
// Exportamos la función para usarla en otras partes de la aplicación
module.exports = { getConnection };
Implementación dentro del servicio de la aplicación
Para aprovechar la conexión, integramos la función getConnection en nuestros servicios. En este caso, se implementa dentro de UserService para realizar consultas sobre tablas específicas.
// Importación de la función de conexión
const { getConnection } = require('../libs/PostgresJS');
async function findUsers() {
const client = await getConnection(); // Esperamos a que se conecte
const res = await client.query('SELECT * FROM tags'); // Hacemos consulta SQL
return res.rows; // Devolvemos los resultados
}
Probar la conexión y ejecución de consultas
Con la conexión establecida, podemos ejecutar consultas SQL a través de nuestro servicio y verificar que los datos se devuelven correctamente. Usando herramientas como Insomnia, se puede solicitar datos y observar la respuesta obtenida del servicio.
Inserción y consulta de datos con PG Admin
Es vital verificar que nuestra tabla de pruebas esté poblada. Usando PG Admin, podemos insertar datos y ejecución de consultas para verificar la correcta funcionalidad de nuestro setup.
INSERT INTO tasks (title, completed) VALUES ('Completar los cursos de Nicolás', false);
Después de la inserción, verificamos que los datos estén disponibles al realizar un request con nuestra API bien configurada, que conecta todas las capas desde controladores hasta la base de datos.
Aplicación de la arquitectura Clean
Al incluir esta conexión, no solo incrementamos las funcionalidades de nuestra aplicación, sino que también mantenemos una estructura organizada y sostenible mediante el uso de la arquitectura Clean, que segmenta las distintas estructuras de lógica y data. Esto resalta la importancia de gestionar adecuadamente la conexión a terceros manteniendo una arquitectura clara y eficiente.
¡Anímate a seguir explorando nuevas funcionalidades y mejorar tu aplicación! Con cada conexión establecida y cada consulta correcta, tu entendimiento de Node y PostgreSQL se fortalece, brindándote las herramientas necesarias para crear aplicaciones poderosas y bien estructuradas.
💡Es un tipo de arquitectura que nos permite descentralizar los diferentes recursos existentes de nuestra aplicación.
.
En ocasiones, a serverless se le denomina sistemas distribuidos ya que permite, abstraer desde servidores hasta módulos denominados cloud functions.
.
Una de las principales ventajas de implementar serverless es la creación de arquitecturas como cliente-servidor, micro-servicios, entre otros.
.
Clean Architecture
💡Es un conjunto de principios cuya finalidad principal es ocultar los detalles de implementación a la lógica de dominio de la aplicación.
.
Las principal característica de Clean Architecture frente a otras arquitecturas es la regla de dependencia.
.
En Clean Architecture, una aplicación se divide en responsabilidades y cada una de estas responsabilidades se representa en forma de capa.
.
Tonces!!!... muchachos no saben cuanto me demore con el error de clave incorrecta para el usuario, no permitía conexión, verifique cambiando el puerto, nada, incluso borre el docker y volví a crear y nada.
La solución, quemar el pc jajajajajajajaja
Nee mentira, la solución?, pues resulta que tenia instalado pgAdmin localmente, pues fui a services.msc y detuve el servicio de pgadmin.
FATAL: password authentication failed for user "edward"
todo el dia comprebe varias veces que el usuario y
contraseña fueran indenticas a las de las varibles del servicio de postgress del archivo docker-compose.yml,
incluso descarge todo los archivos de la esta clase, elimine y volvi a instalar npm, containers y volumenes de docker, para comprobar con el usuario y contrasena de "nico" y "admin123" del profe, busque informacion e intente de otras maneras, me seguia dando siempre el mismo error. Curiosamente al final la solucion que me funciono fue desinstalar y volver a instalar docker.
💡Es un tipo de arquitectura que nos permite descentralizar los diferentes recursos existentes de nuestra aplicación.
.
En ocasiones, a serverless se le denomina sistemas distribuidos ya que permite, abstraer desde servidores hasta módulos denominados cloud functions.
.
Una de las principales ventajas de implementar serverless es la creación de arquitecturas como cliente-servidor, micro-servicios, entre otros.
.
Clean Architecture
💡Es un conjunto de principios cuya finalidad principal es ocultar los detalles de implementación a la lógica de dominio de la aplicación.
.
Las principal característica de Clean Architecture frente a otras arquitecturas es la regla de dependencia.
.
En Clean Architecture, una aplicación se divide en responsabilidades y cada una de estas responsabilidades se representa en forma de capa.
.
Hermano que gran código acabo de ver,wow...!, acabas de pasar el código de la clase a un siguiente nivel usando patrones de diseño y lo que le da ese plus de un código de calidad es el uso de comentarios con el estándar de "jsdoc", un gusto ver un código de esa manera y de mucha calidad.
Una máquina, nada más que decir
Tonces!!!... muchachos no saben cuanto me demore con el error de clave incorrecta para el usuario, no permitía conexión, verifique cambiando el puerto, nada, incluso borre el docker y volví a crear y nada.
La solución, quemar el pc jajajajajajajaja
Nee mentira, la solución?, pues resulta que tenia instalado pgAdmin localmente, pues fui a services.msc y detuve el servicio de pgadmin.
Y listo, ya estuvo funciono Ferpecto!
Gracias!! estaba igual o peor que tu..
Me salvaste la vida, estuve un rato largo probando por mi cuenta creyendo que solo a mí me había pasado hasta que me puse a leer los comentarios xD
Tener en cuenta que primero debemos ejecutar en la terminal
$ compose up -d postgres
luego
$ node index.js
de ahi recien hacer el GET desde insomnia
Lo del error de contraseña es desinstalando postgres de la PC
Super importante estos pasos, el profe se olvido comentar que el segundo se debe hacer.
Gracias! No sabía porque no me funcionaba la consulta y fue justamente por eso! jaja
Si crearon variables de entorno en un archivo .env también pueden reutilizarlas sin quemarlas en el archivo.
Primero tenemos que instalar el módulo dotenv
npm i dotenv
Después importamos dotenv en nuestro archivo de postgres.js
require('dotenv').config();
Por último reemplazamos los valores de la base de datos por nuestras variables de entorno de la siguiente manera:
Dos clases más adelante se hace un mejor manejo de las variables de entorno 😅
Este conocimiento vale oro!
Al me funciono ya que me daba un error tipo:
FATAL: password authentication failed for user "edward"
todo el dia comprebe varias veces que el usuario y
contraseña fueran indenticas a las de las varibles del servicio de postgress del archivo docker-compose.yml,
incluso descarge todo los archivos de la esta clase, elimine y volvi a instalar npm, containers y volumenes de docker, para comprobar con el usuario y contrasena de "nico" y "admin123" del profe, busque informacion e intente de otras maneras, me seguia dando siempre el mismo error. Curiosamente al final la solucion que me funciono fue desinstalar y volver a instalar docker.
Lo que me pasaba a mí es que tenía otro Postgres instalado en Windows y me generaba conflicto
Me paso y cambiando el usuario a 'root' anduvo joya.
alguien mas tiene problemas con la autenticación de usuario?
yo tuve problemas con el query que se usa en el video, asi que lo tuve que cambiar por
const rta =await client.query('SELECT * FROM public.tasks')
Correcto, asi se crea por default en pgAdmin4
SELECT*FROMpublic.taskORDERBY id ASC
comandos
npm install pg
Dennis Bejar Challco
Hace 3 meses
Tener en cuenta que primero debemos ejecutar en la terminal
$ compose up -d postgres
luego
$ node index.js
de ahi recien hacer el GET desde insomnia
Lo del error de contraseña es desinstalando postgres de la PC
En mi caso el error se debia a que tenia instalado el postgres localmente, entonces estaba corriendo en segundo plano, y al detener ese servicio empieza a funcionar normalmente
Luego de esta clase me puedo sentir con superpoderes xd, lograr conectar con una base de datos y luego esos datos poder mandarla al front end, ya sientes que tienes un vision bastante amplia del proceso una webapp
Para los que vengan utilizando sintaxis de ES6
les dejo el import y demas, ya que pg no es compatible con ciertos tipos de importacion, y deberia hacerse de esta manera
pd: Yo no utilice las mismas variables que nico, le puse otros nombres a user, y password, atentos a cambiar esos valores
me encantaría poder usar los export de es6 pero no se la configuración que hay que hacer, ¿la puedes compartir por favor?
Hola! soy una más que no pudo avanzar porque le sale el ' error: password authentication failed for user ', probe todas las posibles soluciones que compartieron los compañeros pero no funciona, alguien encontró otra manera?
Gracias
sii! yo lo pude solucionar asi: Tenes que salir de los servicios (Docker-compose down) borrar TODO lo que esta dentro de la carpeta postgres_data (en VSC) y volver a entrar a los servicios. No se si hay otra manera "más profesional" o "limpia" de hacerlo, pero a mi me funcionó y así pude seguir. Una vez que volves a entrar a los servicios se vuelven a crer todas las cosas que estaban dentro de esa carpeta excepto lo que sea que te provocaba ese error.
alguien podria ayudarme, me esta volviendo loco
Pasa eso porque el IPAddress cambia cada vez que inicias el docker-compose, para que sea mas facil, puedes usar el nombre del contenedor en vez de la IPAddress, en este comentario hay mas info
hola! pudiste resolverlo? yo acabo de resolver varios mensajitos de error asi que me aparecian, si aun estas trabado decime y te ayudo
Todo muy padre, pero porqué hacemos query a las tasks desde el endpoint de users? jaja 😅
Hola, hehe solo es un pequeño ejemplo de como hacer uns consulta SQL desde un servicio, pero si tienes razón debería existir el router solo para tasks con su propio servicio.
En la configuración con docker utilizamos la ip: 172.17.0.2, sin embargo en el archivo de configuración utilizamos localhost.
.
¿Por qué?
.
He utilizado localhost y recibo el siguiente error:
.
La conexion no se dió. trata de hacer un try catch en la conexion y en el host/adress pon el nombre del servicio que colocaste en el docker-compose.yml
Resolví todo este asunto desinatalando y volviendo a configurar el entorno.
¿Es una solución loable?
No.
Tengo una pregunta. La conexión con el método connect de la clase Client, crea nuevas conexiones cada vez que es llamado, o se mantiene la misma? Y en caso de necesitarse un Singleton, es obligatorio usar los Pools o hay una manera de verificar si ya existe la conexión?
Hola Diesan!
Efectivamente crea nuevos clientes. Si quieres reciclar la conexion, toca usar un Pool. Si quieres implementar un Singleton con Client, quizas los eventos de conexion a base de datos te pueden servir para saber si esta alive. Estan al final de la documtancion del paquete.
Saludos!
Gracias @pabloantipan, he revisado lo que me enviaste y creo que terminaré usando un Pool.
Yo tuve sendos problemas de conexión con mi contenedor de postgreSQL. Para solucionarlo tuve que hacer unas modificaciones importantes:
Lo primero fue permitirle al contenedor manejar de manera interna los temporales, ya que esto me estaba generando basura en los logs con un montón de warnings. Lo segundo fue dirigir el puerto 5432 interno del contenedor al 5433 para poderme conectar desde Node.
La otra modificación importante que hice fue cambiar mi archivo postgres.js para que me devolviera el cliente y el pool de conexiones. En este caso el pool es otra forma de conexión pero lo que me interesa es el cliente:
Tuve que hacer esto para evitar un error recurrente que decía que query no era una función, esto me estaba pasando siguiendo los pasos de la clase en la que se usaba getConnection. Este paso tuve que eliminarlo para crear la conexión en el método find del servicio:
En el find, conecto primero a la base de datos con una promesa que devuelve en el catch una consola para ver si hubo errores. Luego ejecuto el query con un callback para resolver dentro de una promesa el resultado de la consulta.
Gracias Jherom Chacon, si no es por tu comentario seguiría dando vueltas y ya llevo tiempo 🙃.
Te comento que yo solo modifique los puertos en docker-compose.yml como:
- 5433:5432
Y en el archivo de postgres.js el puerto como:
port: 5433,
Con esta forma de dirigir los puertos como comentaste tu logre solventar, saludos 😎👍