Dataflow Gen2 のパラメーターを使用すると、データフローを動的に制御およびカスタマイズできるため、データフロー自体を変更せずにさまざまな入力やシナリオを有効にすることで、データフローをより柔軟かつ再利用可能にできます。 複数のデータフローの必要性を減らし、単一のパラメーター化されたデータフロー内で制御を一元化することで、物事を整理するのに役立ちます。
Dataflow Gen2 のパブリック パラメーターは、Power Query エディターの外部で Fabric REST API またはネイティブ Fabric エクスペリエンスを使用してパラメーター値を渡すことで、データフローの実行を許可できる新しいモードです。 これにより、データフローの実行方法に影響を与えるさまざまなパラメーターを使用して各実行を呼び出すことができる、より動的なデータフローエクスペリエンスを実現できます。
[前提条件]
- CI/CD をサポートするデータフロー Gen2
- パラメーターは、データフロー内で設定する必要があります。データフローでクエリ パラメーターを設定する方法の詳細について説明します。
パブリック パラメーター モードを有効にする
データフローの所有者として、データフローを開きます。 リボンの [ホーム] タブで、[ オプション] ボタンを選択します。
![Power Query エディターのリボンの [ホーム] タブにある [オプション] ボタンのスクリーンショット。](media/dataflow-parameters/options-button.png)
ボタンを選択すると、新しい [オプション] ダイアログが開きます。 垂直メニューで、データフロー グループ内のパラメーターというラベルが付いたオプションを選択します。 [パラメーター] セクションで、"パラメーターを検出して 実行をオーバーライド する" というオプションを有効にして、パブリック パラメーター モードを有効にすることができます。
![パブリック パラメーター モードを有効にする [オプション] ダイアログのスクリーンショット。](media/dataflow-parameters/enable-public-parameters-mode.png)
[ OK] ボタンを選択して、これらの変更をコミットします。
このモードを有効にすると、[ パラメーターの管理 ] ダイアログで、ダイアログの上部に "パブリック パラメーター モードが有効になっています" という通知が表示されます。
![パブリック パラメーター モードが有効になっているという通知を示す [パラメーターの管理] ダイアログのスクリーンショット。](media/dataflow-parameters/manage-parameters-dialog.png)
パブリック パラメーター モードが有効になったら、データフローを保存できます。
![リボンの [ホーム] タブ内にデータフローを保存するオプションのスクリーンショット。](media/dataflow-parameters/save-dataflow.png)
データフロー実行のカスタム パラメーター値を渡す
パブリック パラメーター モードは、必須パラメーターと必須でないパラメーターの区別があるデータフロー内のパラメーターの定義に従います。
- 必須パラメーター: パラメーターが必要に応じて設定されている場合、データフローを実行するには、値を実行ジョブに渡す必要があります。 required に設定されているパラメーターに値が渡されない場合、実行は失敗します。
- 必須ではないパラメーター: これらは 省略可能な パラメーターとも呼ばれ、実行をトリガーするために値を渡す必要はありません。 値が渡されない場合は、パラメーター内で定義されている Current 値 が実行に使用されます。
パイプライン内でデータフロー アクティビティを使用する
注
Fabric パイプラインからのデータフロー アクティビティの詳細を読んで、そのすべての機能を理解することをお勧めします。
Fabric でパイプラインを作成するときに、データフロー アクティビティを使用して、パブリック パラメーター モードが有効になっている CI/CD サポートを使用して Dataflow Gen2 の実行をトリガーできます。
使用するデータフローを選択し、[データフロー パラメーター] セクションで使用する パラメーター を設定できます。
[ データフロー パラメーター ] セクションでは、データフローで使用可能なすべてのパラメーターと、値セクション内の各パラメーターの既定値を確認できます。
必須パラメーターには名前の横にアスタリスクが付きますが、省略可能なパラメーターにはアスタリスクがありません。 同時に、オプションのパラメーターをグリッドから削除できますが、必要なパラメーターは削除できません。データフローを実行するには値を渡す必要があります。
更新ボタンを選択して、データフローに最新のパラメーター情報を要求できます。
サポートされているパラメーター タイプ
ヒント
データフローの検出パラメーター REST API を読み取って使用します。 このドキュメントでは、使用可能なすべてのパラメーター型とその予期される値を提供し、REST API はデータフローからパラメーター情報を取得する方法を提供します。
次の表は、現在サポートされているパラメーター型と、REST API が期待する値を理解するための REST API 定義へのリンクを示しています。
| データフロー パラメーターの型 | REST API 定義 |
|---|---|
| テキスト | DataflowStringParameter |
| 整数 (int64) | DataflowIntegerParameter |
| 10 進数 | DataflowNumberParameter |
| 日付 | DataflowDateParameter |
| DateTime | DataflowDateTimeParameter |
| 時間 | DataflowTimeParameter |
| 日付と時間のタイムゾーン | DataflowDateTimeZoneParameter |
| 期間 | DataflowDurationParameter |
| 真/偽 | DataflowBooleanParameter |
考慮事項と制限事項
CI/CD で Dataflow Gen2 のパブリック パラメーター モードを使用する場合の考慮事項と制限事項の一覧を次に示します。
- スケジュール設定と手動トリガー: 必要なパラメーターが設定されていない限り、パブリック パラメーターを含むデータフローを Fabric 経由でスケジュールまたは手動でトリガーすることはできません。
- サポートされていないパラメーター化: ソースまたは宛先のリソース パスを変更するパラメーターはサポートされていません。 接続は、作成されたパスに固定されます。
- 増分更新: パブリック パラメーター モードと互換性がありません。
- ロジックの変更: パブリック パラメーターを使用すると、ユーザーは値をオーバーライドでき、データフロー出力が変更される可能性があります。
- 監視ハブ: 監視ハブには、実行中に使用されたパラメーター値は表示されません。
- ステージング動作: 最新の実行のみがステージング Lakehouse に格納されます。 定義済みの宛先を使用してデータを保持します。
- 重複する要求: 同じパラメーター値が複数回送信された場合、最初の要求のみが完了するまで受け入れられます。
- スキーマ マッピング: パラメーターは、宛先スキーマ マッピングを変更できません。 すべてのマッピングは、作成された構成に従います。 Dataflow Gen2 のデータ変換先と管理設定の詳細については、記事を参照してください。