跳至主要内容
跳至主要内容
编辑此页

SQL 控制台

SQL 控制台是在 ClickHouse Cloud 中探索和查询数据库的最快、最简单的方法。您可以使用 SQL 控制台来

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

探索表​

查看表列表和模式信息​

您可以在左侧边栏区域找到您的 ClickHouse 实例中包含的表的概述。使用左侧栏顶部的数据库选择器来查看特定数据库中的表

列表中的表也可以展开以查看列和类型

探索表数据​

单击列表中的表可在新标签页中打开它。在表视图中，可以轻松查看、选择和复制数据。请注意，复制到电子表格应用程序（如 Microsoft Excel 和 Google Sheets）时，结构和格式都会被保留。您可以使用页脚中的导航在表数据页面之间切换（分页，每次 30 行）。

检查单元格数据​

可以使用单元格检查器工具来查看单个单元格中包含的大量数据。要打开它，请右键单击单元格并选择“检查单元格”。可以通过单击检查器内容右上角的复制图标来复制单元格检查器的内容。

过滤和排序表​

排序表​

要在 SQL 控制台中对表进行排序，请打开表并选择工具栏中的“排序”按钮。此按钮将打开一个菜单，允许您配置排序。您可以选择要排序的列并配置排序顺序（升序或降序）。选择“应用”或按 Enter 键以对表进行排序

SQL 控制台还允许您将多个排序添加到表。再次单击“排序”按钮以添加另一个排序。

注意

排序将按照它们在排序窗格中出现的顺序（从上到下）应用。要删除排序，只需单击排序旁边的“x”按钮。

过滤表​

要在 SQL 控制台中过滤表，请打开表并选择“过滤”按钮。与排序一样，此按钮将打开一个菜单，允许您配置过滤器。您可以选择要过滤的列并选择必要的标准。SQL 控制台会智能地显示与列中包含的数据类型相对应的过滤器选项。

如果您对过滤器感到满意，可以选择“应用”以过滤数据。您还可以添加其他过滤器，如下所示。

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

同时过滤和排序​

SQL 控制台允许您同时过滤和排序表。为此，请使用上述步骤添加所有所需的过滤器和排序，然后单击“应用”按钮。

从过滤器和排序创建查询​

SQL 控制台可以将您的排序和过滤器直接转换为查询，只需单击一下即可。只需从工具栏中选择“创建查询”按钮，并选择所需的排序和过滤参数。单击“创建查询”后，将打开一个新的查询选项卡，其中预填充了与表视图中包含的数据相对应的 SQL 命令。

注意

使用“创建查询”功能时，过滤器和排序不是必需的。

您可以通过阅读 (link) 查询文档来了解有关 SQL 控制台中查询的更多信息。

创建和运行查询​

创建查询​

SQL 控制台中创建新查询有两种方法。

  • 单击选项卡栏中的“+”按钮
  • 从左侧边栏查询列表中选择“新建查询”按钮

运行查询​

要运行查询，请将您的 SQL 命令输入到 SQL 编辑器中，然后单击“运行”按钮或使用快捷键 cmd / ctrl + enter。要按顺序编写和运行多个命令，请确保在每个命令后添加一个分号。

查询执行选项 默认情况下，单击运行按钮将运行 SQL 编辑器中包含的所有命令。SQL 控制台支持其他两种查询执行选项

  • 运行选定的命令
  • 运行光标处的命令

要运行选定的命令，请突出显示所需的命令或命令序列，然后单击“运行”按钮（或使用 cmd / ctrl + enter 快捷键）。当存在选择时，您还可以从 SQL 编辑器上下文菜单（通过右键单击编辑器中的任何位置打开）中选择“运行所选内容”。

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

  • 从扩展的运行选项菜单中选择“光标处”（或使用相应的 cmd / ctrl + shift + enter 键盘快捷键
  • 从 SQL 编辑器上下文菜单中选择“光标处”
注意

执行时，光标处的命令将闪烁黄色。

取消查询​

查询运行时，查询编辑器工具栏中的“运行”按钮将被替换为“取消”按钮。只需单击此按钮或按 Esc 即可取消查询。请注意：任何已经返回的结果在取消后将保留。

保存查询​

保存查询可让您以后轻松找到它们并与您的团队成员共享。SQL 控制台还允许您将查询组织到文件夹中。

要保存查询，只需单击工具栏中“运行”按钮旁边的“保存”按钮。输入所需的名称，然后单击“保存查询”。

注意

使用快捷键 cmd / ctrl + s 也会保存当前查询选项卡中的任何工作。

或者，您可以同时命名和保存查询，方法是单击工具栏中的“未命名查询”，调整名称，然后按 Enter

查询共享​

SQL 控制台允许您轻松与团队成员共享查询。SQL 控制台支持四种访问级别，可以全局调整，也可以针对每个用户进行调整

  • 所有者（可以调整共享选项）
  • 写入权限
  • 只读权限
  • 无权限

保存查询后，单击工具栏中的“共享”按钮。将出现一个带有共享选项的模式

要调整对具有服务访问权限的所有组织成员的查询访问权限，只需调整顶部行中的访问级别选择器

应用上述操作后，现在所有具有访问 SQL 控制台权限的团队成员都可以查看（并执行）该查询。

要调整对特定成员的查询访问权限，请从“添加团队成员”选择器中选择所需的团队成员

选择团队成员后，应显示一个新项目，其中包含访问级别选择器

访问共享查询​

如果查询已与您共享，它将显示在 SQL 控制台左侧边栏的“查询”选项卡中

保存的查询也具有永久链接，这意味着您可以发送和接收共享查询的链接并直接打开它们。

查询中可能存在的任何参数的值会自动作为查询参数添加到保存的查询 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 控制台中从查询结果数据创建可视化效果。例如，我们将使用一个计算 NYC 出租车行程每周统计信息的查询

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

如果没有可视化，这些结果很难解释。让我们把它们变成图表。

创建图表​

要开始构建可视化内容，请从查询结果窗格工具栏中选择“图表”选项。将出现图表配置窗格

我们将从创建一个简单的条形图开始，跟踪 trip_total 随 week 的变化。为此，我们将 week 字段拖动到 x 轴，将 trip_total 字段拖动到 y 轴

大多数图表类型支持数值轴上的多个字段。为了演示，我们将 fare_total 字段拖动到 y 轴

自定义图表​

SQL 控制台支持十种图表类型，可以从图表配置窗格中的图表类型选择器中选择。例如，我们可以轻松地将之前的图表类型从条形图更改为面积图

图表标题与提供数据的查询名称匹配。更新查询名称将导致图表标题也更新

图表配置窗格的“高级”部分中还可以调整许多更高级的图表特征。首先，我们将调整以下设置

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

我们的图表将相应地更新

在某些情况下，可能需要独立地调整每个字段的轴刻度。这也可以通过在图表配置窗格的“高级”部分中为轴范围指定最小值和最大值来完成。例如，上面的图表看起来不错，但为了演示 trip_total 和 fare_total 字段之间的相关性，需要对轴范围进行一些调整

    © . This site is unofficial and not affiliated with ClickHouse, Inc.