使用 SQL Runner 创建查询和探索

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

本页面介绍了如何在 SQL Runner 中运行查询、创建临时探索，以及如何使用 SQL Runner 调试查询。如需了解以下信息，请参阅其他文档页面：

在 SQL Runner 中运行查询

如需对数据库运行查询，您可以从头开始编写 SQL 查询、使用探索创建查询或针对 LookML 模型运行查询。您还可以使用历史记录重新运行之前的查询。

从头开始编写 SQL 查询

您可以使用 SQL Runner 针对数据库编写和运行自己的 SQL 查询。Looker 会将您的查询原封不动地传递给数据库，因此请确保 SQL 查询的语法对您的数据库方言有效。例如，每种方言都有略有不同的 SQL 函数，这些函数具有应传递给函数的特定参数。

  1. 在查询 栏下方的字段中输入 SQL 查询。
  2. （可选）从字段列表中选择表名称或字段，将其包含在光标位置的查询中。
  3. 选择运行 以针对数据库运行查询。
  4. 在结果 区域中查看结果。SQL Runner 最多会加载查询结果集中的 5,000 行。对于支持 流式传输的 SQL 方言，您可以 下载结果以查看整个结果集。

运行查询后，您可以将查询添加到项目、获取派生表的 LookML或共享查询。

您还可以使用 SQL Runner 试用新查询或测试现有查询。SQL Runner 错误突出显示功能 有助于测试和调试查询。

使用探索创建 SQL 查询

您还可以使用探索创建查询，然后获取该查询的 SQL 命令以在 SQL Runner 中使用：

  1. 在探索中，从数据 栏中选择 SQL 标签页。
  2. SQL 查询将显示在数据 栏下方。
  3. 选择在 SQL Runner 中打开 或在 SQL Runner 中说明 ，以在 SQL Runner 中打开查询。

将查询添加到查询 栏下方的字段后，您可以选择运行 以查询数据库。或者，您可以修改查询，然后运行新查询。

使用 SQL Runner 创建可视化图表

如果 Looker 管理员启用了 SQL Runner Vis Labs 功能，您可以直接在 SQL Runner 中创建可视化图表。

启用 SQL Runner Vis 后，SQL Runner 面板会重新排列。可视化图表面板显示在顶部，结果面板显示在中间，查询面板显示在底部。

  1. 创建并运行 SQL 查询后，您可以打开可视化图表 标签页以查看可视化图表并选择可视化图表类型，就像在“探索”页面上一样。
  2. 您可以使用设置 菜单修改可视化图表。
  3. 您可以通过共享网址来共享使用 SQL Runner 创建的可视化图表。您使用可视化图表的设置 菜单所做的任何自定义设置都将保存，并且链接不会更改。

关于 SQL Runner 可视化图表的工作方式，请注意以下几点：

  • 结果表和可视化图表会将任何数字字段解读为衡量指标。
  • 结果表和可视化图表始终使用完整字段名称。因此，设置 菜单中的显示完整字段名称 选项处于停用状态。
  • 如需使用自定义字段、表计算、透视、列总计和小计，请从 SQL Runner 查询中进行探索。
  • SQL Runner 可视化图表不支持静态地图（区域）可视化图表，但支持使用经纬度数据的地图（地图和静态地图（点）可视化图表）。
  • SQL Runner 可视化图表不支持时间轴可视化图表。

透视维度

您可以修改查询结果，以便在 SQL Runner 可视化图表中按一个或多个维度进行 透视。如需透视字段，请执行以下操作：

  1. 在结果 区域中选择列的齿轮菜单，以显示列选项。
  2. 选择透视列 。

透视结果会显示在 SQL Runner 可视化图表中。

如需取消透视 结果，请选择透视列的齿轮菜单，然后选择取消透视列 。

更改字段类型

在显示查询的结果和可视化图表时，SQL Runner 会自动将任何数字字段解读为衡量指标，并将任何非数字字段解读为维度。您可以按照以下步骤替换默认字段类型，并将维度转换为衡量指标，反之亦然：

  1. 在结果 区域中选择列的齿轮菜单，以显示列选项。
  2. 选择转换为维度 或转换为衡量指标 以更改字段类型。

可视化图表将显示新的字段类型。

针对 LookML 模型运行查询

您可以使用 SQL Runner 针对 LookML 模型编写和运行 SQL 查询，而不是直接针对数据库。在针对模型构建查询时，您可以使用 LookML 替换运算符，例如 ${view_name.field_name} 或 ${view_name.SQL_TABLE_NAME}。例如，在构建查询以排查派生表问题时，这可以节省时间。

