注
継続的インテグレーション/継続的配置 (CI/CD) シナリオでこの機能を活用する方法の詳細については、 Dataflow Gen2 の CI/CD および ALM ソリューション アーキテクチャに 関する記事と、 データフローの変数参照に関するエンド ツー エンドのチュートリアルを参照してください。
ファブリック変数ライブラリは、 Microsoft Fabric ワークロード全体の構成値を一元的に管理する方法を提供します。 Dataflow Gen2 の新しい統合により、これらの変数をデータフロー内で直接参照できるため、環境間での動的な動作が可能になり、CI/CD ワークフローが簡略化されます。
[前提条件]
Dataflow Gen2 で Fabric 変数ライブラリを使用するには、次のことを確認します。
Fabric 変数ライブラリを作成および管理する権限があります。
CI/CD を使用して Dataflow Gen2 を使用しています。
入力ウィジェットを使用して変数を参照する
データフロー Gen2 ダイアログには、フィールド値の入力方法を選択できる入力ウィジェットが含まれています。 サポートされているダイアログでは、このウィジェットを使用して変数を選択できます。
注
入力ウィジェットを使用するには、リボンの [ 表示 ] タブの [ パラメーター] グループで 、[ 常に許可] を選択します。
![入力ウィジェットを有効にするリボンの [表示] タブの [常に許可する] チェック ボックスのスクリーンショット。](media/dataflow-gen2-variable-library-integration/allow-parameters.png)
一部のダイアログでは、次のような入力ウィジェット エクスペリエンスと Fabric 変数ライブラリがサポートされています。
- 値で行をフィルター処理する
- 位置で行をフィルター処理する
- 値を置き換える
- テキスト列変換 (たとえば、最初の N 文字を抽出)
- 数値列変換 (例: 除算)
入力ウィジェットで変数オプションを選択すると、変数ピッカー ダイアログが表示されます。 このダイアログでは、変数ライブラリと変数に含まれる変数を参照できます。
![現在のワークスペースで使用可能なすべてのライブラリと変数を表示する [変数の選択] ダイアログのスクリーンショット。](media/dataflow-gen2-variable-library-integration/select-variable.png)
変数を選択すると、ダイアログにライブラリと変数名が表示され、コミットする前に選択内容を確認できます。
![フィルター行ダイアログで選択されているライブラリの [マイ ライブラリ] の Ceiling という名前の変数のスクリーンショット。](media/dataflow-gen2-variable-library-integration/variable-selected.png)
注
すべてのデータフロー エクスペリエンスで入力ウィジェットがサポートされているわけではありません。 サポートされていないエクスペリエンスまたはカスタム シナリオの場合は、変数関数を手動で使用します。
変数関数
Dataflow Gen2 内では、次のいずれかの関数を使用して変数を参照できます。
いずれかの関数に渡す識別子は、次の形式を使用する必要があります。
$(/**/LibraryName/VariableName)
次の例では、 My Library という名前の変数ライブラリと My Variable という名前の文字列変数を想定しています。
Variable.ValueOrDefault("$(/**/My Library/My Variable)", "Sample")
Variable.Value("$(/**/My Library/My Variable)")
Variable.ValueOrDefaultを使用して既定値を使用すると、参照先の変数ライブラリを持たない別の環境にソリューションをコピーまたは移動した場合でも、数式が確実に解決されます。
ヒント
各変数を、ステージングを必要としない個別のクエリとして格納します。 この方法では、 クエリ 入力をサポートするダイアログでこれらの値を使用でき、データフロー内の変数の整理されたビューを維持するのに役立ちます。
考慮事項と制限事項
次の一覧では、Dataflow Gen2 で Fabric 変数ライブラリを使用する場合に注意すべき重要な制約と動作の概要を示します。 これらの制限は、設計と実行時の変数の参照、評価、適用方法に影響します。
ワークスペース スコープ: 変数ライブラリは、CI/CD を使用する Dataflow Gen2 と同じワークスペースに存在する必要があります。
参照場所: 変数は、 CI/CD を使用する Dataflow Gen2 の mashup.pq ファイル内でのみ使用できます。
ランタイム動作: 変数の値は、実行操作の開始時に取得され、操作全体にわたって保持されます。 データフローの実行中にライブラリを変更しても、その実行が停止したり、影響を受けたりすることはありません。
既定値の使用: Variable.ValueOrDefault 関数で既定値を使用する場合は、既定値のデータ型が参照先の変数のデータ型と一致していることを確認します。
サポートされている型: 基本型の変数 (
boolean、datetime、guid、integer、number、string) のみがサポートされます。固定接続: 変数は接続情報を変更できません。 接続は、作成されたリソース パスの構成に固定されたままです。
オーバーライド リスク: 変数ライブラリを変更するアクセス権を持つユーザーは変数値をオーバーライドでき、データフロー出力に影響を与える可能性があります。
スキーマ マッピング: 変数は宛先スキーマ マッピングを変更できません。マッピングは、作成されたセットアップに従います。
系列の表示: 系列ビューには、Dataflow Gen2 とそれが参照する変数ライブラリ間のリンクは表示されません。