本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
开始使用 Amazon DocumentDB 弹性集群
这个入门部分将向您介绍如何创建和查询您的第一个弹性集群。
有许多连接和开始使用 Amazon DocumentDB 的方式。以下过程是用户开始使用我们强大的文档数据库的最快、最简单、最简单的方法。本指南用于Amazon CloudShell直接从连接和查询您的 Amazon DocumentDB 集群。 Amazon Web Services Management Console符合 Amazon 免费套餐条件的新客户可以免费使用亚马逊 DocumentDB CloudShell。如果您的 Amazon CloudShell 环境或 Amazon DocumentDB 弹性集群使用了超出免费套餐范围的资源,则您需要为这些资源支付正常 Amazon 费率。本指南将在不到 5 分钟的时间内让你开始使用亚马逊 DocumentDB。
先决条件
在创建第一个 Amazon DocumentDB 集群之前,您必须执行以下操作:
- 已创建 Amazon Web Services(Amazon)账户
-
在开始使用 Amazon DocumentDB 之前,您必须拥有 Amazon Web Services(Amazon)账户。该 Amazon 账户是免费的。您只需为使用的服务和资源付费。
如果您没有 Amazon Web Services 账户,请完成以下步骤来创建一个。
报名参加 Amazon Web Services 账户
按照屏幕上的说明操作。
在注册时,将接到电话,要求使用电话键盘输入一个验证码。
当您注册时 Amazon Web Services 账户,就会创建Amazon Web Services 账户根用户一个。根用户有权访问该账户中的所有 Amazon Web Services 服务 和资源。作为最佳安全实践,请为用户分配管理访问权限,并且只使用根用户来执行需要根用户访问权限的任务。
- 设置所需的 Amazon Identity and Access Management (IAM) 权限。
-
要管理集群、实例和集群参数组等 Amazon DocumentDB 资源,需要 Amazon 能够对您的请求进行身份验证的证书。有关更多信息,请参阅 适用于 Amazon DocumentDB 的 Identity and Access Management。
-
在的搜索栏中 Amazon Web Services Management Console,键入 IAM,然后在下拉菜单中选择 IAM。
-
一旦您进入 IAM 控制台,就从导航窗格中选择用户。
-
选择您的用户名。
-
单击添加更多权限。
-
选择直接附加策略。
-
在搜索栏中键入
AmazonDocDBElasticFullAccess
,并且一旦它出现在搜索结果中就选择之。 -
单击下一步。
-
单击添加更多权限。
-
注意
您的 Amazon 账户在每个区域都包含一个默认 VPC。如果您选择使用亚马逊 VPC,请完成亚马逊 V PC 用户指南中创建亚马逊 VPC 主题中的步骤。
第 1 步:创建弹性集群
在本节中,我们将说明如何使用 Amazon Web Services Management Console 或 Amazon CLI 并按照以下说明创建全新的弹性集群。
步骤 2:Connect 连接到您的弹性集群
使用连接到您的亚马逊 DocumentDB 弹性集群。 Amazon CloudShell
-
在 Amazon DocumentDB 管理控制台的集群下,找到您创建的弹性集群。通过单击集群旁边的复选框来选择您的集群。
-
单击 Connect to cluster(位于 “操作” 下拉菜单旁边)。只有在您单击集群旁边的复选框后,此按钮才会启用,并且集群的状态显示为 “可用”。将出现 “ CloudShell 运行命令” 屏幕。
-
在 “新环境名称” 字段中,输入一个唯一的名称,例如 “test”,然后单击 “创建并运行”。VPC 环境详细信息会自动为您的亚马逊 DocumentDB 数据库配置。
-
出现提示时,输入您在步骤 1:创建 Amazon DocumentDB 弹性集群(子步骤 5)中创建的密码。
在您输入密码并出现提示后
direct: mongos] <env-name>>
,您已成功连接到您的 Amazon DocumentDB 集群
注意
有关对 流进行问题排查的更多信息,请参阅 Amazon DocumentDB 问题排查。
第 3 步:对您的收藏进行分片、插入和查询数据
弹性集群增加对 Amazon DocumentDB 中分片过程的支持。既然您已连接到集群,您可以对集群分片、插入数据并运行数个查询。
-
要对集合分片,请输入以下:
sh.shardCollection("db.Employee1" , { "Employeeid" : "hashed" })
-
要插入单个文档,请输入以下内容:
db.Employee1.insertOne({"Employeeid":1, "Name":"Joe", "LastName": "Bruin", "level": 1 })
以下输出显示:
WriteResult({ "nInserted" : 1 })
-
要阅读您编写的文档,请输入以下
findOne()
命令(它返回单一文档):db.Employee1.findOne()
以下输出显示:
{ "_id" : ObjectId("61f344e0594fe1a1685a8151"), "EmployeeID" : 1, "Name" : "Joe", "LastName" : "Bruin", "level" : 1 }
-
要执行若干更多查询,请考虑游戏配制文件用例。首先,将几个条目插入标题为“员工”的集合。输入以下信息:
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': ObjectId('679d02cd6b5a0581be78bcbd'), '1': ObjectId('679d02cd6b5a0581be78bcbe'), '2': ObjectId('679d02cd6b5a0581be78bcbf'), '3': ObjectId('679d02cd6b5a0581be78bcc0') } }
-
要返回配制文件集合中的所有文档,请输入
find
() 命令:db.Employee.find()
您在步骤 4 中输入的数据显示。
-
要查询单一文档,请纳入过滤器(例如:“Katie”)。输入以下信息:
db.Employee.find({name: "Katie"})
以下输出显示:
[ { _id: ObjectId('679d02cd6b5a0581be78bcc0'), Employeeid: 4, name: 'Katie', lastname: 'Schaper', level: 3 } ]
-
要查找配置文件并对其进行修改,请输入
findAndModify
命令。在此示例中,给予员工“Matt”更高等级,即 “14”:db.Employee.findAndModify({ query: { "Employeeid" : 1, "name" : "Matt"}, update: { "Employeeid" : 1, "name" : "Matt", "lastname" : "Winkle", "level" : 14 } })
以下输出显示(请注意,级别尚未更改):
{ _id: ObjectId('679d02cd6b5a0581be78bcbd'), Employeeid: 1, name: 'Matt', lastname: 'Winkle', level: 12 }
-
要验证级别提高,请输入以下查询:
db.Employee.find({name: "Matt"})
以下输出显示:
[ { _id: ObjectId('679d02cd6b5a0581be78bcbd'), Employeeid: 1, name: 'Matt', lastname: 'Winkle', level: 14 } ]
第 4 步:探索
恭喜您!您已经成功完成了 Amazon DocumentDB 弹性集群的入门程序。
接下来做什么? 了解如何充分利用这个数据库及其热门功能:
注意
除非您将其删除,否则您通过此入门步骤创建的弹性集群将继续累积成本。有关指导,请参阅删除弹性集群。