Cosmos DB 인스턴스 만들기

5분

이 단원에서는 Azure Cosmos DB와 데이터 구성 방법을 알아봅니다. Visual Studio Code를 사용하여 Cosmos DB 데이터베이스와 컨테이너를 만들고 유지 관리하는 방법을 알아봅니다.

Azure Cosmos DB란 무엇인가요?

Azure Cosmos DB는 문서 데이터베이스를 구현하는 클라우드 서비스입니다. 문서의 데이터는 JSON 구문을 따라야 합니다. JSON 문서에는 속성, 하위 문서 및 문서 배열이 포함될 수 있습니다.

{
    "id": "08225A9E-F2B3-4FA3-AB08-8C70ADD6C3C2",
    "partitionKey": "Bikes",
    "name": "Touring-1000 Blue, 50",
    "description": "The product called \"Touring-1000 Blue, 50\"",
    "price": 2384.0700000000002,
    "inventory": [
        { "location": "Dallas", "inventory": 96 },
        { "location": "Seattle", "inventory": 85 }
      ]
}

관계형 데이터베이스의 테이블과 달리 Azure Cosmos DB의 문서는 미리 정의된 스키마를 따르지 않습니다. 따라서 데이터베이스가 다양한 모양과 크기의 다양한 문서를 저장할 수 있습니다. 예를 들어 다양한 고객에 대한 다양한 정보를 동일한 데이터베이스에 저장할 수 있습니다. 전체 주소 기록을 고객 배열로 기록할 수도 있습니다. 신용도 같은 추가 정보를 기록할 수 있습니다.

Azure Cosmos DB 클라우드 서비스는 계층 구조로 구성됩니다. 맨 위에는 Azure Cosmos DB 계정(리소스)이 있습니다. Azure Cosmos DB 계정은 데이터베이스 세트의 보안 단위입니다. Azure Cosmos DB 계정은 해당 데이터베이스에 액세스하는 데 필요한 보안 정보와 함께 데이터베이스의 위치를 지정합니다. 계정 내에서 하나 이상의 데이터베이스를 만듭니다. 각 데이터베이스 내에 하나 이상의 컨테이너를 만듭니다. 컨테이너에 문서를 저장합니다.

Conceptual image of parent-child relationship of account, database, and container in Cosmos D B.

Cosmos DB 컨테이너 및 파티션 키

각 컨테이너는 일련의 파티션으로 구성됩니다. 파티션은 ‘대략’ 디스크의 물리적 파일에 해당합니다. 큰 파티션은 파일을 포함하지만, 작은 파티션 여러 개는 단일 파일로 결합될 수 있습니다. 각 문서에는 문서가 속한 파티션을 정의하는 파티션 키가 있습니다. 분할을 사용하여 관련 문서를 함께 저장하며 데이터에 액세스하는 방법을 최적화할 수 있습니다.

다음 예제에서는 Contoso 애플리케이션의 일부로 제품 정보를 저장하는 JSON 문서를 보여 줍니다. 이 데이터는 다른 시스템에서 제공되므로 ID는 GUID로 이미 구성되어 있습니다. 사용자 고유의 컨테이너에서 ID를 가져오거나 Cosmos DB가 ID를 제공하도록 허용할 수 있습니다. 새 문서를 삽입할 때 ID와 파티션 키를 제공해야 합니다(파티션 키를 사용하는 경우).

{
    "id": "08225A9E-F2B3-4FA3-AB08-8C70ADD6C3C2",
    "categoryName": "Bikes, Touring Bikes",
    "sku": "BK-T79U-50",
    "name": "Touring-1000 Blue, 50",
    "description": "The product called \"Touring-1000 Blue, 50\"",
    "price": 2384.0700000000002,
    "tags": [
        {
            "_id": "27B7F8D5-1009-45B8-88F5-41008A0F0393",
            "name": "Tag-61"
        }
    ],
    "inventory": [
        { "location": "Dallas", "inventory": 96 },
        { "location": "Seattle", "inventory": 85 },
        { "location": "Boston", "inventory": 4 },
        { "location": "Miami", "inventory": 12 },
        { "location": "San Diego", "inventory": 58 }
      ]
}

Contoso 회사는 범주 이름 categoryName을 파티션 키로 사용하기로 결정했습니다. 이렇게 하면 컨테이너 전체에서 문서를 어느 정도 고르게 배포할 수 있기 때문입니다. 파티션 키 필드는 컨테이너를 만들 때 컨테이너에 대해 설정됩니다. 컨테이너에 삽입된 각 새 문서에 대해 파티션 키가 JSON 문서의 일부로 포함됩니다. 위의 예제에서 올바르게 구성된 문서에 대한 최소 요구 사항은 고유 ID과 파티션 키로 id 및 categoryName입니다. 다른 특정 시스템에서 데이터 세트를 가져와서 여러 다른 시스템에 연결하기 위해 고유 ID를 유지하려는 경우 id 필드를 사용하거나 Cosmos DB가 새 고유 id를 만들도록 허용하고 ID를 별도의 속성 이름에 저장할 수 있습니다.

참고

Azure Cosmos DB는 고유한 일부 필드를 문서에 추가합니다. 이 필드 중 많은 필드가 내부용으로 사용되며 대부분의 경우 직접 수정하면 안 됩니다. 예외는 id라는 필드입니다. Azure Cosmos DB는 이 필드를 사용하여 데이터베이스에서 문서를 식별하며 각 문서에는 고유한 id가 있어야 합니다.

Azure Cosmos DB 처리량 비용

