Power BI Desktop 프로젝트 의미 체계 모델 폴더

Important

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

이 문서에서는 Microsoft Power BI Desktop 프로젝트의 의미 체계 모델 폴더에 있는 파일 및 하위 폴더에 대해 설명합니다. 여기에 있는 파일 및 하위 폴더는 Power BI 의미 체계 모델을 나타냅니다. 프로젝트에 따라 의미 체계 모델 폴더에는 다음이 포함될 수 있습니다.

• .pbi\
  • localSettings.json
  • editorSettings.json
  • cache.abf
  • unappliedChanges.json
• definition.pbism¹
• model.bim²
• definition\ folder³
• diagramLayout.json
• .platform

1 - 이 파일이 필요합니다.
2 - 이 파일은 TMSL 형식을 사용하여 저장할 때 필요합니다.
3 - 이 파일은 TMDL 형식을 사용하여 저장할 때 필요합니다.

모든 프로젝트 의미 체계 모델 폴더에 여기에 설명된 모든 파일 및 하위 폴더가 포함되지는 않습니다.

의미 체계 모델 파일

.pbi\localSettings.json

현재 사용자 및 컴퓨터에만 적용되는 의미 체계 모델 설정을 포함합니다. gitIgnore 또는 기타 소스 제어 제외에 포함되어야 합니다. 기본적으로 Git은 이 파일을 무시합니다.

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

.pbi\editorSettings.json

여러 사용자와 환경에서 사용할 수 있도록 의미 체계 모델 정의의 일부로 저장된 의미 체계 모델 편집기 설정이 포함되어 있습니다.

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

.pbi\cache.abf

마지막으로 편집한 모델 및 데이터의 로컬 캐시 복사본을 포함하는 ABF(Analysis Services Backup) 파일입니다. gitIgnore 또는 기타 소스 제어 제외에 포함되어야 합니다. 기본적으로 Git은 이 파일을 무시합니다.

Power BI Desktop은 cache.abf 파일 없이 프로젝트를 열 수 있습니다. 이 경우 전체 정의가 있지만 데이터가 없는 모델에 연결된 보고서가 열립니다. cache.abf가 있는 경우 Power BI Desktop은 데이터를 로드하고 model.bim의 콘텐츠로 모델 정의를 덮어씁니다.

.pbi\unappliedChanges.json

Power BI Desktop은 데이터 모델에 변경 내용을 적용하지 않고도 Power Query(데이터 변환 편집기)에서 변경한 내용을 저장할 수 있습니다.

나중에 적용을 선택하면 적용되지 않은 변경 내용이 unappliedChanges.json 파일에 저장됩니다. 보류 중인 변경 내용이 unappliedChanges 파일에 있는 경우 Power BI Desktop은 보류 중인 변경 내용을 적용하거나 취소하라는 메시지를 표시합니다.

변경 내용 적용을 선택하면 Power BI Desktop은 model.bim의 쿼리를 unappliedChanges.json의 쿼리로 덮어씁니다. Power BI Desktop 외부에서 model.bim의 쿼리를 편집했으며 기존 unappliedChanges.json 파일이 있는 경우 변경 사항이 적용될 때 변경 내용이 손실되고 unappliedChanges.json의 쿼리로 대체됩니다.

unappliedChanges.json 파일은 의미 체계 모델 정의에 자동으로 통합되고 기본적으로 Git에 저장됩니다. 이렇게 하면 진행 중인 작업을 개발 분기에 커밋하여 백업 역할을 하고 다른 팀 구성원이 액세스할 수 있도록 할 수 있습니다. 하지만 이 파일을 Git의 추적에서 제외하여 완료되지 않은 쿼리 작업이 다른 개발자에게 영향을 미치지 않도록 할 수 있습니다.

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

definition.pbism

의미 체계 모델 및 핵심 설정의 전체 정의를 포함합니다.

또한 이 파일은 'version' 속성을 통해 지원되는 의미 체계 모델 정의 형식을 지정합니다.

버전	지원되는 형식
1.0	의미 체계 모델 정의는 model.bim 파일에 TMSL로 저장되어야 합니다.
4.0 이상	의미 체계 모델 정의는 TMSL(model.bim 파일) 또는 TMDL(\definition 폴더)로 저장할 수 있습니다.

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

model.bim

이 파일은 Power BI 프로젝트가 TMSL 형식을 사용하여 저장된 경우에만 사용할 수 있습니다. 프로젝트 모델의 TMSL(테이블 형식 모델 스크립팅 언어) 데이터베이스 개체 정의를 포함합니다.

definition\ 폴더

이 폴더는 Power BI 프로젝트가 TMDL 형식을 사용하여 저장된 경우에만 사용할 수 있습니다. model.bim 파일을 대체합니다.

이 폴더에는 프로젝트 모델의 TMDL(테이블 형식 모델 정의 언어) 데이터베이스 개체 정의가 포함되어 있습니다.

diagramLayout.json

보고서와 연결된 의미 체계 모델의 구조를 정의하는 다이어그램 메타데이터를 포함합니다. 미리 보기 동안 이 파일은 외부 편집을 지원하지 않습니다.

