舊版儀表板
您可以使用 SQL 編輯器來建置舊版儀表板,它可結合視覺效果和文字輸入框來提供資料內容。
重要
- Databricks 建議使用 AI/BI 儀表板 (先前稱為 Lakeview 儀表板)。 舊版儀錶板,先前稱為 Databricks SQL 儀錶板,現在稱為 舊版儀錶板。 Databricks 不建議建立新的舊版儀表板。
終止支援時程表:
2025 年 4 月 7 日:舊版儀錶板的官方支援將會結束。 只會解決重要的安全性問題和服務中斷問題。
2025 年 11 月 3 日:Databricks 將開始封存過去六個月未存取的舊版儀錶板。 已封存的儀表板將無法再存取,封存過程將會以滾動方式進行。 正在使用中的儀錶板的存取權會保持不變。
Databricks 將在 2025 年 11 月 3 日後與客戶合作,制定現有舊版儀錶板的遷移計劃。
使用移轉工具或 REST API 轉換舊版儀表板。 如需使用內建移轉工具的指示,請參閱將舊版儀表板複製到 AI/BI 儀表板。 如需使用 REST API 建立和管理儀表板的教學課程,請參閱 儀表板 教學課程。
檢視及組織舊版儀表板
您可以從工作區瀏覽器和其他 Azure Databricks 物件存取儀表板。
按一下側邊欄中的
[工作區],即可從工作區瀏覽器檢視儀表板。 儀表板預設儲存於
/Workspace/Users/<username>
目錄。 使用者可以將儀表板與其他 Azure Databricks 物件一起整理至工作區瀏覽器的資料夾中。若要檢視儀表板清單頁面,請按下側邊欄中的
[儀表板] 。
按一下 [舊版儀表板] 索引標籤以檢視舊版儀表板。
根據預設,會選取 [我的儀表板] 並按時間倒序顯示您擁有的儀表板。 點擊 建立於 標題,以重新排序列表。 或者,使用頁面頂端附近的索引標籤來檢視 [我的最愛] 或 [所有儀表板]。 使用 [標籤] 索引標籤依標籤篩選。
將儀表板組織到工作區瀏覽器中的資料夾
可以將新的和現有的儀表板連同其他 Azure Databricks 物件一起組織到工作區瀏覽器中的資料夾。 請參閱<工作區瀏覽器>。
篩選已儲存的儀錶板清單
依您建立的儀錶板(我的儀錶板)、依 我的最愛,以及依 標籤,來篩選所有儀錶板清單。
建立舊版儀表板
請遵循下列步驟來建立新的舊版儀表板。 若要複製現有儀表板,請參閱複製舊版儀表板。
- 按一下側邊欄中的
[儀表板],然後按一下 [舊版儀表板] 索引標籤。
- 按一下 [建立舊版儀表板]。
- 輸入儀表板的名稱。
- 當您建立儀錶板時,您可以選擇指定要用於手動重新整理的倉儲。 如果您未選取並將倉儲儲存至儀錶板,則會回復為使用針對個別查詢儲存的倉儲。
注意
如果您選取並將倉儲儲存至儀錶板後該倉儲被刪除或無法使用,那麼在指派新的倉儲之前,手動重新整理將會失敗。
按一下 [新增] 並選取要新增的內容類型,將內容新增至儀表板:
按一下 [文字輸入框] 以新增評論。
輸入文字。 使用 Markdown 設定文字輸入框的樣式。
- 若要在文字輸入框中新增靜態影像,請使用具有描述和公開可用 URL 的 Markdown 影像語法:

。 例如,下列 Markdown 會插入 Databricks 標誌的影像:
。 若要調整影像大小,請調整小工具尺寸的大小。 - 若要從 DBFS 新增影像,請新增 Markdown 影像語法,並附上所需的描述和 FileStore 路徑:

