使用 SQL Editor (PREVIEW) 探索你的数据

你可以使用 TiDB Cloud 控制台内置的 SQL Editor，最大化挖掘数据价值。

在 SQL Editor 中，你无需本地 SQL 客户端即可针对数据库编写和运行 SQL 查询。你可以直观地以表格或图表形式查看查询结果，并轻松检查查询日志。

使用场景

SQL Editor 的推荐使用场景如下：

• 快速测试 TiDB 的 MySQL 兼容性。
• 使用你自己的数据集轻松探索 TiDB 中的 SQL 功能。

限制

• SQL Editor 目前处于公测阶段，可以在 AWS 上的 TiDB Cloud Starter 实例上使用。如需在 TiDB Cloud Dedicated 集群上使用 SQL Editor，请联系 TiDB Cloud 支持。

访问 SQL Editor

1. 进入 My TiDB 页面。

   小贴士

   如果你属于多个组织，请先使用左上角的下拉框切换到目标组织。

2. 点击你的 TiDB Cloud Starter 实例或 TiDB Cloud Dedicated 集群名称，然后在左侧导航栏中点击 SQL Editor。

   注意

   在以下情况下，SQL Editor 入口会显示为灰色且不可点击。

   • 你的 TiDB Cloud Dedicated 集群版本早于 v6.5.0。要使用 SQL Editor，你需要联系 TiDB Cloud 支持 升级集群。
   • 你的 TiDB Cloud Dedicated 集群刚刚创建，SQL Editor 的运行环境仍在准备中。在这种情况下，请等待几分钟，SQL Editor 即可使用。
   • 你的 TiDB Cloud Dedicated 集群已暂停。

编写并运行 SQL 查询

在 SQL Editor 中，你可以使用自己的数据集编写并运行 SQL 查询。

1. 编写 SQL 查询。

2. 运行 SQL 查询。

   对于 macOS：

   • 如果编辑器中只有一条查询，要运行它，请按 ⌘ + Enter 或点击 Run。

   • 如果编辑器中有多条查询，要按顺序运行其中一条或多条，请用光标选中目标查询所在的行，然后按 ⌘ + Enter 或点击 Run。

   • 要按顺序运行编辑器中的所有查询，请按 ⇧ + ⌘ + Enter，或用光标选中所有查询所在的行后点击 Run。

   对于 Windows 或 Linux：

   • 如果编辑器中只有一条查询，要运行它，请按 Ctrl + Enter 或点击 Run。

   • 如果编辑器中有多条查询，要按顺序运行其中一条或多条，请用光标选中目标查询所在的行，然后按 Ctrl + Enter 或点击 Run。

   • 要按顺序运行编辑器中的所有查询，请按 Shift + Ctrl + Enter，或用光标选中所有查询所在的行后点击 Run。

运行查询后，你可以立即在页面底部看到查询日志和结果。

管理 SQL 文件

在 SQL Editor 中，你可以将 SQL 查询保存到不同的 SQL 文件中，并按如下方式管理 SQL 文件：

• 要添加 SQL 文件，请在 SQL Files 选项卡上点击 +。
• 要重命名 SQL 文件，请将光标移动到文件名上，点击文件名旁边的 ...，然后选择 Rename。
• 要删除 SQL 文件，请将光标移动到文件名上，点击文件名旁边的 ...，然后选择 Delete。请注意，当 SQL Files 选项卡上只有一个 SQL 文件时，你无法将其删除。

管理 SQL Editor 设置

在 SQL Editor 中，你可以更改以下设置：

• 查询结果中的最大行数
• 是否在 Schemas 选项卡上显示系统数据库模式

要更改设置，请执行以下步骤：

1. 在 SQL Editor 右上角，点击 ... 并选择 Settings。
2. 根据需要更改设置。
3. 点击 Save。