데이터 열 매핑 설계기

데이터 열 매핑 설계기

CSV 열을 이름으로 연결해 목표 표를 만드세요. 각 목표 필드에 변환 방법과 검증 규칙을 설정합니다.

UTF-8 입력 1 MiB ·5,000행 ·32열 ·100,000셀. 목표 32필드 ·명세 64 KiB ·전체 보고서 8 MiB ·오류 9,000개. 문자 제한은 UTF-16 코드 단위 기준입니다.

1. 원본 표 읽기

2. 목표 열 구조 정하기

각 필드는 원본을 독립적으로 읽고, 필드 순서가 출력 열 순서가 됩니다. 규칙을 수정하면 이전 결과가 지워집니다. 열 이름은 대소문자를 포함해 정확히 비교하며 유니코드 정규화는 하지 않습니다.

처리 순서: 식 → 선택적 공백 제거 → 대소문자 → 비었을 때만 기본값 → 필수값·자료형 검사. 선택 사항인 빈값은 null입니다. 소수는 정수부 18/소수부 12자리의 정확한 문자열, 정수는 안전 정수 범위입니다. 불리언 true/false, 날짜는 실제 YYYY-MM-DD(0001~9999년)를 받습니다.

목표 필드
저장한 매핑 가져오기

검증을 통과한 뒤에만 현재 목표 필드를 대체합니다. 실패·취소 시 명세는 유지됩니다. JSON 편집은 이전 결과를 지우지만 ‘매핑 가져오기’를 눌러야 적용됩니다. 명세에는 고정값·기본값의 원문이 들어갈 수 있습니다.

원본 표를 읽거나 예제를 불러오세요.

댓글과 질문

데이터 열 매핑 설계기

다른 시스템이 요구하는 열 구조에 맞춰 표를 준비하세요. 목표 필드를 만들고 이름으로 원본 열을 연결한 뒤 변환 방법과 자료형을 명시적으로 선택합니다. 실행하면 정상 출력과 수정이 필요한 행을 구분하고, 전체 보고서에는 파싱한 원본 셀도 남깁니다. 데이터베이스 연결이나 임의 스크립트 실행 없이 이 페이지에서 처리합니다.

주요 기능

  • 원본 열 복사·고정 텍스트·순서대로 열 결합·첫 빈값 아닌 열 선택의 네 가지 매핑
  • 문자열·안전 정수·정확한 소수 문자열·불리언·그레고리력 날짜 목표 자료형
  • 명시적인 공백 제거·대소문자·빈값 기본값·필수값 검사
  • 논리적 CSV 레코드 번호와 필드별 오류, 원본을 보존한 전체 JSON 보고서
  • 재사용할 매핑 JSON과 정상 출력·제외 원본을 구분한 CSV 다운로드

사용 방법

  1. CSV를 붙여넣거나 UTF-8 CSV/TSV 파일을 선택하고 구분자를 지정해 표를 읽습니다.
  2. 초기 원본 열 필드를 사용하거나 목표 필드를 추가하고 이름·자료형·매핑 방법을 선택합니다.
  3. 원본 참조 순서, 공백 제거, 대소문자, 필수값, 필요한 빈값 기본값을 설정합니다.
  4. 매핑을 실행하고 정상·오류 레코드를 확인합니다. 입력이나 규칙을 바꾸면 이전 결과가 지워집니다.
  5. 매핑 명세, 정상 출력 전체, 제외 원본 전체 또는 모든 행이 담긴 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에 저장하지 않습니다. 필요한 명세는 페이지를 떠나기 전에 내려받으세요. 전체 보고서와 제외 행 파일에는 원본 값이 포함되며 명세에도 고정값·기본값이 들어갈 수 있습니다. 취소나 새 입력은 이전 결과의 반영을 막지만, 이미 시작된 운영체제 파일 읽기 자체는 끝까지 진행될 수 있습니다.

관련 도구

