必要條件步驟 1：建立 AWS Cloud9 環境步驟 2：建立安全群組第 3 步：創建一個 Amazon DocumentDB 集群第 4 步：安裝蒙戈外殼步驟 5：Connect 到您的 Amazon DocumentDB 集群步驟 6：插入和查詢資料步驟 7：探索

開始使用 Amazon DocumentDB

有許多方法可以連接並開始使用 Amazon DocumentDB。我們建立本指南是因為我們發現這種方式是讓使用者開始使用我們強大的文件資料庫的最快、最簡單和最簡單的方式。本指南利AWS Cloud9用基於 Web 的終端機連接和查詢您的 Amazon DocumentDB 叢集使用蒙戈外殼直接從. AWS Management Console符合免費方案資格的新客戶可以 AWS 免費使用 Amazon DocumentDB。 AWS Cloud9 如果您的 AWS Cloud9 環境或 Amazon DocumentDB 叢集使用免費方案以外的資源，則需支付這些資源的正常費 AWS 率。本指南將幫助您在不到 15 分鐘的時間內開始使用 Amazon DocumentDB。

注意

本指南中的指示專門用於建立和連線到以 Amazon DocumentDB 執行個體為基礎的叢集。如果您想要建立並連線到 Amazon DocumentDB 彈性叢集，請參閱。開始使用 Amazon DocumentDB 彈性叢集

如果您希望透過建立與 Amazon EC2 執行個體的 SSH 連線，從本機電腦連線到 Amazon DocumentDB，請參閱使用 EC2 Connect 線說明

必要條件

在建立第一個 Amazon DocumentDB 叢集之前，您必須執行下列動作：

創建一個 Amazon Web Services（AWS）帳戶

在您可以開始使用 Amazon DocumentDB 之前，您必須有一個 Amazon Web Services（AWS）帳戶。該 AWS 帳戶是免費的。您僅需按使用的服務和資源量付費。

如果您沒有 AWS 帳戶，請完成以下步驟來建立一個。

若要註冊成為 AWS 帳戶

開啟 https://portal.aws.amazon.com/billing/signup。
請遵循線上指示進行。

部分註冊程序需接收來電，並在電話鍵盤輸入驗證碼。

當您註冊時 AWS 帳戶，會建立AWS 帳戶根使用者一個。根使用者有權存取該帳戶中的所有 AWS 服務和資源。作為安全最佳實務，請將管理存取權指派給使用者，並且僅使用根使用者來執行需要根使用者存取權的任務。

設定所需的 AWS Identity and Access Management (IAM) 許可。

存取管理 Amazon DocumentDB 資源 (例如叢集、執行個體和叢集參數群組) 需要 AWS 可用來驗證請求的登入資料。如需詳細資訊，請參閱 Amazon DocumentDB 的 Identity and Access Management。

在的搜尋列中輸入 IAM AWS Management Console，然後在出現的下拉式功能表中選取 IAM。
進入 IAM 主控台後，從導覽窗格中選取 [使用者]。
選擇您的用戶名。
點擊按鈕添加權限.
選取直接連接現有政策。
AmazonDocDBFullAccess在搜索欄中鍵入並在搜索結果中出現時選擇它。
單擊底部顯示「下一步：查看」的藍色按鈕。
點擊底部顯示「添加權限」的藍色按鈕。

創建一個 Amazon Virtual Private Cloud（Amazon VPC）

只有在您還沒有預設的 Amazon VPC 時，才需要執行此步驟。如果不這樣做，請完成 Amazon VPC 使用者指南中的 Amazon VPC 入門步驟 1。這將需要不到五分鐘。

步驟 1：建立 AWS Cloud9 環境

AWS Cloud9 提供一個基於 Web 的終端機，您可以使用蒙戈殼層連接和查詢您的 Amazon DocumentDB 叢集。

從 AWS Management Console 導航到 AWS Cloud9 控制台，然後選擇創建環境。
在「建立環境」對話方塊的「詳細資料」區段DocumentDBCloud9中，於「名稱」欄位中輸入。
在 [新增 EC2 執行個體] 對話方塊中，從平台下拉式清單中選擇 Amazon Linux 2。

