쉼표로 구분된 값(CSV) 파일은 쉼표로 값을 구분하는 구분 텍스트 파일입니다. 파일의 각 줄은 하나의 데이터 레코드입니다. 각 레코드는 쉼표로 구분된 하나 이상의 필드로 구성됩니다. 필드 구분 기호로 쉼표를 사용하는 것이 이 파일 형식 이름의 유래입니다. CSV 파일은 일반적으로 표 형식 데이터(숫자와 텍스트)를 일반 텍스트로 저장하며, 이 경우 각 줄은 동일한 수의 필드를 가집니다.

CSV 파일 형식은 완전히 표준화되어 있지 않습니다. 다른 문자를 칼럼 구분 기호로 사용할 수 있습니다. 필드는 특수 문자를 이스케이프하기 위해 감쌀 수도 있고 감싸지 않을 수도 있습니다.

리포지터리에 추가하면 .csv 확장자를 가진 파일은 GitLab에서 볼 때 표로 렌더링됩니다.

CSV 파싱 고려 사항#

GitLab은 CSV 파일을 파싱하는 데 Papa Parse 라이브러리를 사용합니다. 이 라이브러리는 RFC4180을 따르며, 형식 요구 사항이 엄격해 일부 CSV 형식에서 파싱 문제가 발생할 수 있습니다.

예를 들면 다음과 같습니다.

• 쉼표(,) 구분 기호와 큰따옴표(") 주변의 공백이 파싱 오류를 일으킬 수 있습니다.
• 쉼표와 큰따옴표가 모두 포함된 필드는 파서가 필드 경계를 잘못 인식하게 할 수 있습니다.

다음 형식은 파싱 오류를 일으킵니다.

"field1", "field2", "field3"

다음 형식은 정상적으로 파싱됩니다.

"field1","field2","field3"

GitLab에서 CSV 파일이 올바르게 표시되지 않으면 다음을 확인합니다.

• 필드를 큰따옴표(")로 감쌌다면 큰따옴표와 쉼표(,) 구분 기호 사이에 공백 없이 바로 붙어 있는지 확인합니다.
• 특수 문자가 포함된 모든 필드를 큰따옴표(")로 감쌉니다.
• 변경한 뒤 GitLab에서 CSV 파일이 어떻게 표시되는지 테스트합니다.

이러한 파싱 요구 사항은 CSV 파일의 시각적 렌더링에만 영향을 미치며, 리포지터리에 저장된 실제 파일 콘텐츠에는 영향을 주지 않습니다.