주요 내용으로 건너뛰기

사용자 지정 OData 쿼리

asset-centric OData 서비스와 데이터 모델링 OData 서비스 모두 속성을 필터링하고 특정 데이터 집합을 검색하는 사용자 지정 쿼리를 지원합니다.

사용자 지정 쿼리 URL​

asset-centric OData 서비스 예​

리소스 유형 속성을 필터링하려면 다음과 같이 하십시오.

GET .../{resourceType}/?$filter={Filter}

조건:

  • {resourceType}: 리소스 유형입니다(예: Assets, TimeSeries, Events 등).
  • {Filter}: OData 필터 식입니다.

데이터 모델링 OData 서비스 예​

데이터 모델에서 view 속성을 필터링하려면 다음과 같이 하십시오.

GET .../{view}/?$filter={Filter}

조건:

  • {view}: 데이터 모델에서 view의 이름입니다.
  • {Filter}: OData 필터 식입니다.

사용자 지정 쿼리 예​

단순 등식 필터​

등식 필터는 AttributeName eq 'AttributeValue' 형식을 사용합니다.

GET .../Assets?$filter=Name eq '23-TE-96116-04'

데이터 모델링 필터링​

데이터 모델 view의 속성에 직접 적용되는 필터입니다.

GET .../City?$filter=iso2 eq 'MX'

메타데이터 필터링​

메타데이터의 경우 필터링은 메타데이터 개체 내에 중첩된 속성에 대해 수행됩니다.

GET .../Assets?$filter=MetaData/RES_ID eq '525283'

결합 필터​

GET .../Assets?$filter=MetaData/RES_ID eq '525283' and Name eq '23-TE-96116-04'

필터에서 함수 사용​

OData는 startswith, endswith, contains 등과 같은 함수를 지원합니다.

예를 들어, ExternalId가 'Sensor'로 시작하는 시계열을 필터링하려면 다음과 같이 하십시오.

GET .../TimeSeries?$filter=startswith(ExternalId,'Sensor')

참고: 모든 함수가 CDF로의 푸시다운을 지원하는 것은 아닙니다. 특정 리소스 유형의 필터링 기능을 확인하십시오.

여러 쿼리 매개 변수 결합​

여러 쿼리 옵션을 결합하여 데이터 검색을 구체화할 수 있습니다.

예를 들어, Name이 'Pump'로 시작하는 자산을 검색하고 Id 및 Name만 선택하며 Name을 기준으로 정렬하려면 다음과 같이 하십시오.

GET .../Assets?$filter=startswith(Name,'Pump')&$select=Id,Name&$orderby=Name asc

사용자 지정 쿼리 디버깅​

  • 별도의 도구 사용: Fiddler와 같은 도구를 사용하면 클라이언트와 서버 간의 HTTP 트래픽을 검사할 수 있습니다.
  • 필터 구문 확인: 필터가 OData 사양에 따라 올바르게 형식화되었는지 확인하십시오.
  • 지원되는 필터 검토: 데이터 모델의 항목 필터링 및 asset-centric 리소스 유형 필터링을 참조하여 OData 서비스에서 지원하는 필터링 기능에 대해 알아보십시오.

제한 사항​

모든 OData 함수와 기능이 지원되는 것은 아닙니다. 지원되는 기능 및 제한 사항에 대한 자세한 내용은 개별 서비스 설명서를 참조하십시오.

마지막으로 업데이트