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

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

パラメーターを使用すると、クエリの値に応じてクエリの出力を動的に変更できる柔軟性が得られ、次の目的で使用できます。

  • 特定の変換とデータソース関数の引数値の変更
  • カスタム関数の入力

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

パラメーターウィンドウを管理します。

パラメーターの作成

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

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

    をパラメーターに変換します。

    注意

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

    クエリに変換します。

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

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

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

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

パラメーターは、Power Query の変換に使用できる値を格納します。 パラメーターの名前と格納する値とは別に、メタデータを提供する他のプロパティもあります。 パラメーターのプロパティは次のとおりです。

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

  • 説明 —パラメーター情報が表示されると、パラメーター名の横に説明が表示されます。これにより、パラメーター値を指定しているユーザーがその目的とセマンティクスを理解するのに役立ちます。

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

  • —パラメーターのデータ型を常に設定することをお勧めします。 データ型の重要性の詳細については、「 データ型 」を参照してください。

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

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

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

      パラメーターを使用して、値の候補リストを指定します。

      注意

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

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

      リストクエリを含むパラメーター。

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

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

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

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

次のセクションでは、この2つのシナリオの例について説明します。

ステップ引数

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

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

注意

この機能は、現在 Power Query オンラインでは使用できません。

たとえば、 OrderID単位、および Margin というフィールドを使用して、次の Orders クエリを確認できます。

Margin のある注文のサンプルテーブルです。

次の図に示すように、 10 進数 の型と 現在の値 0.2 を使用して、name Minimum Margin を持つ新しいパラメーターを作成できます。

サンプルパラメーター。

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

余白フィールドのフィルターオプションの大なり。

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

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

[ OK] を選択すると、パラメーターの 現在の値 を使用してテーブルがフィルター処理されたことを確認できます。

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

最小の margin パラメーターの 現在の値 を0.3 に変更すると、orders クエリがどのように更新されるかをすぐに確認でき、余白 が30% を超える行だけが表示されます。

パラメーターの現在の値を更新しました。

ヒント

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

カスタム関数の引数

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

関数を作成します。

この新しい関数には、必要に応じて名前を付けることができます。 デモンストレーションを目的として、この新しい関数の名前は MyFunction になります。 [ OK] を選択すると、新しい関数の名前を使用して新しいグループが [ クエリ ] ペインに作成されます。 このグループでは、関数に使用されているパラメーター、関数の作成に使用されたクエリ、および関数自体が見つかります。

関数が作成されました。

この新しい関数をテストするには、[ 最小余白 ] ラベルの下にあるフィールドに0.4 のような値を入力します。 次に、[ 起動 ] をクリックします。 これにより、呼び出された name 関数 を使用して新しいクエリが作成され、関数の引数として使用される値0.4 と、余白が40% を超える行だけが渡されます。

値が0.4 の関数が呼び出されました。

カスタム関数の作成方法の詳細については、「 カスタム関数を作成する」を参照してください。