パラメーターを使用します。

パラメーターは、再利用できる値を簡単に格納および管理する手段として機能します。

パラメーターを使用すると、その値に応じて柔軟にクエリの出力を動的に変更できるようになり、次の目的に使用できます。

  • 特定の変換やデータ ソース関数に対する引数値の変更
  • カスタム関数の入力

パラメーターは、 [パラメーターの管理] ウィンドウで簡単に管理できます。 [パラメーターの管理] ウィンドウを表示するには、 [ホーム] タブの [パラメーターの管理][パラメーターの管理] オプションを選びます。

[パラメーターの管理] ウィンドウ。

パラメーターの作成

Power Query には、パラメーターを作成する 2 つの簡単な方法が用意されています。

  • 既存のクエリから — 値が日付、テキスト、数値などの単純な非構造化定数であるクエリを右クリックし、 [パラメーターへ変換する] を選びます。

    パラメーターへ変換する。

    注意

    次の図に示すように、パラメーターを右クリックして [クエリへ変換する] を選ぶことで、パラメーターをクエリに変換することもできます。

    クエリへ変換する。

  • [パラメーターの管理] ウィンドウの使用[ホーム] タブの [パラメーターの管理] のドロップダウン メニューから [新しいパラメーター] オプションを選ぶか、 [パラメーターの管理] ウィンドウを起動して上部の [新規] ボタンを選んで、パラメーターを作成できます。 このフォームに入力して [OK] を選ぶと、新しいパラメーターが作成されます。

    [パラメーターの管理] ウィンドウからパラメーターを作成します。

パラメーターを作成した後は、いつでも [パラメーターの管理] ウィンドウに戻り、どのパラメーターでも変更できます。

パラメーターのプロパティ

パラメーターには、Power Query での変換に使用できる値が格納されます。 パラメーターの名前およびパラメーターに格納されている値以外に、メタデータを提供する他のプロパティもあります。 パラメーターのプロパティは次のとおりです。

  • [名前] — 簡単に認識し、作成する他のパラメーターから区別できる、このパラメーターの名前を指定します。

  • [説明] — 説明は、パラメーター情報が表示されるときにパラメーター名の横に表示され、パラメーターの値を指定するユーザーがその目的とセマンティクスを理解しやすくします。

  • [必須] — このチェック ボックスは、パラメーターの値を指定する必要があるかどうかを、後のユーザーが指定できるかどうかを示します。

  • [型] — パラメーターのデータ型は常に設定することをお勧めします。 データ型の重要性とについて詳しくは、データ型に関する記事をご覧ください。

  • [提案された値] — 使用可能なオプションから [現在の値] の値を選ぶための提案をユーザーに提供します。

    • [任意の値] — 手動で入力した任意の値を現在の値に指定できます。

    • [値の一覧] — 後で [現在の値] として選択できる提案値の一覧を定義するための、簡単なテーブル状のエクスペリエンスを提供します。 このオプションを選ぶと、 [既定値] という新しいオプションを使用できるようになります。 ここから、このパラメーターの既定値を選べます。これは、パラメーターを参照するときにユーザーに表示される既定値になります。 この値は、パラメーター内に格納され、変換で引数として渡すことができる値である、 [現在の値] と同じではありません。 [値の一覧] を使用すると、 [既定値][現在の値] のフィールドにドロップダウン メニューを表示でき、ユーザーは提案された値の一覧から 1 つの値を選ぶことができます。

      パラメーターと提案される値の一覧。

      注意

      その場合でも、パラメーターに渡す任意の値を手動で入力できます。 提案される値の一覧は、単純な提案としてのみ機能します。

    • [クエリ] — リスト クエリ (出力がリストであるクエリ) を使用して、後で [現在の値] に対して選択できる提案される値の一覧を提供します。

      パラメーターとリスト クエリ。

  • [現在の値] — このパラメーターに格納される値。

パラメーターを使用する場所

パラメーターはさまざまな方法で使用できますが、一般的なのは次の 2 つのシナリオです。

  • ステップ引数 — パラメーターは、ユーザー インターフェイス (UI) からの複数の変換の引数として使用できます。
  • カスタム関数の引数 — クエリから新しい関数を作成し、カスタム関数の引数としてパラメーターを参照できます。

次のセクションでは、これら 2 つのシナリオの例を示します。

ステップ引数

この機能を有効にするには、最初に Power Query エディターの [表示] タブに移動し、 [パラメーター] グループの [常に許可] オプションを有効にします。

常にパラメーターを許可します。

注意

現在、この機能は Power Query Online では使用できません。

例として、OrderIDUnitsMargin のフィールドを持つ次の Orders クエリをご覧ください。

マージンを含む注文のサンプル テーブル。

次の図に示すように、名前が Minimum Margin、型が [10 進数][現在の値] が 0.2 の新しいパラメーターを作成できます。

サンプル パラメーター。

Orders クエリに移動し、Margin フィールドで [より大きい] フィルター オプションを選択します。

Margin フィールドの [より大きい] フィルター オプション。

[行のフィルター] ウィンドウに、選ばれたフィールドのデータ型に関するボタンが表示されます。 このボタンのドロップダウン メニューから [パラメーター] オプションを選ぶことができます。 データ型ボタンの横にあるフィールドの選択から、この引数に渡すパラメーターを選ぶことができます。 この例では、Minimum Margin パラメーターです。

変換引数のパラメーターを選びます。

[OK] を選ぶと、パラメーターの [現在の値] を使用してテーブルがフィルター処理されることがわかります。

変換引数として使用されるサンプル パラメーター。

Minimum Margin パラメーターの [現在の値] を 0.3 に変更すると、Orders クエリが更新され、Margin が 30% を超える行だけが表示されることをすぐに確認できます。

パラメーターの更新された現在の値。

ヒント

Power Query の複数の変換でこのエクスペリエンスが提供されており、ドロップダウンからパラメーターを選べます。 そのため、常にそれを探し、提供できるパラメーターを利用することをお勧めします。

カスタム関数の引数

Power Query では、簡単なクリックで既存のクエリからカスタム関数を作成できます。 前の例に続いて、Orders クエリを右クリックして [関数の作成] を選ぶと、新しい [関数の作成] ウィンドウが開きます。 このウィンドウでは、新しい関数の名前を指定でき、クエリで参照されているパラメーターが示されます。 これらのパラメーターは、カスタム関数のパラメーターとして使用されます。

関数を作成します。

この新しい関数には、必要に合った名前を付けることができます。 デモンストレーションのため、この新しい関数の名前を MyFunction にします。 [OK] を選ぶと、新しい関数の名前を使用して [クエリ] ウィンドウに新しいグループが作成されます。 このグループには、関数に使用されているパラメーター、関数の作成に使用されたクエリ、および関数自体が含まれます。

作成された関数。

Minimum Margin というラベルの下のフィールドに 0.4 などの値を入力して、この新しい関数をテストできます。 次に、 [起動] ボタンを選びます。 これにより、Invoked Function という名前の新しいクエリが作成され、関数の引数として使用される値 0.4 が渡されて、マージンが 40% を超える行だけが表示されます。

値 0.4 で呼び出された関数。

カスタム関数の作成方法について詳しくは、カスタム関数の作成に関するページをご覧ください。