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

테이블 및 엔터티 쿼리

 

테이블 서비스의 테이블 및 엔터티를 쿼리하기 위해서는 요청 URI를 주의해서 생성해야 합니다. 다음 섹션에서는 쿼리 옵션에 대해 설명하고 몇 가지 공통적인 시나리오를 보여줍니다.

모든 테이블에 지정 된 저장소 계정에 반환 하려면 다음을 수행는 GET 작업의 설명에 따라 테이블 리소스는 테이블 쿼리 작업 합니다. 테이블 리소스를 나열하는 기본 URI는 다음과 같습니다.

https://myaccount.table.core.windows.net/Tables

단일 명명된 테이블을 반환하려면 다음과 같이 해당 테이블을 지정합니다.

https://myaccount.table.core.windows.net/Tables('MyTable')

테이블에 있는 모든 엔터티를 반환하려면 테이블 리소스 없이 URI에 테이블 이름을 지정합니다.

https://myaccount.table.core.windows.net/MyTable()

쿼리 결과 정렬 PartitionKey, 다음 기준 RowKey합니다. 다른 방식으로의 결과 순서 지정은 현재까지 지원되지 않습니다.

다음에 설명 된 대로 테이블 또는 엔터티만 반환 집합을 제한 하는 추가 옵션을 지정할 수 있습니다 쿼리 옵션 지원 섹션.

System_CAPS_note참고

쿼리가 최대 엔터티 수를 초과하거나, 제한 시간 간격을 초과하거나, 분할 경계를 넘을 경우 단일 요청에 대해 반환되는 엔터티 수가 제한될 수 있습니다. 자세한 내용은 참조 쿼리 제한 시간 및 페이지 번호 매김합니다.

테이블 서비스 지원를 따르고 다음 쿼리 옵션은 OData 프로토콜 사양. 이러한 옵션을 사용하여 쿼리로 반환되는 테이블, 엔터티 또는 엔터티 속성 집합을 제한할 수 있습니다.

시스템 쿼리 옵션

설명

$filter

지정된 필터를 충족하는 테이블 또는 엔터티만 반환합니다.

15 개 까지만 불연속 비교가 내에서 허용 되는 한 $filter 문자열입니다.

$top

위쪽만 반환 n 집합에서 엔터티 또는 테이블입니다.

$select

집합에서 원하는 엔터티 속성을 반환합니다. 이 쿼리 옵션은 2011-08-18 버전 이상을 사용하는 요청에만 지원됩니다. 자세한 내용은 참조 테이블 서비스에 대한 LINQ 쿼리 작성합니다.

System_CAPS_note참고

OData에 정의된 추가 쿼리 옵션은 테이블 서비스에서 지원되지 않습니다.

내는 $filter 절은 쿼리 결과 필터링 할 조건을 지정 하려면 비교 연산자를 사용할 수 있습니다.

모든 속성 유형에 대해 다음과 같은 비교 연산자가 지원됩니다.

operator

URI 식

Equal

eq

GreaterThan

gt

GreaterThanOrEqual

ge

LessThan

lt

LessThanOrEqual

le

NotEqual

ne

또한 부울 속성에 대해 다음과 같은 연산자가 지원됩니다.

operator

URI 식

And

and

Not

not

Or

or

필터 구문에 대 한 자세한 내용은 참조는 OData 프로토콜 사양.

쿼리 문자열에 사용할 경우에는 다음 문자를 인코딩해야 합니다.

  • 슬래시(/)

  • 물음표(?)

  • 콜론(:)

  • @ 기호(at 기호)

  • 앰퍼샌드 (&)

  • 등호(=)

  • 더하기 기호(+)

  • 쉼표(,)

  • 달러 기호($)

다음 예제에서는 REST 구문을 사용해서 몇 가지 일반적인 엔터티 쿼리에 대해 요청 URI를 생성하는 방법을 보여줍니다. LINQ 구문을 사용해서 동일한 쿼리를 작성할 수 있습니다. 자세한 내용은 참조 테이블 서비스에 대한 LINQ 쿼리 작성합니다.

모두는 $top$filter 형식의 속성으로 필터링 하기 위해 설명 된 구문을 사용 하 여 필터링 할 테이블 이름으로, 옵션을 사용할 수 있습니다 String합니다.

위쪽을 반환 하려면 n 지정 하는 모든 쿼리에 대 한 엔터티는 $top 쿼리 옵션입니다. 다음 예에서는 Customers라는 테이블에서 상위 10개 엔터티를 반환합니다.

https://myaccount.table.core.windows.net/Customers()?$top=10

때문에 PartitionKeyRowKey 엔터티의 기본 키를 형성 하는 속성, 다음과 같이 엔터티를 식별 하는 특수 한 구문을 사용할 수 있습니다.

