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

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。

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

Screenshot showing an inactive activity in pipeline

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

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

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

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

Deactive one activity at a time

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

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

Deactive multiple activities all at once

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

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

動作

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

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

Screenshot showing activity run status of an inactive activity

ベスト プラクティス

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

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

既知の制限事項

非アクティブなアクティビティは、実際に実行されることはありません。 これは、アクティビティにエラー フィールドまたはその一般的な出力フィールドがないことを意味します。 欠損しているフィールドを参照している場合、エラーがダウンストリームにスローされます。

関連するコンテンツ

Azure Data Factory と Synapse パイプラインの詳細について参照してください。