Git을 사용하여 작업 영역 관리(미리 보기)

이 문서에서는 Microsoft Fabric의 Git 통합 도구에서 다음과 같은 기본 작업을 안내합니다.

시작하기 전에 Git 통합의 개요를 읽는 것이 좋습니다.

Important

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

필수 조건

Git을 Microsoft Fabric 작업 영역과 통합하려면 Azure DevOps 및 Fabric 모두에서 다음 필수 구성 요소를 설정해야 합니다.

Azure DevOps 필수 구성 요소

  • 패브릭 작업 영역을 사용하는 동일한 사용자에게 등록된 활성 Azure 계정입니다. 무료 계정을 만듭니다.
  • 기존 리포지토리에 대한 액세스.

패브릭 필수 구성 요소

Git 통합 기능에 액세스하려면 다음 중 하나가 필요합니다.

또한 조직의 관리자는 사용자가 관리 포털에서 패브릭 항목 테넌트 스위치를 만들 수 있도록 설정해야 합니다.

사용 가능한 패브릭 스위치의 스크린샷.

Azure 리포지토리에 작업 영역 커넥트

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

  1. Power BI에 로그인하고 연결하려는 작업 영역으로 이동합니다.

  2. 작업 영역 설정으로 이동

    작업 영역 설정 아이콘이 맨 위에 표시된 작업 영역의 스크린샷.

    참고 항목

    작업 영역 설정 아이콘이 표시되지 않으면 줄임표(점 3개)를 선택한 다음 작업 영역 설정을 선택합니다. 줄임표에서 작업 영역 설정 링크가 표시된 작업 영역의 스크린샷

  3. Git 통합을 선택합니다. Fabric에 로그인한 Microsoft Entra 사용자에게 등록된 Azure Repos 계정에 자동으로 로그인됩니다.

    Git 통합이 선택된 작업 영역 설정 창의 스크린샷

  4. 드롭다운 메뉴에서 연결하려는 분기에 대해 다음 세부 정보를 지정합니다.

    참고 항목

    한 번에 하나의 분기와 하나의 폴더에만 작업 영역을 연결할 수 있습니다.

    • 조직
    • 프로젝트
    • Git 리포지토리
    • 분기(드롭다운 메뉴를 사용하여 기존 분기를 선택하거나 + 새 분기를 선택하여 새 분기를 만듭니다. 한 번에 하나의 분기에만 연결할 수 있습니다.)
    • 폴더(분기에서 기존 폴더를 선택하거나 이름을 입력하여 새 폴더를 만듭니다. 폴더를 선택하지 않으면 루트 폴더에 콘텐츠가 만들어집니다. 한 번에 하나의 폴더에만 연결할 수 있습니다.)
  5. 커넥트 선택하고 동기화합니다.

초기 동기화 중에 작업 영역 또는 Git 분기가 비어 있으면 콘텐츠가 비어 있지 않은 위치에서 빈 위치로 복사됩니다. 작업 영역과 Git 분기 모두에 콘텐츠가 있는 경우 동기화를 진행해야 하는 방향을 묻는 메시지가 표시됩니다. 이 초기 동기화에 대한 자세한 내용은 커넥트 및 동기화를 참조하세요.

연결한 후 작업 영역에는 연결된 분기, 분기의 각 항목 상태 및 마지막 동기화 시간을 볼 수 있는 소스 제어에 대한 정보가 표시됩니다.

소스 제어 아이콘 및 기타 Git 정보의 스크린샷

작업 영역을 Git 분기 와 동기화된 상태로 유지하려면 작업 영역에서 변경한 내용을 Git 분기에 커밋하고 Git 분기에 대한 새 커밋을 만들 때마다 작업 영역을 업데이트합니다.

git에 변경 내용 커밋

Git 폴더에 성공적으로 연결되면 평소와 같이 작업 영역을 편집합니다. 저장한 모든 변경 내용은 작업 영역에만 저장됩니다. 준비가 되면 변경 내용을 Git 분기에 커밋하거나 변경 내용을 실행 취소하고 이전 상태 되돌리기 수 있습니다. 커밋에 대해 자세히 알아보세요.

Git 분기에 변경 내용을 커밋하려면 다음 단계를 수행합니다.

  1. 작업 영역으로 이동합니다.

  2. 소스 제어 아이콘을 선택합니다. 이 아이콘은 커밋되지 않은 변경 횟수를 보여줍니다. 커밋할 두 가지 변경 내용이 있음을 나타내는 숫자 2가 있는 소스 제어 아이콘의 스크린샷

  3. 소스 제어 창의 변경 내용 탭을 선택합니다. 변경한 모든 항목과 항목이 새 항목인지, 수정되었는지, 충돌하는지 또는 삭제되었는지를 나타내는 아이콘과 함께 목록이 나타납니다.

  4. 커밋할 항목을 선택합니다. 모든 항목을 선택하려면 위쪽 상자를 검사.

  5. 상자에 메모를 추가합니다. 메모를 추가하지 않으면 기본 메시지가 자동으로 추가됩니다.

  6. 커밋을 선택합니다.

    커밋할 두 가지 변경 내용이 선택된 소스 제어 창의 스크린샷

