リアルタイム ダッシュボードでパラメーターを使用する

パラメーターは、Real-Time ダッシュボードのフィルターの構成要素です。 ダッシュボード レベルで管理し、それらをクエリに追加して、ビジュアルに表示されるデータをフィルター処理します。 クエリでは、1 つ以上のパラメーターを使用できます。

この記事では、ダッシュボードでパラメーター、クロスフィルター、ドリルスルーを作成して使用する方法について説明します。 ダッシュボードのビジュアルをフィルター処理するには、 フィルター バーでパラメーター値を 選択するか 、クロスフィルターを使用します。

この記事で使用するクエリの例は、サンプル ギャラリーで使用できる Weather Analytics サンプル データの StormEvents テーブルに基づいています。

注

パラメーターは、ダッシュボード エディターの 編集 モードでのみ管理できます。

前提条件

パラメーターの一覧を表示する

すべてのダッシュボード パラメーターの一覧を表示するには、[>の管理]を選択します。

パラメーターを作成する

パラメーターを作成するには：

  1. 上部メニューの [新しいパラメーター ] ボタンを選択します。 [パラメーター] ペインが開きます。
  2. 右側のウィンドウの上部にある [ + 追加] を選択します。
  3. パラメーターに関連するプロパティを入力します。
  4. [完了] を選択してパラメーターを作成します。

プロパティ

[パラメーターの追加]ペインで、以下のプロパティの構成設定をします。

フィールド 説明
ラベル ダッシュボードまたは編集カードに表示されるパラメーターの名前。
パラメーターの型 次のいずれかのパラメーター型。
- 1 つの選択: ユーザーがフィルター内の 1 つの値を選択できるようにします。
- 複数選択: ユーザーがフィルター内の 1 つ以上の値を選択できるようにします。
- 時間範囲: クエリとダッシュボードをフィルター処理するための時間ベースのパラメーターを追加します。 すべてのダッシュボードには、既定で時間範囲ピッカーが含まれています。
- フリー テキスト: ユーザーがフィルターに値を入力または貼り付けることができます。 フィルターは、最近使用した値を保持します。
- データ ソース: ユーザーが 1 つ以上のダッシュボード データ ソースを選択できるようにします。
説明 パラメーターの説明 (省略可能)。
[変数名] クエリで使用するパラメーター名。
データの種類 パラメーター値のデータ型。
[Show on pages](ページに表示) このパラメーターが表示されるページ。 [すべて選択] を選択 すると、すべてのページにパラメーターが表示されます。
ソース パラメーター値のソース。
- 固定値: 手動で入力された静的フィルター値。
- クエリ: KQL クエリによって返される値。
[すべて選択]の値を追加 単一選択および複数選択のパラメーター型にのみ適用されます。 すべてのパラメーター値のデータを取得するには、このオプションを使用します。 このオプションのサポートをクエリに組み込む。 例については、「 複数選択クエリ ベースのパラメーターを使用する」を参照してください。
既定値 ダッシュボードが最初にレンダリングされるときにフィルターで使用される値。

パラメーターの管理

上部のバーで [パラメーター] を選択すると、既存のパラメーターの一覧を表示できます。 各パラメーター カードで、編集アイコンを選択してパラメーターを変更するか、[ ...] を選択して複製、削除、または移動します。

パラメーター カードでは、次のインジケーターを表示できます。

  • パラメーターの表示名。
  • 変数名。
  • パラメーターを使用するクエリの数。
  • パラメーターが表示されるページ。

パラメーター カードの順序を変更するには、ドラッグ アンド ドロップするか、[>に移動] を使用します。

サンプル パラメーター カードのスクリーンショット。

クエリでパラメーターを使用する

フィルターがそのビジュアルに影響を与える前に、クエリでパラメーターを使用する必要があります。 パラメーターを定義すると、[クエリ] ページと クエリ IntelliSense のフィルター バーにパラメーターが表示されます。

注

クエリでパラメーターが使用されていない場合、フィルターは非アクティブなままになります。 クエリにパラメーターを追加すると、フィルターがアクティブになります。

パラメーターの種類

ダッシュボードでは、次のパラメーター型がサポートされています。

