영업: 1-800-867-1380

쿼리 제한 시간 및 페이지 번호 매김

업데이트 날짜: 2014년 2월

테이블 서비스에는 다음과 같은 두 가지 유형의 쿼리 작업이 지원됩니다.

  • 테이블 쿼리(REST API) 작업은 지정된 저장소 계정 내의 테이블 목록을 반환합니다. 테이블 목록은 요청에 지정된 조건에 따라 필터링할 수 있습니다.

  • 엔터티 쿼리(REST API) 작업은 지정된 테이블에서 엔터티 집합을 반환합니다. 쿼리 결과는 요청에 지정된 조건에 따라 필터링할 수 있습니다.

테이블 서비스에 대한 쿼리는 한 번에 최대 1,000개까지 항목을 반환할 수 있으며, 최대 5초 동안 실행될 수 있습니다. 결과 집합에 항목이 1,000개 이상 포함된 경우, 쿼리가 5초 내에 완료되지 않은 경우 또는 쿼리가 파티션 경계를 벗어날 경우에는 결과 집합의 다음 항목에서 쿼리를 다시 시작하기 위해 사용할 수 있는 연속 토큰을 개발자에게 제공하는 헤더가 응답에 포함됩니다. 테이블 쿼리(REST API) 작업 또는 엔터티 쿼리(REST API) 작업에 대해 연속 토큰 헤더가 반환될 수 있습니다.

쿼리 예약 및 처리를 위해 요청에 할당되는 시간은 쿼리 실행을 위한 5초를 포함하여 총 30초입니다.

쿼리가 결과를 반환하지 않을 수도 있지만 그래도 연속 헤더는 반환됩니다.

다음 표에서는 연속 토큰 헤더를 보여줍니다.

 

연속 토큰 헤더 설명

x-ms-continuation-NextTableName

이 헤더는 테이블 쿼리(REST API) 작업으로 반환됩니다. 반환된 테이블 목록이 완전하지 않으면 목록의 다음 테이블 이름에 대한 해시가 연속 토큰 헤더에 포함됩니다.

x-ms-continuation-NextPartitionKey

이 헤더는 엔터티 쿼리(REST API) 작업으로 반환됩니다. 이 헤더에는 테이블에 대한 후속 쿼리에 반환할 다음 파티션 키의 해시가 포함됩니다.

x-ms-continuation-NextRowKey

이 헤더는 엔터티 쿼리(REST API) 작업으로 반환됩니다. 이 헤더에는 테이블에 대한 후속 쿼리에 반환할 다음 행 키의 해시가 포함됩니다.

일부 경우에는 x-ms-continuation-NextRowKeyNull일 수 있습니다.

연속 토큰을 검색하고 다음 결과 페이지를 반환하도록 후속 쿼리를 실행하려면 먼저 응답 헤더에 연속 토큰이 있는지 확인합니다. 헤더가 없거나 헤더 값이 Null이면 반환할 추가 엔터티가 없습니다. Microsoft .NET 클라이언트 라이브러리를 사용해서 연속 토큰을 수동으로 처리할 경우에는 먼저 쿼리 작업의 결과를 QueryOperationResponse 개체로 캐스팅합니다. 그런 후 QueryOperationResponse 개체의 Headers 속성에서 연속 토큰 헤더에 액세스할 수 있습니다.

연속 토큰을 검색한 후에는 해당 값을 사용해서 다음 결과 페이지를 반환하도록 쿼리를 생성합니다. 쿼리 요청 URI는 응답에 반환된 연속 토큰 헤더에 해당하는 다음 매개 변수를 사용할 수 있습니다.

  • NextTableName

  • NextPartitionKey

  • NextRowKey

note참고
클라이언트는 DataServiceContext 클래스의 Timeout 속성을 사용해서 쿼리 작업에 대한 제한 시간을 설정할 수 있습니다. 쿼리 예약 및 처리를 위해 요청에 할당되는 시간은 쿼리 실행을 위한 5초를 포함하여 총 30초입니다.

작업이 삽입 또는 삭제 작업인 경우 클라이언트에서 오류가 반환되더라도 서버에서 작업이 성공할 수 있습니다. 이 경우는 클라이언트 제한 시간이 삽입, 업데이트 또는 삭제 작업의 최대 제한 시간인 30초 미만으로 설정된 경우에 발생할 수 있습니다.

다음 코드 예에서는 Customers 테이블에 대해 연속 헤더를 반환하는 엔터티 쿼리의 예제 응답 헤더 집합을 보여줍니다. x-ms-continuation-NextPartitionKeyx-ms-continuation-NextRowKey가 모두 반환됩니다.

Date: Mon, 25 Nov 2013 20:11:08 GMT
Content-Type: application/atom+xml;charset=utf-8
Server: Windows-Azure-Table/1.0 Microsoft-HTTPAPI/2.0
Cache-Control: no-cache
x-ms-request-id: f9b2cd09-4dec-4570-b06d-4fa30179a58e
x-ms-version: 2013-08-15
x-ms-continuation-NextPartitionKey: 1!8!U21pdGg-
x-ms-continuation-NextRowKey: 1!8!QmVuOTk5
Content-Length: 880298

다음 데이터 페이지에 대한 요청은 다음 URI와 같이 생성할 수 있습니다.

http://myaccount.table.core.windows.net/Customers?NextPartitionKey=1!8!U21pdGg-&NextRowKey=1!12!QmVuMTg5OA--

참고 항목

이 정보가 도움이 되었습니까?
(1500자 남음)
의견을 주셔서 감사합니다.
Microsoft는 MSDN 웹 사이트에 대한 귀하의 의견을 이해하기 위해 온라인 설문 조사를 진행하고 있습니다. 참여하도록 선택하시면 MSDN 웹 사이트에서 나가실 때 온라인 설문 조사가 표시됩니다.

참여하시겠습니까?
표시:
© 2014 Microsoft