SQL 控制台

在 SQL 控制台中运行查询并创建可视化。

SQL 控制台是在 ClickHouse Cloud 中浏览和查询数据库最快捷、最简单的方式。您可以使用 SQL 控制台来：

• 连接到您的 ClickHouse Cloud 服务
• 查看、过滤和排序表数据
• 只需点击几下即可执行查询，并将结果数据可视化
• 与团队成员共享查询，更高效地开展协作。

​

浏览表

​

查看表列表和 schema 信息

左侧边栏区域会显示 ClickHouse 实例中所包含表的概览。使用左侧栏顶部的数据库选择器，可查看特定数据库中的表。

还可以展开列表中的表，查看其列和类型。

​

查看表数据

在列表中点击某个表，即可在新标签页中将其打开。在表视图中，可以轻松查看、选择和复制数据。请注意，将数据复制粘贴到 Microsoft Excel 和 Google Sheets 等电子表格应用时，会保留其结构和格式。你可以使用页脚中的导航在表数据的各页之间切换 (每页 30 行) 。

​

查看单元格数据

Cell Inspector 工具可用于查看单个单元格中的大量数据。要打开它，请右键单击某个单元格并选择“Inspect Cell”。点击查看器内容区域右上角的复制图标，即可复制 Cell Inspector 中的内容。

​

对表进行过滤和排序

​

对表进行排序

要在 SQL 控制台中对表排序，请打开某张表，然后选择工具栏中的“Sort”按钮。点击此按钮会打开一个菜单，你可以在其中配置排序。你可以选择用于排序的列，并设置排序顺序 (升序或降序) 。选择“Apply”或按 Enter，即可对表进行排序。

SQL 控制台还支持为一张表添加多个排序条件。再次点击“Sort”按钮即可添加另一个排序条件。

排序会按照其在排序窗格中的显示顺序应用 (从上到下) 。要移除某个排序，只需点击该排序旁边的“x”按钮。

​

过滤表

要在 SQL 控制台中过滤表，请打开一个表，然后选择“Filter”按钮。与排序类似，此按钮会打开一个菜单，供你配置过滤器。你可以选择用于过滤的列，并设置所需条件。SQL 控制台会根据列中包含的数据类型，智能显示相应的过滤选项。

设置好过滤器后，你可以选择“Apply”来过滤数据。你还可以像下图所示添加更多过滤器。

与排序功能类似，点击过滤器旁边的“x”按钮即可将其移除。

​

同时进行过滤和排序

SQL 控制台支持同时对表进行过滤和排序。为此，请按上述步骤添加所需的过滤器和排序条件，然后点击“Apply”按钮。

​

根据过滤器和排序创建查询

SQL 控制台可一键将所选的排序和过滤器直接转换为查询。只需在工具栏中选择“Create Query”按钮，并按需设置排序和过滤器参数。点击“Create Query”后，系统会打开一个新的查询标签页，并预先填入与你当前表视图中的数据相对应的 SQL 命令。

使用“Create Query”功能时，并不一定要先设置过滤器和排序。

如需进一步了解如何在 SQL 控制台中编写查询，请参阅 (链接) 查询文档。

​

创建并运行查询

​

创建查询

在 SQL 控制台中，可通过两种方式创建新查询。

• 点击标签栏中的 ’+’ 按钮
• 在左侧边栏的查询列表中选择 ‘New Query’ 按钮

​

运行查询

要运行查询，请在 SQL 编辑器中输入 SQL 命令，然后点击“运行”按钮，或使用快捷键 cmd / ctrl + enter。如果要依次编写并运行多条命令，请确保在每条命令后加上分号。

查询执行选项 默认情况下，点击运行按钮会执行 SQL 编辑器中的所有命令。SQL 控制台还支持另外两种查询执行方式：

• 运行选中的命令
• 运行光标所在位置的命令

要运行选中的命令，请选中所需的单条命令或一组命令，然后点击“运行”按钮 (或使用 cmd / ctrl + enter 快捷键) 。存在选中内容时，也可以在 SQL 编辑器的上下文菜单中 (在编辑器内任意位置右键打开) 选择“运行所选内容”。

运行当前光标位置的命令可以通过以下两种方式实现：

