Skip to content

Commit

Permalink
update sql-editor
Browse files Browse the repository at this point in the history
  • Loading branch information
yangj1211 committed Jun 26, 2024
1 parent 93ba8ee commit eb84dc6
Showing 1 changed file with 30 additions and 9 deletions.
39 changes: 30 additions & 9 deletions docs/MatrixOne-Cloud/Data-Explore/sql-editor.md
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
# **SQL 编辑器**
# SQL 编辑器

SQL 编辑器是 MatrixOne cloud 平台非常重要的一个工具,你可以通过在线 SQL 编辑器,进行 SQL 语句的快速编写、执行、结果查看,还可以将常用的 SQL 语句保存在 WorkBook 中,方便后续使用、参考和对比。

Expand All @@ -10,7 +10,9 @@ SQL 编辑器是 MatrixOne cloud 平台非常重要的一个工具,你可以

SQL 编辑器模块的页面由 3 部分构成。

![Alt text](https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.12_1.png)
<div align="center">
<img src=https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.12_1.png width=70% heigth=70%/>
</div>

- **左侧区域**:显示当前实例已有的数据库表和工作薄,你可以快速查看和复制所关注的数据库名、表名、列名和已保存在工作薄中的 SQL 语句,点击左上角的角标可对左侧区域进行隐藏。

Expand All @@ -24,28 +26,33 @@ SQL 编辑器模块的页面由 3 部分构成。

在线 SQL 编辑器支持导入数据、库表查看和选择、SQL 语句编辑、在线执行、结果查看几项功能。

**在线导入数据**
### 在线导入数据

SQL 编辑器支持快速导入数据,启动数据分析。点击**导入数据**,即可启动导向式数据导入流程。

MatrixOne Cloud 在线数据导入支持两种导入方式:导入样例数据和导入自有数据。
![Alt text](https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.12_2.png)

<div align="center">
<img src=https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.12_2.png width=70% heigth=70%/>
</div>

- 导入样例数据:平台将提供典型开源数据集和互动式数据导入指引,无需准备数据即可体验 MatrixOne Cloud 的核心产品功能。现阶段已支持 TPC-H Benchmark 样例数据。

- 导入自有数据:现阶段 MatrixOne Cloud 支持你从本地客户端直接导入数据集,也可以从你自己的阿里云 OSS 中导入数据。

更多数据导入方式介绍可以参照导入数据章节。

**从 Database 中查看和选择库表**
### 从 Database 中查看和选择库表

在 SQL 编辑器中进行 SQL 语句编写过程中,开发者经常需要查看目标库表中的数据结构和数据类型,提升 SQL 语句编写的效率和准确性。

![Alt text](https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.12_3.png)
<div align="center">
<img src=https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.12_3.png width=70% heigth=70%/>
</div>

在左侧 Database 区域,当前实例的数据库和数据表将以树形结构呈现,你可以详细查看各个数据库的表结构及各个数据表中的数据类型,同时也可以复制需要的数据库名、表名和列名,快速在编辑器中粘贴使用。

**编辑和执行 SQL 查询**
### 编辑和执行 SQL 查询

右侧 SQL 编辑区域上方的下拉列表用于数据库选择,你可以在下拉列表中查看和选择目前 SQL 查询使用的数据库。选择数据库后,SQL 语句中可以不包括 dbname 执行,相当于已执行 `use database` 语句。

Expand All @@ -54,7 +61,9 @@ MatrixOne Cloud 在线数据导入支持两种导入方式:导入样例数据

进一步输入想要查询的 SQL 语句,点击执行按钮,MatrixOne Cloud 将直接在线执行对应 SQL 请求。

![Alt text](https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.12_4.png)
<div align="center">
<img src=https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.13_2.png width=70% heigth=70%/>
</div>

- 支持使用光标选中部分 SQL 执行,平台将会按顺序执行这些 SQL。
- 若光标位于 SQL 语句内,则执行该 SQL。
Expand All @@ -65,14 +74,26 @@ MatrixOne Cloud 在线数据导入支持两种导入方式:导入样例数据
!!! note
在线 SQL 编辑器目前不支持以下语句:[`explain`](../Reference/SQL-Reference/Other/Explain/explain.md)[`Load data local`]( ../Migrate-Data/Load-Local-Data.md), [`source`](../App-Develop/import-data/bulk-load/using-source.md)[`SELECT INTO...OUTFILE`](https://docs.matrixorigin.cn/1.1.3/MatrixOne/Develop/export-data/select-into-outfile/), [事务]( ../App-Develop/Transactions/matrixone-transaction-overview/how-to-use.md)以及[临时表](../App-Develop/schema-design/create-temporary-table.md)相关语句

**执行结果查看**
### 查询结果

右下侧查询结果区域可以查看当前查询的执行结果。若平台顺序执行了多条 SQL 语句,将分多个 Tab 展示和查看。

受页面长度限制,目前平台可视化查询结果暂只显示前 1000 行,你可以点击下载按钮,进行全量查询结果的导出。

若对查询结果耗时有进一步分析和优化需求,可点击查询结果 Tab 右侧的跳转按钮,进一步在查询历史模块查看查询详情和 Profile 可视化分析。

### 图表

MatrixOne Cloud 支持以图表形式展示的 SQL 查询结果,通过视觉化手段增强了数据的可访问性,是现代数据分析不可或缺的一部分。用户可以从结果列中挑选一列作为横轴进行数据分组,从结果列中选择多个列作为竖轴的聚合指标,同时为每项聚合指标单独配置相应的聚合运算。

<div align="center">
<img src=https://community-shared-data-1308875761.cos.ap-beijing.myqcloud.com/artwork/mocdocs/sqleditor/sql_editor_0.13_1.png width=70% heigth=70%/>
</div>

- 图表类型:默认为柱状图,同时支持饼图和折线图。

- 聚合函数:默认为 SUM,还支持 CNT(COUNT)、MIN、MAX、AVG。

## Workbook 管理

你在线编辑和执行的 SQL 语句都将保存在不同的 Workbook 中,方便后续进一步参考和使用。
Expand Down

0 comments on commit eb84dc6

Please sign in to comment.