共用方式為

舊版儀表板

  • 發行項

您可以使用 SQL 編輯器來建置舊版儀表板，它可結合視覺效果和文字輸入框來提供資料內容。

重要

  • Databricks 建議使用 AI/BI 儀表板 (先前稱為 Lakeview 儀表板)。
  • 原始 Databricks SQL 儀表板現在稱為 舊版儀表板。 它們會繼續收到重大錯誤修復，但不會使用新功能更新。 舊版儀表板預計將在 2025 年底達到生命週期結束。 Databricks 不建議建立新的舊版儀表板。

檢視及組織舊版儀表板

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

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

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

  • 按一下 [舊版儀表板] 索引標籤以檢視舊版儀表板。

    根據預設，會選取 [我的儀表板] 並按時間倒序顯示您擁有的儀表板。 按一下標題處的 [建立時間]，對清單重新排序。 或者，使用頁面頂端附近的索引標籤來檢視 [我的最愛] 或 [所有儀表板]。 使用 [標籤] 索引標籤依標籤篩選。

將儀表板組織到工作區瀏覽器中的資料夾

可以將新的和現有的儀表板連同其他 Azure Databricks 物件一起組織到工作區瀏覽器中的資料夾。 請參閱<工作區瀏覽器>。

篩選已儲存的儀表板清單

依據您建立的儀表板 (我的儀表板)、我的最愛和標籤，篩選所有儀表板清單。

建立舊版儀表板

請遵循下列步驟來建立新的舊版儀表板。 若要複製現有儀表板，請參閱複製舊版儀表板。

  1. 按一下側邊欄中的 儀表板圖示 [儀表板]，然後按一下 [舊版儀表板] 索引標籤。
  2. 按一下 [建立舊版儀表板]。
  3. 輸入儀表板的名稱。
  4. 當您建立儀表板時，可以選擇指定要用於手動重新整理的倉儲。 如果您未選取倉儲並將其儲存至儀表板，則會退回去使用為單獨查詢所儲存的倉儲。

注意

