本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

# 使用 DataGrip 连接到 Amazon DocumentDB
<a name="data-grip-connect"></a>

[DataGrip](https://www.jetbrains.com/help/datagrip/documentdb.html) 是一个强大的集成式开发环境（IDE），支持各种数据库系统，包括 Amazon DocumentDB。本节将引导您完成使用 DataGrip 连接到 Amazon DocumentDB 集群的步骤，从而让您使用图形界面轻松管理和查询您的数据。

## 先决条件
<a name="data-grip-prerequisites"></a>
+ 您的计算机已安装 DataGrip IDE。您可以从 [JetBrains](https://www.jetbrains.com/datagrip/download/#section=windows) 下载。
+ 在与您的 Amazon DocumentDB 集群相同的 VPC 中运行的 Amazon EC2 实例。您将使用此实例建立从您的本地机到 Amazon DocumentDb 集群的安全隧道。要了解如何 [使用 Amazon EC2 进行连接](connect-ec2.md)，请遵循以下说明：
+ Amazon EC2 实例的替代方案，VPN 连接，或者如果您已经使用安全的 VPN 访问您的 Amazon 基础设施。如果您首选此选项，请遵循[使用 Amazon Client VPN 安全访问 Amazon DocumentDB](https://www.amazonaws.cn/blogs/database/securely-access-amazon-documentdb-with-mongodb-compatibility-locally-using-aws-client-vpn/)的说明。

## 使用 DataGrip 连接
<a name="data-grip-connect-steps"></a>

1. 在您的计算机上启动 DataGrip 并创建一个**新项目**。  
![DataGrip 欢迎屏幕，突出显示了“新建项目”选项。](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/welcome.png)

1. 通过以下方式之一添加新数据来源：

   1. 从主菜单中导航到 **文件 — 新建 — 数据来源**，然后选择 **DocumentDB**

   1. 在**数据库资源管理器**中，单击工具栏中的新建图标 (**\+**)。导航到**数据来源**，然后选择**DocumentDB**。  
![+ 的下拉列表显示了“数据来源”子菜单。从该子菜单中选择 DocumentDB。](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/explorer.png)

1. 在**数据来源**页面上的**常规**选项卡中，检查在连接设置区底部是否有**下载缺少的驱动程序文件**链接。单击此链接下载与数据库交互所必备的驱动程序。有关直接下载链接，请参阅 [JetBrains JDBC 驱动程序](https://www.jetbrains.com/datagrip/jdbc-drivers/)。  
![“数据来源和驱动程序”界面突出显示了“下载缺失的驱动程序文件”链接。](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/missing-driver.png)

1. 在**常规**选项卡中，指定连接详情：

   1. 在**主机**字段中，指定 Amazon DocumentDB 集群端点。

   1. **端口**已设置成 27017。如果您的集群部署在一个不同端口上，请更改之。

   1. 对于**身份验证**，请选择**用户 & 密码**。

   1. 输入您的用户名和密码信息。

   1. **数据库**字段为可选项。您可以指定您想要连接的数据库。

   1. 您添加上述详情时，**URL**字段自动完成。  
![“数据来源和驱动程序”界面的“常规”选项卡中的“主机”、“端口”、“身份验证”、“数据库”和“URL”字段。](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/connection.png)

1. 在 **SSH/SSL** 选项卡中，启用**使用 SSH 隧道**，然后单击图标打开 **SSH 配置**对话框。输入以下信息：

   1. 在**主机**字段中，输入您的 Amazon EC2 实例的主机名。

   1. 为您的 Amazon EC2 实例输入用户名和密码。

   1. 对于 **Authentication Type**（身份验证类型），选择 **密钥对**。

   1. 输入您的**私钥文件**。
**注意**  
如果您正使用 VPN 选项，则无需配置 SSH 隧道。  
![“数据来源和驱动程序”界面中的 SSH/SSL 选项卡，已选中“使用 SSH 隧道”，并突出显示了 SSH 配置图标。该图标将打开显示的“SSH 配置”界面。](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/ssh-tunnel.png)

1. 在** SSH/SSL **选项卡中，启用**使用 SSL**。在 **CA 文件**字段中，输入您计算机上到达 `global-bundle.pem` 文件的位置。对于**模式**，保留**需要**选项。
**注意**  
你可以从这个位置或用这个命令：wget [https://rds-truststore.s3.cn-north-1.amazonaws.com.cn/global/global-bundle.pem](https://rds-truststore.s3.cn-north-1.amazonaws.com.cn/global/global-bundle.pem)下载证书
**注意**  
如果您要连接到 Amazon DocumentDB 弹性集群，则无需指定 CA 文件。保留勾选**使用 SSL** 选项及所有其他选项处于其默认值。  
![“数据来源和驱动程序”界面中的 SSH/SSL 选项卡，启用了 SSL 设置。](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/use-ssl.png)

1. 在**架构**选项卡中，选择**所有数据库**或在**架构模式**字段中输入筛选器“\*:\*”。单击**测试连接**链接以测试该连接。  
![“数据来源和驱动程序”界面中的“架构”选项卡，已选择“所有数据库”选项。“测试连接”链接上方会显示一条“成功”消息。](http://docs.amazonaws.cn/documentdb/latest/developerguide/images/schemas.png)

1. 一旦成功测试连接，单击**确定**以保存数据来源配置。

## DataGrip 功能
<a name="data-grip-features"></a>

DataGrip 提供各种功能来帮助您高效地使用 Amazon DocumentDB：
+ **SQL 编辑器** — 使用 DataGrip 中的 SQL 编辑器在您的 DocumentDB 集合上编写并且执行 SQL 样查询。
+ **可视性查询生成器**- 使用可视性查询生成器以图形方式创建查询，而无需编写 SQL 代码。
+ **架构管理** - 轻松管理您的数据库架构，包括创建、更改和删除集合。
+ **数据可视化** — 使用 DataGrip 中可用的各种可视化工具查看并分析您的数据。
+ **导出和导入数据** — 使用 DataGrip 的导出和导入功能在 Amazon DocumentDB和其他数据库之间传输数据。

有关用于 Amazon DocumentDB 和其他数据库系统的更多高级功能和技巧，请参阅正式的 [DataGrip 文档](https://www.jetbrains.com/datagrip/features/) 。