在 Azure 資料總管儀表板中使用參數

參數會作為 Azure 數據總管儀錶板中篩選條件的建置組塊。 它們是在儀表板範圍中進行管理，並且可新增至查詢，以篩選基礎視覺效果呈現的資料。 查詢可以使用一或多個參數。

本文件說明在儀錶板中建立和使用參數和連結篩選。 參數可用來篩選儀錶板視覺效果，方法是選取 篩選列中 的參數值或使用 交叉篩選。

本文中使用的查詢範例是以範例資源庫中的數據表為基礎StormEvents。

必要條件

• 使用 Azure 資料總管儀表板視覺化資料
• Azure 數據總管儀錶板上的編輯器許可權
• 具有視覺效果的儀錶板

檢視參數

若要檢視所有儀錶板參數的清單，請選取 儀錶板頂端的 [參數 ] 按鈕。

建立參數

建立參數

1. 從 [檢視] 切換至 [編輯 ] 模式。

   

2. 選取儀錶板頂端的 [ 參數 ] 按鈕。

   

3. 選取右窗格頂端的 [ + 新增參數 ] 按鈕。

4. 填入參數的相關 屬性 。

支援的屬性

在 [ 新增參數 ] 窗格中，設定下列屬性：

管理參數

從頂端列選取 [參數 ] 之後，您可以 檢視現有參數的清單。 在每個參數卡片中，選取鉛筆小工具以編輯參數，或選取 [更多 [...] ] 功能表來 複製、 刪除或移動參數。

參數卡片中可以檢視下列指標：

• 參數顯示名稱
• 變數名稱
• 使用 參數的查詢數目
• 將參數釘選到的頁面

參數卡片可以透過拖放方式排序，或使用 [移至] > 選項並選取新位置。

在查詢中使用參數

參數必須在查詢中使用，讓篩選條件適用於該查詢視覺效果。 定義之後，您可以在 [查詢] 頁面>篩選頂端列和查詢 Intellisense 中看到參數。

參數型別

支援數種儀錶板參數類型，如下所示：

• 默認時間範圍參數
• 單一選取固定值參數
• 多重選取固定值參數
• 單一選取查詢型參數
• 多重選取查詢型參數
• 自由文字參數
• 資料來源參數

下列範例說明如何在查詢中針對各種參數類型使用參數。

默認時間範圍參數

每個儀錶板預設都有時間 範圍 參數。 它只會在查詢中使用時，才會在儀錶板上顯示為篩選。 使用 參數關鍵詞 _startTime ，並使用 _endTime 查詢中的預設時間範圍參數，如下列範例所示：

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

儲存之後，時間範圍篩選會顯示在儀錶板上。 現在可用來篩選卡片上的數據。 您可以從下拉式清單中選取來篩選儀錶板： 時間範圍 （過去 x 分鐘/小時/天）或 自定義時間範圍。

單一選取固定值參數

固定值參數是以使用者指定的預先定義值為基礎。 下列範例示範如何建立單一選取範圍固定值參數。

建立單一選取固定值參數

1. 選取 [參數] 以開啟 [參數] 窗格，然後選取 [新增參數]。

2. 填入詳細資料，如下所示：

   • 標籤：事件類型

   • 參數類型：單一選取

   • 變數名稱：_eventType

   • 資料類型：字串

   • 釘選為儀錶板篩選：已核取

   • 來源：固定值

     在本節中，我們使用下列範例值：

     值	參數顯示名稱
     雷暴風	雷暴風
     冰雹	冰雹
     暴洪	暴洪
     乾旱	乾旱
     冬季天氣	冬季天氣

   • 新增 [ 全選] 值：取消核取

   • 默認值：雷暴風

3. 選取 [儲存] 以建立參數。

您可以在 [參數] 側邊窗格中看到參數，但目前未用於任何視覺效果。

使用單一選取固定值參數

1. 使用變數名稱，使用_eventType新的 Event TypTope 參數執行範例查詢：

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

   新的參數會顯示在儀錶板頂端的參數清單中。

2. 選取不同的值以更新視覺效果。

   

多重選取固定值參數

固定值參數是以使用者指定的預先定義值為基礎。 下列範例示範如何建立及使用多重選取的固定值參數。

建立多重選取的固定值參數

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. 選取 [參數] 以開啟 [參數] 窗格，然後選取 [新增參數]。

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 參數的下列範例查詢會使用 _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. 1. 填寫詳細數據，如 使用單一選取固定值參數 搭配下列變更：
   • 標籤：狀態
   • 參數類型：多重選取
   • 變數名稱：_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() 函式檢查空白值。

   新的參數會顯示在儀錶板頂端的參數清單中。

