Power BI Dataflow 특정 컬럼을 찾을 수 없다는 오류 해결 방법

반응형

Power BI Dataflow을 사용하다 보면, “The column of the table wasn’t found” 라는 메시지와 함께 데이터 새로 고침이 실패하는 경우가 있습니다. 쿼리 코드 어디에도 그 컬럼을 사용하지 않았는데도 불구하고 이런 오류가 발생한다면, 거의 대부분은 메타데이터 캐시 불일치 문제 때문입니다.

---

💡 오류 증상

데이터 원본(예: Redshift, SQL, Azure 등)에서 특정 테이블을 불러오고 필터만 걸었는데도, Dataflow 실행 시 다음과 같은 에러가 발생합니다.

Error: Encountered user gateway exception: "The column of the table wasn’t found."

이 에러는 실제 쿼리나 연결에 문제가 있는 게 아니라, Power BI가 과거의 스키마 정보를 캐시해 둔 상태에서 원본 DB가 변경되었기 때문에 생기는 현상입니다.

---

🧠 왜 이런 문제가 생길까?

Power Query나 Dataflow은 테이블을 처음 불러올 때, 내부적으로 해당 테이블의 구조(스키마)를 메타데이터로 저장합니다. 하지만 원본 데이터베이스에서 어떤 컬럼이 삭제되거나 이름이 바뀌면, Power BI는 여전히 이전 스키마를 참고하기 때문에 존재하지 않는 컬럼을 찾으려다 오류가 발생합니다.

즉, 쿼리에는 없는 컬럼을 시스템 내부에서 “있다고 착각”하는 상태가 되어버린 것이죠.

---

🧩 해결 방법

이 문제는 단순히 쿼리 수정을 해도 해결되지 않습니다. Dataflow의 스키마를 새로 고침(reset)해 Power BI가 올바른 구조를 다시 읽어오게 해야 합니다.

🔧 방법 1. 쿼리 단계 강제 새로고침

1. 문제가 발생한 쿼리를 선택합니다.
2. Source 단계(Source Step)를 삭제합니다.
3. 같은 데이터 원본에 다시 연결해 동일한 테이블을 불러옵니다.
4. 필요한 필터를 다시 적용하고 미리보기를 새로 고침합니다.

이 과정을 거치면 Power Query가 최신 스키마를 새로 읽어오며, 캐시된 이전 메타데이터가 초기화됩니다.

🔧 방법 2. 데이터플로 전체 스키마 리셋

1. Dataflow 편집 창에서 상단 메뉴의 View → Diagram view로 이동합니다.
2. 오른쪽 상단의 “Schema refresh” 또는 “Refresh all”을 클릭합니다.
3. 저장 후 Dataflow를 닫았다가 다시 엽니다.
4. 오류가 사라졌는지 확인합니다.

이 방법은 전체 쿼리의 구조를 리셋하기 때문에, 캐시 관련 문제를 가장 깔끔하게 해결합니다.

🔧 방법 3. 로컬 캐시 삭제 (Power BI Desktop 환경)

1. File → Options → Data Load → Clear Cache 로 이동합니다.
2. 캐시를 비운 후 Power BI를 재시작하고 다시 Dataflow를 불러옵니다.

이 방식은 로컬 환경에서 이전 메타데이터가 남아 있을 때 효과적입니다.

---

✅ 정리하자면

문제의 원인은 특정 컬럼을 참조해서가 아니라, Power BI가 과거 스키마 정보를 캐싱해둔 상태에서 원본 데이터베이스가 변경되었기 때문입니다.

• ✔ 쿼리 자체에는 오류 없음
• ✔ 원본 DB에서 컬럼 구조 변경 발생
• ✔ Power BI 캐시 초기화 필요

해결책은 간단합니다. 쿼리의 Source 단계를 한 번 삭제 후 재연결하거나, Dataflow 전체 스키마를 새로 고침하면 됩니다.

---

📈 마무리

Power BI Dataflow 오류 중 “컬럼을 찾을 수 없습니다” 유형은 초보자부터 전문가까지 자주 겪는 이슈입니다. 이 문제를 빠르게 해결하려면, 불필요한 쿼리 수정보다는 스키마 캐시 초기화가 가장 효과적입니다.

이 방법으로 해결한 뒤에는 Refresh 시 오류가 재발하지 않으며, 새로운 스키마가 반영된 최신 데이터 구조로 안정적으로 쿼리를 실행할 수 있습니다.

---

💬 이 글이 도움이 되셨다면 “Power BI Dataflow 오류 해결법”, “스키마 불일치 해결”, “Power Query 캐시 초기화” 같은 키워드로 저장해두세요!