데이터 열 매핑 설계기
다른 시스템이 요구하는 열 구조에 맞춰 표를 준비하세요. 목표 필드를 만들고 이름으로 원본 열을 연결한 뒤 변환 방법과 자료형을 명시적으로 선택합니다. 실행하면 정상 출력과 수정이 필요한 행을 구분하고, 전체 보고서에는 파싱한 원본 셀도 남깁니다. 데이터베이스 연결이나 임의 스크립트 실행 없이 이 페이지에서 처리합니다.
주요 기능
- 원본 열 복사·고정 텍스트·순서대로 열 결합·첫 빈값 아닌 열 선택의 네 가지 매핑
- 문자열·안전 정수·정확한 소수 문자열·불리언·그레고리력 날짜 목표 자료형
- 명시적인 공백 제거·대소문자·빈값 기본값·필수값 검사
- 논리적 CSV 레코드 번호와 필드별 오류, 원본을 보존한 전체 JSON 보고서
- 재사용할 매핑 JSON과 정상 출력·제외 원본을 구분한 CSV 다운로드
사용 방법
- CSV를 붙여넣거나 UTF-8 CSV/TSV 파일을 선택하고 구분자를 지정해 표를 읽습니다.
- 초기 원본 열 필드를 사용하거나 목표 필드를 추가하고 이름·자료형·매핑 방법을 선택합니다.
- 원본 참조 순서, 공백 제거, 대소문자, 필수값, 필요한 빈값 기본값을 설정합니다.
- 매핑을 실행하고 정상·오류 레코드를 확인합니다. 입력이나 규칙을 바꾸면 이전 결과가 지워집니다.
- 매핑 명세, 정상 출력 전체, 제외 원본 전체 또는 모든 행이 담긴 JSON 보고서를 저장합니다.
활용 예시
- 문자열 ID의 앞자리 0을 유지하면서 이름과 성 열을 full_name으로 결합
- 우선 연락처가 지정한 공백 규칙에 따라 비었을 때만 대체 연락처 선택
- 다른 시스템에 가져오기 전에 잘못된 날짜와 숫자가 있는 행 분리
- 열 순서가 달라진 파일에도 같은 이름 기반 매핑 명세 재사용
자주 묻는 질문
JSON CSV 변환기나 표 정리 도구와 무엇이 다른가요?
JSON CSV 변환기는 직렬화 형식·평탄화·자료형 추론을 바꾸고, 표 정리 도구는 기존 표에 정리 작업을 순서대로 적용합니다. 이 도구는 별도의 목표 열 구조와 순서를 정의하고 각 필드에 원본을 연결한 뒤, 필수값·자료형 오류를 보고하고 정상 행만 출력합니다.
변환과 기본값은 어떤 순서로 적용되나요?
선택한 식이 원본 셀만 읽은 다음 선택적 앞뒤 공백 제거와 대소문자 변환을 수행합니다. 그 결과가 비었을 때만 기본값을 적용하며 기본값도 같은 변환을 거칩니다. 마지막으로 필수값과 자료형을 검사합니다. 비어 있지 않은 잘못된 값은 기본값으로 숨기지 않고 오류로 남깁니다. 첫 빈값 아닌 열 선택은 공백 제거 설정에 따라 후보를 살펴봅니다.
숫자·불리언·날짜는 어떻게 검사하나요?
정수는 부호가 있는 정수 자릿수를 JSON 안전 정수 범위에서 받습니다. 소수는 정수부 최대 18자리·소수부 12자리이며 지수나 천 단위 구분자 없이 정확한 정규 문자열로 반환합니다. 불리언은 선택한 변환 후 true 또는 false여야 합니다. 날짜는 0001~9999년의 실제 그레고리력 YYYY-MM-DD여야 합니다.
다운로드에는 어떤 행이 들어가나요? 값이 사라지지는 않나요?
정상 출력 CSV에는 오류가 전혀 없는 모든 행이 목표 필드 순서대로 담깁니다. 제외 CSV에는 모든 오류 행의 파싱된 원본 셀과 오류 상세가 들어갑니다. 전체 JSON에는 양쪽 행·변환값·원본·규칙이 모두 남습니다. 화면 필터나 25행 페이지는 다운로드를 제한하지 않습니다. 선택 사항인 빈값은 JSON의 null과 CSV의 빈칸으로 바뀌므로, 구분과 원본이 필요하면 전체 보고서를 보관하세요.
매핑을 다시 사용할 수 있나요? 어떤 JSON을 받나요?
column-mapping-v1 명세는 위치 대신 정확한 헤더 이름을 연결합니다. 참조 열이 없으면 실행을 중단합니다. 고유한 목표 필드 1~32개, 결합·첫 빈값 아닌 열의 순서 있는 참조 1~8개를 지원하며 같은 열을 반복할 수 있습니다. 알 수 없는 속성·이스케이프를 푼 뒤 중복되는 JSON 키·미지원 식·64 KiB 초과 명세는 거부합니다. JavaScript를 실행하는 명세가 아닙니다.
용량 제한과 CSV 저장 규칙은 무엇인가요?
입력은 1 MiB·5,000행·32열·데이터 100,000셀까지입니다. 전체 보고서는 8 MiB·오류 9,000개까지이며 초과하면 부분 결과 없이 실행 전체를 중단합니다. CSV는 UTF-8 BOM·인용부호·CRLF를 쓰고 수식처럼 보이는 문자열 셀 앞에 작은따옴표를 붙입니다. JSON 원문은 바꾸지 않습니다. 스프레드시트가 자료형을 다시 추론할 수 있으므로 ID와 정확한 소수 열은 텍스트로 가져오세요.
개인정보 안내
원본 셀·매핑 규칙·보고서는 이 페이지 메모리에만 머뭅니다. 이 도구는 내용을 업로드하거나 브라우저 저장소·URL에 저장하지 않습니다. 필요한 명세는 페이지를 떠나기 전에 내려받으세요. 전체 보고서와 제외 행 파일에는 원본 값이 포함되며 명세에도 고정값·기본값이 들어갈 수 있습니다. 취소나 새 입력은 이전 결과의 반영을 막지만, 이미 시작된 운영체제 파일 읽기 자체는 끝까지 진행될 수 있습니다.
댓글과 질문