Looker 会解析任何 LookML 替换，然后将查询传递给数据库，因此查询应采用对数据库方言有效的 SQL。例如，每种方言都有略有不同的 SQL 函数，这些函数具有应传递给函数的特定参数。

如需在 SQL Runner 中针对 LookML 模型运行查询，请执行以下操作：

  1. 选择模型 标签页。
  2. 选择要查询的模型。
  3. 在数据 栏下方的文本框中，使用 LookML 字段输入 SQL 查询。
  4. （可选）在视图列表中选择一个视图，将其包含在光标位置的查询中。
  5. 如需查看视图中的字段列表，请在视图 部分中选择该视图。（可选）您可以从字段列表中选择一个字段，将其包含在光标位置的查询中。
  6. 在准备好的 SQL 查询 区域中，您可以查看在将所有 LookML 替换转换为 SQL 后构建的生成的 SQL 查询。
  7. 选择运行 以针对模型运行查询。
  8. 在结果 区域中查看结果。SQL Runner 最多会加载查询结果集中的 5,000 行。对于支持流式传输的 SQL 方言，您可以下载结果以查看整个结果集。

您可以使用 SQL Runner 试用新查询、测试现有查询，或从结果中打开新的探索。SQL Runner 错误突出显示功能 有助于测试和调试查询。

如果您有喜欢的查询，可以共享该查询，甚至可以将该查询添加到 LookML 项目。

从 SQL Runner 查看字段的 LookML

在模型 标签页的字段列表中，您还可以查看字段的 LookML。将指针悬停在字段列表中的字段上，然后选择字段名称右侧的 Looker 图标。

Looker 会打开 LookML IDE，并加载定义该字段的文件。

SQL Runner 历史记录

您还可以查看最近在 SQL Runner 中运行的所有查询的历史记录。

如需查看历史记录，请选择导航窗格顶部的历史记录 标签页。SQL Runner 会显示针对数据库连接运行的所有查询。红色表示因发生错误而未运行的查询。

在历史记录中选择一个查询，以将该查询填充到 SQL Runner 中，然后选择运行 以重新运行该查询。

对查询进行排序

表格的排序顺序由排序字段名称旁边的向上或向下箭头表示，具体取决于结果是升序还是降序。您可以按多个列进行排序，方法是按住 Shift 键，然后按照所需的排序顺序选择列标题。字段的排序顺序还通过以下方式表示：一个数字，用于区分其与其他字段的排序依据顺序；字段名称旁边的箭头，用于显示排序方向（升序或降序）；以及当您将指针悬停在字段名称上时显示的弹出式窗口。

如需了解更多信息和示例，请参阅 对数据进行排序 部分的 在 Looker 中探索数据 文档页面。

共享查询

您可以在 SQL Runner 中与具有 SQL Runner 访问权限的其他用户共享查询。如需共享查询，请复制浏览器地址栏中的网址。

下载结果

运行 SQL 查询后，您可以下载多种格式的结果。

  1. 在 SQL 查询 框中编写查询。（此时，您无需在 SQL Runner 中运行查询。）
  2. 从右上角的齿轮菜单中选择下载 。
  3. 选择下载的文件格式（文本文件、CSV、JSON 等）。

  4. 选择在浏览器中打开 以在新浏览器窗口中查看结果，或选择下载 以将结果下载到计算机上的文件中。

对于支持流式传输的 SQL 方言，SQL Runner 下载 选项将下载整个结果集。对于不支持流式传输的 SQL 方言，SQL Runner 下载 选项只会下载结果 部分中显示的查询行（最多 5,000 行）。

复制列值

您可以从 SQL Runner 的结果 部分复制列值。选择列的齿轮菜单，将值复制到剪贴板。然后，您可以将列值粘贴到文本文件、Excel 电子表格或其他位置。

如果 Looker 管理员启用了 SQL Runner Vis Labs 功能，您还可以在列齿轮菜单中使用其他选项：

您还可以手动移动、固定和调整结果表中的列大小。

SQL Runner 查询的费用估算

对于 BigQuery、MySQL、Amazon RDS for MySQL、Snowflake、Amazon Redshift、Amazon Aurora、PostgreSQL、Cloud SQL for PostgreSQL 和 Microsoft Azure PostgreSQL 连接，SQL Runner 会提供查询费用的估算值。输入 SQL 查询后，SQL Runner 会计算查询所需的数据量，并在运行 按钮附近显示该信息。

