Note
データ宛先の動的式エディタは現在プレビュー中です。
動的式エディタは、テキストとデータフロー実行時に解決する値を組み合わせることで、サポートされるデータ宛先フィールドの値を構築するのに役立ちます。 例えば、ファイル名にUTCの更新日を含める、テーブル名にパラメータを使ったり、ワークスペース固有の値を含めることができます。
エディターはデフォルトで有効です。 初めて使うときは、指導用のコールアウトで動的価値メニューの開き方が説明されます。
使用可能な値
エディタで利用可能な値は、データフローやワークスペースの設定によって異なります。
| Category | Description |
|---|---|
| 動的値 | データフローの実行に関する UTC の日付と時刻の値。
日付 は yyyyMMdd、 時間 は HHmmss、 日付/時間 は yyyyMMddHHmmssを使います。 例えば、日付/時刻の値は2020年12月30日23:24:59 UTCに「 20201230232459 」に解決されることがあります。 |
| パラメーター | データフローで定義するパラメータです。 メニューで パラメータ管理 を選択し、パラメータを作成または編集してください。 |
| ワークスペース変数 |
currentWorkspaceIdなどの組み込みワークスペース値や、データフロー Fabric利用可能な変数ライブラリ項目の値。 |
動的テーブルやファイル名を作成
Power Queryエディターでクエリにデータ宛先を追加します。
カーソルをテーブル 名 や ファイル名などの動的表現をサポートする宛先フィールドに置きます。
データフローを実行するたびに同じであるべきテキストを入力してください。
/を押して動的価値メニューを開きます。動的な数値、パラメータ、またはワークスペース変数を選択します。
/後に入力を始めるとメニューを絞り込むこともできます。式が完成するまでテキストと値を入力し続けます。 ファイルの宛先には、拡張子をテキストとして含めてください。
データ宛先の設定を終え、その後データフローを公開します。
実行時にDataflow Gen2は各トークンを解決し、その値と式内のテキストを組み合わせます。 通常の宛先の動作は、結果として得られる名前に適用されます。 例えば、解決されたファイル名が既存のファイル名と一致すると、ファイル宛先がファイルを上書きすることができます。
式を編集する
テキストを編集したり、式内のどこにでも追加値を挿入したりできます。
- マウスを使わずにメニューを開くには、
/を押してください。 矢印キーでメニューを移動し、 Enter キーを押して選択した値を挿入します。 - 値を選ばずにメニューを閉じるには、 Escキーを押してください。
/とその後に入力したテキストはテキストとしてフィールドに残ります。 - 挿入された値を取り除くには、カーソルをそのトークンの隣に置き、 バックスペース または 削除ボタンを押してください。
数式の例
| Scenario | Expression |
|---|---|
| ファイル名に実行日と時間を付け加えてください | Orders-<Date>-<Time>.csv |
| データフローパラメータをテーブル名プレフィックスとして使います | <Environment>_Sales |
| 現在のワークスペースを名前に含めてください | Sales_<currentWorkspaceId> |
エディターでは、これらの例の角括弧で示された値はトークンとして表示されます。 角括弧をタイプするわけではありません。
Important
解決されたテーブルまたはファイル名は、選択された宛先の命名ルールに従う必要があります。 動的値を含んでサポートされていない文字を導入したり、無効な名前を作成した場合、宛先検証やデータフロー実行が失敗する可能性があります。
動的表現エディターのオンをオフにしてください
動的表現エディタはデフォルトで有効です。 あなたの設定はブラウザクッキーに保存されており、Fabricサービスには保存されません。 そのため、この設定はブラウザやデバイス間で適用されず、ブラウザのクッキーをクリアするとデフォルトに戻ることがあります。 それを変更するには:
- Power Queryエディターでホームタブからオプションを選択してください。
- オプションダイアログでGlobal>Generalを選択します。
- データの宛先セクションへスクロールしてください。
- エディターで「動的表現エディタを有効にする」をクリアしてエディターをオフにします。 チェックボックスを選択して再びオンにしてください。
- [OK] を選択.
エディターをオフにしても、すでに設定されている動的表現は削除されません。
考慮事項と制限事項
- 利用可能性は、選択したデータ宛先とフィールドによって異なります。
- エディタはテキストと利用可能な値を組み合わせます。 汎用的な Power Query M 式エディターではありません。
- データフローが実行される際に参照されたパラメータまたはワークスペース変数が利用可能でなければなりません。
- パラメータ、ワークスペース変数、日付、または時間の価値を変更すると、解決された宛先名が実行間で変化することがあります。
- このエディタでサポートされていないデスティネーション設定をパラメータ化するには、 データデスティネーションクエリについては「Advanced edit」をご覧ください。