この記事では、Fabric ユーザー データ関数のサービスの詳細と現在の制限について詳しく説明します。
容量レポート
Fabric ユーザー データ関数の使用状況は、Fabric 容量メトリック アプリケーションで報告されます。 容量レポートは、Fabric ユーザー データ関数の作成、発行、実行、およびストレージを考慮します。 Fabric 容量メトリック アプリで報告されるメーターの詳細については、「Fabric 操作」を参照してください。
ネットワーク セキュリティの要件
Fabric ユーザー データ関数を正しく機能させるには、ネットワークで "マルチパート/フォーム データ" 要求と Fabric エンドポイントへのファイルアップロードを許可する必要があります。 この要件が満たされていない場合、クロスオリジン リソース共有 (CORS) エラーが発生する可能性があります。関数の発行とカスタム ライブラリのアップロードです。
制限事項
ファブリック ユーザー データ関数の現在の制限事項を次に示します。
関数は所有者のみが編集できます。現時点では、ユーザー データ関数項目の所有者のみが関数コードを変更および発行できます。 Fabric 項目の所有権を譲渡する方法については、「Fabric 項目の所有権を取得する」を参照してください。
関数の発行のクールダウン期間: 関数を発行した後、少なくとも 2 分待ってから再度発行する必要があります。 このクールダウン期間は、Functions のブラウザー内ポータル、User Data Functions Visual Studio Code 拡張機能、GIT インポート アクション、またはデプロイ パイプラインを使用して発行する場合に適用されます。
"接続の管理" では、Fabric データ ソースのみがサポートされます: "接続の管理" 機能では、現時点ではファブリックネイティブのデータ ソースへの接続のみがサポートされます。 詳細については、「データ ソースへ接続する」に関するページを参照してください。
"接続の管理" は、名前に特殊文字が含まれるリソースに接続できません。名前に特殊文字 (中かっこや ASCII 以外の文字など) を含む Fabric リソースは、ユーザー データ関数の接続管理エクスペリエンスと互換性がありません。 詳細については、「データ ソースへ接続する」に関するページを参照してください。
ユーザー データ関数のリージョンの制限事項: ユーザー データ関数は、Fabric リージョンのサブセットでは使用できません。 Fabric ユーザー データ関数を使用できるリージョンの最新の一覧については、「Fabric リージョンの可用性」を参照してください。 お使いのホーム テナントがサポートされていないリージョンにある場合は、ユーザー データ関数を使用するために、サポートされているリージョンに容量を作成できます。 詳細については、「ファブリック容量の管理」を参照してください。
開発モードでのテスト機能のリージョン制限: 開発モードのテスト機能は、ブラジル南部、イスラエル中部、メキシコ中部のファブリック リージョンでは使用できません。 関数を発行して実行するか、 VS Code 拡張機能 を使用してローカルでテストすることで、関数をテストできます。
Fabric ユーザー データ関数の予約済み Python キーワード: Fabric ユーザー データ関数では、Python 言語の予約済みキーワードに加えて、
req、context、reqInvocationIdのキーワードも使用されます。 予約済みキーワードは、パラメーター名または関数名として使用できません。既定値または省略可能な値を持つパラメーターはサポートされていません。現時点では、呼び出しを呼び出すときにすべての関数パラメーターが必要です。 同様に、関数引数の定義に既定値を指定することは現在サポートされていません。 たとえば、次の関数は構文エラーをスローします。
# 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}."サービス プリンシパルのサポート: サービス プリンシパルを使用した Fabric 項目またはデータ ソースへのアクセスは、現在サポートされていません。 たとえば、Fabric User Data Functions をマネージド ID またはワークスペース ID として使用することはできません。
サービスの制限
次の一覧では、ユーザー データ関数項目のサービス制限について詳しく説明します。
| 極限 | 価値 | 説明 |
|---|---|---|
| 要求ペイロードの長さ | 4 MB | すべての要求パラメーターを結合した最大サイズ。 |
| 要求の実行タイムアウト | 240 秒 | 関数を実行できる最大時間。 |
| 応答サイズの制限 | 30メガバイト | 応答の関数の戻り値の最大サイズ。 |
| ログの保存 | 30 日 | 履歴呼び出しログが保持される既定の日数。 |
| プライベート ライブラリの最大サイズ | 28.6 MB | プライベート ライブラリとしてライブラリ管理エクスペリエンスにアップロードされる .whl ファイルの最大サイズ。 |
| ポータルでのテストのタイムアウト | 約 15 分 | 新しい要求が処理されるまでのテスト セッションがアクティブな時間。 タイムアウト期間内に新しい要求を受信すると、セッションは 15 分延長されます。 |
| Python バージョン (実行機能) | 3.11 | 実行専用モードで発行された関数に使用される Python バージョン。 |
| Python バージョン (テスト機能) | 3.12 | 開発モードの テスト機能 に使用される Python バージョン。 |