데이터베이스 만들기

  • 아티클

이 Create Database 작업은 데이터베이스 계정에 새 데이터베이스를 만듭니다.

참고

이러한 API 참조 문서에서는 Azure Cosmos DB 데이터 평면 API를 사용하여 리소스를 만드는 방법을 보여 줍니다. 데이터 평면 API를 사용하면 Cosmos DB SDK와 마찬가지로 인덱싱 정책, 파티션 키와 같은 기본 옵션을 구성할 수 있습니다. 모든 Azure Cosmos DB 리소스에 대한 완전한 기능 지원이 필요한 경우 Cosmos DB 리소스 공급자를 사용하는 것이 좋습니다.

요청

메서드 요청 URI 설명
POST https://{databaseaccount}.documents.azure.com/dbs {databaseaccount}는 구독에서 만든 Azure Cosmos DB 계정의 이름입니다.

헤더

모든 Azure Cosmos DB 요청 에서 사용되는 헤더는 일반적인 Azure Cosmos DB REST 요청 헤더를 참조하세요.

속성 필수 형식 설명
x-ms-offer-throughput 선택 사항 숫자 사용자가 초당 100개 요청 단위 단위로 표현된 데이터베이스에 대한 수동 처리량(RU/s)을 지정했습니다. 최소값은 최대 400에서 1,000,000까지입니다(한도 증가를 요청하여 이상).

또는 x-ms-cosmos-offer-autopilot-settings 중 x-ms-offer-throughput 하나만 지정해야 합니다. 이러한 헤더는 함께 지정할 수 없습니다.
x-ms-cosmos-offer-autopilot-settings 선택 사항 JSON 사용자가 데이터베이스의 최대 RU/s 자동 크기 조정을 지정했습니다. 값은 속성 maxThroughput이 인 JSON입니다. 예: {"maxThroughput": 4000}

또는 x-ms-cosmos-offer-autopilot-settings 중 x-ms-offer-throughput 하나만 지정해야 합니다. 이러한 헤더는 함께 지정할 수 없습니다.

참고

데이터베이스에서 처리량을 설정하는 경우 이 데이터베이스 내의 모든 컬렉션이 프로비전된 처리량을 공유하는 공유 처리량 데이터베이스 를 만듭니다. 공유 처리량 데이터베이스에는 25개의 컨테이너 제한이 있습니다. 공유 처리량 데이터베이스를 사용하지 않으려는 경우 위의 처리량 헤더를 설정하지 않고 데이터베이스를 만듭니다. 자세한 정보를 알아보세요.

본문

속성 필수 형식 Description
id 필수 문자열 사용자가 생성한 데이터베이스의 고유 이름입니다. 255자를 초과하면 안 되는 문자열입니다. 
{  
  "id": "volcanodb2"  
}

응답

헤더

모든 Azure Cosmos DB 응답 에서 반환되는 헤더는 일반적인 Azure Cosmos DB REST 응답 헤더를 참조하세요.

상태 코드

다음 표에는 이 작업에서 반환하는 일반적인 상태 코드가 나열되어 있습니다. 상태 코드의 전체 목록은 HTTP 상태 코드를 참조하세요.

HTTP 상태 코드 설명
201 생성됨 작업이 정상적으로 수행되면 반환됩니다.
400 잘못된 요청 JSON 본문이 잘못된 경우 반환됩니다. 누락된 중괄호나 따옴표를 확인하세요.
409 충돌 새 데이터베이스에 대해 제공된 ID가 기존 데이터베이스에서 가져온 경우 반환됩니다.

본문

속성 Description
id 사용자가 생성한 데이터베이스의 고유 이름입니다.
_rid 시스템 생성 속성입니다. 리소스 ID(_rid)는 리소스 모델의 리소스 스택당 계층적인 고유 식별자입니다. 데이터베이스 리소스의 배치와 탐색용으로 내부에서 사용됩니다.
_ts 시스템 생성 속성입니다. 리소스가 마지막으로 업데이트된 시간의 타임스탬프를 지정합니다. 값은 타임스탬프입니다.
_self 시스템 생성 속성입니다. 고유한 주소를 지정할 수 있는 리소스의 URI입니다.
_etag 낙관적 동시성 제어에 필요한 리소스 etag 를 지정하는 시스템 생성 속성입니다.
_colls 컬렉션 리소스의 주소 지정 가능 경로를 지정하는 시스템 생성 속성입니다.
_사용자 사용자 리소스의 주소 지정 가능 경로를 지정하는 시스템 생성 속성입니다. 
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

