적용 대상: 
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에 대한 셸 변수를 만듭니다.
# 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"
아직 로그인하지 않은 경우 az login 명령을 사용하여 Azure CLI에 로그인합니다.
az group create 명령을 사용하여 새 리소스 그룹을 구독에 만듭니다.
az group create \
--name $resourceGroupName \
--___location $___location
az cosmosdb create 명령을 사용하여 기본 설정으로 NoSQL용 Azure Cosmos DB 계정을 만듭니다.
az cosmosdb create \
--resource-group $resourceGroupName \
--name $accountName \
--locations regionName=$___location
ACCOUNT_NAME, RESOURCE_GROUP_NAME 및 LOCATION에 대한 셸 변수를 만듭니다.
# 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"
아직 로그인하지 않은 경우 Connect-AzAccount 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 Portal에 로그인합니다.
Azure Portal 메뉴 또는 홈 페이지에서 리소스 만들기를 선택합니다.
새로 만들기 페이지에서 Azure Cosmos DB를 검색하여 선택합니다.
API 옵션 선택 페이지의 NoSQL - 권장 섹션에서 만들기 옵션을 선택합니다. Azure Cosmos DB에는 SQL, MongoDB, Gremlin, Table 및 Cassandra의 5가지 API가 있습니다. API for NoSQL에 대해 자세히 알아봅니다.
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 체험 계층을 사용하는 경우 처음에는 1000RU/초 및 25GB의 스토리지가 계정에 무료로 제공됩니다. 무료 등급에 대해 자세히 알아보세요. |
참고
Azure 구독당 최대 1개의 체험 계층 Azure Cosmos DB 계정을 사용할 수 있으며 계정을 만들 때 옵트인해야 합니다. 체험 계층 할인을 적용하는 옵션이 표시되지 않으면 구독의 다른 계정에서 이미 체험 계층을 사용하도록 설정되었음을 의미합니다.
검토 + 만들기를 선택합니다.
제공한 설정을 검토한 다음, 만들기를 선택합니다. 계정을 만드는 데 몇 분이 걸립니다. 포털 페이지에 배포가 완료됨이 표시될 때까지 기다린 다음, 계속 진행합니다.
리소스로 이동을 선택하여 Azure Cosmos DB 계정 페이지로 이동합니다.
