本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 開始使用 Amazon DocumentDB
連線和開始使用 Amazon DocumentDB 的方法有很多。本指南是使用者開始使用我們強大文件資料庫最快速、最簡單且最簡單的方法。本指南使用 直接從 [AWS CloudShell](https://docs.aws.amazon.com/cloudshell/latest/userguide/welcome.html)連接和查詢 Amazon DocumentDB 叢集 AWS 管理主控台。符合 AWS 免費方案資格的新客戶可免費使用 Amazon DocumentDB 和 CloudShell。如果您的 AWS CloudShell 環境或 Amazon DocumentDB 叢集使用免費方案以外的資源，則會向您收取這些資源的正常 AWS 費率。本指南將協助您在五分鐘內開始使用 Amazon DocumentDB。
**注意**
本指南中的指示專門用於建立和連線至 AWS CloudShell 可使用 Amazon DocumentDB 和 的 Amazon DocumentDB 執行個體型叢集。
如果您想要建立並連線至 Amazon DocumentDB 彈性叢集，請參閱 [開始使用 Amazon DocumentDB 彈性叢集](elastic-get-started.md)。
如果您位於 AWS 中國區域，請參閱 [自動連接 Amazon EC2](connect-ec2-auto.md)。
**Topics**
+ [先決條件](#quickstart-prerequisites)
+ [步驟 1：建立叢集](#get-start-cluster)
+ [步驟 2：連線至您的叢集](#get-start-connectcluster)
+ [步驟 3：插入和查詢資料](#get-start-insert-query)
+ [步驟 4：探索](#get-start-congrats)
## 先決條件
建立第一個 Amazon DocumentDB 叢集之前，您必須執行下列動作：
**建立 Amazon Web Services (AWS) 帳戶**
您必須先擁有 Amazon Web Services () 帳戶，才能開始使用 Amazon DocumentDB。AWS AWS 該帳戶是免費的。您僅需按使用的服務和資源量付費。
如果您沒有 AWS 帳戶，請完成下列步驟來建立一個。
**註冊 AWS 帳戶**
1. 開啟 [https://portal.aws.amazon.com/billing/signup](https://portal.aws.amazon.com/billing/signup)。
1. 請遵循線上指示進行。
部分註冊程序需接收來電或簡訊，並在電話鍵盤輸入驗證碼。
當您註冊 時 AWS 帳戶，*AWS 帳戶根使用者*會建立 。根使用者有權存取該帳戶中的所有 AWS 服務 和資源。作為安全最佳實務，請將管理存取權指派給使用者，並且僅使用根使用者來執行[需要根使用者存取權的任務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks)。
**設定 needed AWS Identity and Access Management (IAM) 許可。**
管理叢集、執行個體和叢集參數群組等 Amazon DocumentDB 資源的存取權，需要 AWS 可用於驗證請求的登入資料。如需詳細資訊，請參閱[Amazon DocumentDB 的 Identity and Access Management](security-iam.md)。
1. 在 的搜尋列中 AWS 管理主控台，輸入 IAM，然後在出現的下拉式選單中選取 **IAM**。
1. 進入 IAM 主控台後，請從導覽窗格中選取**使用者**。
1. 選取您的使用者名稱。
1. 按一下 **Add Permission** (新增許可)。
1. 選取**直接連接政策**。
1. 在搜尋列`AmazonDocDBFullAccess`中輸入 ，並在搜尋結果中出現時選取它。
1. 按一下 **Next (下一步)**。
1. 按一下 **Add Permission** (新增許可)。
****
AWS 您的帳戶在每個區域中包含預設 VPC。如果您選擇使用 Amazon VPC，請完成《[Amazon VPC 使用者指南》中建立](https://docs.aws.amazon.com/vpc/latest/userguide/create-vpc.html) *Amazon VPC* 主題的步驟。
## 步驟 1：建立叢集
在此步驟中，您將建立 Amazon DocumentDB 叢集。
1. 登入 AWS 管理主控台，並在 https：//[https://console.aws.amazon.com/docdb](https://console.aws.amazon.com/docdb) 開啟 Amazon DocumentDB 主控台。
1. 在 Amazon DocumentDB 管理主控台的**叢集**下，選擇**建立**。
![\[清空叢集儀表板，其中包含建立新叢集和管理資源的選項。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-gs-start.png)
1. 在建立 Amazon DocumentDB 叢集頁面上的**叢集類型**區段中，選擇**執行個體型叢集** （這是預設選項）。
![\[叢集類型選擇會反白顯示執行個體型叢集選項，並說明這兩種叢集類型。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/create-cluster/cluster-type.png)
**注意**
此類別中的另一個選項是**彈性叢集**。若要進一步了解 Amazon DocumentDB 彈性叢集，請參閱 [使用 Amazon DocumentDB 彈性叢集](docdb-using-elastic-clusters.md)
1. 在**叢集組態**區段中：
1. 針對**叢集識別符**，輸入唯一名稱，例如 **mydocdbcluster**。請注意，無論如何輸入叢集名稱，主控台都會將所有叢集名稱變更為小寫。
1. 針對**引擎版本**，選擇 **5.0.0**。
![\[資料庫叢集的組態表單，其中包含識別符和引擎版本的欄位。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/create-cluster/cluster-config.png)
1. 在**叢集儲存組態**區段中，選擇 **Amazon DocumentDB Standard** （這是預設選項）。
![\[儲存類型選擇會反白顯示 Amazon DocumentDB Standard 選項，並說明兩種儲存類型。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/create-cluster/cluster-storage.png)
**注意**
此類別中的另一個選項是 **Amazon DocumentDB I/O 最佳化**。若要進一步了解任一選項，請參閱 [Amazon DocumentDB 叢集儲存組態](db-cluster-storage-configs.md)
1. 在**執行個體組態**區段中：
1. 針對**資料庫執行個體類別**，選擇**記憶體最佳化類別 （包括 r 類別）** （這是預設值）。
另一個執行個體選項是 **NVMe 支援的類別**。如需詳細資訊，請參閱 [NVMe 支援的執行個體](db-instance-nvme.md)。
1. 針對**執行個體類別**，選擇 **db.t3.medium**。這符合 AWS 免費試用的資格。
1. 針對**執行個體數量**，選擇 **1** 個執行個體。選擇一個執行個體有助於將成本降至最低。如果這是生產系統，我們建議您為高可用性佈建三個執行個體。
![\[資料庫執行個體的組態表單，其中包含資料庫執行個體類別、支援的執行個體類別和執行個體數量的欄位。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/create-cluster/instance-config.png)
1. 在**連線**區段中，保留**不連線至 EC2 運算資源**的預設設定。
![\[具有連線或不連線至 EC2 運算資源選項的資料庫連線設定。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/create-cluster/cluster-connectivity-no-ec2.png)
1. 在**身分驗證**區段中，輸入主要使用者的使用者名稱，然後選擇**自我管理**。輸入密碼，然後確認。
如果您改為選擇 **中的受管 AWS Secrets Manager**，請參閱 [使用 Amazon DocumentDB 和 進行密碼管理 AWS Secrets Manager](docdb-secrets-manager.md) 以取得詳細資訊。
![\[反白顯示 Managed in AWS Secrets Manager 選項並說明兩種身分驗證類型的身分驗證類型選擇。\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/create-cluster/cluster-auth-self.png)
1. 將所有其他選項保留為預設值，然後選擇**建立叢集**。
Amazon DocumentDB 現在正在佈建叢集，最多可能需要幾分鐘的時間才能完成。
**注意**
如需叢集狀態值的資訊，請參閱監控 Amazon DocumentDB 章節[叢集狀態值](monitoring_docdb-cluster_status.md#monitoring_docdb-status_values)中的 。
## 步驟 2：連線至您的叢集
使用 連線至 Amazon DocumentDB 叢集 AWS CloudShell。
1. 在 Amazon DocumentDB 管理主控台的**叢集下**，找到您建立的叢集。按一下叢集旁的核取方塊，以選擇叢集。
![\[Amazon DocumentDB 叢集管理介面顯示具有主要執行個體詳細資訊的區域叢集\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/cluster-connect-cloud-shell.png)
1. 按一下**連線至叢集** （動作****下拉式功能表旁）。只有在您按一下叢集旁的核取方塊，且區域叢集和主要執行個體 （兩者） 的狀態都顯示為**可用**之後，才會啟用此按鈕。隨即出現 CloudShell **Run 命令**畫面。
1. 在**新增環境名稱**欄位中，輸入唯一名稱，例如「測試」，然後按一下**建立並執行**。VPC 環境詳細資訊會自動為您的 Amazon DocumentDB 資料庫設定。
![\[叢集叢集 CloudShell Run 命令畫面，請求新的環境名稱\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-gs-run-command.png)
1. 出現提示時，輸入您在步驟 1：建立 Amazon DocumentDB 叢集中建立的密碼 （子步驟 7)。
![\[請求使用者密碼的 Cluster CloudShell 畫面\]](http://docs.aws.amazon.com/zh_tw/documentdb/latest/developerguide/images/ec-gs-cs-password.png)
輸入密碼且提示變成 後`rs0 [direct: primary] >`，您已成功連線到 Amazon DocumentDB 叢集。
**注意**
如需故障診斷的資訊，請參閱[故障診斷 Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/troubleshooting.html)。
## 步驟 3：插入和查詢資料
現在您已連線至叢集，您可以執行一些查詢來熟悉使用文件資料庫。
1. 若要插入單一文件，請輸入下列項目：
```
db.collection.insertOne({"hello":"DocumentDB"})
```
您會收到下列輸出：
```
{
acknowledged: true,
insertedId: ObjectId('673657216bdf6258466b128c')
}
```
1. 您可以使用 `findOne()`命令讀取您撰寫的文件 （因為它只會傳回單一文件）。輸入下列項目：
```
db.collection.findOne()
```
您會收到下列輸出：
```
{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB" }
```
1. 若要執行更多查詢，請考慮遊戲設定檔使用案例。首先，將幾個項目插入標題為 的集合`profiles`。輸入下列項目：
```
db.profiles.insertMany([{ _id: 1, name: 'Matt', status: 'active', level: 12, score: 202 },
{ _id: 2, name: 'Frank', status: 'inactive', level: 2, score: 9 },
{ _id: 3, name: 'Karen', status: 'active', level: 7, score: 87 },
{ _id: 4, name: 'Katie', status: 'active', level: 3, score: 27 }
])
```
您會收到下列輸出：
```
{ acknowledged: true, insertedIds: { '0': 1, '1': 2, '2': 3, '3': 4 } }
```
1. 使用 `find()`命令來傳回設定檔集合中的所有文件。輸入下列項目：
```
db.profiles.find()
```
您會收到與您在步驟 3 中輸入的資料相符的輸出。
1. 使用篩選條件對單一文件使用查詢。輸入下列項目：
```
db.profiles.find({name: "Katie"})
```
您會收到下列輸出：
```
{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3, "score":27}
```
1. 現在，讓我們嘗試尋找設定檔，並使用 `findAndModify`命令修改它。我們會為使用者 Matt 提供額外 10 點的下列程式碼：
```
db.profiles.findAndModify({
query: { name: "Matt", status: "active"},
update: { $inc: { score: 10 } }
})
```
您會收到下列輸出 （請注意，他的分數尚未增加）：
```
{
[{_id : 1, name : 'Matt', status: 'active', level: 12, score: 202}]
```
1. 您可以使用下列查詢來驗證他的分數是否已變更：
`db.profiles.find({name: "Matt"})`
您會收到下列輸出：
```
{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score" : 212 }
```
## 步驟 4：探索
恭喜您！您已成功完成 Amazon DocumentDB 執行個體型叢集的入門指南。
下一步是什麼？ 了解如何充分利用此資料庫及其一些熱門功能：
+ [管理 Amazon DocumentDB](https://docs.aws.amazon.com/documentdb/latest/developerguide/managing-documentdb.html)
+ [擴展](https://docs.aws.amazon.com/documentdb/latest/developerguide/operational_tasks.html)
+ [備份和還原](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore.html)
**注意**
除非您刪除叢集，否則您從此入門練習建立的叢集將繼續產生成本。如需指示，請參閱[刪除 Amazon DocumentDB 叢集](https://docs.aws.amazon.com/documentdb/latest/developerguide/db-cluster-delete.html)。