アクティビティを非アクティブ化する

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

Data Factory in Microsoft Fabric は、よりシンプルなアーキテクチャ、組み込みの AI、および新機能を備えた次世代のAzure Data Factoryです。 データ統合を初めて使用する場合は、Fabric Data Factory から始めます。 既存の ADF ワークロードをFabricにアップグレードして、データ サイエンス、リアルタイム分析、レポートの新機能にアクセスできます。

パイプラインから 1 つ以上のアクティビティを非アクティブ化できるようになりました。それらのアクティビティは、検証およびパイプラインの実行中にスキップされます。 この機能により、パイプライン開発者の効率が大幅に向上し、お客様はキャンバスからパイプラインを削除せずにパイプラインの一部をコメント アウトできます。 後で再アクティブ化することもできます。

パイプラインで非アクティブ化されたアクティビティを示しているスクリーンショット

非アクティブ化と再アクティブ化

アクティビティを非アクティブ化するには、2 つの方法があります。

まず、[全般] タブから 1 つのアクティビティを非アクティブ化できます。

  • 非アクティブ化するアクティビティを選択します
  • [全般] タブの "アクティビティの状態" で "非アクティブ" を選択します
  • [次としてアクティビティをマークする] で状態を選択します。 "成功"、"失敗"、または "スキップ済み" から選択します

一度に 1 つのアクティビティを非アクティブ化する

または、右クリックで複数のアクティビティを非アクティブ化することもできます。

  • "Ctrl" キーを押すと複数を選択できます。 マウスを使用して、非アクティブ化するすべてのアクティビティを左クリックします
  • 右クリックしてドロップダウン メニューを表示します
  • "非アクティブ化" を選択して、すべてを非アクティブ化します
  • "次としてアクティビティをマークする" の設定を微調整するには、アクティビティの [全般] タブに移動し、適切な変更を行います

複数のアクティビティを一度に非アクティブ化する

どちらの場合も、パイプラインの実行中にパーツを非アクティブ化するために変更をデプロイする必要があります。

アクティビティを再アクティブ化するには、"アクティビティの状態" で "アクティブ" を選択します。すると想定どおりに、以前の動作に戻ります。

動作

非アクティブなアクティビティは、パイプラインでは異なる動作となります。

  1. キャンバスでは、非アクティブなアクティビティは淡色表示され、 "非アクティブのマーク" がアクティビティの種類の横に表示されます
  2. キャンバスでは、状態マーク (成功、失敗またはスキップ済み) がボックスに表示され、"次としてアクティビティをマークする" の設定が視覚化されます
  3. そのアクティビティはパイプラインの検証から除外されます。 そのため、非アクティブなアクティビティについては、すべての必須フィールドに入力する必要はありません。
  4. デバッグの実行とパイプラインの実行中、そのアクティビティは実際に実行されません。 代わりに、予約済みの状態が[非アクティブ] であるプレース ホルダーの行項目が実行されます
  5. 分岐オプションは、"次としてアクティビティをマークする" オプションによって制御されます。 つまり、以下の要件が適用されます。
    • アクティビティを "成功" としてマークすると、 "成功時" または "完了時" ブランチが実行されます
    • アクティビティを "失敗" としてマークすると、 "失敗時" または "完了時" ブランチが実行されます
    • アクティビティを "スキップ済み" としてマークすると、 "スキップ時" ブランチが実行されます
    • 詳細については、「条件付き実行」を参照してください

非アクティブ化されたアクティビティの実行状態を示しているスクリーンショット

ベスト プラクティス

非アクティブ化は、パイプライン開発者にとって強力なツールです。 これによって開発者は、アクティビティを完全に削除することなく、コードの一部を "コメント アウト" できます。 これは次のシナリオで役立ちます。

  • パイプラインを開発する場合、開発者はすべての必須フィールドに入力する前に、非アクティブなアクティビティのプレース ホルダーを追加できます。 たとえば、SQL Serverから Data Warehouse へのCopy アクティビティが必要ですが、まだすべての接続を設定していません。 そこで、反復開発プロセスのプレース ホルダーとして "非アクティブ" な Copy アクティビティを使用します。
  • 展開後、開発者は、常に問題を引き起こしている特定のアクティビティをコメント アウトして、コストのかかる再試行を回避できます。 たとえば、オンプレミスの SQL Server にネットワーク接続の問題があり、Copy アクティビティが確実に失敗することがわかっている場合です。 再試行要求によって不安定なシステムがフラッディングされるのを避けたるため、Copy アクティビティの非アクティブ化が必要になる可能性があります。

既知の制限事項

非アクティブなアクティビティは、実際に実行されることはありません。 これは、アクティビティにエラー フィールドまたはその一般的な出力フィールドがないことを意味します。 欠損しているフィールドへの参照は、後段階でエラーを引き起こす可能性があります。

関連するコンテンツ

Azure Data Factoryパイプラインと Synapse パイプラインの詳細を確認します。

  • Last updated on