Azure Cosmos DB는 RU/s(초당 요청 단위) 개념을 사용하여 데이터베이스의 성능과 비용을 관리합니다. 이 측정값은 필요한 성능을 지원하기 위해 프로비저닝해야 하는 기본 물리적 리소스를 추상화합니다. 데이터베이스 또는 컨테이너를 만들 때 할당할 RU/초 수를 지정합니다. 이 설정에 따라 요금이 부과됩니다.

1 KB 항목에 대한 지점 읽기(ID 및 파티션 키 값을 기준으로 단일 항목을 페치)의 비용은 1 요청 단위(또는 1 RU)입니다. RU를 사용하여 다른 모든 데이터베이스 작업에 비슷하게 비용이 할당됩니다. Azure Cosmos DB 컨테이너 조작에 사용하는 API에 상관없이 비용은 항상 RU로 측정됩니다. 데이터베이스 작업이 쓰기, 지점 읽기 또는 쿼리든 간에 비용은 항상 RU로 측정됩니다.

400RU/초를 프로비전하고 비용이 40RU인 쿼리를 실행하는 경우 이러한 쿼리를 초당 10개 실행할 수 있습니다. 이를 초과하는 요청은 속도가 제한되며 요청을 다시 시도해야 합니다. 클라이언트 드라이버를 사용하는 경우 자동 다시 시도 논리를 지원합니다.

RU/s를 가능한 한 낮게 유지하려면 다음을 고려합니다.

Object	고려 사항
문서 크기	문서가 크면(KB 단위) RU가 증가합니다.
문서 인덱싱	성능이 좋은 인덱싱은 RU를 줄일 수 있습니다.
문서 속성 수	모든 속성을 인덱싱하는 경우 더 많은 속성을 사용하면 RU가 증가합니다. 키 속성을 선택적으로 인덱싱하려면 RU가 더 적게 필요합니다.
데이터 일관성	강력하고 제한된 일관성 수준은 다른 완화된 일관성 수준보다 더 많은 RU를 사용합니다.
문서 읽기 유형	항목의 ID와 파티션 키를 사용하는 포인트 읽기는 쿼리보다 RU 비용이 훨씬 적습니다.
쿼리 패턴	쿼리의 복잡성은 사용되는 RU 수에 영향을 줍니다.
스크립트 사용자	저장 프로시저, 트리거 및 사용자 정의 함수는 이러한 스크립트 내의 쿼리 외에도 RU를 사용합니다.

Cosmos DB에 액세스

Azure Cosmos DB에는 Cosmos DB에 연결하는 다음 방법이 포함되어 있습니다.

Visual Studio Code
JavaScript(및 기타 언어) SDK
Azure portal
Azure CLI
PowerShell
REST API

Azure Cosmos DB API

Azure Cosmos DB는 여러 가지 프로그래밍 API를 지원합니다. 이 API는 다른 일반적인 NoSQL 데이터베이스에서 사용하는 API에 최대한 맞춰집니다. 이렇게 하는 목적은 개발자가 완전히 새로운 패러다임을 배우거나 애플리케이션을 크게 변경하지 않고도 이 데이터베이스에서 Azure Cosmos DB로 쉽게 마이그레이션할 수 있는 경로를 제공하는 것입니다. 현재 지원되는 API는 다음과 같습니다.

Core(SQL)
MongoDB
Cassandra
Gremlin(일반 그래프 DB API)
Azure Table Storage

Core(SQL) API는 대부분의 관계형 데이터베이스 관리 시스템에서 사용하는 SQL 언어의 변형입니다. 테이블이 아닌 스키마 없는 문서 세트를 처리하기 위한 제한 및 조정이 있습니다.

Visual Studio Code를 사용하여 Azure Cosmos DB 관리

개발 환경으로 Visual Studio Code를 사용하는 경우 Azure Cosmos DB 데이터베이스 및 애플리케이션을 빌드하기 위해 Azure Databases 확장을 설치할 수 있습니다.

Screenshot of the Azure Databases extension in Visual Studio Code marketplace

Visual Studio Code용 Extensions Marketplace에서 확장을 설치합니다. Databases 확장을 설치한 후에는 Azure Explorer, Shift + Alt + A를 사용하여 Cosmos DB 확장을 사용합니다.

Azure Explorer에서 Cosmos DB 관리

Visual Studio Code의 Azure Explorer에서 Databases 확장은 Visual Studio Code와 통합된 그래픽 사용자 인터페이스를 제공합니다. 확장을 사용하여 Azure Cosmos DB 계정, 데이터베이스, 컨테이너 및 문서를 만들고, 삭제하고, 관리할 수 있습니다.

Screenshot of the Azure Databases extension in Visual Studio Code as user right-clicks on the Documents node for a contextual menu to create a new document.

포털에서 계정 액세스

또한 확장은 Azure Portal에서 계정을 여는 기능을 제공하여 Cosmos DB의 모든 기능에 쉽게 액세스할 수 있도록 합니다. 계정을 마우스 오른쪽 단추로 클릭하고 포털에서 열기를 선택하면 액세스할 수 있습니다.

Screenshot of the Azure Databases extension in Visual Studio Code as user right-clicks on the account node to open account in Azure portal.

포털은 Cosmos DB에 대한 모든 구성과 데이터베이스 및 컨테이너로 이동할 수 있는 Data Explorer에 대한 액세스를 제공합니다. Data Explorer 사용하여 데이터를 삽입, 업데이트, 삭제 및 쿼리합니다.

Screenshot of the Azure portal with the Data Explorer showing the query window open with a JSON document displayed.

계속