適用対象: 
Azure Data Factory Azure Synapse Analytics
ヒント
企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft Fabric は、データ移動からデータ サイエンス、リアルタイム分析、ビジネス インテリジェンス、レポートまで、あらゆるものをカバーしています。 無料で新しい試用版を開始する方法について説明します。
この記事は、Azure Data Factory と Azure Synapse Analytics のパイプライン パラメーターと変数の違いと、それらを使用してパイプラインの動作を制御する方法を理解するのに役立ちます。
パイプラインのパラメーター
パラメーターはパイプライン レベルで定義され、パイプラインの実行中は変更できません。 パイプライン パラメーターを使用すると、データセットの接続詳細や処理するファイルのパスを渡すことなどで、パイプラインとそのアクティビティの動作を制御できます。
パイプライン パラメーターを定義する方法
パイプライン パラメーターを定義するには、次の手順に従います。
- パイプラインをクリックして、その構成タブを表示します。
- [パラメーター] タブを選択し、[+ 新規] ボタンをクリックして、新しいパラメーターを定義します。
- パラメーターの名前と説明を入力し、ドロップダウン メニューからそのデータ型を選択します。 データ型として、String、Int、Float、Bool、Array、Object、または SecureString を指定できます。
- 必要に応じて、パラメーターに既定値を割り当てることもできます。
パイプライン パラメーターを定義した後、パイプライン アクティビティの @pipeline().parameters.<parameter name> 式を使用して、パイプラインの実行中にその値にアクセスできます。 たとえば、String 型の account_name というパラメーターを定義した場合、@pipeline().parameters.account_name という式を使用して、アクティビティのその値にアクセスできます。
各パイプラインの実行前に、右パネルでパラメーターに新しい値を割り当てることができます。割り当てない場合、パイプラインでは、既定値または前に定義した値が使用されます。
パイプライン変数
パイプライン変数は、パイプラインの実行中に設定および変更できる値です。 パイプライン レベルで定義され、パイプラインの実行中には変更できないパイプライン パラメーターとは異なり、パイプライン変数は、変数の設定アクティビティを使用してパイプライン内で設定および変更できます。
パイプライン変数を使用すると、計算の結果やプロセスの現在の状態を保存するなどして、パイプラインの実行中にデータを保存および操作できます。
注意
現在、変数のスコープはパイプライン レベルです。 つまり、これらはスレッド セーフではなく、foreach ループなどの並列反復アクティビティ内からアクセスされた場合 (特に、その foreach アクティビティ内で値も変更される場合)、予想外の望ましくない動作を引き起こす可能性があります。
パイプライン変数を定義するには、次の手順に従います。
パイプラインをクリックして、その構成タブを表示します。
[変数] タブを選択し、[+ 新規] ボタンをクリックして新しい変数を定義します。
変数の名前と説明を入力し、ドロップダウン メニューからそのデータ型を選択します。 データ型として、String、Bool、または Array を指定できます。
必要に応じて、変数に既定値を割り当てることもできます。 この値は、パイプラインの実行開始時に変数の初期値として使用されます。
パイプライン変数を定義した後、パイプライン アクティビティの @variables('<variable name>') 式を使用して、パイプラインの実行中にその値にアクセスできます。 たとえば、Array 型の flag という変数を定義した場合、@variables('flag') という式を使用してアクティビティのその値にアクセスできます。 "変数の設定" アクティビティを使用して、パイプライン内の変数の値を変更することもできます。
関連するコンテンツ
アクティビティを使用してパイプラインを作成する詳しい手順については、次のチュートリアルを参照してください。
Azure Data Factory を使用して CI/CD (継続的インテグレーションとデリバリー) を実現する方法