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 项目中。有关详情，请参阅以下部分。
添加到项目
使用添加到项目选项是将 SQL Runner 查询添加到项目的最简单方法：
借助 Add to Project 选项，您可以选择一个 LookML 项目，然后 Looker 会在所选项目中使用该查询自动创建视图文件。如果您希望手动创建视图文件并自行添加查询的 LookML，则可以使用获取 Derived Table 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 查询。
- 点击齿轮菜单，然后选择 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 的不同部分以缩小错误的位置。如需了解详情，请参阅使用 SQL Runner 测试派生表 Looker 社区帖子。