使用控制面板篩選

篩選會限制儀錶板視覺效果中顯示的數據，讓使用者可以專注於符合特定準則的數據。 此頁面說明可用的篩選類型，以及如何使用它們。

篩選互動性和範圍

儀錶板作者可以將篩選設定為互動式，讓檢視者以動態或靜態方式調整值，其中儀錶板作者會預先定義篩選值。 互動式篩選可讓儀錶板檢視者選取相關視覺效果中的數據集值。 儀錶板編輯器會設定靜態篩選值，並只將它們套用至其設定所在的小工具，以跨小工具啟用相同數據集的唯一檢視。

儀表板篩選在不同範圍內運作，每個範圍具有特定特性：

• 全域篩選： 針對共用一或多個數據集的視覺效果，在儀錶板中套用至所有頁面的互動式篩選。 檢視者可以動態調整這些值，而變更會影響整個儀錶板。 請參閱 全域篩選。

• 頁面層級篩選： 適用於共用一或多個數據集之相同頁面上所有視覺效果的互動式篩選小工具。 檢視者可以修改這些值，以變更該特定頁面的檢視。

• 小工具層級篩選： 僅套用至設定個別視覺效果小工具的靜態篩選。 儀錶板作者會使用檢視者無法變更的值來設定篩選。 這些過濾器可在不同的小工具中創建同一數據集的獨特視圖。

主動式濾鏡列

儀表板上的所有作用中篩選器都會顯示在儀表板頂端附近的作用中篩選器列中。 任何未設定為 「全部」的篩選器（全域或頁面層級）以及任何交叉篩選都會顯示在此列中。 作用中篩選器列會顯示所有全域和頁面層級篩選器及其值，無論該值是由使用者設定還是繼承自預設值。

過濾器應用行為

預設情況下，當觀眾從下拉選單選擇某個值時，過濾器會立即套用。 儀表板作者可設定篩選器僅在檢視器點擊套 用 按鈕時套用，讓檢視者在更新儀表板前能選擇多個篩選值。 要設定過濾應用程式行為，請參見 設定篩選應用程式行為。

全域篩選

