跳到主要内容

SQL 控制台

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

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

从控制面板打开 SQL 控制台​

您可以直接从您的服务概述屏幕打开 SQL 控制台。只需点击“连接”按钮，然后选择“打开 SQL 控制台”。

Open the SQL console from a service

SQL 控制台将在新标签页中打开，并提示您输入服务凭据

Enter credentials

输入凭据后，点击“连接”，SQL 控制台将尝试连接并进行身份验证。如果成功，您现在应该可以看到 SQL 控制台界面

Authentication success

直接加载 SQL 控制台​

您也可以通过导航到 https://console.clickhouse.cloud. 直接加载 SQL 控制台。登录到您的 ClickHouse Cloud 帐户后，您将看到一个服务列表。选择其中一个，并在服务身份验证屏幕上输入您的服务凭据

Select a service

注意

如果您的组织中只存在一个服务，SQL 控制台将立即将您重定向到服务身份验证屏幕

使用服务切换器​

您可以直接从 SQL 控制台中轻松切换服务。只需打开控制台右上角的服务切换器，然后选择不同的服务

Switch services

探索表​

查看表列表和架构信息​

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

table list and schema

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

view columns

探索表数据​

点击列表中的表以在新标签页中打开它。在“表视图”中，可以轻松地查看、选择和复制数据。请注意，在复制粘贴到 Microsoft Excel 和 Google Sheets 等电子表格应用程序时，会保留结构和格式。您可以使用页脚中的导航在表数据页之间翻页（以 30 行为增量分页）。

abc

检查单元格数据​

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

inspecting cell content

过滤和排序表​

排序表​

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

sort descending on a column

SQL 控制台还允许您向表添加多个排序。再次点击“排序”按钮添加另一个排序。注意：排序按它们在排序窗格中的显示顺序（从上到下）应用。要删除排序，只需点击排序旁边的“x”按钮。

过滤表​

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

filter on the radio column equal to GSM

当您对过滤满意时，可以选择“应用”来过滤数据。您也可以添加其他过滤，如下所示。

Add a filter on range greater than 2000

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

一起过滤和排序​

SQL 控制台允许您同时过滤和排序表。要执行此操作，请使用上面描述的步骤添加所有所需的过滤和排序，然后点击“应用”按钮。

Filtering and sorting together

从过滤和排序创建查询​

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

Create a query from sorts and filters

注意

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

您可以阅读 (链接) 查询文档，详细了解如何在 SQL 控制台中查询。

创建和运行查询​

创建查询​

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

  • 点击标签栏中的“+”按钮

  • 从左侧边栏查询列表中选择“新建查询”按钮

    Creating a query

运行查询​

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

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

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

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

run selected query

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

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

    run at cursor

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

    run at cursor

注意

光标位置处的命令将在执行时闪烁黄色。

取消查询​

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

Cancel a query

保存查询​

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

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

注意

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

Save query

或者，您可以通过单击工具栏中的“无标题查询”来同时命名和保存查询，调整名称，然后按 Enter 键。

Rename query

查询共享​

SQL 控制台允许您轻松地与团队成员共享查询。SQL 控制台支持四种访问级别，这些级别可以在全局和每个用户的基础上进行调整。

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

保存查询后，单击工具栏中的“共享”按钮。将出现一个包含共享选项的模态窗口。

Share query

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

Edit access

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

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

Add team member

选择团队成员后，应出现一个包含访问级别选择器的新行项目。

Edit team member access

访问共享查询​

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

Access 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 子句的结果，或简单地检查以确保结果集中包含特定数据。在搜索输入中输入值后，结果窗格将更新并返回包含与输入值匹配的条目的记录。在此示例中，我们将查找 ClickHouse 存储库的github_events 表中所有alexey-milovidov 的实例。

Search GitHub data

注意：任何与输入值匹配的字段都将被返回。例如，上面截图中的第三条记录在actor_login 字段中没有与“alexey-milovidov” 匹配，但在body 字段中匹配。

Match in body

调整分页设置​

默认情况下，查询结果窗格将在单个页面上显示每个结果记录。对于较大的结果集，最好对结果进行分页，以便于查看。这可以通过使用结果窗格右下角的分页选择器来实现：分页选项

选择页面大小将立即将分页应用于结果集，并且导航选项将出现在结果窗格页脚的中间。

Pagination navigation

导出查询结果数据​

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

Download as 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

Tabular query results

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

创建图表​

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

Switch from query to chart

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

Trip total by week

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

Bar chart

自定义图表​

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

Change from Bar chart to Area

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

Update query name

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

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

我们的图表将相应更新。

Update subtitle etc.

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

Adjust axis scale