Fabric 사용자 데이터 함수(User Data Function) (1)

 

Fabric 사용자 데이터 함수(User Data Function) (1) – 생성, 테스트

 

Fabric UDF와 DAX UDF를 잘못 이해하고 계신 분이 있어 이번 글에서 간략히 정리하고, 활용하는 측면을 구체적으로 추가로 알아보겠습니다.

 

Fabric 사용자 데이터 함수(User Data Function)는 Microsoft Fabric 내에서 사용자가 정의한 Python 코드를 통해 비즈니스 로직을 실행할 수 있는 기능으로 데이터 파이프라인과 노트북, Power BI 등에서 Fabric UDF를 이용할 수 있습니다. Fabric UDF를 이용하게 되면 재사용성, 캡슐화, 외부 시스템과 통합 등의 이점을 얻을 수 있습니다.

 

DAX에서도 UDF를 지원합니다만, DAX의 사용자 정의 함수(User-Defined Function)는 Fabric UDF와 다른 기능입니다. 반복적이거나 비즈니스 로직이 포함된 DAX 수식을 사용자 정의 함수(UDF)로 생성하여 DAX 수식에서 재사용할 수 있습니다.

 

여기서는 간략히 Fabric UDF를 생성하고 테스트해보겠습니다.

새 항목 만들기에서 [사용자 데이터 함수]를 선택하고 함수 이름을 입력하여 함수를 생성합니다.

시작 화면에서는 [새 함수]를 클릭하여 샘플 함수를 생성합니다.

hello_fabric 샘플 함수를 확인할 수 있습니다.

아래 구문은 기본으로 있어야 하는 내용입니다.

@udf.function() 구문은 사용자 데이터 함수라고 알리는 내용으로 함수 정의문 앞에 위치시킵니다.

def hello_fabric(name: str) -> str: 함수 정의 구문으로 함수 이름과 name이라는 문자열 매개변수, 반환 값이 문자열이라는 것을 정의하게 됩니다.

간략히 함수를 테스트할 수 있습니다. 오른쪽 함수 탐색기 창에서 함수 이름 위에 마우스를 올리면 테스트할 수 있는 아이콘을 확인할 수 있습니다. 테스트를 클릭하면 왼쪽에서 테스트 창을 확인할 수 있습니다. 문자열을 입력하고 결과를 확인하면 됩니다.

 

샘플 함수를 살펴보고 테스트를 해보았으니 직접 로직을 생성하거나 샘플 코드를 이용할 수 있습니다. [편집] 메뉴에서 [샘플 삽입]을 확인해보면, 다양한 예제가 있는 것을 확인할 수 있습니다.

웨어하우스의 데이터 조회, 레이크하우스에 파일 쓰기, Pandas 데이터 수정, 카드 번호 마스킹 등의 예제가 있습니다.

[샘플 삽입]에서 SQL Database의 테이블 읽기를 선택하면 함수 편집기에 코드가 추가되며 함수 탐색기에서 새 함수를 확인할 수 있습니다. 샘플 코드를 요구사항에 맞게 수정해야 하며, 필요시 Python 라이브러리를 추가해야 할 수 있습니다. 웨어하우스 등 데이터베이스와 연동하게 되면 연결을 추가하고 별칭을 소스코드에서 지정해야 합니다.

사용자 정의 함수의 연결은 Fabric의 항목만 가능하며 외부 데이터베이스는 REST API 등을 호출하여 처리할 수 있습니다.

 

간략히 Fabric의 사용자 데이터 함수(UDF)를 생성하여 테스트하는 방법을 간략히 알아보았습니다. 다음 글에서 데이터베이스의 값을 조회, 변경하는 내용을 다루어보겠습니다.