Attachments
Azure Cosmos DB 는 문서, 그래프, cassandra 및 테이블 데이터 모델을 지원하는 전역적으로 분산된 다중 모델 데이터베이스입니다. 이 섹션의 내용은 REST를 통해 SQL API를 사용하여 첨부 파일 리소스를 관리하기 위한 것입니다.
첨부 파일은 외부 blob 또는 미디어 파일과 연관된 메타데이터 및 참조서를 포함하는 특수 문서입니다.
개발자는 다음 중에서 선택할 수 있습니다.
- Azure Cosmos DB에서 관리하는 첨부 파일 미디어/Blob 또는
- OneDrive, Dropbox 등과 같은 외부 Blob 서비스 공급자와 함께 저장합니다. 및 는 첨부 파일에 대한 참조 메타데이터를 Azure Cosmos DB에 저장합니다.
첨부 파일 리소스는 Azure Cosmos DB REST 리소스 모델의 첨부 파일로 표시됩니다. 첨부 파일 리소스에는 고정 스키마가 있습니다. 원시 미디어가 저장된 위치에 상관없이 다음 속성이 필요합니다.
다음 예제에서는 문서 첨부 파일의 JSON 구문을 보여 줍니다.
{
"id":"image13d65101-90c4-4c2a-a423-fbf221c73233",
"contentType":"image/jpg",
"media":"www.bing.com",
"_rid":"rnYYAMVFUAUBAAAAAAAAAEC+LNM=",
"_ts":1408056025,
"_self":"dbs\/rnYYAA==\/colls\/rnYYAMVFUAU=\/docs\/rnYYAMVFUAUBAAAAAAAAAA==\/attachments\/rnYYAMVFUAUBAAAAAAAAAEC+LNM=",
"_etag":"00002a00-0000-0000-0000-53ed3ad90000"
}
| 속성 | 설명 |
|---|---|
id |
필수 요소. 사용자 settable 속성입니다. 첨부 파일을 식별하는 고유한 이름입니다. 즉, 두 개의 첨부 파일이 동일한 문서에 대해 동일한 ID를 공유하지 않습니다. ID는 255자를 초과하면 안됩니다. |
contentType |
필수 요소. 사용자 settable 속성입니다. 첨부 파일의 콘텐츠 형식을 지정합니다. 첨부 파일 비트를 본문으로 제출할 때 Cosmos DB는 contentType 를 헤더에 Content-Type 설정된 형식으로 설정합니다. |
Media |
필수 요소. 첨부 파일이 있는 URL 링크 또는 파일 경로입니다. |
_rid |
시스템 생성 속성입니다. 리소스 ID(_rid)는 리소스 모델의 리소스 스택당 계층 구조인 고유 식별자입니다. 첨부 파일 리소스의 배치와 탐색용으로 내부에서 사용됩니다. |
_ts |
시스템 생성 속성입니다. 리소스가 마지막으로 업데이트된 시간의 타임스탬프를 지정합니다. 값은 타임스탬프입니다. |
_self |
시스템 생성 속성입니다. 고유한 주소를 지정할 수 있는 리소스의 URI입니다. |
_etag |
낙관적 동시성 제어에 필요한 리소스 etag를 지정하는 시스템 생성 속성입니다. |
일반적인 응답 헤더
다음 정보는 첨부 파일과 관련된 모든 응답에 공통적으로 적용됩니다.
| 헤더 | 설명 |
|---|---|
x-ms-max-media-storage-usage-mb |
Cosmos DB 첨부 파일 스토리지를 사용하여 원시 미디어를 저장하는 경우 이 헤더는 계정에 할당된 총 첨부 파일 스토리지 할당량을 표시합니다. |
x-ms-media-storage-usage-mb |
Cosmos DB 첨부 파일 스토리지를 사용하여 원시 미디어를 저장하는 경우 이 헤더는 사용된 현재 첨부 파일 스토리지를 보여 줍니다. |
작업
첨부 파일을 사용하여 다음 작업을 수행할 수 있습니다.
첨부 파일 콘텐츠는 인덱싱되거나 검색할 수 없습니다. 첨부 파일 리소스 속성은 인덱싱되고 검색할 수 있습니다.
이러한 작업은 문서의 작업과 유사 합니다. 문서에 대해 작업을 수행하는 대신 특정 문서의 첨부 파일 리소스 경로에 대해 수행됩니다. 따라서 각 작업에 대한 자세한 설명은 건너뜁니다. 대신 다음 섹션에서 원시 미디어 게시와 메타데이터 전용 게시를 통해 첨부 파일을 만드는 방법에 대해 설명합니다.