使用查詢型參數

本文會引導您完成建立使用查詢型參數的互動式儀表板的步驟。 文中假設您基本熟悉如何在 Azure Databricks 上建置儀表板。 如需有關建立儀表板的基本指示，請參閱入門。

需求

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

建立儀表板資料集

本教學課程使用 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. 按一下小工具上的預留位置標題，然後鍵入 [區隔] 以重新命名篩選器。
5. 按一下組態面板中 [參數] 旁邊的 。
6. 從 [行銷區隔] 資料集中選擇 [區隔]。

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

定義值的選取範圍

您建立的篩選器功能正常，但它需要檢視者知道可用的選擇範圍，然後才能鍵入選取範圍。 它還要求使用者在輸入所需的參數值時符合大小寫和拼字。

若要建立下拉式清單以便檢視者可以從可用選項清單中選取參數，請建立新的資料集來定義可能值清單。

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

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

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

   SELECT
     DISTINCT c_mktsegment
   FROM
     samples.tpch.customer
   

4. 執行查詢並檢查結果。 資料表中的五個行銷區隔將出現在結果中。

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

更新篩選器

更新現有的篩選器，以使用您剛建立的資料集來填入使用者可以從中選取的下拉式值清單。

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

變更組態時，篩選器小工具會更新。 按一下篩選器小工具中的欄位，以查看下拉式功能表中的可用選擇。

注意

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

下一步

透過下列文章繼續了解如何使用儀表板：

• 深入了解如何套用篩選器。 請參閱篩選條件。
• 深入了解儀表板參數。 請參閱使用儀表板參數。
• 發佈並共用儀表板。 請參閱發佈儀表板。