Webhook アクティビティを使用すると、カスタム コードでパイプラインの実行を制御できます。 Webhook アクティビティを使用すると、コードでエンドポイントを呼び出して、コールバック URL を渡すことができます。 パイプラインでは、次のアクティビティに進む前に、コールバックが呼び出されるまで実行が待機されます。
前提条件
開始するには、次の前提条件を満たしている必要があります。
- アクティブな Microsoft Fabric サブスクリプションを持つテナント アカウント。 無料試用版で Fabric を試すことができます。
- ファブリック ワークスペース。
UI を使用したパイプラインに WebHook アクティビティを追加する
パイプライン内で WebHook アクティビティを使用するには、次の手順を実行します。
アクティビティの作成
ワークスペースに新しいパイプラインを作成します。
パイプラインの [アクティビティ] ペイン内で WebHook を探し、それを選択してパイプライン キャンバスに追加します。
注記
画面の解像度が非常に高い場合を除き、WebHook アクティビティを見つけるには、省略記号 ... ボタンを使用してツールバーからアクティビティの一覧を展開する必要があります。
まだ選択してない場合は、キャンバス上で新しい WebHook アクティビティを選びます。
[全般設定] タブを構成するには、全般設定のガイダンスを参照してください。
WebHook アクティビティの設定
[設定] タブを選択し、[接続] ドロップダウンから既存の接続を選択するか、新しい接続を作成して、その構成の詳細を指定します。
新しい接続を作成すると、接続作成ダイアログが表示され、接続するためのベース URL と資格情報を指定できます。
オンプレミスまたは仮想ネットワーク データ ゲートウェイの使用
接続を作成するときに、オンプレミス データ ゲートウェイ (OPDG) または仮想ネットワーク データ ゲートウェイのいずれかを使用できるようになりました。 OPDG の作成と構成に関するガイダンスについては、 オンプレミス データ ゲートウェイを作成する方法を参照してください。
仮想ネットワーク ゲートウェイを使用する場合は、 仮想ネットワーク データ ゲートウェイを作成する方法を参照してください。
ゲートウェイを正常に作成して構成すると、接続ダイアログの [データ ゲートウェイ] ドロップダウンの下に表示されます。
お使いの接続を選択または作成したら、残りの必須フィールドに入力する、必要なヘッダーを追加する、または詳細設定を設定します。 WebHook アクティビティは POST メソッドのみをサポートします。
アクティビティからの出力を他のアクティビティへの入力として使用し、宛先アクティビティで動的コンテンツがサポートされている任意の場所で出力を参照します。
パイプラインを保存して実行またはスケジュールする
通常、WebHook アクティビティの出力は他のアクティビティと使用しますが、一旦構成すると、他のアクティビティなしで直接実行することもできます。 もし何らかのアクションを実行する REST API を呼び出すために Web アクティビティを実行しており、そのアクティビティの出力が不要であれば、お使いのパイプラインには Web アクティビティだけが含まれることもあります。
パイプライン エディターの上部にある [ ホーム ] タブに切り替え、[保存] ボタンを選択してパイプラインを保存します。 [ 実行 ] を選択して直接実行するか、特定の時間または間隔で実行をスケジュールする スケジュール を設定します。 パイプラインの実行の詳細については、「パイプラインの実行 をスケジュールする」を参照してください。
実行後、パイプラインの実行を監視し、キャンバスの下にある [出力 ] タブから実行履歴を表示できます。