。 若要調整影像大小,請調整小工具尺寸的大小。
重要
在執行隨選 pdf 或訂用帳戶時,在 DBFS 中儲存的儀表板中使用的影像將不會呈現
- 若要在文字輸入框中新增靜態影像,請使用具有描述和公開可用 URL 的 Markdown 影像語法:
按一下 [視覺效果] 以新增查詢視覺效果。
選擇查詢。 搜尋現有的查詢,或從預先填入的清單中挑選最近的查詢。 如果查詢使用 限制 1000 設定儲存,在儀錶板中的查詢結果將被限制為 1000 行。
在 [選擇 [視覺效果] 下拉式清單中,選取視覺效果類型。
按一下 [新增至舊版儀表板]。
在儀表板中拖放內容區塊。
按一下 [完成編輯]。
也可以使用 Databricks Terraform Provider 和 databricks_sql_dashboard 建立儀表板。 可以使用 databricks_sql_widget 為舊版儀表板建立小工具。 可以使用 dbsql-nyc-taxi-trip-analysis 建立範例舊版儀表板。
複製舊版儀表板
如果對儀表板和所有上游查詢擁有 CAN RUN、CAN EDIT 和 CAN MANAGE 權限,則可以複製舊版儀表板。 您成為新儀表板和查詢的擁有者。
重要
共用設定、警示和訂用帳戶不會複製到新儀表板。
若要複製舊版儀表板:
- 開啟儀錶板右上方的
kebab 功能表,然後選取 [複製Kebab 功能表 ]。 - 輸入新儀表板的名稱,然後按一下 [確認]。
注意
複製保證能夠可靠地使用少於50個視覺效果和少於30個查詢,包括用來產生以查詢為基礎的下拉式清單參數的查詢。 嘗試複製其視覺效果或查詢超過這些限制的儀表板可能會失敗。
如需查詢型下拉式清單參數的詳細資訊,請參閱 Query-Based 下拉式清單。
在傳統儀表板中使用查詢參數
查詢可以選擇性地利用參數或靜態值。 將以參數化查詢為基礎的視覺效果新增至儀表板時,可將視覺效果設定為使用下列其中一項:
- Widget 參數:小工具參數專為儀表板中的單一視覺化設計,並出現在視覺化面板中,其指定的參數值只適用於該視覺化所依據的查詢。
- 儀錶板參數:舊版儀錶板參數可以套用至多個視覺效果。 當您根據參數化查詢將視覺效果新增至儀表板時,參數預設會被當作儀表板參數。 儀錶板參數是針對儀錶板內的一或多個視覺效果所設定,並出現在儀錶板頂端。 為儀錶板參數指定的參數值會套用至重複使用該特定儀錶板參數的視覺效果。 儀錶板可以有多個參數,每個參數都可能套用至某些視覺效果,而不是其他視覺效果。
- 靜態值:會使用靜態值,而不是響應變更的參數。 靜態值允許您使用硬編碼來取代參數,並使該參數從它先前出現的儀錶板或小工具中消失。
當您新增包含參數化查詢的視覺效果時,可以按下適當的鉛筆圖示 ,選擇視覺效果查詢中參數的標題和來源。 您也可以選取 關鍵詞和預設值。 請參閱<參數屬性>。
將視覺效果新增至儀表板之後,按一下儀表板小工具右上角的 Kebab 功能表,然後按下 [變更小工具設定],可存取參數對應介面。
參數屬性
儀表板小工具參數屬性如下:
標題:顯示在儀表板上值選取器旁邊的顯示名稱。 它預設設定為查詢編輯器中的標題設定。 若要編輯它在儀表板內的顯示方式,請按一下鉛筆圖示
。 靜態儀錶板參數不會顯示標題,因為值選取器已隱藏。 如果您選取 [靜態值] 為 [值來源],則 [標題] 字段會呈現灰色。
關鍵字:基礎查詢中此參數的字串常值。 如果您的儀表板未傳回預期的結果,這對於偵錯非常有用。
預設值:在儀表板載入時設置該參數的值,直到選擇另一個參數並套用變更為止。 若要變更此預設值,請在 SQL 編輯器中開啟基礎查詢,將參數變更為所需的值,然後按一下 [儲存] 按鈕。
值來源:參數值的來源。 按下鉛筆圖示
以選擇來源。
- 新的儀表板參數:建立新的儀表板層級參數。 這可讓您在儀錶板的一個位置設定參數值,並將其對應至一或多個視覺效果。 參數在儀錶板內必須有唯一的名稱。
- 現有的儀表板參數:將視覺效果的參數對應至現有的儀表板參數。 您必須指定哪些預先存在的儀表板參數。
- 小工具參數:在儀表板小工具內顯示值選取器。 這適用於小工具之間不共用的專屬參數。
- 靜態值:不論在其他小工具上使用的值為何,都選擇一個靜態值作為這個小工具的值。 儀錶板上的靜態對應參數值不會顯示值選取器,這使得界面更加精簡。 這可讓您利用查詢參數的彈性,而在某些參數不會經常變更時,也能保持儀錶板上的使用者介面整潔。
編輯舊版儀表板
若要開啟儀錶板進行編輯,請開啟儀錶板右上方的 ,然後選取 [編輯] 。
編輯時,您可以新增和移除內容、編輯視覺效果,以及套用篩選。 若要變更顯示參數的順序,您可以按下每個參數,並將每個參數拖曳至所需的位置。
篩選多個查詢
若要篩選儀表板上的多個查詢:
- 移至舊版儀表板。
- 在 [編輯] 模式中,按一下 [新增],然後按一下 [篩選]。
- 選取 新儀錶板篩選,然後選擇要篩選的查詢和欄位。 也可以選擇從現有的查詢匯入篩選,方法是選取 [現有的查詢篩選],然後選擇從 SQL 查詢編輯器匯入篩選。 您選擇的查詢必須屬於相同的目錄和架構。
- 按一下 [檔案] 。 這會建立包含所有下拉式選項合集的篩選條件。
注意
您選擇的查詢必須屬於相同的目錄和架構。 某些舊查詢可能無法與跨多個查詢的篩選相容。
編輯儀表板視覺效果
若要在編輯模式中編輯儀錶板上的視覺效果,請選取您想要編輯的視覺效果,然後按兩下視覺效果右上方的 Kebab功能表。 在顯示的清單中,選取 [編輯視覺效果]。
將內容加入至儀表板
- 開啟儀表板以進行編輯。
- 按一下 [新增文字輸入框] 或 [新增小工具]。
- 按一下 [新增至舊版儀表板]。
- 按一下 [完成編輯]。
也可以在 SQL 編輯器中將視覺效果新增至儀表板。
從儀錶板移除內容
- 點擊
或暫留在物件上,點擊小工具右上方的
,然後選取 [從儀錶板移除] 。
- 按一下刪除。
儀表板篩選
當查詢具有篩選條件時,也必須在儀表板層級套用篩選。 選取 [使用儀錶板層級篩選] 複選框,將篩選套用至所有查詢。
自訂儀表板色彩
可以自訂儀表板調色盤,包括建立調色盤。
建立調色盤
若要建立儀表板的自訂調色盤:
- 按一下右上方的
Kebab 功能表,然後按一下 [編輯]。
- 按一下 [色彩]。
- 若要匯入現有的調色盤,請按兩下 [匯入],然後選取調色盤。 您可以自訂匯入的調色盤。
- 若要建立新的調色盤,或自訂匯入的調色盤,請執行下列動作:
- 若要新增色彩,按一下 [新增]。
- 針對新增的色彩或現有色彩,請執行下列其中一項來指定色彩:
- 按一下方塊,然後在色彩選取器中按一下新的色彩或使用眼滴器選取新的色彩。
- 按一下正方形旁邊的文字欄位,然後輸入十六進位值。
- 按一下 套用。
停止使用自訂調色盤
若要移除自訂調色盤:
- 按一下右上方的
Kebab 功能表,然後按一下 [編輯]。
- 按一下 [色彩]。
- 按一下 [清除]。
- 按一下 套用。
使用不同的調色盤實現視覺效果
根據預設,如果儀表板中已套用調色盤,所有視覺效果都會使用該調色盤。 如果想要對視覺效果使用不同的色彩,可以覆寫此行為:
- 按一下儀表板中視覺效果的
Kebab 功能表,然後按一下 [編輯]。
- 按一下 [保留視覺效果中指定的色彩] 旁邊的複選框。
- 按一下 [確定]。
重新整理儀錶板
舊版儀表板專為高效載入而設計,因為它們會從每次執行查詢時更新的快取中擷取資料。 不過,如果不定期執行相關聯的查詢,儀表板可能會過時。 為了防止儀錶板過時,您可以重新整理儀錶板,這樣即可重新執行相關查詢。
每次手動或按排程重新整理儀表板時,儀表板中參考的所有查詢都會重新整理。 重新整理個別視覺效果時,會重新整理上游查詢。 手動重新整理儀表板或個別視覺化圖表,不會重新整理在查詢式下拉選單中使用的查詢。 如需以查詢為基礎的下拉式清單的詳細資訊,請參閱 Query-Based 下拉式清單。
重新整理行為和執行內容
當儀表板為「以擁有者身分執行」並新增排程時,會使用擁有者的認證來執行,而至少具有 CAN RUN 權限的任何人都可以看到這些重新整理查詢的結果。
當儀錶板以「檢視者身份執行」且已新增排程時,擁有者的認證會用於執行,但只有擁有者會看到重新整理查詢的結果。其他檢視者必須手動重新整理,才能查看更新的查詢結果。
手動更新儀表板
若要強制重新整理,請點選儀錶板右上角的 重新整理。 這會執行所有儀表板查詢,並更新其視覺效果。
自動重新整理儀錶板
具有 CAN EDIT 許可權的儀錶板擁有者和使用者可以設定儀錶板,以依排程自動重新整理。 若要自動重新整理儀表板:
按一下儀表板右上角的 [排程]。 然後,按一下 [加入排程]。
使用下拉式選擇器來指定頻率、期間、開始時間和時區。 選擇性地選取 [顯示 cron 語法] 複選框,以使用 [Quartz 克朗語法] 編輯排程。
選擇 [更多選項] 以顯示可選設定。 您可以選擇:
- 排程的名稱。
- 用來為查詢提供支援的 SQL 倉儲。 根據預設,用於特別查詢執行的 SQL 倉儲也可用於已排程的工作。 使用此選擇性設定來選取不同的倉儲來執行排程查詢。
注意
此倉儲可能不同於用於手動重新整理的倉儲。
選用:在 [訂閱者] 標籤中,輸入自動更新儀表板時要通知的電子郵件地址清單。 每個電子郵件地址都必須與具有工作區存取權的 Azure Databricks 帳戶相關聯,或定義為工作區設定中的通知目的地。 通知目的地由工作區管理員所設定。
按一下 [建立]。 [排程] 標籤變更為 [排程 (1)]。
編輯共用設定。
注意
儀表板權限不會連結到排程權限。 建立排程重新整理間隔之後,請編輯排程許可權以提供其他使用者的存取權。 只有 CAN MANAGE 許可權的使用者可以編輯排程或編輯訂閱者清單。
- 按一下
kebab 功能表。
- 按一下 [編輯排程權限]。
- 從對話方塊的下拉式功能表中選擇使用者或群組。
- 選擇 CAN VIEW 以允許選取的使用者檢視已排程的組態。
- 按一下
CAN VIEW 或 CAN RUN 權限可讓指派的收件者查看排程是否存在,以及諸如報表頻率和訂閱者數目等其他屬性。 CAN MANAGE 可讓收件者修改排程、訂閱者清單和排程許可權。 CAN MANAGE 權限也允許收件者暫停或取消暫停排程。
開啟中的儀錶板上的刷新行為
當您開啟設為 Run as Owner
的儀錶板時,無論更新是排程還是手動進行,顯示的都是最新儀錶板更新的資料。 如果在瀏覽器視窗中開啟儀錶板,而且查詢已被修改或排程的執行更新了儀錶板結果,則變更不會立即顯示。 下次開啟儀表板或者重新整理瀏覽器視窗時,更新後的結果將會顯示出來。
儀表板快照訂用帳戶
您可以定期匯出和透過電子郵件傳送儀表板快照。 儀表板快照是在預設儀表板狀態擷取,這表示與篩選和視覺效果的任何互動都不會包含在快照內。
如果您有至少 CAN EDIT 許可權,您可以建立重新整理排程並訂閱其他使用者,每次重新整理儀錶板時,他們都會收到儀錶板的電子郵件快照集。 若要新增訂閱者,請在 [訂閱者] 索引標籤中輸入使用者或群組,如上所述。 合格的訂閱者包括工作區使用者和通知目的地。
注意
通知目的地由工作區管理員所設定。若要瞭解如何設定通知目的地,請參閱<管理通知目的地>。
電子郵件附件有 6 MB 的檔案大小限制。 如果儀錶板訂閱電子郵件超過 6 MB 大小限制,電子郵件將會省略內嵌儀錶板快照集,並只包含儀錶板快照集的 PDF。
如果 PDF 快照檔案超過 6 MB,訂用帳戶電子郵件將會忽略 PDF,並改為包含已重新整理的儀表板連結。 電子郵件會有詳細說明目前儀表板大小的警告附註。 (使用者可以手動下載儀表板的 PDF 來測試 PDF 快照大小。)
臨時暫停已排程的儀表板更新
如果儀錶板已設定為自動更新,而且您至少具有排程的 CAN VIEW 許可權,則 [
- 按一下 [Schedule(#)]。
- 按一下
kebab 功能表。
- 按一下 [暫停]。
停止自動更新儀表板
若要停止自動更新儀錶板,並移除其訂用帳戶:
- 按一下 [Schedule(#)]。
- 按一下
Kebab 功能表>[刪除]。
注意
您至少必須擁有排程的 CAN MANAGE 權限,才能將其刪除。
訂用帳戶的儀表板大小限制
舊版儀表板訂用帳戶電子郵件包含下列 base64 編碼檔案:
- PDF:包含完整儀表板的 PDF 檔案。
- DesktopImage:針對在桌上型電腦中檢視而最佳化的影像檔。
6MB 的最大限制會加在兩個檔案的合併大小上。 下列描述概述合併的檔案大小超過限制時的預期行為:
- 如果 PDF 檔案大於 6MB:訂用帳戶電子郵件不包含 PDF 附件或任何影像。 其中包含一則附註,指出儀錶板已超過大小限制,並顯示目前儀錶板的實際檔案大小。
- 如果合併檔案大小大於 6MB:只有 PDF 會附加至電子郵件。 內嵌訊息包含儀表板的連結,但沒有影像。
下載為 PDF
若要將儀錶板下載為 PDF 檔案,請單擊儀錶板右上方的 [
將舊版儀表板移至垃圾桶
若要將儀表板移至 [垃圾桶],請執行下列動作:
- 點擊器表板右上方的
kebab 選單,然後選取 [[移至垃圾桶]。
- 然後,按一下 [移至垃圾桶] 進行確認。
注意
在 2024 年 9 月 3 日左右移至垃圾桶的舊版儀表板可能仍會出現在舊版儀表板清單頁面中。 不會顯示永久刪除的儀表板。
從回收站還原舊版資訊面板
- 按下側邊欄中的
[工作區]。
- 按一下工作區瀏覽器中的
[垃圾桶] 以檢視所包含的資產。
- 單擊您想要還原之儀錶板旁的
kebab 功能表。
- 點擊 [還原]。 [移動] 對話方塊隨即出現。
- 使用 [移動] 對話方塊,為還原的儀表板選擇新位置。
永久刪除舊版儀表板
- 按下側邊欄中的
[工作區]。
- 按一下工作區瀏覽器中的 [垃圾桶] 以檢視所包含的資產。
- 單擊您想要刪除的儀錶板旁的
Kebab 功能表。
- 按一下 [永久刪除]。
- 按一下 [刪除] 進行確認。
注意
根據預設,垃圾桶資料夾中的儀表板會在 30 天後永久刪除。 使用此選項可立即永久刪除儀表板。
開啟查詢
若要開啟 SQL 編輯器中小工具中顯示的查詢,請按下小工具右上方的 [ Kebab 選單,然後選取 [檢視查詢]。
設定舊版儀表板權限和儀表板所有權
您在儀表板上必須擁有 CAN MANAGE 權限,才能設定權限。對於儀表板權限等級,請參閱<舊版儀表板 ACL>。
- 在側邊欄中,按一下 [儀表板]。
- 按一下儀表板。
- 按下左上方的
按鈕來開啟 [共用] 對話方塊。
- 搜尋並選取群組或使用者,並指派許可權等級。
- 將憑證設為,然後以檢視模式執行 以指派「可編輯」或「可管理」許可權。
- 按一下新增。
按一下齒輪圖示並選取 [共用所有查詢],可快速共用與儀表板相關聯的所有查詢。 儀表板所參考的查詢具有單獨權限,在共用儀表板時預設不可共用。
轉移舊版儀表板的擁有權
如果已從工作區中移除儀表板的擁有者,則儀表板就不再有擁有者。 工作區管理員使用者可以將任何儀表板的所有權轉移給不同的使用者,包括沒有擁有者的儀表板。 無法為群組指派儀表板所有權。 您也可以使用 權限 API 來轉移所有權。
身為工作區管理員,登入您的 Azure Databricks 工作區。
在側邊欄中,按一下 [儀表板]。
按一下儀表板。
按下右上方的 [共用] 按鈕,以開啟 [共用] 對話方塊。
按下右上方的 [齒輪] 圖示,然後按下 [指派新擁有者]。
選取要指派擁有權的使用者。
按一下 [確認]。
存取管理員檢視
Azure Databricks 工作區管理員使用者擁有工作區中所有儀表板的檢視存取權。 在此檢視中,工作區管理員可以檢視及刪除任何儀表板。 不過,當共用設定認證設為 [以擁有者身分執行]時,工作區系統管理員無法編輯儀錶板。
若要檢視所有舊版儀表板:
- 按一下側邊欄中的
[儀表板]。
- 按一下 [舊版儀表板] 索引標籤。
- 按一下畫面頂端附近的 [所有儀表板] 索引標籤。