레코드 쿼리
콘텐츠의 테이블 축소
콘텐츠의 테이블 확장
이 문서는 기계 번역을 이용하여 번역되었습니다. 문서를 영문으로 보려면 영문 확인란을 선택하세요. 마우스 포인터를 텍스트 위로 이동시켜 팝업 창에서 영문 텍스트를 표시할 수도 있습니다.
번역
영문

레코드 쿼리 작업

 

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

System_CAPS_note참고

기본적으로 모바일 서비스는 쿼리에서 50개의 레코드만 반환합니다. 더 많은 레코드를 반환하려면 요청에서 페이징을 사용합니다. 자세한 내용은 참조 쿼리에 페이징 추가.

다음과 같이 요청을 지정할 수 있습니다. 대체 <service_name> 모바일 서비스 이름으로 및 <table_name> 을 액세스할 테이블의 이름으로 합니다.

HTTP 동사

요청 URI

HTTP 버전

GET

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

HTTP/1.1

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

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: 레코드에 마지막으로 업데이트를 추적 하기 위해 만들어진 sssystem 합니다.

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

  • __deleted: 일시적으로 삭제를 지원 하기 위해 생성 하는 시스템입니다.

예:

__systemproperties=version,deleted

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

요청 헤더

필수

Accept

아니요

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

X-ZUMO-APPLICATION

조건부

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

X-ZUMO-AUTH

조건부

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

X-ZUMO-MASTER

조건부

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

System_CAPS_security 보안 참고

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

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

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

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

응답 헤더

설명

Content-Length

응답 본문의 길이입니다.

Content-Type

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

x-zumo-version

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

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

System_CAPS_note참고

포함 하는 경우는 $inlinecount 매개 변수를 쿼리에 응답에 JSON 사용 하 여 새 JSON 개체에 의해 래핑되는 results 결과 데이터가 JSON 개체의 컬렉션을 포함 하는 속성 및 count 속성의 총 수입니다.

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

테이블 작업 액세스 권한

필수 인증 헤더

모든 사용자

없음

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

X-ZUMO-APPLICATION

인증된 사용자만

X-ZUMO-AUTH

스크립트 및 관리자만

X-ZUMO-MASTER

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

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

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}
표시:
© 2016 Microsoft