Git 통합의 기본 개념

이 문서에서는 기본 Git 개념과 Git을 Microsoft Fabric 작업 영역과 통합하는 프로세스를 설명합니다.

Important

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

사용 권한

• Git 통합 을 사용하려면 조직의 관리자가 사용하도록 설정해야 합니다.
• 작업 영역과 리포지토리가 서로 다른 두 지역에 있는 경우 테넌트 관리자가 지역 간 내보내기를 사용하도록 설정해야 합니다. 자세한 내용은 사용자가 다른 지리적 위치의 Git 리포지토리로 항목을 내보낼 수 있는지를 참조 하세요.
• 작업 영역에서 수행할 수 있는 작업은 작업 영역과 Azure DevOps 모두에 있는 권한에 따라 달라집니다.

Azure DevOps 사용 권한

다음 목록에서는 Azure DevOps 권한에 따라 다른 작업 영역 역할이 수행할 수 있는 작업을 보여 줍니다.

• 관리: 작업 영역에서 Azure DevOps 역할에 의해서만 제한되는 모든 작업을 수행할 수 있습니다.
• 멤버/기여자: 작업 영역에 연결되면 멤버/기여자 Azure DevOps 역할에 따라 변경 내용을 커밋하고 업데이트할 수 있습니다. 작업 영역 연결과 관련된 작업(예: 연결, 연결 끊기 또는 분기 전환)의 경우 관리 도움을 구합니다.
• 뷰어: 작업을 수행할 수 없습니다. 뷰어는 작업 영역에서 Git 관련 정보를 볼 수 없습니다.

일반 작업에 필요한 권한

다음 표에서는 다양한 일반적인 작업을 수행하는 데 필요한 권한을 설명합니다.

연산	작업 영역 역할	Git 권한
작업 영역을 Git 리포지토리로 커넥트	Admin	Read=Allow
Git 리포지토리를 사용하여 작업 영역 동기화	Admin	Read=Allow
Git 리포지토리에서 작업 영역 연결 끊기	Admin	권한이 필요하지 않습니다.
작업 영역의 분기 전환(또는 연결 설정의 변경 내용)	Admin	Read=Allow(대상 리포지토리/디렉터리/분기)
Git 연결 세부 정보 보기	관리, 멤버, 기여자	읽기 또는 없음
작업 영역 'Git 상태'을 참조하세요.	관리, 멤버, 기여자	Read=Allow
Git에서 업데이트	다음을 모두 수행합니다. 작업 영역의 기여자(모든 항목에 대한 쓰기 권한) 항목의 소유자(테넌트 스위치가 비소유자에 대한 업데이트를 차단하는 경우) 외부 종속성 빌드(해당하는 경우)	Read=Allow
Git에 작업 영역 변경 내용 커밋	다음을 모두 수행합니다. 작업 영역의 기여자(모든 항목에 대한 쓰기 권한) 항목의 소유자(테넌트 스위치가 비소유자에 대한 업데이트를 차단하는 경우) 외부 종속성 빌드(해당하는 경우)	Read=Allow Contribute=Allow 분기 정책은 직접 커밋을 허용해야 합니다.
패브릭 내에서 새 Git 분기 만들기	Admin	Role=Write 분기 만들기=허용

커넥트 및 동기화

작업 영역 관리자만 작업 영역을 Azure Repos에 연결할 수 있지만 연결되면 권한이 있는 모든 사용자가 작업 영역에서 작업할 수 있습니다. 관리자가 아닌 경우 관리자에게 연결에 대한 도움을 요청합니다.

작업 영역을 Git에 연결하면 패브릭은 두 위치 간에 동기화되어 동일한 콘텐츠를 갖습니다. 이 초기 동기화 중에 다른 쪽에 콘텐츠가 있는 동안 작업 영역 또는 Git 분기가 비어 있으면 콘텐츠가 비어 있지 않은 위치에서 빈 위치로 복사됩니다. 작업 영역과 Git 분기 모두에 콘텐츠가 있는 경우 동기화를 진행해야 하는 방향을 결정해야 합니다.

• 작업 영역을 Git 분기에 커밋하면 지원되는 모든 작업 영역 콘텐츠가 Git으로 내보내지고 현재 Git 콘텐츠를 덮어씁니다.
• Git 콘텐츠로 작업 영역을 업데이트하면 작업 영역 콘텐츠가 덮어쓰여지고 작업 영역 콘텐츠가 손실됩니다. Git 분기는 항상 이전 단계로 복원할 수 있지만 작업 영역은 복원할 수 없으므로 이 옵션을 선택하면 확인하라는 메시지가 표시됩니다.

동기화할 콘텐츠를 선택하지 않으면 다음을 수행할 때까지 작업을 계속할 수 없습니다.

Git 상태

연결한 후 작업 영역에는 원격 분기의 항목과 관련하여 작업 영역에 있는 각 항목의 동기화 상태를 나타내는 Git 상태 열이 표시됩니다.

각 항목에는 다음 상태 중 하나가 있습니다.

