适用范围:
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 帐户创建应用程序。