SQL Runner 提供了一种直接访问数据库并以多种方式利用该访问的方法。借助 SQL Runner，您可以轻松浏览架构中的表、使用 SQL 查询中的临时探索、对数据运行预先编写的描述性查询、查看 SQL Runner 历史记录、下载结果、共享查询、以派生表形式添加到 LookML 项目中，以及执行其他实用任务。
本页面介绍了如何使用 SQL Runner 创建派生表，以及如何使用 SQL Runner 调试派生表。如需了解相关信息，请参阅以下其他文档页面：
将 SQL Runner 查询添加到 LookML 项目
SQL Runner 是测试 SQL 以用作 LookML 项目中的派生表的绝佳位置。您甚至可以使用其他工具获取 SQL 查询，在 SQL Runner 中对其进行测试，然后将其添加到 LookML 项目中。
在 SQL Runner 中创建 SQL 查询后，您可以使用添加到项目选项或获取 Derived Table LookML 选项基于该查询创建派生表。通过这两种方式，您都可以在 SQL Runner 中执行查询，并将其添加到 LookML 项目中。如需了解详情，请参阅以下部分。
添加到项目
使用 Add to Project 选项是将 SQL Runner 查询添加到项目的最简单方法：
借助 Add to Project 选项，您可以选择 LookML 项目，然后 Looker 会自动使用所选项目中的查询创建视图文件。如果您希望手动创建视图文件并自行添加查询的 LookML，则可以使用获取派生表 LookML 选项。
如需使用 Add to Project 选项，请按以下步骤操作：
- 使用 SQL Runner 创建要用于派生表的 SQL 查询。
- 点击右上角齿轮菜单中的添加到项目 (Add to Project)。
- 选择要添加此派生表的项目。
- 为派生表输入视图名称。
- 点击添加，将查询作为派生表添加到项目中。Looker 将切换到开发模式（如果尚未切换到此模式），使用 SQL Runner 查询中的 LookML 创建一个新的视图文件，然后打开 IDE 文件浏览器并找到新的视图文件。
- 根据项目的文件组织方式移动文件。
- 验证 LookML 并将更改部署到生产环境。
获取派生表 LookML
如需基于 SQL Runner 查询创建派生表，另一种方法是使用 SQL Runner 齿轮菜单中的获取派生表 LookML 选项。与“Add to Project”选项一样，Looker 会提供将 SQL 查询转换为派生表所需的 LookML。您可以在这里复制 LookML 以自行粘贴到项目中，如果您想替换现有的派生表，此功能非常有用。
如需基于 SQL Runner 查询创建派生表，请执行以下操作：
- 使用 SQL Runner 创建要用于派生表的 SQL 查询。
- 点击齿轮菜单，然后选择 Get Derived Table LookML。
在 Get Derived Table LookML 弹出式窗口中，点击 add it to your project 链接。
使用下拉项目列表，选择要添加派生表的项目。
在视图名称字段中输入新视图的名称。如需了解文件命名惯例，请参阅管理 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 的不同部分以缩小错误位置。如需了解详情，请参阅 Looker 社区帖子使用 SQL Runner 测试派生表。