跳到主要内容

SQL 控制台

SQL 控制台是一个强大的 SQL 编辑器，它支持专门为 Apache Doris 开发的智能提示、语法高亮、查询历史、查询结果缓存等功能，让你可以方便的编写 SQL 语句、查看查询结果。

功能面板​

数据目录​

你可以看到数据库、表、视图等信息，鼠标移动到库、表、视图等对象上，会显示相应的操作按钮，你可以点击这些按钮进行相应的操作。也会显示对象的详细信息，如表的创建时间、行数、注释等。

信息

你可以将常用的表、视图等对象添加到置顶，方便快速查看。

sql-console

会话记录​

会话记录是你在 SQL 编辑器中打开的 Tab 的历史记录，你可以点击记录中的 SQL 语句，将其复制到 SQL 编辑器中执行。

query-session

查询历史​

查询历史是你在 SQL 编辑器中执行的 SQL 语句的历史记录，你可以点击记录中的 SQL 语句，查看该语句的 Profile 信息。

注意

非查询语句没有 Profile，查询失败的语句也没有 Profile。

query-history

查询 Profile​

信息

Profile 可视化功能在 Apache Doris 2.1 / SelectDB 4.0.0 以上版本支持。

在 Studio 发起的查询默认都开启了查询 Profile，这可能对单个查询的性能有轻微影响，点击“查询语句”可以进入执行计划页面。

下载按钮可以下载 Profile 信息，包括纯 TEXT 格式的 Profile 信息和可视化的 Profile 图片。

导入 Profile 按钮可以导入 TEXT 格式的 Profile 信息，导入后可以可视化查看 Profile。这有助你可视化分析从其它客户端的发起的查询。

profile
信息

我们正在和 Apache Doris 团队密切合作，对可视化的 Profile 进行增强和标准化，敬请期待。

查询模版​

我们在 Studio 中预先内置了一些测试数据集的样例查询语句，有助于你做一些简单的性能测试。

sql-templates

SQL 编辑器​

我们为 Apache Doris 定制了 SQL 编辑器，支持语法高亮、智能提示、查询历史、查询结果缓存等功能。

查询窗口​

  • 你可以通过选择不同的集群来执行不同的查询任务，一些大的查询可能会影响到集群的性能，你可以选择一个性能较好的集群来执行查询。（仅在支持存算分离的 Doris 版本上看到此下拉框）

  • 每个查询窗口都是独立的，你可以在不同的查询窗口中执行不同的 SQL 语句，每个窗口的查询结果都会被缓存，你可以通过切换 Tab 来查看不同的查询结果而不需要再次发起查询。

  • 你可以拖动查询窗口的 Tab 来调整查询窗口的顺序。

  • 你可以双击查询窗口的 Tab 来修改该窗口的名称。

  • 你可以拖动 SQL 编辑器和查询结果面板的分割线来调整它们的大小。

  • SQL 编辑器的执行按钮有两种状态，分别是“执行”和“执行全部”。如果你选中了部分 SQL 语句，执行按钮会变成“执行”，只会执行选中的 SQL 语句；如果没有选中 SQL 语句，执行按钮会变成“执行全部”，会执行所有 SQL 语句。

SQL 输入框​

  • 你可以使用快捷键 ⌘(Command) + C 复制，⌘(Command) + V 粘贴，⌘(Command) + X 剪切。

  • 你可以鼠标右键呼出输入框的上下文菜单，点击 Command Palette 打开命令面板，可以查看所有支持的命令。

sql-console-command

智能提示​

  • 默认情况下，智能提示将根据你的输入自动提示关键字、表名、字段名等信息。但你也可以使用 ⇧(Shift) + Space 来手动触发智能提示。

  • SQL 编辑器的智能提示将根据你选择的数据库进行提示。比如，当你执行 SELECT * FROM 时，智能提示会提示下拉框选中的 __internal_schema 库中的表，当你继续输入WHERE时，智能提示会提示表的字段。但是对于一些 DDL 语句，智能提示可能会忽略上方选中的数据库，比如当你输入 USE 时，智能提示会提示会同时提示给你 catalog 和 当前选中的 catalog __internal_schema 下的 database。

sql-suggestion

结果面板​

在结果面板中，你可以看到 SQL 语句的执行结果，包括查询结果、执行时间、影响行数等信息。

你还可以通过搜索框搜索结果，或者点击表头排序结果。

sql-console-result

使用限制​

  • SQL 编辑器默认最多查询 1000 条数据，如果查询结果超过 1000 条，只会显示前 1000 条数据，你可以点击“查询并下载”按钮下载查看所有数据。
sql-console-result-download