• 在扩展运行选项菜单中选择“在光标处” (或使用对应的 cmd / ctrl + shift + enter 键盘快捷键

• 在 SQL 编辑器的上下文菜单中选择“在光标处运行”

执行时，光标所在位置的命令会闪烁为黄色。

​

取消查询

查询运行期间，查询编辑器工具栏中的“运行”按钮会变为“取消”按钮。只需点击此按钮或按 Esc，即可取消查询。注意：取消后，已返回的结果仍会保留。

​

保存查询

保存查询后，你可以稍后轻松找到它们，并与团队成员共享。SQL 控制台还支持将查询整理到文件夹中。

要保存查询，只需点击工具栏中紧挨着“运行”按钮的“Save”按钮。输入所需名称，然后点击“Save Query”。

使用快捷键 cmd / ctrl + s 也可以保存当前查询标签页中的所有内容。

或者，你也可以点击工具栏中的“Untitled Query”，修改名称后按 Enter，同时完成查询命名和保存：

​

查询共享

SQL 控制台允许你轻松与团队成员共享查询。SQL 控制台支持四种访问级别，既可全局调整，也可针对单个用户分别设置：

• 所有者 (可调整共享选项)
• 写入权限
• 只读权限
• 无权限

保存查询后，点击工具栏中的“共享”按钮。此时会弹出一个包含共享选项的模态窗口：

如需为组织中所有有权访问该服务的成员调整查询访问权限，只需调整顶部一行中的访问级别选择器：

应用上述设置后，所有有权访问该服务的 SQL 控制台的团队成员都可以查看 (并执行) 该查询。

如需为特定成员调整查询访问权限，请在“添加团队成员”选择器中选择所需的团队成员：

选择团队成员后，应会出现一个新的条目，其中包含访问级别选择器：

​

访问共享的查询

如果有人向你共享了查询，该查询会显示在 SQL 控制台左侧边栏的“Queries”选项卡中：

​

链接到查询 (永久链接)

已保存的查询也支持永久链接，这意味着你可以发送和接收指向共享查询的链接，并直接打开这些查询。

查询中存在的任何参数值都会自动作为查询参数添加到已保存查询的 URL 中。例如，如果某个查询包含 {start_date: Date} 和 {end_date: Date} 参数，则永久链接可能如下所示：https://console.clickhouse.cloud/services/:serviceId/console/query/:queryId?param_start_date=2015-01-01&param_end_date=2016-01-01。

​

高级查询功能

​

搜索查询结果

查询执行后，你可以使用结果面板中的搜索框快速搜索返回的结果集。此功能可用于预览附加 WHERE 子句的结果，或者仅用于检查结果集中是否包含特定数据。在搜索框中输入值后，结果面板会更新，并返回包含与输入值匹配条目的记录。在此示例中，我们将查找 hackernews 表中所有包含 ClickHouse (不区分大小写) 的评论里出现的 breakfast：

注意：只要任意字段与输入值匹配，该记录就会被返回。例如，上方截图中的第三条记录虽然在 by 字段中不匹配 breakfast，但在 text 字段中匹配：

​

调整分页设置

默认情况下，查询结果面板会在单页中显示所有结果记录。对于较大的结果集，使用分页会更便于查看。这可以通过结果面板右下角的分页选择器来实现：

选择页面大小后，结果集会立即启用分页，导航选项会显示在结果面板页脚的中间位置

​

导出查询结果数据

可以直接在 SQL 控制台中将查询结果集导出为 CSV 格式。为此，请打开结果面板工具栏右侧的 ••• 菜单，然后选择“下载为 CSV”。

​

可视化查询数据

有些数据用图表形式更容易理解。只需点击几下，你就可以直接在 SQL 控制台中根据查询结果快速创建可视化图表。下面我们以一个用于计算纽约市出租车行程每周统计信息的查询为例：

SELECT
   toStartOfWeek(pickup_datetime) AS week,
   sum(total_amount) AS fare_total,
   sum(trip_distance) AS distance_total,
   count(*) AS trip_total
FROM
   nyc_taxi
GROUP BY
   1
ORDER BY
   1 ASC

如果不进行可视化，这些结果就很难解读。让我们把它们转换为图表。

​

创建图表

要开始构建可视化，请在查询结果面板的工具栏中选择“Chart”选项。随后会显示图表配置面板：

我们先创建一个简单的条形图，按 week 展示 trip_total。为此，将 week 字段拖到 x 轴上，再将 trip_total 字段拖到 y 轴上：

大多数图表类型都支持在数值轴上放置多个字段。为了演示这一点，我们将 fare_total 字段拖到 y 轴上：

​

自定义图表

SQL 控制台支持十种图表类型，可在图表配置面板中的图表类型选择器中选择。例如，我们可以轻松将前一个图表从柱状图切换为面积图：

图表标题与提供数据的查询名称保持一致。更新查询名称后，图表标题也会随之更新：

在图表配置面板的“高级”部分，还可以调整一些更高级的图表属性。首先，我们将调整以下设置：

• 副标题
• 坐标轴标题
• x 轴标签方向

图表会相应更新：

在某些情况下，可能需要分别调整各个字段的坐标轴刻度。这可以在图表配置面板的“高级”部分中，通过为坐标轴范围指定最小值和最大值来实现。以上图表看起来不错，但为了更清楚地展示 trip_total 与 fare_total 字段之间的相关性，还需要对坐标轴范围做一些调整：