변경 내용이 커밋되면 커밋된 항목이 목록에서 제거되고 작업 영역에서 동기화된 새 커밋을 가리킵니다.

커밋할 변경 내용이 없음을 나타내는 소스 제어 창의 스크린샷

커밋이 성공적으로 완료되면 선택한 항목의 상태 커밋되지 않은 항목에서 동기화됨으로 변경됩니다.

Git에서 작업 영역 업데이트

연결된 Git 분기에 대한 새 변경 내용을 커밋할 때마다 관련 작업 영역에 알림이 표시됩니다. 원본 제어 창을 사용하여 최신 변경 내용, 병합 또는 되돌리기 작업 영역으로 끌어오고 라이브 항목을 업데이트합니다. 업데이트에 대해 자세히 알아보세요.

작업 영역을 업데이트하려면 다음 단계를 수행합니다.

  1. 작업 영역으로 이동합니다.
  2. 소스 제어 아이콘을 선택합니다.
  3. 소스 제어 창의 업데이트 탭을 선택합니다. 마지막 업데이트 이후 분기에서 변경된 모든 항목과 함께 목록이 나타납니다.
  4. 모두 업데이트를 선택합니다.

업데이트 탭이 열리고 모든 업데이트 단추가 선택된 소스 제어 창의 스크린샷

업데이트가 성공적으로 완료되면 항목 목록이 제거되고 작업 영역에서 동기화된 새 커밋을 가리킵니다.

작업 영역을 성공적으로 업데이트했음을 나타내는 소스 제어 창의 스크린샷

업데이트가 성공적으로 완료되면 항목의 상태 Synced로 변경됩니다.

Git에서 작업 영역 연결 끊기

작업 영역 관리자만 Azure 리포지토리에서 작업 영역의 연결을 끊을 수 있습니다. 관리자가 아닌 경우 관리자에게 연결 끊김에 대한 도움을 요청합니다. 관리자이고 리포지토리의 연결을 끊으려면 다음 단계를 수행합니다.

  1. 작업 영역 설정으로 이동

  2. Git 통합 선택

  3. 작업 영역 연결 끊기 선택

    작업 영역 연결 끊기 옵션이 있는 작업 영역 설정 화면의 스크린샷

  4. 다시 연결 끊기를 선택하여 확인합니다.

    연결을 끊을 것인지 묻는 작업 영역 설정 화면의 스크린샷.

사용 권한

작업 영역에서 수행할 수 있는 작업은 작업 영역과 Azure DevOps 모두에 있는 권한에 따라 달라집니다. 사용 권한에 대한 자세한 내용은 사용 권한을 참조 하세요.

고려 사항 및 제한 사항

  • Git에 커밋 프로세스 중에 Fabric 서비스는 항목 정의의 일부가 아닌 항목 폴더 내의 모든 파일을 삭제합니다. 항목 폴더에 없는 관련 없는 파일은 삭제되지 않습니다.

  • 변경 내용을 커밋한 후에는 예기치 않은 변경 내용이 표시될 수 있습니다. 이러한 변경 내용은 의미상 중요하지 않으며 여러 가지 이유로 발생할 수 있습니다. 예시:

    • 항목 정의 파일을 수동으로 변경합니다. 이러한 변경 내용은 유효하지만 편집기를 통해 수행하는 경우와 다를 수 있습니다. 예를 들어 Git에서 의미 체계 모델 열의 이름을 바꾸고 이 변경 내용을 작업 영역으로 가져오는 경우 다음에 의미 체계 모델에 변경 내용을 커밋하면 bim 파일이 변경된 것으로 등록되고 수정된 열이 배열의 columns 뒤로 푸시됩니다. 이는 bim 파일을 생성하는 AS 엔진이 이름이 바뀐 열을 배열의 끝으로 푸시하기 때문입니다. 이 변경 내용은 항목 작동 방식에 영향을 주지 않습니다.

    • CRLF 줄 바꿈을 사용하는 파일 커밋 이 서비스는 LF(줄 바꿈) 줄 바꿈을 사용합니다. CRLF 줄 바꿈이 있는 Git 리포지토리에 항목 파일이 있는 경우 서비스에서 커밋하면 이러한 파일이 LF변경됩니다. 예를 들어 데스크톱에서 보고서를 여는 경우 .pbip 프로젝트를 저장하고 CRLF를 사용하여 Git에 업로드합니다.

  • 이러한 작업에 문제가 있는 경우 Git 통합 기능의 제한 사항을 이해해야 합니다.