如果您選取倉儲並將其儲存至儀表板，然後刪除或變得無法使用，則手動重新整理將會失敗，直到指派新的倉儲為止。

  1. 按一下 [新增] 並選取要新增的內容類型，將內容新增至儀表板：

    • 按一下 [文字輸入框] 以新增評論。

      輸入文字。 使用 Markdown 設定文字輸入框的樣式。

      • 若要在文字輸入框中新增靜態影像，請使用具有描述和公開可用 URL 的 Markdown 影像語法：![description](url)。 例如，下列 Markdown 會插入 Databricks 標誌的影像：![The Databricks Logo](https://upload.wikimedia.org/wikipedia/commons/6/63/Databricks_Logo.png)。 若要調整影像大小，請調整小工具尺寸的大小。
      • 若要從 DBFS 新增影像，請新增 Markdown 影像語法，並附上所需的描述和 FileStore 路徑：![description](files/path_to_dbfs_image)。 若要調整影像大小，請調整小工具尺寸的大小。

      重要

      在執行隨選 pdf 或訂用帳戶時，在 DBFS 中儲存的儀表板中使用的影像將不會呈現

    • 按一下 [視覺效果] 以新增查詢視覺效果。

      1. 選取查詢。 搜尋現有查詢，或從預先填入的清單中挑選最近的查詢。 如果查詢儲存時帶有 [限制 1000] 的設定，則儀表板中的查詢會將結果限製為 1000 個資料列。

      2. 在 [選擇視覺效果] 下拉式清單中，選取視覺效果類型。

        新增至儀表板

  2. 按一下 [新增至舊版儀表板]。

  3. 在儀表板中拖放內容區塊。

  4. 按一下 [完成編輯]。

    完成儀表板

也可以使用 Databricks Terraform Provider 和 databricks_sql_dashboard 建立儀表板。 可以使用 databricks_sql_widget 為舊版儀表板建立小工具。 可以使用 dbsql-nyc-taxi-trip-analysis 建立範例舊版儀表板。

複製舊版儀表板

如果對儀表板和所有上游查詢擁有 CAN RUN、CAN EDIT 和 CAN MANAGE 權限，則可以複製舊版儀表板。 您成為新儀表板和查詢的擁有者。

重要

共用設定、警示和訂用帳戶不會複製到新儀表板。

若要複製舊版儀表板：

  1. 開啟儀表板右上方的 Kebab 功能表 Kebab 功能表，然後選取 [複製]。
  2. 輸入新儀表板的名稱，然後按一下 [確認]。

注意

保證複製能夠可靠地運作，且擁有少於 50 個視覺效果和少於 30 個查詢，包括用來生成以查詢為基礎的下拉式清單參數的查詢。 嘗試複製其視覺效果或查詢超過這些限制的儀表板可能會失敗。

如需查詢型下拉式清單參數的詳細資訊，請參閱《查詢型下拉式清單》。

在舊版儀表板中使用查詢參數

查詢可選擇利用參數或靜態值。 將以參數化查詢為基礎的視覺效果新增至儀表板時，可將視覺效果設定為使用下列其中一項：

  • 小工具參數：小工具參數專屬於儀表板中的單一視覺效果，顯示在視覺效果面板中，而指定的參數值僅會套用至視覺效果底層的查詢。
  • 儀表板參數：舊版儀表板參數可套用至多個視覺效果。 當您根據參數化查詢將視覺效果新增至儀表板時，參數預設會被當作儀表板參數。 針對儀表板中的一個或多個視覺效果設定儀表板參數，並出現在儀表板頂端。 為儀表板參數指定的參數值會套用至重複使用該特定儀表板參數的視覺效果。 儀表板可以有多個參數，每個參數都可以套用至某些視覺效果，而不適用於其他。
  • 靜態值：會使用靜態值，而非回應變更的參數。 靜態值可讓您對一個值進行硬式編碼來取代參數，並讓參數從先前出現的儀表板或小工具中「消失」。

當您新增包含參數化查詢的視覺效果時，可以按下適當的鉛筆圖示 [鉛筆] 圖示，選擇視覺效果查詢中參數的標題和來源。 您也可以選取關鍵字和預設值。 請參閱<參數屬性>。

參數對應

將視覺效果新增至儀表板之後，按一下儀表板小工具右上角的 Kebab 功能表 Kebab 功能表，然後按下 [變更小工具設定]，可存取參數對應介面。

開啟儀表板參數對應

變更參數對應檢視

參數屬性

儀表板小工具參數屬性如下：

  • 標題：顯示在儀表板上值選取器旁邊的顯示名稱。 它預設為查詢編輯器中設定的標題。 若要編輯它在儀表板內的顯示方式，請按一下鉛筆圖示 [鉛筆] 圖示。 靜態儀表板參數不會顯示標題，因為值選取器已隱藏。 如果選取 [靜態值] 作為 [值來源]，[標題] 欄位會呈現灰色。

  • 關鍵字：基礎查詢中此參數的字串常值。 如果您的儀表板未傳回預期的結果，這對於偵錯非常有用。

  • 預設值：在儀表板上為該參數設定的值會載入，直到選取另一個參數並套用變更為止。 若要變更此預設值，請在 SQL 編輯器中開啟基礎查詢，將參數變更為所需的值，然後按一下 [儲存] 按鈕。

  • 值來源：參數值的來源。 按下鉛筆圖示 [鉛筆] 圖示 以選擇來源。

    • 新的儀表板參數：建立新的儀表板層級參數。 這可讓您在儀表板的一個位置設定參數值，並將其對應至一個或更多視覺效果。 參數在儀表板內必須擁有唯一的名稱。
    • 現有的儀表板參數：將視覺效果的參數對應至現有的儀表板參數。 您必須指定哪些預先存在的儀表板參數。
    • 小工具參數：在儀表板小工具內顯示值選取器。 這適用於在小工具之間不共用的一次性參數。
    • 靜態值：不論在其他小工具上使用的值為何，均選擇小工具的靜態值。 靜態對應的參數值不會在儀表板上任何位置顯示值選取器，更為精簡。 當某些參數預期不會經常變更時，這可讓您充分利用查詢參數的彈性，而不會使儀表板上的使用者介面雜亂無章。

    變更參數對應

編輯舊版儀表板

若要開啟要編輯的儀表板，請開啟儀表板右上方的 Kebab 功能表 Kebab 功能表，然後選取 [編輯]。

編輯儀表板

編輯時，可以新增和移除內容、編輯視覺效果，以及套用篩選。 若要變更顯示參數的順序，可以按下每個參數，並將每個參數拖曳至所需的位置。

篩選多個查詢

若要篩選儀表板上的多個查詢：

  1. 移至舊版儀表板。
  2. 在 [編輯] 模式中，按一下 [新增]，然後按一下 [篩選]。
  3. 選取 [新增儀表板篩選]，然後選擇要篩選的查詢和資料行。 也可以選擇從現有的查詢匯入篩選，方法是選取 [現有的查詢篩選]，然後選擇從 SQL 查詢編輯器匯入篩選。 選擇的查詢必須屬於相同的目錄和結構描述。
  4. 按一下 [檔案] 。 這會建立包含所有下拉式選項合集的篩選條件。

注意

選擇的查詢必須屬於相同的目錄和結構描述。 某些舊查詢可能無法與跨多個查詢的篩選相容。

編輯儀表板視覺效果

若要在編輯模式中編輯儀表板上的視覺效果，請選取您想要編輯的視覺效果，然後按一下視覺效果右上方的 Kebab 功能表 Kebab 功能表。 在顯示的清單中，選取 [編輯視覺效果]。

編輯視覺效果

將內容加入至儀表板

  1. 開啟儀表板以進行編輯。
  2. 按一下 [新增文字輸入框] 或 [新增小工具]。
  3. 按一下 [新增至舊版儀表板]。
  4. 按一下 [完成編輯]。

也可以在 SQL 編輯器中將視覺效果新增至儀表板。

從儀表板移除內容

  1. 按一下 SQL [刪除] 圖示 或將滑鼠停留在物件上，按一下小工具右上方的 Kebab 功能表 Kebab 功能表，然後選取 [從儀表板移除]。
  2. 按一下刪除。

儀表板篩選

當查詢具有篩選條件時，也必須在儀表板層級套用篩選。 選取 [使用儀表板層級篩選] 核取方塊，將篩選套用至所有查詢。

自訂儀表板色彩

可以自訂儀表板調色盤，包括建立調色盤。

建立調色盤

若要建立儀表板的自訂調色盤：

  1. 按一下右上方的 Kebab 功能表 Kebab 功能表，然後按一下 [編輯]。
  2. 按一下 [色彩]。
  3. 若要匯入現有的調色盤，請按一下 [匯入] 並選取調色盤。 您可以自訂匯入的調色盤。
  4. 若要建立新的調色盤，或自訂匯入的調色盤，請執行下列動作：
    1. 若要新增色彩，按一下 [新增]。
    2. 針對新增的色彩或現有色彩，請執行下列其中一項來指定色彩：
      • 按一下正方形，然後按一下色彩選取器或使用色彩選擇工具來選取新色彩。
      • 按一下正方形旁邊的文字欄位，然後輸入十六進位值。
  5. 按一下 套用。

停止使用自訂調色盤

若要移除自訂調色盤：

  1. 按一下右上方的 Kebab 功能表 Kebab 功能表，然後按一下 [編輯]。
  2. 按一下 [色彩]。
  3. 按一下 [清除]。
  4. 按一下 套用。

使用不同的調色盤實現視覺效果

根據預設，如果儀表板中已套用調色盤，所有視覺效果都會使用該調色盤。 如果想要對視覺效果使用不同的色彩，可以覆寫此行為：

  1. 按一下儀表板中視覺效果的 Kebab 功能表 Kebab 功能表，然後按一下 [編輯]。
  2. 按一下 [保留視覺效果中指定的色彩] 旁邊的複選框。
  3. 按一下 [確定]。

重新整理儀表板

舊版儀表板專為高效載入而設計，因為它們會從每次執行查詢時更新的快取中擷取資料。 不過，如果不定期執行相關聯的查詢，儀表板可能會過時。 若要防止儀表板過時，可以重新整理儀表板以重新執行相關聯的查詢。

每次手動或按排程重新整理儀表板時，儀表板中參考的所有查詢都會重新整理。 重新整理個別視覺效果時，會重新整理上游查詢。 手動重新整理儀表板或個別視覺效果不會重新整理在查詢型下拉式清單中使用的查詢。 如需有關查詢型下拉式清單的詳細資訊，請參閱《查詢型下拉式清單》。

重新整理行為和執行內容

當儀表板為「以擁有者身分執行」並新增排程時，會使用擁有者的認證來執行，而至少具有 CAN RUN 權限的任何人都可以看到這些重新整理查詢的結果。

當儀表板為「以檢視人員身分執行」且已新增排程時，擁有者的認證會用於執行，但只有擁有者會看到重新整理查詢的結果；所有其他檢視人員都必須手動重新整理，才能查看更新後的查詢結果。

手動重新整理儀表板

若要強制重新整理，請按一下儀表板右上角的 [重新整理]。 這會執行所有儀表板查詢，並更新其視覺效果。

自動重新整理儀表板

具有 CAN EDIT 權限的儀表板擁有者和使用者可以設定儀表板，以按排程自動重新整理。 若要自動重新整理儀表板：

  1. 按一下儀表板右上角的 [排程]。 然後，按一下 [加入排程]。

  2. 使用下拉式選擇器來指定頻率、期間、開始時間和時區。 您可以選擇性地選取 [顯示 cron 語法] 核取方塊，在 [Quartz Cron 語法] 中編輯排程。

  3. 選擇 [更多選項] 以顯示可選設定。 您可以選擇：

    • 排程的名稱。
    • 用來為查詢提供支援的 SQL 倉儲。 根據預設，用於特別查詢執行的 SQL 倉儲也可用於已排程的工作。 使用此可選設定來選取不同的倉儲以執行排程查詢。

    注意

    此倉儲可能不同於用於手動重新整理的倉儲。

  4. 選用：在 [訂閱者] 索引標籤中，輸入自動更新儀表板時要通知的電子郵件地址清單。 每個電子郵件地址都必須與具有工作區存取權的 Azure Databricks 帳戶相關聯，或定義為工作區設定中的通知目的地。 通知目的地由工作區管理員所設定。

  5. 按一下 [建立]。 [排程] 標籤變更為 [排程 (1)]。

  6. 編輯共用設定。

    注意

    儀表板權限不會連結到排程權限。 建立已排程的重新整理間隔之後，請編輯排程權限以提供其他使用者的存取權。 只有擁有 CAN MANAGE 權限的使用者可以編輯排程或編輯訂閱者清單。

    • 按一下 Kebab 功能表 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 快照大小。)

