Data Factory のグローバル パラメーター

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

グローバル パラメーターは、データ ファクトリ全体での定数で、任意の式のパイプラインで使用できます。 これらは、パラメーター名と値が同一のパイプラインが複数ある場合に便利です。 継続的インテグレーションとデプロイ プロセス (CI/CD) を使用してデータ ファクトリを昇格させる場合は、各環境のこれらのパラメーターを上書きできます。

グローバル パラメーターの作成

グローバル パラメーターを作成するには、 [管理] セクションの [グローバル パラメーター] タブに移動します。 [新規] を選択して作成サイド ナビゲーションを開きます。

Screenshot that highlights the New button you select to create global parameters.

サイド ナビゲーションで、名前を入力し、データ型を選択して、パラメーターの値を指定します。

Screenshot that shows where you add the name, data type, and value for the new global parameter.

グローバル パラメーターが作成されたら、パラメーターの名前をクリックすると編集できます。 複数のパラメーターを一度に変更するには、 [すべて編集] を選択します。

Create global parameters

パイプラインでのグローバル パラメーターの使用

グローバル パラメーターは、任意のパイプライン式で使用できます。 パイプラインが、データセットやデータ フローなどの別のリソースを参照している場合は、そのリソースのパラメーターを介してグローバル パラメーター値を渡すことができます。 グローバル パラメーターは pipeline().globalParameters.<parameterName> として参照されます。

Using global parameters

CI/CD でのグローバル パラメーター

CI/CD 中に ARM テンプレートにグローバル パラメーターを含めることをお勧めします。 次に示すように、ARM テンプレートにグローバル パラメーターを含める新しいメカニズム ([管理ハブ] -> [ARM テンプレート] -> [ARM テンプレートにグローバル パラメーターを含める]) は、以前に行ったファクトリ レベルの設定と競合/オーバーライドしないため、CI/CD 中にグローバル パラメーターをデプロイするための追加の PowerShell は必要ありません。

Screenshot of 'Include in ARM template'.

Note

グローバル パラメーターを含める UI エクスペリエンスを、管理ハブの「グローバル パラメーター」セクションから「ARM テンプレート」セクションに移動しました。 以前のメカニズムを既に使用している場合 ([管理ハブ] -> [グローバル パラメーター] -> [ARM テンプレートに含める])、操作を続行できます。 引き続きサポートされます。

継続的インテグレーションとデプロイ ソリューションにグローバル パラメーターを統合する以前のフローを使用している場合は、次のように引き続き機能します。

  • ARM テンプレートにグローバル パラメーターを含める ([管理ハブ] -> [グローバル パラメーター] -> [ARM テンプレートに含める]) Screenshot of deprecated 'Include in ARM template'.

  • PowerShell スクリプトを使用してグローバル パラメーターをデプロイする

グローバル パラメーターを使用する CICD の管理がはるかに簡単になるため、ARM テンプレートにグローバル パラメーターを含める新しいメカニズム ([管理ハブ] -> [ARM テンプレート] -> [ARM テンプレートにグローバル パラメーターを含める]) を使用することを強くお勧めします。

注意

[ARM テンプレートにグローバル パラメーターを含める] 構成は、"Git モード" でのみ使用できます。 現在のところ、"ライブ モード" や "Data Factory" モードでは無効になります。

警告

パラメーター名に '-' を使用することはできません。 エラーコード "{"code":"BadRequest","message":"ErrorCode=InvalidTemplate,ErrorMessage=The expression >'pipeline().globalParameters.myparam-dbtest-url' is not valid: .....}" が表示されます。 ただし、パラメーター名に ‘_’ を使用することはできます。

関連するコンテンツ