# 连接到 Amazon Redshift 集群
<a name="redshift-connection"></a>

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

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

选择一个选项卡，获取有关使用首选身份验证方法连接到集群的说明。

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

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

1. 单击 **Amazon Redshift** 节点，以展开可用群集列表。

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

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

1. 在**设置**窗格的**常规**选项卡中，确认以下字段显示的值是否正确：
   + **主机/端口** – 用于连接集群的端点和端口。对于托管在 AWS Cloud 中的 Amazon Redshift 集群，端点总是以 `redshift.amazon.com` 结尾。
   + **身份验证** – **AWS IAM**（使用 IAM 凭证进行身份验证）。
   + **用户** – 数据库用户账户的名称。
   + **凭证** – 用于访问 AWS 账户的凭证。
   + **区域** – 托管数据库的 AWS 区域。
   + **集群 ID** – 您在 **AWS Explorer** 中选择的集群 ID。
   + **数据库** – 将连接到的集群中的数据库名称。
   + **URL** – JetBrains IDE 用于连接到集群数据库的 URL。  
![\[Amazon Redshift 集群的连接设置以及用于身份验证的 IAM 凭证。\]](http://docs.aws.amazon.com/zh_cn/toolkit-for-jetbrains/latest/userguide/images/redshift-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 Redshift** 节点，以展开可用群集列表。

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

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

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

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

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

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

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

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

------