series_periods_detect()
적용 대상: ✅Microsoft Fabric✅Azure Data Explorer✅Azure Monitor✅Microsoft Sentinel
시계열에 있는 가장 중요한 기간을 찾습니다.
구문
series_periods_detect(계열, min_period ,max_period num_periods, )
구문 규칙에 대해 자세히 알아봅니다.
매개 변수
| 이름 | Type | 필수 | 설명 |
|---|---|---|---|
| 시리즈 | dynamic |
✔️ | 숫자 값의 배열로, 일반적으로 메이크 계열 또는 make_list 연산자의 결과 출력입니다. |
| min_period | real |
✔️ | 검색할 최소 기간입니다. |
| max_period | real |
✔️ | 검색할 최대 기간입니다. |
| num_periods | long |
✔️ | 필요한 최대 기간 수입니다. 이 숫자는 출력 동적 배열의 길이입니다. |
Important
- 알고리즘은 계열 길이의 절반 이상인 4포인트 이상을 포함하는 기간을 검색할 수 있습니다.
- min_period 조금 아래에 설정하고 시계열에서 찾을 것으로 예상되는 기간보다 약간 max_period. 예를 들어 시간별로 집계된 신호가 있고 일별 및 주간 기간(각각 24시간 및 168시간)을 모두 찾는 경우 min_period=0.8*24, max_period=1.2*168을 설정하고 이 기간 주위에 20%의 여백을 남길 수 있습니다.
- 입력 시계열은 일반이어야 합니다. 즉, 상수 bin으로 집계되며, 메이크 시리즈를 사용하여 생성된 경우 항상 해당합니다. 그렇지 않으면 출력은 의미가 없습니다.
반품
이 함수는 두 개의 열이 있는 테이블을 출력합니다.
- periods: 발견된 마침표(bin 크기의 단위)를 포함하는 동적 배열로, 점수에 따라 정렬됩니다.
- scores: 0에서 1 사이의 값을 포함하는 동적 배열입니다. 각 배열은 마침표 배열의 해당 위치에 있는 마침표의 중요성을 측정합니다.
예시
다음 쿼리는 하루에 두 번 집계된 애플리케이션 트래픽의 한 달 스냅샷을 포함합니다. bin 크기는 12시간입니다.
print y=dynamic([80, 139, 87, 110, 68, 54, 50, 51, 53, 133, 86, 141, 97, 156, 94, 149, 95, 140, 77, 61, 50, 54, 47, 133, 72, 152, 94, 148, 105, 162, 101, 160, 87, 63, 53, 55, 54, 151, 103, 189, 108, 183, 113, 175, 113, 178, 90, 71, 62, 62, 65, 165, 109, 181, 115, 182, 121, 178, 114, 170])
| project x=range(1, array_length(y), 1), y
| render linechart
이 시리즈에서 실행 series_periods_detect() , 주간 기간의 결과, 14 포인트 길이.
print y=dynamic([80, 139, 87, 110, 68, 54, 50, 51, 53, 133, 86, 141, 97, 156, 94, 149, 95, 140, 77, 61, 50, 54, 47, 133, 72, 152, 94, 148, 105, 162, 101, 160, 87, 63, 53, 55, 54, 151, 103, 189, 108, 183, 113, 175, 113, 178, 90, 71, 62, 62, 65, 165, 109, 181, 115, 182, 121, 178, 114, 170])
| project x=range(1, array_length(y), 1), y
| project series_periods_detect(y, 0.0, 50.0, 2)
출력
| series_periods_detect_y_periods | series_periods_detect_y_periods_scores |
|---|---|
| [14.0, 0.0] | [0.84, 0.0] |
참고 항목
샘플링이 너무 거칠기 때문에(12h bin 크기) 차트에서도 볼 수 있는 일일 기간을 찾을 수 없으므로 매일 2개의 bin 기간이 알고리즘에 필요한 최소 기간 크기인 4포인트 미만입니다.