DB 筆記本是個別且複雜的文件，當與 MySQL 的連線和特殊用途的編輯器結合時，可為您提供產生圖形結果檢視和圖表的工具。每個 DB 筆記本的查詢、程式碼和輸出僅儲存於目前的工作階段。如果您關閉筆記本編輯器或具有多個筆記本編輯器的連線索引標籤，您的工作將會遺失。

您可以選擇性地儲存和重新載入 DB 筆記本，以持久化查詢或程式碼、結果集、最後的編輯器狀態（最後的插入符號位置、捲動位置和程式碼編輯器的選取範圍等等）。實際上，您可以將筆記本工作階段儲存為筆記本檔案。當您載入檔案時，所有執行區塊都會以與上次儲存筆記本時完全相同的順序和大小還原。

已儲存的筆記本檔案可讓您：

筆記本檔案具有新的檔案類型 (mysql-notebook)，代表特殊的 JSON 文件，其中僅包含足夠的資料來還原筆記本。MySQL Shell for VS Code 會針對這些檔案實作自訂編輯器，允許筆記本檔案和筆記本編輯器之間同步。透過此同步層級，您可以從使用中的連線索引標籤、獨立的筆記本檔案索引標籤或兩者中持久化和重新啟用筆記本檔案。JSON 檔案的特定結構提供類型欄位來識別它，以及版本欄位以允許在需要時順暢地更新它。這些欄位使筆記本檔案便於原始碼管理且易於比較。

筆記本檔案需要連線。它可以是擴充功能設定中設定的連線（預設連線），如果沒有設定，則會提示您選取一個連線。如果筆記本索引標籤使用的連線變得無法使用，則筆記本檔案會在必要時自動儲存文件後關閉。如果您執行以下操作，可能會發生此類型中斷：

您選取的連線會根據筆記本檔案的 URL 儲存在擴充功能狀態中，並在您下次開啟筆記本檔案時使用。如果連線不再存在，MySQL Shell for VS Code 會將其從擴充功能狀態中移除，並提示您選取新的連線。

筆記本檔案索引標籤類似於連線索引標籤，不同之處在於筆記本檔案索引標籤只允許一個使用中的編輯器。相較之下，連線索引標籤可以包含多個筆記本和單一語言指令碼編輯器。因為它只有一個檔案編輯器，所以筆記本檔案索引標籤會省略工具列中的 編輯器 下拉式清單，並新增一個使用中的階層連結清單，顯示開啟檔案的路徑。下圖顯示名為 sakila-actor.mysql-notebook 的檔案在名為 Samples 的資料夾中開啟的筆記本檔案索引標籤（和工具列）。

圖 4.8 MySQL Shell for VS Code - 筆記本檔案索引標籤和工具列

檔案索引標籤工具列操作與連線索引標籤工具列的操作相同（請參閱 第 4.4 節，「DB 筆記本工具列」）。