빠른 시작: Azure Portal에서 Azure Cosmos 계정, 데이터베이스, 컨테이너 및 항목 만들기

적용 대상: SQL API

Azure Cosmos DB는 전 세계에 배포된 Microsoft의 다중 모델 데이터베이스 서비스입니다. Azure Cosmos DB를 사용하여 Azure Cosmos DB의 핵심인 글로벌 배포 및 수평적 크기 조정 기능의 이점을 활용하는 키/값 데이터베이스, 문서 데이터베이스 및 그래프 데이터베이스를 빠르게 만들고 쿼리할 수 있습니다.

이 빠른 시작에서는 Azure Portal을 사용하여 Azure Cosmos DB SQL API 계정, 문서 데이터베이스 및 컨테이너를 만들고 컨테이너에 데이터를 추가하는 방법을 보여줍니다.

필수 구성 요소

Azure 구독 또는 Azure Cosmos DB 체험 계정

Azure Cosmos DB 계정 만들기

  1. Azure Portal 메뉴 또는 페이지에서 리소스 만들기 를 선택합니다.

  2. 새로 만들기 페이지에서 Azure Cosmos DB 를 검색하여 선택합니다.

  3. Azure Cosmos DB 페이지에서 만들기 를 선택합니다.

  4. Azure Cosmos DB 계정 만들기 페이지에서 새 Azure Cosmos 계정에 대한 기본 설정을 입력합니다.

    설정 Description
    Subscription 구독 이름 이 Azure Cosmos 계정에 사용하려는 Azure 구독을 선택합니다.
    리소스 그룹 리소스 그룹 이름 리소스 그룹을 선택하거나 새로 만들기 를 선택한 후, 새 리소스 그룹에 고유한 이름을 입력합니다.
    계정 이름 고유한 이름 Azure Cosmos 계정을 식별하는 이름을 입력합니다. URI를 만들기 위해 제공하는 이름에 documents.azure.com 이 추가되므로 고유한 이름을 사용합니다.

    이름은 소문자, 숫자 및 하이픈(-) 문자만 포함할 수 있으며, 길이는 3~44자여야 합니다.
    API 만들 계정 형식 Core(SQL) 를 선택하여 문서 데이터베이스를 만들고 SQL 구문을 사용하여 쿼리합니다.

    API는 만들 계정의 형식을 결정합니다. Azure Cosmos DB는 문서 데이터용 Core(SQL) 및 MongoDB, 그래프 데이터용 Gremlin, Azure Table 및 Cassandra, 이렇게 5가지 API를 제공합니다. 현재 각 API에 대한 별도의 계정을 만들어야 합니다.

    SQL API에 대한 자세한 정보
    위치 사용자와 가장 가까운 지역 Azure Cosmos DB 계정을 호스트할 지리적 위치를 선택합니다. 데이터에 가장 빨리 액세스할 수 있도록 사용자와 가장 가까운 위치를 사용합니다.
    용량 모드 프로비저닝된 처리량 또는 서버리스 프로비저닝된 처리량 을 선택하여 프로비저닝된 처리량 모드에서 계정을 만듭니다. 서버리스 를 선택하여 서버리스 모드에서 계정을 만듭니다.
    Azure Cosmos DB 체험 계층 할인 적용 적용 또는 적용 안 함 Azure Cosmos DB 체험 계층을 사용하는 경우 처음에는 1000RU/초 및 25GB의 스토리지가 계정에 무료로 제공됩니다. 체험 계층에 대해 자세히 알아보세요.

    참고

    Azure 구독당 최대 1개의 체험 계층 Azure Cosmos DB 계정을 사용할 수 있으며 계정을 만들 때 옵트인해야 합니다. 체험 계층 할인을 적용하는 옵션이 표시되지 않으면 구독의 다른 계정에서 이미 체험 계층을 사용하도록 설정되었음을 의미합니다.

    Azure Cosmos DB에 대한 새 계정 페이지

  5. 전역 배포 탭에서 다음 세부 정보를 구성합니다. 이 빠른 시작의 목적을 위해 기본값을 그대로 둘 수 있습니다.

    설정 Description
    지리적 중복 사용 안 함 지역에 쌍 영역을 페어링하여 계정에서 글로벌 배포를 사용하거나 사용하지 않도록 설정합니다. 나중에 계정에 더 많은 지역을 추가할 수 있습니다.
    다중 지역 쓰기 사용 안 함 다중 영역 쓰기 기능을 사용하면 전 세계의 데이터베이스 및 컨테이너에 대해 프로비저닝된 처리량을 활용할 수 있습니다.

    참고

    용량 모드서버리스 를 선택한 경우 다음 옵션을 사용할 수 없습니다.

    • 체험 계층 할인 적용
    • 지리적 중복
    • 다중 지역 쓰기
  6. 필요에 따라 다음 탭에서 추가 세부 정보를 구성할 수 있습니다.

    • 네트워킹 - 가상 네트워크에서 액세스를 구성합니다.
    • 백업 정책 - 주기적 또는 지속적인 백업 정책을 구성합니다.
    • 암호화 - 서비스 관리형 키 또는 고객 관리형 키를 사용합니다.
    • 태그 - 태그는 동일한 태그를 여러 개의 리소스 및 리소스 그룹에 적용하여 리소스를 범주화하고 통합된 청구를 볼 수 있는 이름/값 쌍입니다.
  7. 검토 + 만들기 를 선택합니다.

  8. 계정 설정을 검토한 다음, 만들기 를 선택합니다. 계정을 만드는 데 몇 분이 걸립니다. 포털 페이지에 배포가 완료됨 이 표시되기를 기다립니다.

    Azure Portal 알림 창

  9. 리소스로 이동 을 선택하여 Azure Cosmos DB 계정 페이지로 이동합니다.

    Azure Cosmos DB 계정 페이지

