Important
此功能目前以公共预览版提供。
自定义 URL 为 Azure Databricks 帐户提供一个统一的品牌入口点（例如：acme.databricks.com），替代了用户目前需要使用的每个工作区的 URL 集合。 启用自定义 URL 后，用户可以登录到其Azure Databricks帐户，并在工作区和 Genie One 之间自由移动，而无需重新进行身份验证。
Eligibility
符合条件的帐户管理员可以直接从帐户控制台声明和启用自定义 URL。 以下资格要求适用：
- 你的帐户必须是已验证的付费客户帐户。
- 启用自定义 URL 的帐户管理员必须具有非保留域电子邮件地址。
如果以前已分配自定义 URL，它将自动显示在帐户设置中。 若要重命名自定义 URL，请联系Azure Databricks帐户团队。
注释
Azure Databricks随时保留更改、回收或撤销自定义 URL 的权利。 在可能的情况下，我们提供提前通知并帮助协调更换。
Requirements
- 工作区不得使用专用链接入站（前端）。 入站专用链接保护工作区的 URL 回退到旧版每工作区 URL。
以下合作伙伴连接器目前不支持自定义 URL。 使用帐户的旧 URL 配置这些连接。 支持所有其他连接器。
分配自定义 URL
注释
如果以前已分配自定义 URL，它将自动显示在帐户设置中。 若要重命名现有的自定义 URL，请联系Azure Databricks帐户团队。
- 在帐户控制台中，转到 “设置帐户” > 设置。
- 单击“ 声明 URL ”按钮以启用自定义 URL。
- （可选）启用自动重定向设置，以自动将所有旧工作区 URL 重定向到自定义 URL。
启用自定义 URL 后，导航到 Genie One at <Your_DataBricks_ID>.azure.databricks.cn/one. 帐户中的用户现在可以跨他们有权访问的任何工作区访问资产，而无需提示再次登录。
开发人员工具支持
以下Azure Databricks开发人员工具支持自定义 URL。 至少升级到列出的最低版本，以确保兼容性。
| 工具 | 最低版本 |
|---|---|
| CLI / DABs | 1.0.0 |
| Terraform | 1.114.0 |
| Go 软件开发工具包 (SDK) | 0.130.0 |
| Python SDK | 0.103.0 |
| Java SDK | 0.105.0 |
| VS Code 扩展 | 2.11.0 |
使用自定义网址时会发生什么变化
当您开始使用自定义 URL 时，大多数 Azure Databricks 功能仍可照常工作。 以下应用和集成需要额外的配置。
面向外部用户的嵌入式仪表盘
要使用自定义 URL 嵌入外部用户的仪表盘，请更新你的嵌入应用：
- 用自定义URL替换工作区专用实例URL。
- 用
o=<workspace-id>查询参数将目标工作区 ID 添加到/oidc/v1/tokenand/api/2.0/lakeview/dashboards/<dashboard-id>/published/tokeninfo请求中。 当它作为第一个查询参数时，使用&o=<workspace-id>；如果 URL 已经包含查询参数，则使用?o=<workspace-id>。
完整的 Python 和 JavaScript 示例请参见“使用示例应用认证和生成令牌”。