이 문서에서는 Microsoft Fabric Git 통합 도구에서 다음과 같은 기본 작업을 안내합니다.
시작하기 전에 Git 통합 개요를 읽어보는 것이 좋습니다.
필수 조건
Git을 Microsoft Fabric 작업 영역과 통합하려면 Fabric 및 Git 모두에 대해 다음 필수 구성 요소를 설정해야 합니다.
패브릭 필수 구성 요소
Git 통합 기능에 접근하려면 Fabric 용량이 필요합니다. 지원되는 패브릭 항목을 모두 사용하려면 패브릭 용량이 필요합니다. 아직 계정이 없으시다면, 무료 평가판에 등록하세요. 이미 Power BI Premium 용량을 보유한 고객은 해당 용량을 사용할 수 있지만, 일부 Power BI SKU는 Power BI 항목만 지원한다는 점을 유념하세요.
또한 관리 포털에서 다음 테넌트 스위치를 사용하도록 설정해야 합니다.
- 사용자는 패브릭 항목을 만들 수 있습니다 - Fabric artifacts 사용의 경우 필요
- 사용자는 작업 영역 항목을 Git 리포지토리와 동기화할 수 있습니다.
- 작업 영역을 만듭니다(새 작업 영역 으로 분기하려는 경우에만).
- 사용자는 작업 영역 항목을 GitHub 리포지토리와 동기화할 수 있습니다: GitHub 사용자만
이러한 스위치는 조직의 설정에 따라 테넌트 관리자, 용량 관리자 또는 작업 영역 관리자가 사용하도록 설정할 수 있습니다.
Git 필수 구성 요소
Git 통합은 현재 Azure DevOps 및 GitHub 지원됩니다. 패브릭 작업 영역과 Git 통합을 사용하려면 Azure DevOps 또는 GitHub 다음이 필요합니다.
- 동일한 Fabric 사용자에게 등록된 Active Azure DevOps 계정(Azure DevOps 조직이 패브릭 테넌트가 아닌 다른 테넌트에 있는 경우에도 지원됨). 체험 계정을 만듭니다.
- 기존 리포지토리에 Access.
작업 영역을 Git 리포지토리에 연결
Git 리포지토리에 연결
작업 영역 관리자만 작업 영역을 리포지토리에 연결할 수 있지만 연결되면 권한이 있는 모든 사용자가 작업 영역에서 작업할 수 있습니다. 관리자가 아닌 경우 관리자에게 연결과 관련된 도움을 요청하세요. 작업 영역을 Azure 또는 GitHub 리포지토리에 연결하려면 다음 단계를 수행합니다.
Fabric에 로그인하고 연결할 작업 영역으로 이동합니다.
작업 영역 설정으로 이동합니다.
Git 통합을 선택합니다.
Git 공급자를 선택합니다. 현재 Azure DevOps 및 GitHub 지원됩니다.
Azure DevOps를 선택하는 경우 Connect를 선택하여 Fabric에 로그인한 Microsoft Entra 사용자에게 등록된 Azure Repos 계정에 자동으로 로그인합니다.
다른 계정을 사용하여 Fabric에서 Azure 이미 로그인한 경우 목록에서 계정을 선택하고 Connect 선택합니다.
Fabric에서 처음 로그인하거나 새 계정을 추가하려는 경우 계정 추가를 선택합니다.
처음 연결하는 경우 사용자에게 권한을 부여해야 합니다. 다음 정보를 제공합니다.
- 표시 이름 - 각 사용자에 대해 고유해야 합니다.
-
Azure DevOps URL - Azure DevOps 리포지토리의 URL입니다. URL은
https://dev.azure.com/{organization}/{project}/_git/{repository}또는https://{organization}.visualstudio.com/{project}/_git/{repo}형식이어야 합니다. -
인증 - OAuth2 또는 서비스 주체를 사용하여 인증할 수 있습니다. 자세한 내용은
Azure DevOps - 서비스 주체와 Git 통합
로그인한 후, Fabric이 계정에 접근할 수 있도록 Connect를 선택하세요.
작업 영역에 연결
작업 영역이 이미 Azure DevOps/GitHub 연결되어 있는 경우 공유 작업 영역에 연결 지침을 따릅니다.
드롭다운 메뉴에서 연결하려는 분기에 대해 다음 세부 정보를 지정합니다.
- Organization
- Project
- Git 리포지토리.
- 분기. 드롭다운 메뉴를 사용하여 기존 분기를 선택하거나 + 새 분기를 선택하여 새 분기를 만듭니다. 한 번에 하나의 분기에만 연결할 수 있습니다.
- 폴더(기존 폴더의 이름을 입력하거나 이름을 입력하여 새 폴더를 만듭니다. 폴더 이름을 비워 두면 루트 폴더에 콘텐츠가 만들어집니다. 한 번에 하나의 폴더에만 연결할 수 있습니다.)
연결 및 동기화를 선택합니다.
초기 동기화 중에 작업 영역 또는 Git 분기가 비어 있으면 콘텐츠가 비어 있지 않은 위치에서 빈 위치로 복사됩니다. 작업 영역과 Git 분기 모두에 콘텐츠가 있는 경우 동기화를 진행해야 하는 방향을 묻는 메시지가 표시됩니다. 이 초기 동기화에 대한 자세한 내용은 연결 및 동기화를 참조하세요.
연결한 후 작업 영역에는 연결된 분기, 분기의 각 항목 상태 및 마지막 동기화 시간을 볼 수 있는 소스 제어에 대한 정보가 표시됩니다.
작업 영역을 Git 분기 와 동기화된 상태로 유지하려면 작업 영역에서 변경한 내용을 Git 분기에 커밋하고 누구든 Git 분기에 대한 새 커밋을 만들 때마다 작업 영역을 업데이트합니다.
git에 변경 내용 커밋
Git 폴더에 성공적으로 연결되면 평소와 같이 작업 영역을 편집합니다. 저장한 모든 변경 내용은 작업 영역에만 저장됩니다. 준비가 되면 변경 내용을 Git 분기에 커밋하거나 변경 내용을 실행 취소하고 이전 상태로 되돌릴 수 있습니다.
커밋에 대해 자세히 읽어보세요.
Git 분기에 변경 내용을 커밋하려면 다음 단계를 수행합니다.
작업 영역으로 이동합니다.
소스 제어 아이콘을 선택합니다. 이 아이콘은 커밋되지 않은 변경 수를 보여줍니다.
소스 제어 패널에서 변경 내용을 선택합니다. 변경한 모든 항목과 항목이 새
항목인지, 수정
되었는지, 충돌
하는지, 같은 변경
내용인지 또는 삭제되었는지
를 나타내는 아이콘과 함께 목록이 나타납니다.커밋할 항목을 선택합니다. 항목을 모두 선택하려면 맨 위 확인란을 선택합니다.
상자에 메모를 추가합니다. 메모를 추가하지 않으면 기본 메시지가 자동으로 추가됩니다.
커밋을 선택합니다.
변경 내용이 커밋되면 커밋된 항목이 목록에서 제거되고 작업 영역은 동기화된 새 커밋을 가리킵니다.
커밋이 성공적으로 완료되면 선택한 항목의 상태가 커밋되지 않음에서 동기화됨으로 변경됩니다.
Git에서 작업 영역 업데이트
연결된 Git 분기에 대한 새 변경 내용을 커밋할 때마다 관련 작업 영역에 알림이 표시됩니다. 원본 제어 패널을 사용하여 최신 변경 내용, 병합 또는 되돌리기를 작업 영역으로 끌어오고 라이브 항목을 업데이트합니다. 폴더에 대한 변경 내용도 업데이트됩니다. 업데이트에 대해 자세히 읽어보세요.
작업 영역을 업데이트하려면 다음 단계를 수행합니다.
- 작업 영역으로 이동합니다.
- 소스 제어 아이콘을 선택합니다.
- 소스 컨트롤 패널에서 Updates를 선택합니다. 마지막 업데이트 이후 브랜치에서 변경된 모든 항목이 표시된 목록이 나타납니다.
- 모두 업데이트를 선택합니다.
- 확인 대화 상자에서 업데이트를 선택합니다.
업데이트가 성공적으로 완료되면 항목 목록이 제거되고 작업 영역은 동기화된 새 작업 영역을 가리킵니다.
업데이트가 성공적으로 완료되면 항목의 상태가 동기화됨으로 바뀝니다.
Git에서 작업 영역 연결 끊기
작업 영역 관리자만 Git 리포지토리에서 작업 영역의 연결을 끊을 수 있습니다. 관리자가 아닌 경우 관리자에게 연결 끊기와 관련된 도움을 요청하세요. 관리자인데 리포지토리의 연결을 끊으려면 다음 단계를 수행합니다.
- 작업 영역 설정으로 이동합니다.
- Git 통합을 선택합니다.
- 작업 영역 연결 끊기를 선택합니다.
- 다시 연결 끊기를 선택하여 확인합니다.
사용 권한
작업 영역에서 수행할 수 있는 작업은 작업 영역과 Git 리포지토리 둘 다에서 사용 권한에 따라 달라집니다. 사용 권한에 대한 자세한 내용은 사용 권한을 참조하세요.