주요 내용으로 건너뛰기

asset-centric OData 서비스

Cognite Data Fusion(CDF)을 데이터 원본으로 연결하고 OData 클라이언트를 사용하여 CDF asset-centric 리소스에 저장된 데이터를 쿼리하고, 변환하고, 시각화할 수 있습니다.

asset-centric OData 서비스를 사용하면 assets, time series, events, files, sequences 및 RAW 데이터와 같은 CDF 리소스에 OData API를 통해 액세스할 수 있습니다.

asset-centric OData 서비스는 다음과 같은 스키마를 갖는 URL을 수락합니다.

https://{cluster}.cognitedata.com/odata/{apiVersion}/projects/{project}

조건:

  • {cluster}: CDF 클러스터의 이름입니다(예: westeurope-1).
  • {apiVersion}: OData 서비스 API의 버전입니다(최신은 v1).
  • {project}: CDF 프로젝트의 이름입니다(예: publicdata).

OData 클라이언트가 올바른 asset-centric OData URL을 가리키게 하고 인증하면 서버는 지원되는 OData 함수 외에 현재 OData 서비스에서 지원되는 모든 asset-centric 유형이 포함된 테이블을 반환합니다.

asset-centric 리소스 유형 필터링​

asset-centric OData 서비스는 필터를 CDF로 푸시다운할 수 있습니다. 이렇게 하면 서버 측에서 필터링이 수행되어 클라이언트로 전송되는 데이터의 양이 줄어들므로 성능이 향상됩니다.

필터링 옵션​

  • 푸시다운: CDF 백엔드로 푸시되는 필터 함수입니다. 이것이 가장 효율적인 필터링입니다.
  • 로컬: 클라이언트로 결과를 반환하기 전에 OData 서비스에 의해 수행되는 필터링입니다. 푸시다운보다 효율성이 떨어집니다.
  • 클라이언트 측: 데이터가 검색된 후 클라이언트가 수행하는 필터링입니다. 가장 효율적이지 않습니다.

정의​

  • FilterFunctions - Contains, StartsWith 및 EndsWith입니다.
  • 비교 - <, <=, >, >= 및 =입니다.
  • 검색 - 검색 API를 사용하며 추가적인 로컬 필터링이 필요할 수 있습니다.
정보

검색에서는 제한된 수의 행을 반환하며, CDF에서 일치하는 모든 데이터를 수신하지 못할 수 있습니다.

Assets(자산)​

속성푸시다운로컬
Id==
ExternalId=, StartsWith=, FilterFunctions
Name=, Search=, FilterFunctions
Description검색=, FilterFunctions
ParentId==
ParentExternalId==
DataSetId==
Source==
MetaData=
RootId==
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison

Time series(시계열)​

속성푸시다운로컬
Id==
ExternalId=, StartsWith=, FilterFunctions
Name=, Search=, FilterFunctions
Description검색=, FilterFunctions
IsString==
MetaData=
Unit==
IsStep==
AssetId==
SecurityCategories
DataSetId==
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison

Data point (데이터 요소)​

속성푸시다운로컬
Id==
TimeStampComparisonComparison

Events(이벤트)​

속성푸시다운로컬
Id==
ExternalId=, StartsWithFilterFunctions
Description검색=, FilterFunctions
Source==
Type==
SubType==
MetaData=
DataSetId==
StartTimeComparisonComparison
EndTimeComparisonComparison
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison
AssetIdsContainsContains

Files(파일)​

속성푸시다운로컬
Id==
ExternalId=, StartsWith=, FilterFunctions
Name=, Search=, FilterFunctions
Source==
MimeType==
MetaData
DataSetId==
SourceCreatedTimeComparisonComparison
SourceModifiedTimeComparisonComparison
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison
UploadedTimeComparisonComparison
Uploaded==
AssetIdsContainsContains

Sequences(시퀀스)​

속성푸시다운로컬
Id*=
ExternalIdStartsWith=, StartsWith
Name=, Search=, FilterFunctions
Description=, Search=, FilterFunctions
MetaData
AssetId==
DataSetId==
CreatedTimeComparisonComparison
LastUpdatedTimeComparisonComparison
Columns
참고

Sequences(id) 구문을 통해 지원됩니다.

CDF RAW 데이터베이스​

속성푸시다운로컬
Name==

CDF RAW 테이블​

속성푸시다운로컬
Name==

CDF RAW 행​

속성푸시다운로컬
Key==, FilterFunction
LastUpdatedTimeComparisonComparison

지원되는 OData 함수​

AssetsRoots​

CDF 프로젝트의 루트 에셋을 가져옵니다.

매개 변수TypeDescription
매개 변수 없음

AssetsSearch​

CDF 프로젝트에서 자산을 검색합니다.

매개 변수TypeDescription
Search텍스트자산에서 검색할 공백으로 구분된 용어입니다. 검색어의 변형에 대해 관련 필드(현재 name 및 description)에서 최선 노력 퍼지 검색을 수행합니다. 관련성별로 결과를 정렬합니다.

EventsSearch​

CDF 프로젝트에서 이벤트를 검색합니다.

매개 변수TypeDescription
Search텍스트이벤트에서 검색할 공백으로 구분된 용어입니다. 검색어의 변형에 대해 관련 필드(현재 description)에서 최선 노력 퍼지 검색을 수행합니다. 관련성별로 결과를 정렬합니다.

TimeseriesAggregate​

여러 시계열의 데이터 요소를 집계합니다.

매개 변수TypeDescription
Tags텍스트쿼리에 포함할 시계열 ID 또는 외부 ID의 쉼표로 구분된 목록입니다.
Granularity텍스트데이터 요소 집계를 가져오는 데 사용되는 세분성입니다.
Start텍스트이 시간부터 시작하고 이 시간을 포함한 데이터 요소를 가져옵니다.
End텍스트(선택 사항)이 시점은 제외하고 이 시점까지의 데이터 요소를 가져옵니다. 값을 제공하지 않으면 기본적으로 now로 설정됩니다.

TimeseriesSearch​

CDF 프로젝트에서 시계열을 검색합니다.

매개 변수TypeDescription
Search텍스트시계열에서 검색할 공백으로 구분된 용어입니다. 검색어의 변형에 대해 관련 필드(현재 name 및 description)에서 최선 노력 퍼지 검색을 수행하고 관련성별로 결과를 정렬합니다.
마지막으로 업데이트