使用 Azure portal 管理 Azure Cosmos DB 帐户

Aplica-se a: ✅ NoSQL, ✅ MongoDB, ✅ Apache Cassandra, ✅ Apache Gremlin, ✅ Table

本文介绍如何使用 Azure portal 管理 Azure Cosmos DB 帐户上的各种任务。 Azure Cosmos DB 还可以与其他Azure管理客户端一起管理，包括 Azure PowerShell、Azure CLI、Azure Resource Manager templates、Bicep 和 Terraform。

提示

Azure Cosmos DB 或 控制平面的管理 API 并未像服务的其他部分那样设计用于处理高请求量。若要了解详细信息，请参阅控制平面服务限制

先决条件

无

创建帐户

按照以下步骤操作：

在Azure portal菜单或 Home 页面中，选择创建资源。
搜索 Azure Cosmos DB。选择 Create>Azure Cosmos DB。
在 创建 Azure Cosmos DB 帐户页上，选择 Azure Cosmos DB for NoSQL 节中的 create 选项。

Azure Cosmos DB 提供了多个 API：
- NoSQL，用于文档数据
- MongoDB，用于文档数据
- Apache Cassandra
- 表
- Apache Gremlin，用于图形数据
若要了解有关 NoSQL API 的详细信息，请参阅 Welcome 到 Azure Cosmos DB。

在 创建 Azure Cosmos DB 帐户页中，输入新 Azure Cosmos DB 帐户的基本设置。

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

每个 Azure 订阅最多只能拥有一个免费层 Azure Cosmos DB 帐户，并且必须在创建帐户时选择加入该免费层。如果看不到应用免费层折扣的选项，则说明订阅中的其他帐户已经应用了免费层折扣。

注意事项

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

应用免费层折扣
限制总帐户吞吐量

在“全局分发”选项卡中，配置以下详细信息。在本快速入门中，你可以保留默认值：

设置	值	说明
异地冗余	禁用	通过将你的区域与某个配对区域进行配对来启用或禁用帐户的多区域分布。稍后可以将更多区域添加到帐户。
多区域写入	禁用	借助多区域写入功能，可以利用全中国的数据库和容器的预配吞吐量。
可用区	禁用	可用区有助于进一步提高您的应用程序的可用性和弹性。

注意事项

在上一页的“基本信息”中，如果选择“容量模式”为“无服务器”，则以下选项不可用：

异地冗余
多区域写入

（可选）可以在以下选项卡中配置更多详细信息：
- 网络：配置来自虚拟网络的访问。
- 备份策略：配置定期或连续备份策略。
- 加密：使用服务管理密钥或客户管理密钥。
- 标记：标记是名称/值对，通过向多个资源和资源组应用相同的标记，可以对资源进行分类和查看合并计费。
选择“查看 + 创建”。
检查帐户设置，然后选择“创建”。创建帐户需要几分钟时间。等待门户页显示“你的部署已完成”消息。
选择转到资源访问“Azure Cosmos DB 帐户”页。

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

提示

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

登录到 Azure portal。
转到 Azure Cosmos DB 帐户，然后在资源菜单中选择在多区域复制数据。
要添加区域，请在地图上选择包含与所需区域对应的 + 标签的六边形。另外，若要添加某个区域，请选择“+ 添加区域”选项，然后从下拉菜单中选择一个区域。
若要删除区域，请选择带对号的蓝色六边形以从地图中清除一个或多个区域。还可以选择右侧区域旁边的 垃圾袋 （🗑）图标。
若要保存更改，请选择“确定”。

在单区域写入模式下，无法删除写入区域。在删除当前的写入区域之前，必须先故障转移到其他区域。

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

配置多个写入区域

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

为 Azure Cosmos DB 帐户启用由服务管理的故障转移

由服务管理的故障转移选项允许 Azure Cosmos DB 在某个区域不可用时自动故障转移到具有最高故障转移优先级的区域，无需用户操作。如果启用由服务管理的故障转移，则可修改区域优先级。您的帐户必须具有两个或更多区域才能启用服务管理故障切换。

在 Azure Cosmos DB 帐户中，打开 重新复制多区域数据窗格。
在窗格顶部选择“服务管理的故障转移”。
在“服务托管故障转移”面板中，确保将“启用服务托管故障转移”设置为“开”。
选择“保存”。

为 Azure Cosmos DB 账户执行强制故障转移

强制故障转移（区域脱机）使用户能够及时解决 Cosmos DB 帐户中性能下降、部分中断或区域中断的问题。服务托管的故障转移依赖于服务的确认，并且激活可能需要时间，这取决于中断的进展情况。强制故障转移允许管理员快速还原受影响区域的可用性，而无需等待服务管理的故障转移。

在 Azure Cosmos DB 帐户中，打开全局复制数据窗格。
在窗格顶部，选取 “脱机区域”。
查看警告消息，指示由于未复制的写入在区域中不可用而导致数据丢失的可能性，这些写入将基于故障转移优先级提升到新的写入区域。
选择要标记为脱机的区域，选中标题为“我理解并同意脱机当前所选区域”的框，然后单击“脱机区域”按钮。
完成后，将具有最高故障转移优先级的区域提升到新的写入区域，而原始写入区域将标记为脱机。

Azure Cosmos DB 服务团队负责将区域恢复联机。如果该区域在停机期间处于脱机状态，则可能需要三天以上的时间才能将其恢复到联机状态，具体取决于影响的严重程度。对于进行区域脱机的灾难恢复演练，请创建支持请求，以便将该区域重新联机。

在单个写入区域的情况下，如果写入区域在演练或停机期间脱机，则使该区域重新联机会将其恢复为“读取区域”。之后，可以执行“更改写入区域”操作，将区域还原为写入区域。

Azure Cosmos DB 为想要基于这些指标创建自动化的用户提供 Region Offline 和 Region Online 指标。例如，在区域重新联机后，可能需要触发自动化作业以更改写入区域。可在此处找到支持的数据库帐户指标列表。