Fabric 사용자 데이터 함수는 Fabric 기반 데이터 원본을 기반으로 빠르고 쉽게 애플리케이션을 개발할 수 있는 서버리스 솔루션입니다. Fabric의 서버리스 컴퓨팅의 장점은 유연성과 비용 효율성이 향상된다는 것입니다. 사용자 데이터 함수는 서비스에서 제공하는 엔드포인트에 대한 HTTP 요청으로 호출되며 Fabric 기반 데이터 원본에서 작동합니다.
이 빠른 시작에서는 VS(Visual Studio) Code에서 사용자 데이터 함수 항목을 만드는 방법을 알아봅니다.
필수 조건
작업 영역을 선택합니다.
VS Code를 열고 Fabric에 로그인합니다.
Fabric에서 Fabric 작업 영역을 열거나새로운 작업 영역을 만듭니다.
+ 새 항목을 선택하여 새 항목 창을 엽니다.
새 항목 창의 데이터 개발에서 사용자 데이터 함수 항목 종류를 선택합니다.
새로운 사용자 데이터 함수 항목의 이름을 입력하고 만들기를 선택합니다. 새로운 사용자 데이터 함수 항목이 만들어졌습니다.
리본에서 런타임 언어로 Python을 선택합니다.
이 사용자 데이터 함수 항목에 대한 가상 환경을 만듭니다.
Python 런타임 버전을 선택합니다. 사용자 데이터 함수를 사용하려면 Python 버전 3.11이 필요합니다.
예를 선택하여 폴더의 가상 환경을 설정합니다.
function_app.py를 열어 두 개 이상의 함수를 추가합니다.
첫 번째 함수 작성
@udf.function() 데코레이터를 사용하여 함수 시작을 정의하는 사용자 데이터 함수 항목을 작성합니다. str, int, float 등과 같은 기본 데이터 형식과 같은 함수에 대한 입력을 전달할 수 있습니다. 함수 내에서 사용자 지정 비즈니스 논리를 작성할 수 있습니다.
hello_fabric 함수의 예는 다음과 같습니다.
@udf.function()
def hello_fabric(name: str) -> str:
# Use logging to write custom logs to help trace and debug issues
logging.info('Python UDF trigger function processed a request.')
logging.info('Executing hello fabric function.')
return f"Welcome to Fabric Functions, {name}, at {datetime.datetime.now()}!"
VS Code에서 사용자 데이터 함수 관리
현재 열려 있는 작업 영역 내 VS Code의 Fabric 탐색기에서 사용자 데이터 함수 항목을 볼 수 있습니다.
Fabric 작업 영역의 모든 함수는 VS Code의 탐색기에서 열어서 편집을 시작할 수 있습니다. 열려는 함수를 선택한 다음 탐색기에서 열기를 선택합니다. 사용자 데이터 함수 항목에 작성된 연결, 라이브러리 및 모든 함수를 볼 수 있습니다.
연결 및 라이브러리 관리
연결: 사용자 데이터 함수에 추가된 모든 데이터 연결은 Fabric 탐색기에서 볼 수 있습니다. 마우스 오른쪽 단추를 클릭하고 사용자 데이터 함수 항목에 대해 Fabric에서 연결 관리를 선택합니다.
라이브러리: 사용자 데이터 함수 항목에 추가된 모든 라이브러리는 Fabric 탐색기에서 볼 수 있습니다. 마우스 오른쪽 단추를 클릭하고 Fabric에서 라이브러리 관리를 선택하여 사용자 데이터 함수 항목에 대한 새 라이브러리를 추가합니다.
함수: 게시된 모든 수를 여기에서 볼 수 있습니다. 함수를 선택하고 다음 작업을 수행합니다.
- API 테스트 도구를 사용하지 않고도 VS Code에서 함수를 테스트하려면 실행 및 테스트합니다.
- 공용 URL 복사 이 함수가 공개적으로 액세스 가능한 경우 외부 애플리케이션에서 호출합니다.
사용자 데이터 함수를 관리하는 로컬 폴더
VS Code 탐색기에서 열린 사용자 데이터 함수 항목은 로컬 폴더 보기에 표시됩니다. 로컬 폴더를 이용하면 사용자 데이터 함수 항목에 대한 로컬 변경 내용을 테스트하고 확인할 수 있습니다.
함수: 로컬
function_app.py파일에 있는 모든 함수를 볼 수 있습니다. 샘플로 시작하려면 함수를 마우스 오른쪽 단추로 클릭하고 함수 추가를 선택하여 샘플 함수를 추가합니다.
로컬에서 함수를 테스트하려면 F5 키를 눌러 디버깅을 시작합니다. 또한 함수 항목을 선택하고 실행 및 디버그를 선택할 수도 있습니다.
로컬 함수에 대한 연결 및 라이브러리 보기: 로컬 환경에서
local.settings.json에 있는 모든 연결과requirements.txt파일에 있는 라이브러리를 볼 수 있습니다.- 로컬 환경의 현재 연결 목록을 표시하려면 local.settings에서 연결을 동기화합니다.
- 로컬 환경에 있는 현재 라이브러리 목록을 표시하려면 requirements.txt를 동기화합니다.
사용자 데이터 함수 게시
변경 내용을 테스트한 후 Fabric에 사용자 데이터 함수를 게시합니다. 변경 내용을 게시하는 데 몇 분이 걸릴 수 있습니다.
중단점을 사용하여 로컬 디버깅
F5 키를 선택하여 Fabric 함수를 디버깅합니다. 코드의 어느 곳에나 중단점을 추가할 수 있습니다. 디버그 모드에서는 예상대로 중단점이 적용되고, 배포된 함수를 테스트하듯이 코드를 테스트합니다.
