数据查询#

SDT#

数据查询页面中,我们称左侧数据库目录树为 SDT。

SDT 工具栏#

SDT 顶部工具栏:

  • 「主题色切换」:可切换 CloudQuery 整体页面为深色/浅色模式;
  • 点击「搜索」按钮,可搜索 SDT 已加载的数据库元素等
  • 新建查询:点击「新建查询」按钮,打开新的查询页面,可在右侧红框区域选择「连接」和「数据库」
  • 创建连接:点击「创建连接」按钮,选择对应数据库,进入「创建连接」页面,填写所需信息。连接默认公开,若勾选私有连接,则仅创建该连接的用户可见。点击「测试连接」可查看连接是否正常可用
  • 创建组信息:点击「添加组」按钮,弹出新增组信息面板,可自定义组名称,创建成功可在 SDT 菜单栏中查看改组
  • 层级目录收起:点击「收起节点」按钮,对展开的所有层级目录收起
  • 刷新菜单:点击「刷新」按钮,可刷新元素树和 SDT 各元素节点

SDT 菜单#

连接节点右键菜单:

  • 关闭连接:点击「关闭连接」,即表示切断与编辑器之间的会话,将无法对此连接中的数据库中的内容进行查看或操作;
  • 新建查询:在编辑框中新建查询页面
  • 打开终端:当编辑区不能满足操作需求时,可打开终端进行操作。
  • 连接管理:点击此按钮,则会跳转至 Owner 设置栏 →「连接管理」界面,查看此连接的相关信息或进行相关操作;
  • 移动到组:将此连接移动到相应的组中
  • 复制名称:复制该连接的名称
  • 刷新:刷新该连接的信息

PL/SQL 编辑器:Oracle 数据源支持使用 PL/SQL 编辑器进行操作,即在 Oracle 数据源「连接层级右键菜单」中有「PL/SQL 编辑器」功能。

不同数据源支持的右键菜单可能会有所不同。

只有 Owner 才可打开「连接管理」。

只有创建此连接的人才能打开终端。

库层级右键菜单:

  • 新建查询:在编辑框中新建查询页面
  • 转储 SQL 文件:可将 SQL 文件重命名,并设置导出数据行数,转储到个人设置栏 →「个人文件夹」的 Export 文件夹内
  • 删除数据库:即删除此数据库
  • 添加数据库:输入数据库名,选择字符集,选择排序顺序,系统将会自动生成 SQL,点击确定后将会提示添加数据库成功

点击数据库左侧下拉按钮,展开该数据库特性元素;双击数据库名称,展开该数据库特性元素,同时在右侧页面会新建查询页面。以 MySQL 为例:MySQL 下数据库元素为表、视图、函数组、存储过程组,右键单击数据库元素,可进行添加、复制名称和刷新操作。

注意:不同数据库下展示的数据库元素不同,如 MySQL 数据源特性元素为表、视图、函数组和存储过程,Oracle 数据源特性元素为表、视图、物化视图、函数组、存储过程组、同义词、序列、数据库连接、包和包体。

表层级:点击「表」左侧下拉按钮或双击「表」,展开该数据库中所有表。

选择一张表(此处以『course』表为例),点击『course』表左侧下拉按钮,展开该表下元素信息;双击『course』表,展开该表下元素信息,同时在右侧打开一个查询页面执行『course』表全表查询。

表层级右键菜单:

  • 查看表:及打开表,对该表执行全表查询动作
  • 查看表结构:查看该表字段、索引、外键等信息
  • 转储 SQL 文件:可将 SQL 文件重命名,选择转储类型,并设置导出数据行数,转储到个人设置栏 →「个人文件夹」的 Export 文件夹内
  • 删除表:即删除该表
  • 添加表:即在『course』表所属数据库下新建表,通过填选方式设置表格字段,系统会自动生成 SQL 语句,点击「提交」即可成功创建表格
  • 截断表:即执行『 truncate table 』 动作
  • 清空表:即执行『 delete table 』 动作
  • 设计表:即无需通过编写 SQL 语句即可添加、修改、删除表字段信息
  • 重命名:即重命名该表
  • 复制名称:即复制该表名称
  • 刷新:刷新此列

编辑区#

「数据查询」页面中,我们称右侧上半部分区域为「编辑区」。

编辑工具栏#

「编辑区」顶部为编辑工具栏:

连接切换区#

① 选择连接:可在该下拉框选择对应连接
② 选择数据库:可在该下拉框选择对应数据库

语句执行区#

① 语句执行:在编辑情况内输入 SQL 语句,点击此按钮即可执行语句
② 语句终止:可终止执行耗时较长的语句
③ 执行计划:点击此按钮,可在结果集区域通过 Explain 展示 SQL 语句执行详情
④ 事务提交:在手动事务模式情况下,点击此按钮提交事务,同时在其下方显示当前事务语句
⑤ 回滚:在手动事务模式情况下,点击此按钮可回滚缓冲区语句,其下方显示当前事务语句
⑥ 事务模式:点击此按钮可切换自动/手动提交事务模式

辅助查询区#

辅助查询:点击可按钮,进入可视化辅助查询页面。可视化辅助查询主要针对 SQL 基础较弱的业务人员,可在界面上进行元素拖拽、连线、筛选等方式自动生成 SQL 语句并快捷执行。

