본문 바로가기

CSV 규칙 검사기

브라우저 처리

CSV 열마다 required, unique, email, integer, date, min=, max=, in= 같은 규칙을 적어 어긋난 값을 '3행 email: 이메일 형식이 아님'처럼 행 번호와 함께 찾아냅니다.

사용 전 확인
  • 파일·이미지·문서 처리 도구는 브라우저 안에서 처리되더라도 원본에 개인정보나 민감 정보가 포함될 수 있습니다. 공유·제출 전 원본과 결과를 한 번 더 확인하세요.
도구 실행입력 후 결과 확인
CSV 규칙 검사기 샘플 실행

회원 가입 일괄 등록이나 상품 대량 업로드처럼 CSV를 시스템에 올리기 전에, 열마다 지켜야 할 조건을 적어 두고 어긋난 행을 한 번에 찾는 도구입니다. 규칙은 '열 이름:규칙|규칙' 형식으로 한 줄에 하나씩 또는 ;로 나눠 적습니다.

브라우저 처리
샘플 결과
3행 email: 이메일 형식이 아님
3행 age: 18보다 작음
4행 id: 3행과 중복
4행 age: 필수 값이 비어 있음
자바스크립트가 활성화되면 이 영역이 실제 입력, 실행, 결과 패널로 바뀝니다.

CSV 규칙 검사기 사용 가이드

회원 가입 일괄 등록이나 상품 대량 업로드처럼 CSV를 시스템에 올리기 전에, 열마다 지켜야 할 조건을 적어 두고 어긋난 행을 한 번에 찾는 도구입니다. 규칙은 '열 이름:규칙|규칙' 형식으로 한 줄에 하나씩 또는 ;로 나눠 적습니다.

쓸 수 있는 규칙은 required(필수), unique(중복 금지), email, integer(정수), number(숫자), date(YYYY-MM-DD, 실제 있는 날짜), min=와 max=(숫자 범위), minlen=과 maxlen=(글자 수), in=a,b(허용 값 목록)입니다. 빈 값은 required에서만 문제로 보고 나머지 규칙은 건너뜁니다.

결과는 '3행 age: 18보다 작음'처럼 CSV 파일의 실제 줄 번호(머리글이 1행)와 함께 나옵니다. 모든 행이 규칙을 지키면 '통과' 메시지가 나오고, 철자가 틀린 규칙이나 없는 열 이름은 검사 전에 바로 알려 줍니다.

사용 방법

  1. 'CSV' 칸에 검사할 데이터를 붙여 넣습니다.
  2. '규칙' 칸에 'email:required|email', 'age:number|min=18'처럼 열마다 규칙을 적습니다.
  3. '실행'을 누르면 어긋난 값이 행 번호 순으로 나오고, 문제가 없으면 통과 메시지가 나옵니다.

예시: 회원 일괄 등록 전 검사

입력
id,email,age
1,[email protected],20
2,bad,17
2,[email protected],
---
id:required|unique; email:required|email; age:required|number|min=18
결과
3행 email: 이메일 형식이 아님
3행 age: 18보다 작음
4행 id: 3행과 중복
4행 age: 필수 값이 비어 있음

행 번호는 머리글을 1행으로 센 CSV 파일의 줄 번호입니다.

이럴 때 쓰면 좋아요

  • 쇼핑몰 상품 대량 등록 파일의 가격·재고 값이 범위 안인지 올리기 전에 확인할 때
  • 회원 일괄 가입 CSV에서 이메일 형식과 중복 ID를 찾을 때
  • 정해진 값만 와야 하는 상태 열(in=대기,완료,취소)에 오타가 있는지 볼 때
  • 매달 받는 정산 파일을 같은 규칙으로 반복 검사할 때

문제가 생겼을 때

'"requird" 규칙은 지원하지 않습니다' 오류

규칙 이름 철자가 틀렸습니다. 오류에 나온 지원 규칙 목록과 같은 철자로 고치세요.

in= 목록에 있는 값인데 위반으로 나옴

in= 비교는 대소문자까지 정확히 같아야 합니다. 'Pro'와 'pro'를 모두 허용하려면 in=pro,Pro처럼 둘 다 적으세요.

활용 팁

  • unique는 앞뒤 공백을 지운 값으로 비교하고, 위반 행에 '3행과 중복'처럼 처음 나온 행 번호를 함께 적어 줍니다.
  • 위반이 500건을 넘으면 앞의 500건과 남은 개수만 보여 줍니다. 같은 원인이 반복되는 경우가 많으니 앞부분부터 고쳐 보세요.

자주 묻는 질문

정규식 규칙도 쓸 수 있나요?

지원하지 않습니다. 규칙 구분에 쓰는 | 기호와 충돌하기 때문입니다. 형식 검사가 더 필요하면 정규식 테스터로 값을 따로 확인하세요.

integer와 number는 어떻게 다른가요?

number는 1.5 같은 소수도 통과하고, integer는 1이나 2.0처럼 정수인 값만 통과합니다. 둘 다 '12,000'처럼 쉼표가 든 값은 숫자로 보지 않습니다.

이메일 검사는 얼마나 엄격한가요?

공백 없이 '@'와 점이 들어간 기본 형태만 확인합니다. 실제로 받을 수 있는 주소인지는 확인하지 않습니다.