突出显示要运行的行。

选择“运行”>“运行所选文本”或使用键盘快捷方式 Ctrl + Shift + Enter 。 如果未突出显示任何文本，“运行所选文本”将执行当前行。

如果 在单元格中使用混合语言 ，则必须在所选内容中包含 %<language> 行。

“运行所选文本”还会执行折叠的代码（如果突出显示的选定内容中有任何代码）。

支持特殊的单元格命令，例如 %run 、 %pip 和 %sh 。

不能在具有多个输出选项卡的单元格（即已定义数据配置文件或可视化效果的单元格）上使用“运行所选文本”。

设置代码单元格的格式

Azure Databricks 提供的工具可用于在笔记本单元格中快速且轻松地设置 Python 和 SQL 代码的格式。 这些工具减少了使代码带有格式的工作量，有助于在笔记本中强制实施相同的编码标准。

Python black 格式化程序库

此功能目前以 公共预览版 提供。

Azure Databricks 支持在笔记本中使用 black 的 Python 代码格式设置。 笔记本必须附加到安装了 black 和 tokenize-rt Python 包的群集。

在 Databricks Runtime 11.3 LTS 及更高版本上，Azure Databricks 将预安装 black 和 tokenize-rt 。 可以直接使用格式化程序，而无需安装这些库。

在 Databricks Runtime 10.4 LTS 及更低版本上，必须在笔记本或群集上通过 PyPI 安装 black==22.3.0 和 tokenize-rt==4.2.1 才能使用 Python 格式化程序。 可以在笔记本中运行以下命令：

%pip install black==22.3.0 tokenize-rt==4.2.1
或在群集上安装库。
有关安装库的更多详细信息，请参阅 Python 环境管理。
对于 Databricks Git 文件夹中的文件和笔记本，可根据 pyproject.toml 文件配置 Python 格式化程序。 若要使用此功能，请在 Git 文件夹根目录中创建一个 pyproject.toml 文件，并根据 Black 配置格式对其进行配置。 编辑文件中的 [tool.black] 部分。 当格式化该 Git 文件夹中的任何文件和笔记本时，将应用该配置。
如何设置 Python 和 SQL 单元格的格式
必须拥有笔记本“可编辑”权限，才能设置代码的格式。
Azure Databricks 使用 Gethue/sql-formatter 库来设置 SQL 格式，并使用适用于 Python 的 black 代码格式化程序。
可通过以下方式触发格式化程序：
设置单个单元格的格式
键盘快捷方式：按 Cmd+Shift+F。
命令上下文菜单：

设置 SQL 单元格的格式：在 SQL 单元格的命令上下文下拉菜单中选择“设置 SQL 格式”。 此菜单项仅在 SQL 笔记本单元格和具有 %sql 语言 magic 的单元格中可见。
设置 Python 单元格的格式：在 Python 单元格的命令上下文下拉菜单中选择“设置 Python 格式”。 此菜单项仅在 Python 笔记本单元格和具有 %python 语言 magic 的单元格中可见。
笔记本“编辑”菜单：选择一个 Python 或 SQL 单元格，然后选择“编辑”>“设置单元格格式”。
设置多个单元格的格式
选择多个单元格，然后选择“编辑”>“设置单元格格式”。 如果选择多个语言的单元格，则仅会设置 SQL 和 Python 单元格的格式。 这包括那些使用 %sql 和 %python 的单元格。
设置笔记本中所有 Python 和 SQL 单元格的格式
选择“编辑”>“设置笔记本格式”。 如果笔记本包含多种语言，则只会设置 SQL 和 Python 单元格的格式。 这包括那些使用 %sql 和 %python 的单元格。
代码格式设置的限制
Black 对 4 空格缩进强制执行 PEP 8 标准。 缩进不可配置。
不支持设置 SQL UDF 中嵌入的 Python 字符串的格式。 同样，不支持设置 Python UDF 中 SQL 字符串的格式。
  版本历史记录
Azure Databricks 笔记本维护笔记本版本历史记录，允许查看和还原笔记本以前的快照。 可以执行以下有关版本的操作：添加注释、还原和删除版本，以及清除版本历史记录。
还可以将 Databricks 中的工作与远程 Git 存储库同步。
要访问笔记本版本，请单击右侧边栏中的。 此时会显示笔记本版本历史记录。 还可以选择“文件”>“版本历史记录”。
要将注释添加到最新版本，请执行以下操作：
单击版本。
单击“立即保存”。
调用语言 magic 命令时，该命令会被调度到笔记本的执行上下文中的 REPL。 用一种语言定义（并且因此位于该语言的 REPL 中）的变量在其他语言的 REPL 中不可用。 REPL 只能通过外部资源（例如 DBFS 中的文件或对象存储中的对象）共享状态。
笔记本还支持几个辅助 magic 命令：
%sh：允许你在笔记本中运行 shell 代码。 若要在 shell 命令的退出状态为非零值的情况下使单元格发生失败，请添加 -e 选项。 此命令仅在 Apache Spark 驱动程序上运行，不在工作器上运行。 若要在所有节点上运行 shell 命令，请使用初始化脚本。
%fs：允许你使用 dbutils 文件系统命令。 例如，如需运行 dbutils.fs.ls 命令以列出文件，可以改为指定 %fs ls。 有关详细信息，请参阅使用 Azure Databricks 上的文件。
%md：允许你包括各种类型的文档，例如文本、图像以及数学公式和等式。 请参阅下一部分。
Python 命令中的 SQL 语法突出显示和自动完成
当你在 Python 命令（例如 spark.sql 命令）中使用 SQL 时，可以使用语法突出显示和 SQL 自动完成。
  使用 Python 浏览 Python 笔记本中的 SQL 单元格结果
