快速入门:使用 Azure 门户创建 Azure Cosmos DB for NoSQL 帐户

适用范围: NoSQL

在本快速入门中,你将在 Azure 门户中创建一个新的 Azure Cosmos DB for NoSQL 帐户。 然后,使用 Azure 门户中的数据资源管理器体验来创建数据库和容器并配置所有必需的设置。 最后,将示例数据添加到容器并发出基本查询。

先决条件

创建账户

首先创建一个新的 Azure Cosmos DB for NoSQL 帐户

  1. 登录到 Azure 门户 (https://portal.azure.cn)。

  2. 在全局搜索栏中输入 Azure Cosmos DB

    Azure 门户中的全局搜索栏的屏幕截图。

  3. 在“服务”中,选择“Azure Cosmos DB”。

    搜索菜单中选择的 Azure Cosmos DB 选项的屏幕截图。

  4. Azure Cosmos DB 窗格中,选择“创建”,然后选择“Azure Cosmos DB for NoSQL”。

    Azure 服务的窗格中“创建”选项的屏幕截图。

    Azure Cosmos DB API 选择窗格的屏幕截图,其中突出显示了 API for NoSQL。

  5. 在“基本信息”窗格中,配置以下选项,然后选择“查看 + 创建” :

    订阅 选择 Azure 订阅
    资源组 创建新的资源组,或选择现有资源组
    Account Name 提供多个区域唯一的名称
    可用性区域 禁用
    位置 为订阅选择支持的 Azure 区域

    Azure Cosmos DB for NoSQL 资源创建“基本信息”窗格的屏幕截图。

    提示

    可以将任何未指定的选项保留为其默认值。 还可以配置帐户,将帐户总吞吐量限制为每秒 1,000 个请求单位 (RU/s),并启用免费层以最大限度地降低成本。

  6. 在“查看 + 创建”窗格中,等待帐户验证成功完成,然后选择“创建”。

    创建体验中资源验证步骤的屏幕截图。

  7. 门户会自动导航到“部署”窗格。 等待部署完成。

    包含当前待处理部署的部署窗格的屏幕截图。

  8. 部署完成后,选择“转到资源”以导航到新的 Azure Cosmos DB for NoSQL 帐户。

    已完全部署的资源的屏幕截图,其中突出显示了“转到资源”选项。

创建数据库和容器

接下来,使用数据资源管理器在门户中创建数据库和容器。

  1. 在帐户资源窗格中,在服务菜单中选择“数据资源管理器”。

    帐户的服务菜单中“数据资源管理器”选项的屏幕截图。

  2. 在“数据资源管理器”窗格中,选择“新建容器”选项。

    数据资源管理器中“新建容器”选项的屏幕截图。

  3. 在“新建容器”对话框中,配置以下值,然后选择“确定”:

    Database 新建
    数据库 ID cosmicworks
    在容器之间共享吞吐量 不要选中
    容器 ID employees
    分区键 department/name
    容器吞吐量(自动缩放) 自动缩放
    容器最大 RU/s 1000

    用于创建新数据库和容器的对话框的屏幕截图,其中填充了指定的选项。

  4. 创建名为 demo.bicepparam 或 (demo.bicepparam) 的新文件。

  5. 在数据资源管理器的层次结构中观察新创建的数据库和容器。

    具有数据库容器的数据资源管理器层次结构的屏幕截图。

    提示

    或者,可以展开容器节点来观察其他属性和配置设置。

添加和查询示例数据

最后,使用数据资源管理器创建一个示例项,然后向容器发出基本查询。

  1. 展开数据资源管理器树中员工容器的节点。 然后,选择“”选项。

    数据资源管理器层次结构中容器内的“项”选项的屏幕截图。

  2. 在数据资源管理器的菜单中,选择“新项”。

    数据资源管理器中“新项”选项的屏幕截图。

  3. 现在,在员工容器中为新项插入以下 JSON,然后选择“保存”:

    {
      "id": "aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb",
      "name": {
        "first": "Kai",
        "last": "Carter"
      },
      "email": "<kai@adventure-works.com>",
      "department": {
        "name": "Logistics"
      }
    }
    

    数据资源管理器中新项的 JSON 内容的屏幕截图。

  4. 在数据资源管理器的菜单中,选择“新建 SQL 查询”。

    数据资源管理器菜单中“新建 SQL 查询”选项的屏幕截图。

  5. 现在,插入以下 NoSQL 查询,使用不区分大小写的搜索获取 logistics 部门的所有项。 然后,查询将输出格式化为结构化的 JSON 对象。 通过选择“执行查询”来运行查询:

    SELECT VALUE {
        "name": CONCAT(e.name.last, " ", e.name.first),
        "department": e.department.name,
        "emailAddresses": [
            e.email
        ]
    }
    FROM
        employees e
    WHERE
        STRINGEQUALS(e.department.name, "logistics", true)
    

    数据资源管理器中的 NoSQL 查询文本的屏幕截图。

  6. 观察查询的 JSON 数组输出。

    [
      {
        "name": "Carter Kai",
        "department": "Logistics",
        "emailAddresses": [
          "kai@adventure-works.com"
        ]
      }
    ]
    

    数据资源管理器中上一个 NoSQL 查询的执行结果的屏幕截图。