#
数据查询#
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
⑥ 当前数据源类型