本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
Amazon DocumentDB 入門
連線和開始使用 Amazon DocumentDB 的方法有很多種。我們建立本指南的原因在於,我們發現這種方式是讓使用者開始使用我們強大文件資料庫最快速、最簡單和最簡單的方式。本指南使用 Amazon Elastic Compute Cloud (Amazon EC2) 直接從 連線和查詢 Amazon DocumentDB 叢集 AWS Management Console。符合 AWS 免費方案資格的新客戶可免費使用 Amazon DocumentDB 和 Amazon EC2。如果您的 Amazon EC2 環境或 Amazon DocumentDB 叢集使用免費層以外的資源,則會向您收取這些資源的正常 AWS 費率。本指南將協助您在 15 分鐘內開始使用 Amazon DocumentDB。
注意
本指南中的說明專門用於建立和連線至 Amazon DocumentDB 執行個體型叢集。如果您想要建立並連線至 Amazon DocumentDB 彈性叢集,請參閱 開始使用 Amazon DocumentDB 彈性叢集。
主題
如果您想要透過建立 Amazon Word 執行個體的 Word 連線,從本機機器連線至 Amazon DocumentDB,請參閱 SSH EC2 使用 Amazon 連線 EC2
必要條件
建立第一個 Amazon DocumentDB 叢集之前,您必須執行下列動作:
- 建立 Amazon Web Services (AWS) 帳戶
-
您必須先擁有 Amazon Web Services () 帳戶,才能開始使用 Amazon DocumentDB。AWS AWS 帳戶是免費的。您僅需按使用的服務和資源量付費。
如果您沒有 AWS 帳戶,請完成下列步驟以建立 。
若要註冊 AWS 帳戶
開啟 https://portal.aws.amazon.com/billing/ 註冊
。 請遵循線上指示進行。
部分註冊程序需接收來電,並在電話鍵盤輸入驗證碼。
當您註冊 時 AWS 帳戶,AWS 帳戶根使用者會建立 。根使用者有權存取該帳戶中的所有 AWS 服務 和資源。作為安全最佳實務,請將管理存取權指派給使用者,並且僅使用根使用者來執行需要根使用者存取權的任務。
- 設定 needed AWS Identity and Access Management (IAM) 許可。
-
管理叢集、執行個體和叢集參數群組等 Amazon DocumentDB 資源的存取權,需要 AWS 可用於驗證請求的憑證。如需詳細資訊,請參閱Amazon DocumentDB 的身分和存取管理。
-
在 的搜尋列中 AWS Management Console,輸入 IAM,然後在出現的下拉式選單中選取 IAM。
-
進入 IAM 主控台後,請從導覽窗格中選取使用者。
-
選取您的使用者名稱。
-
按一下按鈕 新增許可。
-
選取直接連接現有政策。
-
在搜尋列
AmazonDocDBFullAccess
中輸入 ,並在搜尋結果中出現時選取它。 -
按一下底部標示下一步:檢閱的藍色按鈕。
-
按一下底部標示新增許可的藍色按鈕。
-
- 建立 Amazon Virtual Private Cloud (Amazon VPC)
-
AWS 您的帳戶在每個區域中包含預設 VPC。只有在您選擇使用預設的 Amazon VPC 時,才需要此步驟。在此情況下,請完成 Amazon VPC 使用者指南中建立 Amazon VPC 主題中的步驟。
- 啟動 Amazon EC2 執行個體
-
完成 Amazon Elastic Compute Cloud 使用者指南中 Amazon EC2 主題入門的步驟 1 和 2。
步驟 1:建立 Amazon DocumentDB 叢集
在此步驟中,您將建立 Amazon DocumentDB 叢集。
-
在 Amazon DocumentDB 管理主控台的叢集下,選擇建立。
-
在建立 Amazon DocumentDB 叢集頁面上的叢集類型區段中,選擇執行個體型叢集 (這是預設選項)。
-
在組態區段中:
對於叢集識別符,輸入唯一名稱,例如
mydocdbcluster
。請注意,無論如何輸入叢集名稱,主控台都會將所有叢集名稱變更為小寫。針對引擎版本,選擇 5.0.0。
針對執行個體類別,選擇 db.t3.medium。這符合 AWS 免費方案的資格。
針對執行個體數量,選擇 1 個執行個體。選擇一個執行個體有助於將成本降至最低。如果這是生產系統,建議您佈建三個執行個體以獲得高可用性。
-
在叢集儲存組態區段中,選擇 Amazon DocumentDB Standard (這是預設選項)。
-
在連線區段中:
選取連線至 EC2 運算資源。
針對 EC2 執行個體,選取您在 中建立的 EC2 執行個體必要條件。
-
在身分驗證區段中,輸入登入憑證。
-
將所有其他選項保留為預設值,然後選擇建立叢集。
注意
當您設定 EC2 執行個體與 Amazon DocumentDB 資料庫之間的連線時,Amazon DocumentDB 會自動為您的 VPC 執行個體和 Amazon DocumentDB 資料庫設定 EC2 安全群組。如需詳細資訊,請參閱與EC2執行個體的自動連線概觀。
Amazon DocumentDB 現在正在佈建叢集,最多可能需要幾分鐘的時間才能完成。當叢集和執行個體狀態顯示為可用時,您可以連線至叢集。
注意
步驟 2:安裝 mongo shell
在您在 中建立的 Amazon EC2 執行個體中安裝 mongo shell必要條件。mongo shell 是命令列公用程式,用於連接和查詢 Amazon DocumentDB 叢集。
連線至您的 Amazon EC2 執行個體,並在命令提示中,使用下列命令建立儲存庫檔案:
echo -e "[mongodb-org-5.0] \nname=MongoDB Repository\nbaseurl=https://repo.mongodb.org/yum/amazon/2023/mongodb-org/5.0/x86_64/\ngpgcheck=1 \nenabled=1 \ngpgkey=https://pgp.mongodb.com/server-5.0.asc" | sudo tee /etc/yum.repos.d/mongodb-org-5.0.repo
完成後,請使用下列命令安裝 mongo shell:
sudo yum install -y mongodb-org-shell
步驟 3:連線至您的 Amazon DocumentDB 叢集
使用您在步驟 2 中安裝的 mongo shell 連線至 Amazon DocumentDB 叢集。
-
在 Amazon DocumentDB 管理主控台的叢集下,找到您的叢集。按一下叢集識別符,選擇您建立的叢集。
-
Amazon DocumentDB 預設為啟用 Encryption-in-transit 。您可以選擇性地停用 TLS。若要下載對叢集進行身分驗證所需的目前憑證,請在連線和安全索引標籤的連線區段中,下載對叢集進行身分驗證所需的 Amazon DocumentDB Certificate Authority (CA) 憑證下,複製提供的命令。返回 Amazon EC2 執行個體並貼上命令。
-
在 Amazon DocumentDB 主控台的連線與安全索引標籤的連線區段中,使用 mongo shell 連線至此叢集,複製提供的連線字串。省略複製,
<insertYourPassword>
以便在連線時,mongo Shell 會提示您輸入密碼。返回 Amazon EC2 執行個體並貼上連線字串。
當您輸入密碼且提示變成 時rs0:PRIMARY>
,您已成功連線至 Amazon DocumentDB 叢集。
注意
如需疑難排解的資訊,請參閱疑難排解 Amazon DocumentDB。
步驟 4:插入和查詢資料
現在您已連線至叢集,您可以執行一些查詢,以熟悉使用文件資料庫。
-
若要插入單一文件,請輸入下列項目:
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 }
步驟 5:探索
恭喜您!您已成功完成 Amazon DocumentDB 入門指南。
下一步是什麼? 了解如何充分利用此資料庫及其一些常用功能:
注意
除非您刪除叢集,否則您從此入門練習中建立的叢集將繼續產生成本。如需指示,請參閱刪除 Amazon DocumentDB 叢集。