JSON을 CSV로: JSON 데이터를 스프레드시트 형식으로 변환

2026년 3월 31일 · 12분 읽기

JSON과 CSV 형식 이해하기

변환 기술을 다루기 전에, 두 형식에 대한 확실한 이해를 확립해 봅시다. JSON(JavaScript Object Notation)과 CSV(Comma-Separated Values)는 데이터 생태계에서 서로 다른 목적을 제공하며, 그들의 강점을 아는 것이 효과적으로 작업하는 데 도움이 됩니다.

JSON은 사람이 읽을 수 있고 기계가 파싱할 수 있는 경량 데이터 교환 형식입니다. 복잡한 데이터 구조를 자연스럽게 처리하기 때문에 API와 웹 서비스의 사실상 표준이 되었습니다. 구성 파일부터 API 응답, NoSQL 데이터베이스까지 어디서나 JSON을 찾을 수 있습니다.

일반적인 JSON 구조는 다음과 같습니다:

{
  "users": [
    {
      "id": 1,
      "name": "Sarah Chen",
      "email": "[email protected]",
      "role": "developer",
      "active": true
    },
    {
      "id": 2,
      "name": "Marcus Johnson",
      "email": "[email protected]",
      "role": "designer",
      "active": false
    }
  ]
}

반면 CSV는 데이터를 표 형식으로 나타냅니다—스프레드시트의 행과 열을 생각하면 됩니다. 각 줄은 레코드이고, 쉼표는 해당 레코드 내의 필드를 구분합니다. CSV 파일은 스프레드시트 애플리케이션, 데이터베이스 및 데이터 분석 도구와 보편적으로 호환됩니다.

CSV 형식의 동일한 데이터:

id,name,email,role,active
1,Sarah Chen,[email protected],developer,true
2,Marcus Johnson,[email protected],designer,false

이러한 형식 간의 주요 차이점은 작업할 때 명확해집니다:

왜 JSON을 CSV로 변환하나요?

JSON을 CSV로 변환하는 것은 단순한 기술적 연습이 아닙니다—실제 비즈니스 문제를 해결합니다. 언제 왜 변환해야 하는지 이해하면 데이터 워크플로에 대해 더 나은 결정을 내릴 수 있습니다.

데이터 분석 및 시각화

분석가와 데이터 과학자들은 도구와 원활하게 통합되기 때문에 CSV를 선호하는 경우가 많습니다. Excel, Google Sheets, Tableau, R 모두 CSV 파일을 기본적으로 처리합니다. API에서 JSON 데이터를 받았지만 피벗 테이블, 차트 또는 통계 분석을 만들어야 할 때, CSV가 이러한 강력한 도구로 가는 다리가 됩니다.

예를 들어, 전자상거래 API에서 판매 데이터를 가져오는 경우 JSON 응답에는 수백 개의 거래가 포함될 수 있습니다. CSV로 변환하면 Excel로 빠르게 가져와서 요약 테이블을 만들고 이해관계자 프레젠테이션을 위한 시각화를 생성할 수 있습니다.

데이터베이스 가져오기 작업

많은 관계형 데이터베이스는 CSV 파일에 대해 최적화된 대량 가져오기 기능을 제공합니다. PostgreSQL의 COPY 명령, MySQL의 LOAD DATA INFILE 및 다른 데이터베이스의 유사한 기능은 수백만 개의 CSV 행을 몇 초 만에 처리할 수 있습니다. JSON 가져오기는 가능하지만 종종 더 복잡한 파싱이 필요하고 느립니다.

시스템 간 데이터를 마이그레이션하거나 초기 데이터베이스 시딩을 수행할 때 CSV 변환은 가져오기 시간을 극적으로 줄일 수 있습니다.

단순성과 호환성

CSV 파일은 보편적으로 이해됩니다. 누구에게나 CSV 파일을 이메일로 보낼 수 있으며, 특별한 소프트웨어 없이도 열 수 있습니다. 이는 CSV를 다음과 같은 용도에 이상적으로 만듭니다:

• 비기술 이해관계자와 데이터 공유
• 복원하기 쉬운 데이터 백업 생성
• 규정 준수를 위한 보고서 생성
• 수십 년 동안 접근 가능한 형식으로 데이터 보관

성능 및 파일 크기

단순한 구조의 대규모 데이터셋의 경우 CSV 파일은 동등한 JSON보다 훨씬 작습니다. 형식 문자(괄호, 따옴표, 콜론)의 감소로 30-50% 더 작은 파일 크기를 얻을 수 있습니다. 이는 네트워크를 통해 데이터를 전송하거나 대용량 아카이브를 저장할 때 중요합니다.

레거시 시스템 통합

JSON 시대 이전에 구축된 많은 엔터프라이즈 시스템은 여전히 CSV 입력을 기대합니다. JSON을 CSV로 변환하면 광범위한 시스템 재작성 없이 최신 API를 레거시 시스템과 통합할 수 있습니다. 이는 오래된 시스템이 여전히 운영 중인 금융, 의료 및 제조업과 같은 산업에서 특히 일반적입니다.

간단한 변환 방법

프로그래밍 지식이 필요 없는 방법부터 시작하여 JSON을 CSV로 변환하는 가장 간단한 방법을 살펴보겠습니다.

스프레드시트 애플리케이션 사용

Excel과 Google Sheets 모두 JSON 데이터를 직접 가져올 수 있지만 몇 가지 제한이 있습니다. 이 방법은 단순하고 평면적인 JSON 구조에 가장 적합합니다.

Microsoft Excel에서:

