儀表板

您可以使用儀錶板來建置數據視覺效果，並與小組共享報表。 AI/BI 儀表板提供 AI 輔助撰寫、增強的視覺效果程式庫，以及簡化的設定體驗，讓您可以快速地將資料轉換成可共用的深入解析。 當儀表板發佈時，任何 Azure Databricks 帳戶的已註冊使用者可與您共用儀表板，即便該使用者無工作區的存取權。 請參閱共用儀表板。

重要

• Databricks 建議使用 AI/BI 儀表板 (先前稱為 Lakeview 儀表板)。 舊版儀錶板，先前稱為 Databricks SQL 儀錶板，現在稱為 舊版儀錶板。 Databricks 不建議建立新的舊版儀表板。
• 使用遷移工具或 REST API 轉換現有的舊版儀表板。
  • 如需使用內建移轉工具的指示，請參閱將舊版儀表板複製到 AI/BI 儀表板。
  • 如需使用 API 移轉舊版儀錶板的指示，請參閱 移轉儀錶板。
  • 請參閱 REST API 參考中的遷移儀錶板 POST /api/2.0/lakeview/dashboards/migrate 端點。

AI/BI 儀表板具有下列元件：

• 資料：資料索引標籤可讓使用者定義資料集以供儀表板使用。 當您使用 UI 或 API 共用、匯入或匯出資料集時，資料集會與儀表板搭配使用。
• Canvas：[畫布] 索引標籤可以組織成多頁報表。 儀錶板編輯器可以藉由新增視覺效果、篩選、文字和影像等小工具來建置和設定其儀錶板。

注意

每個儀表板可定義多達 100 個資料集。 Canvas 最多可以包含 10 頁。 儀錶板可跨所有頁面保存最多 100 個小工具。

檢視及整理儀表板

您可以從工作區瀏覽器和其他 Azure Databricks 物件存取儀表板。

• 按一下側邊欄中的 [工作區]，即可從工作區瀏覽器檢視儀表板。 儀表板預設儲存於 /Workspace/Users/<username> 目錄。 使用者可以將儀表板與其他 Azure Databricks 物件一起整理至工作區瀏覽器的資料夾中。 請參閱工作區瀏覽器。

• 若要檢視儀表板清單頁面，請按下側邊欄中的[儀表板] 。

  根據預設，儀表板清單頁面會按反向時間順序顯示您有權存取的儀表板。 您可以在搜尋列中輸入標題來篩選清單，或根據上次修改的時間範圍以及擁有者進行篩選。

• 按下儀表板標題即可開啟儀表板。 如果之前已發佈儀表板，則會開啟已發佈的版本。 否則，草稿儀表板將會開啟。

建立新的儀表板

若要從儀表板清單頁面建立新的儀表板，請按下頁面右上角附近的[建立]。

在儀表板撰擬草稿和共同作業

新的儀表板會以草稿形式開始。 您可以與工作區中的其他使用者共用草稿以共同作業。 您無法與工作區外部的使用者共用草稿儀表板。 所有用戶都會使用其認證來與儀錶板草稿中的數據和視覺效果互動。

如需許可權等級的詳細資訊，請參閱 AI/BI 儀錶板 ACL。

定義資料集

使用 [資料]索引標籤定義儀表板的基礎資料集。

您可以將資料集定義為下列任何一項：

• 針對一或多個資料表或視圖的新查詢。
• 現有的 Unity Catalog 數據表或檢視。

注意

每個數據集都是由查詢所定義。 選取現有的 Unity 目錄資料表或檢視時，查詢預設為在該物件上 SELECT *，您可以修改以精簡數據集。

您可以藉由新增查詢或選取其他數據表或檢視來建立多個數據集。 若要調整數據集的顯示順序，請將其名稱拖放到所需的位置。

