Git 통합 소스 코드 형식

Microsoft Fabric의 항목은 폴더에 저장됩니다. 항목이 포함된 폴더는 루트 디렉터리 또는 하위 디렉터리에 있을 수 있습니다. 작업 영역을 git에 연결하면 항목이 포함된 폴더에 연결합니다. 폴더의 각 항목은 자체 하위 디렉터리에 표시됩니다. 이러한 항목 디렉터리에는 항목과 이름이 같고 그 뒤에 항목 유형이 있습니다.

Important

이 기능은 미리 보기로 제공됩니다.

각 항목 디렉터리에는 항목 정의 파일 과 하나 또는 두 개의 자동으로 생성된 시스템 파일이 포함됩니다.

항목 정의 파일

각 항목의 디렉터리에는 해당 항목을 정의하는 특정 필수 파일이 있습니다.

현재 Microsoft Fabric에서 지원되는 항목은 다음과 같습니다.

• Notebook
• 페이지를 매긴 보고서
• Report
• 의미 체계 모델

Notebook 파일

Notebook 폴더에는 .py 파일이 포함되어 있습니다.

Notebook과 Git 통합을 사용하는 방법에 대한 지침은 Notebook 소스 제어 및 배포를 참조하세요.

페이지를 매긴 보고서 파일

페이지를 매긴 보고서 폴더에는 페이지를 매긴 보고서를 정의하는 .rdl 파일이 포함되어 있습니다. RDL(보고서 정의 언어)은 페이지를 매긴 보고서 정의의 XML 표현입니다.

자세한 내용은 RDL(보고서 정의 언어)을 참조하세요. 페이지를 매긴 보고서와 Git 통합을 사용하는 방법에 대한 지침은 페이지를 매긴 보고서와 Git 통합을 참조 하세요.

보고서 파일

보고서 폴더에는 다음 파일이 포함됩니다.

• definition.pbir
• report.json

보고서 폴더 및 해당 콘텐츠의 전체 목록에 대한 자세한 내용은 Power BI Desktop 프로젝트 보고서 폴더를 참조 하세요.

의미 체계 모델 파일

의미 체계 모델 폴더에는 다음 파일이 포함됩니다.

• definition.pbidataset
• model.bim 파일(TMSL 형식) OR \definition 폴더(TMDL 형식)

의미 체계 모델 폴더 및 해당 콘텐츠의 전체 목록에 대한 자세한 내용은 Power BI Desktop 프로젝트 의미 체계 모델 폴더를 참조 하세요.

자동으로 생성된 시스템 파일

항목 정의 파일 외에도 각 항목 디렉터리에는 사용 중인 버전에 따라 자동으로 생성된 시스템 파일이 하나 또는 두 개 포함됩니다.

• 버전 1 디렉터리에는 item.metadata.json 및 item.config.json 포함됩니다. V1을 사용하는 경우 두 파일이 모두 디렉터리에 있어야 합니다.
• 버전 2 디렉터리에는 .platform이 포함되어 있습니다. 이 파일에는 item.metadata.json 파일과 item.config.json 파일의 내용이 모두 포함됩니다. 이 파일이 있는 경우 다른 두 파일을 가질 수 없습니다. 버전 1을 사용하고 변경 내용을 커밋하는 경우 시스템 파일이 이 버전으로 자동으로 업데이트됩니다.

참고 항목

디렉터리에는 파일 또는 item.config.json 파일이 .platform 포함되어 item.metadata.json 야 합니다. 세 개의 파일을 모두 가질 수는 없습니다.

버전 2

플랫폼 파일

버전 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: 항목 및 해당 소스 제어 표현을 나타내는 자동으로 생성된 작업 영역 간 식별자입니다.
• type: (문자열) 항목의 형식(의미 체계 모델, 보고서 등)
• displayName: (string) 항목의 이름입니다.
• description: (선택적 문자열) 항목에 대한 설명입니다.

버전 1

버전 1을 사용하는 경우 각 항목 디렉터리에 두 개의 파일이 있습니다.

• item.metadata.json
• item.config.json

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

메타데이터 파일

{ 
    "type": "report", 
    "displayName": "All visual types",
    "description": "This is a report"
} 

item.metadata.json 파일에는 다음 특성이 포함됩니다.

• type: (문자열) 항목의 형식(의미 체계 모델, 보고서 등)
• displayName: (string) 항목의 이름입니다.
• description: (선택적 문자열) 항목에 대한 설명

항목 이름을 바꾸려면 'item.metadata.json' 파일에서 변경 displayName 합니다. 폴더 이름을 변경해도 작업 영역에 있는 항목의 표시 이름은 변경되지 않습니다.

Config 파일

{ 
    version: "1.0", 
    logicalId: "e553e3b0-0260-4141-a42a-70a24872f88d", 
} 

파일에 item.config.json 는 다음 특성이 포함됩니다.

• version: 시스템 파일의 버전 번호입니다. 이 숫자는 이전 버전과의 호환성을 사용하도록 설정하는 데 사용됩니다. 항목의 버전 번호가 다를 수 있습니다.
• logicalId: 항목 및 해당 소스 제어 표현을 나타내는 자동으로 생성된 작업 영역 간 식별자입니다.

logicalId는 작업 영역의 항목을 Git 분기의 해당 항목과 연결합니다. logicalId가 동일한 항목은 동일한 것으로 간주됩니다. logicalId는 이름 또는 디렉터리가 변경되더라도 링크를 유지합니다. 분기를 여러 작업 영역과 동기화할 수 있으므로 동일한 logicalId를 가진 여러 작업 영역에 항목이 있을 수 있지만 단일 작업 영역에는 동일한 logicalId를 가진 두 개의 항목이 있을 수 없습니다. logicalId는 작업 영역이 Git 분기에 연결되거나 새 항목이 동기화될 때 만들어집니다. Git 통합이 제대로 작동하려면 logicalId가 필요합니다. 따라서 어떤 방식으로든 변경하지 않는 것이 중요합니다.

참고 항목

버전 1에서 Git에 변경 내용을 커밋하면 시스템 파일이 변경 내용과 함께 버전 2로 자동으로 업데이트됩니다. 또한 Power BI Desktop 개발자 모드에서 내보낸 새 파일은 버전 2 파일 형식으로 저장됩니다.

참고 항목

• 형식 필드는 대/소문자를 구분합니다. 자동으로 생성되거나 실패할 수 있는 방식을 변경하지 마세요.
• 일반적으로 항목의 logicalId 또는 표시 이름을 변경하지는 않지만 한 가지 예외는 기존 항목 디렉터리를 복사하여 새 항목을 만드는 경우일 수 있습니다. 이 경우 logicalId 및 표시 이름을 리포지토리에서 고유한 이름으로 변경해야 합니다.

관련 콘텐츠

Git 통합을 시작합니다.