重要
若要避免在建立 Amazon DocumentDB 資料庫期間發生錯誤，您必須在「平台」欄位中選取 Amazon Linux 2。如果您在上一個步驟中選擇使用現有的 Amazon EC2 執行個體，則必須使用 Amazon Linux 2 建立該執行個體。
對於「網路設定」和「標籤」區段，請保留預設設定。
按一下畫面底部的 [建立]。

您的新 AWS Cloud9 環境會顯示在「環境」表格中：

注意

AWS Cloud9 環境的佈建最多可能需要三分鐘。

步驟 2：建立安全群組

這個安全群組可讓您從環境連線到 Amazon DocumentDB 叢集。 AWS Cloud9

在 Amazon EC2 管理主控台的網路和安全性下，選擇安全群組。
選擇建立安全群組。
在「基本詳細資料」區段中：
1. 針對 Security group name (安全群組名稱)，輸入 demoDocDB。
2. 在描述中，輸入描述。
3. 對於 VPC，請接受預設 VPC 的使用。
在 Inbound rules (傳入規則) 區段中，選擇 Add rule (新增規則)。
1. 針對 Type (類型)，請選擇 Custom TCP (自訂 TCP)。
2. 對於連接埠範圍，輸入27017。
3. 針對來源，選擇完成步驟 1 之後所建立之 AWS Cloud9 環境的安全性群組。若要查看可用 AWS Cloud9 安全性群組的清單，請cloud9在「來源」欄位右側的搜尋欄位中輸入。選擇名稱為 aws-cloud9-<environment name> 的安全群組。
注意
連接埠 27017 是 Amazon DocumentDB 的預設連接埠。
針對輸出規則中的「目的地」欄位，選擇「自訂」。在旁邊的欄位中，搜尋您剛建立的名稱為安全性群組demoDocDB。您可能需要為 Amazon EC2 主控台重新整理瀏覽器，才能自動填入demoDocDB來源名稱。
接受所有其他預設值並選擇建立安全性群組。

第 3 步：創建一個 Amazon DocumentDB 集群

在此步驟中，您將使用您在上一個步驟中建立的安全群組來建立 Amazon DocumentDB 叢集。

注意

此步驟中的指示專門用於建立以 Amazon DocumentDB 執行個體為基礎的叢集。如果您想要建立 Amazon DocumentDB 彈性叢集，請參閱。開始使用 Amazon DocumentDB 彈性叢集

在 Amazon DocumentDB 理主控台的叢集下，選擇建立。
在「建立 Amazon DocumentDB 叢集」頁面的「叢集類型」區段中，選擇「以執行個體為基礎的叢集」(這是預設選項)。
在「組態」段落中，選擇 1 個執行處理。選擇一個執行個體有助於降低成本如果這是生產系統，建議您佈建三個執行個體以獲得高可用性。您可以將「組態」區段中的其他設定保留為預設值。
對於連線，請保留預設設定 [不連線至 EC2 運算資源]。
在「驗證」區段中，輸入登入認證。
開啟 [顯示進階設定]。
如果您要建立測試或示範叢集，請在 [網路設定] 區段中，針對 VPC 安全性群組選擇 DemoDocDB (VPC)。如果要為生產系統建立叢集，請選擇預設 (VPC)，或者如果要建立特定的 VPC 安全群組，請參閱 Amazon Virtual Private Cloud 使用者指南中的安全群組。
選擇建立叢集。

Amazon DocumentDB 現在正在佈建您的叢集，最多可能需要幾分鐘的時間才能完成。當叢集和執行個體狀態顯示為時，您可以連線到叢集available。

注意

如需叢集狀態值的相關資訊，請參閱《監控 Amazon DocumentDB》一章叢集狀態值中的。

如需執行個體狀態值的相關資訊，請參閱《監控 Amazon DocumentDB》一章執行個體狀態值中的。

第 4 步：安裝蒙戈外殼

現在，您將在步驟 1 中創建的 AWS Cloud9 環境中安裝 mongo 外殼。蒙戈殼層是一個命令列公用程式，可用來連接和查詢 Amazon DocumentDB 叢集。

如果您的 AWS Cloud9 環境仍然從步驟 1 開啟，請返回該環境並跳至指令 3。如果您瀏覽離開您的 AWS Cloud9 環境，請在 AWS Cloud9 管理主控台的 [環境] 下，尋找標示為 Document DBCloud9 的環境。在 Cloud9 IDE 資料行中選擇「開啟」。

在命令提示字元中，使用下列命令建立儲存庫檔案：


