練習:建立儀表板參數

已完成

在本單元中,您將建立參數來篩選儀表板視覺效果。

建立參數

首先,您必須從檢視模式切換到編輯模式。

  1. 選取 [檢視],並將模式切換為 [編輯]。

    Screenshot of switching to editing mode.

  2. 在頂端功能表列上,選取 [[@] 參數]。 會開啟 [參數] 窗格。

  3. 選取 [+ 新增參數]

  4. [新增參數] 窗格中填寫參數選項,如下所示:

    Screenshot of parameter options.

    欄位 描述 建議的值
    標籤 儀表板或編輯卡上所顯示參數的名稱。 州/省
    參數類型 單一選取:在篩選條件中只能選取一個值作為參數的輸入。
    多重選取:在篩選條件中可以選取一個或多個值作為參數的輸入。
    時間範圍:根據時間篩選查詢和儀表板。
    任意文字:使用者可以輸入一值,或複製一值並貼入文字欄位中。
    多重選取
    變數名稱 要在查詢中使用的參數名稱。 _state
    資料類型 參數值的資料類型。 string
    在頁面上顯示 選取會顯示此參數的頁面。 全選
    來源 固定值:手動引進的靜態篩選值。
    查詢:使用 KQL 查詢動態引進的值。
    查詢
    資料來源 查詢式參數的來源。 請參閱 [編輯查詢]

編輯參數來源查詢

您必須建立此參數的可能值清單。 您要建立的參數稱為 [州]。 您想要用它以根據事件發生的州來篩選結果。 您可以手動輸入所有可能州的清單,不過,使用將動態傳回此清單的查詢會更簡單。

  1. 在 [資料來源] 中,選取 [樣本] 資料庫。

  2. [查詢結果] 欄位中,選取 [編輯查詢]

  3. 複製下列查詢並將其貼入查詢編輯器中:

    StormEvents
    | distinct (State)
    
  4. 選取執行。 此查詢會傳回資料行「省/市」中所有不同值的清單。

    Screenshot of editing query for parameter.

  5. 選取 [新增] 以返回 [新增參數] 對話框。

  6. 選取 [預設值] 下拉式清單,然後選取其中一個州 (例如 [明尼蘇達州])。

    Screenshot of source to add query.

  7. 選取完成

編輯這兩個磚查詢以包含參數

您已建立了一個參數,但您的儀表板看起來沒變。 您必須在產生視覺效果的查詢中使用參數。

依日期排序的事件

  1. 在 [依日期排序的事件] 磚中,選取鉛筆圖示。

    Screenshot of editing the query in the tile.

  2. 請使用參數選項中所定義的 [變數名稱] 作為查詢中的篩選條件。 在此情況下,變數名稱是 state。 編輯查詢以包含下列一行:

    | where State has_any (_state)
    

    您的查詢看起來應該如下圖所示:

    Screenshot of editing the query to add parameter.

  3. 選取 [套用變更]

依州所列的事件計數

  1. [依州所列的事件計數] 圖格中,選取鉛筆圖示。

  2. 編輯查詢以包含下列一行:

    | where State has_any (_state)
    

    您的查詢看起來應該如下圖所示:

    Screenshot of query in dashboard visual including parameter.

  3. 選取 [套用變更]

請使用參數

選取 State 參數,然後選取下拉式功能表上的其中一個選項,例如 TEXAS。 請確定並取消核取預設值,以便只選取一個州。 請注意視覺效果如何變更,只顯示與所選取省市相關聯的資料。

Animated gif showing how to use the parameter picker.