데이터베이스 및 컨테이너 추가

Azure Portal에서 데이터 탐색기를 사용하여 데이터베이스와 컨테이너를 만들 수 있습니다.

  1. Azure Cosmos DB 계정 페이지의 왼쪽 탐색 모음에서 Data Explorer 를 선택한 다음, 새 컬렉션 을 선택합니다.

    컨테이너 추가 창을 보려면 오른쪽으로 스크롤해야 할 수도 있습니다.

    Azure Portal Data Explorer, 컨테이너 추가 창

  2. 컨테이너 추가 창에서 새 컨테이너의 설정을 입력합니다.

    설정 제안 값 설명
    데이터베이스 ID ToDoList 새 데이터베이스의 이름으로 ToDoList 를 입력합니다. 데이터베이스 이름은 1~255자여야 하며, /, \\, #, ? 또는 후행 공백은 포함할 수 없습니다. 컨테이너 간에 처리량 공유 옵션을 선택합니다. 그러면 데이터베이스에 프로비저닝된 처리량을 데이터베이스 내 모든 컨테이너가 공유할 수 있습니다. 이 옵션은 비용 절감에도 도움이 됩니다.
    데이터베이스 처리량 자동 스케일링 또는 수동 처리량을 프로비저닝할 수 있습니다. 수동 처리량을 사용하면 RU/s를 직접 스케일링할 수 있지만 자동 스케일링을 사용하면 시스템에서 사용량에 따라 RU/s를 스케일링할 수 있습니다. 이 예제에서는 수동 을 선택합니다.

    처리량을 400 RU/s(초당 요청 단위)로 유지합니다. 대기 시간을 줄이려면 용량 계산기를 사용하여 필요한 RU/s를 예측하여 나중에 처리량을 스케일 업할 수 있습니다.

    참고: 서버리스 계정에서 새 컨테이너를 만들 때는 이 설정을 사용할 수 없습니다.
    컨테이너 ID Items 새 컨테이너의 이름으로 Items 를 입력합니다. 컨테이너 ID에는 데이터베이스 이름과 동일한 문자 요구 사항이 적용됩니다.
    파티션 키 /category 이 문서에 설명된 샘플은 파티션 키로 /category 를 사용합니다.

    이 예제에서는 고유 키 를 추가하거나 분석 저장소 를 설정하지 마세요. 고유 키를 사용하면 분할 키당 하나 이상의 값의 고유성을 보장하여 데이터베이스에 데이터 무결성 레이어를 추가할 수 있습니다. 자세한 내용은 Azure Cosmos DB의 고유 키를 참조하세요. 분석 저장소는 트랜잭션 워크로드에 영향을 주지 않으면서 운영 데이터에 대한 대규모 분석을 사용하도록 설정하는 데 사용됩니다.

  3. 확인 을 선택합니다. Data Explorer가 새 데이터베이스와 앞에서 만든 컨테이너를 표시합니다.

데이터베이스에 데이터 추가