臨時暫停已排程的儀表板更新

如果儀表板已設定為自動更新，而且您至少擁有 SCHEDULE VIEW 排程權限，則 [排程] 按鈕上的標籤會讀取 Schedule(#)，其中 # 是您看到的排程事件數目。 此外，如果您對排程至少擁有 CAN MANAGE 權限，則可以臨時暫停排程。 這有助於避免在測試儀表板的變更時傳送更新。 若要臨時暫停已排程的儀表板更新，而不需修改訂閱者清單：

  1. 按一下 [Schedule(#)]。
  2. 按一下 Kebab 功能表 kebab 功能表。
  3. 按一下 [暫停]。

停止自動更新儀表板

若要停止自動更新儀表板，並移除其訂用帳戶：

  1. 按一下 [Schedule(#)]。
  2. 按一下 Kebab 功能表 Kebab 功能表>[刪除]。

注意

您至少必須擁有排程的 CAN MANAGE 權限，才能將其刪除。

訂用帳戶的儀表板大小限制

舊版儀表板訂用帳戶電子郵件包含下列 base64 編碼檔案：

  • PDF：包含完整儀表板的 PDF 檔案。
  • DesktopImage：針對在桌上型電腦中檢視而最佳化的影像檔。

兩個檔案的合併大小上限為 6MB。 下列描述概述合併檔案大小超過限制時的預期行為：

  • 如果 PDF 檔案大於 6MB：訂用帳戶電子郵件不包含 PDF 附件或任何影像。 它包含一則附註，指出儀表板已超過大小限制，並顯示目前儀表板的實際檔案大小。
  • 如果合併檔案大小大於 6MB：只有 PDF 會附加至電子郵件。 內嵌訊息包含儀表板的連結，但沒有影像。

下載為 PDF

若要將儀表板下載為 PDF 檔案，請按一下儀表板右上方的 Kebab 功能表 Kebab 功能表，然後選取 [下載為 PDF]。

將舊版儀表板移至垃圾桶

若要將儀表板移至 資源回收筒 [垃圾桶]，請執行下列動作：

  1. 按一下儀表板右上方的 Kebab 功能表 Kebab 功能表，然後選取 [移至垃圾桶]。
  2. 然後，按一下 [移至垃圾桶] 進行確認。

注意

在 2024 年 9 月 3 日左右移至垃圾桶的舊版儀表板可能仍會出現在舊版儀表板清單頁面中。 不會顯示永久刪除的儀表板。

從垃圾桶中還原舊版儀表板

  1. 按下側邊欄中的 工作區圖示 [工作區]。
  2. 按一下工作區瀏覽器中的 資源回收筒 [垃圾桶] 以檢視所包含的資產。
  3. 按一下您要還原之儀表板旁邊的 Kebab 功能表 Kebab 功能表。
  4. 按一下 [還原]。 [移動] 對話方塊隨即出現。
  5. 使用 [移動] 對話方塊，為還原的儀表板選擇新位置。

永久刪除舊版儀表板

  1. 按下側邊欄中的 工作區圖示 [工作區]。
  2. 按一下工作區瀏覽器中的 [垃圾桶] 以檢視所包含的資產。
  3. 按一下您要還原之儀表板旁邊的 Kebab 功能表 Kebab 功能表。
  4. 按一下 [永久刪除]。
  5. 按一下 [刪除] 進行確認。

注意

根據預設，垃圾桶資料夾中的儀表板會在 30 天後永久刪除。 使用此選項可立即永久刪除儀表板。

開啟查詢

若要開啟 SQL 編輯器小工具中顯示的查詢，請按一下小工具右上角的 Kebab 功能表 Kebab 功能表，然後選取 [檢視查詢]。

設定舊版儀表板權限和儀表板所有權

您在儀表板上必須擁有 CAN MANAGE 權限，才能設定權限。對於儀表板權限等級，請參閱<舊版儀表板 ACL>。

  1. 在側邊欄中，按一下 [儀表板]。
  2. 按一下儀表板。
  3. 按下左上方的 共用按鈕 按鈕來開啟 [共用] 對話方塊。 管理儀表板權限
  4. 搜尋並選取群組和使用者，並指派權限等級。
    1. 將認證設定為 [以檢視人員身分執行] 以指派 CAN EDIT 或 CAN MANAGE 權限。
  5. 按一下新增。

按一下齒輪圖示並選取 [共用所有查詢]，可快速共用與儀表板相關聯的所有查詢。 儀表板所參考的查詢具有單獨權限，在共用儀表板時預設不可共用。

轉移舊版儀表板的擁有權

如果已從工作區中移除儀表板的擁有者，則儀表板就不再有擁有者。 工作區管理員使用者可以將任何儀表板的所有權轉移給不同的使用者，包括沒有擁有者的儀表板。 無法為群組指派儀表板所有權。 您也可以使用 權限 API 來轉移所有權。

  1. 身為工作區管理員，登入您的 Azure Databricks 工作區。

  2. 在側邊欄中，按一下 [儀表板]。

  3. 按一下儀表板。

  4. 按下右上方的 [共用] 按鈕，以開啟 [共用] 對話方塊。

  5. 按下右上方的 [齒輪] 圖示，然後按下 [指派新擁有者]。

    指派新的擁有者

  6. 選取您想要指派所有權的使用者或群組。

  7. 按一下確認。

存取管理員檢視

Azure Databricks 工作區管理員使用者擁有工作區中所有儀表板的檢視存取權。 在此檢視中，工作區管理員可以檢視及刪除任何儀表板。 不過，當共用設定認證設為 [以擁有者身分執行] 時，工作區管理員無法編輯儀表板。

若要檢視所有舊版儀表板：

  1. 按一下側邊欄中的 儀表板圖示 [儀表板]。
  2. 按一下 [舊版儀表板] 索引標籤。
  3. 按一下畫面頂端附近的 [所有儀表板] 索引標籤。