若要檢視所有全域篩選，請按下 [ 儀錶板左上角的篩選圖示。 在儀錶板右側開啟一個面板。

若要建立全域篩選：

1. 按兩下 儀錶板畫布左上角的篩選圖示。
2. 按一下 +。 篩選組態面板會在畫布右側開啟。
3. 設定篩選組態，就像任何其他互動式篩選小工具一樣。 如需設定篩選小工具的範例，請參閱 儀錶板篩選類型。

篩選小工具

篩選小工具是互動式元素，可讓檢視者調整數據集欄位和參數上的頁面層級篩選值。

若要建立篩選小工具：

1. 按兩下 新增篩選條件 （field/parameter） 以新增篩選小工具。 然後，將篩選器放在儀錶板畫布的頁面上。 已選取篩選條件，且組態面板會在畫面右側開啟。
2. 開啟 Widget 標題 ，以顯示 Widget 中的標題欄位。 編輯小工具上的標題。
3. 開啟 [描述]。
4. 從組態面板中的 [ 篩選 ] 下拉功能表中，選取 [日期範圍選擇器]。
5. 單擊 [ 加上 [ 字段 ] 功能表旁的圖示。 從下拉功能表中點選tpep_pickup_datetime。

設定預設篩選值

當儀錶板重新整理而不選取新的篩選值時，會使用預設值。 若要設定預設值，請從篩選小工具組態設定中的 [ 預設值 ] 下拉式清單中選取值。

篩選會套用至整個數據集。 針對小型數據集，篩選會在瀏覽器中套用，以將效能優化。 如果數據集較大，則會將篩選新增至 SQL 倉儲中執行的查詢。 請參閱 資料集優化和快取。

欄位篩選

欄位會依特定數據集欄位篩選縮小數據範圍。 例如，欄位篩選可能會根據資料集中的日期欄位，將數據限製為特定日期範圍。 欄位篩選可以連接到一或多個數據集，允許根據選取專案動態變更可用的篩選值。 若要將篩選連接到多個數據集的欄位，請新增多個 Fields，每個數據集最多一個。 此篩選會套用至建置在所選數據集上的所有視覺效果。 選取一個篩選的值會動態變更其他篩選的下拉功能表中顯示的可用值。 下圖顯示設定為篩選兩個字段的篩選組態面板。

根據參數篩選

參數篩選會直接修改 SQL 查詢，並提供動態查詢調整。 篩選可以連線到一或多個參數。 若要將篩選連接到多個參數，請在篩選組態面板中新增多個 Parameters。 篩選 Widget 中設定的預設值會覆寫查詢編輯器中設定的預設值。 如果篩選已連線至參數，則不論數據集大小為何，都會對SQL倉儲執行查詢。 請參閱 使用儀錶板參數。

您可以設定參數值以接受下列其中一種資料類型：

• 字串
• 數字
  • 整數
  • 十進位
• 日期
• 日期和時間
• 日期範圍
• 日期和時間範圍

我是否應該篩選欄位或參數？

對於相對較小的資料集，欄位篩選通常會比參數更有效率地執行，因為 Azure Databricks 會在瀏覽器中套用它們，而不需要重新執行查詢。

參數會在執行階段取代值，而且一律需要相關聯的查詢才能重新執行。 不過，參數可以為查詢最佳化提供更大的彈性。 欄位篩選器會將 SQL 包裝在通用表格運算式 （CTE） 中，並在查詢結尾套用，這在某些情況下可能會降低效率。

使用參數，您可以將篩選條件放在查詢中的任何位置，例如在聯結之前而不是之後。 這種靈活性可讓您根據資料結構和存取模式最佳化查詢效能。 例如，在聯結之前進行篩選會大幅減少聯結作業期間處理的資料。

下表比較直接在數據集欄位上的篩選與使用參數進行篩選的差異。

篩選類型

欄位和參數篩選支援各種篩選類型：

• 欄位篩選： 單一值、多個值、日期選擇器、日期範圍選擇器、文字輸入、範圍滑桿。
• 參數篩選： 單一值、多個值、日期選擇器、日期範圍。

如需示範如何設定不同篩選類型的範例，請參閱 儀錶板篩選類型。

發佈的儀錶板 URL 中的篩選器

已發佈的儀錶板會將欄位篩選和參數選擇儲存在URL中。 這可讓使用者使用特定篩選組態來加入書籤或共用儀錶板。 當用戶開啟 URL 時，儀錶板會載入已套用這些篩選值。

篩選標識元不會儲存為具名值。 每個篩選都是透過頁面 name 值和小工具 name 值的組合來識別，並以圖狀符號分隔（~）。 這些值預設會自動產生。 篩選標識碼和值會當做 URL 的一部分傳遞，以載入具有指定篩選選取範圍的儀錶板。

下列範例顯示具有已選取的篩選值與儀表板 URL 結構：

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_<page-name>~<widget-name>=<filter-value>

• URL 的第一個部分用來識別已發佈的儀錶板。 請參閱 儀錶板 URL 和標識碼。
• 識別篩選的 區段開頭 f_ 為 ，後面接著 page-name 和 widget-name，並以底狀符號 （~） 分隔。
• 等號 （=） 右邊的值是選取的篩選值。

建立儀錶板時，page-name 和 widget-name 值會自動產生。 您可以在串行化 lvdash.json 檔案中編輯這些名稱。 名稱會跨匯入、匯出和重新發佈等作業保存。 請參閱 編輯儀錶板檔案。

存取並設定 URL 中的篩選值

下列範例顯示發佈的儀表板 URL，其中包含選定的篩選值：

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=10013

此範例會參考具有三個篩選條件的儀錶板： 時間範圍、 取貨郵遞區號 和 卸貨郵遞區號。 只有 Pickup Zip 篩選條件已指派值。 在網址中，它已設定為 10013 使用識別碼 f_53eadf26~3490f286。

若要建立類似此範例中使用的儀錶板，請參閱 建立儀錶板。

在 URL 中指定相對日期範圍值

如果使用相對時間篩選條件，例如 過去 5 分鐘 或 過去 12 小時，則對應的值會出現在 URL 中。

下列範例顯示已選取 [過去 12 小時] 的 URL。

<databricks-instance>/dashboardsv3/<dashboard-id>/published?o=<workspace-id>&f_53eadf26~3490f286=now-12h

在這裡情況下，篩選識別碼 f_53eadf26~3490f286 會設定為相對值 now-12h。

靜態小工具篩選

靜態 widget 篩選器顯示由儀表板作者設定的數據集視圖。 這些只會套用至其設定所在的小工具，以在不同的小工具中啟用相同數據集的唯一檢視。 與全域和頁面層級篩選不同，靜態小工具篩選只會套用至設定它們的視覺效果小工具。 儀錶板檢視者無法變更其篩選值。

範例使用案例

假設您正在建立可分析區域效能的銷售儀錶板。 您使用包含所有區域銷售數據的資料集。 藉由套用靜態小工具篩選，您可以設定一個小工具以顯示區域 A 的銷售，另一個小工具顯示區域 B 的銷售。此方法可讓檢視者並排比較區域效能，即使這兩個小工具都從相同的數據集繪製也一樣。 因為靜態小工具篩選是固定的，所以檢視者無法修改篩選，確保儀錶板一律會呈現一致的數據檢視。

小工具層級篩選器支援的篩選器類型

小工具層級篩選器支援下列篩選器類型：

• 單一值：篩選欄位中的特定值
• 多個值：篩選欄位中的一或多個值
• 日期選擇器：以特定日期篩選
• 日期範圍選擇器：篩選日期範圍，包括相對日期範圍 （例如過去 7 天、上個月）
• 範圍滑桿：篩選數值範圍
• 文字輸入：根據文字比對進行篩選

如需每個篩選器的組態範例，請參閱 儀表板篩選類型。

新增靜態小工具層級篩選

若要將靜態小工具層級篩選新增至視覺化：

1. 將視覺效果小工具新增至草稿儀錶板畫布。

2. 選取新的小工具後，從組態面板中 數據集 下拉式清單中選擇數據集。

3. 點擊 顯示篩選。 篩選欄位 選項會出現在數據集標題下方。 針對包含參數的數據集，也會顯示 Parameters 區段。

   

若要新增欄位篩選，請執行下列動作：

1. 點擊 篩選欄位標題右邊的加號，然後從下拉功能表中選擇欄位。
2. 根據預設，篩選值會設定為 All。 使用下拉功能表來選擇新的值。 從下拉選單移開，顯示套用新篩選條件後的視覺化效果。
3. 檢閱您的儀錶板。

若要瞭解如何設定靜態小工具層級參數，請參閱 靜態小工具參數。