Power BI Desktop 프로젝트로 작업을 저장하면 Power BI Desktop은 보고서 및 의미 체계 모델 정의를 개별 텍스트 파일로 저장합니다. 프로젝트가 Power BI Desktop에서 열려 있는 동안 VS Code(Visual Studio Code) 또는 다른 외부 도구를 사용하여 지원되는 파일을 편집할 수 있습니다. Power BI Desktop은 저장된 파일 변경 내용을 감지하고 적용하라는 메시지를 표시하므로 프로젝트를 닫았다가 다시 열 필요가 없습니다.
Important
Power BI 데스크톱 프로젝트(PBIP) 및 Power BI 향상된 보고서 형식(PBIR)을 일반적으로 사용할 수 있습니다. Power BI Desktop에서 외부 PBIP 변경 내용 검색 및 다시 로드는 현재 미리 보기로 제공됩니다.
이 문서에서는 다음에 대해 알아봅니다.
- 프로젝트 파일을 편집하기 위한 편리한 진입점으로 Power BI Desktop에서 직접 Visual Studio Code 여는 방법입니다.
- 열려 있는 Power BI 데스크톱 세션에서 지원되는 보고서 및 의미 체계 모델 파일 변경 내용을 적용하는 방법입니다.
- Power BI Desktop이 Power BI Desktop의 저장되지 않은 변경 내용과 프로젝트 파일의 변경 내용 간의 충돌을 처리하는 방법입니다.
PBIP 파일을 외부에서 편집하기 위한 필수 구성 요소
- Windows 컴퓨터에 Power BI Desktop의 2026년 8월 릴리스 이상을 설치합니다.
- Power BI Desktop에서 파일>옵션 및 설정>옵션>미리 보기 기능을 선택하고, 외부 PBIP 변경 내용 검색 및 다시 로드를 사용하도록 설정한 다음, Power BI Desktop을 다시 시작합니다.
- Visual Studio Code 또는 다른 코드 편집기 또는 외부 도구를 설치합니다.
- Power BI Desktop 프로젝트를 PBIP 형식으로 저장합니다. 자세한 내용은 Power BI Desktop 프로젝트를 참조하세요.
- PBIP 루트 폴더를 각 프로젝트 파일 경로를 Windows 260자 경로 제한 미만으로 유지하는 위치에 저장합니다.
VS Code에서 PBIP 폴더 열기
Power BI Desktop은 프로젝트 폴더에 대한 기본 제공 진입점을 제공합니다. 제목 표시줄에서 프로젝트 이름을 선택한 다음 Visual Studio Code 선택합니다. VS Code는 프로젝트 폴더를 활성 작업 영역으로 열어 보고서 및 의미 체계 모델 정의 파일에 액세스할 수 있습니다.
Note
VS Code는 프로젝트를 여는 데 사용한 파일이 포함된 폴더를 엽니다. 이 폴더는 .pbip 파일일 .pbir 수 있습니다.
프로젝트 파일 편집 및 변경 내용 적용
다음 워크플로를 사용하여 프로젝트 파일과 열린 Power BI 데스크톱 세션을 동기화된 상태로 유지합니다.
- Power BI Desktop에서 프로젝트 파일을 외부에서 편집하기 전에 저장을 선택합니다. Power BI Desktop은 저장할 때까지 프로젝트 파일에 최신 변경 내용을 작성하지 않습니다.
- VS Code 또는 다른 외부 도구에서 지원되는 보고서 또는 의미 체계 모델 파일을 편집합니다.
- 외부 도구에 파일을 저장합니다.
- Power BI 바탕 화면에서 표시되는 배너에서 외부 변경 내용 적용을 선택합니다.
- Power BI Desktop에서 업데이트된 보고서 또는 의미 체계 모델을 검토한 다음, Power BI Desktop에서 후속 변경 내용을 유지할 준비가 되면 프로젝트를 저장합니다.
Power BI Desktop은 영향을 받는 보고서, 의미 체계 모델 또는 둘 다 프로젝트 파일에서 다시 로드합니다. 개별 파일이나 시각적 개체를 다시 로드하지는 않습니다.
Power BI Desktop에서 저장되지 않은 변경 내용 해결
Power BI Desktop에 저장되지 않은 변경 내용이 포함된 경우 외부 변경 내용 적용을 선택하면 해당 변경 내용을 덮어쓸 것이라는 경고가 표시됩니다.
- 외부 변경 내용 적용을 선택하여 Power BI Desktop에서 저장되지 않은 변경 내용을 취소하고 최신 프로젝트 파일을 다시 로드합니다.
- Power BI Desktop에서 저장되지 않은 변경 내용을 유지하려면 [취소]를 선택합니다. 외부 파일 변경 내용은 디스크에 남아 있지만 열려 있는 세션에는 적용되지 않습니다.
Important
Power BI 데스크톱 및 외부 도구는 서로의 변경 내용을 덮어쓸 수 있습니다. 이러한 변경 내용을 전환하기 전에 두 도구에서 동일한 프로젝트 정의를 사용하도록 현재 변경 내용을 저장하거나 적용합니다.
Power BI 바탕 화면 브리지를 사용하여 외부 변경 내용 적용
Power BI 데스크톱 브리지를 사용하여 프로그래밍 방식으로 외부 변경 내용을 적용할 수도 있습니다.
고려사항 및 제한사항
- 외부 PBIP 변경 내용 및 Power BI 데스크톱 브리지 검색 및 다시 로드는 현재 미리 보기로 제공됩니다. 기능 및 동작은 일반 공급 전에 변경될 수 있습니다.
- 외부 편집 및 다시 로드는 파일이 아닌
.pbixPBIP 프로젝트에 적용됩니다. - Power BI Desktop은 다시 로드
cache.abf되지 않습니다. - 다시 로드하면 필터 및 일부 사용자 인터페이스 요소가 다시 설정됩니다.
- 모든 프로젝트 파일이 외부 편집을 지원하지는 않습니다. 외부 변경 내용 다시 로드 미리 보기 중에는 Power BI Desktop 외부에서
semanticModelDiagramLayout.json,definition.pbir,report.json또는mobileState.json을 편집할 수 없습니다. - 프로젝트에 포함된
unappliedChanges.json경우 의미 체계 모델 식을 외부에서 편집하기 전에 해당 변경 내용을 적용합니다. 그렇지 않으면 Power BI Desktop은 보류 중인 변경 내용을 적용할 때 외부 식 변경 내용을 삭제합니다.