적용 대상:
NoSQL
MongoDB
카산드라
그렘린
테이블
이 문서에서는 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를 제공합니다.
- NoSQL, 문서 데이터용
- PostgreSQL
- MongoDB, 문서 데이터용
- Apache Cassandra
- 테이블
- Apache Gremlin, 그래프 데이터용
API for NoSQL에 대한 자세한 내용은 Azure Cosmos DB 시작을 참조하세요.
Azure Cosmos DB 계정 만들기 페이지에서 새 Azure Cosmos DB 계정에 대한 기본 설정을 입력합니다.
설정 값 설명 구독 구독 이름 이 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 계정을 사용할 수 있으며 계정을 만들 때 옵트인해야 합니다. 무료 계층 할인을 적용하는 옵션이 표시되지 않으면 구독의 다른 계정에서 이미 무료 계층을 사용하도록 설정되어 있는 것입니다.
참고 항목
서버 리스 를 용량 모드로 선택하는 경우 다음 옵션을 사용할 수 없습니다.
- 무료 계층 할인 적용
- 총 계정 처리량 제한
전역 배포 탭에서 다음 세부 정보를 구성합니다. 이 빠른 시작의 기본값을 그대로 둘 수 있습니다.
설정 값 설명 지리적 중복 사용 안 함 지역에 쌍 영역을 페어링하여 계정에서 글로벌 배포를 사용하거나 사용하지 않도록 설정합니다. 나중에 계정에 더 많은 지역을 추가할 수 있습니다. 다중 지역 쓰기 사용 안 함 다중 영역 쓰기 기능을 사용하면 전 세계의 데이터베이스 및 컨테이너에 대해 프로비저닝된 처리량을 활용할 수 있습니다. 가용성 영역 사용 안 함 가용성 영역을 사용하면 애플리케이션의 가용성 및 복원력을 더욱 향상시킬 수 있습니다. 참고 항목
이전 기본 사항 페이지에서 서버리스를 용량 모드로 선택하는 경우 다음 옵션을 사용할 수 없습니다.
- 지리적 중복
- 다중 지역 쓰기
필요에 따라 다음 탭에서 자세한 내용을 구성할 수 있습니다.
- 네트워킹: 가상 네트워크에서 액세스를 구성합니다.
- 백업 정책: 정기 또는 연속 백업 정책을 구성합니다.
- 암호화: 서비스 관리형 키 또는 고객 관리형 키를 사용합니다.
- 태그: 태그는 여러 리소스 및 리소스 그룹에 동일한 태그를 적용하여 리소스를 분류하고 통합 청구를 볼 수 있는 이름/값 쌍입니다.
검토 + 만들기를 선택합니다.
계정 설정을 검토한 다음, 만들기를 선택합니다. 계정을 만드는 데 몇 분이 걸립니다. 포털 페이지에 배포가 완료됨이 표시되기를 기다립니다.
리소스로 이동을 선택하여 Azure Cosmos DB 계정 페이지로 이동합니다.
데이터베이스 계정에서 Azure 지역 추가/제거
팁
새 지역이 추가되면 해당 지역이 사용 가능으로 표시되기 전에 모든 데이터를 완전히 복제하고 새 지역에 커밋해야 합니다. 이 작업에 걸리는 시간은 계정에 저장된 데이터의 양에 따라 다릅니다. 비동기 처리량 스케일링 작업이 진행 중인 경우 처리량 스케일 업 작업이 일시 중지되고 지역 추가/제거 작업이 완료되면 자동으로 다시 시작됩니다.
Azure 포털에 로그인합니다.
Azure Cosmos DB 계정으로 이동하고, 리소스 메뉴에서 전역으로 데이터 복제를 선택합니다.
지역을 추가하려면 원하는 지역에 해당하는 레이블이 있는 맵에서 + 육각형을 선택합니다. 또는, 지역을 추가하려면 + 지역 추가 옵션을 선택하고 드롭다운 메뉴에서 Azure 지역을 선택합니다.
지역을 제거하려면 확인 표시가 있는 파란색 육각형을 선택하여 맵에서 하나 이상의 지역을 지웁니다. 오른쪽 영역 옆에 있는 휴지방 (🗑) 아이콘을 선택할 수도 있습니다.
변경 내용을 저장하려면 확인을 선택합니다.
단일 지역 쓰기 모드에서는 쓰기 지역을 제거할 수 없습니다. 현재 쓰기 지역을 삭제하려면 먼저 다른 Azure 지역으로 장애 조치해야 합니다.
다중 지역 쓰기 모드에서는 하나 이상의 Azure 지역이 있으면 Azure 지역을 추가하거나 제거할 수 있습니다.
다중 쓰기 지역 구성
전역으로 데이터 복제 탭을 열고 사용을 선택하여 다중 지역 쓰기를 사용하도록 설정합니다. 다중 지역 쓰기를 사용하도록 설정한 후에는 현재 계정에 있는 모든 읽기 지역이 읽기 및 쓰기 지역이 됩니다.
Azure Cosmos DB 계정에 대해 서비스 관리 장애 조치(failover) 사용
서비스 관리 장애 조치(failover) 옵션을 사용하면 Azure Cosmos DB가 지역을 사용할 수 없게 될 경우 사용자 작업 없이 장애 조치 우선 순위가 가장 높은 지역으로 장애 조치(failover)할 수 있습니다. 서비스 관리 장애 조치(failover)가 사용하도록 설정되면 지역 우선 순위를 수정할 수 있습니다. 서비스 관리형 장애 조치(failover)를 사용하도록 설정하려면 계정에 두 개 이상의 지역이 있어야 합니다.
Azure Cosmos DB 계정에서 글로벌로 데이터 복제 창을 엽니다.
창의 위쪽에서 서비스 관리형 장애 조치(failover)를 선택합니다.
서비스 관리형 장애 조치(failover) 창에서 서비스 관리형 장애 조치(failover) 사용이 켜기로 설정되었는지 확인합니다.
저장을 선택합니다.
Azure Cosmos DB 계정에 대한 강제 장애 조치(failover) 수행
강제 장애 조치(Failover)(오프라인 지역)를 사용하면 사용자가 Cosmos DB 계정의 성능 저하, 부분 중단 또는 지역 중단을 신속하게 해결할 수 있습니다. 서비스 관리 장애 조치(failover)는 서비스의 확인에 따라 달라지며 중단 진행 상황에 따라 활성화하는 데 시간이 걸릴 수 있습니다. 강제 장애 조치(failover)를 사용하면 관리자가 서비스 관리 장애 조치(failover)를 기다리지 않고 영향을 받는 지역의 가용성을 신속하게 복원할 수 있습니다.
Azure Cosmos DB 계정에서 글로벌로 데이터 복제 창을 엽니다.
창 맨 위에서 오프라인 지역을 선택합니다.
장애 조치(failover) 우선 순위에 따라 새 쓰기 지역으로 승격될 지역에서 복제되지 않은 쓰기를 사용할 수 없기 때문에 데이터가 손실될 가능성을 나타내는 경고 메시지를 검토합니다.
오프라인으로 표시할 지역을 선택하고, 현재 선택한 지역을 이해하고 오프라인으로 동의하는 확인란을 선택하고, 오프라인 지역 단추를 클릭합니다.
완료되면 장애 조치 우선 순위가 가장 높은 지역이 새 쓰기 지역으로 승격되고 원래 쓰기 지역은 오프라인으로 표시됩니다.
Azure Cosmos DB 서비스 팀은 지역을 온라인으로 다시 가져오는 것을 처리합니다. 중단 시 지역이 오프라인 상태인 경우 영향의 심각도에 따라 온라인으로 복원하는 데 3일 이상이 걸릴 수 있습니다. 지역이 오프라인으로 전환되는 재해 복구 훈련의 경우 지원 티켓 요청을 만들어 지역을 다시 온라인 상태로 만듭니다.
단일 쓰기 영역의 경우 드릴 또는 중단 중에 쓰기 지역이 오프라인 상태이면 지역을 다시 온라인 상태로 전환하면 '읽기 지역'으로 복원됩니다. 그 후 '쓰기 지역 변경' 작업을 수행하여 지역을 쓰기 지역으로 다시 승격할 수 있습니다.
Azure Cosmos DB는 이러한 메트릭을 기반으로 자동화를 만들려는 사용자를 위해 지역 오프라인 및 지역 온라인 메트릭을 제공합니다. 예를 들어 지역이 다시 온라인 상태가 된 후 변경-쓰기 지역으로 자동화 작업을 트리거할 수 있습니다. 지원되는 데이터베이스 계정 메트릭 목록은 여기에서 찾을 수 있습니다.
Azure Cosmos DB 계정에 대한 장애 조치 우선 순위 설정
서비스 관리형 장애 조치를 사용하도록 Azure Cosmos DB 계정을 구성한 후 지역의 장애 조치 우선 순위를 변경할 수 있습니다.
중요합니다
서비스 관리형 장애 조치를 사용하도록 계정을 구성하면 쓰기 지역(장애 조치 우선 순위 = 0)을 수정할 수 없습니다. 쓰기 영역을 변경하려면 서비스 관리 장애 조치(failover)를 사용하지 않도록 설정하고 수동 장애 조치(failover)를 수행해야 합니다.
Azure Cosmos DB 계정에서 글로벌로 데이터 복제 창을 엽니다.
창의 위쪽에서 서비스 관리형 장애 조치(failover)를 선택합니다.
서비스 관리형 장애 조치(failover) 창에서 서비스 관리형 장애 조치(failover) 사용이 켜기로 설정되었는지 확인합니다.
장애 조치 우선 순위를 수정하려면 마우스로 가리킬 때 나타나는 행 왼쪽의 점 세 개를 통해 읽기 지역을 끕니다.
저장을 선택합니다.
Azure Cosmos DB 계정에 대한 쓰기 지역 변경
중요합니다
Azure Cosmos DB 계정은 변경-쓰기 지역 작업을 위해 여러 지역으로 구성해야 합니다.
참고 항목
비동기 처리량 크기 조정 작업이 진행 중인 동안 수동 변경-쓰기 지역 작업을 수행하면 처리량 확장 작업이 일시 중지됩니다. 장애 조치 작업이 완료되면 자동으로 다시 시작됩니다. 자세한 내용은 프로비저닝된 처리량(RU/s) 스케일링 모범 사례를 참조하세요.
경고
쓰기 지역 중단이 발생할 경우 변경-쓰기 지역을 사용하지 마세요. 중단 시나리오의 경우 강제 장애 조치(failover) 섹션을 참조하세요.
Azure Cosmos DB 계정으로 이동하고 전역으로 데이터 복제 메뉴를 엽니다.
메뉴 맨 위에서 쓰기 영역 변경을 선택합니다.
쓰기 영역 변경 패널은 가동 중단 시나리오 중에 이 작업이 실행되지 않도록 하는 세부 정보를 제공합니다. 지역 가동 중단 중에 이 작업이 수행되지 않음을 선택하고 인정합니다.
새 쓰기 지역을 선택하고 확인란을 선택하여 작업 확인을 승인합니다. 확인을 클릭하여 작업을 수행합니다.