Dataflow Gen2のデータ宛先には動的式エディタを使います(プレビュー)

Note

データ宛先の動的式エディタは現在プレビュー中です。

動的式エディタは、テキストとデータフロー実行時に解決する値を組み合わせることで、サポートされるデータ宛先フィールドの値を構築するのに役立ちます。 例えば、ファイル名にUTCの更新日を含める、テーブル名にパラメータを使ったり、ワークスペース固有の値を含めることができます。

エディターはデフォルトで有効です。 初めて使うときは、指導用のコールアウトで動的価値メニューの開き方が説明されます。

使用可能な値

エディタで利用可能な値は、データフローやワークスペースの設定によって異なります。

Category Description
動的値 データフローの実行に関する UTC の日付と時刻の値。 日付yyyyMMdd時間HHmmss日付/時間yyyyMMddHHmmssを使います。 例えば、日付/時刻の値は2020年12月30日23:24:59 UTCに「 20201230232459 」に解決されることがあります。
パラメーター データフローで定義するパラメータです。 メニューで パラメータ管理 を選択し、パラメータを作成または編集してください。
ワークスペース変数 currentWorkspaceIdなどの組み込みワークスペース値や、データフロー Fabric利用可能な変数ライブラリ項目の値。

動的テーブルやファイル名を作成

  1. Power Queryエディターでクエリにデータ宛先を追加します。

  2. カーソルをテーブル ファイル名などの動的表現をサポートする宛先フィールドに置きます。

  3. データフローを実行するたびに同じであるべきテキストを入力してください。

  4. /を押して動的価値メニューを開きます。

    ファイル名フィールドで動的価値メニューが開いているスクリーンショットです。メニューには日付、時刻、日付/時刻、パラメータ、ワークスペース変数が含まれています。

  5. 動的な数値、パラメータ、またはワークスペース変数を選択します。 /後に入力を始めるとメニューを絞り込むこともできます。

  6. 式が完成するまでテキストと値を入力し続けます。 ファイルの宛先には、拡張子をテキストとして含めてください。

    テキストとDate、Time、Date/Timeトークンを組み合わせた動的ファイル名のスクリーンショットです。

  7. データ宛先の設定を終え、その後データフローを公開します。

実行時にDataflow Gen2は各トークンを解決し、その値と式内のテキストを組み合わせます。 通常の宛先の動作は、結果として得られる名前に適用されます。 例えば、解決されたファイル名が既存のファイル名と一致すると、ファイル宛先がファイルを上書きすることができます。

式を編集する

テキストを編集したり、式内のどこにでも追加値を挿入したりできます。

  • マウスを使わずにメニューを開くには、 /を押してください。 矢印キーでメニューを移動し、 Enter キーを押して選択した値を挿入します。
  • 値を選ばずにメニューを閉じるには、 Escキーを押してください。 / とその後に入力したテキストはテキストとしてフィールドに残ります。
  • 挿入された値を取り除くには、カーソルをそのトークンの隣に置き、 バックスペース または 削除ボタンを押してください。

数式の例

Scenario Expression
ファイル名に実行日と時間を付け加えてください Orders-<Date>-<Time>.csv
データフローパラメータをテーブル名プレフィックスとして使います <Environment>_Sales
現在のワークスペースを名前に含めてください Sales_<currentWorkspaceId>

エディターでは、これらの例の角括弧で示された値はトークンとして表示されます。 角括弧をタイプするわけではありません。

Important

解決されたテーブルまたはファイル名は、選択された宛先の命名ルールに従う必要があります。 動的値を含んでサポートされていない文字を導入したり、無効な名前を作成した場合、宛先検証やデータフロー実行が失敗する可能性があります。

動的表現エディターのオンをオフにしてください

動的表現エディタはデフォルトで有効です。 あなたの設定はブラウザクッキーに保存されており、Fabricサービスには保存されません。 そのため、この設定はブラウザやデバイス間で適用されず、ブラウザのクッキーをクリアするとデフォルトに戻ることがあります。 それを変更するには:

  1. Power Queryエディターでホームタブからオプションを選択してください。
  2. オプションダイアログでGlobal>Generalを選択します。
  3. データの宛先セクションへスクロールしてください。
  4. エディターで「動的表現エディタを有効にする」をクリアしてエディターをオフにします。 チェックボックスを選択して再びオンにしてください。
  5. [OK] を選択.

データ宛先の「動的表現エディタを有効にする」設定を選択してオプションダイアログのスクリーンショットです。

エディターをオフにしても、すでに設定されている動的表現は削除されません。

考慮事項と制限事項

  • 利用可能性は、選択したデータ宛先とフィールドによって異なります。
  • エディタはテキストと利用可能な値を組み合わせます。 汎用的な Power Query M 式エディターではありません。
  • データフローが実行される際に参照されたパラメータまたはワークスペース変数が利用可能でなければなりません。
  • パラメータ、ワークスペース変数、日付、または時間の価値を変更すると、解決された宛先名が実行間で変化することがあります。
  • このエディタでサポートされていないデスティネーション設定をパラメータ化するには、 データデスティネーションクエリについては「Advanced edit」をご覧ください。