• 동기화됨(항목이 작업 영역 및 Git 분기에서 동일)
• 충돌(작업 영역과 Git 분기 모두에서 항목이 변경됨)
• 지원되지 않는 항목
• 작업 영역의 커밋되지 않은 변경 내용
• Git에서 필요한 업데이트
• 항목은 두 위치에서 동일하지만 마지막 커밋으로 업데이트해야 합니다.

동기화 정보

연결되면 화면 아래쪽에 다음 정보가 표시됩니다.

• 커넥트 분기
• 마지막 동기화 시간
• 작업 영역이 동기화된 마지막 커밋에 대한 링크

커밋 및 업데이트

소스 제어 창

화면 맨 위에는 소스 제어 아이콘이 있습니다. 작업 영역 및 Git 분기에서 서로 다른 항목의 수를 표시합니다. 작업 영역이 Git 분기와 동기화되면 소스 제어 아이콘에 0이 표시됩니다.

작업 영역 또는 Git 분기를 변경하면 소스 제어 아이콘에 다른 항목 수가 표시됩니다. 소스 제어 아이콘을 선택하여 소스 제어 창을 엽니다.

소스 제어 창의 변경 내용 탭에는 작업 영역에서 변경되어 Git에 커밋해야 하는 항목 수가 표시되고, 업데이트 탭에는 Git 분기에서 수정되어 작업 영역으로 업데이트해야 하는 항목 수가 표시됩니다.

각 탭에서 변경된 항목은 상태 나타내는 아이콘과 함께 나열됩니다.

• 새로운
• 으로 바뀌었습니다
• 삭제
• 충돌

Commit

• 커밋할 항목이 두 개 이상 있는 경우 Git 분기에 커밋할 항목을 선택할 수 있습니다.
• Git 분기에 대한 업데이트가 있는 경우 작업 영역을 업데이트할 때까지 커밋이 비활성화됩니다.

엽데이트

• 커밋 및 실행 취소와 달리 업데이트 명령은 항상 전체 분기를 업데이트하고 가장 최근의 커밋으로 동기화합니다. 업데이트할 특정 항목을 선택할 수 없습니다.
• 작업 영역과 동일한 항목의 Git 분기에서 변경된 경우 충돌이 해결될 때까지 업데이트를 사용할 수 없습니다.

커밋 및 업데이트 방법에 대해 자세히 알아보세요. 업데이트 프로세스 및 충돌을 해결하는 방법에 대해 자세히 알아보세요.

고려 사항 및 제한 사항

일반적인 제한 사항

• Azure DevOps 계정은 패브릭 작업 영역을 사용하는 동일한 사용자에게 등록되어야 합니다.
• Power BI의 인증 방법은 적어도 Azure DevOps에 대한 인증 방법만큼 강력해야 합니다. 예를 들어 Azure DevOps에 다단계 인증이 필요한 경우 Power BI에도 다단계 인증이 필요합니다.
• Power BI 데이터 세트 및 Analysis Services의 직접 쿼리 및 복합 모델은 현재 지원되지 않습니다.
• DirectLake 의미 체계 모델은 현재 지원되지 않습니다.
• 향상된 새로 고침 API를 사용하여 의미 체계 모델을 새로 고치면 새로 고칠 때마다 Git diff가 발생합니다.

작업 영역 제한 사항

작업 영역 관리자만 분기 연결, 연결 끊기 또는 추가와 같은 Azure 리포지토리에 대한 연결을 관리할 수 있습니다. 연결되면 권한이 있는 모든 사용자가 작업 영역에서 작업할 수 있습니다.

분기 및 폴더 제한 사항

• 분기 이름의 최대 길이는 244자입니다.

• 파일 이름에 대한 전체 경로의 최대 길이는 250자입니다. 더 긴 이름은 실패합니다.

• 최대 파일 크기는 25MB입니다.

• Git 통합을 사용하여 배포한 후에는 보고서에서 .pbix로 보고서/데이터 세트를 다운로드할 수 없습니다.

• 항목의 표시 이름인 경우:

  • 256자 이상
  • '또는 공백으로 .끝납니다.
  • 다음 문자를 "포함합니다. , ,/, <:, , *?>\\|

  Git에서 폴더 이름을 지정할 때 논리 ID(Guid)가 형식 앞에 접두사로 추가됩니다.

동기화 및 커밋 제한 사항

• 커밋의 크기 제한은 125MB입니다.
• 한 번에 한 방향으로만 동기화할 수 있습니다. 커밋 및 업데이트는 동시에 수행할 수 없습니다.
• 민감도 레이블은 지원되지 않으며 민감도 레이블이 있는 항목을 내보내지 않도록 설정할 수 있습니다. 민감도 레이블이 없는 민감도 레이블이 있는 항목을 커밋하려면 관리자 에게 도움을 요청하세요.
• 제한된 항목에서 작동합니다. 지원되지 않는 항목이 폴더에 있으면 무시됩니다.
• Power BI에서 허용하는 경우에도 이름을 복제할 수 없습니다. 업데이트, 커밋 또는 실행 취소 작업이 실패합니다.
• B2B는 지원되지 않습니다.
• 충돌 해결 은 Git에서 부분적으로 수행됩니다.

관련 콘텐츠

• 분기 관리
• 오류 및 충돌 해결