다음을 통해 공유

Power BI Desktop 프로젝트(미리 보기)

  • 아티클

Important

Power BI Desktop 프로젝트는 현재 미리 보기에 있습니다.

팁

Power BI 개발 계획 방법에 대한 지침은 Power BI 구현 계획을 참조하세요.

Power BI Desktop 프로젝트를 작성, 협업 및 저장하는 새로운 방법을 소개합니다. 작업을 Power BI 프로젝트(PBIP)로 저장하면 보고서 및 의미 체계 모델 항목 정의는 간단하고 직관적인 폴더 구조의 개별 일반 텍스트 파일로 저장됩니다.

작업을 프로젝트로 저장하면 다음과 같은 이점이 있습니다.

  • 텍스트 편집기 지원 - 항목 정의 파일은 의미 체계 모델 및 보고서 메타데이터가 포함된 JSON 형식의 텍스트 파일입니다. 이러한 파일은 공개적으로 문서화되어 사람이 읽을 수 있습니다. 프로젝트 파일은 메모장과 같은 간단한 텍스트 편집 도구를 지원하지만, intellisense, 유효성 검사 및 Git 통합을 비롯한 풍부한 편집 환경을 제공하는 Visual Studio Code(VS Code)와 같은 코드 편집기를 사용하는 것이 좋습니다.

  • 프로그래밍 방식 생성 및 항목 편집 정의 - 널리 사용되고 사용하기 쉬운 TMSL(테이블 형식 모델 스크립팅 언어)를 사용하여 스크립트를 만들거나 사용자 지정 애플리케이션을 만들어 항목 정의를 변경할 수 있습니다. 애플리케이션은 항목 정의 스키마 및/또는 클라이언트 라이브러리의 공용 설명서를 기반으로 할 수 있습니다.

  • 소스 제어 - Power BI 의미 체계 모델 및 보고서 항목 정의는 Git과 같은 소스 제어 시스템에 저장할 수 있습니다. Git을 사용하면 버전 기록을 추적하고, 수정 버전(diff)을 비교하고, 이전 버전으로 되돌릴 수 있습니다. 소스 제어는 충돌(병합)을 해결하고 변경 내용(끌어오기 요청)을 검토하는 데 익숙한 협업 메커니즘을 사용하여 Power BI Desktop을 사용할 때 협업 차단을 해제할 수도 있습니다. 자세한 내용은 Git의 버전 제어를 참조하세요.

  • CI/CD(연속 통합 및 지속적인 업데이트) - 조직의 개발자가 CI/CD 시스템에 제안된 변경 내용을 제출하는 시스템을 사용할 수 있습니다. 그런 다음, 시스템은 프로덕션 시스템에 변경 내용을 적용하기 전에 일련의 품질 게이트를 사용하여 변경 내용의 유효성을 검사합니다. 이러한 품질 게이트에는 다른 개발자의 코드 검토, 자동화된 테스트 및 변경 내용의 무결성을 확인하는 자동화된 빌드가 포함될 수 있습니다. CI/CD 시스템은 일반적으로 기존 소스 제어 시스템을 기반으로 빌드됩니다. 자세한 내용은 DevOps - 연속 통합및 DevOps - 지속적인 업데이트를 참조하세요.

미리 보기 기능 활성화

Power BI Desktop에서 Power BI 프로젝트로 저장하기 기능은 현재 미리 보기로 제공되므로, 이를 미리 보기 기능에서 활성화해야 합니다.

파일 > 옵션 및 설정 > 옵션 > 미리 보기 기능으로 이동하여 Power BI 프로젝트(.pbip) 저장 옵션 옆의 확인란을 선택합니다.

프로젝트로 저장

새 프로젝트에서 작업 중이거나 기존 Power BI Desktop 파일(pbix)을 연 경우 작업을 Power BI 프로젝트 파일(pbip)로 저장할 수 있습니다.

저장 파일을 Power BI 프로젝트로 보여 주는 화면.

프로젝트로 저장하면 Power BI Desktop은 보고서 및 의미 체계 모델 항목을 폴더로 저장하며, 각 항목에는 항목을 정의하는 텍스트 파일이 포함되어 있습니다.

