컬럼 변환¶

컬럼 변환 스킬은 데이터의 컬럼 구조를 변환합니다. 컬럼 선택, 이름 변경, 타입 변환, 분할, 병합, 순서 변경을 지원합니다.

설정 방법¶

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

스킬 노드를 추가하고 우측 패널에서 컬럼 변환을 선택합니다.

2. 파라미터 입력¶

설정 탭에서 데이터(이전 노드의 테이블 데이터)와 변환 작업 목록을 입력합니다.

파라미터¶

파라미터	필수	설명
data	O	테이블 데이터 (TabularData)
operations	O	변환 작업 목록 (순서대로 적용)

변환 타입¶

select — 컬럼 선택¶

필요한 컬럼만 선택합니다.

{"type": "select", "columns": ["이름", "이메일", "전화번호"]}

rename — 이름 변경¶

{"type": "rename", "old_name": "phone", "new_name": "전화번호"}

convert_type — 타입 변환¶

{"type": "convert_type", "column": "나이", "target_type": "int", "on_error": "null"}

지원 타입: str, int, float, bool

on_error: null(기본), skip, raise

split — 컬럼 분할¶

하나의 컬럼을 구분자로 분할합니다.

{"type": "split", "column": "주소", "separator": " ", "new_columns": ["시", "구", "동"]}

merge — 컬럼 병합¶

여러 컬럼을 하나로 합칩니다.

{"type": "merge", "source_columns": ["성", "이름"], "target_column": "전체이름", "separator": ""}

reorder — 순서 변경¶

{"type": "reorder", "column_order": ["id", "이름", "이메일", "가입일"]}

출력¶

{
  "success": true,
  "data": {
    "rows": [{"id": 1, "전체이름": "홍길동", "이메일": "hong@example.com"}],
    "columns": ["id", "전체이름", "이메일"],
    "row_count": 1
  },
  "metadata": {
    "operations_applied": 3,
    "original_columns": ["id", "성", "이름", "email", "phone"],
    "result_columns": ["id", "전체이름", "이메일"]
  }
}

사용 예시¶

데이터 정리 파이프라인¶

여러 변환을 순서대로 적용:

[
  {"type": "rename", "old_name": "email", "new_name": "이메일"},
  {"type": "merge", "source_columns": ["성", "이름"], "target_column": "전체이름", "separator": ""},
  {"type": "select", "columns": ["id", "전체이름", "이메일"]}
]

참고¶

변환 작업은 배열 순서대로 순차 적용됩니다.
select를 마지막에 사용하면 최종 출력 컬럼을 깔끔하게 정리할 수 있습니다.
타입 변환 실패 시 on_error 설정에 따라 null 처리, 건너뜀, 또는 에러를 발생시킵니다.