使用 SQL Runner 管理数据库函数

SQL Runner 可让您直接访问数据库并以多种方式利用该访问权限。使用 SQL Runner，您可以轻松浏览架构中的表、使用 SQL 查询中的临时探索、对数据运行预先编写的描述性查询、查看 SQL Runner 历史记录、下载结果、共享查询、作为派生表添加到 LookML 项目，以及执行其他有用的任务。

本页面介绍了如何使用 SQL Runner 修改数据库架构和数据、使用 EXAMINE 语句查看数据库的执行计划，以及如何使用 SQL Runner 获取有关数据库的信息。请参阅以下文档页面，了解有关以下方面的信息：

修改数据库架构和数据

除了对数据库运行查询之外，SQL Runner 中的数据库标签页还允许您对数据库执行数据定义语言 (DDL) 和数据操纵语言 (DML) 语句。您可以使用 SQL Runner 进行架构更改（例如创建、删除和更改）和数据更改（例如插入、更新和删除）。SQL 方言对 DDL 和 DML 语句的支持各不相同，因此请参阅数据库的相关文档，了解哪些语句受支持。

Looker 无法控制允许用户在您的数据库上运行哪些 SQL 语句的授权。拥有 use_sql_runner 权限的 Looker 用户有权访问 SQL Runner，但 SQL Runner 不会控制用户可以执行哪些命令。如果您的数据库管理员希望阻止 SQL Runner 用户修改数据库架构，则管理员必须通过为数据库本身配置用户权限来实现此目的。

如需在 SQL Runner 中对数据库执行 DDL 或 DML 语句，请按以下步骤操作：

  1. 导航到 SQL Runner。
  2. 在 SQL Runner 中，点击数据库标签页。
  3. 在 SQL Runner 查询框中输入 DDL 或 DML 语句。（请参阅您的数据库方言文档，了解 DDL 和 DML 语句的支持和语法。）
  4. 点击运行，对数据库执行语句。

如果对数据库成功执行了语句，SQL 结果框将显示确认消息。

使用 EXPLAIN 检查执行计划

除了对数据库运行 SQL 查询之外，您还可以使用 SQL Runner 为查询运行 EXPLAIN 函数。大多数 SQL 方言都支持 EXPLAIN 函数，该函数会返回数据库的查询执行计划。

  1. 在“探索”中，运行查询，然后点击数据区域的 SQL 标签页，以查看该查询的 SQL 命令。

  2. 在“探索”的 SQL 标签页中，点击 Explain in SQL Runner 按钮。

    Looker 将打开 SQL Runner 并在 EXPLAIN 函数中加载查询。

  3. 在 SQL Runner 中，点击运行以执行 EXPLAIN 函数。

  4. 查看 EXPLAIN 函数的输出。

EXPLAIN 响应的确切信息和格式取决于您的特定方言，因此您应该会看到所用方言的具体说明。

在前面的 MySQL 示例中，EXPLAIN 函数返回数据库完成查询所执行步骤的列表。这对于执行速度似乎很慢的查询非常有用，因为您可能会发现数据库正在扫描查询中的整个表，而该表也许可以使用索引来提高性能。

如需查看在 SQL Runner 中使用 EXPLAIN 优化 SQL 的分步示例，请参阅如何使用 EXPLAIN 优化 SQL 社区帖子。

获取有关数据库的信息

SQL Runner 中的数据库标签页提供了一系列工具，可帮助您深入了解数据库。

获取数据库连接信息

当您在 SQL Runner 中选择连接时，Looker 会在 SQL 查询横幅的右侧显示该连接的数据库方言。如果您通过选择 Open in SQL Runner 或 Explain in SQL Runner 导航到 SQL Runner，则 Looker 会为您预先选择合适的连接，并显示连接的数据库方言。

点击连接齿轮菜单，获取更多数据库连接选项：

  • 选择显示进程选项，以显示当前在该连接上运行的查询和进程的相关信息。
  • 选择 Refresh Schemas & Tables 选项，以使用数据库中的架构和表重新填充 SQL Runner 左侧导航窗格。

