预发布:2024-07-17
操作输出是指您在代码块中看到的文本,例如,来自失败的 SQL 查询的错误输出;运行 Python、JavaScript 或 TypeScript 代码的结果;或长时间运行的远程命令的状态信息。输出条目具有不同的颜色,具体取决于其类型。
状态消息为灰色
成功消息为绿色
警告消息为黄色
错误消息为红色
输出使用等宽字体,以便与普通文本区分开来。例如,在 DB 笔记本编辑器中发出 USE sakila
(然后按 Ctrl+Enter)将在 SQL 查询下方直接返回一个简单的状态消息作为独立输出。
从 GUI 控制台会话发出的命令、脚本和简单的 SQL 语句也会返回状态、成功、警告和错误消息作为独立输出。返回的确切消息文本可能有所不同,具体取决于您是从控制台会话还是笔记本编辑器中发出命令或查询。
对于单个代码块内的 SQL 查询,如果存在错误,操作输出可以作为独立输出出现,也可以出现在 输出 选项卡中作为 SQL 执行结果的一部分。例如,使用未知数据库发出的简单 USE
语句将在语句下方返回一个错误消息作为独立输出。
将鼠标悬停在错误消息上以应用焦点并为文本添加下划线。通过单击错误文本,您可以选择导致输出的查询。此行为非常适合于调试包含多个 SQL 语句的代码块的任务。当查询返回多个错误时,每个条目都以索引号为前缀。显示的输出项的索引也是代码块中语句的索引。
JavaScript、TypeScript 和 Python 代码由单个文本块组成,无法从此功能中受益。
如以下示例所示,选择索引为 #2
的错误将标识原始代码块(语言提示下方会出现一个滚动条),并将突出显示该代码块中的第二个失败语句 (SELECT B;
)。
当一个复杂的 SQL 查询生成多个良好的结果数据集时,每个数据集都会出现在一个单独的编号选项卡中。选项卡号表示生成结果数据的代码块中每个语句的顺序。一个单独的 输出 选项卡(显示为 SQL 执行结果的一部分)包含在操作期间生成的、如果需要则已索引的所有错误消息。
更改代码可能会改变编辑器与输出之间的关联,如果语句的顺序发生变化。