Azure Databricks UI 包括一个 SQL 编辑器，可用于编写查询、与同事协作、查找可用数据以及创建可视化效果。 本页介绍新的 SQL 编辑器和页面链接，这些页面详细介绍了每个任务。
本页介绍新的 SQL 编辑器。 若要了解如何使用旧版 SQL 编辑器，请参阅 编写查询并浏览旧版 SQL 编辑器中的数据。
注意
从 2026 年 5 月下旬开始，默认为所有工作区启用新的 SQL 编辑器。 在工作区级别关闭新的 SQL 编辑器的功能将不再可用。 在此期间，单个用户仍能够切换到旧版编辑器。 从 2026 年 7 月下旬开始，旧版 SQL 编辑器将停用，所有用户都将使用新的 SQL 编辑器。 有关详细信息，请参阅 有什么新内容？。
打开 SQL 编辑器
若要在 Azure Databricks UI 中打开 SQL 编辑器，请单击边栏中的 
SQL 编辑器。
SQL 编辑器将打开到上次打开的查询。 如果不存在查询，或者所有查询均已显式关闭，则 SQL 编辑器登陆页将打开。
打开新的 SQL 编辑器
使用 “新建 SQL 编辑器” 开关，在目录和架构下拉列表选择器右侧打开新编辑器。 在窄显示器上，可以通过单击目录和架构选择器右侧的烤肉串菜单 来找到切换至Kebab menu icon.新建 SQL 编辑器的选项。
为任何查询启用拥有的新编辑器：
- 点击“新 SQL 编辑器：关闭”。 系统会打开“新 SQL 编辑器”弹出菜单。
- 默认选中“应用于所有我的查询”复选框。 保留此设置以为拥有的所有查询启用编辑器。
- 若要仅为活动查询启用新编辑器，请清除“ 应用于所有查询 ”复选框。
- 将“新 SQL 编辑器”切换开关设置为“打开”。
新的 SQL 编辑器不能用于所有查询。 如果以下任一情况属实，则无法切换到新的 SQL 编辑器进行查询：
- 你尚未拥有查询。
- 查询包含 不支持的基于查询的下拉列表。 请参阅 “使用命名参数标记”。
打开新的 SQL 编辑器时，查询将在新 UI 中重新打开。 在运行查询前，结果集为空。
注意
查询结果与所有协作者共享，限制为 64,000 行。
方向
本部分重点介绍 UI 中的主要差异，并介绍如何查找和使用可用功能。
- 打开工作区文件系统：可以直接从 SQL 编辑器打开和组织工作区对象。
- 使用集成的 Genie Code：与 Genie Code 聊天，帮助你编写、优化或了解查询。 从侧窗格中运行 Genie Code 生成的代码。
- 折叠代码部分：单击代码块左侧的折叠箭头可以选择性地隐藏和展开代码部分。 这样就可以更轻松地处理大型文件。
- 打开命令面板：命令面板包括常用操作、键盘快捷键、自定义主题和链接，可帮助快速找到所需内容。 打开面板后，使用搜索栏查找特定的工具和快捷键。
- 为代码添加注释：在代码中添加注释以增强协作。
- 查看版本历史记录：查看查询的最新更改。
使用 SQL 编辑器
以下页面讨论可在新的 SQL 编辑器中执行的主要任务：
| 任务 | 说明 |
|---|---|
| 编写查询 | 连接到计算资源、浏览数据资产并编写查询。 |
| 运行和共享查询 | 运行单语句或多语句查询、共享查询并实时编辑它们。 |
| 查看查询结果 | 浏览、可视化、下载和筛选查询结果。 |
| 使用参数 | 使用命名参数并配置参数控件。 |
| 自定义格式 SQL | 自定义 SQL 自动格式设置选项。 |
| 键盘快捷方式 | 常见键盘快捷方式的参考。 |
复制旧查询 ID
若要获取迁移到新 SQL 编辑器的查询的旧查询 ID，请从 “文件” 菜单复制它。 旧查询 ID 对于 API 调用或其他引用它的集成非常有用。
- 在新 SQL 编辑器中打开查询。
- 单击编辑器顶部的烤肉串
。 - 单击 “文件>复制遗留查询 ID”。
禁用新的 SQL 编辑器
注意
从 2026 年 5 月下旬开始，工作区级别的新 SQL 编辑器退出功能将被移除。 单个用户仍然可以切换到旧版编辑器，直到 2026 年 7 月下旬，旧版 SQL 编辑器将完全停用。 有关详细信息，请参阅 有什么新内容？。
若要关闭新的 SQL 编辑器，请执行以下操作：
- 单击“新 SQL 编辑器：打开”。 系统会打开“新 SQL 编辑器”弹出菜单。
- 将“新 SQL 编辑器”切换开关设置为“关闭”。
- 在确认对话框中，选择是仅为当前查询关闭新编辑器，还是为所有符合条件的查询关闭新编辑器。
- 取消选中“为所有符合条件的查询禁用”。 如果您只想对当前查询禁用新编辑器，请保留此设置。
- 若要关闭所有查询的新 SQL 编辑器，请选中“ 禁用所有符合条件的查询”复选框。
若要防止查询在新 SQL 编辑器中自动打开：
- 在Azure Databricks工作区中，单击顶部栏中的用户名，然后选择Settings。
- 在左窗格中的 “用户”下，单击“ 开发人员 ”选项卡。
- 在新的 SQL 编辑器中关闭“创建并打开所有符合条件的查询”。
工作区管理员可以访问预览门户并搜索 SQL 编辑器，在工作区级别关闭此功能。 请参阅 Manage Azure Databricks 预览版。