Azure Time Series Insights Gen2에서 데이터 쿼리
메모
Time Series Insights 서비스는 2024년 7월 7일에 사용 중지됩니다. 가능한 한 빨리 기존 환경을 대체 솔루션으로 마이그레이션하는 것이 좋습니다. 사용 중단 및 마이그레이션에 대한 자세한 내용은 설명서를 참조하세요.
Azure Time Series Insights Gen2를 사용하면 퍼블릭 Surface API를 통해 환경에 저장된 이벤트 및 메타데이터에 대한 데이터 쿼리를 사용할 수 있습니다. 이러한 API는 Azure Time Series Insights TSI Explorer에서 사용됩니다.
Azure Time Series Insights Gen2에서는 세 가지 기본 API 범주를 사용할 수 있습니다.
- 환경 API: 이러한 API는 Azure Time Series Insights Gen2 환경 자체에서 쿼리를 사용하도록 설정합니다. 호출자가 액세스 권한이 있는 환경 목록과 환경 메타데이터를 수집하는 데 사용할 수 있습니다.
- 시계열 Model-Query(TSM-Q) API: 환경의 시계열 모델에 저장된 메타데이터에 대해 CRUD(만들기, 읽기, 업데이트 및 삭제) 작업을 가능하게 합니다. 인스턴스, 형식 및 계층 구조에 액세스하고 편집하는 데 사용할 수 있습니다.
- 시계열 쿼리 (TSQ) API: 원본 공급자로부터 기록될 때 원격 분석 또는 이벤트 데이터를 검색하며, 고급 스칼라 및 집계 함수를 사용하여 데이터에 대한 고성능 계산 및 집계를 가능하게 합니다.
Azure Time Series Insights Gen2는 시계열 변수계산을 표현하기 위해 다양한 문자열 기반 식 언어인 TSX(시계열 식)사용합니다.
Azure Time Series Insights Gen2 API 개요
지원되는 핵심 API는 다음과 같습니다.
환경 응용 프로그래밍 인터페이스
- 환경 가져오기 API: 호출자가 액세스할 수 있는 권한이 있는 환경 목록을 반환합니다.
-
Get Environments 가용성 API: 이벤트 타임스탬프
$ts대한 이벤트 수 분포를 반환합니다. 이 API는 시간 간격(있는 경우)으로 구분된 이벤트 수를 반환하여 환경에 이벤트가 있는지 여부를 확인하는 데 도움이 됩니다. - 이벤트 스키마 API가져오기 : 지정된 검색 범위에 대한 이벤트 스키마 메타데이터를 반환합니다. 이 API는 지정된 검색 범위에 대한 스키마에서 사용할 수 있는 모든 메타데이터 및 속성을 검색하는 데 도움이 됩니다.
시계열 Model-Query(TSM-Q) API
대부분의 API들은 여러 시계열 모델 엔터티에서 일괄 CRUD 작업이 가능하도록 일괄 실행 작업을 지원합니다.
- 모델 설정 API: 환경의 기본 형식 및 모델 이름에 GET 및 PATCH 사용하도록 설정합니다.
- 형식 API: 시계열 형식 및 관련 변수에서 CRUD를 사용하도록 설정합니다.
- 계층 API: 시계열 계층 구조 및 관련 필드 경로에서 CRUD를 사용하도록 설정합니다.
-
인스턴스 API: 시계열 인스턴스 및 관련 인스턴스 필드에 CRUD를 사용하도록 설정합니다. 또한 Instances API는 다음 작업을 지원합니다.
- 검색: 인스턴스 특성을 기반으로 시계열 인스턴스를 검색할 때 검색 결과의 일부 목록을 가져옵니다.
- 제안: 인스턴스 특성을 토대로 시계열 인스턴스를 검색할 때, 결과의 일부 목록을 제안하고 보여줍니다.
TSQ(시계열 쿼리) API
이러한 API는 멀티레이어 스토리지 솔루션의 두 스토리지(웜 및 콜드)에서 사용할 수 있습니다.
이벤트 가져오기 API: 원본 공급자의 Azure Time Series Insights Gen2에 기록된 원시 이벤트 및 관련 이벤트 타임스탬프를 쿼리하고 검색할 수 있습니다. 이 API를 사용하면 지정된 시계열 ID 및 검색 범위에 대한 원시 이벤트를 검색할 수 있습니다. 이 API는 선택한 입력에 대한 전체 응답 데이터 세트를 검색하기 위한 페이지 매김을 지원합니다.
중요하다
JSON 평면화 및 이스케이프 규칙변경 사항의 일부로, 배열은 동적 형식으로 저장됩니다. 이 형식으로 저장된 페이로드 속성은 오직이벤트 가져오기 API를 통해서만
접근 가능합니다. Series API가져오기: 원시 이벤트에 변수로 정의된 계산을 적용하여 계산 값 및 관련 이벤트 타임스탬프를 쿼리하고 검색할 수 있습니다. 이러한 변수는 시계열 모델에서 정의하거나 쿼리에서 인라인으로 제공할 수 있습니다. 이 API는 선택한 입력에 대한 전체 응답 데이터 세트를 검색하기 위한 페이지 매김을 지원합니다.
Aggregate Series API: 원시 이벤트에 대해 변수로 정의된 계산을 적용하여 집계된 값과 해당 구간의 타임스탬프를 쿼리하고 검색할 수 있습니다. 이러한 변수는 시계열 모델에서 정의하거나 쿼리에서 인라인으로 제공할 수 있습니다. 이 API는 선택한 입력에 대한 전체 응답 데이터 세트를 검색하기 위한 페이지 매김을 지원합니다.
지정된 검색 범위 및 간격의 경우 이 API는 시계열 ID에 대한 변수당 간격당 집계된 응답을 반환합니다. 응답 데이터셋의 간격 수는 Unix epoch(1970년 1월 1일) 이후 경과된 시간(밀리초)인 epoch 틱을 계산한 후, 쿼리에 지정된 간격 크기로 나누어 계산됩니다.
응답 집합에 반환된 타임스탬프는 간격에서 샘플링된 이벤트가 아닌, 간격의 왼쪽 경계점에 해당하는 타임스탬프입니다.
스토어 유형 선택
위의 API는 단일 호출에서 두 스토리지 유형(콜드 또는 웜) 중 하나에 대해서만 실행할 수 있습니다. 쿼리 URL 매개 변수는 쿼리를 실행할
매개 변수를 지정하지 않으면 기본적으로 콜드 저장소에서 쿼리가 실행됩니다. 쿼리가 콜드 저장소와 웜 저장소 둘 다 겹치는 시간 범위에 걸쳐 있는 경우 웜 저장소에는 부분 데이터만 포함되므로 최상의 환경을 위해 쿼리를 콜드 저장소로 라우팅하는 것이 좋습니다.
Azure Time Series Insights Explorer 및 Power BI Connector는 위의 API를 호출할 있으며 관련 있는 올바른 storeType 매개 변수를 자동으로 선택합니다.
다음 단계
- 시계열 모델정의할 수 있는 다양한 변수에 대해 자세히 알아보세요.
- Azure Time Series Insights 탐색기에서 데이터를 쿼리하는 방법에 대해 자세히 알아보세요
.