CSV 구분자와 인용 부호를 설정해 데이터 정리하는 방법

CSV 텍스트를 입력하고 원본의 구분자와 인용 부호를 맞춘 뒤 서식 지정 방식을 선택하면, 다시 작성된 내용과 행·열 수를 확인할 수 있습니다. 정확히 minimal을 선택하면 필요한 경우에만 인용되고, 그 밖의 서식 값은 모든 필드를 인용합니다.

CSV 정리 전에 확인할 항목

CSV Formatter는 이미 작성된 CSV 텍스트를 선택한 구분자와 인용 부호에 맞춰 다시 정리할 때 사용할 수 있습니다. 표 계산 프로그램이나 다른 도구에서 만든 내용을 옮긴 뒤, 값 사이를 나누는 문자가 무엇인지 확인하고 같은 설정을 적용하는 방식입니다. 기본값은 쉼표 구분자, 큰따옴표 인용 부호, pretty 형식입니다. 따라서 쉼표로 필드를 나누고 큰따옴표로 값을 감싼 일반적인 CSV라면 기본 설정에서 시작할 수 있습니다.

이 도구에서 확인할 수 있는 결과는 정리된 CSV 내용, 처리된 행 수, 열 수입니다. 입력은 파일 이름이나 설명이 아니라 CSV 텍스트 자체여야 합니다. 한 줄에 여러 필드가 들어가는 자료, 여러 줄로 구성된 목록, 값 안에 구분자나 인용 부호가 포함될 수 있는 자료를 다룰 때 설정을 원본과 맞추는 것이 중요합니다. 입력에 쓰인 문자와 다른 문자를 고르면 원래 의도한 필드 경계가 다르게 해석될 수 있습니다.

서식 지정 방식도 결과의 모양에 영향을 줍니다. minimal은 CSV 규칙상 필요한 경우에만 인용을 사용하는 방식이고, minimal이 아닌 서식 값은 모든 필드를 인용하는 방식으로 처리됩니다. 이 선택은 행과 열을 세는 기준을 바꾸는 설정이 아니라, 읽은 행을 결과 CSV로 다시 작성할 때 적용되는 방식입니다. 결과를 다른 곳에 붙여 넣을 예정이라면 내용뿐 아니라 구분자와 인용 부호도 함께 확인하세요.

설정부터 결과 확인까지

1. 먼저 입력 영역에 정리할 CSV 텍스트를 붙여 넣습니다. 줄바꿈은 행을 구분하는 자료의 일부이므로, 원본에 있는 줄바꿈을 임의로 삭제하거나 추가하지 않는 편이 좋습니다. 입력이 공백만으로 이루어졌다면 성공 응답이 반환되지만, 결과 내용은 비어 있고 행 수와 열 수는 0으로 표시됩니다.

2. 원본에서 필드 사이에 사용한 문자를 살펴봅니다. 쉼표로 값이 나뉘면 쉼표 구분자를 그대로 두고, 탭이나 다른 문자가 경계로 쓰였다면 해당 문자를 구분자로 선택합니다. 구분자는 보기 좋은 결과를 고르는 장식 옵션이 아니라, 각 행을 어떤 필드로 나눌지 정하는 기준입니다. 입력 안에서 실제로 사용한 문자와 선택한 값이 일치해야 파싱 결과를 원본의 구조에 가깝게 읽을 수 있습니다.

3. 값 안에서 내용을 감싼 문자를 확인합니다. 큰따옴표를 사용한 CSV라면 기본 인용 부호를 사용할 수 있으며, 다른 문자가 사용되었다면 그 문자에 맞춰 설정합니다. 인용 부호는 필드 안에 들어 있는 구분자가 경계로 오해되지 않도록 해석할 때 관여합니다. 이 항목을 원본과 다르게 지정하면 한 줄의 필드 수가 예상과 달라질 수 있습니다.

4. 서식 지정 방식을 선택합니다. 필요한 경우에만 인용이 필요하면 정확히 minimal을 선택합니다. 모든 필드를 인용한 결과를 원한다면 minimal이 아닌 값을 선택할 수 있습니다. 검토할 때는 선택한 값의 철자와 대소문자도 입력한 설정과 일치하는지 확인하세요. minimal 외의 값은 별도의 여러 인용 모드로 나뉜다고 가정하지 말고, 모든 필드 인용으로 이해해야 합니다.

5. 처리를 실행한 다음 정리된 내용과 집계 정보를 함께 살펴봅니다. 공백이 아닌 입력은 선택한 구분자와 인용 부호를 사용해 행을 읽고, 같은 설정을 기준으로 읽은 행을 CSV로 다시 작성합니다. 결과 내용에서 필드 사이의 문자가 원하는 값인지 확인하고, 값에 붙은 인용 부호가 선택한 서식 방식과 맞는지도 확인합니다. 행 수는 읽힌 행의 개수이며, 열 수는 관찰된 행 가운데 가장 넓은 행의 필드 수입니다.

