你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

使用 Azure 门户管理 Azure Cosmos DB 帐户

适用对象: NoSQL MongoDB Cassandra Gremlin

本文介绍如何使用 Azure 门户管理 Azure Cosmos DB 帐户中的各种任务。 也可使用其他 Azure 管理客户端(包括 Azure PowerShellAzure CLIAzure 资源管理器模板BicepTerraform)来管理 Azure Cosmos DB。

提示

Azure Cosmos DB 或控制平面的管理 API 并非像服务的其余部分那样针对高请求量而设计。 若要了解详细信息,请参阅控制平面服务限制

先决条件

创建帐户

按照以下步骤操作:

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

  2. 搜索 Azure Cosmos DB。 选择“创建”>“Azure Cosmos DB”。

  3. 在“创建 Azure Cosmos DB 帐户”页上,选择“Azure Cosmos DB for NoSQL”部分中的“创建”选项。

    Azure Cosmos DB 提供了多个 API:

    • NoSQL,用于文档数据
    • PostgreSQL
    • MongoDB,用于文档数据
    • Apache Cassandra
    • Apache Gremlin,用于图形数据

    若要详细了解 API for NoSQL,请参阅欢迎使用 Azure Cosmos DB

  4. 在“创建 Azure Cosmos DB 帐户”页中,输入新 Azure Cosmos DB 帐户的基本设置。

    设置 说明
    订阅 订阅名称 选择要用于此 Azure Cosmos DB 帐户的 Azure 订阅。
    资源组 资源组名称 选择一个资源组,或者选择“新建”,然后输入新资源组的唯一名称。
    帐户名 唯一的名称 输入标识 Azure Cosmos 帐户的名称。 由于 documents.azure.com 将追加到所提供的名称以创建 URI,因此,请使用唯一的名称。 名称只能包含小写字母、数字和连字符 (-)。 它必须是 3-44 个字符。
    位置 离用户最近的区域 选择用于托管 Azure Cosmos DB 帐户的地理位置。 使用离用户最近的位置,使他们能够以最快的速度访问数据。
    容量模式 预配吞吐量或无服务器 选择“预配吞吐量”以在预配吞吐量模式下创建帐户。 选择“无服务器”以在无服务器模式下创建帐户。
    应用 Azure Cosmos DB 免费层折扣 “应用”或“不应用” 如果使用 Azure Cosmos DB 免费层,在帐户中使用的前 1000 RU/s 和 25 GB 存储空间是免费的。 了解免费层的详细信息。
    限制总帐户吞吐量 已选中或未选中 限制可在此帐户上预配的总吞吐量。 此限制可防止与预配吞吐量相关的意外费用。 创建帐户后,可以更新或删除此限制。

    每个 Azure 订阅最多可以有一个免费层 Azure Cosmos DB 帐户,并且你必须在创建帐户时选择加入。 如果看不到用于应用免费层折扣的选项,那么订阅中的另一个帐户已启用免费层。

    屏幕截图显示“创建 Azure Cosmos DB 帐户”页。

    注意

    如果选择“无服务器”作为“容量模式”,则以下选项不可用:

    • 应用免费层折扣
    • 限制总帐户吞吐量
  5. 在“全局分发”选项卡中,配置以下详细信息。 在本快速入门中,你可以保留默认值:

    设置 说明
    异地冗余 禁用 通过将你的区域与另一区域进行配对来启用或禁用帐户的全局分发。 稍后可以将更多区域添加到帐户。
    多区域写入 禁用 借助多区域写入功能,可以利用全球数据库和容器的预配吞吐量。
    可用性区域 禁用 可用性区域有助于进一步提高应用程序的可用性和复原能力。

    注意

    如果在前面的“基本信息”页中选择“无服务器”作为“容量模式”,则以下选项不可用:

    • 异地冗余
    • 多区域写入
  6. (可选)可以在以下选项卡中配置更多详细信息:

    • 网络。 配置从虚拟网络访问
    • 备份策略。 配置定期连续备份策略。
    • 加密。 使用服务管理的密钥或客户管理的密钥
    • 标记。 标记是名称/值对,可让你通过将相同的标记应用到多个资源和资源组,对资源进行分类并查看合并的账单。
  7. 选择“查看 + 创建”。

  8. 检查帐户设置,然后选择“创建”。 创建帐户需要几分钟时间。 等待门户页显示“你的部署已完成”消息。

    屏幕截图显示部署已完成。

  9. 选择“转到资源”,转到 Azure Cosmos DB 帐户页。

    屏幕截图显示 Azure Cosmos DB 帐户页。

