Cómo conectarte a PostgreSQL (psql) desde tu computadora local a un RDS en AWS

Conectarte a una base de datos RDS de Amazon Web Services (AWS) desde tu computadora local es una tarea esencial para administrar y consultar tus datos. Sin embargo, es común cometer algunos errores en el proceso. En este tutorial, te mostraré cómo hacerlo correctamente.

Pasos previos

Antes de comenzar, asegúrate de cumplir con los siguientes requisitos:

1. Tener instalado PostgreSQL en tu computadora local. Esto incluye la herramienta de línea de comandos psql. Puedes verificar si está instalado ejecutando psql --version en tu terminal.
2. Credenciales de acceso a tu base de datos RDS. Necesitarás:
   • Host: La dirección de tu instancia RDS.
   • Usuario: El nombre de usuario configurado en tu base de datos.
   • Contraseña: La contraseña del usuario.
   • Nombre de la base de datos: La base específica a la que deseas conectarte.
3. Configuración adecuada en tu RDS Security Group. Este paso es crucial y donde muchos suelen equivocarse.

Paso 1: Configura el Security Group de tu RDS

Un error común al configurar el acceso a una instancia RDS es dar permisos al Security Group de una EC2 en lugar del de la RDS. Para conectarte desde tu computadora local, debes agregar tu dirección IP a las reglas de entrada (Inbound Rules) del Security Group asociado a tu RDS. Aquí te explico cómo hacerlo:

1. Inicia sesión en tu consola de AWS.
2. Ve a la sección de EC2 y selecciona Security Groups.
3. Encuentra el Security Group asociado a tu RDS.
4. Edita las reglas de entrada (Inbound Rules) y agrega una nueva regla:
   • Tipo: PostgreSQL.
   • Protocolo: TCP.
   • Puerto: 5432.
   • Origen: Tu dirección IP (selecciona “My IP” para agregarla automáticamente).

Guarda los cambios.

Paso 2: Conéctate a tu RDS desde psql

Una vez configurado el Security Group, utiliza el siguiente comando en tu terminal para conectarte a tu RDS desde tu computadora local:

psql -h <host> -U <username> -d <database_name> -p 5432

Detalle de los parámetros:

• -h <host>: El endpoint de tu instancia RDS (por ejemplo, mydb.xxxxxx.us-east-1.rds.amazonaws.com).
• -U <username>: El nombre de usuario de tu base de datos.
• -d <database_name>: El nombre de la base de datos específica a la que deseas conectarte.
• -p 5432: El puerto en el que PostgreSQL escucha por defecto.

Posibles errores y soluciones

Error 1: Connection timed out

Esto sucede si tu IP no está correctamente configurada en las reglas de entrada del Security Group. Revisa el paso 1 y confirma que tu dirección IP es la que aparece.

Error 2: FATAL: password authentication failed

Esto indica que el nombre de usuario o contraseña son incorrectos. Verifica tus credenciales y asegúrate de que coincidan con las configuradas en tu RDS.

Error 3: psql: could not translate host name

Esto sucede si el host ingresado no es válido. Asegúrate de usar el endpoint completo que aparece en la configuración de tu RDS.

Con estos pasos, deberías poder conectarte exitosamente a tu RDS desde tu computadora local utilizando psql. Si tienes alguna duda, ¡déjala en los comentarios! 🚀