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

# 使用连接亚马逊 DocumentDB DataGrip
<a name="data-grip-connect"></a>

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

## 先决条件
<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 访问 AWS 基础设施。如果您更喜欢此选项，请按照说明[使用安全地访问亚马逊文档数据库](https://aws.amazon.com/blogs/database/securely-access-amazon-documentdb-with-mongodb-compatibility-locally-using-aws-client-vpn/)。 AWS Client VPN

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

1.  DataGrip 在电脑上启动并创建一个**新项目**。  
![DataGrip 欢迎屏幕，突出显示了 “新建项目” 选项。](http://docs.aws.amazon.com/zh_cn/documentdb/latest/devguide/images/welcome.png)

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

1. 成功测试连接后，选择**确定**以保存数据源配置。

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

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

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