이 문서에서는 Fabric 사용자 데이터 함수의 서비스 세부 정보와 현재 제한 사항에 대해 자세히 설명합니다.
용량 보고
Fabric 사용자 데이터 함수의 사용량은 Fabric Capacity Metrics 애플리케이션에서 보고됩니다. 용량 보고서는 Fabric 사용자 데이터 함수의 만들기, 게시, 실행 및 스토리지에 대한 정보를 제공합니다. Fabric Capacity Metrics 앱에서 보고된 계량기에 대한 자세한 내용을 알아보려면 Fabric 운영을 확인하세요.
네트워크 보안 요구 사항
패브릭 사용자 데이터 함수가 올바르게 작동하려면 네트워크에서 패브릭 엔드포인트에 대한 "다중 파트/양식 데이터" 요청 및 파일 업로드를 허용해야 합니다. 이 요구 사항이 없는 경우 다음 요청으로 인해 CORS(원본 간 리소스 공유) 오류가 발생할 수 있습니다. 함수 게시 및 사용자 지정 라이브러리 업로드.
제한점
다음은 패브릭 사용자 데이터 함수에 대한 현재 제한 사항입니다.
함수는 소유자만 편집할 수 있습니다. 현재 사용자 데이터 함수 항목의 소유자만 함수 코드를 수정하고 게시할 수 있습니다. Fabric 항목의 소유권을 이전하는 방법에 대한 지침은 Fabric 항목의 소유권 가져오기를 참조하세요.
함수 게시 대기 시간: 함수를 게시한 후 다시 게시하기 전에 2분 이상 기다려야 합니다. 이 쿨다운 기간은 Functions 브라우저 내 포털, 사용자 데이터 함수 Visual Studio Code 확장, GIT 가져오기 작업 또는 배포 파이프라인을 사용하여 게시할 때 적용됩니다.
"연결 관리"는 Fabric 데이터 원본만 지원합니다.: "연결 관리" 기능은 현재 Fabric 기반 데이터 원본에만 연결하는 것을 지원합니다. 자세한 내용은 데이터 원본에 연결을 참조하세요.
"연결 관리"는 이름에 특수 문자가 있는 리소스에 연결할 수 없습니다. 이름에 특수 문자가 있는 데이터베이스와 같은 패브릭 리소스(예: 중괄호 또는 ASCII가 아닌 문자)는 사용자 데이터 함수의 연결 관리 환경과 호환되지 않습니다. 자세한 내용은 데이터 원본에 연결을 참조하세요.
사용자 데이터 함수에 대한 지역별 제한 사항: 사용자 데이터 함수는 패브릭 지역의 하위 집합에서 사용할 수 없습니다. Fabric 사용자 데이터 함수를 사용할 수 있는 지역의 업데이트된 목록은 Fabric 지역 가용성을 참조하세요. 홈 테넌트가 지원되지 않는 지역에 있는 경우 지원되는 지역에서 용량을 만들어 사용자 데이터 함수를 사용할 수 있습니다. 자세한 내용은 Fabric 용량 관리를 참조하세요.
개발 모드의 테스트 기능에 대한 지역별 제한 사항: 개발 모드의 테스트 기능은 브라질 남부, 이스라엘 중부 및 멕시코 중부의 패브릭 지역에서 사용할 수 없습니다. 함수를 게시하고 실행하거나 VS Code 확장을 사용하여 로컬로 테스트하여 함수를 테스트할 수 있습니다.
패브릭 사용자 데이터 함수의 예약된 Python 키워드: Python 언어의 예약된 키워드 외에도 Fabric 사용자 데이터 함수는 다음 키워드를
reqcontext사용합니다.reqInvocationId예약된 키워드는 매개 변수 이름이나 함수 이름으로 사용할 수 없습니다.기본값 또는 선택적 값이 있는 매개 변수는 지원되지 않습니다. 현재 호출을 호출할 때 모든 함수 매개 변수가 필요합니다. 마찬가지로 함수 인수 정의에 기본값을 제공하는 것은 현재 지원되지 않습니다. 예를 들어 아래 함수는 구문 오류를 throw합니다.
# The default value for the argument called 'name' is not supported and treated like a syntax error. @udf.function() def goodbye_fabric(name: str = "N/A") -> str: return f"Goodbye, {name}."서비스 주체 지원: 서비스 주체를 사용하여 패브릭 항목 또는 데이터 원본에 액세스하는 것은 현재 지원되지 않습니다. 예를 들어 패브릭 사용자 데이터 함수를 관리 ID 또는 작업 영역 ID로 사용할 수 없습니다.
서비스 제한
다음 목록은 사용자 데이터 함수 항목에 대한 서비스 한도를 자세히 설명합니다.
| 한계 | 가치 | 설명 |
|---|---|---|
| 요청 페이로드 길이 | 4MB | 모든 요청 매개 변수의 최대 크기. |
| 요청 실행 시간 제한 | 240초 | 함수가 실행될 수 있는 최대 시간. |
| 응답 크기 제한 | 30MB | 함수의 응답 반환 값의 최대 크기. |
| 로그 보존 | 30일 | 기본적으로 과거 호출 로그가 보존되는 일 수. |
| 프라이빗 라이브러리 최대 크기 | 28.6MB | 라이브러리 관리 환경에 프라이빗 라이브러리로 업로드된 파일의 .whl 최대 크기입니다. |
| 포털 시간 제한에서 테스트 | 15분 | 새 요청이 처리될 때까지 테스트 세션이 활성화된 시간입니다. 세션은 시간 제한 기간 내에 새 요청을 받으면 15분까지 연장됩니다. |
| Python 버전(실행 기능) | 3.11 | 실행 전용 모드에서 게시된 함수에 사용되는 Python 버전입니다. |
| Python 버전(테스트 기능) | 3.12 | 개발 모드의 테스트 기능에 사용되는 Python 버전입니다. |