次の例では、さまざまなパラメーターの種類に対してクエリでパラメーターを使用する方法について説明します。

既定の時間の範囲パラメーター

すべてのダッシュボードには、既定で 時間範囲 パラメーターが含まれています。 フィルターとして表示されるのは、クエリで使用する場合のみです。 次の例に示すように、 _startTime キーワードと _endTime キーワードを使用して、既定の時間範囲パラメーターを適用します。

StormEvents
| where StartTime between (_startTime.._endTime)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

クエリを保存すると、時間範囲フィルターがダッシュボードに表示されます。 その後、時間範囲のプリセットを選択するか、[カスタム時間範囲] を選択して、ビジュアルをフィルター処理できます。

カスタム範囲が選択されている [時間範囲] フィルターのスクリーンショット。

単一選択の固定値パラメーター

固定値パラメーターは、指定した定義済みの値に基づいています。 次の例は、単一選択の固定値パラメーターを作成する方法を示しています。

単一選択の固定値パラメーターを作成する

  1. [ パラメーター] を選択して [ パラメーター] ウィンドウを開き、[ 新しいパラメーター] を選択します。

  2. 次の詳細情報を入力します:

    • ラベル: イベントの種類

    • パラメーターの種類: 単一選択

    • 変数名: _eventType

    • データ型: 文字列

    • ダッシュボード フィルターとして固定: 選択中

    • ソース: 固定値

      この例では、次の値を使用します。

      価値 パラメーターの表示名
      雷雨風 雷雨風
      ひょう ひょう
      鉄砲水 鉄砲水
      干ばつ 干ばつ
      冬の天気 冬の天気

    • [すべて選択]の値を追加: 未確認

    • 既定値: 雷雨風

  3. [完了] を選択してパラメーターを作成します。

パラメーターは [ パラメーター ] ウィンドウに表示されますが、まだビジュアルで使用していません。

単一選択の固定値パラメーターを使用する

  1. 変数名を使用して、新しい_eventTypeパラメーターを使用するサンプル クエリを実行します。

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType == _eventType
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    ダッシュボードの上部にあるパラメーター リストに新しいパラメーターが表示されます。

  2. さまざまな値を選択して、ビジュアルを更新します。

    状態別の上位 5 種類のイベントのスクリーンショット。

複数選択の固定値パラメーター

固定値パラメーターは、指定した定義済みの値に基づいています。 次の例は、複数選択の固定値パラメーターを作成して使用する方法を示しています。

複数選択の固定値パラメーターを作成する

  1. [ パラメーター] を選択して [ パラメーター] ウィンドウを開き、[ 新しいパラメーター] を選択します。

  2. 「 単一選択の固定値パラメーターを作成する」の説明に従って詳細を入力し、次の変更を行います。

    • ラベル: イベントの種類
    • パラメーターの種類: 複数選択
    • 変数名: _eventType

  3. [完了] を選択してパラメーターを作成します。

新しいパラメーターが [パラメーター] ウィンドウに表示されますが、まだビジュアルで使用していません。

複数選択の固定値パラメーターを使用する

  1. 新しい イベント型 パラメーターと _eventType 変数を使用するサンプル クエリを実行します。

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    ダッシュボードの上部にあるパラメーター リストに新しいパラメーターが表示されます。

  2. 1 つまたは複数の異なる値を選択して、ビジュアルを更新します。

    フィルターで複数のイベントの種類を選択するスクリーンショット。

単一選択のクエリベース パラメーター

クエリベースのパラメーター値は、パラメーターのクエリを実行することで、ダッシュボードの読み込み時に取得されます。 次の例では、単一選択のクエリベース パラメーターを作成して使用する方法を示します。

単一選択のクエリーベース パラメーターを作成する

  1. [ パラメーター] を選択して [ パラメーター] ウィンドウを開き、[ 新しいパラメーター] を選択します。

  2. 「 単一選択の固定値パラメーターを作成する」の説明に従って詳細を入力し、次の変更を行います。

    • ラベル：状態

    • 変数名: _state

    • ソース：クエリー

    • データ ソース: StormEventsSample

    • [クエリの編集] 選択し、次のクエリを入力します。 完了 を選択します。

      StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents
