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

创建 Azure Cosmos DB for NoSQL 帐户

适用范围： NoSQL

Azure Cosmos DB for NoSQL 帐户包含所有 Azure Cosmos DB 资源：数据库、容器和项。 该帐户为各种工具和 SDK 提供唯一终结点，用于连接到 Azure Cosmos DB 并执行日常操作。 有关 Azure Cosmos DB 中资源的详细信息，请参阅 Azure Cosmos DB 资源模型。

先决条件

• 具有活动订阅的 Azure 帐户。 免费创建帐户。

创建帐户

使用 API for NoSQL 创建单个 Azure Cosmos DB 帐户。

Azure CLI

1. 为 accountName、resourceGroupName 和 location 创建 shell 变量。

   # Variable for resource group name
   resourceGroupName="msdocs-cosmos"
   
   # Variable for location
   location="westus"
   
   # Variable for account name with a randomnly generated suffix
   let suffix=$RANDOM*$RANDOM
   accountName="msdocs-$suffix"
   

2. 如果尚未登录，请使用 az login 命令登录到 Azure CLI。

3. 使用 az group create 命令在订阅中创建新的资源组。

   az group create \
       --name $resourceGroupName \
       --location $location
   

4. 使用 az cosmosdb create 命令创建具有默认设置的新 Azure Cosmos DB for NoSQL 帐户。

   az cosmosdb create \
       --resource-group $resourceGroupName \
       --name $accountName \
       --locations regionName=$location
   

PowerShell

1. 为 ACCOUNT_NAME、RESOURCE_GROUP_NAME 和 LOCATION 创建 shell 变量。

   # Variable for resource group name
   $RESOURCE_GROUP_NAME = "msdocs-cosmos"
   
   # Variable for location
   $LOCATION = "West US"
   
   # Variable for account name with a randomnly generated suffix
   $SUFFIX = Get-Random
   $ACCOUNT_NAME = "msdocs-$SUFFIX"
   

2. 如果尚未登录，请使用 Connect-AzAccount cmdlet 登录到 Azure PowerShell。

3. 使用 New-AzResourceGroup cmdlet 在订阅中创建新的资源组。

   $parameters = @{
       Name = $RESOURCE_GROUP_NAME
       Location = $LOCATION
   }
   New-AzResourceGroup @parameters    
   

4. 使用 New-AzCosmosDBAccount cmdlet 创建具有默认设置的新 Azure Cosmos DB for NoSQL 帐户。

   $parameters = @{
       ResourceGroupName = $RESOURCE_GROUP_NAME
       Name = $ACCOUNT_NAME
       Location = $LOCATION
   }
   New-AzCosmosDBAccount @parameters
   

Portal

提示

对于本指南，建议使用资源组名称 msdocs-cosmos。

1. 登录 Azure 门户。

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

3. 在“新建”页面中搜索“Azure Cosmos DB”，然后选择它。

4. 在“选择 API 选项”页中，选择“NoSQL - 建议”部分中的“创建”选项。 Azure Cosmos DB 具有五个 API：SQL、MongoDB、Gremlin、Table 和 Cassandra。 详细了解 API for NoSQL。

   

5. 在“创建 Azure Cosmos DB 帐户”页中，输入以下信息：

   设置	值	说明
   订阅	订阅名称	选择要用于此 Azure Cosmos DB 帐户的 Azure 订阅。
   资源组	资源组名称	选择一个资源组，或者选择“新建”，然后输入新资源组的唯一名称。
   帐户名	唯一的名称	输入用于标识 Azure Cosmos DB 帐户的名称。 该名称将用作后缀为“documents.azure.com”的完全限定的域名 (FQDN) 的一部分，因此该名称必须全局唯一。 名称只能包含小写字母、数字和连字符 (-)。 名称的长度也必须介于 3 - 44 个字符之间。
   位置	离用户最近的区域	选择用于托管 Azure Cosmos DB 帐户的地理位置。 使用离用户最近的位置，使他们能够以最快的速度访问数据。
   容量模式	预配吞吐量或无服务器	选择“预配吞吐量”以在预配吞吐量模式下创建帐户。 选择“无服务器”以在无服务器模式下创建帐户。
   应用 Azure Cosmos DB 免费层折扣	“应用”或“不应用”	使用 Azure Cosmos DB 免费层，你将在帐户中获得每秒前 1000 RU 的免费吞吐量和 25 GB 的免费存储。 了解免费层的详细信息。

   注意

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

   

6. 选择“查看 + 创建”。

7. 查看提供的设置，然后选择“创建”。 创建帐户需要几分钟时间。 等待门户页显示“部署已完成”后再继续。

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

   

后续步骤

本指南介绍了如何创建 Azure Cosmos DB for NoSQL 帐户。 现在可以使用 Azure Cosmos DB 帐户创建应用程序。

使用 Azure Cosmos DB for NoSQL 创建 .NET 控制台应用程序