CSV 뷰어

이 페이지는 DevUtilities CSV Viewer로 CSV를 미리 보는 정식 가이드입니다. 위에서 파일을 연 뒤 구분자/헤더, 정렬, 대용량 제한, 인코딩, JSON/CSV 전달 섹션을 사용하세요. 파싱은 브라우저에서 유지됩니다.

CSV Viewer는 쉼표로 구분된 값의 클라이언트 측 테이블 미리보기입니다. 첫 행을 헤더로 파싱하고 정렬 가능한 그리드를 렌더하며, ETL·JSON 변환·티켓 첨부 전에보내기를 검사할 수 있도록 전체 텍스트를 메모리에 유지합니다.

얻는 것

• FileReader(텍스트)로 파일 선택 / 드래그 앤 드롭
• RFC 4180 스타일 파싱: 쉼표, 따옴표 필드, 이스케이프된 따옴표
• 첫 행을 열 헤더로 취급
• 클릭 가능한 헤더 정렬(localeCompare, 오름/내림)
• 테이블 UI의 행·열 수
• 로컬 전용 — 스프레드시트 내용은 업로드되지 않음

이 뷰어를 사용할 때

• Excel 없이보내기를 빠르게 보고 싶을 때
• JSON/CSV 변환 전 헤더와 행 형태를 검증할 때
• 따옴표와 쉼표가보내기를 견뎠는지 확인할 때
• 고객·급여 CSV를 오프라인으로 유지해야 할 때

이 도구가 돕는 방법

1. 디스크에서 .csv를 엽니다.
2. 헤더 이름이 생산자 스키마와 일치하는지 확인합니다.
3. 행 수를 예상보내기 크기와 비교합니다.
4. 열 헤더를 클릭해 정렬하고 다시 클릭해 반전합니다.
5. 들쭉날쭉한 행이나 병합처럼 보이는 값을 스캔합니다.
6. 문자가 잘못 보이면(é, ’) 소스에서 인코딩을 고치고 다시 로드합니다.
7. 변환을 위해 CSV를 JSON ↔ CSV, Dev Toolkit Columns → JSON 또는 ETL로 복사합니다.

파서는 쉼표 구분입니다. 첫 번째 비어 있지 않은 논리 행이 헤더가 되고, 이후 각 행은 열 인덱스로 정렬된 데이터 행입니다.

감지되는 항목

• 필드 구분자로서의 쉼표 (,)
• 쉼표와 줄바꿈을 포함할 수 있는 큰따옴표 필드
• 따옴표 필드 안 이중 따옴표로 이스케이프 ("")
• CRLF 및 LF 행 종결자

자동 감지되지 않는 항목

• EU Excel보내기에 흔한 세미콜론(;) 또는 탭(\t) 구분자
• 별도 «헤더 있음» 토글 — 행 0은 항상 헤더
• 타입 추론(숫자/날짜는 그리드에서 문자열로 유지)

실무 팁

실무 팁

정렬은 셀 문자열에 대한 localeCompare 사전식입니다. 카테고리·ID 스캔에 적합하고 숫자 크기 순에는 적합하지 않습니다.

• 헤더 클릭으로 오름차순, 다시 클릭으로 내림차순
• 숫자 열은 텍스트로 정렬(«10»이 «2»보다 앞)
• 빈 셀은 빈 문자열; 들쭉날쭉한 행은 값이 시각적으로 밀릴 수 있음
• 새 파일을 로드하면 정렬 상태가 초기화됨
• 행 × 열 메타 줄로보내기 완전성 확인

벤더가 overnight.csv를 보냈습니다. 웨어하우스 작업에 넣기 전에 헤더, 행 수, 따옴표 안 쉼표가 필드를 쪼개지 않았는지 확인해야 합니다.

이 도구가 돕는 방법

1. 파일을 열고 계약 스키마에 맞춰 헤더 행을 읽습니다.
2. 표시된 행 수를 벤더 매니페스트와 비교합니다.
3. 키 열(order_id, email)을 정렬하고 빈칸·중복을 눈으로 찾습니다.
4. 의심 행의 셀을 엽니다 — 따옴표 주소 필드는 한 열에 있어야 합니다.
5. 형태가 틀리면 ETL 전에 파일을 거부하거나 재요청합니다.

결과: 파이프라인 실패 후가 아니라 미리보기에서 문제를 잡습니다.

API 목이나 LLM 도구 스키마용 객체가 필요하지만 진실의 원천은 여전히 CSV보내기입니다.

