[PYTHON] pandas read_csv 함수의 header 옵션 정리

1. header 옵션이란?

CSV 파일에서 어떤 행을 열 이름(헤더)으로 사용할지 지정하는 역할을 합니다.

기본값은 header=0으로, 첫 번째 행을 헤더로 사용합니다.

 

데이터 구조에 따라 내가 원하는 header(컬럼명)을 가져오지 못할 때가 있는데요.

header옵션을 활용하면 pd.read_csv로 불러올 때 부터 원하는 헤더를 지정할 수 있습니다.

2. header  == None: 헤더가 없는 파일 처리

•  열 이름을 0부터 시작하는 정수로 설정 되므로, 이후 컬럼명 직접 지정

# 헤더가 없는 CSV 파일 읽기
data = pd.read_csv('your_file.csv', header=None)

# 열 이름을 직접 지정
data.columns = ['column_name1', 'column_name2', 'column_name3']

3. header  == 0: 첫 번째 행을 헤더로 사용(기본값)

# 헤더가 없는 CSV 파일 읽기
data = pd.read_csv('your_file.csv', header=None)

# 열 이름을 직접 지정
data.columns = ['column_name1', 'column_name2', 'column_name3']

4. header  == N: 특정 값을 헤더로 사용

• 원하는 행을 헤더로 지정하는 방법
• 주의) 헤더로 지정한 행 이전의 행은 na값으로 표기됩니다.
  => skiprows  매개변수를 사용하여 불필요한 데이터를 제거할 수 있습니다.
• 아래 예시는 2개 모두 header는 4번 행이지만, skiprows를 지정하지 않은 경우 헤더 이전의 값이 na로 표기됩니다.

# 첫 두 줄 건너뛰고 세 번째 행(인덱스 2)을 헤더로 지정
data = pd.read_csv('your_file.csv', header=0, skiprows=3)

# 아래와 같이 사용할 경우, 앞의 2줄의 데이터가 출력됨
data = pd.read_csv('your_file.csv', header=3)

# sample data
메타데이터: 이 파일은 테스트용입니다.
작성자: 홍길동
날짜: 2025-03-07

이름,나이,직업
철수,25,개발자
영희,30,디자이너
민수,28,마케터

# skiprows =3, header = 0
    이름  나이      직업
0  철수   25    개발자
1  영희   30    디자이너
2  민수   28    마케터

# header = 3
      메타데이터: 이 파일은 테스트용입니다.
0          작성자: 홍길동 NaN NaN
1           날짜: 2025-03-07 NaN NaN
2               이름    나이   직업
3               철수     25   개발자
4               영희     30   디자이너
5               민수     28   마케터