요약 집계
ssemworks-microservice-base.summarize데이터 변환집계
아이템을 그룹핑하고 합계·평균·개수 등으로 요약한다(피벗 유사).
기본 정보
| 항목 | 값 |
|---|---|
| 서비스 타입 | ssemworks-microservice-base.summarize |
| 표시 이름 | 요약 집계 |
| 카테고리 | 데이터 변환 |
| 그룹 | transform |
| 버전 | 1 |
입출력
- 입력: 메인(main)
- 출력: 메인(main)
파라미터
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 그룹 기준 필드 | fieldsToSplitBy | 문자열 | "" | 콤마로 구분된 그룹핑 기준 필드 목록 (비면 그룹 없이 전체 집계) |
| 집계할 필드 | fieldsToSummarize | 고정 컬렉션 | {} | — |
| 옵션 | options | 컬렉션 | {} | — |
집계할 필드 › 집계 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 집계 방식 | aggregation | 선택 | count | 집계 함수 선택지: 배열로 모으기( append) · 평균(average) · 문자열 연결(concatenate) · 개수(count) · 고유 개수(countUnique) · 최댓값(max) · 최솟값(min) · 합계(sum) |
| 필드 | field | 문자열 | "" | 집계 대상 필드명 (점 표기 지원) |
| 빈 값 포함 | includeEmpty | 불리언 | false | 빈 값(null/빈 문자열)도 집계에 포함할지 여부 표시 조건: aggregation = "append" 또는 "concatenate" 또는 "countUnique" 또는 "count" |
| 구분자 | separateBy | 선택 | , | 문자열 연결 시 사용할 구분자 (엔진은 'other' 값만 특수 처리하며, 그 외 값은 리터럴 구분자로 그대로 사용) 선택지: 콤마(,)( ,) · 사용자 지정(other)표시 조건: aggregation = "concatenate" |
| 사용자 지정 구분자 | customSeparator | 문자열 | "" | 구분자=사용자 지정일 때 사용할 구분자 문자열 표시 조건: aggregation = "concatenate", separateBy = "other" |
옵션 하위 필드
| 파라미터 | 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|---|
| 점 표기 비활성화 | disableDotNotation | 불리언 | false | 필드명의 점(.) 표기를 경로가 아닌 리터럴 키로 취급할지 여부 |
| 출력 형식 | outputFormat | 선택 | separateItems | 그룹별 결과를 여러 아이템으로 낼지, 중첩 객체 1건으로 낼지 선택지: 아이템별 분리( separateItems) · 단일 아이템(singleItem) |
| 빈 그룹 필드 건너뛰기 | skipEmptySplitFields | 불리언 | false | 그룹 기준 필드 값이 비어있는(숫자 제외) 아이템을 그룹핑에서 제외할지 여부 |
| 필드 없어도 계속 진행 | continueIfFieldNotFound | 불리언 | false | 집계 대상 필드가 어떤 아이템에도 없을 때 오류 대신 계속 진행할지 여부 |