# Uso de psql para conectarse a una instancia de base de datos de RDS for PostgreSQL
<a name="USER_ConnectToPostgreSQLInstance.psql"></a>

Puede usar una instancia local de la utilidad de línea de comandos psql para conectarse a una instancia de base de datos de RDS for PostgreSQL. Necesitará que PostgreSQL o el cliente de psql estén instalados en el equipo cliente. 

Puede descargar el cliente de PostgreSQL desde el sitio web de [PostgreSQL](https://www.postgresql.org/download/). Para instalar psql, siga las instrucciones específicas de su sistema operativo.

Para conectarse a la instancia de base de datos de RDS for PostgreSQL mediante psql, debe proporcionar la información del host (DNS) y las credenciales de acceso.

Use uno de los siguientes formatos para conectarse a la instancia de base de datos de RDS for PostgreSQL. Cuando se conecte, se le pedirá una contraseña. En los trabajos por lotes o scripts, use la opción `--no-password`. Esta opción está establecida para toda la sesión.

**nota**  
Un intento de conexión con `--no-password` falla cuando el servidor requiere autenticación de contraseña y una contraseña no está disponible desde otras fuentes. Para obtener más información, consulte [la documentación de psql](https://www.postgresql.org/docs/13/app-psql.html).

Si es la primera vez que se conecta a esta instancia de base de datos o si aún no creó una base de datos para esta instancia de RDS for PostgreSQL, puede conectarse a la base de datos **postgres** mediante el “nombre de usuario maestro” y la contraseña.

En Unix, utilice el formato siguiente.

```
psql \
   --host=<DB instance endpoint> \
   --port=<port> \
   --username=<master username> \
   --password \
   --dbname=<database name>
```

En Windows, utilice el formato siguiente.

```
psql ^
   --host=<DB instance endpoint> ^
   --port=<port> ^
   --username=<master username> ^
   --password ^
   --dbname=<database name>
```

Por ejemplo, el siguiente comando se conecta a una base de datos denominada `mypgdb` en una instancia de base de datos PostgreSQL denominada `mypostgresql` usando credenciales ficticias. 

```
psql --host=mypostgresql.c6c8mwvfdgv0.us-west-2.rds.amazonaws.com --port=5432 --username=awsuser --password --dbname=mypgdb 
```