echo -e "[mongodb-org-4.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2013.03/mongodb-org/4.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://www.mongodb.org/static/pgp/server-4.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-4.0.repo

完成後，請使用以下命令安裝 mongo 外殼：
```
sudo yum install -y mongodb-org-shell
```

重要

如果您在 mongo 殼層安裝過程中收到錯誤，請檢查您在 Cloud9 配置期間選擇了哪個平台。您必須為 Cloud9 中的「平台」欄位選取 Amazon Linux 2。如果您選擇使用現有的 Amazon EC2 執行個體，它也必須是使用 Amazon Linux 2 建立的。

步驟 5：Connect 到您的 Amazon DocumentDB 集群

現在，您將使用您在步驟 4 中安裝的蒙戈殼層連接到您的 Amazon DocumentDB 叢集。

在 Amazon DocumentDB 管理主控台的叢集下，找到您的叢集。按一下叢集識別碼，選擇您建立的叢集。
E 默認ncryption-in-transit 情況下在 Amazon DocumentDB 上啟用。您可以選擇性地停用 TLS。若要下載對叢集進行驗證所需的目前憑證，請在「連線與安全性」索引標籤的「連線」區段的「下載對叢集進行驗證所需的 Amazon DocumentDB 憑證授權單位 (CA) 憑證」下，複製提供的 Connec t 字串。返回您的 AWS Cloud9 環境並粘貼連接字符串。
在 Amazon DocumentDB 主控台的連線與安全性索引標籤的「連線」區段的「使用 mongo 殼層連線到此叢集」下，返回叢集，複製提供的 Connec t 字串。省略複製，<insertYourPassword>以便在連接時由 mongo shell 提示您輸入密碼。

返回您的 AWS Cloud9 環境並粘貼連接字符串。

當您輸入密碼且提示出現提示時，即表rs0:PRIMARY>示您已成功連線至 Amazon DocumentDB 叢集。

注意

如需疑難排解的相關資訊，請參閱疑難排解 Amazon DocumentDB。

步驟 6：插入和查詢資料

現在您已連線到叢集，您可以執行一些查詢以熟悉文件資料庫的使用。

若要插入單一文件，請輸入下列內容：
```
db.collection.insert({"hello":"DocumentDB"})
```
您會得到以下輸出：
```
WriteResult({ "nInserted" : 1 })
```
您可以讀取使用findOne()指令撰寫的文件 (因為它只會傳回單一文件)。輸入以下內容：
```
db.collection.findOne()
```

您會得到以下輸出：


{ "_id" : ObjectId("5e401fe56056fda7321fbd67"), "hello" : "DocumentDB"
                        }

要執行更多查詢，請考慮遊戲配置文件使用案例。首先，將幾個項目插入到標題為的集合中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" : [ 1, 2, 3, 4 ] }

使用指find()令傳回縱斷面集合中的所有文件。輸入以下內容：
```
db.profiles.find()
```
您將獲得與您在步驟 5 中輸入的數據匹配的輸出。
使用篩選器查詢單一文件。輸入以下內容：
```
db.profiles.find({name: "Katie"})
```

你應該得到這個輸出：


{ "_id" : 4, "name" : "Katie", "status": "active", "level": 3,
                        "score":27}

現在，讓我們嘗試查找配置文件並使用findAndModify命令對其進行修改。我們將使用以下代碼給用戶 Matt 額外的十分：


db.profiles.findAndModify({
                query: { name: "Matt", status: "active"},
                update: { $inc: { score: 10 } }
            })

您會得到以下輸出（請注意，他的分數尚未增加）：


{
        "_id" : 1,
        "name" : "Matt",
        "status" : "active",
        "level" : 12,
        "score" : 202
}

您可以通過以下查詢驗證他的分數是否已更改：
```
db.profiles.find({name: "Matt"})
```

您會得到以下輸出：


{ "_id" : 1, "name" : "Matt", "status" : "active", "level" : 12, "score"
                        : 212 }

步驟 7：探索

恭喜您！您已成功完成 Amazon DocumentDB 的入門指南。

下一步是什麼？了解如何充分利用這個數據庫的一些熱門功能：

注意

除非您將其刪除，否則您從此入門練習建立的叢集將繼續累積成本。如需指示，請參閱刪除 Amazon DocumentDB 叢集。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

使用文件

快速開始使用 AWS CloudFormation