제안 쿼리

  • 아티클

제안 리소스, 즉 제안 URI 경로에 대해 POST를 실행하여 제안 리소스에 대해 쿼리를 수행할 수 있습니다. 이 섹션에서는 자체 링크로 특정 컬렉션에 대한 제품을 검색하는 간단한 예제를 보여 줄 것입니다.

요청

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

헤더

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

헤더 필수 Description
Content-Type 필수 application/query+json으로 설정해야 합니다.
x-ms-documentdb-isquery 필수 True로 설정해야 합니다.

본문

속성 필수 설명
쿼리 필수 이 속성의 값은 실행할 SQL 문입니다. 
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}

응답

쿼리와 일치하는 개체 리소스의 배열을 반환합니다.

헤더

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

헤더 Description
x-ms-item-count 쿼리에서 반환된 항목의 수입니다.

상태 코드

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

HTTP 상태 코드 Description
200 정상 작업이 완료되었습니다.
400 잘못된 요청 JSON 본문이 잘못되었습니다.
401 권한 없음 권한 부여 또는 x-ms-date 헤더가 설정되지 않았습니다. 401은 권한 부여 헤더가 잘못된 권한 부여 토큰으로 설정된 경우에도 반환됩니다.

본문

속성 Description
_제거 시스템 생성 속성입니다. 이 작업에는 _rid 값이 비어 있습니다.
_횟수 이 속성은 작업의 일부로 반환된 제안 수를 표시합니다.
제품 작업의 일부로 반환된 제품을 포함하는 배열입니다.
제품 리소스의 속성을 찾으려면 제품을 참조하세요.		 
{"_rid":"","Offers":[],"_count":0}

예제

POST https://querydemo.documents.azure.com/offers HTTP/1.1  
x-ms-continuation:   
x-ms-documentdb-isquery: True  
x-ms-documentdb-query-enablecrosspartition: False  
x-ms-date: Tue, 29 Mar 2016 18:07:41 GMT  
authorization: type%3dmaster%26ver%3d1.0%26sig%3d0si%2fhno2pKTQhgvdkojNqlQlYdoguwQEBt79XvpobMc%3d  
Cache-Control: no-cache  
User-Agent: Microsoft.Azure.Documents.Client/1.6.0.0 samples-net/3  
x-ms-version: 2015-12-16  
Accept: application/json  
Content-Type: application/query+json  
Host: querydemo.documents.azure.com  
Content-Length: 94  
Expect: 100-continue  
  
{"query":"SELECT * FROM root WHERE root.resource = \"dbs/EVQzAA==/colls/EVQzALIIEQw=/\") "}
  

HTTP/1.1 200 Ok  
Cache-Control: no-store, no-cache  
Pragma: no-cache  
Transfer-Encoding: chunked  
Content-Type: application/json  
Server: Microsoft-HTTPAPI/2.0  
Strict-Transport-Security: max-age=31536000  
x-ms-last-state-change-utc: Fri, 25 Mar 2016 21:27:20.035 GMT  
x-ms-item-count: 0  
x-ms-schemaversion: 1.1  
x-ms-request-charge: 3.94  
x-ms-serviceversion: version=1.6.52.5  
x-ms-activity-id: b151cbe4-aae0-4949-959f-189b9884478d  
x-ms-session-token: M:8166  
x-ms-gatewayversion: version=1.6.52.5  
Date: Tue, 29 Mar 2016 18:07:41 GMT  
  
{"_rid":"","Offers":[],"_count":0}

참고 항목