Unity Gateway 中文指南
Databricks / Unity Gateway / 模型接入與權限繁體中文 · 官方文件導讀
非官方網站依 Databricks 官方技術文件整理,未獲 Databricks 授權或背書。
官方文件導讀 / DATABRICKS ON AWS

Unity Gateway 模型接入與權限:前置條件、代理連線與用量確認

閱讀原指南的模型治理入門、Coding Agents 整合與存取控制內容。

模型教學的前置條件

模型教學的前置條件

工作區須啟用 Unity Catalog;準備可呼叫的 Model Service 與 EXECUTE 權限、已登入工作區的 Databricks CLI,以及工作區 URL。服務的完整授權條件見模型文件。

開發工具與整合條件

讓開發工具共用治理入口

官方整合涵蓋 Claude Code、Codex CLI、Cursor 與 Gemini CLI 等工具。Unity Gateway CLI(ug)協助驗證身分、設定代理與導向服務;用量儀表板可觀察不同工具使用狀況。

需有支援區域的工作區與 Unity Catalog。Unity Gateway CLI 安裝需要 Python 3.12 以上及 uv;文件中的 Cursor 整合目前僅支援 Databricks 提供的模型服務。

連接程式開發代理

官方建議使用 Unity Gateway CLI(ug)處理 OAuth 與客戶端設定,也提供手動設定路徑。首次啟動時輸入工作區 URL 並完成驗證。

設定模型存取、速率與預算

06安全與存取控制Security and Access含 Beta 政策

以 Unity Catalog 權限決定誰能呼叫服務,再以內容政策檢查每次互動。模型 API、供應商連線與 MCP 服務可各自管理授權。

導入前看這裡:呼叫者需有服務的 EXECUTE 及上層目錄使用權。Model Service 以擁有者權限存取後端,呼叫者不必直接取得底層模型或供應商權限。system.ai 模型服務預設開放帳戶使用者,應先檢查權限。

在 Catalog Explorer 管理服務的 EXECUTE,設定 QPM 或 TPM;帳戶管理員可建立 Unity Gateway 預算,選擇通知或封鎖用量。預算採近即時估算,不能保證最終帳單上限。

確認請求經過治理

從代理送出提示,再查詢 system.ai_gateway.usage 確認服務、呼叫者與狀態。查詢系統表需要另外的讀取權限;有服務執行權不代表可讀全部用量紀錄。

用量表預設查詢者須同時具備 account admin 與 metastore admin 角色,亦可由管理者另行授權。對超過 1 MiB 的非串流、非 embedding 回應,Gateway 不追蹤 token 用量。

原始文件與延伸閱讀

本頁取樣原指南既有內容與其官方技術文件引用。原指南文件核對日為 2026-09-15,本頁重組日為 2026-09-15;本次未重新查核外部文件。

  1. 模型存取治理入門教學 ↗官方文件 · 本站核對 2026-09-15
  2. 模型 API 與 Model Services ↗文件 · 本站核對 2026-09-15
  3. Coding Agents 整合 ↗文件 · 本站核對 2026-09-15
  4. 外部模型供應商與 BYOK ↗文件 · 本站核對 2026-09-15
  5. Service Policies ↗文件 · 本站核對 2026-09-15
  6. 預算、通知與用量封鎖 ↗文件 · 本站核對 2026-09-15
  7. 用量追蹤、儀表板與計費 ↗官方文件 · 本站核對 2026-09-15