次の方法で共有

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

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

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

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

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

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

グローバルパラメーターを作成するために選択した [新規] ボタンを強調表示しているスクリーンショット。

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

新しいグローバル パラメーターの名前、データ型、値を追加する場所を示すスクリーンショット。

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

グローバル パラメーターを作成する

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

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

グローバル パラメーターの使用

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

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

[ARM テンプレートに含める] のスクリーンショット。

注意

グローバル パラメーターを含める UI エクスペリエンスを、管理ハブの「グローバル パラメーター」セクションから「ARM テンプレート」セクションに移動しました。

以前のメカニズムを既に使用している場合 ([管理ハブ] -> [グローバル パラメーター] -> [ARM テンプレートに含める])、操作を続行できます。 私たちは引き続きサポートします。

ダウンロードした ARM テンプレートの Parameters フォルダーには、ARM テンプレートで使用されるパラメーターを定義する JSON ファイルが含まれています。 各ファイルは特定のグローバル パラメーターに対応します。

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

  • ARM テンプレートにグローバル パラメーターを含める ([管理ハブ] -> [グローバル パラメーター] -> [ARM テンプレートに含める]) 非推奨の [ARM テンプレートに含める] のスクリーンショット。

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

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

注意

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

警告

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

関連するコンテンツ

  • Last updated on