Power BI 프로젝트 파일을 보여 주는 화면.

프로젝트로 저장한 후 제목 표시줄을 보면 프로젝트 작업 중인지 확인할 수 있습니다.

프로젝트에 저장할 때 Power BI Desktop 제목을 보여 주는 화면.

제목 표시줄을 선택하면 Power BI 프로젝트에 대한 특정 플라이아웃이 나타납니다. 이 플라이아웃을 사용하면 보고서와 의미 체계 모델에 대한 프로젝트 파일, 표시 이름 설정을 찾을 수 있습니다. 경로를 클릭하여 파일 탐색기에서 폴더를 열 수도 있습니다.

Power BI Desktop 제목 플라이아웃을 보여 주는 화면.

프로젝트의 루트 폴더에 표시되는 내용을 자세히 살펴보겠습니다.

<프로젝트 이름>.SemanticModel

Power BI 의미 체계 모델을 나타내는 파일 및 폴더 컬렉션입니다. 여기에 있는 파일, 하위 폴더 및 파일에 대해 자세히 알아보려면 프로젝트 의미 체계 모델 폴더를 참조하세요.

<project name>.Report

Power BI 보고서를 나타내는 파일 및 폴더의 컬렉션입니다. 여기에서 파일 및 하위 폴더 및 파일에 대한 자세한 내용은 프로젝트 보고서 폴더를 참조하세요.

.gitIgnore

cache.abf 및 localSettings.json과 같은 Power BI 프로젝트 파일에 대해 Git이 무시해야 하는 의도적으로 추적되지 않는 파일을 지정합니다.

Power BI Desktop은 선택한 저장 폴더 또는 부모 Git 리포지토리에 .gitignore 파일이 아직 없는 경우에만 해당 파일을 만듭니다.

PBIP로 저장할 때 .gitignore의 기본 콘텐츠:

**/.pbi/localSettings.json
**/.pbi/cache.abf
<project name>.pbip

PBIP 파일에는 보고서 폴더에 대한 포인터가 포함되어 있습니다. PBIP를 열면 대상 보고서와 작성 모델이 열립니다.

자세한 내용은 pbip 스키마 문서를 참조하세요.

Power BI 프로젝트 열기

보고서 폴더에서 pbip 파일 또는 pbir 파일을 열어 Power BI Project 폴더에서 Power BI Desktop을 열 수 있습니다. 두 옵션 모두 편집을 위해 보고서를 열고, 의미 체계 모델에 대한 상대 참조가 있는 경우 의미 체계 모델을 엽니다.

여러 보고서와 의미 체계 모델을 동일한 폴더에 저장할 수 있습니다. 보고서 폴더 내의 pbir에서 직접 각 보고서를 열 수 있으므로 각 보고서에 대해 별도의 .pbir 파일을 사용할 필요는 없습니다.

├── project
│   ├── AdventureWorks-Sales.Report
│   │   └── definition.pbir
│   ├── AdventureWorks-Stocks.Report
│   │   └── definition.pbir
│   ├── AdventureWorks.SemanticModel
|   |   └── *.*
│   .gitignore
└──  AdventureWorks.pbip

Power BI Desktop 외부 변경 내용

프로젝트로 저장하면 Power BI Desktop에서만 의미 체계 모델 및 보고서 정의를 강제로 변경할 필요가 없습니다. VS Code, 오픈 소스 커뮤니티 도구(예: 테이블 형식 편집기) 또는 메모장과 같은 다른 도구를 사용할 수 있습니다. 그러나 모든 파일 또는 변경 내용이 외부 오픈 소스 도구에서 편집을 지원하는 것은 아닙니다.

Power BI Desktop 외부의 파일 또는 속성을 변경하면 예기치 않은 오류가 발생하거나 Power BI Desktop를 열지 못할 수도 있습니다. 이러한 경우 Power BI Desktop에서 프로젝트를 다시 열기 전에 파일의 문제를 해결해야 합니다.

가능한 경우 Power BI Desktop는 파일 및 오류 위치를 나타냅니다.

파일을 열 수 없음 오류 화면.