JSON CSV 변환문자열 찾기·바꾸기JSON 포맷터WebAssembly 모듈 검사기다국어 연결 행렬 검사기구문 트리 질의 실험실컨테이너 빌드 단계 분석기의존성 그래프 탐색기버전 제약 충돌 분석기작업 스케줄 충돌 검사기패치 검토 작업대소스맵 탐색기다국어 카탈로그 검사기구조화 데이터 대조기HTTP 아카이브 분석기웹훅 서명 실험실Protobuf 스키마 작업대GraphQL 스키마 실험실Avro 스키마 호환성 검사기로컬 SQL 데이터 작업대스키마 기반 입력 폼 생성기3D 메쉬 검사·복구기관망 유량·압력 실험실로봇팔 운동학 실험열저항 회로 실험실보 휨 실험실기어열 배치 실험공차 누적 실험실센서 교정 곡선 맞추기PCB 적층 비교 설계기디지털 필터 설계기도로망 도달 범위 지도태양 그림자 배치 실험GPS 오차 시뮬레이터디지털 논리 회로 실험아날로그 회로 실험실링크 기구 운동 실험해석용 메쉬 생성기OpenAPI 계약 검사기DB 스키마 변경 계획기수식 차원 검사기트러스 힘 실험실논리식 최소화 실험실제어계 응답 실험실대기행렬 시뮬레이터위치 구역 출입 이벤트 실험실좌표계 변환 실험실측량 폐합 검산 실험실위성·래스터 구간 분류단계구분도 설계기지도 인쇄 편집기GeoTIFF 래스터 재투영고도 등고선 생성기지형 가시영역 실험실지형 유역 탐색기오프라인 지도 타일 패키저텍스트 파일 인코딩 작업대파일 경로 호환성 검사기SBOM 라이선스 탐색기파일 형식 위장 검사기npm 잠금 파일 충돌 해결기소스 비밀값 점검기오프라인 웹 자료 패키저인증서 체인 검사기토렌트 메타정보 검사기파일 분할 전송 패키저로컬 파일 암호 금고동일 파일 찾기압축 파일 작업대디자인 토큰 관리기반응형 간격 체계 설계기반응형 타이포 시스템 설계기포장 전개도 설계기SVG 아이콘 스프라이트 묶기Flexbox 배치 설계기CSS Grid 배치 설계기정규 언어 동치 검사기Markdown 문서 묶음 검사기로그 패턴 추출기반응형 HTML 레이아웃 검사기메일 HTML 렌더 검토기내부 링크 구조 분석기상태 전이 모델 테스트 생성기페트리넷 흐름 실험Git 이력 그래프 탐색기HTTP 요청 명령 설계기바이너리 프로토콜 설계기바이너리 Hex 편집기바이너리 차이 패치 만들기파일 전자서명 작업대API 모의 응답 실험실이벤트 로그 세션 분석기데이터베이스 관계도 설계기시계열 누락 검사기학습 데이터 분할기데이터 흐름 계보 작성기결정트리 학습 실험실데이터 비식별 처리기데이터 계약 규칙 검사기JSON Schema 검증기항목 동시출현 분석기robots 규칙 시뮬레이터HTML 검색 기본 검사기접근성 구조 검사기RSS·Atom 피드 작성기IndexNow 배포 알림 준비기검색 로봇 로그 분석기CSP 정책 검토기검색 실적 CSV 분석기CSV 수식 위험 검사기CORS 응답 시뮬레이터HTTP 캐시 동작 실험실쿠키 속성 검사기성능 추적 파일 분석기사이트맵 구조 검사기파일 일괄 이름 바꾸기파일 묶음 무결성 검증기폴더 용량 지도폴더 차이 검토기방문 순서 최적화GeoJSON 지도 편집기지도 영역 중첩 분석기지도 라벨 배치기공간 속성 결합기GeoJSON 공간 위상 검사기GPS 이동 기록 분석기이동 기록 위치 가림표 관계 결합기피벗 테이블 작업대데이터 품질 프로파일러표 데이터 정제 작업대기록 대사 도구데이터 사전 작성기canonical 관계 검사기리다이렉트 계획 검증기HTTP 응답 속도·핑 참고 테스트내 브라우저·시스템 정보JSON ↔ YAML 변환기XML ↔ JSON 변환기HTML 포맷터JavaScript 압축기목 데이터 생성기.gitignore 생성기라이선스 생성기User-Agent 분석기비밀번호 강도 검사코드 이미지 만들기XML 포맷터HTTP 상태 코드 찾기MIME 타입 찾기JS·SQL 문자열 이스케이프CSS 박스 그림자 생성기CSS 그라데이션 생성기들여쓰기 변환기진법 변환기유니코드 이스케이프 변환기유니코드 문자 분석기JSON 구조 비교기Markdown 표 생성기Base64 인코더URL 인코더SQL 포맷터Cron 표현식 생성기정규식 테스터UUID 생성기해시 생성기타임스탬프 변환기JWT 디코더HTML 엔티티 변환기Markdown 미리보기CSS Minifier메타태그·OG 생성기대소문자·케이스 변환이미지 Base64 변환
개발 도구 도구 전체 보기 →이미지/미디어 →텍스트/변환 →생활/재미 →