6. 기대한 구조와 결과가 다르면 원본의 구분자, 인용 부호, 서식 값을 차례로 다시 확인합니다. 먼저 한두 줄의 짧은 입력으로 구조를 점검한 뒤 전체 자료를 처리하면 설정 차이를 찾기 쉽습니다. 처리 중 예외가 발생한 경우에는 결과 내용이 비어 있고 행 수와 열 수가 0으로 반환되며 오류 설명도 함께 제공됩니다. 이때 같은 내용을 무조건 여러 번 실행하기보다 오류 설명과 선택한 설정을 대조하세요.

행·열 수와 결과 내용 해석

행 수는 파싱이 끝난 뒤 읽힌 행의 개수를 나타냅니다. 열 수는 고정된 표의 열 제목을 판정한 값이 아니라, 처리된 행에서 확인된 가장 큰 필드 수를 나타냅니다. 예를 들어 두 줄이 각각 세 필드로 이루어진 쉼표 구분 CSV라면 행 수는 2이고 열 수는 3입니다. 한 행에 필드가 더 많으면 그 행의 폭이 열 수에 반영됩니다.

행마다 필드 개수가 서로 다를 때는 열 수만 보고 모든 행의 구조가 같다고 판단하지 마세요. 표시된 값은 관찰된 최대 너비이므로, 일부 행이 더 짧은지 여부는 정리된 내용에서 직접 살펴봐야 합니다. 이 집계는 내용이 표처럼 보기 좋게 맞춰졌는지를 뜻하지 않으며, 열 너비 정렬이나 원본의 장식 서식까지 평가한 결과도 아닙니다.

정리된 내용은 선택한 구분자와 인용 부호를 사용해 다시 작성된 CSV입니다. minimal을 선택한 경우에는 필요한 필드만 인용될 수 있고, 다른 서식 값을 선택한 경우에는 모든 필드가 인용되는 결과를 예상합니다. 그러므로 원본과 결과의 줄바꿈, 필드 경계, 인용 표시를 각각 나누어 비교하는 것이 좋습니다. 결과가 달라 보인다는 사실만으로 입력이 잘못되었다고 결론 내리지 말고, 선택한 서식 방식이 바뀌었는지 먼저 확인하세요.

내용이 비어 있고 행 수와 열 수가 0인 응답은 두 가지 상황에서 나타날 수 있습니다. 입력이 비어 있거나 공백만 있었을 때에는 오류 설명 없이 성공 응답이 반환됩니다. 반대로 처리 중 예외가 발생했다면 빈 내용과 0이라는 집계에 오류 설명이 함께 반환됩니다. 이 둘을 구분하려면 결과 내용만 보지 말고 오류 설명의 존재 여부를 확인해야 합니다.

오류 설명이 있다면 입력에 사용한 구분자와 인용 부호가 선택한 설정과 같은지 검토하세요. 오류 설명이 없고 입력도 공백뿐이었다면 빈 결과는 해당 입력 조건에 맞는 정상적인 응답입니다. 처리 결과의 행과 열은 파싱된 구조를 요약한 값이므로, 특정 값의 의미나 데이터의 업무상 정확성을 판정하는 지표로 해석해서는 안 됩니다. 또한 결과가 반환되었다는 사실만으로 원본의 모든 표현이 그대로 보존되었다고 단정하지 않는 것이 안전합니다.

사용 예시

세 필드로 구성된 상품 CSV 두 줄의 인용 방식을 정리하려는 상황입니다.

상품,수량,가격이 있는 첫 번째 줄과 사과,2,1500이 있는 두 번째 줄을 입력하고 쉼표 구분자, 큰따옴표 인용 부호, minimal 형식을 선택해 처리합니다.

정리된 CSV 내용과 함께 행 수 2, 열 수 3이 반환됩니다.

제한 사항

• 이 결과는 행을 파싱한 뒤 CSV로 다시 작성한 내용과 집계이며, 예외가 발생하면 빈 내용과 0행 0열 및 오류 설명이 반환됩니다.

자주 발생하는 오류

• 원본에 실제로 쓰인 구분자나 인용 부호와 다른 값을 선택하면 필드 경계가 예상과 다르게 읽힐 수 있습니다. 짧은 원본 한두 줄에서 구분자와 인용 부호를 다시 확인한 뒤 같은 설정으로 처리하세요.

자주 묻는 질문

입력란을 비워 두면 어떤 결과가 나오나요?

입력이 비어 있거나 공백만 있으면 성공 응답이 반환되며, 결과 내용은 비어 있고 행 수와 열 수는 0으로 표시됩니다.

필요한 필드만 인용하려면 어떤 서식 값을 선택해야 하나요?

정확히 minimal을 선택하면 필요한 경우에만 CSV 인용이 적용됩니다. minimal이 아닌 서식 값은 모든 필드를 인용하는 방식으로 처리됩니다.

결과 내용이 비어 있고 행과 열이 0이면 무엇을 확인해야 하나요?

처리 중 예외가 발생한 경우에는 빈 결과 내용과 0행 0열이 오류 설명과 함께 반환됩니다. 입력이 공백뿐인 정상 응답과 구분하려면 오류 설명이 있는지 확인하고, 구분자와 인용 부호 설정도 원본과 대조하세요.