设置 API 键参考

本页列出了通过公共 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查询的默认自动限制。

其他资源