HOWTO · Python

Python에서 헤더가 있는 CSV 읽기

Python에서 헤더가 있는 CSV를 읽는 방법을 알아봅니다.

이 페이지의 내용

Python 표준 라이브러리의 csv 모듈을 사용하면 쉼표로 구분된 파일을 행별로 읽을 수 있습니다. CSV 파일은 첫 행에 열 이름을 넣고 그 뒤에 레코드를 두는 경우가 많습니다. 여기의 예제는 이 형식을 가정합니다. csv.reader 자체는 첫 행을 자동으로 헤더로 처리하지 않습니다. 이 함수는 반복 가능한 행들을 반환하며, 각 행은 문자열 목록으로 표현됩니다.

예제는 작은 입력 파일을 직접 만들기 때문에 별도 파일을 내려받지 않고 각각 실행할 수 있습니다. 실제 파일을 사용하려면 임시 파일 설정을 해당 파일의 경로로 바꾸고 newline=""을 지정한 뒤 파일에 맞는 인코딩으로 여세요. 입력 파일로 이메일 CSV 파일을 살펴볼 수도 있습니다. 각 예제 뒤의 출력에는 관찰된 결과가 표시됩니다.

Python에서 헤더가 있는 CSV 파일 읽기

텍스트 파일을 연 다음 csv.reader에 전달하고 결과를 반복 처리합니다. 반복문은 모든 행을 포함하므로 처음 출력되는 목록은 열 이름이 담긴 행입니다. 헤더를 따로 처리하기 전에 원시 레코드를 살펴보고 싶을 때 유용합니다.

다음 예제를 실행해 보세요.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import csv
import tempfile

with tempfile.NamedTemporaryFile(mode="w", encoding="utf-8", newline="", delete=False) as source:
    source.write("name,team\nAda,Research\nLin,Design\n")
    path = source.name

with open(path, encoding="utf-8", newline="") as source:
    rows = csv.reader(source)
    for row in rows:
        print(row)
['name', 'team']
['Ada', 'Research']
['Lin', 'Design']

리더는 CSV 인용 규칙에 따라 필드를 파싱합니다. 필드 안에 따옴표로 묶인 쉼표가 있으면 각 줄을 쉼표 기준으로 직접 나눌 때 잘못된 결과가 나올 수 있습니다. 파일을 한 번 훑어 읽으므로 처리 시간은 입력 크기에 비례해 선형으로 증가합니다. 파일이 크더라도 이 방식은 모든 행을 메모리에 한꺼번에 저장할 필요가 없습니다.

헤더를 추출하고 행을 따로 처리하기

리더에 내장된 next() 함수를 호출해 첫 행을 가져와 헤더로 저장합니다. 그러면 리더는 다음 행부터 계속 읽으므로 반복문에서 데이터 레코드만 처리할 수 있습니다. 파일 전체를 목록으로 불러오지 않고도 열 이름과 값을 분리할 수 있습니다.

다음 예제를 실행해 보세요.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import csv
import tempfile

with tempfile.NamedTemporaryFile(mode="w", encoding="utf-8", newline="", delete=False) as source:
    source.write("name,team\nAda,Research\nLin,Design\n")
    path = source.name

with open(path, encoding="utf-8", newline="") as source:
    rows = csv.reader(source)
    header = next(rows)
    print("Header:", ", ".join(header))
    for row in rows:
        print(dict(zip(header, row)))
Header: name, team
{'name': 'Ada', 'team': 'Research'}
{'name': 'Lin', 'team': 'Design'}

여기서 zip은 각 열 이름을 해당 필드와 짝짓고, dict는 그 쌍을 이름으로 조회할 수 있게 합니다. 이 방법은 파일에 헤더 행이 있고 각 레코드의 필드 순서가 헤더와 같다고 가정합니다. 행이 없을 수도 있는 파일이라면 첫 행을 헤더로 사용하기 전에 행이 있는지 확인하세요. 그렇지 않으면 next()가 반환할 행이 없습니다.

다른 delimiter로 CSV 읽기

기본 구분자는 쉼표입니다. 세미콜론을 사용하는 파일이라면 delimiter 인수를 csv.reader에 전달하세요. 입력에서 실제로 필드를 구분하는 문자를 사용해야 합니다. 리더의 동작은 같지만 헤더 처리는 명시적으로 해야 합니다. 관례상 첫 행에 헤더가 들어가지만 csv.reader는 이를 헤더로 해석하지 않습니다. 따라서 이 예제는 레코드를 출력하기 전에 next()로 첫 행을 소비합니다.

다음 예제를 실행해 보세요.

이 섹션의 코드와 표시되는 레이블 또는 출력은 영어로 유지됩니다.

import csv
import tempfile

with tempfile.NamedTemporaryFile(mode="w", encoding="utf-8", newline="", delete=False) as source:
    source.write("name;team\nAda;Research\nLin;Design\n")
    path = source.name

with open(path, encoding="utf-8", newline="") as source:
    rows = csv.reader(source, delimiter=";")
    header = next(rows)
    print("Header:", ", ".join(header))
    for row in rows:
        print(", ".join(row))
Header: name, team
Ada, Research
Lin, Design

다른 형식의 파일이라면 탭 문자처럼 해당 파일에서 사용하는 구분자를 delimiter에 지정하세요. CSV 모듈에서 파일을 열 때는 newline=""을 유지하고 원본 데이터에 맞는 인코딩을 선택합니다. 행에 따옴표로 묶인 필드나 줄바꿈이 포함되어 있다면 줄을 직접 전처리하지 말고 csv.reader가 파싱하도록 하세요.