数据库笔记本是独立的复杂文档，当与 MySQL 连接和专用编辑器结合使用时，可以为您提供一个工具来生成图形结果视图和图表。每个数据库笔记本的查询、代码和输出仅存储在当前会话中。如果您关闭笔记本编辑器或包含多个笔记本编辑器的连接选项卡，您的工作将丢失。

可以选择以一种持久化查询或代码、结果集、最后一个编辑器状态（最后一个插入符号位置、滚动位置和代码编辑器的选择等）的方式保存和重新加载数据库笔记本。实际上，您可以将笔记本会话保存为笔记本文件。加载文件时，所有执行块都将按与保存笔记本时完全相同的顺序以完全相同的尺寸恢复。

保存的笔记本文件使您可以

笔记本文件具有一种新的文件类型 (mysql-notebook)，它表示一个特殊的 JSON 文档，其中只有足够的数据可以恢复笔记本。MySQL Shell for VS Code 为这些文件实现了一个自定义编辑器，它允许笔记本文件和笔记本编辑器之间进行同步。借助这种级别的同步，您可以从活动连接选项卡、独立笔记本文件选项卡或两者中持久化和重新激活笔记本文件。JSON 文件的特定结构提供了一个 type 字段来识别它，以及一个 version 字段来允许在需要时无缝更新它。这些字段使笔记本文件对源代码管理友好，并且易于比较。

笔记本文件需要连接。它可以是扩展设置中配置的连接（默认连接），或者如果没有设置，则会提示您选择一个。如果笔记本选项卡正在使用的连接变得不可用，则笔记本文件将在必要时自动保存文档后关闭。如果发生以下情况，可能会发生这种类型的中断

您选择的连接根据笔记本文件的 URL 存储在扩展状态中，并在您下次打开笔记本文件时使用。如果连接不再存在，MySQL Shell for VS Code 将从扩展状态中删除它，并提示您选择一个新的连接。

笔记本文件选项卡类似于连接选项卡，只是笔记本文件选项卡只允许一个活动编辑器。相反，连接选项卡可以包含多个笔记本和单语言脚本编辑器。由于它只有一个文件编辑器，因此笔记本文件选项卡省略了工具栏中的 编辑器下拉列表，并添加了一个活动面包屑列表，显示打开文件的路径。下图显示了一个名为 sakila-actor.mysql-notebook 的文件的打开笔记本文件选项卡（和工具栏），该文件位于名为 Samples 的文件夹中。

图 4.8 MySQL Shell for VS Code - 笔记本文件选项卡和工具栏

文件选项卡工具栏操作与连接选项卡工具栏的操作相同（请参阅 第 4.4 节，“数据库笔记本工具栏”）。