문서
Azure Cosmos DB 는 문서, 그래프 및 키-값 데이터 모델을 지원하는 전역적으로 분산된 다중 모델 데이터베이스입니다. 이 섹션의 내용은 REST를 통해 SQL API를 사용하여 문서 리소스를 만들고, 쿼리하고, 관리하기 위한 것입니다.
문서 리소스는 Azure Cosmos DB 리소스 모델에서 로 표시됩니다 docs
. 문서는 JSON 형식의 사용자 정의 콘텐츠로 구성됩니다. 필요한 ID 속성 외에도 사용자는 콘텐츠에 대한 임의의 요소, 구조 및 계층 구조를 정의할 수 있습니다. ID 요소는 사용자 설정 가능이며 255자를 초과해서는 안 되는 고유한 문자열입니다. 컬렉션의 임의 JSON 문서를 삽입하고, 바꾸고, 삭제하고, 읽고, 열거하고, 쿼리할 수 있습니다.
Azure Cosmos DB는 컬렉션의 문서에 대한 쿼리를 지원하기 위해 스키마 또는 보조 인덱스가 필요하지 않습니다. 기본적으로 문서는 일관된 방식으로 자동으로 인덱싱되므로 문서를 만드는 즉시 쿼리할 수 있습니다.
- 문서는 컬렉션 내에 저장됩니다. 컬렉션에 대한 자세한 내용은 컬렉션을 참조하세요.
- 문서에 첨부 파일이 하나 이상 포함될 수 있습니다. 첨부 파일에 대한 자세한 내용은 첨부 파일을 참조하세요.
- 문서에 대한 사용자 액세스는 권한을 통해 관리할 수 있습니다. 권한에 대한 자세한 내용은 사용 권한을 참조하세요.
이 샘플 JSON 문서에서는 컬렉션의 화산에 대한 항목을 보여줍니다. 항목에는 화산 이름, 지리 공간 데이터를 포함한 위치 정보 및 _rid, _ts, _self, _etag 및 _attachments 같은 시스템 정의 요소가 포함됩니다.
{
"Volcano Name": "Agua de Pau",
"Country": "Portugal",
"Region": "Azores",
"Location": {
"type": "Point",
"coordinates": [
-25.47,
37.77
]
},
"Elevation": 947,
"Type": "Stratovolcano",
"Status": "Historical",
"Last Known Eruption": "Last known eruption from 1500-1699, inclusive",
"id": "d44c94b6-81f8-4b27-4970-f79b149529d3",
"_rid": "Sl8fALN4sw4BAAAAAAAAAA==",
"_ts": 1448049512,
"_self": "dbs/Sl8fAA==/colls/Sl8fALN4sw4=/docs/Sl8fALN4sw4BAAAAAAAAAA==/",
"_etag": "\"0000443f-0000-0000-0000-564f7b680000\"",
"_attachments": "attachments/"
}
속성 | Description |
---|---|
id | 필수 요소. 사용자 설정 가능 속성입니다. 문서를 식별하는 고유한 이름입니다. 즉, 논리 파티션 내에서 동일한 ID를 공유하는 두 문서가 없습니다. 파티션 및 ID는 데이터베이스의 항목을 고유하게 식별합니다. ID 필드는 255자를 초과하면 안됩니다. |
_rid | 시스템 생성 속성입니다. 리소스 ID(_rid)는 리소스 모델의 리소스 스택당 계층적인 고유 식별자입니다. 문서 리소스의 배치와 탐색을 위해 내부적으로 사용됩니다. |
_ts | 시스템 생성 속성입니다. 리소스가 마지막으로 업데이트된 시간의 타임스탬프를 지정합니다. 값은 타임스탬프입니다. |
_self | 시스템 생성 속성입니다. 고유한 주소를 지정할 수 있는 리소스의 URI입니다. |
_etag | 낙관적 동시성 제어에 필요한 리소스 etag를 지정하는 시스템 생성 속성입니다. |
_첨부 파일 | 첨부 파일 리소스의 주소 지정 가능 경로를 지정하는 시스템 생성 속성입니다. |
작업
문서를 사용하여 다음 작업을 수행할 수 있습니다.