ユーザーデータ関数のスケジューリング

Microsoft Fabricのジョブスケジューラは、パイプラインやノートブック、外部オーケストレーションサービスを必要としない、定期的なスケジュール上でユーザーデータ関数(UDF)を実行できるようにします。 ユーザーデータ関数上でスケジュールを直接設定したり、再発パターンを指定したり、関数パラメータを渡したり、Fabricのモニタリング体験から実行を監視したりできます。

前提条件

スケジュールを作成する前に、以下のことを確認してください:

  • 公開されたユーザーデータ機能があります。
  • あなたはそのワークスペースに対してContributor以上の権限を持っています。
  • この機能は手動呼び出しによって成功裏にテストされます。
  • 必要な接続、秘密、依存関係の設定を行います。

ユースケース例

ユーザーデータ機能をスケジュールし、繰り返しの業務や運営業務を自動化します。 一般的なシナリオは次のとおりです。

  • データ品質検証 – 報告や下流処理の前にデータセットのチェックを行います。
  • 顧客フィードバック処理 – 新しいフィードバックを分析し、感情スコアを生成し、結果を保存します。
  • ビジネスイベント生成 – 運用データの変化を検出し、下流アプリケーション向けにビジネスイベントを公開します。
  • スケジュールされたクリーンアップ – 古い記録のアーカイブ、一時ファイルの削除、または定期的なメンテナンス作業の実施。
  • 定期的なデータ同期 – 外部システムからデータを定期的なスケジュールでFabricに同期します。
  • 自動通知 – ビジネスルールや閾値に基づいてアラートや通知を生成します。

スケジューラーを開く

  1. Fabric ワークスペースを開きます。
  2. ユーザーデータ関数項目を開きます。
  3. 設定を選択します。
  4. [スケジュール] を選択します。

スケジュールページでは、以下が可能になります:

  • スケジュールを作成する
  • エラー通知を構成する
  • 予定された処刑を見る
  • スケジュールの編集または無効化
  • 手動でスケジュールされたジョブを実行する

スケジュールを作成する

  1. スケジュールで「スケジュールを追加」を選択してください。

  2. スケジュールプロパティを設定してください。

    スケジューラは以下の設定をサポートしています:

    Setting 説明
    Controller 変数ライブラリから実行を制御するために使われる変数
    繰り返し 再発パターンを定義します
    インターバル 周波数間隔
    開始日時 スケジュールが始まるとき
    終了日時 スケジュールが切れるとき
    タイム ゾーン スケジュール実行のためのタイムゾーン
    Parameters 関数に渡された入力パラメータ

    関数がどのくらいの頻度で実行されるかを選び、スケジューリングの詳細を提供してください。 スケジューラは数分ごと、1時間ごと、1日ごと、週ごと、または月ごとなどの定期的な実行をサポートしています。 例えば、15分ごとに関数を実行するには、次のように設定します:

  3. FunctionNameのパラメータを提供します。 このパラメータは、呼び出す関数を定義するために 必要 です。

    パラメーター名 タイプ 価値
    関数名 String 関数名、例えば hello_fabric
  4. 関数入力にパラメータを追加してください。 例えば、 hello_fabric(name:str) の場合、パラメータ name 型文字列を追加します。

    パラメーター名 タイプ
    名前 String

    Important

    パラメータ名はユーザーデータ関数の署名と正確に一致しなければなりません。 パラメーター名では大文字と小文字が区別されます。

  5. スケジュールを保存します。

  6. ユーザーデータ関数項目に他の機能のスケジュールを追加してください。

手動でスケジュールされた機能を実行する

スケジュールされた関数をすぐにテストするには、 実行を選択します。 Fabricは次のスケジュールされた間隔を待たずに実行を送信します。 手動実行はパラメータの検証、接続の検証、関数ロジックのテストに役立ちます。

スケジュールされた実行を監視する

Fabricのモニタリング体験からユーザーデータ機能の実行を監視できます。

  1. モニターハブを開いてください。
  2. 活動 を選択します。
  3. ユーザーデータ機能によるフィルター。

モニタリング体験を使って、失敗した実行のトラブルシューティングや実行の検証を行いましょう。

エラー通知を構成する

失敗したスケジュール実行に対してメール通知を設定することも可能です。

  1. スケジュールページを開きます。
  2. 失敗通知では、1つ以上のメールアドレスを入力してください。
  3. 構成を保存します。

Fabricはスケジュールされた実行が失敗するたびにメール通知を送信します。

次のステップ

  • ユーザーデータ機能について学びましょう。
  • Fabricのジョブスケジューラについて学びましょう。
  • Monitorハブを使ってFabricワークロードを監視しトラブルシューティングします。