快速入门：使用 Azure 门户创建 Azure DocumentDB 群集

在本快速入门中，你将创建新的 Azure DocumentDB 群集。 此群集包含所有典型的 MongoDB 资源：数据库、集合和文档。 群集为各种工具和驱动程序提供了一个唯一的终结点，用于连接到 Azure DocumentDB 并执行日常作。

先决条件

• Azure 订阅服务

  • 如果没有 Azure 订阅，请创建 一个免费帐户

创建群集

若要开始，首先需要创建一个 Azure DocumentDB 群集，该群集充当存储和管理 NoSQL 数据的基础。

1. 登录到 Azure 门户 （https://portal.azure.com）。

2. 在 Azure 门户菜单或主页中，选择“创建资源” 。

3. 在 “新建 ”页上，搜索并选择 Azure DocumentDB。

   

4. 在“创建 Azure DocumentDB 群集”页和“基本信息”部分中，选择“群集层”部分中的“配置”选项。

   

5. 在“ 缩放 ”页上，配置这些选项，然后选择“ 保存 ”以将更改保存到群集层。

   	价值
   群集层	M30 tier, 2 vCore, 8-GiB RAM
   每个分片的存储量	128 GiB

   

6. 返回 “基本信息 ”部分，配置以下选项：

   	价值
   Subscription	选择您的 Azure 订阅
   资源组	创建新的资源组，或选择现有资源组
   群集名称	提供一个全局唯一的名称
   位置	为订阅选择支持的 Azure 区域
   MongoDB 版本	选择 8.0
   管理员用户名	创建用户名以以用户管理员身份访问群集
   密码	使用与用户名关联的唯一密码

   

   小窍门

   记录用于用户名和密码的值。 本指南稍后会使用这些值。 有关有效值的详细信息，请参阅 群集限制。

7. 选择下一步：网络。

8. 在“网络”选项卡上的“防火墙规则”部分中，配置以下选项：

   	价值
   连接方法	Public access
   允许从 Azure 中的 Azure 服务和资源公开访问此群集	已启用

9. 为当前客户端设备添加防火墙规则，通过选择 “+ 添加当前客户端 IP 地址”来授予对群集的访问权限。

   

   小窍门

   在许多企业环境中，由于 VPN 或其他企业网络的设置，开发人员计算机 IP 地址会隐藏。 在这些情况下，可以通过将 IP 地址范围添加 0.0.0.0 - 255.255.255.255 为防火墙规则来暂时允许访问所有 IP 地址。 将此防火墙规则暂时用作连接测试和开发的一部分。

10. 选择“查看 + 创建”。

11. 查看提供的设置，然后选择“创建”。 创建群集需要几分钟时间。 等待资源部署完成。

12. 最后，选择转到资源以前往门户中的 Azure DocumentDB 集群。

获取群集凭据

获取用于连接到群集的凭据。

1. 在群集页上，在资源菜单中选择 “连接字符串 ”选项。

2. 在 “连接字符串 ”部分中，复制或记录 “连接字符串 ”字段中的值。

重要

门户中的连接字符串不包括密码值。 必须将 <password> 占位符替换为创建群集时输入的凭据或以交互方式输入密码。

通过快速入门使用 MongoDB Shell 进行连接

若要使用 MongoDB Shell 直接连接到 Azure DocumentDB，请使用 Azure 门户中资源页上提供的快速启动体验。

1. 在群集资源页中，从导航菜单中选择“快速启动”（预览）。

2. 然后选择 “打开 MongoDB shell”。

3. 等待 MongoDB Shell 环境启动。

4. 环境准备就绪后，输入 Y 接受通知。

   注释

   如果在接受通知后遇到使用 MongoDB Shell 进行连接的问题，请确保 Azure Cloud Shell 有权访问群集。

5. 现在，输入密码，将群集连接到 Cloud Shell。

执行测试查询

通过执行一系列测试命令和查询来验证是否已成功连接到群集。

1. 通过运行 connectionStatus 命令检查连接状态。

   db.runCommand({connectionStatus: 1})
   

   {
     ...
     ok: 1
   }
   

2. 列出群集中的数据库。

   show dbs
   

3. 切换到特定数据库。 将 <database-name> 占位符替换为群集中任何数据库的名称。

   use <database-name>
   

   小窍门

   例如，如果数据库名称为 inventory，则命令为 use inventory。

4. 列出数据库中的集合。

   show collections
   

5. 查找特定集合中的前五项。 将 <collection-name> 占位符替换为群集中任何集合的名称。

   db.<collection-name>.find().limit(5)
   

   小窍门

   例如，如果集合名称为 equipment，则命令为 db.equipment.find().limit(5)。

清理资源

完成 Azure DocumentDB 群集后，可以删除创建的 Azure 资源，以免产生更多费用。

1. 在 Azure 门户的“搜索”栏中，搜索并选择“资源组”。

   

2. 在列表中选择为本快速入门使用的资源组。

   

3. 在资源组页上，选择“删除资源组”。

4. 在删除确认对话框中，输入资源组的名称以确认要删除它。 最后，选择“删除”以永久删除资源组。

   

相关内容

• 从 MongoDB Shell 进行连接
• 从 Azure Cloud Shell 进行连接
• 将数据迁移到 Azure DocumentDB