在数据库帐户中添加/删除区域

提示

添加新区域时,必须将所有数据完全复制并提交到新区域,然后才能将该区域标记为可用。 此操作所需的时间取决于帐户中存储的数据量。 如果正在进行异步吞吐量缩放操作,则吞吐量纵向扩展操作会暂停,但会在“添加/删除区域”操作完成后自动继续。

  1. 登录到 Azure 门户

  2. 转到 Azure Cosmos DB 帐户,在资源菜单中选择“全局复制数据”。

  3. 要添加区域,请在地图上选择包含与所需区域对应的 + 标签的六边形。 另外,若要添加某个区域,请选择“+ 添加区域”选项,然后从下拉菜单中选择一个区域。

  4. 若要删除区域,请选择带对号的蓝色六边形以从地图中清除一个或多个区域。 也可选择右侧位于区域旁边的“废纸篓”(🗑) 图标。

  5. 若要保存更改,请选择“确定”。

    “全局复制数据”菜单的屏幕截图,其中突出显示了某个区域。

    在单区域写入模式下,无法删除写入区域。 必须先故障转移到另一区域,然后才能删除当前的写入区域。

    在多区域写入模式下,如果你至少具有一个区域,则可以添加或删除任何区域。

    配置多个写入区域

    打开“全局复制数据”选项卡,选择“启用”以启用多区域写入。 启用多区域写入后,你的帐户当前拥有的所有读取区域将变为读取和写入区域。

    “全局复制数据”菜单的屏幕截图,其中突出显示了“配置区域”和“保存”。

为 Azure Cosmos DB 帐户启用服务托管故障转移

借助服务托管故障转移选项,在某个区域不可用时,Azure Cosmos DB 可以故障转移到具有最高故障转移优先级的区域,无需用户操作。 如果启用服务托管故障转移,则可修改区域优先级。 帐户必须有两个或更多个区域以启用服务托管故障转移。

  1. 在 Azure Cosmos DB 帐户中,打开“全局复制数据”窗格。

  2. 在窗格顶部选择“服务托管故障转移”。

    屏幕截图显示“全局复制数据”菜单。

  3. 在“服务托管故障转移”窗格中,确保将“启用服务托管故障转移”设置为“开”。

  4. 选择“保存”。

    “服务托管故障转移”门户菜单的屏幕截图。

为 Azure Cosmos DB 帐户设置故障转移优先级

在将 Azure Cosmos DB 帐户配置为进行服务托管故障转移后,可以更改区域的故障转移优先级。

重要

在将帐户配置为进行服务托管故障转移后,不能修改写入区域(故障转移优先级为零)。 要更改写入区域,必须禁用服务托管故障转移并执行手动故障转移。

  1. 在 Azure Cosmos DB 帐户中,打开“全局复制数据”窗格。

  2. 在窗格顶部选择“服务托管故障转移”。

    屏幕截图显示“全局复制数据”菜单。

  3. 在“服务托管故障转移”窗格中,确保将“启用服务托管故障转移”设置为“开”。

  4. 若要修改故障转移优先级,请将鼠标指针悬停在读取区域上,并通过在行左侧出现的三个点拖动读取区域。

  5. 选择“保存”。

    “服务托管故障转移”门户菜单的屏幕截图。

在 Azure Cosmos DB 帐户上执行手动故障转移

重要

Azure Cosmos DB 帐户必须配置为手动故障转移,才能成功执行此操作。

注意

如果在异步吞吐量缩放操作正在进行时执行手动故障转移操作,则会暂停吞吐量纵向扩展操作。 故障转移操作完成后,它会自动继续。 有关详细信息,请参阅缩放预配吞吐量(RU/秒)的最佳做法

警告

如果发生写入区域中断,导致 Azure Cosmos DB 帐户通过服务管理的故障转移将次要区域提升为新的主要写入区域,则原始写入区域在恢复后不会自动重新提升为写入区域。 你有责任使用 PowerShell、Azure CLI 或 Azure 门户切回恢复的区域作为写入区域(在安全的情况下,如上所述)。

  1. 转到你的 Azure Cosmos DB 帐户,打开“全局复制数据”菜单。

  2. 在菜单顶部,选择“手动故障转移”。

    “全局复制数据”菜单的屏幕截图。

  3. 在“手动故障转移”菜单上,选择你的新写入区域。 选中相应的复选框,以指示你了解此选项会更改你的写入区域。

  4. 若要触发故障转移,请选择“确定”。

    “手动故障转移”门户菜单的屏幕截图。