Share via

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

  • 아티클

Important

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

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

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

  • 텍스트 편집기 지원 - 항목 정의 파일은 의미 체계 모델 및 보고서 메타데이터를 포함하는 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 - 지속적인 업데이트를 참조하세요.

동영상

Microsoft Build 2023에서 도입되는 Power BI Desktop 프로젝트 및 기타 개발자 모드 기능을 참조하세요.

미리 보기 기능 활성화

Power BI Desktop 프로젝트로 저장은 현재 미리 보기에 있습니다. 이 기능을 사용하려면 Premuim 라이선스가 필요하며 미리 보기 기능에서 사용하도록 설정해야 합니다.

사용하도록 설정하려면 Power BI Desktop >파일>옵션 및 설정>옵션>미리 보기 기능에서 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 의미 체계 모델을 나타내는 파일 및 폴더의 컬렉션입니다. 여기에는 model.bim과 같이 작업할 가능성이 가장 높은 몇 가지 중요한 파일이 포함되어 있습니다. 여기에 있는 파일 및 하위 폴더 및 파일에 대한 자세한 내용은 프로젝트 의미 체계 모델 폴더를 참조 하세요.

<project name>.Report

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

.gitIgnore

Git이 무시해야 하는 의도적으로 추적되지 않은 파일을 지정합니다. Power BI Desktop은 .gitignore 파일이 없는 경우 저장할 때 루트 폴더에 만듭니다.

의미 체계 모델 및 보고서 하위 폴더에는 각각 .gitIgnore에 지정된 기본 git 무시 파일이 있습니다.

├── project
│   ├── *.SemanticModel
│   │   ├── .pbi
│   │   │   ├── localSettings.json
│   │   │   └── cache.abf
│   ├── *.Report
│   │   ├── .pbi
│   │   │   └── localSettings.json
<project name>.pbip

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

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

Power BI 프로젝트 열기

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

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

├── 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에서 만든 자동 날짜 테이블은 외부 도구를 사용하여 변경할 수 없습니다.

  • 직접 쿼리를 사용하여 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에서는 PBIP로 OneDrive 및 SharePoint에 직접 저장할 수 없습니다.
  • Power BI Desktop 외부에서 PBIP 파일을 편집할 때는 BOM 인코딩 없이 UTF-8을 사용하여 저장해야 합니다.
  • 보고서 언어 스키마는 Power BI 프로젝트에서 지원되지 않습니다.
  • Power BI Desktop CRLF를 줄 끝으로 사용합니다. diff의 문제를 방지하려면 autocrlf를 사용하도록 설정하여 줄 끝을 처리하도록 Git을 구성합니다.
  • Power BI 프로젝트는 현재 Microsoft Power BI Desktop에서 지원되지 않습니다(Power BI Report Server에 최적화됨).

자주 묻는 질문

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

답변: 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를 사용합니다.

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

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

관련 콘텐츠