对于 BigQuery、MySQL 和 Amazon RDS for MySQL 连接，费用估算功能始终处于启用状态。对于 Snowflake、Amazon Redshift、Amazon Aurora、PostgreSQL、Cloud SQL for PostgreSQL 和 Microsoft Azure PostgreSQL 数据库连接，您必须为连接启用 费用估算 选项。您可以在创建连接时启用费用估算。对于现有连接，您可以修改连接，方法是转到 Looker 的管理面板的数据库部分中的连接页面。

创建临时探索

在 SQL Runner 中，您可以为 SQL 查询或数据库表创建临时探索，从而快速了解数据。您可以使用 Looker 探索选择字段、添加过滤条件、直观呈现结果以及创建 SQL 查询。

您可以通过以下两种方式从 SQL Runner 打开临时探索：

  • 从 SQL Runner 的查询结果中进行探索
  • 从 SQL Runner 的表列表中进行探索

从 SQL Runner 查询结果中进行探索

SQL Runner 允许您从 SQL 查询中打开探索。这会根据在 SQL Runner 中编写的查询创建一个临时探索。这样，您就可以测试查询返回的内容，并直观呈现结果。这可用于任何查询，但对于您计划用于派生表的测试查询尤其有用。

  1. 使用 SQL Runner 创建要使用的 SQL 查询。
  2. 从右上角的齿轮菜单中选择探索 。这会将您带到新的探索，您可以在其中探索 SQL 查询，就像它是模型中的已保存表一样。
  3. 您可以复制此探索的网址以进行共享。
  4. 如需直接从此处将此查询添加为项目中的派生表，请选择将视图添加到项目 。

在 SQL Runner 中探索时创建自定义字段

如果您有权访问自定义字段功能，则可以使用自定义字段在 SQL Runner 中直观呈现未建模的字段。如上一部分所述，从齿轮菜单中选择探索 。然后，在字段选择器中，按照以下步骤操作：

探索 SQL Runner 中列出的表

使用数据库 标签页中的探索表 选项，为连接中的任何表创建临时探索。这样，您就可以在对表进行建模之前在表上使用 Looker，就像探索 LookML 视图一样探索表。

打开表的探索后，您可以决定是否将该表添加到项目中。您还可以使用探索的 SQL 标签页查看 Looker 发送到数据库的 SQL 查询，然后使用在 SQL Runner 中打开 按钮将查询返回到 SQL Runner 中。

  1. 选择数据库 标签页。
  2. 在 SQL Runner 中，选择表的齿轮图标，然后选择探索表 。
  3. Looker 会生成一个临时模型，其中包含表的视图，然后显示探索。
  4. Looker 会为表中的每个列提供一个维度字段。（这与 Looker 在项目开始时生成模型的方式相同。）
  5. Looker 会自动为任何日期字段添加时间范围。
  6. Looker 还会添加计数衡量指标。

使用 SQL Runner 进行调试

SQL Runner 也是一个实用工具，可用于检查查询中的 SQL 错误。

SQL Runner 错误突出显示

SQL Runner 会突出显示 SQL 命令中错误的位置，并在错误消息中包含错误的位置：

提供的位置信息因数据库方言而异。例如，MySQL 提供包含错误的行号，而 Redshift 提供错误的字符位置。其他数据库方言可能具有其中一种或其他行为。

SQL Runner 还会突出显示 SQL 命令中第一个语法错误的位置，方法是使用红色下划线标记该错误，并使用 x 标记该行。 将指针悬停在 x 上可查看有关该错误的更多信息。修复该问题后，选择运行 以查看查询中是否还有其他错误。

使用 SQL Runner 检查探索中的错误

如果您在探索中遇到 SQL 语法错误，可以使用 SQL Runner 确定错误的位置和错误类型，例如拼写错误或缺少命令。

  1. 在探索中，选择“数据”栏的 SQL 标签页 。
  2. 选择在 SQL Runner 中打开 以在 SQL Runner 中打开查询。

这会将探索生成的 SQL 复制到 SQL Runner。如 SQL Runner 错误突出显示 部分 所示，SQL Runner 会突出显示 SQL 命令中错误的位置，并在错误消息中包含错误的位置。然后，您可以在 SQL Runner 中进行更改并重新运行查询，直到更正错误为止。

使用 SQL Runner 检查派生表中的错误

如需了解如何使用 SQL Runner 检查派生表中的 SQL 错误，请参阅使用 SQL Runner 测试派生表 Looker 社区帖子。