테이블 디자이너에 대한 필터 문자열 생성
메모
이 문서는 Azure Azure Cloud Services(추가 지원)적용됩니다. Cloud Services(클래식)는 2024년 8월 31일부터 사용 중지됩니다. 자세한 내용은 2024년 8월 31일 Cloud Services(클래식) 배포 모델이 사용 중지되는 것을 참조하세요. 새 개발의 경우 Azure App Service , Azure Functions 또는 Azure Container Apps 같은 특정 용도로 설계된 최신 서비스 유형을 사용하는 것이 좋습니다. 사용 가능한 서비스의 최신 목록은 azure 제품 디렉터리를 참조하세요.
Visual Studio 테이블 디자이너표시되는 Azure 테이블의 데이터를 필터링하려면 필터 문자열을 생성하고 필터 필드에 입력합니다. 필터 문자열 구문은 WCF Data Services에서 정의되며 SQL WHERE 절과 유사하지만 HTTP 요청을 통해 Table service로 전송됩니다.
테이블 디자이너 적절한 인코딩을 처리하므로 원하는 속성 값을 필터링하려면 속성 이름, 비교 연산자, 조건 값 및 선택적으로 필터 필드에 부울 연산자만 입력하면 됩니다.
Storage Services REST API 참조통해 테이블을 쿼리하는 URL을 생성하는 경우와 마찬가지로 $filter 쿼리 옵션을 포함할 필요가 없습니다.
WCF Data Services는 OData(Open Data Protocol)기반으로 합니다. 필터 시스템 쿼리 옵션($filter)에 대한 자세한 내용은 OData URI 규칙 사양참조하세요.
비교 연산자
다음 논리 연산자는 모든 속성 형식에 대해 지원됩니다.
| 논리 연산자 | 묘사 | 필터 문자열 예제 |
|---|---|---|
| 방정식 | 같다 | City eq 'Redmond' |
| gt | 보다 큼 | 가격 gt 20 |
| ge | 보다 크거나 같음 | 가격 ge 10 |
| lt | 미만 | 가격 lt 20 |
| 르 | 작거나 같음 | Price le 100 |
| 네브라스카 | 같지 않음 | 시티 네 '런던' |
| 그리고 | 그리고 | 가격 ≤ 200 및 가격 > 3.5 |
| 또는 | 또는 | Price 이하 3.5 또는 Price 초과 200 |
| 아니 | 안 | 사용 가능하지 않음 |
필터 문자열을 생성할 때는 다음 규칙이 중요합니다.
- 논리 연산자를 사용하여 속성과 값을 비교합니다. 속성을 동적 값과 비교할 수 없습니다. 식의 한쪽은 상수여야 합니다.
- 필터 문자열의 모든 부분은 대/소문자를 구분합니다.
- 필터가 유효한 결과를 반환하려면 상수 값이 속성과 동일한 데이터 형식이어야 합니다. 지원되는 속성 형식에 대한 자세한 내용은 테이블 서비스 데이터 모델을 참조하세요.
문자열 속성 필터링
문자열 속성을 필터링할 때 문자열 상수는 작은따옴표로 묶습니다.
다음 예제에서는 PartitionKey 및 RowKey 속성을 기준으로 필터링합니다. 또한, 키가 아닌 추가 속성을 필터 문자열에 추가할 수도 있습니다.
PartitionKey eq 'Partition1' and RowKey eq '00001'
필수는 아니지만 각 필터 식을 괄호로 묶을 수 있습니다.
(PartitionKey eq 'Partition1') and (RowKey eq '00001')
Table Service는 와일드카드 쿼리를 지원하지 않으며 테이블 디자이너에서도 지원되지 않습니다. 그러나 원하는 접두사에서 비교 연산자를 사용하여 접두사 일치를 수행할 수 있습니다. 다음 예제에서는 문자 'A'로 시작하는 LastName 속성이 있는 엔터티를 반환합니다.
LastName ge 'A' and LastName lt 'B'
숫자 속성 필터링
정수 또는 부동 소수점 숫자를 필터링하려면 따옴표 없이 숫자를 지정합니다.
이 예제에서는 값이 30보다 큰 Age 속성이 있는 모든 엔터티를 반환합니다.
Age gt 30
이 예제에서는 값이 100.25보다 작거나 같은 AmountDue 속성이 있는 모든 엔터티를 반환합니다.
AmountDue le 100.25
부울 속성 필터링
부울 값을 필터링하려면 true 또는 false를 따옴표 없이 지정합니다.
다음 예제에서는 IsActive 속성이 true 설정된 모든 엔터티를 반환합니다.
IsActive eq true
논리 연산자 없이 이 필터 식을 작성할 수도 있습니다. 다음 예제에서 Table 서비스는 IsActive가 true인 모든 엔터티를 반환합니다.
IsActive
IsActive가 false인 모든 엔터티를 반환하려면 not 연산자를 사용할 수 있습니다.
not IsActive
DateTime 속성 필터링
DateTime 값을 필터링하려면 datetime 키워드와 날짜/시간 상수를 작은따옴표로 지정합니다. 날짜/시간 상수는 날짜시간 속성 값 포맷에 설명된 대로 결합된 UTC 형식이어야 합니다.
다음 예제에서는 CustomerSince 속성이 2008년 7월 10일과 같은 엔터티를 반환합니다.
CustomerSince eq datetime'2008-07-10T00:00:00Z'