내보내기(0) 인쇄
모두 확장

레코드 쿼리 작업

업데이트 날짜: 2012년 9월

쿼리 작업은 테이블에서 항목을 반환합니다.

다음과 같이 요청을 지정할 수 있습니다. <service_name>을 모바일 서비스 이름으로 바꾸고 <table_name>을 액세스할 테이블 이름으로 바꾸십시오.

 

HTTP 동사 요청 URI HTTP 버전

GET

https://<service_name>.azure-mobile.net/tables/<table_name>

HTTP/1.1

Microsoft Azure 모바일 서비스는 OData(Open Data Protocol)로 정의한 쿼리 옵션 매개 변수의 다음 하위 집합을 지원합니다.

 

URI 매개 변수 필수 설명

$filter

아니요

필터 조건자에 따라 반환되는 항목을 제한합니다.

$inlinecount

아니요

페이징 적용 없이 기본 쿼리에서 반환될 수 있는 모든 항목의 수를 반환합니다. 이 매개 변수에 대한 allpages 값을 지정해야 합니다.

$orderby

아니요

하나 이상의 열을 기준으로 반환되는 항목의 순서입니다. 순서는 오름차순(asc: 기본값) 또는 내림차순(desc)으로 지정할 수 있습니다.

$select

아니요

반환된 데이터에 포함된 열을 지정하여 데이터의 새로운 프로젝션을 정의합니다.

$skip

아니요

항목을 반환하기 전에 건너뛸 수 있는 기본 쿼리의 레코드 수를 지정합니다. 페이징 결과에 사용됩니다. 자세한 내용은 쿼리에 페이징 추가를 참조하십시오.

$top

아니요

응답에 포함할 항목 수를 지정합니다. 페이징 결과에 사용됩니다. 자세한 내용은 쿼리에 페이징 추가를 참조하십시오.

noscript 매개 변수도 지원됩니다.

 

URI 매개 변수 필수 설명

noscript

아니요

true 값이 제공되면 등록된 스크립트가 실행되지 않습니다. 스크립트를 실행하지 않으려면 X-ZUMO-MASTER 헤더에 서비스 마스터 키도 지정해야 합니다.

__includeDeleted

아니요

일시 삭제를 사용하도록 설정한 테이블에 대해 true 값을 제공하면 __deleted 시스템 속성이 true로 설정된 행이 응답에 포함됩니다. 그렇지 않으면 일시 삭제를 사용하도록 설정한 경우 해당 행이 반환되지 않습니다.

예:

__includeDeleted=true

__systemproperties

아니요

응답에 포함할 시스템 속성의 쉼표로 구분된 목록입니다. 다음 목록의 시스템 속성이 허용됩니다.

  • __createdAt: 레코드 만들기를 추적하기 위해 작성된 시스템입니다.

  • __updatedAt: 마지막 레코드 업데이트를 추적하기 위해 작성된 시스템입니다.

  • __version: 동시성을 지원하는 데 사용되는 버전입니다.

  • __deleted: 일시 삭제를 지원하기 위해 작성된 시스템입니다.

예:

__systemproperties=version,deleted

다음 표에서는 요청 헤더에 대해 설명합니다.

 

요청 헤더 필수  

Accept

아니요

이 헤더를 application/json로 설정합니다.

X-ZUMO-APPLICATION

조건부

모바일 서비스의 응용 프로그램의 키입니다. 테이블 작업에 액세스해야 할 경우 유효한 응용 프로그램 키를 지정해야 합니다. 기본 테이블 작업 액세스 권한입니다.

X-ZUMO-AUTH

조건부

인증된 사용자의 서비스 생성 인증 토큰입니다. 테이블 작업에 액세스해야 할 경우 인증된 사용자의 토큰을 지정해야 합니다.

X-ZUMO-MASTER

조건부

서비스 마스터 키입니다. 테이블 작업에 액세스하는 데 관리자 액세스가 필요한 경우에만 이 키를 포함해야 합니다.