좋습니다.

Fabric 항목과 Git 간의 연결을 설정하고 유지하는 데 필수적인 속성을 보유하는 Fabric 플랫폼 파일입니다.

자세한 내용은 Git 통합 자동 생성 시스템 파일을 참조하세요.

TMDL 형식

더 나은 소스 제어 및 공동 개발 환경을 제공하기 위해 TMDL(테이블 형식 모델 정의 언어)을 의미 체계 모델 파일 형식으로 사용하여 PBIP(Power BI 프로젝트 파일)를 저장할 수 있습니다.

TMSL(테이블 형식 모델 스크립팅 언어)과 달리 TMDL은 처음부터 인간 친화적으로 설계되어 가독성이 훌륭할 뿐만 아니라 모든 텍스트 편집기에서 쉽게 편집할 수 있습니다. 이는 소스 제어 및 협업 개발 환경을 크게 향상시킵니다.

TMSL(테이블 형식 모델 스크립팅 언어)과 같은 큰 JSON 파일 대신 TMDL에는 각 테이블, 큐브 뷰, 역할 및 문화권에 대해 별도의 파일이 있는 폴더 구조가 있습니다. 이렇게 하면 폴더 및 파일을 보는 것만으로도 다른 사용자와 작업하고 의미 체계 모델 구조를 쉽게 이해할 수 있습니다. 궁극적으로 이는 git diff 및 병합 충돌을 처리할 때 훌륭한 소스 제어 및 공동 개발 환경으로 이어집니다.

여기에서 TMDL대해 자세히 알아보세요.

TMDL 형식 미리 보기 기능 사용

TMDL을 사용하여 Power BI 프로젝트로 저장하는 것은 현재 미리 보기 상태입니다. 이 기능을 사용하기 전에 먼저 미리 보기 기능에서 활성화해야 합니다.

파일 > 옵션 및 설정 > 옵션 > 미리 보기 기능으로 이동하여 TMDL 형식을 사용하여 스토어 의미 체계 모델 옆의 확인란을 선택합니다.

TMDL을 사용하여 프로젝트로 저장

TMDL 미리 보기 기능을 활성화하면 프로젝트를 저장할 때 의미 체계 모델이 의미 체계 모델 폴더 내에 \definition이라는 이름의 TMDL 폴더로 저장됩니다.

TMDL 폴더 구조에 대해 자세히 알아봅니다.

기존 PBIP를 TMDL로 변환

TMSL을 의미 체계 모델 형식으로 사용하는 PBIP가 이미 있는 경우 다음과 같이 TMDL로 변환할 수 있습니다.

1. Power BI Desktop에서 PBIP를 엽니다.

2. 미리 보기 기능이 사용하도록 설정되어 있는지 확인합니다.

3. 프로젝트를 저장합니다. TMDL로 업그레이드하라는 메시지가 나타납니다.

4. 업그레이드를 선택합니다.

   Important

   TMDL로 업그레이드한 후에는 TMSL로 되돌릴 수 없습니다. TMSL로 되돌리려는 경우 먼저 PBIP 파일의 복사본을 저장합니다.

   

기존 TMSL(테이블 형식 모델 스크립팅 언어) 파일(model.bim)은 의미 체계 모델의 TMDL 표현을 포함하는 \definition 폴더로 바뀝니다.

현재 형식 유지를 선택하면 데스크톱에서 업그레이드하라는 메시지를 다시 표시하지 않습니다.

TMDL 파일의 외부 변경

TMDL 파일을 읽고 편집하는 더 나은 환경을 위해 TMDL - Visual Studio Marketplace Microsoft VS Code 확장을 설치합니다.

VS Code를 사용하여 PBIP 폴더를 열고 의미 체계 모델 정의 폴더로 이동합니다.

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

Power BI Desktop 외부에서 지원되는 쓰기 작업은 여기를 참조하세요.

TMDL 오류

TMDL 파일을 잘못 편집한 경우 Power BI Desktop을 열면 오류 위치와 함께 오류 메시지가 표시됩니다.

TMDL 고려 사항 및 제한 사항

공개 미리 보기 동안 Fabric Git Integration은 기본적으로 TMSL을 사용하여 의미 체계 모델을 내보냅니다. 그러나 TMDL 형식과 패브릭 Git 통합을 사용하여 의미 체계 모델을 패브릭으로 가져오는 경우 패브릭 Git 통합은 서비스에 의미 체계 모델 변경 내용이 있는 경우 TMDL 형식을 사용하여 의미 체계 모델 정의를 Git으로 내보냅니다.

Important

Power BI Desktop 게시와 같은 다른 가져오기 방법을 사용하여 의미 체계 모델을 가져오는 경우 패브릭 Git 통합은 기본 TMSL 형식으로 다시 전환됩니다.

관련 콘텐츠

• Power BI Desktop 프로젝트 보고서 폴더
• Power BI Desktop 프로젝트
• 테이블 형식 모델 스크립팅 언어(TMSL)