你可能希望使用 SQL 加载数据，并使用 Python 浏览数据。 在 Databricks Python 笔记本中，SQL 语言单元格中的表结果自动作为分配到变量 _sqldf 的 Python 数据帧提供。
在 Databricks Runtime 13.3 LTS 及更高版本中，还可以使用 IPython 的输出缓存系统访问数据帧结果。 提示计数器显示在单元格结果底部的输出消息中。 对于所示的示例，结果将引用为 Out[2]。
每次运行 %sql 单元格时，都可以重新分配变量 _sqldf。 若要避免丢失对数据帧结果的引用，请在运行下一个 %sql 单元格之前将其分配到新的变量名称：
new_dataframe_name = _sqldf
如果查询使用小组件进行参数化，则结果不可作为 Python 数据帧提供。
如果查询使用关键字 CACHE TABLE 或 UNCACHE TABLE，则结果不可作为 Python 数据帧提供。
下面的屏幕截图显示了一个示例：
  并行执行 SQL 单元格
当某个命令正在运行且你的笔记本已附加到交互式群集时，可以将 SQL 单元格与当前命令同时运行。 SQL 单元格在新的并行会话中执行。
若要并行执行某个单元格，请执行以下操作：
运行该单元格。
单击 “立即运行” 。 此时会立即执行该单元格。
由于单元格在新会话中运行，因此并行执行的单元格不支持临时视图、UDF 和隐式 Python 数据帧 (_sqldf)。 此外，在并行执行期间将使用默认目录和数据库名称。 如果代码引用不同目录或数据库中的表，则你必须使用三级命名空间 (catalog.schema.table) 来指定表名。
在 SQL 仓库上执行 SQL 单元格
可以在 SQL 仓库上的 Databricks 笔记本中运行 SQL 命令，这是一种针对 SQL 分析优化的计算类型。 请参阅将笔记本与 SQL 仓库配合使用。
Azure Databricks 支持在 Markdown 单元格中显示图像。 可显示存储在工作区、卷或 FileStore 中的图像。
显示存储在工作区中的图像
可以使用绝对路径或相对路径来显示存储在工作区中的图像。 若要显示存储在工作区中的图像，请使用以下语法：
![my_test_image](/Workspace/absolute/path/to/image.png)
![my_test_image](./relative/path/to/image.png)
可使用绝对路径来显示存储在卷中的图像。 若要显示存储在卷中的图像，请使用以下语法：
![my_test_image](/Volumes/absolute/path/to/image.png)
显示存储在 FileStore 中的图像
若要显示在 FileStore 中存储的图像，请使用以下语法：
![my_test_image](files/image.png)
例如，假设你在 FileStore 中有 Databricks 徽标图像文件：
dbfs ls dbfs:/FileStore/
databricks-logo-mobile.png
在 Markdown 单元格中包括以下代码时：
图像会呈现在单元格中：
可将图像从本地文件系统拖放到 Markdown 单元格中。 图像上传到当前工作区目录并显示在单元格中。
显示数学等式
笔记本支持 KaTeX，用于显示数学公式和等式。 例如，
\\(c = \\pm\\sqrt{a^2 + b^2} \\)
\\(A{_i}{_j}=B{_i}{_j}\\)
$$c = \\pm\\sqrt{a^2 + b^2}$$
\\[A{_i}{_j}=B{_i}{_j}\\]
\\( f(\beta)= -Y_t^T X_t \beta + \sum log( 1+{e}^{X_t\bullet\beta}) + \frac{1}{2}\delta^t S_t^{-1}\delta\\)
where \\(\delta=(\beta - \mu_{t-1})\\)
包括 HTML
可以使用函数 displayHTML 在笔记本中包括 HTML。 请参阅笔记本中的 HTML、D3 和 SVG，通过示例来了解如何执行此操作。
displayHTML iframe 是从域 databricksusercontent.com 提供的，iframe 沙盒包含 allow-same-origin 属性。 必须可在浏览器中访问 databricksusercontent.com。 如果它当前被企业网络阻止，则必须将其添加到允许列表。
链接到其他笔记本
可以使用相对路径链接到 Markdown 单元格中的其他笔记本或文件夹。 将定位点标记的 href 属性指定为相对路径（以 $ 开头），然后遵循与 Unix 文件系统中的模式相同的模式：
<a href="$./myNotebook">Link to notebook in same folder as current notebook</a>
<a href="$../myFolder">Link to folder in parent folder of current notebook</a>
<a href="$./myFolder2/myNotebook2">Link to nested notebook</a>