Fabric Invoke パイプライン アクティビティは、別のMicrosoft Fabric パイプラインを実行できます。 これを使用して、1 つのパイプライン内から 1 つまたは複数のパイプラインの実行を調整できます。 これは、複雑なワークフローの整理、再利用、管理に役立ちます。 呼び出しパイプライン アクティビティは、特定の目的を持つ他のパイプラインを呼び出すことによって、再利用可能なモジュール式パイプライン パターンを作成するのに非常に役立ちます。
Prerequisites
開始するには、次の前提条件を満たしている必要があります。
- プロビジョニングされた capacity を持つMicrosoft Fabric テナントにアクセスできる必要があります。 無料試用版でFabricをお試しください。
- Fabric workspaceその容量に割り当てられます。
Note
現在、2 つの呼び出しパイプライン アクティビティがあります。 Invoke パイプライン (レガシ) では、親パイプラインと同じワークスペース内のFabric パイプラインのみがサポートされます。 また、親パイプラインのみを監視でき、レガシ アクティビティを使用して ADF (Azure Data Factory) または Synapse パイプラインを呼び出すことはできません。 新しい Invoke パイプライン アクティビティを使用すると、ADF または Synapse から Fabric ワークスペース間でパイプラインを呼び出し、子パイプラインを監視できます。
UI を使用して パイプラインに呼び出しパイプライン アクティビティ を追加する
パイプラインで呼び出しパイプライン アクティビティを使用するには、次の手順を実行します。
アクティビティを作成する
ワークスペースに新しいパイプラインを作成します。
パイプライン アクティビティ ペインで呼び出しパイプラインを検索し、それを選択してパイプライン キャンバスに追加します。
キャンバス上の新しい 呼び出しパイプライン アクティビティ がまだ選択されていない場合は選択します。
[全般設定] タブを構成するには、全般設定のガイダンスを参照してください。
パイプラインの呼び出し (レガシー) 設定
[ 設定] タブを選択し、[ 呼び出されたパイプライン ] ドロップダウンから既存のパイプラインを選択するか、[ + 新規 ] ボタンを使用して新しいパイプラインを直接作成します。 完了を待機するか、直接続行するかを選択できます。続行の場合、呼び出されたパイプラインは、親パイプラインの実行フロー内でその後のアクティビティと並行して実行されます。
パイプライン設定を呼び出す
[ 設定] タブを選択し、アクティビティを構成します。
Fabricからパイプラインを呼び出す
種類: パイプラインのソースFabric選択します。
接続: 各Invoke パイプライン アクティビティには、セキュリティで保護されたFabric資格情報ストアに格納されている Connection オブジェクトが必要です。 この接続オブジェクトには、Fabric ワークスペースに関連付けられているユーザー トークンが格納されます。 新しい Invoke パイプライン アクティビティをまだ作成していない場合は、アクティビティを使用する前に、最初に新しい接続オブジェクトを作成する必要があります。
パイプライン接続を設定するときに、 認証の種類として、組織アカウント、サービス プリンシパル、またはワークスペース ID の 3 つのオプションが用意されています。
ワークスペース: 親パイプラインから呼び出すターゲット パイプラインがあるFabric ワークスペースを選択します。
パイプライン: 呼び出すパイプラインを選択します。
ADF および Synapse からパイプラインを呼び出す
- 種類: パイプラインのソース (Fabric、Azure Data Factory、Synapse) を選択します
- 接続: 接続として登録されているFabric、Azure Data Factory、または Synapse への参照
- パイプライン: 呼び出すパイプライン名を選択します
Fabric ワークスペースアイデンティティ (WI) をインボークパイプラインアクティビティで使用する
ワークスペース ID を作成する
ワークスペースで WI を有効にする必要があります (読み込みに少し時間がかかる場合があります)。 Fabric ワークスペースにワークスペース ID を作成します。 WI はパイプラインと同じワークスペースに作成する必要があることに注意してください。
ワークスペース ID に関するドキュメントを確認してください。
テナント レベルの設定を有効にする
次のテナント設定を有効にします (既定では無効になっています):Service プリンシパルはパブリック API Fabric呼び出すことができます。
この設定は、Fabric管理ポータルで有効にすることができます。 この設定の詳細については、 管理者 API のサービス プリンシパル認証の有効化に関する記事を参照してください。
ワークスペース ID にワークスペースのアクセス許可を付与する
ワークスペースを開き、[アクセスの管理] を選択し、ワークスペース ID にアクセス許可を割り当てます。 ほとんどのシナリオでは、共同作成者アクセスで十分です。 パイプライン(呼び出しているもの)があなたのパイプラインと同じワークスペースにない場合、あなたのパイプラインのワークスペースで作成したWIに、少なくともそのパイプラインのワークスペースへの共同作成者アクセス権を付与する必要があります。
パイプラインを保存して実行またはスケジュールする
パイプライン エディターの上部にある [ ホーム ] タブに切り替え、[保存] ボタンを選択してパイプラインを保存します。 [ 実行 ] を選択して直接実行するか、特定の時間または間隔で実行をスケジュールする スケジュール を設定します。 パイプラインの実行の詳細については、「パイプラインの実行 をスケジュールする」を参照してください。
実行後、パイプラインの実行を監視し、キャンバスの下にある [出力 ] タブから実行履歴を表示できます。