이 문서에서는 Microsoft Fabric의 사용자 데이터 함수에 대한 Git 통합 및 배포 파이프라인이 작동하는 방식을 설명합니다. Git 통합을 사용하면 패브릭 작업 영역을 리포지토리 분기와 동기화된 상태로 유지하여 사용자 데이터 함수의 버전을 제어하고, 분기 및 끌어오기 요청을 사용하여 공동 작업하고, Azure DevOps와 같은 기본 Git 도구에서 코드를 사용할 수 있습니다.
Git 통합의 기본 개념에서 Git을 Microsoft Fabric 작업 영역과 통합하는 프로세스에 대해 자세히 알아봅니다.
연결 설정
작업 영역 설정에서 리포지토리에 대한 연결을 쉽게 설정하여 변경 내용을 커밋하고 동기화할 수 있습니다. 연결을 설정하려면 Git 통합 시작을 참조하세요. 연결되면 사용자 데이터 함수를 포함한 항목이 소스 제어 창에 나타납니다.
사용자 데이터 함수 항목을 Git 리포지토리에 성공적으로 커밋하면 리포지토리에 사용자 데이터 함수 폴더가 표시됩니다. 이제 끌어오기 요청 만들기 등의 향후 작업을 실행할 수 있습니다.
Git에서의 사용자 데이터 함수 표현
다음 이미지는 리포지토리에 있는 각 사용자 데이터 함수 항목의 파일 구조 예제를 보여 줍니다.
폴더 구조에는 다음과 같은 요소가 포함됩니다.
.platform:
.platform파일에는 다음 특성이 포함되어 있습니다.
- version: 시스템 파일의 버전 번호입니다. 이 숫자는 이전 버전과의 호환성을 사용하도록 설정하는 데 사용됩니다. 항목의 버전 번호가 다를 수 있습니다.
- logicalId: 항목 및 해당 소스 제어 표현을 나타내는 자동으로 생성된 작업 영역 간 식별자입니다.
-
type:
UserDataFunction은 사용자 데이터 함수 항목을 정의하는 형식입니다. - displayName: 항목의 이름을 나타냅니다. 사용자 데이터 함수 항목의 이름이 변경되면 이 displayName이 업데이트됩니다.
definitions.json: 이 파일은 사용자 데이터 함수 항목 속성의 표현으로 연결, 라이브러리 등과 같은 모든 사용자 데이터 함수 항목 정의를 공유합니다.
function-app.py: 이 파일은 함수 코드입니다. 사용자 데이터 함수 항목에 대한 모든 코드 변경 내용은 이 파일을 통해 리포지토리에 동기화됩니다. 다양한 Git 작업을 수행하여 코드 개발 주기를 관리할 수 있습니다.
resources: 이 폴더에는 이 항목 내의 연결, 라이브러리, 함수 등 모든 메타데이터가 포함된 functions.json 파일이 들어 있습니다. 이 파일을 수동으로 업데이트하지 마세요.
functions.json은 Fabric이 작업 영역에서 사용자 데이터 함수 항목을 만들거나 다시 만들 수 있도록 합니다.
폴더 구조 및 시스템 파일에 대한 세부 정보를 포함하여 Git 통합에 대한 자세한 내용은 Git 통합 소스 코드 형식을 참조하세요.
배포 파이프라인의 사용자 데이터 함수
배포 파이프라인을 사용하여 개발, 테스트 및 프로덕션과 같은 다양한 환경에 사용자 데이터 함수를 배포할 수 있습니다. 배포 파이프라인을 사용하면 개발 프로세스를 간소화하고, 품질과 일관성을 보장하며, 간단한 코드가 낮은 작업으로 수동 오류를 줄일 수 있습니다.
비고
모든 연결과 라이브러리는 다른 환경에서 만들어진 새로운 사용자 데이터 함수 항목에 추가됩니다.
배포 파이프라인을 사용하여 사용자 데이터 함수를 배포하려면 다음을 수행합니다.
새 배포 파이프라인을 만들거나 기존 배포 파이프라인을 엽니다. 자세한 내용은 배포 파이프라인 시작을 참조하세요.
배포 목표에 따라 여러 단계에 작업 영역을 할당합니다.
다양한 단계 간의 사용자 데이터 함수 항목을 포함한 항목을 선택하고, 보고, 비교합니다.
테스트 환경에 사용자 데이터 함수 항목을 배포하려면 배포를 선택합니다. 이 배포에 대한 변경 내용에 대한 세부 정보를 제공하는 메모를 추가할 수 있습니다. 마찬가지로 개발, 테스트, 프로덕션 단계에 걸쳐 변경 내용을 푸시할 수 있습니다.
배포 기록배포 상태를 모니터링합니다.