https://myaccount.table.core.windows.net/Customers(PartitionKey='MyPartition',RowKey='MyRowKey1')

또는 이러한 속성의 일부로 지정할 수는 $filter 다음 섹션에 표시 된 것 처럼 옵션.

키 속성 이름 및 상수 값은 대/소문자를 구분합니다. 모두는 PartitionKeyRowKey 형식의 속성은 String합니다.

필터 문자열을 생성할 때는 다음 규칙에 주의하세요.

  • 정의 된 논리 연산자를 사용 하 여는 OData 프로토콜 사양 속성 값을 비교 합니다. 동적 값에 대해서는 속성을 비교할 수 없습니다. 식의 어느 한 쪽은 상수여야 합니다.

  • 속성 이름, 연산자 및 상수 값은 URL로 인코딩된 공백으로 구분해야 합니다. 공백은 URL로 인코딩된입니다 %20합니다.

  • 필터 문자열의 모든 부분은 대/소문자를 구분합니다.

  • 필터가 유효한 결과를 반환할 수 있도록 상수 값은 속성과 동일한 데이터 형식이어야 합니다. 지원 되는 속성 형식에 대 한 자세한 내용은 참조 테이블 서비스 데이터 모델 이해합니다.

System_CAPS_note참고

해당 형식이 문자열 형식이라고 가정하기 전에 속성이 명시적으로 형식화되어 있는지 여부를 확인하세요. 속성의 형식이 명시적으로 지정된 경우 엔터티가 반환될 때 해당 형식이 응답 내에 표시됩니다. 형식의 됩니다 속성이 명시적으로 형식화 되지 않은 경우 String, 및 엔터티가 반환 될 때 해당 형식이 응답 내에서 표시 되지 것입니다.

문자열 속성으로 필터링할 때는 문자열 상수를 작은 따옴표로 묶습니다.

다음 예제에 대 한 필터는 PartitionKeyRowKey 속성, 키가 아닌 추가 속성은 쿼리 문자열에 추가할 수도 있습니다.

https://myaccount.table.core.windows.net/Customers()?$filter=PartitionKey%20eq%20'MyPartitionKey'%20and%20RowKey%20eq%20'MyRowKey1'

다음 예제에 대 한 필터는 FirstNameLastName 속성:

https://myaccount.table.core.windows.net/Customers()?$filter=LastName%20eq%20'Smith'%20and%20FirstName%20eq%20'John'

테이블 서비스에서는 와일드카드 쿼리가 지원되지 않습니다. 그러나 원하는 접두사에 대해 비교 연산자를 사용하여 접두사 일치 비교를 수행할 수 있습니다. 다음 예제에서는 엔터티를 반환 합니다. 한 LastName 'A' 문자로 시작 하는 속성:

https://myaccount.table.core.windows.net/Customers()?$filter=LastName%20ge%20'A'%20and%20LastName%20lt%20'B'

정수 또는 부동 소수점 숫자로 필터링하려면 따옴표 없이 URI에 상수 값을 지정합니다.

포함 된 모든 엔터티를 반환 하는이 예제는 Age 30 보다 큰 값으로 속성:

https://myaccount.table.core.windows.net/Customers()?$filter=Age%20gt%2030

포함 된 모든 엔터티를 반환 하는이 예제는 AmountDue 100.25 보다 작거나 같은 값이 속성의:

https://myaccount.table.core.windows.net/Customers()?$filter=AmountDue%20le%20100.25%20

지정 된 부울 값을 필터링 하려면 true 또는 false 따옴표 없이 합니다.

다음 예에서는 모든 엔터티를 반환 합니다. 여기서는 IsActive 속성이 true:

https://myaccount.table.core.windows.net/Customers()?$filter=IsActive%20eq%20true

필터링 할는 DateTime 값을 지정 된 datetime URI에는 키워드와 뒤에 날짜/시간 상수를 작은따옴표로 합니다. 날짜/시간 상수에 설명 된 것 처럼 결합 된 UTC 형식에서 이어야 합니다 DateTime 속성 값 서식 지정합니다.

다음 예제에서는 엔터티를 반환 합니다. 여기서는 CustomerSince 속성은 2008 년 7 월 10 일입니다.

https://myaccount.table.core.windows.net/Customers()?$filter=CustomerSince%20eq%20datetime'2008-07-10T00:00:00Z'

GUID 값을 필터링 하려면 지정는 guid URI에는 키워드와 뒤에 고 guid 상수를 작은따옴표로 묶습니다.

다음 예제에서는 엔터티를 반환 합니다. 여기서는 GuidValue 속성이:

https://myaccount.table.core.windows.net/Customers()?$filter=GuidValue%20eq%20guid'a455c695-df98-5678-aaaa-81d3367e5a34'
표시:
© 2016 Microsoft