本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 使用 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 DocumentDBcluster。請遵循如何 的指示[使用 Amazon EC2 連線](connect-ec2.md)。
+ Amazon EC2 執行個體、VPN 連線或您已使用安全 VPN 存取 AWS 基礎設施的替代方案。如果您偏好此選項，請依照指示[安全地使用 存取 Amazon DocumentDB AWS Client VPN](https://aws.amazon.com/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.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/welcome.png)

1. 使用下列其中一種方式新增資料來源：

   1. 從主選單中，導覽至**檔案 – 新增 – 資料來源**，然後選取 **DocumentDB**

   1. 在 **Database Explorer** 中，按一下工具列中的新圖示 (**＋**)。導覽至**資料來源**，然後選取 **DocumentDB**。  
![+ 的下拉式清單會顯示資料來源子功能表。DocumentDB是從該子選單中選取。](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/explorer.png)

1. 在**一般**索引標籤的**資料來源**頁面上，檢查連線設定區域底部是否有**下載缺少驅動程式檔案**連結。按一下此連結，下載與資料庫互動所需的驅動程式。如需直接下載連結，請參閱 [JetBrains JDBC 驅動程式](https://www.jetbrains.com/datagrip/jdbc-drivers/)。  
![資料來源和驅動程式界面，其中顯示下載缺少驅動程式檔案連結。](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/missing-driver.png)

1. 在**一般**索引標籤中，指定連線詳細資訊：

   1. 在**主機**欄位中，指定 Amazon DocumentDB 叢集端點。

   1. **連接埠**已設定為 27017。如果您的叢集部署在不同連接埠上，請變更它。

   1. 針對**身分驗證**，選擇**使用者和密碼**。

   1. 輸入您的使用者名稱和密碼資訊。

   1. **資料庫**欄位為選用。您可以指定要連線的資料庫。

   1. 當您新增上述詳細資訊時，**URL** 欄位會自動完成。  
![資料來源和驅動程式界面上一般索引標籤中的主機、連接埠、身分驗證、資料庫和 URL 欄位。](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/connection.png)

1. 在 **SSH/SSL** 索引標籤中，啟用**使用 SSH 通道**，然後按一下 圖示以開啟 **SSH 組態**對話方塊。輸入下列資訊：

   1. 在**主機**欄位中，輸入 Amazon EC2 執行個體的主機名稱。

   1. 輸入 Amazon EC2 執行個體的使用者名稱和密碼。

   1. 針對**身分驗證類型**，選擇**金鑰對**。

   1. 輸入您的**私有金鑰檔案**。
**注意**  
如果您使用的是 VPN 選項，則不需要設定 SSH 通道。  
![資料來源和驅動程式介面中的 SSH/SSL 索引標籤，已選取使用 SSH 通道，且 SSH 組態圖示已反白。圖示會開啟顯示的 SSH 組態介面。](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/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_tw/documentdb/latest/developerguide/images/use-ssl.png)

1. 在**結構描述**索引標籤中，選擇**所有資料庫**，或在**結構描述模式**欄位中輸入篩選條件「\*：\*」。按一下**測試連線**連結以測試連線。  
![資料來源和驅動程式介面中的結構描述索引標籤，已選取所有資料庫選項。成功訊息會顯示在測試連線連結上方。](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/schemas.png)

1. 成功測試連線後，按一下**確定**以儲存資料來源組態。

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

DataGrip 提供各種功能，可協助您有效率地使用 Amazon DocumentDB：
+ **SQL 編輯器** – 使用 DataGrip 中的 SQL 編輯器，在 DocumentDB 集合上寫入和執行類似 SQL 的查詢。
+ **Visual Query Builder** — 使用視覺化查詢建置器以圖形方式建立查詢，而無需撰寫 SQL 程式碼。
+ **結構描述管理** — 輕鬆管理您的資料庫結構描述，包括建立、變更和捨棄集合。
+ **資料視覺化**：使用 DataGrip 中提供的各種視覺化工具來檢視和分析您的資料。
+ **匯出和匯入資料** — 使用 DataGrip 的匯出和匯入功能，在 Amazon DocumentDB 和其他資料庫之間傳輸資料。

如需使用 Amazon DocumentDB 和其他資料庫系統的更進階功能和秘訣，請參閱官方 [DataGrip 文件](https://www.jetbrains.com/datagrip/features/)。