수식 계산¶

수식 계산 스킬은 데이터에 수식을 적용하여 새로운 컬럼을 생성합니다. 산술 연산, 조건식, 함수를 지원합니다.

설정 방법¶

1. 스킬 노드 추가 및 선택¶

스킬 노드를 추가하고 우측 패널에서 수식 계산을 선택합니다.

2. 파라미터 입력¶

설정 탭에서 데이터(이전 노드의 테이블 데이터)와 수식 정의를 입력합니다.

파라미터¶

파라미터	필수	설명
data	O	테이블 데이터 (TabularData)
formulas	O	수식 정의 목록 (아래 참조)

수식 정의¶

{
  "expression": "매출 - 비용",
  "output_column": "이익",
  "type": "simple",
  "null_handling": "zero"
}

항목	설명
expression	수식 (컬럼명 참조)
output_column	결과를 저장할 새 컬럼명
type	`simple` 또는 `python` (기본: simple)
null_handling	`zero` (0으로 대체), `empty` (건너뜀), `error` — 기본: zero

지원 연산¶

산술 연산자¶

+, -, *, /, //(정수 나눗셈), %(나머지), **(거듭제곱)

비교 및 조건¶

매출 - 비용 if 매출 > 비용 else 0

함수¶

함수	설명
`SUM(A, B, C)`	합계
`AVG(A, B)` 또는 `AVERAGE(A, B)`	평균
`MIN(A, B)`, `MAX(A, B)`	최솟값, 최댓값
`ROUND(A, 2)`	반올림
`ABS(A)`	절대값
`SQRT(A)`	제곱근
`COUNT(A, B, C)`	개수

출력¶

{
  "success": true,
  "data": {
    "rows": [
      {"매출": 100000, "비용": 60000, "이익": 40000},
      {"매출": 80000, "비용": 50000, "이익": 30000}
    ],
    "columns": ["매출", "비용", "이익"],
    "row_count": 2,
    "metadata": {
      "formulas_applied": 1,
      "added_columns": ["이익"]
    }
  }
}

사용 예시¶

매출 이익률 계산¶

수식:

[
  {"expression": "매출 - 비용", "output_column": "이익"},
  {"expression": "ROUND((매출 - 비용) / 매출 * 100, 1)", "output_column": "이익률(%)"}
]

참고¶

수식은 AST 기반으로 안전하게 평가됩니다 (exec/eval 미사용).
null_handling: zero로 설정하면 NULL 값을 0으로 처리합니다.
Excel 스타일 함수명(SUM, AVG, ROUND 등)을 지원합니다.