변환기 - 범위 지정, 전역

Transformer API는 시계열 데이터를 조작하여 평가 및 분석을 위한 데이터를 준비합니다.

범위가 지정된 스크립트 및 전역 서버 스크립트에서 이 API를 호출할 수 있습니다. Transformer 클래스를 사용하는 경우 sn_clotho 네임스페이스 식별자를 사용합니다.

일반적인 사용 사례는 평가할 기간을 결정하고, 메트릭 필드가 있는 테이블에서 기록을 선택하고, 실행할 변환 유형을 정의한 다음, 변환을 실행하는 것입니다.

// create the start and end time
       var start = new GlideDateTime();
	start.addSeconds(-1 * 60 * 60); 
	var end = new GlideDateTime();
	
	//mb_demo_drone is a table with metric fields. 
	var drones = new GlideRecord("mb_demo_drone");
	drones.addQuery("model", "Kingfisher Phantom");
	drones.query();

	//build a transform that returns a simple average
	var builder = new sn_clotho.Transformer(drones);
	builder.metric("mb_demo_mt_rem_battery").avg().label("Original");

	//execute transform and return result for visualization
	var result = builder.execute(start,end);

이 클래스는 애플리케이션의 일부입니다 MetricBase .

변환기 - 변환기(GlideRecord sourceRecords)

Transformer 객체를 생성합니다.

표 1. 매개변수

이름	유형	설명
소스 레코드	GlideRecord	메트릭을 평가할 기록이 포함되어 있습니다. 하나 또는 여러 개의 기록일 수 있습니다.

//where drones is a GlideRecord created from a table with a metric field
	var builder = new sn_clotho.Transformer(drones);

변환기 - execute(GlideDateTime start, GlideDateTime end)

변환을 실행합니다.

execute()를 호출하기 전에 metric() 및 groupBy() 메서드를 사용하십시오. execute() 메서드는 각 트랜스포머 객체에 대해 한 번만 호출할 수 있습니다.

변환의 일부로 수행되는 작업은 데이터베이스의 데이터를 MetricBase 변경하지 않습니다.

표 2. 매개변수

이름	유형	설명
시작	Glide날짜/시간	평가할 기간의 시작입니다.
끝	Glide날짜/시간	평가할 기간의 종료입니다.

표 3. 반환

유형	설명
변환 결과	변환된 데이터입니다.

var minutesAgoStart = 60;
	var end = new GlideDateTime();
	var start = new GlideDateTime(end);
	start.addSeconds(-1 * 60 * minutesAgoStart);
	
	// query subject records
	var grDrone = new GlideRecord('mb_demo_drone');
	grDrone.query();
	
	// building transform; get the average transforms of a metric, grouping by model
	var transformer = new sn_clotho.Transformer(grDrone);
	transformer.groupBy("fleet").metric("mb_demo_mt_altitude").avg().label('avg - %g:fleet:');

	// execute and return result for visualization
	var tfrmResult = transformer.execute(start, end);

변환기 - groupBy(String field)

데이터를 그룹화하는 데 사용할 필드를 지정합니다.

groupBy() 메서드를 사용하려면 execute() 메서드를 호출하기 전에 must를 호출해야 합니다.

표 4. 매개변수

이름	유형	설명
필드	문자열	변환 결과를 그룹화하는 데 사용할 테이블의 필드입니다.

표 5. 반환

유형	설명
변환 파트	변환 특성을 지정하는 데 사용할 수 있는 TransformPart 개체입니다.

var transformer = new sn_clotho.Transformer(grDrone);
var trnsfrm = transformer.groupBy("fleet");

변환기 - metric(String metricName)

변환에 사용할 메트릭 필드를 지정합니다.

변환에 사용할 여러 메트릭을 지정할 수 있습니다. execute() 메서드가 호출된 후에는 metric() 메서드를 호출할 수 없습니다.

표 6. 매개변수

이름	유형	설명
metricName	문자열	메트릭 필드의 이름입니다.

표 7. 반환

유형	설명
변환 파트	변환 특성을 지정하는 데 사용할 수 있는 TransformPart 개체입니다.

var transformer = new sn_clotho.Transformer(grDrone);
var trnsfrm = transformer.metric("mb_demo_mt_altitude");