security보안 참고
서비스 마스터 키는 데이터 서비스에 관리자 액세스를 제공하는 중요한 보안 자격 증명입니다. 이러한 암호는 다른 사람과 공유하거나 앱과 함께 배포해서는 안 됩니다. 이 키는 항상 암호화된 채널을 통해 안전하게 배포되어야 합니다.

없음.

응답에는 HTTP 상태 코드, 응답 헤더 집합 및 응답 본문이 포함되어 있습니다.

작업이 성공하면 상태 코드 200(정상)이 반환됩니다.

이 작업의 응답에는 다음과 같은 헤더가 포함됩니다. 응답에는 추가 표준 HTTP 헤더가 포함될 수도 있습니다. 모든 표준 헤더는 HTTP/1.1 프로토콜 사양을 따릅니다.

 

응답 헤더 설명

Content-Length

응답 본문의 길이입니다.

Content-Type

헤더가 application/json으로 설정됩니다.

x-zumo-version

요청을 실행한 런타임 버전을 나타냅니다.

쿼리 결과의 JSON 표현입니다. 결과는 단일 JSON 개체 또는 JSON 개체 컬렉션으로 표현됩니다.

note참고
$inlinecount 매개 변수를 쿼리에 포함하면 응답의 JSON은 새 JSON 개체에 의해 results 속성(결과 데이터가 JSON 개체의 컬렉션으로 포함됨) 및 count 속성(총 개수임)으로 래핑됩니다.

권한 부여는 테이블 작업에 대한 액세스 권한 요구 사항에 따라 달라지며 다음과 같이 요약됩니다.

 

테이블 작업 액세스 권한 필수 인증 헤더

모든 사용자

없음

응용 프로그램 키가 있는 모든 사용자

X-ZUMO-APPLICATION

인증된 사용자만

X-ZUMO-AUTH

스크립트 및 관리자만

X-ZUMO-MASTER

개별 테이블 작업에 대한 액세스 권한은 Microsoft Azure 관리 포털에서 설정합니다. 자세한 내용은 사용 권한를 참조하세요.

다음 예제 URI는 TodoItem 테이블에서 전체 propertyfalse인 JSON 개체를 반환합니다.

GET https://todolist.azure-mobile.net/tables/TodoItem?$filter=(complete%20eq%20false)

요청이 다음 헤더와 함께 보내집니다.

Accept: application/json
X-ZUMO-APPLICATION: UzMAOXRlJdZyqibeUqCMoZZMrUXIRs92
Host: todolist.azure-mobile.net

요청을 보낸 후에는 다음 응답이 반환됩니다.

HTTP/1.1 200 OK
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 05:59:27 GMT
Content-Length: 188

[{"id":1,"text":"Sign-up for the free trial","complete":false},{"id":2,"text":"Create the mobile service","complete":false },
    {"id":3,"text":"Complete the quickstart","complete":false}]

다음 예제 URI는 총 개수 값(이 경우 3)을 포함하여 동일한 필터링된 쿼리를 반환합니다.

GET https://todolist.azure-mobile.net/tables/TodoItem?$filter=(complete%20eq%20false)&$inlinecount=allpages

요청이 다음 헤더와 함께 보내집니다.

Accept: application/json
X-ZUMO-APPLICATION: UzMAOXRlJdZyqibeUqCMoZZMrUXIRs92
Host: todolist.azure-mobile.net

요청을 보낸 후에는 다음 응답이 반환됩니다.

HTTP/1.1 200 OK
Content-Type: application/json
x-zumo-version: Zumo.Main.0.1.6.527.Runtime
Date: Thu, 20 Sep 2012 05:59:27 GMT
Content-Length: 211

{"results": [{"id":1,"text":"Sign-up for the free trial","complete":false},{"id":2,"text":"Create the mobile service","complete":false },
    {"id":3,"text":"Complete the quickstart","complete":false}],"count":3}

표시:
© 2015 Microsoft