# 使用 psql 连接到 RDS for PostgreSQL 数据库实例
可使用 psql 命令行实用工具的本地实例连接到 RDS for PostgreSQL 数据库实例。需要在您的客户端计算机上安装 PostgreSQL 或 psql 客户端。
您可以从 [PostgreSQL](https://www.postgresql.org/download/) 网站下载 PostgreSQL 客户端。请按照特定于您的操作系统版本的说明安装 psql。
要使用 psql 连接到 RDS for PostgreSQL 数据库实例，您需要提供主机 (DNS) 信息、访问凭证以及数据库名称。
使用以下格式之一连接到 RDS for PostgreSQL 数据库实例。在连接时，系统将提示您输入密码。对于批处理作业或脚本，请使用 `--no-password` 选项。此选项面向整个会话设置。
**注意**
如果服务器需要进行密码身份验证，而密码不能从其他来源获取，`--no-password` 连接尝试则会失败。有关更多信息，请参阅 [psql 文档](https://www.postgresql.org/docs/13/app-psql.html)。
如果这是您第一次连接到此数据库实例，或者如果您尚未为此 RDS for PostgreSQL 实例创建数据库，则可以使用“主用户名”和密码连接到 **postgres** 数据库。
对于 Unix，使用以下格式。
```
psql \
--host= \
--port= \
--username= \
--password \
--dbname=
```
对于 Windows，使用以下格式。
```
psql ^
--host= ^
--port= ^
--username= ^
--password ^
--dbname=
```
例如，以下命令使用虚构的凭证连接到名为 `mypgdb` 的 PostgreSQL 数据库实例上名为 `mypostgresql` 的数据库。
```
psql --host=mypostgresql.c6c8mwvfdgv0.us-west-2.rds.amazonaws.com --port=5432 --username=awsuser --password --dbname=mypgdb
```