다음을 통해 공유

Git 통합 소개(미리 보기)

  • 아티클

이 문서에서는 개발자에게 ALM(패브릭 애플리케이션 수명 주기 관리) 도구와 Git 버전 제어를 통합하는 방법을 설명합니다.

Important

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

Microsoft Fabric의 Git 통합을 통해 개발자는 개발 프로세스, 도구 및 모범 사례를 패브릭 플랫폼에 바로 통합할 수 있습니다. 패브릭에서 개발하는 개발자는 다음을 수행할 수 있습니다.

  • 작업 백업 및 버전 관리
  • 필요에 따라 이전 단계로 되돌리기
  • 다른 사용자와 공동 작업하거나 Git 분기를 사용하여 혼자 작업
  • 친숙한 소스 제어 도구의 기능을 적용하여 패브릭 항목 관리

소스 제어와의 통합은 작업 영역 수준에 있습니다. 개발자는 작업 영역 내에서 개발하는 항목을 단일 프로세스로 버전 관리하여 모든 항목을 완전히 볼 수 있습니다. 현재 미리 보기에서는 일부 항목만 지원되지만 지원되는 항목 목록이 늘어나고 있습니다.

  • 버전 제어 및 Git을 읽어 기본 Git 개념에 대해 잘 알고 있는지 확인합니다.

  • Git 통합 프로세스에 대해 자세히 알아보세요.

  • Git 분기를 관리하는 가장 좋은 방법에 대해 알아봅니다.

개인 정보

Git 통합을 사용하도록 설정하기 전에 다음 개인 정보 취급 방침을 검토해야 합니다.

지원되는 Git 공급자

지원되는 Git 공급자는 다음과 같습니다.

지원되는 항목

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

작업 영역 또는 Git 디렉터리에 지원되지 않는 항목이 있는 경우 여전히 연결할 수 있지만 지원되지 않는 항목은 무시됩니다. 저장되거나 동기화되지는 않지만 삭제되지도 않습니다. 소스 제어판에 표시되지만 커밋하거나 업데이트할 수는 없습니다.

고려 사항 및 제한 사항

일반 Git 통합 제한 사항

  • 패브릭의 인증 방법은 적어도 Git의 인증 방법만큼 강력해야 합니다. 예를 들어 Git에 다단계 인증이 필요한 경우 패브릭에도 다단계 인증이 필요합니다.
  • Analysis Services에 연결된 Power BI 데이터 세트는 현재 지원되지 않습니다.
  • 소버린 클라우드는 지원되지 않습니다.
  • Azure DevOps 계정은 패브릭 작업 영역을 사용하는 동일한 사용자에게 등록되어야 합니다.
  • 작업 영역과 Git 리포지토리가 서로 다른 두 지역에 있는 경우 테넌트 관리자는 지역 간 내보내기를 사용하도록 설정해야 합니다.
  • 커밋 크기는 125MB로 제한됩니다.

GitHub Enterprise 제한 사항

일부 GitHub Enterprise 설정은 지원되지 않습니다. 예시:

  • IP 허용 목록
  • 프라이빗 네트워크

작업 영역 제한 사항

  • 작업 영역 관리자만 분기 연결, 연결 끊기 또는 추가와 같은 Git 리포지토리에 대한 연결을 관리할 수 있습니다.
    연결되면 권한이 있는 모든 사용자가 작업 영역에서 작업할 수 있습니다.
  • 작업 영역 폴더 구조는 Git 리포지토리에 반영되지 않습니다. 폴더의 작업 영역 항목을 루트 디렉터리로 내보냅니다.

분기 및 폴더 제한 사항

  • 분기 이름의 최대 길이는 244자입니다.
  • 파일 이름에 대한 전체 경로의 최대 길이는 250자입니다. 더 긴 이름은 실패합니다.
  • 최대 파일 크기는 25MB입니다.
  • Git 통합을 사용하여 배포한 후에는 보고서에서 .pbix로 보고서/데이터 세트를 다운로드할 수 없습니다.
  • Git에서 폴더 이름을 지정할 때 항목의 표시 이름인 경우 논리 ID(Guid)가 형식 앞에 접두사로 추가됩니다.
    • 256자 이상
    • . 또는 공백으로 끝납니다.
    • 다음 문자를 포함합니다. " / : ? < > \ * |

