본문 바로가기
Python/Pandas

pandas KeyError: 'nonexistent_column' 오류 해결하기

by PySun 2025. 5. 8.
반응형

소개

파이썬에서 pandas를 사용할 때 'KeyError: 'nonexistent_column'' 오류는 매우 흔하게 발생하는 문제입니다. 이 오류는 데이터프레임에 존재하지 않는 열(column)에 접근하려 할 때 발생합니다. 오늘은 이 오류가 발생하는 원인과 이를 해결하는 몇 가지 방법을 소개하겠습니다.

에러 발생 예시 코드

먼저, 'KeyError: 'nonexistent_column''이 발생할 수 있는 간단한 예시 코드를 확인해 봅시다.

import pandas as pd

# 데이터프레임 생성
data = {'name': ['Alice', 'Bob'], 'age': [25, 30]}
df = pd.DataFrame(data)

# 존재하지 않는 열에 접근 시도
print(df['nonexistent_column'])

에러 해결 방법

1. 올바른 열 이름 사용

가장 간단한 오류 해결 방법은, 데이터프레임에 존재하는 열 이름을 사용하여 올바르게 접근하는 것입니다. 열 이름이 철자가 맞는지 확인하십시오.

import pandas as pd

# 데이터프레임 생성
data = {'name': ['Alice', 'Bob'], 'age': [25, 30]}
df = pd.DataFrame(data)

# 올바른 열 이름 사용
print(df['name'])

2. 열 이름 목록 확인

데이터프레임에 어떤 열들이 있는지 확인하기 위해 'columns' 속성을 사용하여 열 목록을 확인할 수 있습니다. 이렇게 하면 가능한 열 이름을 쉽게 확인할 수 있습니다.

import pandas as pd

# 데이터프레임 생성
data = {'name': ['Alice', 'Bob'], 'age': [25, 30]}
df = pd.DataFrame(data)

# 열 목록 확인
print(df.columns)

# 존재하는 열에 접근
print(df['age'])

3. 조건부 접근 사용

특정 열이 존재할 때만 접근하려면 조건부 접근을 사용할 수 있습니다. 'in' 키워드를 사용하여 열이 존재하는지 확인한 후 접근합니다.

import pandas as pd

# 데이터프레임 생성
data = {'name': ['Alice', 'Bob'], 'age': [25, 30]}
df = pd.DataFrame(data)

# 조건부 열 접근
if 'nonexistent_column' in df.columns:
    print(df['nonexistent_column'])
else:
    print("열이 존재하지 않습니다.")

마무리

이번 블로그 글에서는 pandas에서 발생하는 'KeyError: 'nonexistent_column'' 오류에 대한 원인과 몇 가지 해결 방법을 살펴보았습니다. 올바른 열 이름을 사용하고, 열 목록을 확인하며, 조건부 접근을 활용함으로써 이러한 오류를 효과적으로 처리할 수 있습니다. pandas는 데이터 분석에 매우 유용한 도구이므로, 사용 시 주의 깊게 열 이름을 다루는 것이 중요합니다.

반응형