文档首页
适用于 VS Code 的 MySQL Shell


正式发布前:2024-07-17

4.4 数据库笔记本工具栏

数据库笔记本工具栏提供了一些快速操作,用于修改以 SQL 语句、脚本或 MySQL Shell 函数(如 runSql())中的查询字符串编写的查询。工具栏会根据编辑器的类型和插入符号所在的块语言(在多语言编辑器中)而变化。例如,在 SQL 模式下,您可以使用工具栏中的按钮执行单个语句,该按钮可以执行插入符号处的语句或选定的语句。这与脚本语言不同,脚本语言始终作为一个整体执行(独立编辑器中的整个脚本或多语言编辑器中的整个代码块)。

下图显示了活动连接选项卡中工具栏中设置的图标操作。

图 4.4 适用于 VS Code 的 MySQL Shell - 数据库笔记本工具栏

Content is described in the surrounding text.

工具栏操作(从左到右)如下:

  • 编辑器 列表:提供对数据库连接浏览器和每个活动连接的快速访问。该列表使您能够将活动连接整合到一个选项卡中,而不是为每个连接生成单独的选项卡。

    每个活动连接都包含:

    第二个快速访问列表使您能够通过单击以下内容来打开新文档:

    • 新建数据库笔记本

    • 新建 SQL 脚本

    • 新建 TS 脚本

    • 新建 JS 脚本

  • 保存此笔记本:将当前数据库笔记本文档下载到您在 Visual Studio Code 中建立为默认工作区的文件夹中。此特殊 JSON 文档包含还原笔记本所需的所有数据,包括所有加载的结果数据和最后一个编辑器状态(选择、插入符号位置等)。

    此操作允许您在必要时在对话框中指定文件名和备用路径。文件类型默认为(并且必须是).mysql-notebook

  • 从文件中加载新的笔记本:将先前下载的数据库笔记本 (.mysql-notebook) 文档加载到选择该操作的连接选项卡中,替换当前的笔记本。此外,它还会在“打开的编辑器”树和工具栏的 编辑器 列表中添加一个新的数据库笔记本条目。

  • 执行当前块中的选择或所有内容并创建一个新的块:提供一种简单的方法来执行块内的整个查询或查询的子集,然后在查询下方添加一个使用相同语言的新提示输出块。

    仅限 SQL 模式的笔记本编辑器:此操作不适用于运行脚本编辑器时。

  • 执行插入符号位置处的语句:使用键盘光标的位置来标识和执行查询。

    仅限 SQL 模式。

  • 执行块并将结果打印为文本:提供一种简单的方法来执行块内的整个查询或查询的子集,然后以文本形式查看结果。

    仅限 SQL 模式。

  • 停止执行当前语句/脚本:在语句或脚本执行开始之前不活动。

    仅限 SQL 模式。

  • 如果出现错误,则停止执行当前语句/脚本:默认情况下未启用。

    仅限 SQL 模式。

  • 提交数据库更改:在您执行更改数据的查询之前不活动。

    仅限 SQL 模式。

  • 回滚数据库更改:在您将更改提交到数据库之前不活动。

    仅限 SQL 模式。

  • 自动提交数据库更改:启用后,每个语句都会立即提交。

    仅限 SQL 模式。

  • 格式化当前块或脚本:默认情况下,关键字会更改为大写。

    仅限 TypeScript 和 JavaScript 模式。

  • 查找:打开“查找”面板,该面板支持匹配大小写、匹配整个单词和使用正则表达式。向上和向下箭头使您能够跨块导航到找到的每个匹配实例。

  • 显示隐藏字符:启用后,将显示不可见字符,例如换行符、空格和制表符。新行表示为 [LF],空格表示为单个点 (.),制表符表示为右箭头。

  • 自动换行:启用后,会在编辑器中对长行进行换行,从而无需滚动。建议对长文件禁用此功能。