將舊版儀錶板複製到 Lakeview 儀錶板

注意

儀錶板（先前稱為 Lakeview 儀錶板）現已正式推出。

Azure Government 區域中無法使用儀錶板。 使用 舊版儀錶板。

• Azure Databricks 建議使用最新的工具撰寫新的儀錶板。 請參閱 儀錶板。
• 原始 Databricks SQL 儀錶板現在稱為 舊版儀錶板。 它們將會繼續受到支援，並透過重大錯誤修正進行更新，但新功能會受到限制。 您可以繼續使用舊版儀錶板來進行撰寫和取用。
• 使用移轉工具或 REST API 轉換舊版儀錶板。 如需使用內建移轉工具的指示，請參閱 將舊版儀錶板複製到 Lakeview 儀錶板 。 如需使用 REST API 建立和管理儀錶板的教學課程，請參閱 使用 Azure Databricks API 來管理儀錶板 。

本文說明如何藉由複製現有的舊版儀錶板來建立新的草稿儀錶板。 複製到 Lakeview 儀錶板 是 UI 中的功能表選項，可簡化轉換程式。

使用此按鈕來建立新的儀錶板不會影響原始的舊版儀錶板或查詢。 相反地，此程式會使用基礎查詢和小工具設定來建立對等的儀錶板。

注意

儀錶板（先前稱為 Lakeview 儀錶板）不支援所有舊版儀錶板功能。 請參閱 儀錶板 以瞭解可用的功能。

所需的權限

您至少必須擁有舊版儀錶板和所有上游查詢的許可權，包括支援以查詢為基礎的下拉式清單參數。 舊版儀錶板會分別處理 Databricks SQL 查詢和儀錶板的許可權。 上游查詢的許可權不足會導致複製作業失敗。

複製到儀錶板

下列動畫顯示成功的轉換。

完成下列步驟以複製儀錶板：

1. 按兩下 [ 複製到 Lakeview 儀錶板]。

   您可以從 UI 中的下列區域存取 [複製到 Lakeview 儀錶板 ] 選項：

   • 工作區檔案瀏覽器。

     以滑鼠右鍵按兩下儀錶板標題，然後按兩下 [ 複製到 Lakeview 儀錶板]。 或者，使用 Kebab 功能表來存取相同的選項。

   • 舊版儀錶板。

     • 檢視已儲存的儀錶板時：從現有舊版儀錶板上的Kebab功能表單擊 [複製到Lakeview 儀錶板]。

     • 編輯儲存的儀錶板時：按兩下畫面右上角附近的 [ 複製到Lakeview ]。

       

2. （選擇性）指定新儀錶板的標題和資料夾位置。

   根據預設，您會將新儀錶板儲存在與原始舊版儀錶板相同的資料夾中，並將 [Lakeview] 附加至原始標題。 在這個階段，您可以重新整理新的儀錶板，並選擇不同的目的地資料夾。

3. 按一下 [複製]。

   

作業完成之後，請在畫面右上角尋找通知。 使用連結流覽至新的儀錶板。

檢閱複製的儀錶板結果

成功的複製作業會建立新的草稿儀錶板。 現有的舊版儀錶板和相關查詢保持不變。 這兩個儀錶板無關。 更新 至某個儀錶板不會影響另一個儀錶板。

新的儀錶板會建立為草稿。 它會繼承資料夾層級所套用的任何共享許可權。 不會傳播來源儀錶板上設定的許可權。

不論原始舊版儀錶板中現有的認證設定為何，所有儀錶板草稿都會自動被授 與執行身分查看器 認證。 當您發佈儀錶板時，您可以選擇內嵌認證。 這會影響其他使用者如何檢視及與您的儀錶板互動。 請參閱 儀錶板 ACL ，以瞭解如何共用和管理已發佈儀錶板的許可權。

調整舊版參數

儀錶板（先前稱為 Lakeview 儀錶板）提供有限的參數支援。 不支援個別小工具參數篩選。 不支援下列參數類型：

• 下拉式清單
• 以查詢為基礎的下拉式清單
• 日期範圍

所有支持的參數類型都會保存在新的儀錶板中。 不支援的參數類型預設為 string 值。 先前設定的預設值會保留。

使用參數小工具

在複製作業期間，所有舊版儀錶板層級參數小工具都會轉換成篩選，並出現在新儀錶板 Canvas 的頂端。 日期和時間參數小工具會新增為 日期選擇器 篩選，而所有其他類型的參數小工具都會轉換成 單一值 篩選。

當您複製包含具有參數的查詢的儀錶板時，複製會成功重新建立目標查詢，但必須調整查詢，才能使用具名參數語法來成功。 請參閱 [_] （/sql/language-manual/sql-ref-parameter-marker。md # named-parameter-markers）。 您必須更新相關數據集查詢中的語法，以清除參數篩選小工具中顯示的錯誤訊息。 以滑鼠右鍵按兩下小工具，以開啟和編輯連接的數據集查詢。

在數據集中使用參數

在 [ 數據] 索引標籤上，開啟您要編輯的數據集。 在轉換時，舊版儀錶板中所使用查詢的所有鬍子參數 （{{ }}） 都會自動新增至 UI 中顯示的參數集合。

疑難解答和手動調整

儀錶板（先前稱為 Lakeview 儀錶板）不支援舊版儀錶板中所有可用的功能或圖表類型。 當您複製具有不支援元素的舊版儀錶板時，新儀錶板上的小工具會顯示錯誤訊息，而不是原始小工具的複本。 通常，轉換不支持的視覺效果或篩選時會發生錯誤。 請參閱 在畫布 上新增或移除視覺效果、文字和篩選小工具，以了解支援哪些視覺效果和篩選。

請參閱 儀錶板視覺效果類型 ，以瞭解如何使用儀錶板中支援的圖表類型。