이 도구가 돕는 방법

1. CSV Viewer에서 헤더가 깨끗한지(빈 이름·중복 제목 없음) 확인합니다.
2. CSV 텍스트를 Dev Toolkit → Columns → JSON에 복사해 객체 배열을 만들거나 JSON ↔ CSV로 왕복합니다.
3. 목을 연결하기 전에 JSON Formatter에서 샘플 객체를 검증합니다.
4. CSV를 감사 산출물로 유지하고 정제된 샘플만 커밋합니다.

결과: 파이프라인 실패 후가 아니라 미리보기에서 문제를 잡습니다.

이름이 José로 보이거나 스마트 따옴표가 ’로 보입니다. 이해관계자는 데이터가 손상됐다고 생각합니다.

이 도구가 돕는 방법

1. 파일을 로드합니다 — FileReader는 브라우저 기본 텍스트 디코딩(보통 UTF-8)을 사용합니다.
2. 모지바케가 보이면 파일이 UTF-8로 잘못 라벨된 Windows-1252/Latin-1(또는 그 반대)일 가능성이 큽니다.
3. Excel/Sheets에서 CSV UTF-8로 다시보내거나 적절한 인코딩 도구로 변환합니다.
4. 다시 로드해 발음 구별 부호와 통화 기호가 올바른지 확인합니다.

결과: 파이프라인 실패 후가 아니라 미리보기에서 문제를 잡습니다.

전체 파일이 문자열로 유지되고 전체 인메모리 테이블로 파싱됩니다. 한도는 스트리밍 엔진이 아니라 탭 메모리입니다.

• 수백 MB CSV는 탭을 멈추거나 충돌시킬 수 있음 — 분할하거나 헤드 샘플을 먼저
• 정렬은 행 배열을 복사; 넓고 높은 테이블은 메모리를 키움
• 백만 행용 가상 무한 스크롤 없음 — DB 또는 CLI(csvkit, DuckDB) 사용
• 스팟 체크는 소스에서 처음 1–5k 행을보내기

증상: 일부 행의 셀이 적고, 값이 잘못된 헤더 아래에 있거나, 쉼표가 있는 필드가 추가 열로 쪼개집니다.

발생 이유

필드 안 따옴표 없는 쉼표, 맞지 않는 따옴표,보내기 중 잘린 행이 열 정렬을 깨뜨립니다. 세미콜론 파일을 쉼표로 파싱하면 한 열로 붕괴합니다.

진단

첫 번째 나쁜 행을 찾습니다. 주소/이름에 따옴표 없는 쉼표가 있는지 확인합니다. 파일이 세미콜론이 아니라 쉼표를 쓰는지 확인합니다.

수정

1. 올바른 따옴표로 다시보내기(Excel: CSV UTF-8; DB: FORCE QUOTE).
2. 열기 전에 세미콜론/TSV를 쉼표 구분으로 변환.
3. 문제 행의 불균형 따옴표를 수정.
4. 다시 로드해 샘플 행의 열 수가 헤더 길이와 일치하는지 확인.

증상: 악센트, 기호, CJK 텍스트가 라틴 쓰레기(Ã, Â, â€)로 렌더됩니다.

발생 이유

바이트가 잘못된 문자 집합으로 디코딩되었습니다. 이 뷰어는 브라우저를 통해 텍스트로 읽습니다(현대 CSV는 UTF-8 기대).

진단

인코딩을 보여주는 편집기에서 같은 파일을 엽니다. Windows-1252로는 맞고 여기서는 틀리면 UTF-8로 변환합니다.

수정

1. 스프레드시트나 BI 도구에서 CSV UTF-8로 다시 저장.
2. iconv 또는 전용 인코딩 변환기로 변환한 뒤 다시 로드.
3. 생산자가 파이프라인에서 UTF-8을 선언하도록 보장(특히 레거시 ERP).

인코딩은 소스에서 고치세요 — 정렬과 JSON 전달은 손상만 전파합니다.

CSV보내기에는 종종 PII, 급여, 고객 목록이 포함됩니다.

• 알 수 없는 «CSV 온라인» 사이트보다 로컬 미리보기 선호
• 그리드 스크린샷 공유 전 이메일/ID 제거 또는 해시
• 프로덕션 CSV를 공개 저장소에 커밋하지 말 것
• 나중에 스프레드시트에 붙여넣을 때 수식 주입(=, +, -) 주의