Azure Data Factory のグローバルパラメーターを Fabric Data Factory の変数ライブラリに変換する

Fabricはワークスペース内の変数ライブラリを用いて、パイプラインや他のデータファクトリー、Fabric項目間で定数を定義します。 Azure Data FactoryのグローバルパラメータをFabricの変数ライブラリに手動で移行できます。

このガイドでは、プロセスについて説明します。

  • Azure Data Factory のグローバル パラメーターをエクスポートする
  • Fabricでワークスペース変数を作成する
  • パイプライン式を更新する
  • 動作を検証する

Fabric変数ライブラリについて

Fabricの変数ライブラリはワークスペースレベルの値を保存し、パイプラインやアクティビティ間で参照できます。 文字列、数値、ブール値などの型に加えて、シークレットのセキュリティで保護された値がサポートされています。 デプロイ パイプラインを使用して、変数ライブラリをバージョン管理し、複数の環境にデプロイできます。

Azure Data Factoryのグローバルパラメータとは異なり、Fabric変数はより厳格なセキュリティ、より容易な再利用、そしてより良いガバナンス制御を提供します。 すべてのFabric項目に適用できます。 詳細については、「 変数ライブラリの概要」を参照してください。

Azure Data Factory のグローバル パラメーターを Fabric の変数ライブラリに移行する

  1. Azure Data Factoryのグローバルパラメータをエクスポートしてください。

    1. Azure Data Factory Studio で、Manage>Global Parameters に移動します。 各パラメーターの名前、型、値を記録します。
    2. 大規模な移行の場合は、 Manage>ARM テンプレート に移動し、ARM テンプレートをエクスポートしてプログラムでパラメーターを抽出します。 これらのファイルは、 ファクトリ フォルダーの下のテンプレート フォルダーの末尾にあるファイル内にあります。 ParametersForFactory

  2. 使用可能な型を比較します。

    Azure Data Factoryのグローバルパラメータ型(文字列、整数、ブールなど)を確認し、Fabricの変数ライブラリ型と比較してください。 移行中に調整が必要になる可能性がある種類の違いをメモしておきます。

  3. Fabric.

    1. Fabric ワークスペースで、+ 新しい項目を選択し、Variable ライブラリを検索して選択します。
    2. ライブラリ (GlobalParams など) を作成します。
    3. 新しい変数ライブラリを開き、+New variableを選択し、各Azure Data Factoryのグローバルパラメータを変数として選びます。

    変数ライブラリの作成の詳細については、「変数ライブラリ の概要」を参照してください。

  4. 移行されたパイプライン式を更新します。

    @globalParameters('ParamName')などのグローバル パラメーター参照を、@pipeline.libraryVariables.ParamNameなどの変数ライブラリ参照に更新します。

    すべてのアクティビティ式、接続文字列、スクリプト引数、フィルター ロジック、データセット プロパティを更新します。 詳細については、「 変数ライブラリとデータ パイプラインの統合」を参照してください。

  5. パイプラインの動作を検証します。

    検証とテストの実行を実行して、パイプラインで変数が正しく解決されたことを確認します。 接続、パラメーター バインド、および安全な変数の使用が期待どおりに動作することを確認します。

一般的な移行パターン

グローバル パラメーターを変数ライブラリに変換するときに使用できる移行パターンを次に示します。

  • 直接マッピング — Simple Azure Data Factoryパラメータ(リージョン名やテナント名)を変数ライブラリエントリに1対1でマッピングします。

  • 環境固有のライブラリ — 1 つのライブラリではなく、複数のライブラリ (Global-Dev、Global-Test、Global-Prod) を作成します。 デプロイ パイプラインでは、環境に基づいて適切なライブラリをバインドできます。

  • ハイブリッド モデル - 変数ライブラリに共有定数を保持しますが、パイプライン パラメーターを使用して実行固有の情報を渡します。

現在の制限

現時点では、注意すべきいくつかの制限があります。

  • 組み込みのアップグレード体験もPowerShellアップグレードツールも、グローバルパラメータを自動的にアップグレードするわけではありません。
  • @globalParameters()を参照するリンクされたサービスまたはパイプライン内の式は、自動的に書き換えられません。
  • Fabric接続 (Azure Data Factoryにリンクされたサービスの代替) では、パラメーター式は同様の方法でサポートされていません。 接続定義で使用される動的パラメーターを手動で再作成する必要があります。

ベスト プラクティス

次のヒントに留意してください。

  • 移行前に名前付け規則を調整します。
  • ワークスペース レベルの変数のオーバーロードは避けてください。 代わりに、実行時の値にパイプライン パラメーターを使用します。
  • デプロイ パイプラインを使用して、環境固有の変数ライブラリを管理します。
  • チーム メンバーがどのパイプラインがどの変数に依存するかを把握できるように、変数ライブラリを文書化します。

関連コンテンツ

  • 最終更新: