数据查询是 ByteHouse 企业版控制台提供的 SQL 编辑器，支持编写和执行 SQL 查询并查看结果，帮助您高效执行 SQL 查询并管理查询结果，提升数据处理效率。本文介绍了如何使用数据查询窗口。

执行查询前，您需要先选择集群，您可在界面右上角单击下拉列表选择您的数据所在的集群。

在 ByteHouse 工作表中，您可以执行新建、命名、保存、共享、归档、删除等操作。工作表可被保存在云端，在其他浏览器上登录火山账号，即可看到被保存的工作表。

新建并命名工作表 #

在工作表页面的顶部导航栏右侧，单击加号按钮，即可新建工作表。您可在选项卡栏中单击工作表标题，为工作表自定义名称（例如 销售分析 ）。如需修改已设置的工作表名，可再次单击工作表名称，修改名称。

保存工作表 #

1. 在命令执行区域的工具栏中，单击保存图标。
   
2. 在弹窗中输入工作表的名称，单击保存，即可将工作表保存至云上。
3. 在界面左侧的工作表页签中，可以看到所有当前账号所在的当前集群中保存的工作表。
   

打开已保存的工作表 #

工作表保存后，如需打开已关闭的工作表，请在工作表页签下，单击工作表名称，即可打开。

归档工作表 #

您可在已保存工作表中创建文件夹，并将工作表移动至文件夹中，便于管理工作表。
操作步骤：

1. 在工作表页签下，单击文件夹图标，创建文件夹。
   
2. 将鼠标悬停在工作表名称上，单击工作表后的 ... 按钮，单击移动至，选择文件夹，单击确定，即可将工作表移动至对应的文件夹。
   您也可以长按工作表名称，拖动工作表至目标文件夹，实现归档工作表。
   
3. （可选）如需修改已设置的文件夹名称，将鼠标悬停在文件夹名称上，单击 ... 按钮，单击重命名，即可修改文件夹名称。
   
4. （可选）如需删除文件夹，将鼠标悬停在文件夹名称上，单击 ... 按钮，单击删除，勾选删除全部工作表，并单击确定，即可删除当前文件夹。
   

   注意

   删除文件夹将同时删除该文件夹及其中的全部工作表，且该操作不可逆，请谨慎操作。
   如果您仍需使用该文件夹下的工作表，请在删除文件夹前，根据步骤 1-2，将工作表移动至其他文件夹。
   

删除工作表 #

如需删除工作表。单击工作表后的 ... 按钮，单击删除，即可删除工作表。

节点是集群中的一台服务器，是构成 ByteHouse 集群的计算和存储单元。执行查询前，需选择合适的查询发送模式：

• 自动分配节点：默认发送模式，通过网关，选择一个节点发送查询。
• 选择一个节点：单击展开下拉列表，单击选择一个节点，按需选择您的节点。通常用于排查错误。
• 全部节点：将查询发送到所有集群下的节点，可用于取代 on cluster 语法发送 DML 命令，也可以用于排障。

  注意

  选择全部节点时，如果您执行插入数据操作，会造成数据重复，请谨慎选择。

工作表中显示的查询详情与结果仅对当前用户会话有效。如果您退出 ByteHouse 控制台界面后重新登录，则上一个会话的结果将不再显示在工作表中；但是，您可以通过 SQL 历史功能查看已执行的查询，详情请参见SQL 历史。

执行查询 #

在数据查询页面中，在选择集群并选择执行查询的节点后，您可在工作表窗口中，输入 SQL 语句，单击运行即可执行查询。

如果您输入了多条 SQL 语句，系统默认执行您选中的语句。如需执行所有查询，请选中所有查询复选框。

中止执行中的查询 #

当查询正在运行时，运行按钮右侧会新增中止按钮，单击此按钮可中止运行中的查询。

查看查询结果 #

查询执行完成后，您可在 SQL 编辑器下方查询结果中查看到具体信息。

您可单击搜索按钮，按需在表格中查找结果。

您也可以单击查询结果页面的以下按钮：

• 隐藏列：隐藏查询结果中显示的列名。您可单击隐藏列，去勾选列名，查询结果将及时同步。
  
• 复制该行：在查询结果中选中某行的任意单元格，单击复制该行，即可复制选中行的数据。
• 复制该列：在查询结果中选中某列的任意单元格，单击复制该列，即可复制选中列的数据。
• 复制选中：在查询结果中选中数据，单击复制选中，即可复制您选中的数据。
• 下载：对于查询成功的结果，您可单击查询结果页中的下载按钮，将查询结果以 CSV 格式的文件下载到本地，进行二次分析和使用。

可视化查询结果 #

ByteHouse 支持以柱状图和折线图的形式查看数据结果。
查询执行完成后，您可在 SQL 编辑器下方数据可视化中设置图表类型、X 轴、Y 轴，将查询结果以可视化图表形式展示。可视化结果示例如下：

查看查询简报及详情 #

单击查询结果右侧的展开图标，可查看查询简报。

单击查询详情，您可查看查询摘要、诊断结果、查询时负载、执行计划等查询详情，可用于排障、优化查询。

移除查询 #

当您执行的查询过多，导致页面缓存过多时，您可删除查询结果，提升页面加载速度，删除后的查询结果可在 SQL 历史中查看。SQL 历史功能详情请参见 SQL 历史。
单击某条查询右侧的 x 号，单击确定，即可删除当前查询。

您可使用对象浏览器浏览您创建和被共享的所有数据对象，包括数据库、表、预处理查询、UDF、物化视图等数据资源。您可将鼠标悬浮在表名称上方，查看数据的预览信息，例如表的列信息、表信息、底表、DDL等。您也可单击数据对象右侧的插入按钮，将数据对象插入 SQL 编辑器。
当工作表的内容发生变化时，数据库及其他对象的列表会自动刷新。您还可以单击对象浏览器上部的刷新按钮，立即查看对象的更改内容。