給你的 Azure Databricks 帳號一個自訂網址

Important

這項功能目前處於 公開預覽版。

自訂網址會讓你的 Azure Databricks 帳戶擁有單一的品牌入口(例如: acme.databricks.com),取代目前帳戶使用者瀏覽的每個工作區 URL 集合。 啟用自訂 URL 後,使用者即可登入 Azure Databricks 帳號,自由在工作區與 Genie One 之間移動,無需重新認證。

Eligibility

符合資格的帳號管理員可以直接從帳號主控台申請並啟用自訂網址。 適用以下資格要求:

  • 你的帳戶必須是付費且已驗證的客戶帳戶。
  • 啟用自訂網址的帳號管理員必須擁有非保留網域的電子郵件地址。

如果你之前被分配過自訂網址,它會自動顯示在你的帳號設定中。 若要重新命名您的自訂網址,請聯絡您的 Azure Databricks 帳戶團隊。

Note

Azure Databricks 保留隨時更改、回收或撤銷自訂網址的權利。 在可能的情況下,我們會提前通知並協助協調更換。

要求

  • 如果您的工作區使用 Inbound Private Link,您可以為自訂 URL 設定 Inbound Private Link,並使用依內容脈絡的 Ingress 原則,將流量導向您的 工作區和帳戶層級資源。

以下合作夥伴連接器目前不支援自訂網址。 請使用你帳戶的舊有網址來設定這些連線。 其他所有連接器皆支援。

指派自訂網址

Note

如果你之前被分配過自訂網址,它會自動顯示在你的帳號設定中。 如果您想重新命名現有的自訂網址,請聯絡您的 Azure Databricks 帳號團隊。

  1. 在帳號主控台,進入 設定 > 帳號設定。
  2. 點擊「 認領你的網址 」按鈕以啟用自訂網址。
  3. 可選擇啟用自動重定向設定,自動將所有舊有工作區的網址重新導向到你的自訂網址。

啟用自訂網址後,請前往 Genie One 頁面 acme.azuredatabricks.net/one。 你帳號中的使用者現在可以在他們能存取的任何工作區存取資產,而不必被要求重新登入。

開發者工具支援

以下 Azure Databricks 開發者工具支援自訂網址。 升級到至少標示的最低版本以確保相容性。

Tool 最低版本
CLI / DABs 1.0.0
Terraform 1.114.0
Go 軟體開發套件 (SDK) 0.130.0
Python SDK 0.103.0
Java 開發套件 0.105.0
VS Code 擴充功能 2.11.0

使用自訂網址會有什麼改變

當您開始使用自訂 URL 時,大多數 Azure Databricks 功能都可照常運作。 以下應用與整合需要額外設定。

Unity 目錄與 OAuth 的連結

對於會提示使用者透過由客戶管理的第三方應用程式使用 OAuth 登入的 Unity Catalog 連線,請新增使用自訂 URL 的回呼 URI 至該應用程式允許的重新導向 URI 清單。 如果使用者還能存取該 URL,請保留使用工作區 URL 的回調 URI。 回撥路徑依連線類型而異。 例如,對於 HTTP 連線,請將 https://<custom-url>/login/oauth/http.html 加入第三方應用程式的重新導向 URL 允許清單。

外部使用者的嵌入式儀表板

若要讓供外部使用者使用的嵌入式儀表板使用您的自訂 URL,請更新您的嵌入應用程式:

  1. 將工作區專屬的實例 URL 替換成你自訂的 URL。
  2. 使用 /api/2.0/lakeview/dashboards/<dashboard-id>/published/tokeninfo 查詢參數,將目標工作區 ID 新增至 o=<workspace-id> 和 /oidc/v1/token 請求中。 當它是第一個查詢參數時,請使用 &o=<workspace-id>;如果 URL 已經有查詢參數,則請使用 ?o=<workspace-id>。

完整 Python 和 JavaScript 範例請參考「使用範例應用程式驗證與產生令牌」。