| project State

    • 値：状態

    • 表示名: 状態

    • 既定値: 既定値を選択する

  3. [完了] を選択してパラメーターを作成します。

単一選択のクエリベース パラメーターを使用する

  1. 新しい状態パラメーターを使用した次のサンプルクエリでは、_state 変数が使用されます。

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| where State == _state
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    ダッシュボードの上部にあるパラメーター リストに新しいパラメーターが表示されます。

  2. さまざまな値を選択して、ビジュアルを更新します。

複数選択のクエリベースのパラメーター

クエリベースのパラメーター値は、ダッシュボードの読み込み時にユーザー指定のクエリを実行した結果です。 次の例は、複数選択クエリ ベースのパラメーターを作成する方法を示しています。

複数選択のクエリベースのパラメーターを作成する

  1. [ パラメーター] を選択して [ パラメーター ] ウィンドウを開き、[ + 新しいパラメーター] を選択します。

  2. 「 単一選択クエリ ベースのパラメーターを作成する」の説明に従って、次の変更を加えた詳細を入力します。

    • ラベル：状態
    • パラメーターの種類: 複数選択
    • 変数名: _state

  3. [完了] を選択してパラメーターを作成します。

複数選択のクエリベースのパラメーターを使用する

  1. 次のサンプル クエリでは、_state 変数を使用して、新しい State パラメーターを使用します。

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| where State in (_state) or isempty(_state)
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

    注

    このサンプルでは、isempty() 関数で値が空であるかどうかを確認することで、Select All オプションを使用しています。

    ダッシュボードの上部にあるパラメーター リストに新しいパラメーターが表示されます。

  2. 1 つまたは複数の異なる値を選択して、ビジュアルを更新します。

フリーテキスト パラメーター

自由記載パラメーターには値は含まれていません。 独自の値を追加できます。

自由記載パラメーターを作成する

  1. [ パラメーター] を選択して [ パラメーター ] ウィンドウを開き、[ + 新しいパラメーター] を選択します。
  2. 以下の詳細情報を入力します。
    • ラベル：状態
    • パラメーターの種類: フリーテキスト
    • 変数名: _state
    • データ型: 文字列
    • 既定値： [既定値なし]
  3. [完了] を選択してパラメーターを作成します。

フリーテキスト パラメーターを使用する

  1. 変数名 _state を使用して、新しい State パラメーターでサンプルクエリを実行します。

    StormEvents
| where StartTime between (_startTime.._endTime)
| where EventType in (_eventType) or isempty(_eventType)
| where State contains _state
| summarize TotalEvents = count() by State
| top 5 by TotalEvents

データ ソース パラメーター

ダッシュボードに データ ソースを追加 したら、1 つ以上の使用可能なデータ ソースを選択するパラメーターを作成できます。 このパラメーターは、タイルやその他のパラメーターで使用します。

データ ソース パラメーターを作成する

  1. [ パラメーター] を選択して [ パラメーター ] ウィンドウを開き、[ + 新しいパラメーター] を選択します。

  2. 次の詳細情報を入力します:

    • ラベル：ソース
    • パラメーターの種類： データ ソース
    • ページに表示: すべて選択
    • 値：すべて選択
    • 既定値: StormEvents

    データ ソースのパラメーターのスクリーンショット。

  3. 完了 を選択します。

ダッシュボードの上部にあるパラメーター リストに、新しいパラメーターが表示されるようになりました。

データ ソース パラメーターを使用する

  1. 新規または既存のタイルのクエリに移動します。

  2. [ソース]では、[データ ソース パラメーター]のもとで新しいパラメーターの名前 (新しいソース パラメーターなど)を選択します。

    クエリでデータ ソース パラメーターを選択するスクリーンショット。

  3. [変更の適用] を選択します。

  4. ソースパラメーターを使用して、この接続されたクエリのデータ ソースを変更します。

クロスフィルター パラメーター

クロスフィルターは、あるビジュアルで値を選択し、同じダッシュボード上の他のビジュアルのデータをフィルター処理するために使用するダッシュボードの機能です。 クロスフィルターを使用すると、ダッシュボード上部のパラメーターリストのパラメーターに相当する値を選択した場合と同じ結果が得られます。

