서비스를 사용하여 가치 스트림 데이터에 액세스
다음 가치 스트림 서비스는 사물 또는 사물 템플릿을 통해 사용할 수 있습니다. 데이터는 가치 스트림을 사용하는 사물을 통해 액세스해야 합니다.
제공된 서비스를 사용하여 다양한 방식으로 가치 스트림 엔트리를 읽어들일 수 있습니다. 예를 들어, 특정 로깅된 속성(QueryBooleanPropertyHistory, QueryDateTimePropertyHistory), 로깅된 속성 집합(QueryNamedPropertyHistory) 또는 모든 로깅된 속성(QueryPropertyHistory)별로 엔트리를 읽어들일 수 있습니다.
여러 속성을 읽어들이면 ThingWorx는 특수 알고리즘을 실행하여 Null이 없는 동기화된 전체 테이블이 반환되도록 합니다. 예를 들어, 한 속성이 다른 속성보다 더 자주 로깅된 경우 두 속성을 한 번에 읽어들이면 ThingWorx에서 공백을 채웁니다.
가치 스트림 데이터는 데이터를 생성한 사물이 데이터를 명시적으로 제거하거나 가치 스트림이 삭제된 경우가 아니면 삭제되지 않습니다. 데이터는 원본 사물 또는 속성이 삭제되어도 그대로 유지됩니다.
|
가치 스트림의 지속성 공급자를 전환하면(예: ThingworxPersistenceProvider에서 PostgreSQL 또는 InfluxDB로 전환) 가치 스트림을 구현하는 사물은 RestartThing 서비스를 호출하여 새 지속성 공급자에 쓰여진 엔트리를 읽어들여야 합니다. 사물이 재시작되지 않으면 엔트리가 데이터베이스에 쓰여질 수도 있습니다. 이러한 엔트리는 사물이 재시작될 때까지 읽어들이지 않습니다.
|
|
DSE 가치 스트림에서 스트림 데이터를 필터링할 때 종료 날짜는 포함되지 않습니다. 예를 들어, 엔트리를 질의하고 종료 날짜를 마지막 엔트리의 정확한 타임스탬프로 설정하면 마지막 엔트리가 결과에 포함되지 않습니다.
|
가치 스트림 서비스
• GetLoggedProperties
가치 스트림 로깅으로 표시된 사물의 속성 목록을 반환합니다.
• GetNumericLoggedProperties
지정된 숫자 기본 유형에 대한 속성 목록을 반환합니다.
• GetPropertyLogging
속성이 로깅 중인지 여부를 확인합니다.
• GetValueStream
사물에 지정된 가치 스트림의 이름을 반환합니다.
• PurgePropertyHistory
지정된 날짜 범위 내 속성에 대한 모든 가치 스트림 엔트리를 삭제합니다.
• QueryBooleanPropertyHistory
사물의 날짜 범위 내 지정된 부울 속성 값에 대한 가치 스트림 엔트리를 질의합니다.
• QueryDateTimePropertyHistory
사물의 지정된 날짜/시간 속성 값에 대한 가치 스트림 엔트리를 질의합니다.
• QueryImagePropertyHistory
사물의 지정된 이미지 속성 값에 대한 가치 스트림 엔트리를 질의합니다.
• QueryInfoTablePropertyHistory
사물의 날짜 범위 내 지정된 인포테이블 속성 값에 대한 가치 스트림 엔트리를 질의합니다.
• QueryIntegerPropertyHistory
사물의 지정된 정수 속성 값에 대한 가치 스트림 엔트리를 질의합니다.
• QueryLocationPropertyHistory
지정된 시간 범위 내 사물의 지정된 위치 속성 값에 대한 가치 스트림 엔트리를 질의합니다.
• QueryNamedPropertyHistory
지정된 로깅된 속성 값에 대한 가치 스트림 엔트리를 필터 및 정렬 조건과 함께 질의하고 지정된 시간 범위에 대한 결과를 표시하도록 데이터 집합을 정규화합니다.
• QueryNumberPropertyHistory
로깅된 속성 값에 대한 가치 스트림을 필터 및 정렬 조건과 함께 질의하고 지정된 시간 범위에 대한 결과를 표시하도록 데이터 집합을 정규화합니다.
지정된 시간 범위 내 사물의 각 로깅된 속성 값에 대한 가치 스트림을 질의합니다.
• QueryStringPropertyHistory
지정된 시간 범위 내 사물의 지정된 문자열 속성 값에 대한 가치 스트림을 질의합니다.
• SetPropertyLogging
지정된 속성에 대한 로깅을 설정 또는 해제합니다.
• SetValueStream
사물에 대한 가치 스트림을 설정합니다.