SQL Runner 提供了一种直接访问数据库的方法，并可通过多种方式利用这种访问权限。借助 SQL Runner，您可以轻松浏览架构中的表、使用 SQL 查询中的临时探索、对数据运行预先编写的描述性查询、查看 SQL Runner 历史记录、下载结果、共享查询、将其添加为派生表到 LookML 项目，以及执行其他实用任务。
本页介绍了如何使用 SQL Runner 创建派生表，以及如何使用 SQL Runner 调试派生表。如需了解以下内容，请参阅其他文档页面：
向 LookML 项目添加 SQL Runner 查询
SQL Runner 非常适合测试 SQL，以便在 LookML 项目中将其用作派生表。您甚至可以从其他工具获取 SQL 查询，在 SQL Runner 中对其进行测试，然后将其添加到 LookML 项目中。
在 SQL Runner 中创建 SQL 查询后，您可以使用添加到项目选项或获取派生表 LookML 选项，根据该查询创建派生表。这两种方法都允许您在 SQL Runner 中执行查询，并将其添加到 LookML 项目中。如需了解详情，请参阅以下部分。
添加到项目
若要将 SQL Runner 查询添加到项目中，最简单的方法是使用添加到项目选项：
借助添加到项目选项，您可以选择一个 LookML 项目，然后 Looker 会自动在所选项目中使用该查询创建视图文件。如果您想手动创建视图文件并自行添加查询的 LookML，可以使用获取派生表 LookML 选项。
如需使用添加到项目选项，请按以下步骤操作：
- 使用 SQL Runner 创建要用于派生表的 SQL 查询。
- 点击右上角齿轮菜单中的添加到项目。
- 选择要将此派生表添加到的项目。
- 为派生表输入视图名称。
- 点击添加，将查询添加为项目中的派生表。 Looker 将切换到开发模式（如果尚未处于该模式），使用 SQL Runner 查询中的 LookML 创建一个新视图文件，然后打开 IDE 文件浏览器以显示新视图文件。
- 移动文件，以适应项目的文件组织方式。
- 验证 LookML 并将更改部署到生产环境。
获取派生表 LookML
若要根据 SQL Runner 查询创建派生表，您还可以使用 SQL Runner 齿轮菜单中的 Get Derived Table LookML 选项。与添加到项目选项一样，Looker 会提供将 SQL 查询转换为派生表所需的 LookML。然后，您可以自行复制 LookML 并将其粘贴到项目中，这对于替换现有派生表非常有用。
如需基于 SQL Runner 查询创建派生表，请执行以下操作：
- 使用 SQL Runner 创建要用于派生表的 SQL 查询。
- 点击齿轮菜单，然后选择获取派生表 LookML。
在 Get Derived Table LookML 弹出式窗口中，点击将其添加到您的项目链接。
使用下拉项目列表选择要将派生表添加到的项目。
在视图名称字段中输入新视图的名称。如需了解文件命名惯例，请参阅管理 LookML 文件和文件夹页面。
点击添加按钮。 Looker 会切换到开发模式（如果尚未处于该模式），使用 SQL Runner 查询中的 LookML 创建一个新视图文件，然后打开 IDE 文件浏览器以查看新视图文件。
移动文件，以适应项目的文件组织方式。
使用 SQL Runner 进行调试
SQL Runner 还是一种用于检查派生表定义中的 SQL 错误的实用工具。
SQL Runner 错误突出显示
SQL Runner 会突出显示 SQL 命令中的错误位置，并在错误消息中包含错误的位置。
所提供的位置信息会因数据库方言而异。例如，MySQL 会提供包含错误的行号，而 Redshift 会提供错误的字符位置。其他数据库方言可能具有这些行为之一或其他行为。
SQL Runner 还会突出显示 SQL 命令中第一个语法错误的位置，方法是用红色为其添加下划线，并用“x”标记相应行。将鼠标悬停在“x”上，即可查看有关该错误的更多信息。解决该问题后，点击运行，看看查询中是否还有其他错误。
使用 SQL Runner 测试派生表
如果您看到派生表中出现错误，可以将 SQL 语句复制到 SQL Runner 中，并测试 SQL 的不同部分，以缩小错误的位置范围，从而确定错误的原因。如需了解详情，请参阅 Using SQL Runner to test derived tables（使用 SQL Runner 测试派生表）这篇 Looker 社区帖子。