데이터 탐색기를 사용하여 새 데이터베이스에 데이터를 추가합니다.

  1. Data Explorer 에서 ToDoList 데이터베이스를 확장하고 Items 컨테이너를 확장합니다. 다음으로, 항목 을 선택한 다음, 새 항목 을 선택합니다.

    Azure Portal의 Data Explorer에서 새 문서 만들기

  2. 다음 구조를 문서 창 오른쪽의 문서에 추가합니다.

    {
        "id": "1",
        "category": "personal",
        "name": "groceries",
        "description": "Pick up apples and strawberries.",
        "isComplete": false
    }
    
  3. 저장 을 선택합니다.

    Azure Portal의 Data Explorer에서 Json 데이터를 복사하고 저장을 선택합니다.

  4. 새 문서 를 다시 선택하고 고유한 id의 다른 문서를 만들고 저장한 다음, 원하는 다른 속성 및 값을 지정합니다. Azure Cosmos DB가 데이터에 어떠한 스키마도 적용하지 않으므로 해당 문서는 사용자가 원하는 어떠한 구조든 가질 수 있습니다.

데이터 쿼리

데이터 탐색기에서 쿼리를 사용하여 데이터를 검색하고 필터링할 수 있습니다.

  1. 데이터 탐색기의 항목 탭 위쪽에서 기본 SELECT * FROM c 쿼리를 검토합니다. 이 쿼리는 ID로 정렬된 컨테이너에서 모든 문서를 검색하고 표시됩니다.

    데이터 탐색기의 기본 쿼리는 SELECT * FROM c입니다.

  2. 쿼리를 변경하려면 필터 편집 을 선택하고 기본 쿼리를 ORDER BY c._ts DESC로 변경한 다음, 필터 적용 을 선택합니다.

    ORDER BY c._ts DESC를 추가하고 필터 적용을 클릭하여 기본 쿼리 변경

    수정된 쿼리는 해당 타임스탬프에 따라 내림차순으로 문서를 표시합니다. 따라서 이제 두 번째 문서가 첫 번째로 나열됩니다.

    쿼리를 ORDER BY c._ts DESC로 변경하고 필터 적용을 클릭

SQL 구문에 익숙한 경우 쿼리 조건자 상자에 지원되는 SQL 쿼리를 입력할 수 있습니다. 데이터 탐색기를 사용하여 서버 쪽 비즈니스 논리에 대한 저장 프로시저, UDF 및 트리거를 만들 수도 있습니다.

데이터 탐색기를 사용하면 API에 제공되는 모든 내장 프로그래밍 방식 데이터 액세스 기능에 대해 Azure Portal에서 간편하게 액세스할 수 있습니다. 포털을 사용하여 Azure Cosmos DB 계정에 대한 처리량을 조정하고 키와 연결 문자열을 가져오고, 메트릭과 SLA를 검토할 수 있습니다.

리소스 정리

앱과 Azure Cosmos DB 계정을 모두 사용했으면 추가로 비용을 지불하지 않도록 만든 Azure 리소스를 삭제할 수 있습니다. 리소스를 삭제하려면:

  1. Azure Portal 검색 창에서 리소스 그룹 을 검색하고 선택합니다.

  2. 목록에서 이 빠른 시작에서 만든 리소스 그룹을 선택합니다.

    삭제할 리소스 그룹 선택

  3. 리소스 그룹 개요 페이지에서 리소스 그룹 삭제 를 선택합니다.

    리소스 그룹 삭제

  4. 새 창에서 삭제할 리소스 그룹의 이름을 입력한 다음, 삭제 를 선택합니다.

데이터베이스만 삭제하고 나중에 Azure Cosmos 계정을 사용하려면 다음 단계에 따라 데이터베이스를 삭제할 수 있습니다.

  • Azure Cosmos 계정으로 이동합니다.
  • 데이터 탐색기 를 열고, 마우스 오른쪽 단추로 삭제할 데이터베이스를 클릭하고, 데이터베이스 삭제 를 선택합니다.
  • 데이터베이스 ID/데이터베이스 이름을 입력하여 삭제 작업을 확인합니다.

다음 단계

이 빠른 시작에서는 Azure Cosmos DB 계정을 만들고, 데이터 탐색기를 사용하여 데이터베이스 및 컨테이너를 만드는 방법을 알아보았습니다. 이제 사용자의 Azure Cosmos DB 계정에 추가 데이터를 가져올 수 있습니다.

Azure Cosmos DB로 마이그레이션하기 위한 용량 계획을 수행하려고 하나요? 용량 계획을 위해 기존 데이터베이스 클러스터에 대한 정보를 사용할 수 있습니다.