적용 대상: 
NoSQL MongoDB Cassandra Gremlin 테이블
이 문서에서는 Azure Portal을 사용하여 Azure Cosmos DB 계정에서 다양한 작업을 관리하는 방법을 설명합니다. Azure Cosmos DB는 Azure PowerShell, Azure CLI, Azure Resource Manager 템플릿, Bicep 및 Terraform을 포함하여 다른 Azure 관리 클라이언트로 관리될 수도 있습니다.
팁
Azure Cosmos DB 또는 컨트롤 플레인에 대한 관리 API는 서비스의 나머지 부분과 같은 높은 요청 볼륨을 위해 설계되지 않았습니다. 자세한 내용은 컨트롤 플레인 서비스 제한을 참조하세요.
다음 단계를 따릅니다.
Azure Portal 메뉴 또는 홈 페이지에서 리소스 만들기를 선택합니다.
Azure Cosmos DB를 검색합니다. 만들기>Azure Cosmos DB를 선택합니다.
Azure Cosmos DB 계정 만들기 페이지의 Azure Cosmos DB for NoSQL 섹션 내에서 만들기 옵션을 선택합니다.
Azure Cosmos DB는 여러 API를 제공합니다.
API for NoSQL에 대한 자세한 내용은 Azure Cosmos DB 시작을 참조하세요.
Azure Cosmos DB 계정 만들기 페이지에서 새 Azure Cosmos DB 계정에 대한 기본 설정을 입력합니다.
| 설정 | 값 | Description |
|---|---|---|
| 구독 | 구독 이름 | 이 Azure Cosmos DB 계정에 사용할 Azure 구독을 선택합니다. |
| 리소스 그룹 | 리소스 그룹 이름 | 리소스 그룹을 선택하거나 새로 만들기를 선택한 후, 새 리소스 그룹에 고유한 이름을 입력합니다. |
| 어카운트 이름 | 고유 이름 | Azure Cosmos DB 계정을 식별하는 이름을 입력합니다. URI를 만들기 위해 제공하는 이름에 documents.azure.com이 추가되므로 고유한 이름을 사용합니다. 이름에는 소문자, 숫자, 하이픈(-) 문자만 사용할 수 있습니다. 3~44자여야 합니다. |
| 위치 | 사용자와 가장 가까운 지역 | Azure Cosmos DB 계정을 호스트할 지리적 위치를 선택합니다. 데이터에 가장 빨리 액세스할 수 있도록 사용자와 가장 가까운 위치를 사용합니다. |
| 용량 모드 | 프로비저닝된 처리량 또는 서버리스 | 프로비저닝된 처리량을 선택하여 프로비저닝된 처리량 모드에서 계정을 만듭니다. 서버리스를 선택하여 서버리스 모드에서 계정을 만듭니다. |
| Azure Cosmos DB 체험 계층 할인 적용 | 적용 또는 적용 안 함 | Azure Cosmos DB 무료 계층을 사용하는 경우 처음에는 1000RU/초 및 25GB의 스토리지가 계정에 무료로 제공됩니다. 체험 계층에 대해 자세히 알아보세요. |
| 총 계정 처리량 제한 | 선택 여부 | 이 계정에서 프로비전할 수 있는 총 처리량을 제한합니다. 이 한도는 프로비전된 처리량과 관련된 예기치 않은 요금을 방지합니다. 계정을 만든 후 이 한도를 업데이트하거나 제거할 수 있습니다. |
Azure 구독당 최대 1개의 무료 계층 Azure Cosmos DB 계정을 사용할 수 있으며 계정을 만들 때 옵트인해야 합니다. 무료 계층 할인을 적용하는 옵션이 표시되지 않으면 구독의 다른 계정에서 이미 무료 계층을 사용하도록 설정되어 있는 것입니다.
참고 항목
용량 모드로 서버리스를 선택한 경우 다음 옵션을 사용할 수 없습니다.
전역 배포 탭에서 다음 세부 정보를 구성합니다. 이 빠른 시작의 기본값을 그대로 둘 수 있습니다.
| 설정 | 값 | Description |
|---|---|---|
| 지리적 중복 | 사용 안 함 | 지역에 쌍 영역을 페어링하여 계정에서 글로벌 배포를 사용하거나 사용하지 않도록 설정합니다. 나중에 계정에 더 많은 지역을 추가할 수 있습니다. |
| 다중 지역 쓰기 | 사용 안 함 | 다중 영역 쓰기 기능을 사용하면 전 세계의 데이터베이스 및 컨테이너에 대해 프로비저닝된 처리량을 활용할 수 있습니다. |
| 가용성 영역 | 사용 안 함 | 가용성 영역은 애플리케이션의 가용성 및 복원력을 한층 향상시킬 수 있습니다. |
참고 항목
이전 기본 사항 페이지에서 서버리스를 용량 모드로 선택하는 경우 다음 옵션을 사용할 수 없습니다.
필요에 따라 다음 탭에서 자세한 내용을 구성할 수 있습니다.
검토 + 만들기를 선택합니다.
계정 설정을 검토한 다음, 만들기를 선택합니다. 계정을 만드는 데 몇 분이 걸립니다. 포털 페이지에 배포가 완료됨이 표시되기를 기다립니다.
리소스로 이동을 선택하여 Azure Cosmos DB 계정 페이지로 이동합니다.
팁
새 지역이 추가되면 해당 지역이 사용 가능으로 표시되기 전에 모든 데이터를 완전히 복제하고 새 지역에 커밋해야 합니다. 이 작업에 걸리는 시간은 계정에 저장된 데이터의 양에 따라 다릅니다. 비동기 처리량 스케일링 작업이 진행 중인 경우 처리량 스케일 업 작업이 일시 중지되고 지역 추가/제거 작업이 완료되면 자동으로 다시 시작됩니다.
Azure 포털에 로그인합니다.
Azure Cosmos DB 계정으로 이동하고, 리소스 메뉴에서 전역으로 데이터 복제를 선택합니다.
지역을 추가하려면 지도에서 원하는 지역에 해당하는 + 레이블이 있는 육각형을 선택합니다. 또는, 지역을 추가하려면 + 지역 추가 옵션을 선택하고 드롭다운 메뉴에서 Azure 지역을 선택합니다.
지역을 제거하려면 확인 표시가 있는 파란색 육각형을 선택하여 맵에서 하나 이상의 지역을 지웁니다. 오른쪽의 지역 옆에 있는 “휴지통”(🗑) 아이콘을 선택할 수도 있습니다.
변경 내용을 저장하려면 확인을 선택합니다.
단일 지역 쓰기 모드에서는 쓰기 지역을 제거할 수 없습니다. 현재 쓰기 지역을 삭제하려면 먼저 다른 Azure 지역으로 장애 조치해야 합니다.
다중 지역 쓰기 모드에서는 하나 이상의 Azure 지역이 있으면 Azure 지역을 추가하거나 제거할 수 있습니다.
전역으로 데이터 복제 탭을 열고 사용을 선택하여 다중 지역 쓰기를 사용하도록 설정합니다. 다중 지역 쓰기를 사용하도록 설정한 후에는 현재 계정에 있는 모든 읽기 지역이 읽기 및 쓰기 지역이 됩니다.
서비스 관리 장애 조치(failover) 옵션을 사용하면 Azure Cosmos DB가 지역을 사용할 수 없게 되는 경우 사용자 작업 없이 장애 조치(failover) 우선 순위가 가장 높은 지역으로 장애 조치(failover)할 수 있습니다. 서비스 관리 장애 조치(failover)가 사용하도록 설정되면 지역 우선 순위를 수정할 수 있습니다. 서비스 관리형 장애 조치(failover)를 사용하도록 설정하려면 계정에 두 개 이상의 지역이 있어야 합니다.
Azure Cosmos DB 계정에서 글로벌로 데이터 복제 창을 엽니다.
창의 위쪽에서 서비스 관리형 장애 조치(failover)를 선택합니다.
서비스 관리형 장애 조치(failover) 창에서 서비스 관리형 장애 조치(failover) 사용이 켜기로 설정되었는지 확인합니다.
저장을 선택합니다.
서비스 관리형 장애 조치를 사용하도록 Azure Cosmos DB 계정을 구성한 후 지역의 장애 조치 우선 순위를 변경할 수 있습니다.
Important
서비스 관리형 장애 조치를 사용하도록 계정을 구성하면 쓰기 지역(장애 조치 우선 순위 = 0)을 수정할 수 없습니다. 쓰기 영역을 변경하려면 서비스 관리 장애 조치(failover)를 사용하지 않도록 설정하고 수동 장애 조치(failover)를 수행해야 합니다.
Azure Cosmos DB 계정에서 글로벌로 데이터 복제 창을 엽니다.
창의 위쪽에서 서비스 관리형 장애 조치(failover)를 선택합니다.
서비스 관리형 장애 조치(failover) 창에서 서비스 관리형 장애 조치(failover) 사용이 켜기로 설정되었는지 확인합니다.
장애 조치 우선 순위를 수정하려면 마우스로 가리킬 때 나타나는 행 왼쪽의 점 세 개를 통해 읽기 지역을 끕니다.
저장을 선택합니다.
Important
이 작업이 성공하기 위해서는 수동 장애 조치(failover)에 대해 Azure Cosmos DB 계정을 구성해야 합니다.
참고 항목
비동기식 처리량 스케일링 작업이 진행되는 동안 수동 장애 조치 작업을 수행하면 처리량 스케일 업 작업이 일시 중지됩니다. 장애 조치 작업이 완료되면 자동으로 다시 시작됩니다. 자세한 내용은 프로비저닝된 처리량(RU/s) 스케일링 모범 사례를 참조하세요.
Warning
Azure Cosmos DB 계정이 서비스 관리 장애 조치(failover)를 통해 보조 지역을 새 기본 쓰기 지역으로 승격하는 쓰기 지역 중단이 발생할 경우 원래 쓰기 지역은 복구된 후 자동으로 쓰기 지역으로 다시 승격되지 않습니다. PowerShell, Azure CLI 또는 Azure Portal을 사용하여 복구된 지역을 쓰기 지역으로 다시 전환하는 것은 사용자의 책임입니다(위에 설명된 대로 안전한 경우).
Azure Cosmos DB 계정으로 이동하고 전역으로 데이터 복제 메뉴를 엽니다.
메뉴의 위쪽에서 수동 장애 조치를 선택합니다.
수동 장애 조치 메뉴에서 새 쓰기 지역을 선택합니다. 이 옵션이 쓰기 영역을 변경한다는 것을 알고 있음을 나타내는 확인란을 선택합니다.
장애 조치를 트리거하려면 확인을 선택합니다.