数据库元素区#

选择数据库元素:左侧数据库展开后可选择指定数据库元素(表),以拖拽的方式放入画布区中,画布区会将表中包含的列元素自动展开。

画布区#

① 连线动作:表中列元素自动展开后可进行不同表间列元素连线,连线等同于连表查询中的关联条件。
② 勾选动作:选择需要查询的列进行勾选,勾选等同于 select 指定列元素。

结果编辑区#

针对本次语句的结果集进行再次筛选操作,操作可分为:

① SELECT :指定需要查询的字段,同时支持字段别名操作。

② FROM :查看当前画布中的表,同时支持表别名操作。

③ WHERE : 指定当前查询画布结果集添加限制条件,

④ GROUP BY : 指定当前查询画布结果集分组条件,支持标识符方式选择字段分组以及自定义分组。

⑤ HAVING : 条件筛选后以指定方式进行分组,支持标识符方式选择字段以及聚合方式(SUM)以及自定义函数,同时可支持「与」、「并」条件关系。

⑥ ORDER BY : 按照指定字段进行升/降序排序。

语句预览区#

根据画布区以及结果集编辑区的操作自动生成可执行 SQL。

操作区#

① 返回:返回 CloudQuery 数据操作页面。

② 重置:针对画布区、结果集编辑区进行重置操作。

③ 使用语句:快捷返回数据操作区,并将语句预览区生成的语句拼接至编辑区。

格式美化区#

① 格式化:可将 SQL 进行格式化

② 全部折叠/展开:可对 SQL 语句进行折叠/展开

③ 放大/缩小字体:可对 SQL 编辑区字体进行放大和缩小

收藏保存区#

① 添加收藏:可对编写的 SQL 语句进行收藏并设置别名,点击「设置别名」弹出「收藏语句」详情页,也对别名和语句进行编辑修改。

② 打开收藏:点击此按钮出现最近 10 条收藏语句列表,可在此进行语句搜索和删除操作,点击最下方「更多按钮」,弹出「收藏管理」页面

在「收藏管理」页面,可搜索收藏语句,对收藏的语句进行使用、删除操作

③ 打开文件:点击左侧按钮主体可打开最近使用的三个文件,点击更多按钮可打开个人文件夹,选择指定文件可将其内容打开至编辑区。点击向下角标可打开本地文件夹,选择文件后同样会将文件内容打开至编辑区。

④ 保存文件:点击左侧按钮主体可将编辑区的内容保存至个人文件夹,支持指定保存路径、文件名、文件编码。点击向下角标可将文件另存为另一独立文件,同样可支持指定保存路径、文件名以及文件编码。

编辑框#

编辑框内可支持手动输入 SQL 语句、执行进度展示、自动提示、快捷键操作。

① 执行进度展示:以绿色光标展示当前执行进度。

② 自动提示:自动提示可根据当前选择数据源语法、语义进行对应数据库元素/关键字提示。

③ 快捷键操作:编辑区内可支持 复制(Ctrl/Command+C)、粘贴(Ctrl/Command+V)、剪切(Ctrl/Command+X)、撤销(Ctrl/Command+Z)、执行(Ctrl/Command+I)快捷键。

结果集和执行日志#

「数据查询」页面中,我们称右侧下半部分区域为「结果集区」。

结果集#

结果集用来渲染当次执行的执行返回结果,结果集数量与执行语句条数对应。结果集右侧有权限状态栏、记录总数。

① 权限状态栏:分为「增」、「删」、「改」、「导」四个字符,分别对应「新增数据」、「删除数据」、「修改数据」、「导出数据」四个动作,字体为白色、亮起则为拥有该权限,字体为暗色、灰灭附加斜删除线则为不具有该权限。

② 记录总数:展示本条查询语句返回结果集总数。

结果集内支持操作:

① 刷新:针对本条查询语句的结果集进行刷新,重新获取结果集。

② 新增:新增一条数据记录。

③ 删除:删除选中行数据记录。

④ 确认:确认本次对结果集的修改/新增动作。

⑤ 取消:取消本次对结果集的修改/新增动作。

⑥ 查看详情:查看单元格数据详情,如字段格式为二进制字段可进行对应格式渲染。

⑦ 导出:针对本次查询结果集进行导出。

执行日志#

执行日志可记录登陆以来每次执行的时间、语句明细、执行结果、耗时信息。支持筛选仅错误日志、清空日志。

① 仅错误:筛选执行日志中执行失败的语句记录进行展示。

② 清空日志:针对当前执行日志区数据进行清空操作。

树对象信息#

「数据查询」页面中,我们称最右侧区域为「树对象信息」,可展开,是针对当前 CloudQuery 平台纳管数据库元素进行对象信息展示,目前可涵盖连接、数据库、表、列、视图、存储过程以及各数据库特性元素。

状态栏#

「数据查询」页面中,我们称最底部区域为「状态栏」,展示如下信息:

① 展示正在执行的语句

② 记录该语句的执行耗时

③ 编辑框内光标位置

④ 字符集:点击可选择指定字符集

⑤ 文件编码:点击可选择 LF 或 CRLF

⑥ 当前数据源类型