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

CSV 파일 형식은 완전히 표준화되어 있지 않습니다. 다른 문자를 열 구분 기호로 사용할 수 있습니다. 필드는 특수 문자를 이스케이프하기 위해 둘러싸거나 그렇지 않을 수 있습니다.

저장소에 추가되면 .csv 확장자를 가진 파일은 GitLab에서 볼 때 표로 렌더링됩니다:

CSV 파싱 고려 사항#

GitLab은 CSV 파일을 파싱하기 위해 Papa Parse 라이브러리를 사용합니다. 이 라이브러리는 RFC4180을 따르며 특정 CSV 형식에서 파싱 문제를 일으킬 수 있는 엄격한 형식 요구 사항이 있습니다.

예를 들어:

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

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

"field1", "field2", "field3"

다음 형식은 성공적으로 파싱됩니다:

"field1","field2","field3"

GitLab에서 CSV 파일이 올바르게 표시되지 않으면:

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

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