Azure Batch アクティビティを使用して Azure Batch インスタンスでコマンドを実行する

Fabric Data FactoryのAzure Batchアクティビティは、Azure Batchインスタンスに対してコマンドを実行することを可能にします。 Azure Data FactoryやAzure SynapseからFabric Data Factoryへ移行する場合、このアクティビティは「カスタムアクティビティ」と呼ばれます。

前提 条件

開始するには、次の前提条件を満たす必要があります。

UI を使用して Azure Batch アクティビティをパイプラインに追加する

パイプラインで Azure Batch アクティビティを使用するには、次の手順を実行します。

アクティビティを作成する

  1. ワークスペースに新しいパイプラインを作成します。

  2. パイプライン アクティビティ ペインで Azure Batch を検索し、それを選択してパイプライン キャンバスに追加します。

    手記

    次のスクリーンショットで強調表示されている Azure Batch アクティビティを表示するには、メニューを展開して下にスクロールすることが必要な場合があります。

    [アクティビティ] ウィンドウと Azure Batch アクティビティが強調表示されている Fabric UI のスクリーンショット。

  3. パイプライン エディター キャンバスで新しい Azure Batch アクティビティがまだ選択されていない場合は選択します。

    Azure Batch アクティビティの [全般設定] タブを示すスクリーンショット。

全般 設定 ガイダンスを参照して、全般 設定タブを構成します。

Azure Batch アクティビティの設定

[設定] タブを選択すると、既存の Azure Batch 接続 を選択するか、新しい作成したり、実行する コマンド を指定したり、ストレージ アカウントに リソース接続を指定したりできます。 また、ストレージ アカウント内の特定の フォルダー パス と、データを保持する リテンション期間 (日数) を指定したり、独自の拡張プロパティを追加したりすることもできます。

Azure Batch アクティビティでは、WI、SPN、OAuth 接続の種類がサポートされます。

Azure Batch アクティビティの [設定] タブを示すスクリーンショット。

Azure Batch アクティビティで Fabric workspace identity を使う

  1. ワークスペースのアイデンティティを作成する

    ワークスペースでワークスペースのアイデンティティを有効にする必要があります(読み込みに少し時間がかかることがあります)。 Fabricワークスペースでワークスペースのアイデンティティを作成しましょう。 ワークスペースのアイデンティティはパイプラインと同じワークスペース内で作成すべきです。

    ワークスペースのアイデンティティに関するドキュメントをチェックしてみてください。

  2. テナント レベルの設定を有効にする

    次のテナント設定を有効にします (既定では無効になっています): サービス プリンシパルは Fabric パブリック API を呼び出すことができます。

    この設定は、Fabric管理ポータルで有効にすることができます。 この設定の詳細については、 管理者 API のサービス プリンシパル認証の有効化に関する記事を参照してください。

  3. ワークスペースのアイデンティティに権限を付与する

    ワークスペースを開き、「アクセス管理」を選択し、ワークスペースのアイデンティティに権限を割り当てます。 ほとんどのシナリオでは、共同作成者アクセスで十分です。

    ワークスペースへのアクセス権をユーザーに付与する方法に関するドキュメントを参照してください。

パイプラインを保存して実行またはスケジュールする

パイプライン エディターの上部にある [ ホーム ] タブに切り替え、[保存] ボタンを選択してパイプラインを保存します。 [ 実行 ] を選択して直接実行するか、特定の時間または間隔で実行をスケジュールする スケジュール を設定します。 パイプラインの実行の詳細については、「パイプラインの実行 をスケジュールする」を参照してください。

タブ名、[保存]、[実行]、[スケジュール] ボタンが強調表示されているパイプライン エディターの [ホーム] タブを示すスクリーンショット。

実行後、パイプラインの実行を監視し、キャンバスの下にある [出力 ] タブから実行履歴を表示できます。

既知の問題

  • 接続設定のワークスペース識別オプションが、場合によっては表示されません。 これは、現時点で修正が行われているバグです。
  • サービス プリンシパルを使用してセマンティック リンク コードを含むノートブックを実行するには、機能上の制限があり、セマンティック リンク機能のサブセットのみをサポートします。 詳細については、 サポートされているセマンティック リンク関数 を参照してください。 他の機能を使用するには、サービス プリンシパルを使用して セマンティック リンクを手動で認証することをお勧めします。
  • 一部の顧客はワークスペースのアイデンティティドロップダウンを見なかったり、見たものの接続を作成できない場合があります。 この動作は、基になるプラットフォーム コンポーネントの 1 つで既知の問題が原因です。 修正プログラムは現在進行中です。