분기 제한 사항

  • 분기를 사용하려면 사용 권한 테이블에 나열된 권한이 필요합니다.
  • 이 작업에 사용할 수 있는 용량이 있어야 합니다.
  • 모든 작업 영역 및 분기 명명 제한은 새 작업 영역으로 분기할 때 적용됩니다.
  • 분기할 때 새 작업 영역이 만들어지고 원래 작업 영역의 설정이 복사되지 않습니다. 새 작업 영역이 조직의 정책을 충족하도록 설정 또는 정의를 조정합니다.
  • 새 작업 영역에서는 Git 지원 항목만 사용할 수 있습니다.
  • 관련 분기 목록에는 볼 수 있는 권한이 있는 분기 및 작업 영역만 표시됩니다.
  • Git 통합 을 사용하도록 설정해야 합니다.

동기화 및 커밋 제한 사항

  • 한 번에 한 방향으로만 동기화할 수 있습니다. 커밋 및 업데이트는 동시에 수행할 수 없습니다.
  • 민감도 레이블은 지원되지 않으며 민감도 레이블이 있는 항목을 내보내지 않도록 설정할 수 있습니다. 민감도 레이블이 없는 민감도 레이블이 있는 항목을 커밋하려면 관리자 에게 도움을 요청하세요.
  • 제한된 항목에서 작동합니다. 폴더에서 지원되지 않는 항목은 무시됩니다.
  • 이름을 복제할 수 없습니다. Power BI에서 이름 중복을 허용하더라도 업데이트, 커밋 또는 실행 취소 작업이 실패합니다.
  • B2B는 지원되지 않습니다.
  • 충돌 해결 은 Git에서 부분적으로 수행됩니다.
  • Git에 커밋 프로세스 중에 Fabric 서비스는 항목 정의의 일부가 아닌 항목 폴더 내의 파일을 삭제합니다. 항목 폴더에 없는 관련 없는 파일은 삭제되지 않습니다.
  • 변경 내용을 커밋한 후에는 예기치 않은 변경 내용이 표시될 수 있습니다. 이러한 변경 내용은 의미상 중요하지 않으며 여러 가지 이유로 발생할 수 있습니다. 예:
    • 항목 정의 파일을 수동으로 변경합니다. 이러한 변경 내용은 유효하지만 편집기를 통해 수행하는 경우와 다를 수 있습니다. 예를 들어 Git에서 의미 체계 모델 열의 이름을 바꾸고 이 변경 내용을 작업 영역으로 가져오는 경우 다음에 의미 체계 모델에 변경 내용을 커밋하면 bim 파일이 변경된 것으로 등록되고 수정된 열이 배열의 columns 뒤로 푸시됩니다. 이는 bim 파일을 생성하는 AS 엔진이 이름이 바뀐 열을 배열의 끝으로 푸시하기 때문입니다. 이 변경 내용은 항목 작동 방식에 영향을 주지 않습니다.
    • CRLF 줄 바꿈을 사용하는 파일 커밋 이 서비스는 LF(줄 바꿈) 줄 바꿈을 사용합니다. CRLF 줄 바꿈이 있는 Git 리포지토리에 항목 파일이 있는 경우 서비스에서 커밋하면 이러한 파일이 LF로 변경됩니다. 예를 들어 데스크톱에서 보고서를 여는 경우 .pbip 프로젝트를 저장하고 CRLF를 사용하여 Git에 업로드합니다.
  • 향상된 새로 고침 API를 사용하여 의미 체계 모델을 새로 고치면 새로 고칠 때마다 Git diff가 발생합니다.

관련 콘텐츠