JSON Excel 변환기

JSON 계층 구조를 평평한 표로 변환하는 원리

이 페이지는 JSON 파일을 업로드하여 바로 엑셀(XLSX) 파일로 변환합니다. JSON은 객체, 배열, 숫자, 불리언, null 등 다양한 자료형을 중첩해 담을 수 있는 반면, 스프레드시트는 2차원 평면 구조입니다. 따라서 변환 과정에서 계층을 평평하게 만드는(flatten) 규칙이 필수적입니다. 핵심은 점 경로(dot-path) 키를 사용하는 것입니다. 예를 들어 다음 JSON이 입력되면:

[
  {
    "name": "홍길동",
    "address": {
      "city": "서울",
      "zip": "12345"
    },
    "scores":
  }
]

변환 결과는 name, address.city, address.zip, scores라는 열이 만들어집니다. scores는 배열 전체가 하나의 셀에 문자열로 들어가거나, 배열 원소가 각각 행으로 확장되지 않습니다. 배열의 객체인 경우에만 각 객체가 행이 되고 키가 열이 됩니다. 배열의 배열이 입력되면 각 하위 배열을 그대로 행으로 취급합니다. null 값은 빈 셀로 남으며, 불리언과 숫자는 XLSX의 해당 데이터 형식으로 보존됩니다.

XLSX 형식의 장점과 한계

CSV는 모든 값을 텍스트로 저장하지만, XLSX는 zipped XML 기반의 통합 문서로 숫자와 불리언을 원래 형식 그대로 보관할 수 있습니다. 이 도구는 JSON의 자료형을 가능한 한 유지하여 XLSX 셀에 기록합니다. 다만 수식, 셀 스타일, 여러 시트는 생성하지 않습니다. 오직 첫 번째 워크시트 하나만 만들어지고, 보이는 정적 데이터만 담깁니다. 변환된 표의 행 수, 열 수, 출력 파일 크기가 미리보기와 함께 표시됩니다.

입력 조건과 에러 처리

입력은 하나의 JSON 파일만 가능합니다. 파일은 반드시 테이블 형상이어야 합니다. 즉, 객체의 배열이거나 배열의 배열이어야 합니다. 단일 객체나 깊게 중첩된 비정형 데이터는 변환할 수 없습니다. 가능한 에러 메시지는 다음과 같습니다:

• "CSV, JSON 또는 XLSX 파일을 선택하십시오."
• "파일이 너무 큽니다. ‹최대› 미만의 파일을 사용하십시오."
• "이 JSON은 유효하지 않거나 테이블 형상이 아닙니다."
• "이 파일에는 표 행이 없습니다."
• "변환이 취소되었습니다."
• "변환 시간이 너무 오래 걸립니다. 더 작은 파일을 시도하십시오."

사용자가 신속하게 오류를 파악하고 다음 조치를 취할 수 있도록 구체적인 메시지로 안내합니다.

실제 사용 사례

• API 응답 데이터 분석: REST API가 반환하는 JSON 배열을 엑셀 파일로 내보내 팀원과 공유하거나 피벗 테이블로 분석할 때 유용합니다.
• 설정 파일 가공: JSON 형식의 환경 설정이나 구성 데이터를 표 구조로 펼쳐 검토하거나 문서화할 때 사용합니다.
• 데이터 형식 유지가 필요한 상황: 불리언이나 숫자가 문자열로 변환되면 안 되는 경우, CSV보다 XLSX 출력이 적합합니다. 예를 들어 true/false 값이 논리형으로, 숫자가 숫자형으로 그대로 엑셀에 들어갑니다.
• 비개발자와 협업: JSON 파일을 일상적으로 다루지 않는 동료가 엑셀로 데이터를 열어볼 수 있도록 변환해 줍니다.

FAQ

Q: JSON에 중첩 배열이 여러 개 있으면 어떻게 되나요?
A: 점 경로로 평탄화되지만, 배열 자체는 하나의 셀에 JSON 문자열로 기록됩니다. 객체의 배열만 행으로 확장됩니다.

Q: null 값은 어떻게 표시되나요?
A: 빈 셀이 됩니다. JSON에 명시적으로 null이 있는 필드는 해당 셀이 비어 있습니다.

Q: XLSX 파일에 수식을 포함할 수 있나요?
A: 아닙니다. 이 도구는 입력 JSON의 정적 데이터만 셀에 기록합니다. 수식이나 서식은 유지되지 않습니다.

Q: 파일 크기 제한은 어느 정도인가요?
A: 8MB 이하의 파일만 변환할 수 있습니다. 초과 시 This file is too large. Use a file under ‹최대›. 메시지가 나타납니다.

Q: 여러 시트를 만들 수 있나요?
A: 아니요. 오직 첫 번째 워크시트 하나만 생성됩니다.

Q: 개인정보 보호는 어떻게 되나요?
A: 모든 변환은 브라우저 안에서만 처리됩니다. 파일이 서버로 업로드되지 않으므로 데이터가 외부로 유출되지 않습니다.