예 1

다음 예제에서는 데이터베이스를 만듭니다.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms.date: 04/20/2021
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}  
  

HTTP/1.1 201 Created  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Sun, 29 Nov 2015 02:25:35.212 GMT  
etag: "00000a00-0000-0000-0000-56672f920000"  
x-ms-resource-quota: databases=100;  
x-ms-resource-usage: databases=15;  
x-ms-schemaversion: 1.1  
x-ms-quorum-acked-lsn: 859  
x-ms-session-token: 860  
x-ms-current-write-quorum: 3  
x-ms-current-replica-set-size: 4  
x-ms-request-charge: 4.95  
x-ms-serviceversion: version=1.5.57.3  
x-ms-activity-id: f171e571-994e-4dc2-b443-7c3d5fa4a293  
x-ms-gatewayversion: version=1.5.57.3  
Date: Tue, 08 Dec 2015 19:29:21 GMT  
Content-Length: 169  
  
{  
    "id": "volcanodb2",  
    "_rid": "CqNBAA==",  
    "_ts": 1449602962,  
    "_self": "dbs\/CqNBAA==\/",  
    "_etag": "\"00000a00-0000-0000-0000-56672f920000\"",  
    "_colls": "colls\/",  
    "_users": "users\/"  
}

예제 2

다음 예제에서는 수동 처리량이 400RU/s인 공유 처리량 데이터베이스 를 만듭니다. x-ms-offer-throughput 헤더는 처리량(RU/s) 값을 설정하는 데 사용됩니다. 100 단위씩 증가하는 최소 400의 숫자를 허용합니다.

POST https://contosomarketing.documents.azure.com/dbs HTTP/1.1  
x-ms-date: Tue, 08 Dec 2015 19:29:22 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d  
Cache-Control: no-cache  
User-Agent: contoso/1.0  
x-ms-version: 2015-08-06  
Accept: application/json  
x-ms-offer-throughput = 400
Host: contosomarketing.documents.azure.com  
Content-Length: 19  
Expect: 100-continue  
  
{"id":"volcanodb2"}

예제 3

다음 예제에서는 자동 크기 조정 최대 처리량이 4000RU/s(400~4000RU/s 사이)인 공유 처리량 데이터베이스를 만듭니다. x-ms-cosmos-offer-autopilot-settings 헤더는 자동 크기 조정 최대 RU/s 값인 를 설정하는 maxThroughput데 사용됩니다. 1000 단위씩 증가하는 최소 4000의 숫자를 허용합니다.

참고

기존 데이터베이스 또는 컨테이너에서 자동 크기 조정을 사용하도록 설정하거나 자동 크기 조정에서 수동 처리량으로 전환하려면 제품 바꾸기 문서를 참조하세요.

POST https://contosomarketing.documents.azure.com:443/dbs HTTP/1.1 
x-ms-version: 2018-12-31
x-ms-date: Wed, 22 Jul 2020 20:09:50 GMT
authorization: type%3dmaster%26ver%3d1.0%26sig%3dsc0%2fu25RB8wSqbY1%2bUZqTGD0yCQC5KkGOAP%2bgnHFceQ%3d 
Accept: application/json
x-ms-cosmos-offer-autopilot-settings: {"maxThroughput": 4000}
Content-Type: application/json
User-Agent: contoso/1.0
Postman-Token: 81c0a4ac-4b7c-4f98-8d46-8c662969bc7e
Host: contosomarketing.documents.azure.com:443
Accept-Encoding: gzip, deflate, br
Connection: keep-alive
Content-Length: 27

{"id":"volcanodb3"}

참고 항목