브라우저 기반 로컬 테이블 파일 변환
CSV / JSON / Excel 변환기는 사용자의 장치에 있는 CSV, JSON, XLSX 형식의 테이블 파일을 다른 형식으로 변환하는 도구입니다. 변환하고자 하는 파일을 선택하거나 드래그 앤 드롭하여 도구에 입력한 후, 원하는 출력 형식과 CSV 구분 기호를 지정하면 변환이 수행됩니다. 변환이 완료되면 결과 미리보기와 함께 행 수, 열 수, 출력 크기 정보가 표시되며 새 파일을 다운로드할 수 있습니다.
이 도구는 한 번에 하나의 파일만 처리하며, 너무 큰 파일은 변환할 수 없습니다. 변환 과정에서 입력 형식은 업로드된 파일로부터 자동으로 감지됩니다.
데이터 프라이버시와 클라이언트 사이드 처리
이 도구를 사용할 때 테이블 파일 변환 작업은 브라우저 내에서 처리됩니다. CSV, JSON, XLSX 파일은 사용자의 브라우저 내에서 파싱되며, 다운로드 파일 또한 로컬에서 생성됩니다. BroBroGo 서버로 어떠한 데이터도 전송되지 않습니다. 따라서 외부 서버로 데이터를 업로드하지 않고 공통 형식 간에 테이블 데이터를 변환하려는 사용자에게 적합합니다.
파일 형식별 데이터 표현과 변환 규칙
테이블 데이터를 표현하는 방식은 파일 형식마다 다릅니다. 이 도구는 각 형식의 특성에 맞춰 다음과 같은 규칙으로 데이터를 변환합니다.
- Excel 파일 변환 제한: Excel 파일(XLSX)을 변환할 때는 첫 번째 워크시트의 화면에 보이는 값만 테이블로 변환합니다. 수식을 계산하거나 셀 스타일을 보존하지는 않습니다.
- JSON 구조의 평탄화: JSON 데이터를 테이블 구조로 변환할 때, 객체 배열은 행으로 변환되고 객체의 키는 열로 변환됩니다. 중첩된 객체 키는 점 경로(dot path)를 사용하여 평탄화(flatten)됩니다. 배열의 배열 구조는 테이블 행으로 그대로 유지됩니다.
- CSV 구분 기호 지정: CSV 파일로 변환할 때 사용자는 쉼표 (,), 세미콜론 (;), 탭 (Tab) 중에서 CSV 구분 기호를 직접 지정할 수 있습니다.
변환 중 발생할 수 있는 오류 상황
파일 상태나 데이터 구조에 따라 다음과 같은 오류 메시지가 표시되며 변환이 중단될 수 있습니다.
- 파일을 선택하지 않고 변환을 시도할 때: "먼저 파일을 하나 선택해 주세요."
- 지원하지 않는 확장자일 때: "CSV, JSON 또는 XLSX 파일을 선택해 주세요."
- 파일 용량이 제한을 초과할 때: "파일이 너무 큽니다.
{max}이하의 파일을 사용해 주세요." - 입력과 출력이 동일한 형식일 때: "다른 출력 형식을 선택해 주세요."
- 파일 손상 등으로 처리가 불가능할 때: "이 파일을 변환할 수 없습니다."
- CSV 구문 분석에 실패할 때: "이 CSV를 파싱할 수 없습니다."
- JSON 형식이 잘못되었거나 테이블 형태가 아닐 때: "이 JSON은 올바르지 않거나 테이블 구조가 아닙니다."
- Excel 파일을 읽을 수 없을 때: "이 Excel 파일을 열 수 없습니다."
- 테이블에 데이터가 없을 때: "이 파일에는 테이블 행 데이터가 없습니다."
- 행 제한을 초과할 때: "이 테이블은 행이
{max}개를 초과합니다." - 열 제한을 초과할 때: "이 테이블은 열이
{max}개를 초과합니다." - 사용자가 작업을 중단했을 때: "변환이 취소되었습니다."
- 처리 시간이 너무 길어질 때: "변환 작업이 너무 오래 걸립니다. 더 작은 파일로 시도해 주세요."
자주 묻는 질문 (FAQ)
Q. 제 스프레드시트 파일이 업로드되나요? A. 아닙니다. CSV, JSON, XLSX 파일은 사용자의 브라우저 내에서 파싱되며, 다운로드 파일 또한 로컬에서 생성됩니다.
Q. Excel 수식과 서식도 그대로 유지되나요? A. 아닙니다. 이 도구는 첫 번째 워크시트의 화면에 보이는 값만 깔끔한 테이블로 변환합니다. 수식을 계산하거나 셀 스타일을 보존하지는 않습니다.
Q. JSON은 어떤 방식으로 테이블로 변환되나요? A. 객체 배열은 행으로, 객체의 키는 열로 변환되며, 중첩된 객체 키는 점 경로(dot path)를 사용하여 평탄화(flatten)됩니다. 배열의 배열 구조는 테이블 행으로 그대로 유지됩니다.