若要在資料集編輯器中格式化查詢，請在編輯器內按下滑鼠右鍵，然後選取 [[格式化檔案]。

如需建立和管理儀錶板資料集的詳細資訊，請參閱 建立和管理儀錶板數據集。

將頁面、視覺效果、文字和篩選新增至畫布

使用 [創作區]索引標籤即可建構儀表板。 畫布最多可以包含十頁。 您可以將視覺效果、文字和篩選小工具新增至每個頁面。 使用多個頁面來組織您的內容簡報、最小化捲動，以及改善儀錶板可讀性。 使用每個頁面底部的工具列來新增小工具，例如視覺效果、文本框和篩選。

建立多頁報表

新的儀錶板會以名為 Untitled 頁面的單一頁面開始。 若要編輯頁面的名稱，請按兩下標題，然後在文字欄位中輸入新名稱。 命名衝突會自動解決，方法是將數位附加至標題。

若要檢視頁面上的內容，請按下標題加以選取。

新增和移除頁面

若要新增頁面：

• 按兩下 畫布上目前頁面標題的右邊。 根據預設，您的新頁面名為 [未命名] 頁面。
• （選擇性）按兩下頁面標題，然後輸入新名稱來重新命名頁面。

若要移除頁面：

• 按兩下 頁面標題右側的Kebab功能表。
• 按兩下 [ 刪除] 以刪除頁面。

注意

刪除頁面也會刪除該頁面上的所有小工具。 如果您刪除所有頁面，請按兩下 [建立頁面 ] 以再次開始建置儀錶板。

複製頁面

若要複製頁面：

1. 按兩下頁面標題以選取它。
2. 單擊標題圖格中的 [，然後單擊 [複製]。

新頁面是原始的確切復本，包括所有小工具。 基礎數據集維持不變。

視覺效果

將視覺效果小工具新增至畫布上的頁面，以建立視覺效果。 支援的視覺效果包括區域、直方圖、方塊、組合、計數器、熱度圖、直方圖、折線圖、餅圖、樞紐圖、散佈圖和表格圖表類型。 如需可用視覺效果類型和範例組態值的完整清單，請參閱 儀錶板視覺效果類型。

注意

視覺效果所使用的查詢不一定會精確對應至資料集。 例如，如果您將匯總套用至視覺效果，視覺效果會顯示匯總的值。

使用下列其中一個方法來建立視覺效果：

• AI 輔助視覺效果：描述您想要以自然語言查看的圖表，並讓 Databricks Assistant 產生圖表。 圖表建立之後，您可以使用組態面板修改產生的圖表。 您無法使用小幫手來建立資料表或數據透視表圖表類型。
• 使用組態面板：在視覺效果組態套用其他的彙總或時間區間即可，不必直接修改資料集。 您可以選擇資料集、x 軸值、y 軸值和色彩。

如需如何將自訂格式套用至圖表的詳細資訊，請參閱 儀錶板視覺效果。 請參閱 數據表選項 瞭解如何控制數據表視覺效果中的數據呈現。

注意

當您在視覺效果組態中套用時態性轉換時，視覺效果中顯示的日期代表該期間的開始日期。

文字小工具

Markdown 是在純文字編輯器將文字格式化的標記語言。 您可以在文字小工具中使用 Markdown 來格式化文字、插入連結，以及將影像新增至儀錶板。

將影像新增至文字小工具

使用下列其中一種方法，將影像新增至儀表板。 每個方法都包含可編輯以顯示影像的範例 Markdown 語法。 若要調整影像大小，請調整小工具尺寸的大小。

• 使用本機檔案:

  若要顯示本機檔案，請先將其編碼為base64字串。 然後，使用下列 Markdown 語法，將 <base64-encoded-string> 替換為您的編碼字串。

  ![description](data:image/webp;base64,<base64-encoded-string>)
  

  注意

  如果您熟悉命令行公用程式，請使用 base64 工具來轉換您的檔案。 或者，有許多免費的在線資源可供您用來base64編碼檔案。

• 從磁碟區：

  <WorkspaceURL>/ajax-api/2.0/fs/files/<Volumes/path/to/image>
  

  以工作區 URL 取代此範例中的範例文字，以及儲存在磁碟區中影像的路徑。

  使用下列步驟來取得圖像的路徑：

  1. 在側邊欄中點選 目錄，開啟目錄瀏覽器 UI。
  2. 點擊架構瀏覽器中的圖片文件。
  3. 按下檔案名稱右邊的 kebab 功能表。 然後按下 [複製路徑]。

  請參閱 什麼是 Unity 目錄磁碟區？ 深入瞭解如何將數據儲存在磁碟區中。

• 公開託管的影像：

  針對公開裝載的影像，請使用下列 Markdown 語法，並插入指向影像的公用 URL。

  ![description](URL)
  

將範例文字取代為您想要顯示之影像的描述和 URL。 例如，下列 Markdown 會插入 Databricks 標誌的影像：![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png)。

如需 Markdown 語法的詳細資訊，請參閱 本指南。

注意

當您使用內嵌認證發佈儀錶板時，檢視者會使用您的認證來存取包含的影像。 如果您的儀錶板未使用嵌入式憑證發佈，您必須明確地授予儲存在 Azure Databricks 上的影像檔案的使用者存取權。 使用目錄總管來檢查、授與和撤銷您想要包含之圖像檔的許可權。 在側邊欄中點選 目錄，開啟目錄瀏覽器 UI。

交叉篩選

交叉篩選可讓您分析選取的數據子集，並探索多個視覺效果之間的關聯性。 當您按一張圖表中的元素時，相同頁面上的所有圖表都會根據選取的值自動篩選相同的數據集。

身為儀錶板編輯者，透過建立兩個或多個共用相同數據集的圖表來設定交叉篩選。 檢視人員按下圖表項目即可依下列圖表類型篩選資料集：

• 橫條圖
• 方塊圖
• 熱度圖
• 長條圖
• 圓形圖
• 散佈圖
• 點圖

選取之後，以相同數據集為基礎的所有其他視覺效果都會使用篩選的值自動更新。

使用篩選

篩選器是儀表板小工具，可協助檢視人員縮小結果範圍，並精簡視覺效果中的資料，功能類似其他 BI 工具中的交叉分析篩選器。 您可以設定它們，根據一或多個數據集數據行（也稱為欄位）或建立數據集之 SQL 查詢中定義的參數來篩選值。 若要瞭解如何在儀錶板上設定視覺效果的篩選，請參閱 使用儀錶板篩選。

複製小工具

使用鍵盤快速鍵複製選取的小工具，並將它貼回創作區。 建立新的小工具之後，即可像編輯任何其他小工具一樣對其進行編輯。

若要在草稿儀表板創作區複製小工具，請完成下列步驟：

• 以滑鼠右鍵按一下小工具。
• 按下 [複製]。

您小工具的復本會出現在原始的下方。

移除小工具

選取小工具，然後按鍵盤上的 DELETE 鍵，即可刪除小工具。 或者，以滑鼠右鍵按一下小工具。 然後按下 [刪除]。

下載結果

您可以將資料集下載為 CSV、TSV 或 Excel 檔案。 您可以將創作區上的視覺效果下載為 PNG 檔案。

• 若要從 [創作區] 索引標籤開啟下載選項，請按下小工具右上角的 Kebab 功能表。
• 若要從 [資料] 索引標籤開啟下載選項，請按下資料集右側的 Kebab 功能表。

您可下載最多約 1GB 的 結果資料 (CSV 和 TSV 格式)，以及最多 100,000 個資料列到 Excel 檔案。 最終檔案下載大小可能略高於或小於 1GB，因為 1GB 限制會套用至比最終檔案下載還舊的步驟。

若要瞭解如何將已發佈的儀錶板下載為 PDF，請參閱 下載已發佈的儀錶板。

發佈儀表板

發佈儀表板，即可建立目前草稿的全新複本。 您必須至少有 CAN EDIT 權限才能發佈儀表板。

發佈儀表板之後，即使您對草稿進行變更，發佈的版本仍會保持不變，直到您再次發佈為止。 您可以修改和改善草稿版本，而不會影響已發佈的複本。 任何具有已發佈儀表板存取權的已註冊使用者都可以持續檢視已發佈的版本。 您可持續以電子郵件傳送已發佈的版本給訂閱者 (如果有)。 如需管理儀表板存取權的詳細資訊，請參閱共用儀表板。

重要

已發佈的儀表板未設定版本，且不應用於版本控制。 您無法將草稿儀表板還原回先前發佈的狀態。

發佈時，請選擇下列其中一項：

• 內嵌認證：已發佈儀錶板的所有檢視者都可以使用您的認證來執行涉及數據和計算資源的查詢。 即使缺少源工作區、基礎數據或 SQL 倉儲的存取權，這可讓具有儀錶板存取權的已註冊用戶檢視它。 此作法可能會將資料公開給未授與直接存取權的使用者。 這是預設選項。
• 不要內嵌憑證：已發佈儀錶板的所有檢視者都會使用各自的資料和運算憑證來執行查詢。 若要在儀表板檢視結果，檢視人員必須存取工作區、連結的 SQL 倉儲，以及相關聯的資料。

注意

不論認證設定為何，所有儀錶板檢視者都必須進行驗證才能存取儀錶板。

如需該選擇何種設定的建議，請參閱共用已發佈的儀表板 。

若要發佈儀表板，請完成下列步驟：

1. 開啟儀表板。 如果儀表板先前已發佈，則會開啟已發佈的版本。 如有必要，請使用頁面頂端的切換器查看目前的草稿版本。
2. 按一下 [發行]。 [發佈] 對話方塊隨即顯示。
3. 請選擇要用于發佈的儀錶板的憑證。 您可以選擇內嵌或不內嵌您的認證。
4. 按一下 [發行]。 如果儀表板是第一次發佈，[共用]對話方塊會隨即開啟，並提示您共用已發佈的儀表板。 如需共用的詳細資訊和建議，請參閱 共用儀表板 。

若要存取已發佈的儀表板，請按下儀表板頂端附近下拉式功能表中的 [已發佈]。

使用服務主體發佈和共用儀錶板

使用 REST API 以與服務主體相關聯的內嵌認證來發佈和共用儀錶板。 這可讓用戶沒有直接數據或計算許可權，即可檢視儀錶板，並使用服務主體的認證來執行查詢，而不是自己的認證。 用戶必須向 Databricks 帳戶註冊。 如需使用 REST API 來管理儀錶板的詳細資訊，請參閱 REST API 參考中的 Lakeview。

下載已發布的儀表板

載入已發佈的儀錶板之後，請使用下列步驟將它下載為 PDF：

• 單擊儀錶板右上角附近的 。
• 點擊 下載為 PDF。

從儀表板啟用 Genie 空間

重要

這項功能處於公開預覽狀態。

當您建立儀錶板時，系統會自動為您建立 Genie 空間。 Genie 空間是一種無程式碼介面，可讓商務使用者使用自然語言進行自助資料分析。 自動建立的 Genie 空間會以可用來預覽空間的草稿開始。 當您新增和移除數據集和視覺效果時，草稿 Genie 空間會與您的草稿儀錶板保持同步。

當您發佈儀錶板時，您可以選擇發佈相關聯的 Genie 空間草稿，或改為連結到現有的 Genie 空間。

發佈與您的儀錶板相關聯的 Genie 空間可讓檢視者以不同的方式探索儀錶板數據。 他們可以與資料互動並自行提問來進行更深入的分析，而非只基於儀表板上的可用內容獲得深入解析。 請參閱 什麼是 AI/BI Genie 空間。

發佈 Genie 空間會將 [詢問 Genie] 按鈕新增至已發佈的儀錶板。 當儀錶板檢視者按兩下該按鈕時，會在儀錶板上開啟聊天介面，並提示使用者詢問數據相關問題。

若要發佈相關聯的 Genie 空間，請使用下列步驟：

1. 按一下 [發行]。
2. [啟用 Genie] 切換預設為開啟。 點擊切換開關以開啟它。
3. （選擇性）若要鏈接現有的 Genie 空間，請選取 [鏈接現有的 Genie 空間] 單選按鈕，然後貼上相關聯的 URL。 如果未選取此選項，系統會根據您的儀表板自動為您產生新的 Genie 空間。
4. 按兩下 [發佈] 對話框中的 [發佈]。

注意

草稿和已發佈的 Genie 空間各自獨立，就像儀表板的草稿和已發佈版本一樣。 只有當您重新發佈儀表板時，對草稿儀表板所做的任何變更，才會反映在已發佈的 Genie 空間中。 草稿和已發佈的 Genie 空間為儀表板的隨附功能。 它們不會出現在您的檔案瀏覽器或 Genie 清單頁面中。

若要在新視窗中開啟已發佈的 Genie 空間：

1. 點擊聊天視窗右上角的 kebab選單
2. 按兩下 [ 開啟 Genie 空間]。

若要預覽草稿 Genie 空間：

1. 按下儀表板右上角的 Kebab 功能表。
2. 按下 [開啟草稿 Genie 空間]。

注意

您無法從 Genie 空間 UI 編輯此 Genie 空間的指令。 只有當您變更草稿儀表板時，草稿 Genie 空間才會變更。

連結的 Genie 空間許可權

相關聯 Genie 空間的許可權會鏡像儀錶板上的許可權，但存取權僅限於具有工作區存取權的使用者。 即使您的儀錶板透過內嵌憑證進行共用，只有具備工作區存取權限的使用者才能與 Genie 空間互動。

檢視者會使用自己的認證來存取為 Genie 空間提供電源所需的計算和數據。 他們必須至少擁有在 Genie 空間中使用資料表的 SELECT 許可權。

共用儀表板

您可以安全地與帳戶中的任何人共用儀表板。 針對指派給工作區的使用者，您可以授與存取權，並設定與其他工作區物件一樣的不同許可權等級。 至於未指至工作區的使用者，您可以與其在帳戶層級共用儀表板，讓已註冊的使用者能夠檢視和執行儀表板。

若要了解系統管理員如何在帳戶層級設定以便共用，請參閱 儀錶板管理指南。 如需在帳戶和工作區層級共用儀表板的詳細資料，請參閱共用儀表板。

在網站和應用程式中內嵌儀表板

您可以使用 iframe，將已發佈的儀表板內嵌至外部網站和應用程式。 請參閱內嵌儀表板。

如果您是工作區系統管理員，想管理儀錶板可以內嵌的外部網站，請參閱管理儀錶板內嵌。

排程和訂用帳戶

您可以設定自動更新排程，以自動刷新儀錶板的緩存，並選擇性地將包含最新儀錶板的 PDF 電子郵件發送給訂閱計劃的用戶。 至少有 可編輯 許可權的使用者可以建立排程，讓具有內嵌認證的已發佈儀錶板定期執行。 每個儀表板有多達十個排程。

請參閱 管理排程的儀表板更新和訂用帳戶。

匯出、匯入或取代儀表板

您可以將儀表板匯出為檔案再匯入，以利跨不同工作區共用可編輯的儀表板。 若要將儀表板傳輸到不同的工作區，請將儀表板匯出為檔案，然後匯入新的工作區。 您也可以直接取代儀表板檔案。 這表示當您直接編輯儀表板檔案時，可以將該檔案上傳至原始工作區，並在維持現有共用設定的同時覆寫現有檔案。

下列各節說明如何在UI中匯出和匯入儀錶板。 您也可以使用 Databricks API，以程式設計方式匯入和匯出儀表板。 請參閱POST /api/2.0/workspace/import。

匯出儀表板檔案

• 從草稿儀表板中，按下畫面右上角的 Kebab 功能表，然後按下 [匯出儀表板]。
• 使用 [匯出儀表板] 對話方塊確認或取消動作。 當匯出成功時，.lvdash.json 檔案會儲存至網頁瀏覽器的預設下載目錄。

匯入儀表板檔案

• 從儀表板清單頁面，按下 >[從檔案匯入儀表板]。
• 點擊 [選擇檔案] 開啟本機檔案對話框，然後選取您要匯入的 .lvdash.json 檔案。
• 按下 [匯入儀表板] 以確認並建立儀表板。

匯入的儀表板會儲存至您的使用者資料夾。 如果匯入的儀表板與已存在該位置的儀表板名稱相同，則會附加括號中的數字以建立唯一名稱，進而自動解決衝突。

從檔案取代儀表板

• 從草稿儀表板中，按下畫面右上角的 Kebab 功能表，然後按下 [取代儀表板]。
• 請按一下 [選擇檔案] 來開啟檔案對話框，然後選取要匯入的 [.lvdash.json 檔案]。
• 按下 [覆寫]即可覆寫現有的儀表板。

管理儀表板版本的最佳做法

若要啟用共同作業及管理不同版本的儀錶板，Databricks 建議使用下列步驟：

1. 將儀錶板導出為 JSON 檔案。 檔案格式 lvdash.json。
2. 將該檔案新增至版本控制系統，例如 Git。
3. 編輯檔案。 儀錶板檔案包含完整的查詢語法和小工具設定。 您可以直接編輯文字檔中的值，或將它上傳回您的工作區，並在 UI 中進行變更。
4. 儲存新檔案。 如果您在 UI 中做了變更，請匯出新的檔案。 使用您的版本控制系統來追蹤儀錶板變更和版本。
5. 更新現有的儀錶板。 從現有的草稿儀錶板：
   1. 點擊右上角 kebab 選單，然後點擊 [取代儀錶板] 。
   2. 在 [取代儀錶板] 上的對話框中，點擊 [選擇檔案]，並從檔案 中選擇。 然後按下 覆寫。

使用 REST API 管理儀表板

如需示範如何使用 Azure Databricks REST API 管理儀表板的教學課程，請參閱使用 Azure Databricks API 管理儀表板。 隨附的教學課程說明如何將舊版儀錶板轉換成 Lakeview 儀錶板，以及如何建立、管理及共享它們。

若要瞭解如何使用 Databricks 資產組合來管理 AI/BI 儀錶板，請參閱 儀錶板。

Databricks 也提供 Terraform 提供者。 請參閱 Databricks Terraform 檔。