캐시 정리 (Excel & Power BI)
Business Central에 새 API를 배포한 후 메타데이터 및 캐시된 스키마 충돌을 해결하기 위한 운영 프로토콜.
0조회
지속 통합(CI/CD) 운영에서 우리는 AL 언어로 작성된 API를 수정하여 새로운 열을 추가하거나 기존 이름을 변경합니다 (예: numDocumento에서 Num_Documento로 변경).
Business Central에서 배포가 성공적이더라도, Microsoft의 클라이언트 도구(Excel 및 Power BI Desktop)는 대역폭을 절약하기 위해 매우 공격적인 메타데이터 캐시 시스템을 사용합니다. 이로 인해 오래된 스키마 "사진"을 기반으로 API를 읽으려고 시도하여 데이터 수집이 완전히 중단됩니다.
1. 클래식한 오류: “Property does not exist”
Sección titulada «1. El Error Clásico: “Property does not exist”»이 충돌의 명확한 증상은 Power Query에서 다음과 같은 오류가 발생하는 것입니다:
Detalles: "OData: The property 'numDocumento' does not exist on type 'Microsoft.NAV.comercialAlbaranCompra'. Make sure to only use property names that are defined by the type or mark the type as open type."DevSecOps 진단: 원본 데이터베이스가 변경되었지만, 로컬 클라이언트(Excel/Power BI)는 OData의 새로운 문서 $metadata를 다운로드하지 않으려고 합니다. 여전히 오래된 열을 요청하고 서버는 요청을 거부합니다.
2. Microsoft Excel에서 정리 프로토콜
Sección titulada «2. Protocolo de Limpieza en Microsoft Excel»Excel에서 Power Query를 통해 분석 API를 직접 사용할 때, 스키마 업데이트를 강제하려면 두 가지 서로 다른 캐시를 제거해야 합니다:
- 옵션 띠에서 데이터 탭으로 이동합니다.
- 데이터 가져오기 -> 데이터 원본 설정 (Data Source Settings)을 클릭합니다.
- 전역 원본 또는 현재 통합 문서 원본 목록에서 Business Central API 경로를 검색합니다.
- 권한 삭제 (Clear Permissions)을 클릭합니다.
B단계: 데이터 캐시 정리
Sección titulada «Paso B: Limpieza de la Caché de Datos»- Power Query 편집기를 엽니다(오른쪽 패널의 쿼리를 두 번 클릭).
- 파일 -> 옵션 및 설정 -> 쿼리 옵션으로 이동합니다.
- 왼쪽 패널의 "전역" 섹션에서 데이터 로드를 선택합니다.
- 캐시 삭제 버튼을 클릭합니다.
- 마지막으로 Power Query 편집기에서 미리 보기 업데이트 버튼을 클릭합니다. 시스템은 다시 인증하고 새 열을 올바르게 읽습니다.
3. Power BI Desktop 정리 프로토콜
Sección titulada «3. Protocolo de Limpieza en Power BI Desktop»Power BI의 동작은 Excel과 동일하지만, 옵션 배치가 약간 다릅니다.
- 파일 -> 옵션 및 설정 -> 옵션으로 이동합니다.
- 왼쪽 사이드메뉴의 "전역" 항목에서 데이터 로드 (Data Load)를 선택합니다.
- 데이터 캐시 옵션 섹션에서 캐시 삭제를 클릭합니다.
- (선택 사항) Q&A를 사용하는 경우 “Q&A 캐시 지우기”를 클릭합니다.
- 옵션 창을 닫습니다.
- 메인 뷰(또는 Power Query)에서 업데이트를 클릭합니다. 로컬 캐시를 찾지 못하면 Power BI는 새로운 JSON API 스키마를 다운로드하기 위해 HTTP 호출을 수행하여 오류를 즉시 해결합니다.
4. 캐시 유지관리 체크리스트
Sección titulada «4. Checklist de Mantenimiento de Caché»- ✓ 권한 디버깅: Entra ID의 UPN 변경 또는 재구성 후 손상된 글로벌 자격 증명 삭제.
- ✓ 스키마 업데이트: Power Query에서 로컬 데이터 캐시를 정리하여 ERP의 문서
$metadata을 다시 로드합니다. - ✓ 최종 검증: Power Query 뷰에서 가져온 열을 검증하여 AL의 현재 정의와 일치하는지 확인합니다.

