Fabric 사용자 데이터 함수란 무엇인가요?

사용자 데이터 함수는 Fabric 전반과 외부 애플리케이션에서 호출할 수 있는 재사용 가능한 Python 함수를 생성할 수 있게 해줍니다. 비즈니스 로직을 한 번 작성한 후 파이프라인, 노트북, 액티베이터 규칙, Power BI 전이적 작업 흐름, 또는 REST 엔드포인트를 통한 외부 시스템에서 호출하세요.

사용자 데이터 함수는 Fabric 직접 사용자 지정 Python 코드를 호스트하고 실행할 수 있는 서버리스 컴퓨팅 환경을 제공합니다. 제품 범주를 표준화하거나, 복잡한 비즈니스 규칙을 적용하거나, 외부 API와 통합해야 하든, 전체 데이터 플랫폼에서 즉시 사용할 수 있는 함수를 작성할 수 있습니다. 이 서비스는 Python 3.11.9 런타임, PyPI의 공용 라이브러리패브릭 데이터 연결을 지원합니다.

Fabric 사용자 데이터 함수의 인터페이스를 보여주는 애니메이션 GIF.

시작할 준비가 되셨나요? 이 가이드를 따라 새 사용자 데이터 함수 항목을 생성하거나 VS 코드 확장 기능을 사용하십시오.

왜 Fabric 사용자 데이터 함수를 사용하나요?

Fabric 사용자 데이터 기능은 사용자 정의 로직을 호스팅하고 다양한 유형의 Fabric 항목과 데이터 소스에서 이를 호출할 수 있는 서버리스 플랫폼을 제공합니다. 이 서비스를 이용해 비즈니스 로직, 내부 알고리즘, 재사용 가능한 함수를 작성하여 Fabric 솔루션에 통합하세요.

주요 이점은 다음과 같습니다.

  • 재사용성: 비즈니스 로직을 사용자 데이터 함수로 한 번 작성하고, 여러 Fabric 항목(파이프라인, 노트북, 액티베이터 규칙, Power BI 전이적 작업 흐름)에서 호출하세요. 비즈니스 규칙이 변경되면 여러 위치에서 코드를 수정하는 대신 함수를 한 번 업데이트합니다.
  • 서버리스 호스팅: 인프라를 관리하지 않고 Python 함수를 배포합니다. 사용자 데이터 함수는 내장 인증과 함께 서버 없는 컴퓨트 환경을 제공하여 별도의 API 서비스나 컨테이너를 설정하고 유지할 필요가 없습니다.
  • 외부 연결: 각 함수는 고유한 REST 엔드포인트를 자동으로 노출하여 외부 애플리케이션, 웹 서비스 및 사용자 지정 클라이언트와 통합할 수 있도록 합니다. HTTP 요청을 지원하는 모든 시스템에서 함수를 호출합니다.

주요 기능

  • 한 번 작성하고 어디서든 실행: 파이프라인, 노트북, 액티베이터 규칙, Power BI, 외부 REST 호출 등 어떤 함수에서도 동일하게 작동하는 함수를 만드세요
  • 풍부한 Python 에코시스템: PyPI의 모든 패키지를 사용하여 정교한 논리(데이터 조작을 위한 pandas, API 호출 요청 또는 도메인에 대한 특수 라이브러리)를 빌드합니다.
  • 안전한 데이터 접근: 내장 인증 및 보안이 적용된 Fabric 데이터 소스(SQL 데이터베이스, 웨어하우스, 레이크하우스, 미러 데이터베이스)에 연결하세요
  • 워크플로 개발 및 게시: 함수를 게시하기 전에 함수를 테스트하여 호출에 사용할 수 있게 되기 전에 변경 내용의 유효성을 검사합니다.

통합 기능

사용자 데이터 기능은 Fabric 워크로드 및 외부 시스템과 원활하게 통합되어 포괄적인 데이터 솔루션을 구축할 수 있습니다.

패브릭 항목에서 호출