クロスフィルターの定義

クロスフィルターを作成するには、ビジュアルでオプションを有効にし、データをフィルター処理するパラメーターを指定します。

  1. クロスフィルターを追加するタイルのクエリに移動します。

  2. [ビジュアル] を選択します。

  3. 右側のペインで、[相互作用] を選択し、[クロスフィルター] をオンにします。

  4. 必要に応じて、相互作用の種類を指定します。 既定値は、ビジュアルで値を選択する ポイント です。 時間グラフなどの値の範囲を選択するには、[ドラッグ]を選択します。

  5. 値を提供する列と、ビジュアルのクエリをフィルター処理するパラメーターの両方を指定します。

    重要

    列とパラメーターのデータ型は同じである必要があります。

クロスフィルターを使用してデータを操作する

クロスフィルターを定義したら、それを使用してデータを操作します。 クロスフィルターを定義するビジュアルでは、データ ポイントを選択し、その値を使用して現在のダッシュボード ページをフィルター処理します。 テーブル ビジュアルの場合は、関連するセルを右クリックし、[ クロス フィルター] を選択します。

クロスフィルターをリセットする場合は、選択したビジュアルの上部にある [リセット ] を選択します。

リセットボタンが表示されているテーブルビジュアルのスクリーンショット。

ドリルスルーをダッシュボードのパラメーターとして使用する

ドリルスルーを使用すると、ビジュアル内の値を選択し、それを使用して同じダッシュボード内のターゲット ページ上のビジュアルをフィルター処理できます。 ターゲット ページをオープンする際に、関連するフィルターで値が事前に選択されます。 折れ線グラフや散布図などのページ上のビジュアルには、関連するデータのみが表示されます。 この機能は、概要ページから詳細ページにドリルスルーする場合に便利です。 ページの作成に関する情報については、[ページの追加]を参照してください。

ドリルスルーの定義

ドリルスルーを作成するには、ビジュアルでオプションを有効にし、データをフィルター処理する 1 つ以上のドリルスルー パラメーターを指定します。

  1. プライマリ ページで、編集モードに入ります。

  2. ドリルスルーを追加しようとしているビジュアルを編集します。 [ビジュアル] タブが選択されていることを確認します。

    編集オプションが選択されているダッシュボード ビジュアルのスクリーンショット。

  3. 右側のウィンドウで、[ 対話式操作] を選択し、ドリルスルーを有効にします。

    ドリルスルーが有効になっている [対話式操作] ペインのスクリーンショット。

  4. [ドリルスルー] の下で、[新規作成] を選択し、次の情報を指定します。 必要に応じて、[別のペアを追加] を選択し、ターゲット ページに対して複数のパラメーターを追加します。 異なるパラメーターを使用して、現在のダッシュボードの他のページにドリルスルーを追加するには、この手順を繰り返します。

    フィールド 説明
    宛先のページ 定義されたパラメーターを使用してドリルスルーする 1 つ以上のターゲット ページ。
    列 ターゲット ページ内のパラメーターの値として使用する、クエリ結果の列。
    パラメーター 列の値を使用してターゲット ページのビジュアルをフィルター処理するために使用するパラメーター。
    メモ 省略可能な簡単な説明。

    重要

    列とパラメーターのペアのデータ型が同じである必要があります。

    入力するフィールドが強調表示されているドリルスルー フォームのスクリーンショット。

ドリルスルーを使用してデータを操作する

ドリルスルーを定義したら、ドリルスルーを使用してデータを操作します。 ドリルスルーを定義するビジュアルまたはテーブル内で、データ ポイントを右クリックし、次へドリルスルー>リンク先ページを選択します。 データ ポイントの値によって、ターゲット ページ上のビジュアルがフィルター処理されます。

ドリルスルーインタラクションが表示されているダッシュボード ビジュアルのスクリーンショット。

単一選択フィルターと複数選択フィルターにフィルター検索を使用する

単一選択フィルターと複数選択フィルターで、目的の値を入力します。 フィルターが更新され、検索語句に一致する値のみが表示されます。

関連するコンテンツ

  • Last updated on