/
데이터의 구성

데이터의 구성

Owned by Andrew Kim
Last updated: Aug 25, 2022 by Hyeonmin Lee (Unlicensed)
2 min read

이 문서는 현재 마크레이크에서 제공하고 있는 데이터의 형태와 종류 그리고, 간략한 설명을 담고 있다.

 

현재 구성된 lake의 Schema는 다음과 같다.

NAME

TIME

VALUE

NAME

TIME

VALUE

SensorNumber_Aggr_Type
(시리얼넘버_(평균,최소,최대)_센서종류)

DATA가 발생한 시간

DATA의 값

Unique

 

 

 

예시)

NAME

TIME

VALUE

NAME

TIME

VALUE

V02Q1940409_AVG_UPM

2022-07-18 23:59:00 000:000:000

10

V02Q1940409_AVG_PM

2022-07-18 23:59:00 000:000:000

10

V02Q1940409_MIN_TEMPER

2022-07-18 23:59:00 000:000:000

27.3

V02Q1940409_MAX_RH

2022-07-18 23:59:00 000:000:000

73

NAME에 해당하는 값을 알고 싶다면 여기 를 클릭하여 확인

 

lake Restfuapi 간단 예제

CloudVendor: aws1   CountryCode: kor   Lake ID :cbjrcb643gpb5mr175o0   X-API-KEY : WSlhoAVd60JoYC_BYSWwLl_piDb7Wt6dDPwLe034ZS_NkBW4F7TFV9QIHCh_LmjtSU5mKz9ERoiy6U9vt_NektI4RWGUmyoX2yKopOfLLOo0c   예) https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/

 

센서 데이터는 다음의 API를 통해서 다운로드 가능합니다.

  • 원시값 검색 : Lake에 저장된 Tag의 시작시간, 종료 시간 범위 내의 원시 데이터값을 가져옴

  • 최근값 검색 : 특정 Tag의 가장 나중에 입력된 값을 가져옴

  • 시간 범위 검색 : 특정 Tag의 최초 시간과 최종 입력시간을 가져옴

  • Tag 통계 데이터 검색 : 특정 Tag에 대한 통계값을 가져옴

  • 통계값 검색 : 특정 Tag에 대한 주어진 시간 범위 내에서 시간 단위 통계값을 가져옴

  • 피봇 검색 : tag별 데이터를 시간별 tag 통계값으로 변환하여 가져옴

 

각 API를 이용하여 검색하는 방법은 아래 페이지들을 참고하십시오.

사용 가능한 TAG NAME 에 대한 모든 정보를 확인하는 RESTFUL API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/tags   Tags를 통해 획득한 Name값인 V02Q1940409_AVG_UPM (평균 초미세먼지) TAG DATA의 Time Range 정보를 확인 가능한 API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/values/time_range?tag_name=V02Q1940409_AVG_UPM   Tags를 통해 획득한 Name 값 V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM 데이터를 조회하는 API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/values/raw?tag_name=V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM&start_time=2022-07-19 23:59:00 000:000:000&end_time=2022-07-20 03:59:00 000:000:000&limit=1000 V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM의 가장 최근에 입력된 데이터를 조회하는 API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/values/current?tag_name=V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM&value_return_form=0 V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM 데이터를 2시간 단위로 집계하여 나온 평균값(AVG)을 조회하는 API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/values/calculated?tag_name=V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM&start_time=2021-06-16 11:00:00&end_time=2021-07-06 11:00:00&calc_mode=avg&interval_type=hour&interval_value=2&limit=1000&value_return_form=0 V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM 데이터를 Pivoting 하여 조회하는 API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/values/pivoted?tag_name=V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM&start_time=2022-07-19 23:59:00 000:000:000&end_time=2022-07-20 03:59:00 000:000:000&limit=1000&value_return_form=0 V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM 데이터를 3시간 단위로 집계하여 나온 평균값을 Pivoting 하여 조회하는 API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/values/pivoted?tag_name=V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM&calc_mode=avg&start_time=2021-06-16 11:00:00&end_time=2021-07-06 11:00:00&interval_type=hour&interval_value=3&limit=1000&value_return_form=0 특정 TAG 에 대한 STAT 정보가 담긴 데이터 조회하는 API https://aws1.kor.machlake.com/lakes/cbjrcb643gpb5mr175o0/values/stat?tag_name=V02Q1940409_AVG_UPM,V02Q1940409_AVG_PM

Data 조회 API에 대해 자세한 설명은 여기 를 클릭하여 확인

Related content