# 连接到 Amazon RDS 数据库
<a name="rds-connection"></a>

借助 **AWS Explorer**，您可以选择 Amazon RDS 数据库、身份验证方法，然后配置连接设置。成功测试连接后，即可开始使用 JetBrains DataGrip 与数据来源交互。

**重要**  
确保已完成[先决条件](rds-access-prerequisities.md)，以便用户能够访问 Amazon RDS 数据库并与之交互。

选择一个选项卡，获取有关使用首选身份验证方法连接到数据库实例的说明。

------
#### [ Connect with IAM credentials ]

1. 打开 AWS Explorer（如果尚未打开）。

1. 单击 **Amazon RDS** 节点以展开支持的数据库引擎列表。

1. 单击支持的数据库引擎（Aurora、MySQL 或 PostgreSQL）节点以展开可用数据库实例列表。
**注意**  
如果选择 Aurora，则可以在扩展 MySQL 集群和 PostgreSQL 集群之间进行选择。

1. 右键单击数据库，然后选择**使用 IAM 凭证进行连接**。
**注意**  
还可以选择**复制 ARN**，以将数据库的 Amazon 资源名称（ARN）添加到剪贴板。

1. 在**数据来源和驱动程序**对话框中，执行以下操作以确保可以打开数据库连接：
   + 在**导入的数据来源**窗格中，确认选择了正确的数据来源。
   + 如果有消息表明您需要**下载缺失的驱动程序文件**，请选择**转到驱动程序**（扳手图标），下载所需文件。

1. 在**设置**窗格的**常规**选项卡中，确认以下字段显示的值是否正确：
   + **主机/端口** – 用于连接数据库的端点和端口。对于托管在 AWS Cloud 中的 Amazon RDS 数据库，端点总是以 `rds.amazon.com` 结尾。如果您通过代理连接到数据库实例，请使用这些字段指定代理的连接详细信息。
   + **身份验证** – **AWS IAM**（使用 IAM 凭证进行身份验证）。
   + **用户** – 数据库用户账户的名称。
   + **凭证** – 用于访问 AWS 账户的凭证。
   + **区域** – 托管数据库的 AWS 区域。
   + **RDS 主机/端口** – 数据库的端点和端口，如 AWS 管理控制台 中所列。如果您使用不同的端点连接到数据库实例，请在**主机/端口**字段中指定代理的连接详细信息（如前所述）。
   + **数据库** – 数据库名称。
   + **URL** – JetBrains IDE 用于连接到数据库的 URL。  
![\[Amazon RDS 数据库的连接设置以及用于身份验证的 IAM 凭证。\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-jetbrains/latest/userguide/images/rds-auth-iam.png)
**注意**  
有关可使用**数据来源和驱动程序**对话框配置的连接设置的完整说明，请参阅您正在使用的 [JetBrains IDE 文档](https://www.jetbrains.com/help/)。

1. 要验证连接设置是否正确，请选择**测试连接**。

   绿色复选标记表示测试成功。

1. 选择**应用**以应用设置，然后选择**确认**以开始使用数据来源。

   **数据库**工具窗口打开。这会显示树形结构的可用数据来源，其中的节点表示数据库元素，例如架构、表和键。
**重要**  
要使用**数据库**工具窗口，必须先在 JetBrains 中下载并安装 DataGrip。有关更多信息，请参阅 [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/)。

------
#### [ Connect with Secrets Manager ]

1. 打开 AWS Explorer（如果尚未打开）。

1. 单击 **Amazon RDS** 节点以展开支持的数据库引擎列表。

1. 单击支持的数据库引擎（Aurora、MySQL 或 PostgreSQL）节点以展开可用数据库实例列表。
**注意**  
如果选择 Aurora，则可以在扩展 MySQL 集群和 PostgreSQL 集群之间进行选择。

1. 右键单击数据库，然后选择**使用 Secrets Manager 连接**。
**注意**  
还可以选择**复制 ARN**，以将数据库的 Amazon 资源名称（ARN）添加到剪贴板。

1. 在**选择数据库密钥**对话框中，使用下拉字段为数据库选择凭证，然后选择**创建**。

1. 在**数据来源和驱动程序**对话框中，执行以下操作以确保可以打开数据库连接：
   + 在**导入的数据来源**窗格中，确认选择了正确的数据来源。
   + 如果有消息表明您需要**下载缺失的驱动程序文件**，请选择**转到驱动程序**（扳手图标），下载所需文件。

1. 在**设置**窗格的**常规**选项卡中，确认以下字段显示的值是否正确：
   + **主机/端口** – 用于连接数据库的端点和端口。对于托管在 AWS Cloud 中的 Amazon RDS 数据库，端点总是以 `rds.amazon.com` 结尾。如果您通过代理数据库连接到数据库，请使用这些字段指定代理的连接详细信息。
   + **身份验证** – **SecretsManager Auth**（使用 AWS Secrets Manager 进行身份验证)。
   + **凭证** – 用于访问 AWS 账户的凭证。
   + **区域** – 托管数据库的 AWS 区域。
   + **密钥名称/ARN** – 包含身份验证凭证的密钥的名称和 ARN。要覆盖**主机/端口**字段中的连接设置，请选中**使用密钥中的 URL 和端口**复选框。
   + **数据库** – 您在 **AWS Explorer** 中选择的数据库实例名称。
   + **URL** – JetBrains IDE 用于连接到数据库的 URL。
**注意**  
如果您使用 Secrets Manager 进行身份验证，则没有数据库的用户名和密码字段。此信息包含在密钥的加密密钥数据部分中。  
![\[连接设置以及用于身份验证的 IAM 凭证。\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-jetbrains/latest/userguide/images/rds-auth-asm.png)
**注意**  
有关可使用**数据来源和驱动程序**对话框配置的连接设置的完整说明，请参阅您正在使用的 [JetBrains IDE 文档](https://www.jetbrains.com/help/)。

1. 要验证连接设置是否正确，请选择**测试连接**。

   绿色复选标记表示测试成功。

1. 选择**应用**以应用设置，然后选择**确认**以开始使用数据来源。

   **数据库**工具窗口打开。这会显示树形结构的可用数据来源，其中的节点表示数据库元素，例如架构、表和键。
**重要**  
要使用**数据库**工具窗口，必须先在 JetBrains 中下载并安装 DataGrip。有关更多信息，请参阅 [https://www.jetbrains.com/datagrip/](https://www.jetbrains.com/datagrip/)。

------