CSV 또는 JSON? 다음 작업에 맞는 형식을 고르세요.

같은 정보, 다른 두 가지 형태

CSV와 JSON은 모두 일반 텍스트 형식입니다. 텍스트 편집기로 열고, 앱 간에 전달하고, 유용한 데이터를 저장할 수 있습니다. 차이는 데이터를 표현하는 방식에 있습니다.

CSV는 표를 표현합니다. 각 레코드가 한 행이고 쉼표로 셀을 구분합니다. 보통 머리글 행에 열 이름을 씁니다. JSON은 객체, 목록, 문자열, 숫자, 불리언, null을 표현하며 필요하면 중첩 구조도 담을 수 있습니다.

name,company
Alex,Studio North
Sam,Orbit

[
  {"name": "Alex", "company": "Studio North"},
  {"name": "Sam", "company": "Orbit"}
]

이 예시들은 같은 두 레코드를 담고 있습니다. 어느 형식이 본질적으로 더 정확한 것은 아닙니다. 다음에 읽을 시스템에 따라 선택하면 됩니다.

단순한 표에는 CSV 선택하기

CSV는 연락처 목록, 조사 자료 내보내기, 모든 행이 같은 열을 쓰는 간단한 보고서에 적합합니다. 스프레드시트와 가져오기 도구에서 널리 지원하며 눈으로 검토하기도 쉽습니다.

단순한 만큼 제약도 있습니다. CSV는 데이터 형식을 정의하지 않으므로 수신 앱이 값을 텍스트, 숫자, 날짜 중 무엇으로 볼지 결정합니다. 열을 텍스트로 가져오지 않으면 00123 같은 코드가 123으로 바뀔 수 있습니다.

값 안의 쉼표도 별도 처리가 필요합니다. North, Inc.라는 회사명은 큰따옴표로 감싼 셀에 들어가야 합니다. 큰따옴표 안에 또 큰따옴표가 있으면 두 번 씁니다. 제대로 된 변환 도구가 이를 처리해 줍니다.

구조화된 데이터에는 JSON 선택하기

JSON은 레코드에 선택적 필드, 태그 목록, 중첩 주소가 있을 때 유용합니다. 객체는 모든 것을 직사각형 표에 맞추지 않고도 이런 관계를 담을 수 있습니다.

웹훅 전송 데이터와 앱 API에서도 흔히 쓰이는 형식입니다. 수신 시스템이 기대하는 스키마를 항상 확인하세요. 유효한 JSON이라고 해서 연동이 받아들이는 구조라는 뜻은 아닙니다.

CSV를 JSON에 매핑할 때 어떤 열을 문자열로 유지하고 어떤 열을 숫자나 불리언으로 바꿀지 정하세요. 식별자는 원래 표현을 보존하도록 문자열로 유지하세요.

사용할 곳을 고려해 변환하기

JSON 배열을 CSV로 변환하려면 먼저 고정된 열 구성을 정하세요. 누락 필드, null 값, 중첩 객체의 처리 방법을 결정하세요. 중첩 주소에는 개별 열이, 목록에는 별도의 표가 필요할 수 있습니다.

API 레코드를 살펴보는 데는 유용하지만 다시 변환해도 손실 없이 복원되지는 않습니다. JSON으로 되돌려도 원래 형식이 재현되거나 누락 필드와 null이 구분되지 않습니다. 나중에 전체 구조가 필요할 수 있다면 원본 파일을 보관하세요.

원본이 웹페이지라면 WebAct로 보이는 정보를 파일로 추출할 수 있습니다. 유료 연동으로 완료된 작업 결과를 웹훅 워크플로에 보낼 수도 있습니다. 후속 동작에 연결하기 전에 결과와 수신 스키마를 확인하세요.