本页列出了通过公共 Azure Databricks 设置 API 提供的设置,按范围分组。 每个设置都通过稳定 的设置名称 (密钥)来标识。 关于如何发现、阅读和更新这些设置,请参见 通过设置API管理设置。
功能预览也通过设置API管理,但这里未列出,因为它们是短暂的,最终会终止生命。 通过 设置-元数据端点发现当前可用的预览版本。
可用设置
以下设置可通过公开设置API按范围分组使用。 该列表会定期生成;对于权威且始终最新的设置集及其文档链接,调用 settings-metadata 端点,返回每个设置的 name、 description、 typedocs_link和 。
帐户设置
适用于整个账户的设置。
| 设置 | 密钥名称 | Description |
|---|---|---|
| 禁用旧有功能 | disable_legacy_features |
禁用新Databricks工作区的遗留功能。 对于新创建的工作区:1. 禁用DBFS根和挂载的使用。 2. Hive Metastore 不会被配置。 3. 禁用“无隔离集群”的使用。 4. 禁用13.3LTS之前的Databricks运行时版本。 |
| 强制执行 Unity 网关 | enforce_ai_gateway_v3_only |
控制所有基础模型访问是否必须通过 Unity Gateway。 启用后,模型访问权限、AI预算和安全策略均由Unity Gateway集中管理,所有基础模型流量都必须通过该门户。 服务绕过 Unity Gateway 的端点的遗留基础模型拒绝流量。 |
| 合作伙伴驱动的人工智能功能 | llm_proxy_partner_powered |
决定是否启用合作伙伴驱动的模型。 该设置既可在账户层面,也支持工作区层面 |
| 强制执行合作伙伴驱动的AI功能 | llm_proxy_partner_powered_enforce |
确定伙伴驱动的强制设置是否开启。 启用后,账户级合作伙伴驱动的价值会覆盖任何工作区层级的覆盖。 |
| 限制工作区管理员 | restrict_workspace_admins |
“限制工作区管理员”设置允许你控制工作区管理员的功能。 设置状态设置为ALLOW_ALL后,工作区管理员可以代表工作区内的任何服务主体创建服务主体个人访问令牌。 工作区管理员还可以将作业所有者更改为工作区中的任何用户。 他们还可以将工作run_as设置更改为工作空间内的任何用户,或是拥有服务主用户角色的服务主体。 设置状态设为RESTRICT_TOKENS_AND_JOB_RUN_AS后,工作区管理员只能代表他们拥有服务主体用户角色的服务主体创建个人访问令牌。 他们也只能将作业所有者更改为自己。 他们可以将工作run_as设置更改为自己,或更改为拥有服务主用户角色的服务主体。 |
工作区设置
适用于单一工作区的设置。
| 设置 | 密钥名称 | Description |
|---|---|---|
| AI/BI 仪表板嵌入访问策略 | aibi_dash_embed_ws_acc_policy |
控制 AI/BI 发布的仪表盘嵌入在工作区层面是否启用、条件启用或禁用。默认情况下,该设置为条件启用(ALLOW_APPROVED_DOMAINS)。 |
| AI/BI仪表盘嵌入已批准的域名 | aibi_dash_embed_ws_apprvd_domains |
控制获批托管嵌入式 AI/BI 仪表盘的域名列表。当当前访问策略未设为ALLOW_APPROVED_DOMAINS时,已批准的域名列表无法变更。 |
| 将应用的 OAuth 范围限制为选定值 | allowedAppsUserApiScopes |
限制应用开发者代表用户时可以请求的OAuth范围。 指定允许的范围列表,或使用“*”表示允许所有支持的范围。 空列表实际上会禁用应用的用户授权。 |
| 允许电子表格回写 | allowSpreadsheetWriteback |
启用或禁用用户是否可以通过 Excel 和 Google 表格连接器将数据写回 Databricks。 |
| 自动集群更新 | automatic_cluster_update |
自动群集更新可确保工作区中的所有群集定期更新到最新的主机 OS 映像和安全修补程序。 帐户管理员可以安排维护时段的频率、开始日期和开始时间。 适用于经典计算(集群、池、经典SQL仓库、遗留模型服务);它不适用于无服务器计算。 启用此功能将添加增强安全性与合规附加组件,并要求使用高级定价等级。 |
| 允许的协作平台 | collaboration_platform_connectivity |
控制哪些外部协作平台(Slack和/或Microsoft Teams)可以连接到该工作区。 默认是ALLOW_ALL。 |
| 允许在协作平台中发布公开消息 | collaboration_platform_message_visibility |
启用后,用户可以选择Slack或Microsoft Teams中Databricks应用的回复是否被频道看到。 禁用后,所有响应都必须对请求用户保密。 |
| Databricks 人员的工作区访问权限 | customerApprovedWSLoginExpirationTime |
在特定时间之后,Databricks员工将不再登录您的工作区。 时间格式为 YYYY-MM-DDTHH:MM:SSZ。 你可以通过设置过去的时间戳来完全禁用访问权限,比如 1998-01-01T00:00:00.000Z。 通过使用空字符串或特殊值 indefinite来无限期启用访问。 |
| 默认命名空间 | default_namespace_ws |
默认命名空间设置API允许用户配置Databricks工作区的默认命名空间。 |
| 禁用旧版访问 | disable_legacy_access |
“禁用遗留访问”具有以下影响:1. 禁用从工作区直接访问 Hive Metastore(通过 Hive Metastore 联合访问不受影响)。 2. 禁用从工作区进行外部位置访问的回退模式。 3. 禁用13.3LTS之前的Databricks运行时版本。 重要提示:当工作区默认目录设置为遗留目录(hive_metastore或spark_catalog)时,此设置无法启用。 先把默认目录改成 Unity 目录。 |
| 禁用 DBFS 根目录和挂载 | disable_legacy_dbfs |
禁用遗留DBFS有以下两个含义:1. 禁止访问DBFS的root和DBFS挂载(以及创建新的挂载)。 2. 禁用13.3LTS之前的Databricks运行时版本。 关闭该设置时,所有DBFS功能都被启用,且对Databrick的运行时版本不施加任何限制。 该设置可能需要长达20分钟才能生效,并且需要手动重启多功能计算集群和SQL仓库。 |
| 启用自动灵活节点类型 | enableAutoNodeTypeFlexibility |
启用后,当请求节点类型不可用时,该工作区中的集群可自动启动替代节点类型,从而在容量短缺时提高启动可靠性。 |
| Databricks 自动记录 | enableDatabricksAutologgingAdminConf |
为此工作区启用或禁用 Databricks 自动记录。 启用后,在支持版本 Databricks Runtime for 机器学习 的集群上以交互方式执行的 ML 模型训练运行,将自动记录到 MLflow。 |
| Databricks 容器服务 | enableDcs |
为工作区启用 Databricks 容器服务(DCS),允许用户启动运行用户提供的 Docker 镜像的集群。 |
| 笔记本导出 | enableExportNotebook |
控制用户是否可以从工作区 UI 导出笔记本和文件。 默认情况下会启用此设置。 |
| FileStore 端点 | enableFileStoreEndpoint |
控制遗留的FileStore HTTP端点,用于从DBFS FileStore下载文件。 当遗留DBFS被禁用时,该端点依然不可用。 |
| Git 代理 | enableGitProxy |
不要手动设置,使用Git代理启用笔记本,按照文档中的流程操作。 |
| 结果表剪贴板功能 | enableNotebookTableClipboard |
控制用户是否可以将结果表中的表格数据复制到剪贴板。 默认情况下会启用此设置。 |
| 笔记本结果下载 | enableResultsDownloading |
控制用户是否可以下载笔记本结果。 默认情况下会启用此设置。 |
| 个人访问令牌 | enableTokensConfig |
控制用户是否可以在工作区创建和使用个人访问令牌。 |
| 通过界面上传数据 | enableUploadDataUis |
控制用户是否可以通过界面将数据上传到工作区。 该设置不控制上传到 Unity 目录卷,后者受 Unity 目录权限管理。 |
| 强制执行 Unity 网关 | enforce_ai_gateway_v3_only |
控制所有基础模型访问是否必须通过 Unity Gateway。 启用后,模型访问权限、AI预算和安全策略均由Unity Gateway集中管理,所有基础模型流量都必须通过该门户。 服务绕过 Unity Gateway 的端点的遗留基础模型拒绝流量。 |
| 仅允许从 Git 进行应用部署 | enforceGitAppDeployments |
启用后,该工作区中的应用只能从 Git 部署。 |
| Git 代理集群 ID | gitProxyClusterId |
Workspace 管理员设置,用于存储作为工作区 Git 代理的集群 ID。 |
| 合作伙伴驱动的人工智能功能 | llm_proxy_partner_powered |
决定是否启用合作伙伴驱动的模型。 该设置既可在账户层面,也支持工作区层面 |
| 关键任务 | mission_critical |
为关键工作负载提供最高水平的运营韧性和安全性。 包括灾难恢复以及增强的安全性和合规性。 |
| MLflow 模型注册表电子邮件通知 | mlflowModelRegistryEmailNotificationsEnabled |
布尔切换功能,启用MLflow模型注册表对模型版本动作(创建、评论、状态转换)的邮件通知。 |
| 允许仓库导出 IPYNB 输出 | reposIpynbResultsExportPermissions |
控制用户是否能将 .ipynb 笔记本输出提交到工作区内的远程 Git 仓库。 允许的值有 ALLOW (允许提交笔记本输出)和 DISABLE (防止提交笔记本输出)。 数值是区分大小写的。 |
| 限制工作区管理员 | restrict_workspace_admins |
“限制工作区管理员”设置允许你控制工作区管理员的功能。 设置状态设置为ALLOW_ALL后,工作区管理员可以代表工作区内的任何服务主体创建服务主体个人访问令牌。 工作区管理员还可以将作业所有者更改为工作区中的任何用户。 他们还可以将工作run_as设置更改为工作空间内的任何用户,或是拥有服务主用户角色的服务主体。 设置状态设为RESTRICT_TOKENS_AND_JOB_RUN_AS后,工作区管理员只能代表他们拥有服务主体用户角色的服务主体创建个人访问令牌。 他们也只能将作业所有者更改为自己。 他们可以将工作run_as设置更改为自己,或更改为拥有服务主用户角色的服务主体。 |
| 合规安全配置 | shield_csp_enablement_ws_db |
控制该工作区是否启用合规安全配置文件。 合规安全配置文件提供高度安全的基线(额外监控、加固的计算镜像、为节点间加密强制执行实例类型及其他控制措施),使符合和管理适用的合规标准变得更为便捷。 启用该功能还永久支持工作区的安全监控和自动集群更新,并增加了增强安全性与合规附加组件。 |
| 增强安全监控 | shield_esm_enablement_ws_db |
控制该工作区是否启用增强的安全监控。 增强安全监控提供加固的计算镜像和额外的安全监控代理(文件完整性监控、杀毒软件和漏洞扫描),生成可审查的日志行。 它只适用于经典计算平面资源,不适用于无服务器资源。 如果工作区启用了合规安全配置文件,该设置将被永久执行。 |
| 将交互式笔记本结果存储在客户账户中 | storeInteractiveNotebookResultsInCustomerAccount |
将所有交互式笔记本结果存储在工作区的云存储桶中,而不是Databricks管理的控制平面。 默认情况下,较小的结果存储在控制平面,较大的结果存储在工作区桶中。 开启此设置后,所有结果都会存储在你的云端账户中,无论结果大小大小。 |
| 强制用户隔离 | user_isolation_ws_enable |
防止创建或启动使用无隔离共享访问模式的集群。 变更在集群启动或重启时生效。 该设置无法在仅受Unity Catalog强制执行的工作区上禁用。 |
| AI/BI 仪表盘工作区主题 | workspace_dashboard_theme |
一个工作区主题,用于标准化AI/BI仪表盘的颜色、字体和对齐。 新仪表盘默认使用,作者可以在仪表盘设置中应用到现有仪表盘上。 |
| 工作区标签 | workspace_label |
在Databricks控制台顶部导航中,工作区名称旁边会显示一个自定义标签和颜色徽章。 工作区管理员可以使用此设置在不同环境中可视化区分工作区。 该值是一个对象,包含一个label字段(文本字符串)和一个color字段(其中一个:coral, turquoiselimeindigolemonpurple, , )。 pink 当没有设置标签时,这两个字段都是空字符串。 |
| Web 终端 | wt_ws_enable |
控制该工作区是否启用了网页终端。 当账户将控制权委派给工作区时,接受真或假。 禁用委托时,只接受账户强制值:启用时为真,禁用时为假。 需要一个布尔值。 对于与账户关联的工作空间,如果账户的委托设置未定义,更新将被拒绝。 |
用户首选项
适用于账户用户的设置。
| 设置 | 密钥名称 | Description |
|---|---|---|
| 在编辑器交互时自动创建会话 | autoCreateSessionOnEditorInteraction |
控制与编辑器交互时是否会自动创建会话。 |
| 自动发射并挂钩 | autoLaunchAndAttach |
控制笔记本是否会自动启动并连接到集群。 |
| 确认命令删除 | confirmCommandDelete |
控制删除命令前是否需要确认。 |
| 在草稿文件夹中创建新素材 | createNewAssetsInDraftsFolder |
控制草稿文件夹中是否创建新素材。 |
| Databricks 统一 SQL 编辑器 在 Open Pref 上创建并转换查询 | databricks-unified-sql-editor-create-and-convert-queries-on-open-pref |
控制统一SQL编辑器中的查询创建和转换行为。 |
| 默认 Python 缩进单元 | defaultPythonIndentUnit |
控制默认的 Python 缩进单元。 允许的值: 2、 4,或 ''(默认为空字符串)。 |
| 编辑器自定义暗色主题 | editorCustomDarkTheme |
控制编辑器的自定义暗色主题。 允许的值:defaultTheme, Atom-One-Dark, Ayu-Dark, BlackboardDracula, GitHub-Dark, MonokaiOne-Dark-Pro, , , 。 Winter-is-Coming-Dark |
| 编辑器自定义光源主题 | editorCustomLightTheme |
控制编辑器的自定义光源主题。 允许的值:defaultTheme、、、Active4DAtom-One-Light、Ayu-LightGitHub-Light、TomorrowWinter-is-Coming-Light。 |
| 编辑器字体大小 | editorFontSize |
控制编辑器中的字体大小。 允许的值:整数范围为10到30。 |
| 启用自动内联快速修复 | enableAutoInlineQuickFix |
控制是否会自动推荐内联快速修复方案。 |
| 启用自动内联快速修复 选择退出 | enableAutoInlineQuickFixOptOut |
自动在线快速修复的选择退出控制。 |
| 启用自动触发诊断 | enableAutoTriggerDiagnose |
控制诊断是否自动触发。 |
| 启用自动触发诊断 选择退出 | enableAutoTriggerDiagnoseOptOut |
自动诊断的选择退出控制。 |
| 启用居中布局 | enableCenteredLayout |
控制编辑器是否使用居中布局。 |
| 启用经典快捷键 | enableClassicShortcuts |
控制键盘快捷键模式。 允许的值:default、classic。 |
| 启用命令编号 | enableCommandNumbers |
控制命令编号是否显示在笔记本中。 |
| 在输入时启用补全 | enableCompletionsAsYouType |
控制你输入时自动补全建议是否会出现。 |
| 启用光标闪烁 | enableCursorBlink |
控制编辑器中光标是否闪烁。 |
| 启用暗黑模式 | enableDarkMode |
控制主题模式。 允许的值:light、dark、system。 |
| 启用 Enter 接受建议 | enableEnterAcceptsSuggestions |
控制按回车是否接受自动补全建议。 |
| 启用编辑器悬停 | enableHoverForEditor |
控制编辑器中是否显示悬停工具提示。 |
| 在输入时启用内联建议,选择退出 | enableInlineSuggestionAsYouTypeOptOut |
输入时的内嵌建议可选择退出。 |
| 启用行号 | enableLineNumbers |
控制编辑器中是否显示行号。 |
| 启用线号V2 | enableLineNumbersV2 |
控制编辑器(v2)中是否显示行号。 |
| 启用线环 | enableLineWrap |
控制编辑器中文本是否换行到下一行。 |
| 启用摩纳哥多光标 | enableMonacoMultiCursor |
控制多光标修饰键。 允许的值:alt、ctrlCmd。 |
| 启用笔记本调试器 选择退出 | enableNotebookDebuggerOptOut |
笔记本调试器的退出控制。 |
| 启用无服务器可观察性开关 | enableServerlessObservabilityToggle |
当工作区预览启用时,用户选择加入“改进的无服务器可观察性”。 |
| 在新单元界面中启用显示命令统计 | enableShowCommandStatsInNewCellUi |
控制命令统计是否显示在新单元格界面中。 |
| 启用节目推广单元标题 | enableShowPromotedCellTitles |
控制是否显示推广单元标题。 |
| 启用智能报价 | enableSmartQuotes |
控制编辑器中是否启用智能引号。 |
| 启用笔记本和文件的软标签页 | enableSoftTabsForNotebooksAndFiles |
控制笔记本和文件中标签页是否转换为空格。 |
| 启用SQL语法错误突出显示 | enableSqlSyntaxErrorHighlighting |
控制SQL语法错误是否被突出显示。 |
| 执行后启用切换到命令模式 | enableSwitchToCommandModeAfterExecution |
控制编辑器在单元格执行后是否切换到命令模式。 |
| 启用统一文件树浏览器 | enableUnifiedFileTreeExplorer |
控制是否启用统一文件树资源管理器。 |
| 焦点 | enableUnifiedSchemaBrowserTreeExplorer |
控制是否启用统一模式浏览器树资源管理器。 |
| 启用Vega Lite渲染器 | enableVegaLiteRenderer |
控制 Vega-Lite 渲染器是否启用用于可视化。 |
| 启用Vega Lite渲染器 选择退出 | enableVegaLiteRendererOptOut |
Vega-Lite 渲染器的选择退出控制。 |
| 启用Vega Lite Renderer 预览标签 | enableVegaLiteRendererPreviewTag |
控制是否显示 Vega-Lite 渲染器预览标签。 |
| 加长的底部面板 | extendedBottomPanel |
控制是否显示扩展的底部面板。 |
| 湖流新管道监测界面 | lakeflowNewPipelinesMonitoringUi |
控制是否启用新的 Lakeflow 管道监控界面。 |
| 笔记本默认导出格式 | notebookDefaultExportFormat |
控制笔记本的默认导出格式。 允许的值:SOURCE、JUPYTER。 |
| 选项箭头快捷模式 | optionArrowShortcutMode |
控制Option+Arrow键盘快捷键的行为。 允许的值:navigate、move。 |
| 管道多文件创作 | pipelinesMultifileAuthoring |
控制管道是否启用多文件创作。 |
| 发送评论邮件通知 | sendCommentEmailNotifications |
控制是否发送评论邮件通知。 |
| 显示单元执行小地图 | showCellExecutionMinimap |
控制单元执行小地图是否显示。 |
| 显示Pip到环境面板提示 | showPipToEnvironmentPanelPrompt |
控制是否向环境面板提示显示 pip。 |
| 节目火花顾问 | showSparkAdvisor |
控制是否显示Spark优化建议。 |
| Show Spark 错误提示 | showSparkErrorTips |
控制是否显示Spark错误的有用提示。 |
| 用户激活 Python 格式错误高亮 | userActivatesPythonFormatErrorHighlighting |
控制是否高亮显示 Python 格式错误。 |
| 用户激活 Python 语法错误,突出显示退出选项 | userActivatesPythonSyntaxErrorHighlightingOptOut |
Python语法错误高亮的opt-out控制。 |
| 用户激活 Python 类型检查 | userActivatesPythonTypeChecking |
控制是否启用 Python 类型检查。 |
| 用户激活快照恢复 | userActivatesSnapshotRestore |
控制是否启用快照恢复功能。 |
| 新查询默认限制为1000 | usqleDefaultQueryAutoLimit |
控制编辑器中SQL查询的默认自动限制。 |