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

# 在 Toolkit 中使用 Amazon DocumentDB
<a name="docdb-overview"></a>

Amazon DocumentDB （與 MongoDB 相容） 是一種快速、可靠且全受管的資料庫服務，可簡化雲端中 MongoDB 相容資料庫的設定、操作和擴展。

如需 Amazon DocumentDB、入門資訊和教學課程的詳細資訊，請參閱 [Amazon DocumentDB](https://docs.aws.amazon.com//documentdb/latest/developerguide/what-is.html) 開發人員指南。

下列各節說明如何搭配 使用 Amazon DocumentDB AWS Toolkit for Visual Studio Code。

## 從 AWS Toolkit 存取 Amazon DocumentDB
<a name="docdb-overview-access"></a>

若要使用 AWS Toolkit 存取 Amazon DocumentDB，請完成下列程序。

**在 AWS 工具組中存取 Amazon DocumentDB**

1. 從 VS 程式碼開啟 AWS Toolkit for Visual Studio Code。

1. 從 AWS Toolkit 中，展開 **Explorer**。

1. 從 **Explorer** 展開 Amazon DocumentDB 以顯示您現有的 Amazon DocumentDB 資源。

## 建立執行個體型叢集。
<a name="docdb-overview-create-cluster"></a>

若要開始使用 Amazon DocumentDB，請完成下列程序來建立叢集。

**建立執行個體型叢集**

1. 從 AWS Toolkit for Visual Studio Code開啟 （按一下滑鼠右鍵） Amazon DocumentDB 的內容選單，然後選取**建立叢集**以在 VS 程式碼中開啟**建立 Amazon DocumentDB 叢集**對話方塊。

1. 從**叢集類型**畫面中，選擇**執行個體型叢集**。

1. 從**叢集名稱**畫面中，指定新叢集的名稱。

1. 從**選取引擎版本**畫面中，選擇您偏好的 Amazon DocumentDB 引擎版本。

1. 在**管理員使用者名稱和密碼**畫面中，指定管理員使用者名稱和密碼來保護您的叢集。

1. 從**指定儲存體加密**畫面中，選擇是否要加密叢集。

1. 在**執行個體數量**畫面中，設定您偏好的執行個體數量。

1. 從**選取執行個體類別**畫面中，選擇您偏好的執行個體類別，然後繼續建立新的叢集。
**注意**  
啟動叢集可能需要幾分鐘的時間。

## 複製叢集端點
<a name="docdb-overview-create-cluster"></a>

若要複製 Amazon DocumentDB 叢集端點，請完成下列程序。

**複製叢集端點**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要從中複製連線詳細資訊的叢集上按一下滑鼠右鍵，然後選擇**複製端點**，將叢集端點資訊複製到剪貼簿。

1. 您的叢集端點現在可以貼到您的文件中。

## 在瀏覽器中開啟
<a name="docdb-overview-browser-cluster"></a>

在 AWS 主控台中開啟 Amazon DocumentDB 叢集，以取得更多叢集管理功能。若要在預設 Web 瀏覽器中開啟 Amazon DocumentDB 叢集的 AWS 主控台，請完成下列程序。

**在 AWS 主控台中開啟叢集**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要在 AWS 主控台中檢視的叢集上按一下滑鼠右鍵，然後選擇在**瀏覽器中開啟**。

1.  AWS 主控台會在您的預設 Web 瀏覽器中開啟 Amazon DocumentDB 叢集。

## 展開現有的叢集
<a name="docdb-overview-expand-cluster"></a>

若要透過新增執行個體來擴展 Amazon DocumentDB 叢集，請完成下列程序。

**新增執行個體以擴展叢集**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要展開的叢集上按一下滑鼠右鍵**，然後選擇新增執行個體**，以在 VS 程式碼中開啟**新增執行個體**對話方塊。

1. 出現提示時，請在文字欄位中輸入新執行個體的名稱，然後按 **Enter**鍵繼續。

1. 出現提示時，請從清單中選擇執行個體類別以繼續。

1. **AWS Explorer** 會在新執行個體就緒時顯示建立狀態和更新。

## 停止叢集
<a name="docdb-overview-stopping-cluster"></a>

完成下列程序以停止您的 Amazon DocumentDB 叢集。

**注意**  
當您的叢集停止時，大多數叢集管理功能將無法使用。

**停止 Amazon DocumentDB 叢集**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 選擇您要停止之叢集旁邊的**停止叢集**按鈕，或在叢集上按一下滑鼠右鍵，然後選擇**停止叢集**。

1. 出現提示時，請選擇**是**以停止叢集，或**選擇取消**以取消停止程序，並讓叢集保持執行狀態。

1. **AWS Explorer** 會顯示叢集的狀態，並在叢集停止時更新。

## 重新啟動執行個體
<a name="docdb-overview-reboot-cluster"></a>

重新啟動執行個體對於疑難排解和進行次要變更非常有用，而不會影響整個叢集。若要重新啟動 Amazon DocumentDB 執行個體，請完成下列程序。

**重新啟動叢集執行個體**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要重新啟動的叢集執行個體上按一下滑鼠右鍵，然後選擇**重新啟動執行個體**。

1. 出現提示時，請選擇**是**以重新啟動執行個體，或**選擇取消**以取消重新啟動程序，並讓執行個體停止。

1. **AWS Explorer** 會顯示叢集的狀態，並在執行個體重新啟動時更新。

## 刪除執行個體
<a name="docdb-overview-delete-cluster"></a>

若要刪除 Amazon DocumentDB 叢集執行個體，請完成下列程序。

**注意**  
刪除執行個體不會影響您叢集中的資料。如果您刪除主要執行個體，其中一個複本執行個體會接管為可寫入的執行個體。

**刪除叢集執行個體**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在要刪除的叢集執行個體上按一下滑鼠右鍵，然後選擇**刪除**以在 VS 程式碼中開啟 delete-cluster-instance 確認對話方塊。

1. 遵循確認提示，然後按 **Enter**鍵刪除叢集執行個體。

1. **AWS Explorer** 會顯示叢集執行個體的狀態，並在執行個體刪除時更新。

## 檢視、新增和移除標籤
<a name="docdb-overview-tags"></a>

標籤用於組織和追蹤您環境中的資源。若要檢視或編輯與您的 Amazon DocumentDB 叢集相關聯的標籤，請完成下列其中一個程序。

**檢視叢集標籤**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要檢視標籤的叢集上按一下滑鼠右鍵，然後選擇**標籤...**以開啟對話方塊**的標籤**your cluster name****。

1. 您的標籤會顯示在對話方塊中，如果沒有標籤與您的叢集相關聯，則會顯示訊息 **【未指派標籤】**。

**將標籤新增至叢集**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要新增標籤的叢集上按一下滑鼠右鍵，然後選擇**標籤...**以開啟對話方塊**的標籤**your cluster name****。

1. 選擇**新增標籤...**按鈕，在 VS 程式碼中開啟**新增標籤**對話方塊。

1. 在文字欄位中輸入新標籤，然後按 **Enter** 鍵繼續。

1. 在文字欄位中輸入值，然後按 **Enter** 將鍵/值對新增至叢集。

**從叢集移除標籤**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要從中移除標籤的叢集上按一下滑鼠右鍵，然後選擇**標籤...**以開啟對話方塊**的標籤**your cluster name****。

1. 選擇**移除標籤...**按鈕以開啟 VS 程式碼中的**從對話方塊移除標籤**your cluster name****。

1. 從提供的清單中選擇您要移除的標籤，以從叢集中移除標籤。

## 修改執行個體類別
<a name="docdb-overview-instance-class"></a>

若要修改 Amazon DocumentDB 叢集執行個體的類別，請完成下列程序。

**修改執行個體類別**

1. 從 AWS Toolkit for Visual Studio Code展開 **Amazon DocumentDB** 以顯示您的 Amazon DocumentDB 叢集。

1. 在您要修改的叢集執行個體上按一下滑鼠右鍵，然後選擇**修改類別...**，以在 VS 程式碼中開啟**選取執行個體類別**對話方塊。

1. 從清單中選擇執行個體的新類別，以更新類別。

1. **AWS Explorer** 會顯示叢集執行個體的狀態，並在執行個體的類別更新時更新。