2. 選取一或多個不同的值來更新視覺效果。

自由文字參數

自由文字參數不包含任何值。 它們可讓您介紹自己的價值。

建立文字參數

1. 選取 [參數] 以開啟 [參數] 窗格，然後選取 [+ 新增參數]。

2. 填入詳細資料，如下所示：

   • 標籤：狀態
   • 參數類型：自由文字
   • 變數名稱規則：_state
   • 資料類型：字串
   • 預設值：沒有預設值

使用文字參數

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. 選取 [參數] 以開啟 [參數] 窗格，然後選取 [+ 新增參數]。

2. 填入詳細資料，如下所示：

   • 標籤：來源
   • 參數類型：數據源
   • 在頁面上顯示：Select all
   • 值：Select all
   • 默認值：StormEventsSample

3. 選取完成。

新的參數現在會顯示在儀錶板頂端的參數清單中。

使用資料來源參數

1. 流覽至新磚或現有磚的查詢。

2. 在 [來源] 中，選取 [數據源參數] 底下新參數的名稱。 針對上述建立的參數，選取 [ 叢集]。

3. 選取 [套用變更]。

4. 使用 Cluster 參數來變更此連線查詢的數據源。

交叉篩選參數

交叉篩選可讓您選取一個視覺效果中的值，而所有儀錶板視覺效果，例如折線圖或散佈圖，都會篩選成只顯示相關數據。 使用交叉篩選可達到相同的結果，就像在儀錶板頂端的參數清單中選取參數的對等值一樣。

定義交叉篩選

若要建立交叉篩選，您必須開啟視覺效果中的 選項，然後指定用來篩選數據的參數。

1. 流覽至您要在其中新增交叉篩選的磚查詢。

2. 選取視覺效果。

3. 在右窗格中，選取 [互動]，然後開啟交叉篩選。

4. 選擇性地指定 Interaction 類型。 默認值為 Point，您可以在視覺效果中選取值。 若要選取某個範圍的值，例如在時程圖表中，請選取 [ 拖曳]。

5. 指定用來提供值的數據行，以及用來篩選查詢的參數。

   重要

   數據行和參數必須具有相同的數據類型。

使用交叉篩選與您的數據互動

定義交叉篩選之後，您就可以使用它來與數據互動。 在您已定義交叉篩選的視覺效果中，您可以選取數據點，並使用其值來篩選目前的儀錶板頁面。 針對資料表視覺效果，以滑鼠右鍵單擊相關數據格，然後在操作功能表中選取 [交叉篩選]。

您可以選取 選取視覺效果頂端的 [重 設]，以重設交叉篩選。

使用鑽研作為儀錶板參數

透過鑽研，您可以選取視覺效果中的值，並用它來篩選相同儀錶板中目標頁面中的視覺效果。 當目標頁面開啟時，值會在相關的篩選中預先選取。 頁面上的視覺效果，例如折線圖或散佈圖，會篩選成只顯示相關數據。

定義鑽研

若要建立鑽研，您必須先在視覺效果中開啟它，然後視需要新增一或多個鑽研。

1. 編輯您要新增鑽研的視覺效果。 確定已選取 [視覺效果] 索引標籤。

2. 在右窗格中，選取 [互動]，然後開啟鑽研。

   

3. 在 [鑽研] 底下，選取 [新建]，然後指定下列資訊。 選擇性地選取 [新增另一組 ] 以新增目標頁面的多個參數。 重複此步驟，以使用不同的參數，將鑽研新增至目前儀錶板中的其他頁面。

   欄位	描述
   目的地路徑	一或多個目標頁面，以使用定義的參數鑽研至 。
   資料行	要作為目標頁面中參數值的查詢結果數據行。
   參數	參數，用來使用數據行值篩選目標頁面中的視覺效果。
   備註	選用的更新描述。

   重要

   數據行和參數位必須具有相同的數據類型。

使用鑽研與您的數據互動

定義鑽研之後，您就可以使用這些鑽研來與您的數據互動。 若要這樣做，請在您已定義鑽研的視覺效果或資料表中，以滑鼠右鍵按兩下數據點，然後選取 [鑽研至>目的地] 頁面。 來自數據點的值將做為參數，以篩選目標頁面上的視覺效果。

若要返回來源頁面，請在目的地頁面右上角選取 [ 重設]。 鑽研指派的所有篩選都會重設。

針對單一和多個選取篩選使用篩選條件搜尋

在單一和多個選取範圍篩選中，輸入您想要的值。 篩選會更新，只顯示符合搜尋字詞的值。

相關內容

• 自訂 Azure 資料總管儀表板視覺效果
• 在 Web UI 撰寫 Kusto 查詢語言 查詢