TransformPart - 범위, 전역
TransformPart API는 수행할 변환의 세부 정보를 지정하는 메서드를 제공합니다.
범위가 지정된 전역 서버 스크립트에서 이 클래스를 호출할 수 있습니다. TransformPart 클래스를 사용하는 경우 sn_clotho 네임스페이스 식별자를 사용합니다.
이 클래스에 대한 생성자가 없습니다. TransformPart 개체는 많은 Transformer 및 TransformPart 메서드에서 반환됩니다.
이 클래스의 메서드는 수행할 변환을 정의합니다. 실제 변환은 execute () 메서드가 Transformer 객체에서 호출될 때 수행됩니다.
- 변환 메서드를 호출하기 전에 metric() 메서드를 호출해야 합니다.
- 변환 메서드를 호출한 후에는 metric() 또는 groupBy() 메서드를 사용할 수 없습니다.
- 원하는 중간 결과에 대해 collect() 메서드가 호출되지 않는 한 중간 변환이 결과에 반환되지 않습니다.
// where tp is a TransformPart object // example 1 tp.avg().add(2); var tr = tp.execute(); // tr contains avg+2, but not avg // example 2 tp.avg().add(2); tp.avg(); var tr = tp.execute(); // tr contains both avg and avg + 2 // example 3 tp.avg().collect().add(2); var tr = tp.execute(); // tr contains both avg and avg + 2
이 클래스는 애플리케이션의 일부입니다 MetricBase .
TransformPart - add(숫자 상수)
각 타임 스탬프의 값에 지정된 숫자를 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 상수 | 번호 | 각 타임 스탬프의 값에 추가할 숫자입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
파트 변환 - avg()
선택한 메트릭 계열을 각 타임 스탬프의 평균 값을 포함하는 하나의 계열로 집계합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - bottom(숫자 수)
각 타임 스탬프에 대해 지정된 수의 하단 값을 반환하는 결과 세트를 작성합니다. 이 방법을 사용하면 계열 수가 "카운트"가 발생합니다. 각 값은 소스 계열의 레이블을 유지합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 카운트 | 번호 | 반환할 계열 수입니다. 계열에는 카운트 - 1에 0 레이블이 붙습니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - ceil(Number ceiling)
지정된 값보다 큰 타임 스탬프의 값을 지정된 값으로 바꿉니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 천장 | 번호 | 모든 타임 스탬프에 허용되는 최대값입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - collect()
이 변환을 수집용으로 표시합니다.
체인의 일부이지만 마지막 변환이 아닌 변환은 기본적으로 수집되지 않습니다. 수집된 변환은 변환 결과의 일부로 반환됩니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - count()
선택한 메트릭 계열을 각 타임 스탬프의 값 수를 포함하는 하나의 계열로 집계합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - div(숫자 상수)
각 타임 스탬프의 값을 지정된 숫자로 나눕니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 상수 | 번호 | 각 타임 스탬프의 값을 나눌 숫자입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - filter(객체 집계, 객체 기간)
지정된 시간 동안 지정된 집계기를 사용하여 계열을 작성합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 집계기 | 객체 | 다음과 같을 수 있습니다.
|
| 기간 | 객체 | 계열의 기간입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - 층(층 번호)
지정된 값보다 작은 타임 스탬프의 값을 지정된 값으로 바꿉니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 층 | 번호 | 타임 스탬프의 최소값입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - fractiles(배열 분수)
지정된 백분율의 값이 아래에 있는 값으로 구성된 계열을 작성합니다. 지정된 배열의 각 분수에 대한 계열을 반환합니다.
반환된 계열의 타임 스탬프에 있는 값은 해당 타임 스탬프에 대해 지정된 샘플 비율이 아래에 있는 값입니다. 예를 들어 분수가 0.5이면 타임 스탬프의 값은 입력 계열의 값 절반이 아래(중앙값)인 값입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 분수 | 숫자 배열 | 입력 계열에 사용할 분수입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. 지정된 각 분수에 대해 하나의 계열을 포함합니다. |
// returns a single series containing the median for each time stamp, which
// means that half a time stamp's values are below the returned value
fractiles([.5])
// returns four series, one series for each of the 25%, 50%, 75%, and 100% quartiles
fractiles([.25, .5, .75, 1])
// returns the median, 95% percentile, the max value
fractiles([.50, .95, 1])
TransformPart - getResult()
이 변환과 관련된 결과의 일부를 반환합니다.
collect() 메서드는 execute() 메서드 전에 호출되어야 하며, execute() 메서드는 getResult() 메서드를 호출하기 전에 호출되어야 합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 결과 변환 | 변환의 이 부분과 연결된 변환 결과를 포함합니다. |
var t = new sn_clotho.Transformer(drones);
t.metric("mb_demo_mt_altitude");
var avgTform = t.avg();
t.execute();
var avgTformResult = avgTform.getResult();
TransformPart - groupBy(문자열 필드)
데이터를 그룹화할 필드를 지정합니다. 여러 필드를 지정하려면 연속 호출을 개별적으로 실행합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 필드 | 문자열 | 변환 결과를 그룹화할 테이블의 필드 이름입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
다음 예제는 차량 및 모델 필드별로 고도 평균 메트릭을 그룹화하는 방법을 보여줍니다.
transformer.groupBy("fleet,model").metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');
var transformPart = transformer.groupBy("fleet,model")
transformPart.metric("mb_demo_mt_altitude").avg().label('%g:fleet: - %g:model:');
TransformPart - interpolate(객체 수)
인접한 데이터 값에서 보간하여 NaN 데이터 항목에 대한 데이터 값을 생성합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 카운트 | 객체 | NaN이 아닌 값을 확인할 각 방향의 데이터 샘플 수를 지정합니다. NaN이 아닌 값을 찾을 수 없는 경우 NaN이 사용됩니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - iqr()
사분위수 범위 변환을 수행합니다.
- IQR, 모든 항목의 중앙값
- IQR 범위, Q1-1.5IQR 미만 또는 Q3+1.5IQR 이상
- Q1, 항목의 가장 작은 절반의 중앙값
- Q3, 항목의 가장 큰 절반의 중앙값
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - label(문자열 레이블)
결과 계열의 레이블을 추가합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 레이블 | 문자열 | 변환 결과의 레이블입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - limit(객체 수)
NaN이 아닌 가장 최근의 값부터 시작하여 지정된 최대 수의 값을 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 카운트 | 객체 | 여러 타임 스탬프 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - log(Number base)
각 타임 스탬프의 값에 대해 로그를 실행하며, 결과는 타임 스탬프 값에 대해 지정된 기준의 로그입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 기본 | 번호 | 로그 계산의 기준입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - max()
각 타임 스탬프에 대한 최대값이 있는 계열을 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - median()
계열 집합의 각 타임 스탬프에 대한 값의 중앙값을 포함하는 계열을 만듭니다.
TranformPart 객체에 n 계열이 있는 경우 n이 홀수이면 타임 스탬프의 (n / 2 + 1) 값이 중앙값입니다. n이 짝수이면 타임 스탬프에 대한 (n / 2) 및 (n / 2 + 1) 값의 평균이 중앙값입니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - 메트릭(문자열 메트릭)
변환에 사용할 메트릭 필드를 지정합니다.
변환에 사용할 여러 메트릭을 지정할 수 있습니다. 변환이 실행된 후에는 metric() 메서드를 호출할 수 없습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 메트릭 | 문자열 | 메트릭 필드의 이름입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
파트 변환 - min()
각 타임 스탬프에 대한 최소값을 포함한 계열을 반환합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - mul(숫자 상수)
각 타임 스탬프의 값에 지정된 숫자를 곱합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 상수 | 번호 | 각 타임 스탬프의 값을 곱할 숫자입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - partition(문자열 집계, GlideDateTime 기간, GlideDateTime 기본)
계열을 동일한 기간의 간격으로 분할합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 집계기 | 문자열 | 사용할 집계기입니다. 최소, 최대, 평균 또는 마지막일 수 있습니다. |
| 기간 | GlideDateTime 또는 ISO 8601 형식의 문자열 | 간격 길이입니다. |
| 기본 | GlideDateTime 또는 ISO 8601 형식의 문자열 | 파티셔닝에 대한 0 오프셋입니다. 예를 들어 일(24시간)별로 분할하는 경우 기준을 시간대의 월요일 자정으로 설정합니다. 30일로 분할하는 경우 기준을 최근 달의 1일로 설정합니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - resample(Number count)
결과에 포함할 데이터 요소 수를 지정합니다.
지정된 범위의 고정된 수의 데이터 요소와 계열을 맞춥니다. 원래 계열에 지정된 것보다 많은 데이터 요소가 있는 경우 여러 값이 평균화됩니다. 원래 계열의 데이터 요소가 지정된 것보다 적으면 기존 데이터 요소 사이에 데이터 요소를 보간하여 데이터 요소를 추가합니다.
resample() 메서드를 사용하여 결과의 샘플 수를 줄여 표시할 샘플 수와 더 근접하게 일치시킬 수 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 카운트 | 번호 | 결과에 포함할 샘플 수입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - resample(최소값, 최대값)
결과에 포함할 샘플의 최소 및 최대 개수를 지정합니다.
이 방법은 기간(세분성)이 다른 계열을 표시할 때 유용합니다.
이 메서드는 계열당 평균 포인트 수를 결정하고, 지정된 최소값과 최대값 사이에 맞는 경우 각 계열을 해당 평균 포인트 수로 다시 샘플링합니다. 계산된 평균이 지정된 최대값보다 크거나 지정된 최소값보다 작으면 지정된 최대값 또는 최소값이 사용됩니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 최소 | 번호 | 결과에 포함할 최소 샘플 수입니다. 사용할 수 있는 샘플이 충분하지 않은 경우 보간을 사용하여 샘플을 만듭니다. |
| 최대 | 번호 | 결과에 포함할 샘플의 최대 개수입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - resample(String aggregator, Number numValues)
지정된 크기의 결과 세트를 생성하는 데 사용할 집계기를 지정합니다. 집계기는 LAST, AVG, MIN 또는 MAX일 수 있습니다.
resample() 메서드를 사용하여 결과의 샘플 수를 줄여 표시할 샘플 수와 더 근접하게 일치시킬 수 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 집계기 | 문자열 | LAST, AVG, MIN 또는 MAX일 수 있습니다. |
| 숫자 값 | 번호 | 결과 집합에 포함할 샘플 수입니다. 요청된 값의 수가 요청된 기간 동안의 데이터의 값 수보다 크면 interpolate()를 사용하여 기존 지점 사이에 값을 추가하여 요청된 값 수에 도달합니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - resample(String aggregator, GlideDuration duration)
지정된 기간 동안 결과 세트를 작성하는 데 사용할 집계기를 지정합니다. 집계기는 LAST, AVG, MIN 또는 MAX일 수 있습니다.
- 시계열이 1분 간격으로 저장되고
resample(AVG, new GlideDuration("1:00"))이 호출되면 결과에는 이전 60개 값의 평균을 반영하는 매시간 하나의 데이터 요소가 있습니다. - 요청된 기간이 데이터 기간보다 작으면 보간을 사용하여 중간 데이터 요소를 계산합니다.
resample() 메서드를 사용하여 결과의 샘플 수를 줄여 표시할 샘플 수와 더 근접하게 일치시킬 수 있습니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 집계기 | 문자열 | LAST, AVG, MIN 또는 MAX일 수 있습니다. |
| 기간 | GlideDuration | 결과 세트의 기간입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - round(숫자 정밀도)
각 타임 스탬프의 값을 지정된 정밀도로 반올림합니다.
(v / precision) * precision| 이름 | 유형 | 설명 |
|---|---|---|
| 정밀도 | 번호 | 반올림 계산에 사용할 값입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - stddev()
계열 집합의 각 타임 스탬프에 대한 값의 표준 편차를 포함하는 계열을 생성합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - sub(객체 상수)
각 타임 스탬프의 값에서 지정된 숫자를 뺍니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 상수 | 객체 | 각 타임 스탬프의 값에서 뺄 숫자입니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - sum()
선택한 메트릭 계열을 각 타임 스탬프에 대한 모든 값의 합계를 포함하는 하나의 계열로 집계합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 안 함 |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |
TransformPart - top(숫자 수)
각 타임 스탬프에 대해 지정된 수의 상위 값을 반환하는 결과 세트를 작성합니다. 이 방법을 사용하면 계열 수가 "카운트"가 발생합니다. 각 값은 소스 계열의 레이블을 유지합니다.
| 이름 | 유형 | 설명 |
|---|---|---|
| 카운트 | 번호 | 반환할 계열 수입니다. 계열에는 카운트 - 1에 0 레이블이 붙습니다. |
| 유형 | 설명 |
|---|---|
| 파트 변환 | 변환 특성을 지정하는 데 사용할 수 있는 TransformPart 객체입니다. |