JSON ⇔ CSV 변환기

JSON ⇔ CSV 변환기란 무엇인가요?

JSON ⇔ CSV 변환기는 웹 API 및 프로그래밍에서 흔히 사용되는 JSON 형식과 스프레드시트 소프트웨어 및 비즈니스 시스템에서 널리 사용되는 CSV 형식 간에 데이터를 변환하는 도구입니다.JSON은 객체와 배열을 사용하여 구조화된 데이터를 표현할 수 있는 반면, CSV는 행과 열로 구성된 간단한 표 형식으로, Excel이나 스프레드시트로 가져오기, 목록 데이터 검토, 다른 시스템으로의 데이터 전송에 매우 적합합니다.이 도구는 API에서 가져온 JSON을 CSV 파일로 저장하거나, CSV 목록 데이터를 JavaScript나 API에서 처리할 수 있는 JSON으로 변환하고자 할 때 사용할 수 있습니다.

JSON을 CSV로 변환할 때는 일반적으로 모두 동일한 유형의 필드를 포함하는 객체 배열을 제공합니다. 예를 들어, 이름, 가격, 재고와 같은 필드를 가진 여러 상품 객체가 포함된 JSON이 있다면, 각 키는 CSV의 열 머리글이 되고 각 객체는 별도의 행으로 출력됩니다. 특정 필드가 일부 행에만 존재하더라도 모든 키가 수집되어 열로 생성되며, 값이 없는 셀은 공백으로 처리됩니다. “점 표기법을 사용하여 중첩된 JSON 확장” 옵션을 활성화하면 중첩된 객체를 `address.city`와 같은 열 이름으로 확장할 수 있습니다.

CSV를 JSON으로 변환할 때는 첫 번째 행을 열 이름으로 간주하고, 두 번째 행부터 시작하여 각 행을 객체로 변환하십시오. CSV의 모든 값은 문자열로 표현되므로, "유형 추론"을 활성화하면 123을 숫자로, true와 false를 부울 값으로, null을 null로 변환할 수 있습니다.제품 코드나 우편번호처럼 선행 0이 중요한 데이터의 경우, 해당 값을 문자열로 유지해야 하므로 이러한 경우에는 유형 추론을 비활성화하는 것이 좋습니다.

CSV 구분 기호로는 쉼표뿐만 아니라 탭, 세미콜론, 파이프도 지원됩니다. 탭을 선택하면 해당 파일을 TSV로 사용할 수 있습니다.셀에 쉼표, 줄바꿈 또는 큰따옴표가 포함된 경우, 표준 CSV 규칙에 따라 데이터는 큰따옴표로 묶이며, 셀 내의 모든 큰따옴표는 출력 시 두 개로 처리됩니다. 이를 통해 시스템은 단순한 문자열 대체 방식으로는 손상되기 쉬운 텍스트나 설명이 포함된 데이터를 처리할 수 있습니다.

이 도구의 변환 과정은 자바스크립트를 사용하여 브라우저 내에서 수행되며, 변환을 위해 입력된 JSON 또는 CSV 파일을 서버로 업로드하지 않습니다. 고객 데이터나 내부 데이터를 처리할 때도 외부 서버로 데이터를 전송하지 않아도 됩니다. 다만, 공용 기기, 브라우저 확장 프로그램 및 기기 자체의 보안에 대해서는 별도로 주의해 주시기 바랍니다. 매우 대용량의 데이터 세트는 브라우저 메모리를 상당량 소모하므로, 필요에 따라 데이터를 분할해 주십시오.

주요 기능

• JSON 객체 배열을 CSV 또는 TSV로 변환할 수 있습니다.
• CSV 및 TSV 파일을 JSON 객체 배열로 변환할 수 있습니다.
• 쉼표, 탭, 세미콜론, 파이프 구분자를 지원합니다.
• 중첩된 JSON 객체를 점 표기법 열로 펼칠 수 있습니다.
• CSV를 JSON으로 변환할 때, 시스템은 숫자형, 부울형 및 null 값의 유형을 자동으로 추론할 수 있습니다.
• JSON의 서식 적용 여부를 전환할 수 있습니다.
• 결과를 복사하거나 CSV, TSV, JSON 파일로 저장할 수 있습니다.
• 입력된 데이터는 서버로 전송되지 않고 브라우저 내에서 처리됩니다. 리소스를 많이 소모하는 변환 작업은 웹 워커(Web Workers)를 사용하여 실행되며, 시스템은 처리 중에도 사용자 상호작용에 대한 방해를 최소화하도록 설계되었습니다.

JSON ⇔ CSV 변환기 사용 방법