패브릭 워크로드에서 함수를 호출하여 비즈니스 논리를 중앙 집중화하고 일관성을 유지합니다.

  • 데이터 파이프라인 - 데이터 변환, 검증 또는 오케스트레이션 로직을 위한 파이프라인 활동으로 함수를 실행합니다
  • Notebooks - 데이터 과학 워크플로 및 예비 분석을 위해 PySpark 또는 Python Notebook에서 함수 호출
  • 활성화자 규칙 - 실시간 이벤트 및 스트리밍 데이터에 대한 응답으로 함수 트리거
  • Power BI translytical 작업 흐름 - 대화형 데이터 환경에 대한 Power BI 보고서에서 직접 함수를 호출합니다. 사용자 데이터 함수는 요청 페이로드에서 현재 필터 및 선택 컨텍스트와 같은 보고서 컨텍스트를 받을 수 있어, 보고서 내에서 동작 실행 및 쓰기 시나리오를 가능하게 합니다. 쓰기 저장이 완료되면 보고서의 데이터 표시 유형은 보고서의 스토리지 모드 및 새로 고침 의미 체계에 따라 달라집니다. 업데이트된 값은 Direct Lake 또는 DirectQuery 보고서에 즉시 표시되거나 가져오기 모드 보고서의 작업 흐름에 의해 자동 새로 고침이 트리거된 후에 표시됩니다.

패브릭 데이터 원본에 연결

함수는 패브릭 플랫폼 전체에서 데이터에 안전하게 액세스할 수 있습니다.

  • SQL 데이터베이스 - Fabric에서 SQL 데이터베이스의 읽기 및 쓰기 작업
  • 웨어하우스 - 구조적 데이터에 대한 읽기 및 쓰기 작업
  • Lakehouses - 레이크하우스 파일 읽기 및 쓰기; SQL 분석 엔드포인트에 대한 읽기 전용 액세스
  • 미러된 데이터베이스 - 미러된 데이터베이스 데이터에 대한 읽기 전용 액세스
  • 변수 라이브러리 - 함수 내 변수로 중앙 집중식 설정 설정에 접근할 수 있습니다.
  • Fabric에서 Cosmos DB - NoSQL 데이터 작업을 위해 Fabric 컨테이너에서 Cosmos DB에 연결하세요.
  • 비즈니스 이벤트 - 운영 데이터 변화를 감지하고 하위 애플리케이션에 대한 비즈니스 이벤트를 게시합니다.

관리 연결 외에도, 사용자 데이터 기능은 아이템 소유자 신원을 이용해 Fabric 아이템이나 Azure 리소스에 연결할 수 있는 일반 연결을 지원합니다. 일반 연결은 지정된 청중 유형에 대해 소유자 신원이 포함된 Microsoft Entra ID 토큰을 생성하여, 개별 관리되는 연결을 설정하지 않고도 Azure Cosmos DB나 Azure Key Vault와 같은 서비스와 유연하게 인증할 수 있는 방법을 제공합니다. 자세한 내용은 Fabric 항목이나 Azure 리소스에 대한 일반 연결(Generic connections)을 참조하세요.

Power BI 전이적 작업 흐름에서 쓰기 백은 사용자 데이터 기능을 호출할 때 기본적으로 지원합니다. 사용자 데이터 기능은 Fabric, 웨어하우스, 레이크하우스 파일 내 SQL 데이터베이스에 대해 추가, 업데이트, 삭제 작업을 수행할 수 있어, 작업 흐름 기반 쓰기 백 시나리오에 이상적인 통합 지점입니다.

패브릭 데이터 원본에 연결하는 방법에 대해 자세히 알아봅니다.

외부 애플리케이션에서 호출

각 사용자 데이터 함수는 Fabric 외부 시스템과의 통합을 위해 고유한 REST 엔드포인트를 자동으로 노출합니다:

  • 웹 애플리케이션 - 웹앱, 모바일 앱 또는 단일 페이지 애플리케이션에서 함수 호출
  • External services - 외부 시스템, 마이크로 서비스 또는 레거시 애플리케이션과 통합(예: Microsoft Teams 메시지 또는 업데이트 게시 또는 작업 흐름 기반 작업의 일부로 외부 REST API 호출)
  • API 워크플로 - 함수를 다른 API와 연결하여 복잡한 통합 시나리오 빌드
  • 사용자 지정 클라이언트 - HTTP 요청을 지원하는 프로그래밍 언어 또는 플랫폼에서 호출

사용자 데이터 기능을 위한 REST 엔드포인트는 Microsoft Entra ID 인증을 지원하여 외부 시스템으로부터의 안전한 접근을 보장합니다. Python 애플리케이션에서 사용자 데이터 함수를 호출하는 방법을 배워보세요.

시작하기

첫 사용자 데이터 함수를 만들 준비가 되셨나요? 원하는 개발 환경을 선택합니다.