使用以查詢為基礎的參數

本文會引導您完成建立使用查詢型參數的互動式儀錶板的步驟。 它假設對在 Azure Databricks 上建置儀錶板有基本熟悉度。 如需建立儀錶板的基本指示，請參閱開始使用。

需求

• 您已登入 Azure Databricks 工作區。
• 您有該工作區中的 SQL 權利。
• 您至少可以存取一或多個 SQL 倉儲。

建立儀錶板數據集

本教學課程使用 Azure Databricks 上範例 目錄中產生的數據。

1. 單擊提要字段中的 [新增]，然後從功能表中選取 [儀錶板]。

2. 按兩下 [資料] 索引標籤。

3. 按兩下 [ 從 SQL 建立]，並將下列查詢貼到編輯器中。 然後按兩下 [ 執行] 以傳回結果。

   SELECT
     *
   FROM
     samples.tpch.customer
   

4. 新定義的數據集會以未命名的數據集名稱自動儲存。 按兩下標題，然後將它重新命名為 行銷區段。

新增參數

您可以將參數新增至此數據集，以篩選傳回的值。 這個範例中的參數為 :segment。 請參閱 什麼是儀錶板參數？ 以深入了解參數語法。

1. 將下列 WHERE 子句貼到查詢底部。 參數名稱 segment 的文字欄位會出現在您的查詢下方。

   WHERE
     c_mktsegment = :segment
   

2. 在查詢下方的文字欄位中輸入 BUILDING ，以設定 參數的預設值。

3. 重新執行查詢以檢查結果。

設定視覺效果小工具

完成下列步驟，在畫布上新增數據集的視覺效果：

1. 按兩下 [畫布] 索引 標籤 。
2. 按兩下 [新增視覺效果 ] 以新增視覺效果小工具，並使用滑鼠將它放在畫布中。

設定 X 軸

1. 如有必要，請從 [視覺效果] 下拉功能表中選取 [列]。
2. 按兩下 以選擇沿著 X 軸呈現的數據。 您可以使用搜尋欄位依名稱搜尋欄位。 選取 [c_nationkey]。
3. 按兩下您選取的功能變數名稱，以檢視其他組態選項。
   • 選取 [ 尺規類型]，選取 [類別]。
   • 針對 [ 轉換 ] 選取項目，選擇 [ 無]。

設定Y軸

1. 按兩下 Y軸旁的 ，然後選取 [c_acctbal]。
2. 按兩下您選取的功能變數名稱，以檢視其他組態選項。
   • 選取 [數量類型] 作為 [調整類型]。
   • 針對 [ 轉換 ] 選取項目，選擇 [ SUM]。

當您設定視覺效果時，視覺效果會自動更新。 顯示的資料只包含的紀錄，其中 segment 是 BUILDING。

新增篩選

設定篩選條件，讓儀錶板檢視者可以控制要關注的行銷區段。

1. 按兩下 [新增篩選] [字段/參數] 以新增篩選小工具。 將它放在畫布上。
2. 從組態面板中的 [ 篩選 ] 下拉功能表中，選取 [單一值]。
3. 選取 [ 標題] 複選框，以顯示篩選小工具上的標題字段。
4. 按兩下小工具上的佔位元符標題，然後輸入 Segment 來重新設定篩選條件。
5. 按兩下組態面板中的 [參數] 旁。
6. 從行銷區段數據集中選擇區段。

您設定的篩選小工具會顯示資料集的預設參數值。

定義值的選取範圍

您建立的篩選功能正常，但它需要查看器知道可用的選項範圍，才能輸入選取範圍。 它也要求使用者在輸入所需的參數值時符合案例和拼字。

若要建立下拉式清單，讓查看器可以從可用選項清單中選取參數，請建立新的數據集來定義可能值的清單。

1. 按兩下 [資料] 索引標籤。

2. 按兩下 [ 從 SQL 建立] 以建立新的資料集。

3. 將下列內容複製並貼到編輯器中：

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. 執行查詢並檢查結果。 數據表中的五個行銷區段會出現在結果中。

5. 按兩下自動產生的標題，然後重新命名此資料集 區段選擇。

更新篩選條件

更新現有的篩選條件，以使用您剛才建立的數據集，填入使用者可以選取的值下拉式清單。

1. 按兩下 [ 畫布]。 然後，按下您在上一個步驟中建立的篩選小工具。
2. 按兩下 [欄位] 旁 的 [欄位]。
3. 點選取 [ 區段選擇]，然後按下網域名稱 c_mktsegment。

當您變更設定時，篩選小工具會更新。 按下篩選小工具中的欄位，以查看下拉功能表中的可用選項。

注意

本教學課程包含簡化的使用案例，旨在示範如何使用查詢型參數。 建立此儀錶板的替代方法是將篩選套用至 c_mktsegment 欄位。

下一步

繼續瞭解如何使用下列文章使用儀錶板：

• 深入瞭解套用篩選。 請參閱 篩選。
• 深入了解儀錶板參數。 請參閱 什麼是儀錶板參數？。
• 發佈並共用您的儀錶板。 請參閱 發佈儀錶板。