Git 통합 소스 코드 형식
Microsoft Fabric의 항목은 폴더에 저장됩니다. 항목이 포함된 폴더는 루트 디렉터리 또는 하위 디렉터리에 있을 수 있습니다. 작업 영역을 git에 연결할 때 항목이 포함된 폴더에 연결합니다. 폴더의 각 항목은 자체 하위 디렉터리에 표시됩니다.
디렉터리 이름
Git에 새 항목을 저장하면 Git 통합에서 해당 항목에 대한 디렉터리를 자동으로 만듭니다.
항목 디렉터리 이름은 다음 규칙을 기반으로 합니다.
- 이름의 패턴은 .입니다
{display name}.{public facing type}. - 필요한 경우 표시 이름을 다음과 같이 변경합니다.
- 해당 폴더 이름을 사용할 수 없는 경우 항목의 logicalID(GUID) 이름이 표시 이름 대신 사용됩니다.
예를 들어 작업 영역에 다음 항목이 있는 경우(첫 번째 및 세 번째 항목에는 각각 보이지 않는 선행 및 후행 공간이 있음)
다음 디렉터리는 Git 리포지토리에 만들어집니다.
- 만든 후 Git 통합은 디렉터리의 이름을 변경하지 않습니다. 항목의 이름을 변경하더라도 디렉터리 이름은 동일하게 유지됩니다.
- 항목 디렉터리의 이름을 수동으로 변경하는 경우 항목의 종속성을 고려해야 합니다. 예를 들어 의미 체계 모델의 디렉터리를 변경하는 경우 보고서의 종속성 파일에서 의미 체계 모델의 경로를 업데이트해야 합니다. 종속성 위치는 Fabric 환경마다 다릅니다. 디렉터리 이름을 변경해도 작업 영역에서 들어오는 변경이 발생하지 않습니다 .
디렉터리 콘텐츠
각 항목 디렉터리에는 항목 정의 파일 과 자동으로 생성된 시스템 파일이 포함됩니다.
항목 정의 파일
각 항목의 디렉터리에는 해당 항목을 정의하는 특정 필수 파일이 있습니다.
현재 Microsoft Fabric에서 지원되는 항목은 다음과 같습니다.
Notebook 파일
Notebook 폴더에는 .py 파일이 포함되어 있습니다.
Notebook과 Git 통합을 사용하는 방법에 대한 지침은 Notebook 소스 제어 및 배포를 참조하세요.
페이지를 매긴 보고서
페이지를 매긴 보고서 폴더에는 페이지를 매긴 보고서를 정의하는 .rdl 파일이 포함되어 있습니다. RDL(Report Definition Language)은 페이지를 매긴 보고서 정의를 XML로 표현한 것입니다.
RDL에 대한 자세한 내용은 RDL(Report Definition Language)을 참조하십시오. 페이지를 매긴 보고서와 Git 통합을 사용하는 방법에 대한 지침은 페이지를 매긴 보고서와 Git 통합을 참조하세요.
보고서 파일
보고서 폴더에는 다음 파일이 포함됩니다.
- definition.pbir
- report.json
보고서 폴더 및 해당 콘텐츠의 전체 목록에 대한 자세한 내용은 Power BI Desktop 프로젝트 보고서 폴더를 참조하세요.
의미 체계 모델 파일
의미 체계 모델 폴더에는 다음 파일이 포함됩니다.
- definition.pbidataset
- model.bim 파일(TMSL 형식) 또는 \definition 폴더(TMDL 형식)
의미 체계 모델 폴더 및 해당 콘텐츠의 전체 목록에 대한 자세한 내용은 Power BI Desktop 프로젝트 의미 체계 모델 폴더를 참조하세요.
자동으로 생성된 시스템 파일
항목 정의 파일 외에도 각 항목 디렉터리에는 사용 중인 버전에 따라 자동으로 생성된 시스템 파일이 하나 또는 두 개 포함됩니다.
- 버전 1 디렉터리에는 item.metadata.json 및 item.config.json 파일이 포함됩니다. V1을 사용하면 두 파일이 모두 디렉터리에 있어야 합니다.
- 버전 2 디렉터리에는 .platform 파일이 포함되어 있습니다. 이 파일에는 item.metadata.json 파일과 item.config.json 파일의 내용이 모두 포함됩니다. 이 파일이 있는 경우 다른 두 파일을 가질 수 없습니다. 버전 1을 사용하고 변경 내용을 커밋하는 경우 시스템 파일이 이 버전으로 자동으로 업데이트됩니다.
참고 항목
디렉터리에는 item.metadata.json 및 item.config.json 파일 또는 .platform 파일이 포함되어야 합니다. 세 개의 파일을 모두 가질 수는 없습니다.
플랫폼 파일
버전 2에서는 각 항목 디렉터리에 두 개의 원본 파일이 있는 대신 .platform 파일은 모든 정보를 $schema 속성과 함께 하나의 파일로 결합합니다. 이 파일이 있는 경우 다른 두 파일을 가질 수 없습니다.
{
"version": "2.0",
"$schema": https://developer.microsoft.com/json-schemas/fabric/platform/platformProperties.json,
"config": {
"logicalId": "e553e3b0-0260-4141-a42a-70a24872f88d"
},
"metadata": {
"type": "Report",
"displayName": "All visual types",
"description": "This is a report"
}
}
.platform 파일에는 다음과 같은 특성이 포함되어 있습니다.
version: 시스템 파일의 버전 번호입니다. 이 숫자는 이전 버전과의 호환성을 사용하도록 설정하는 데 사용됩니다. 항목의 버전 번호는 다를 수 있습니다.logicalId: 추적된 논리 GUID는 항목과 해당 소스 제어 표현을 나타내는 자동으로 생성된 작업 영역 간 식별자입니다.type: (문자열) 항목의 형식(의미 체계 모델, 보고서 등)displayName: (문자열) 항목의 이름description: (선택적 문자열) 항목에 대한 설명
참고 항목
- 유형 필드는 대/소문자를 구분합니다. 자동으로 생성되는 방식을 변경하지 마세요. 실패할 수 있습니다.
- 일반적으로 항목의 logicalId 또는 표시 이름을 변경하지는 않지만 한 가지 예외는 기존 항목 디렉터리를 복사하여 새 항목을 만드는 경우일 수 있습니다. 이 경우 logicalId 및 표시 이름을 리포지토리에서 고유한 이름으로 변경해야 합니다.