更新為最新的 Databricks SQL API 版本

本文說明最新版 Databricks SQL API 中包含的查詢、警示、許可權和數據源 API 變更。 使用本文可協助您將應用程式和整合移轉至新的 API 版本。

舊版 API 將持續支援六個月。 此轉換期間可讓您在淘汰舊版之前移轉。

查詢 API 的變更

新的查詢 API 包含更方便使用的體驗，其中包含更具描述性的名稱、編頁回應，以及依建立時間自動排序的清單回應。 下列清單描述查詢 API 的變更：

• API 路徑現在是 api/2.0/sql/queries，取代的 /api/2.0/preview/sql/queries舊版路徑。
• 包含具有更描述性功能變數名稱和類型的新查詢定義。
• 更新端點現在支援部分更新，方法是使用 PATCH 而非 POST。
• 更新端點現在支援傳輸查詢的擁有權。 先前，這隻允許使用 傳輸對象擁有權 API。
• 清單端點回應現在會使用以令牌為基礎的分頁進行分頁。
• 清單端點不再支援依名稱或自定義排序進行篩選。 相反地，所有可存取的查詢都會依建立時間以遞增順序傳回和排序。
• 不再支援還原端點。 已回收的查詢可以透過 Azure Databricks UI 繼續還原。

如需更新查詢 API 的完整檔，請參閱 查詢。

警示 API 的變更

新的警示 API 包含更方便使用的體驗，其中包含更描述性的功能變數名稱和類型、列出端點的編頁回應，以及部分更新的支援。 下列清單描述警示 API 的變更：

• API 路徑現在是 api/2.0/sql/alerts，取代的 /api/2.0/preview/sql/alerts舊版路徑。
• 包含具有更具描述性功能變數名稱和類型的新警示定義。
• 更新端點現在支援部分更新，方法是使用 PATCH 而非 POST。
• 更新端點現在支援傳輸查詢的擁有權。 先前，這隻允許使用 傳輸對象擁有權 API。
• 清單端點回應現在會使用以令牌為基礎的分頁進行分頁。
• 刪除端點現在會將警示移至垃圾桶，而不是永久刪除警示。 垃圾警示會在 30 天后自動清除。 您可以透過 Azure Databricks UI 在刪除後的 30 天內還原垃圾警示。

如需更新警示 API 的完整檔，請參閱 警示。

許可權 API 的變更

許可權 API 不再支援 Get 物件 ACL 和 Set 物件 ACL。 使用工作區 API 來管理這些動作的許可權。

標示為舊版的數據源 API

數據源 API 現在標示為舊版。 目前，其功能僅限於取得 SQL 倉儲清單。 由於新的查詢 API 支援傳入和傳回 SQL 倉儲標識碼，而不是數據源標識碼，因此不再需要在數據源與 SQL 倉儲之間轉換的個別 API 呼叫。