다음 파일에 대한 스키마 세부 정보는 문서화되지 않습니다. 미리 보기 동안 Power BI Desktop 외부에서 이러한 파일에 대한 변경 내용은 지원되지 않습니다.

모델 작성

다음 두 가지 방법으로 외부 도구를 사용하여 의미 체계 모델 정의를 변경할 수 있습니다.

  • 외부 도구를 사용하여 Power BI Desktop AS(Analysis Service) 인스턴스에 연결하여.
  • VS Code 또는 다른 외부 도구를 사용하여 model.bim 파일에서 JSON 메타데이터를 편집하여.

모든 모델 개체가 쓰기 작업을 지원하는 것은 아닙니다. 지원되는 변경 내용을 적용하면 예기치 않은 결과가 발생할 수 있습니다.

쓰기 작업을 지원하는 개체:

Object AS 인스턴스에 연결 파일 변경
테이블 예 예
열 예 1, 2 예
계산된 테이블 예 예
계산 열 예 예
계층 구조 예 예
관계 예 예
측정값 그룹 예 예
모델 KPI 예 예
계산 그룹 예 예
Perspectives 예 예
번역 예 예
행 수준 보안(RLS) 예 예
OLS(개체 수준 보안) 예 예
주석 예 예
M 식 아니요 예 3, 4

다음 사항에 유의하세요.

  • Power BI Desktop 외부에서 열린 파일을 변경한 경우 해당 변경 내용을 Power BI Desktop에 표시하려면 다시 시작해야 합니다. Power BI Desktop은 다른 도구에서 만든 프로젝트 파일의 변경 내용을 인식하지 못합니다.

  • Power BI Desktop은 여러 파티션이 있는 테이블을 지원하지 않습니다’. 각 테이블에 대해 단일 파티션만 지원됩니다. 빈 파티션 또는 둘 이상의 파티션이 있는 테이블을 만들면 보고서를 열 때 오류가 발생합니다.

  • Power BI Desktop에서 만든 자동 날짜 테이블은 외부 도구를 사용하여 변경할 수 없습니다.

  • Direct Query를 사용하여 Power BI 의미 체계 모델 또는 Analysis Services 모델을 연결하는 모델을 변경하는 경우 변경되었거나 제거된 속성을 포함하도록 변경된 개체의 ChangedProperties 및 PBI_RemovedChildren 컬렉션을 업데이트해야 합니다. ChangedProperties 및/또는 PBI_RemovedChildren이 업데이트되지 않으면 Power BI Desktop은 다음에 쿼리를 편집하거나 Power BI Desktop 모델을 새로 고칠 때 변경 내용을 덮어쓸 수 있습니다.

  • 1 - 열의 데이터 형식 변경이 지원됩니다. 그러나 AS 인스턴스에 연결할 때는 열 이름 바꾸기가 지원되지 않습니다.

  • 2 - 의미 체계 모델에 자동 날짜/시간 기능이 사용하도록 설정되어 있고 Power BI Desktop 외부에서 새 날짜/시간 열을 만드는 경우 로컬 날짜 테이블이 자동으로 생성되지 않습니다.

  • 3 - 파티션 SourceType은 Calculated, M, Entity 또는 CalculationGroup이어야 합니다. 파티션 모드는 가져오기, DirectQuery 또는 이중이어야 합니다.

  • 4 - unappliedChanges.json이 있는 프로젝트의 Power BI Desktop 외부에서 편집되는 식은 변경 내용이 적용될 때 손실됩니다.

  • Power BI Desktop 외부에서 테이블 쿼리 식을 수정하면 Power BI Desktop을 다시 시작할 때 테이블 데이터가 제거됩니다.

JSON 파일 스키마

대부분의 프로젝트 파일에는 JSON 형식의 메타데이터가 포함되어 있습니다. 해당 JSON 스키마는 유효성 검사 및 설명서에 사용할 수 있습니다.

JSON 스키마를 사용하면 다음을 수행할 수 있습니다.

  • 구성 가능한 속성에 대해 알아봅니다.
  • 코드 편집기에서 제공하는 인라인 JSON 유효성 검사를 사용합니다.
  • 구문 강조 표시, 도구 설명 및 자동 완성을 사용하여 작성을 개선합니다.
  • 프로젝트 메타데이터 내에서 지원되는 속성에 대한 지식이 있는 외부 도구를 사용합니다.