BigQuery 齿轮菜单选项

当您选择支持多个数据库的 BigQuery 连接时，Looker 会在齿轮菜单中显示特定于方言的选项。菜单项会根据当前所选的选项，在显示可用项目和搜索公共项目之间切换。

  • 选择 Refresh Schemas & Tables 以使用数据库中的架构和表重新填充 SQL Runner 左侧导航窗格。
  • 显示可用项目时，您会看到搜索公开项目的齿轮菜单选项。选择此选项可以搜索在信息架构中不可见的公共数据集。
  • 显示公开项目时，您会看到一个齿轮菜单选项，用于显示可用项目。选择此选项可以在 SQL Runner 左侧导航窗格中还原显示特定于连接的 BigQuery 项目和表。

搜索数据库

SQL Runner 在选定的架构（对于 Google BigQuery 连接则为数据集）下方显示一个搜索框。

SQL Runner 搜索会浏览搜索框中包含该字符串的所有表和表列的名称。在下图中，“airport_name”是一个列，“airport_remarks”是一个表。

点击搜索结果之一以导航到 SQL Runner 中的该项。

获取表信息

默认情况下，当您选择连接和架构时，SQL Runner 会预加载所有表信息。对于包含许多表或非常大的表的连接，管理员可以通过取消选中“连接”页面中的 SQL Runner 预缓存选项来停用此行为。

通过 SQL Runner 的左侧导航面板，您可以浏览连接中的架构和表。选择连接和架构即可查看该架构中的所有表。点击表名称可查看该表中的字段。

SQL Runner 提供了一些预先编写的查询，可帮助您理解数据。要使用这些查询，请点击表格或表格列名称旁边显示的齿轮图标，然后选择所需的查询。Looker 会在 SQL 查询部分中自动生成 SQL，然后该查询将会运行。

可用的查询因数据库方言而异。

表信息

点击表名称旁边的齿轮图标后，Looker 会显示以下选项：

  • 探索表格：打开新的浏览器标签页，前往表格的 Looker 探索页面。
  • 描述：显示底层表中的列名称及其数据类型。
  • 显示索引：显示有关表如何编入索引的信息。
  • 选择 10 行：返回包含表中前十行的查询。这是了解数据实际样子的好方法。
  • Count：返回一个简单的 count(*) 查询，以获取表的总行数。

列信息

点击表格名称即可查看表格中的列。点击列名称旁边的齿轮图标后，Looker 会显示以下选项：

  • 最常见值：返回该表列中最常见值的查询，以及该值在列中出现的次数。
  • Approximate Count Distinct：显示列中不同值的数量的近似计数。

获取列数据类型信息

您可以使用 SQL Runner 通过执行以下步骤来获取列数据类型信息：

  1. 在 SQL Runner 中，从连接下拉列表中选择数据库连接。
  2. 从架构下拉列表中选择架构。（对于 BigQuery 连接，请选择项目和数据集。）
  3. SQL Runner 将显示数据库中该架构中的表列表。点击某个表格即可查看该表格中的列。
  4. 每个列名称都有一个表示数据类型的图标。将鼠标悬停在某个列名称上方，即可查看该列中数据的类型。

修改预构建的 SQL 查询

您可以在查询区域修改任何 SQL 查询，包括从表和字段齿轮菜单中选择的预设 SQL 查询。

例如，您可以使用 SQL Runner Count 查询加载数据库的基本计数命令，然后修改 SQL 查询。因此，如果您认为 public.users 表中的 id 列可能是主键，可以通过修改 count 查询来验证没有重复值，如下所示：

SELECT id ,COUNT(*)
FROM public.users
GROUP BY 1
ORDER BY 2 DESC
LIMIT 10

由于在结果限制到 10 行之前按计数对查询进行排序，因此结果将包含计数值最高的行。如果此查询针对每个 id 值返回计数 1，则 id 可能是此表中的主键。但是，此查询在查询运行时仅指定表中的行。由于将来向数据库插入数据可能会使 id 无法作为主键，因此我们建议您对数据库实施限制，以确保主键是唯一的。