次の方法で共有

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

  • [アーティクル]

適用対象: Azure Data Factory Azure Synapse Analytics

ヒント

企業向けのオールインワン分析ソリューション、Microsoft Fabric の Data Factory をお試しください。 Microsoft 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' is not valid: .....}" が表示されます。 ただし、パラメーター名に ‘_’ を使用することはできます。

関連するコンテンツ