VS Code를 사용하여 JSON 스키마를 작성 중인 파일에 매핑합니다. 프로젝트 파일에 대한 JSON 스키마는 Power BI Desktop 샘플 Git 리포지토리에 제공됩니다.

고려 사항 및 제한 사항

  • Power BI Desktop은 다른 도구 또는 애플리케이션의 변경 내용을 인식하지 못합니다. 외부 도구를 사용하여 변경한 내용은 변경 내용이 표시되기 전에 Power BI Desktop을 다시 시작해야 합니다.
  • 민감도 레이블은 Power BI 프로젝트에서 지원되지 않습니다.
  • 서비스에서 모델을 편집할 때 다이어그램 보기가 무시됩니다.
  • Power BI 프로젝트로 저장할 때 프로젝트 파일 경로의 최대 길이는 260자입니다.
  • Power BI Desktop에서는 OneDrive 및 SharePoint에 직접 PBIP로 저장할 수 없습니다.
  • Power BI Desktop 외부에서 PBIP 파일을 편집할 때는 BOM 인코딩 없이 UTF-8을 사용하여 저장해야 합니다.
  • Power BI 프로젝트에서는 보고서 언어 스키마가 지원되지 않습니다.
  • Power BI Desktop CRLF를 줄 끝으로 사용합니다. diff의 문제를 방지하려면 autocrlf를 사용하도록 설정하여 줄 끝을 처리하도록 Git을 구성합니다.
  • Power BI 프로젝트는 현재 Power BI Report Server에 최적화된 Microsoft Power BI Desktop 버전에서 지원되지 않습니다.
  • PBIP로 저장된 라이브 연결 보고서에는 XMLA 엔드포인트를 사용하도록 설정해야 합니다.

자주 묻는 질문

질문: 의미 체계 모델 및 보고서 항목 폴더 정의를 보면 몇 개의 파일만 필수로 표시되어 있습니다. 삭제하면 어떻게 되나요?

답변: Power BI Desktop에서 프로젝트(PBIP)로 저장할 때 자동으로 만듭니다.

질문: 외부 도구 또는 애플리케이션에서 Power BI Project 파일의 변경 내용을 Power BI Desktop은 인식하나요?

대답: 아니요. 파일을 변경하려면 해당 변경 내용을 반영하기 위해 Power BI Desktop을 다시 시작해야 합니다.

질문: PBIX를 PBIP로 변환하는 경우 PBIX로 다시 변환할 수 있나요?

답변: 예. PBIX를 PBIP로 저장하거나 PBIP를 PBIX로 저장할 수 있습니다.

질문: PBIX를 PBIP로 변환하거나 프로그래밍 방식으로 변환할 수 있나요?

대답: 아니요. Power BI Desktop의 파일>다른 이름으로 저장을 사용하여 PBIX를 PBIP로 또는 그 반대로 변환할 수 있습니다.

질문: AAS(Azure Analysis Services) 또는 SQL SSAS(Server Analysis Services)에 Power BI Desktop 프로젝트를 배포할 수 있나요?

대답: 아니요. Power BI Desktop 프로젝트 보고서 정의는 AAS 및 SSAS에서 지원되지 않습니다. 모델 정의는 Power BI의 고유한 향상된 메타데이터를 사용합니다. AAS 및 SSAS 프로젝트의 경우 모델 작성, Git 및 Azure DevOps 통합에 Microsoft Visual Studio를 사용합니다.

질문: Fabric 작업 영역을 Git에 연결할 때 *.pbip 파일이 없는 이유는 무엇인가요? Power BI Desktop에서 보고서와 의미 체계 모델을 편집하려면 어떻게 해야 하나요?

답변: PBIP 파일은 선택 사항이며 보고서 폴더에 대한 바로 가기 역할만 합니다. 보고서 폴더에 있는 정의.pbir 파일을 열어 Power BI Desktop에서 편집할 보고서와 의미 체계 모델을 모두 열 수 있습니다.

관련 콘텐츠