JSON CSV 변환

JSON을 CSV로 바꾸는 방법

1. JSON 붙여넣기. 복사한 응답, .json 파일, 한 줄에 하나씩 쓰인 NDJSON 모두 됩니다. 어디로도 보내지 않습니다.
2. 어느 배열을 읽었는지 확인. 감싼 응답이면 표 위에 사용한 키(data, results, items …)가 나옵니다.
3. 열 이름 읽기. 중첩 값은 customer.name 같은 점으로 이은 열이 되고, 문자열 목록은 세미콜론으로 이어 한 칸에 들어갑니다.
4. 내려받기. 스크립트나 DB에 넣을 거면 CSV, 엑셀에서 열 거면 .xlsx를 고릅니다.

레코드 배열은 대개 한 단계 안쪽에 있습니다

CSV는 직사각형이고 JSON은 나무입니다. 변환이 실패하는 이유는 거의 언제나 첫 행을 쓰기도 전에 정해집니다. 가장 흔한 것은 레코드가 맨 위에 있지 않다는 점입니다. API는 {"data": [ … ]}, {"results": [ … ]}처럼 한 단계 감싸서 돌려줍니다. 감싼 객체를 그대로 펼치면 여러 행이 아니라 아주 넓은 한 행이 나옵니다.

이 페이지는 맨 위 키들 가운데 객체가 들어 있는 첫 번째 배열을 찾아 레코드로 씁니다. 어느 키를 읽었는지는 표 위에 나오니, 엉뚱한 배열을 집었다면 바로 알 수 있습니다.

중첩 객체는 점으로 이은 열이 됩니다

{"고객": {"이름": "김민지", "지역": "서울"}}은 고객.이름, 고객.지역 두 열이 됩니다. 한 칸에 [object Object]가 찍히는 일은 없습니다. 깊이 제한도 없어서 세 단계면 a.b.c가 됩니다.

• 문자열·숫자 목록 —— ["vip","서울"] —— 은 한 칸에 vip; 서울로 이어 씁니다. 대개 태그라서 열로 쪼개면 표가 들쭉날쭉해집니다.
• 객체 목록은 번호를 붙인 열로 펼칩니다. 주문 품목 두 개라면 items.0.sku, items.1.sku로 따로 남습니다.
• 키 이름이 한글이어도 그대로 열 이름이 됩니다. 영문으로 바꾸지 않습니다.

레코드마다 키가 달라도 열이 밀리지 않습니다

세 번째 레코드에만 메모 키가 있는 경우가 흔합니다. 열은 모든 레코드의 키를 합친 것이고, 처음 나온 순서대로 놓입니다. 없는 값은 빈 칸으로 쓰기 때문에 다음 값이 왼쪽 열로 끌려오지 않습니다.

NDJSON(한 줄에 JSON 하나)도 읽습니다

로그 파일이나 BigQuery 내보내기는 대개 한 줄에 완결된 JSON 하나씩, 감싸는 배열도 쉼표도 없이 쓰여 있습니다. 문서 전체로는 올바른 JSON이 아니라서 엄격한 해석기는 거부합니다. 여기서는 전체 해석이 실패하면 줄마다 따로 해석해 보고, 그게 되면 표 위에 NDJSON이라고 표시합니다.

받은 CSV를 엑셀에서 열면 한글이 깨질 수 있습니다

내려받는 CSV는 UTF-8이고, 파일 앞에 BOM을 붙이지 않습니다. 한국어 윈도우의 엑셀은 BOM 없는 CSV를 더블클릭하면 CP949로 읽으려 하므로 한글이 깨져 보입니다. 파일이 망가진 것은 아니고, 스크립트나 DB, 구글 시트에서는 제대로 읽힙니다.

엑셀에서 쓸 거라면 「.xlsx 받기」를 누르세요. .xlsx에는 인코딩이라는 개념이 없어서 깨질 일이 없습니다. CSV가 꼭 필요하다면 엑셀의 데이터 → 텍스트/CSV에서로 가져오면서 UTF-8을 고르면 됩니다. 이미 깨진 CSV가 있다면 CSV 한글 깨짐 복구로 되살릴 수 있습니다.

이 도구가 하지 않는 일

• 구분자 고르기. CSV는 항상 쉼표로 씁니다. 세미콜론이나 탭이 필요하면 .xlsx로 받은 뒤 원하는 형식으로 저장하세요.
• 잘못된 JSON 고치기. 해석기가 어디서 멈췄는지 그 메시지를 그대로 보여 줄 뿐, 추측해서 고치지 않습니다.
• 열 고르기. 모든 키를 열로 만듭니다. 필요 없는 열은 받은 뒤 지우세요.

같은 응답을 매주 바꾸고 있다면

처음 두세 번은 브라우저 탭이 딱 맞습니다. 같은 API 응답을 정해진 날마다 같은 표에 넣고, 어느 날 필드가 빠지면 누군가 알아채야 한다면 그건 더 이상 변환이 아닙니다. TableDI 2는 매 기간 다시 해야 하는 파일 작업을 위한 데스크톱 앱입니다. 원본·규칙·전달 방식을 하나의 작업으로 저장해 두므로, 다음 달에는 새 파일을 넣고 다시 실행하기만 하면 됩니다. 모든 처리는 내 컴퓨터 안에서 이루어집니다.