1. "JSON → CSV" 또는 "CSV → JSON" 중에서 변환 방향을 선택하십시오.
2. 데이터를 입력란에 붙여넣거나 JSON, CSV, TSV 파일을 선택하십시오.
3. CSV 구분자, JSON 중첩 확장, CSV 값에 대한 유형 추론 등 필요한 설정을 선택하십시오.
4. "변환"을 클릭하면 결과가 표시됩니다. 결과 영역이 화면 밖으로 나간 경우, 자동으로 화면에 표시되도록 스크롤됩니다.
5. 내용을 검토한 후 "결과 복사" 또는 "다운로드"를 사용하십시오.
6. 대용량 데이터 세트를 처리할 때 기기의 부하를 줄이려면 "저부하 모드"를 활성화하십시오. 처리 중에는 진행률 표시기와 "처리 일시 중지" 버튼을 사용할 수 있습니다.
7. 반대 방향으로 변환하려면 "변환 방향 반전"을 사용하여 결과를 입력 쪽으로 이동시킨 후 변환을 계속하십시오.

사용 시 주의사항

• JSON → CSV는 표 형식으로 변환할 수 있는 데이터를 위한 것으로, 복잡한 계층적 배열을 완전히 표현할 수는 없습니다.
• CSV 유형 추론이 활성화된 경우, 00123과 같은 값은 숫자가 아닌 문자열로 처리되므로, 0으로 시작하는 값은 자동으로 문자열로 처리됩니다.
• CSV를 JSON으로 변환할 때는 첫 번째 행을 열 이름으로 사용하십시오. 중복된 열 이름은 뒤따르는 값으로 덮어쓰게 되므로, 열 이름이 고유하도록 확인해 주십시오.
• 대량의 데이터는 기기의 메모리 및 처리 시간에 영향을 미칠 수 있으므로, 파일 크기를 20MB 미만으로 유지하도록 해 주십시오.

JSON ⇔ CSV 변환기에 대한 자주 묻는 질문

CSV로 변환하려면 어떤 형식의 JSON을 입력해야 하나요?

일반적으로 객체 배열을 입력합니다. 단일 객체라도 CSV 데이터의 한 줄로 변환될 수 있습니다.

중첩된 JSON도 CSV로 변환할 수 있나요?

네. "점 표기법을 사용하여 중첩된 JSON 확장"을 활성화하면 address.city와 같은 열 이름으로 확장할 수 있습니다.

배열을 포함하는 JSON은 어떻게 처리되나요?

객체 내의 배열은 단일 CSV 셀에 들어갈 수 있도록 JSON 문자열로 출력됩니다. 복잡한 다차원 데이터의 구조는 미리 정리해 두는 것이 좋습니다.

CSV를 JSON으로 변환할 때 데이터가 숫자 값으로 변환되나요?

유형 추론이 활성화되면 일반적인 숫자 값, `true`, `false` 및 `null`은 각각의 JSON 유형으로 변환됩니다. 비활성화된 경우, 이들은 모두 문자열로 처리됩니다.

00123과 같이 앞자리에 0이 붙은 값은 그대로 유지할 수 있나요?

네. 유형 추론이 활성화된 경우에도, 앞자리에 0이 붙은 정수 형식의 값은 문자열로 저장되도록 보장합니다.

TSV도 지원하나요?

네. 구분자로 “Tab (TSV)”를 선택하면 JSON과 TSV 간에 변환할 수 있습니다.

셀 내에 쉼표나 줄 바꿈이 포함된 CSV 파일을 변환할 수 있나요?

CSV 규칙에 따라 데이터가 큰따옴표로 묶여 있는 한, 시스템은 셀 내의 쉼표, 줄 바꿈 및 큰따옴표를 파싱할 수 있습니다.

JSON 및 CSV 파일이 서버로 전송되나요?

아니요. 파일 로딩 및 변환은 브라우저 내의 자바스크립트를 통해 처리됩니다.

번역 결과를 파일로 저장할 수 있나요?

네. 변환 방향에 따라 .csv, .tsv 또는 .json 형식의 파일을 다운로드할 수 있습니다.

CSV 파일의 열 순서는 어떻게 결정되나요?

JSON에 나타나는 키를 첫 번째 객체부터 순서대로 수집하고, 새로운 키가 나타나면 그 끝에 추가하십시오.

CSV 파일의 첫 번째 행은 필수인가요?

CSV를 JSON으로 변환할 때 첫 번째 행이 JSON 키로 사용되므로, 열 이름이 포함된 헤더 행이 필요합니다.

Excel 파일을 직접 변환할 수 있나요?

이 도구는 JSON, CSV 및 TSV 파일을 지원합니다. .xlsx 파일은 사용하기 전에 CSV 파일로 저장해 주십시오.

대용량 파일을 처리할 때 브라우저 속도가 느려지면 어떻게 해야 하나요?

저부하 모드가 활성화되면 처리가 더 작은 단위로 분할되고, 각 단위 사이에 일시 정지 시간이 발생합니다. 또한, 변환 처리가 웹 워커에서 실행되므로 화면이 멈출 가능성이 줄어들며, 처리 중일 때 "중단" 버튼을 사용하여 프로세스를 중지할 수 있습니다.