创建 Azure Cosmos DB for NoSQL 帐户
本文内容
适用范围: NoSQL
Azure Cosmos DB for NoSQL 帐户包含所有 Azure Cosmos DB 资源:数据库、容器和项。 该帐户为各种工具和 SDK 提供唯一终结点,用于连接到 Azure Cosmos DB 并执行日常操作。 有关 Azure Cosmos DB 中资源的详细信息,请参阅 Azure Cosmos DB 资源模型 。
先决条件
创建帐户
使用 API for NoSQL 创建单个 Azure Cosmos DB 帐户。
为 accountName、resourceGroupName 和 location 创建 shell 变量。
# Variable for resource group name
resourceGroupName="msdocs-cosmos"
# Variable for location
location="chinanorth"
# Variable for account name with a randomnly generated suffix
let suffix=$RANDOM*$RANDOM
accountName="msdocs-$suffix"
如果尚未登录,请使用 az login
命令登录到 Azure CLI。
使用 az group create
命令在订阅中创建新的资源组。
az group create \
--name $resourceGroupName \
--location $location
使用 az cosmosdb create
命令创建具有默认设置的新 Azure Cosmos DB for NoSQL 帐户。
az cosmosdb create \
--resource-group $resourceGroupName \
--name $accountName \
--locations regionName=$location
为 ACCOUNT_NAME、RESOURCE_GROUP_NAME 和 LOCATION 创建 shell 变量。
# Variable for resource group name
$RESOURCE_GROUP_NAME = "msdocs-cosmos"
# Variable for location
$LOCATION = "China North"
# Variable for account name with a randomnly generated suffix
$SUFFIX = Get-Random
$ACCOUNT_NAME = "msdocs-$SUFFIX"
如果尚未登录,请使用 Connect-AzAccount -Environment AzureChinaCloud
cmdlet 登录到 Azure PowerShell。
使用 New-AzResourceGroup
cmdlet 在订阅中创建新的资源组。
$parameters = @{
Name = $RESOURCE_GROUP_NAME
Location = $LOCATION
}
New-AzResourceGroup @parameters
使用 New-AzCosmosDBAccount
cmdlet 创建具有默认设置的新 Azure Cosmos DB for NoSQL 帐户。
$parameters = @{
ResourceGroupName = $RESOURCE_GROUP_NAME
Name = $ACCOUNT_NAME
Location = $LOCATION
}
New-AzCosmosDBAccount @parameters
提示
对于本指南,建议使用资源组名称 msdocs-cosmos
。
登录 Azure 门户 。
在 Azure 门户菜单或主页中,选择“创建资源” 。
在“新建”页面中搜索“Azure Cosmos DB”,然后选择它。
Azure Cosmos DB 具有五个 API:SQL、MongoDB、Gremlin、Table 和 Cassandra。 详细了解 SQL API 。
在“创建 Azure Cosmos DB 帐户”页中,输入以下信息:
设置
值
说明
订阅
订阅名称
选择要用于此 Azure Cosmos DB 帐户的 Azure 订阅。
资源组
资源组名称
选择一个资源组,或者选择“新建”,然后输入新资源组的唯一名称。
帐户名
唯一的名称
输入用于标识 Azure Cosmos DB 帐户的名称。 该名称将用作后缀为“documents.azure.cn”的完全限定的域名 (FQDN) 的一部分,因此该名称必须在多个区域中独一无二。 名称只能包含小写字母、数字和连字符 (-)。 名称的长度也必须介于 3 - 44 个字符之间。
位置
离用户最近的区域
选择用于托管 Azure Cosmos DB 帐户的地理位置。 使用离用户最近的位置,使他们能够以最快的速度访问数据。
容量模式
预配吞吐量或无服务器
选择“预配吞吐量”以在预配吞吐量 模式下创建帐户。 选择“无服务器”以在无服务器 模式下创建帐户。
应用 Azure Cosmos DB 免费层折扣
“应用”或“不应用”
使用 Azure Cosmos DB 免费层,你将在帐户中获得每秒前 1000 RU 的免费吞吐量和 25 GB 的免费存储。 了解免费层 的详细信息。
注意
每个 Azure 订阅最多可以有一个免费层 Azure Cosmos DB 帐户,并且你必须在创建帐户时选择加入使用。 如果看不到用于应用免费层折扣的选项,这意味着订阅中的另一个帐户已启用免费层。
选择“查看 + 创建”。
查看提供的设置,然后选择“创建”。 创建帐户需要几分钟时间。 等待门户页显示“部署已完成”后再继续。
选择“转到资源”,转到 Azure Cosmos DB 帐户页。
后续步骤
本指南介绍了如何创建 Azure Cosmos DB for NoSQL 帐户。 现在可以使用 Azure Cosmos DB 帐户创建应用程序。