1. Excel을 열고 새 통합 문서를 만듭니다
2. 데이터 → 데이터 가져오기 → 파일에서 → JSON에서로 이동합니다
3. JSON 파일을 선택합니다
4. 파워 쿼리 편집기를 사용하여 데이터를 변환합니다
5. "닫기 및 로드"를 클릭하여 가져옵니다
6. 파일 → 다른 이름으로 저장 → CSV(쉼표로 구분)를 사용하여 CSV로 저장합니다

Google Sheets에서:

1. 새 스프레드시트를 만듭니다
2. JSON이 온라인에 호스팅된 경우 IMPORTDATA() 함수를 사용합니다
3. 또는 셀에 JSON을 붙여넣고 파싱을 위해 Apps Script를 사용합니다
4. 파일 → 다운로드 → 쉼표로 구분된 값을 사용하여 CSV로 다운로드합니다

명령줄 도구

터미널에 익숙한 개발자의 경우 명령줄 도구는 코드 작성 없이 빠른 변환을 제공합니다. jq 유틸리티는 JSON 조작에 특히 강력합니다.

시스템에 jq를 설치합니다:

# macOS
brew install jq

# Ubuntu/Debian
sudo apt-get install jq

# Windows (Chocolatey 사용)
choco install jq

간단한 JSON 배열을 CSV로 변환합니다:

jq -r '.[] | [.id, .name, .email] | @csv' input.json > output.csv

이 명령은 각 JSON 객체에서 특정 필드를 추출하고 CSV 행으로 형식을 지정합니다. -r 플래그는 JSON 따옴표 없이 원시 문자열을 출력하고, @csv는 적절한 CSV 이스케이프를 처리합니다.

온라인 변환 도구 사용하기

온라인 변환기는 아무것도 설치하지 않고 JSON에서 CSV로 가는 가장 빠른 경로를 제공합니다. 일회성 변환이나 소프트웨어를 설치할 수 없는 컴퓨터에서 작업할 때 완벽합니다.

찾아야 할 기능

온라인 JSON to CSV 변환기를 선택할 때 다음 기능을 우선시하세요:

• 개인정보 보호: 도구가 서버에 업로드하는 대신 클라이언트 측(브라우저에서) 데이터를 처리하는지 확인하세요
• 크기 제한: 최대 파일 크기를 확인하세요—일부 도구는 1MB로 제한되는 반면 다른 도구는 100MB 이상을 처리합니다
• 중첩 데이터 처리: 중첩된 객체와 배열을 평면화할 수 있나요?
• 사용자 정의: 구분 기호 선택, 헤더 포함 및 필드 선택 옵션
• 미리보기: 다운로드하기 전에 결과를 미리 볼 수 있는 기능

일반적인 워크플로

대부분의 온라인 변환기는 다음 패턴을 따릅니다:

1. JSON 텍스트를 붙여넣거나 JSON 파일을 업로드합니다
2. 도구가 JSON 구조를 검증하고 파싱합니다
3. 변환 옵션을 구성합니다(구분 기호, 헤더, 평면화)
4. CSV 출력을 미리 봅니다
5. 변환된 파일을 다운로드합니다

프로그래밍 기반 솔루션

정기적으로 또는 자동화된 워크플로의 일부로 JSON을 CSV로 변환해야 할 때 프로그래밍 솔루션은 유연성과 강력함을 제공합니다. 인기 있는 언어로 구현을 살펴보겠습니다.

Python 구현

Python의 내장 라이브러리는 JSON to CSV 변환을 간단하게 만듭니다. 다음은 일반적인 시나리오를 처리하는 강력한 솔루션입니다:

import json
import csv

def json_to_csv(json_file, csv_file):
    # JSON 데이터 읽기
    with open(json_file, 'r') as f:
        data = json.load(f)
    
    # 단일 객체와 객체 배열 모두 처리
    if isinstance(data, dict):
        data = [data]
    
    # 첫 번째 객체에서 헤더 추출
    headers = data[0].keys()
    
    # CSV에 쓰기
    with open(csv_file, 'w', newline='', encoding='utf-8') as f:
        writer = csv.DictWriter(f, fieldnames=headers)
        writer.writeheader()
        writer.writerows(data)

# 사용법
json_to_csv('input.json', 'output.csv')

중첩된 데이터가 있는 더 복잡한 시나리오의 경우 pandas 라이브러리가 강력한 도구를 제공합니다:

import pandas as pd

# JSON 읽기 및 중첩 구조 정규화
df = pd.read_json('input.json')

# 필요한 경우 중첩된 열 평면화
df = pd.json_normalize(data)

# CSV로 내보내기
df.to_csv('output.csv', index=False)

JavaScript/Node.js 구현

JavaScript 개발자의 경우 Node.js는 여러 접근 방식을 제공합니다. 다음은 인기 있는 json2csv 라이브러리를 사용한 솔루션입니다:

const { parse } = require('json2csv');
const fs = require('fs');

// JSON 파일 읽기
const jsonData = JSON.parse(fs.readFileSync('input.json', 'utf8'));

// CSV로 변환
const csv = parse(jsonData);

// CSV 파일 쓰기
fs.writeFileSync('output.csv', csv);

외부 라이브러리 없이 사용자 정의 제어를 위해:

const fs = require('fs');

function jsonToCsv(jsonData) {
    const array = Array.isArray(jsonData) ? jsonData : [jsonData];
    const headers = Object.keys(array[0]);
    
    const csvRows = [
        headers.join(','),
        ...array.map(row => 
            headers.map(header => 
                JSON.stringify(row[header] ?? '')
            ).join(',')
        )
    ];
    
    return csvRows.join('\n');
}

const data = JSON.parse(fs.readFileSync('input.json', 'utf8'));
const csv = jsonToCsv(data);
fs.writeFileSync('output.csv', csv);

다른 언어 솔루션