SQL Runner 可让您直接访问数据库并以多种方式利用该访问权限。使用 SQL Runner，您可以轻松浏览架构中的表、使用 SQL 查询中的临时探索、对数据运行预先编写的描述性查询、查看 SQL Runner 历史记录、下载结果、共享查询、作为派生表添加到 LookML 项目，以及执行其他有用的任务。
本页面介绍了如何在 SQL Runner 中运行查询、创建临时探索，以及如何使用 SQL Runner 调试查询。请参阅以下文档页面，了解有关以下方面的信息：
在 SQL Runner 中运行查询
如需对数据库运行查询，您可以从头开始编写 SQL 查询、使用探索来创建查询或针对 LookML 模型运行查询。您还可以使用历史记录重新运行上一个查询。
从头开始编写 SQL 查询
您可以使用 SQL Runner 来针对数据库编写并运行自己的 SQL 查询。Looker 会像您编写查询一样将查询传递到数据库，因此请确保 SQL 查询的语法对您的数据库方言有效。例如，每种方言的 SQL 函数略有不同，它们都有应传递给该函数的特定参数。
- 在查询栏下方的文本框中输入 SQL 查询。
- （可选）从字段列表中选择一个表名称或字段，将其添加到查询中的光标位置。
- 选择运行以对数据库运行查询。
- 在结果区域中查看结果。SQL Runner 最多可加载 5,000 行查询结果。对于支持流式处理的 SQL 方言，您可以下载结果以查看整个结果集。
某些 SQL 程序支持连续运行多个查询。但是，一次只能在 SQL Runner 中运行一个查询。SQL Runner 在查询（包括空格）上也有 65,535 个字符的限制。
运行查询后，您可以将查询添加到项目中、获取派生表的 LookML 或共享查询。
您还可以使用 SQL Runner 来尝试运行新查询或测试现有查询。SQL Runner 错误突出显示有助于测试和调试查询。
使用探索创建 SQL 查询
您还可以使用探索来创建查询，然后获取要在 SQL Runner 中使用该查询的 SQL 命令：
- 在“探索”界面中，从数据栏中选择 SQL 标签页。
- SQL 查询将显示在数据栏下方。
- 选择 Open in SQL Runner 或 Explain in SQL Runner，在 SQL Runner 中打开查询。
将查询添加到查询栏下方的文本框中后，您可以选择运行来查询数据库。或者，您可以修改查询，然后运行新查询。
使用 SQL Runner 创建可视化图表
如果您的 Looker 管理员已启用 SQL Runner Vis Labs 功能，那么您可以直接在 SQL Runner 中创建可视化图表。
启用 SQL Runner Vis 后，SQL Runner 面板将被重新组织。可视化面板显示在顶部，结果面板位于中间，查询面板显示在底部。
- 创建并运行 SQL 查询后，您可以打开可视化图表标签页以查看可视化图表并选择可视化图表类型，就像在“探索”页面上执行的操作一样。
- 您可以使用设置菜单修改可视化图表。
- 您可以通过共享网址来共享使用 SQL Runner 创建的可视化图表。系统将保存您使用可视化图表的设置菜单进行的任何自定义设置，并且该链接不会更改。
关于 SQL Runner 可视化的工作原理，请注意以下几点：
- 结果表格和可视化图表会将任何数字字段解读为测量。
- 结果表格和可视化图表中始终会使用完整字段名称。因此，设置菜单中的显示完整字段名称选项处于无效状态。
- 如需使用自定义字段、表计算、数据透视表、列总计和小计，请通过 SQL Runner 查询探索。
- SQL Runner 可视化图表不支持静态地图（区域）可视化图表，但支持使用纬度和经度数据的地图（地图和静态地图（点）可视化图表）。
- SQL Runner 可视化图表不支持时间轴可视化图表。
数据透视尺寸
您可以在 SQL Runner 可视化图表中修改查询结果，以按一个或多个维度进行数据透视。要透视字段，请按以下步骤操作：
- 在结果区域中选择列的齿轮菜单，以显示列选项。
- 选择透视列。
透视结果将显示在 SQL Runner 可视化图表中。
结果区域中的结果不会透视。
要对结果进行逆透视，请选择已透视列的齿轮菜单，然后选择逆透视列。
更改字段类型
在显示查询结果和可视化内容时，SQL Runner 会自动将任何数字字段解释为测量，并将任何非数字字段解释为维度。您可以按照以下步骤替换默认字段类型，并将维度转换为度量，反之亦然：
- 在结果区域中选择列的齿轮菜单，以显示列选项。
- 选择转换为维度或转换为测量以更改字段类型。
可视化图表将显示新的字段类型。
对 LookML 模型运行查询
您可以使用 SQL Runner 针对 LookML 模型编写和运行 SQL 查询，而不是直接针对数据库运行。根据模型构建查询时，您可以使用 LookML 替代运算符，例如 ${view_name.field_name} 或 ${view_name.SQL_TABLE_NAME}。这可以在构造查询以对派生表进行问题排查时节省时间。
Looker 会解析所有 LookML 替换项，然后将查询传递到数据库，因此查询应使用适用于数据库方言的有效 SQL。例如，每种方言的 SQL 函数略有不同，它们都有应传递给该函数的特定参数。
如需在 SQL Runner 中对 LookML 模型运行查询，请执行以下操作：
- 选择模型标签页。
- 选择要查询的模型。
- 在数据栏下方的文本框中，使用 LookML 字段输入 SQL 查询。
- （可选）在视图列表中选择一个视图，以便在查询的光标位置处添加该视图。
- 要查看视图中的字段列表，请在视图部分选择相应视图。或者，您也可以在字段列表中选择某个字段，以将其添加到查询中的光标位置。
- 在准备的 SQL 查询区域中，您可以查看在将任何 LookML 替代变量转换为 SQL 后构建的 SQL 查询。
- 选择运行以针对您的模型运行查询。
- 在结果区域中查看结果。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 查询后，您能够以各种格式下载结果。
- 在 SQL 查询框中编写查询。（此时您无需在 SQL Runner 中运行查询。）
- 从右上角的齿轮菜单中选择下载。
- 选择下载的文件格式（文本文件、CSV、JSON 等）。
选择在浏览器中打开可在新的浏览器窗口中查看结果，或选择下载将结果下载到计算机上的文件中。
当您选择在浏览器中打开或下载时，Looker 将重新运行查询，然后执行下载。
对于支持流的 SQL 方言，SQL Runner 的 Download 选项将下载整个结果集。对于不支持流的 SQL 方言，SQL Runner 的 Download 选项将仅下载 Results 部分中显示的查询行（最多 5,000 行）。
复制列值
您可以从 SQL Runner 的 Results 部分复制列值。选择列的齿轮菜单，将值复制到剪贴板。然后，您可以将列值粘贴到文本文件、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 编写的查询创建临时的 Discover。这样，您就可以测试查询返回的内容并直观呈现结果。这可用于任何查询，但在测试您计划用于派生表的查询时尤其有用。
如果您的 Looker 管理员已启用 SQL Runner Vis Labs 功能，您可以直接在 SQL Runner 中创建可视化图表。
- 使用 SQL Runner 创建要使用的 SQL 查询。
- 从右上角的齿轮菜单中选择探索。此操作会将您转到新的“探索”，您可以在其中探索 SQL 查询，就像它是您模型中已保存的表一样。
- 您可以将网址复制到此“探索”页面进行分享。
- 要直接从此处将此查询添加为项目中的派生表，请选择将视图添加到项目。
在 SQL Runner 中探索时创建自定义字段
如果您有权使用自定义字段功能，则可以使用自定义字段直观呈现 SQL Runner 中未建模的字段。如上一部分中所述，从齿轮菜单中选择探索。然后，在字段选择器中，按以下步骤操作：
- 选择“自定义字段”部分将其打开，然后选择添加以开始创建自定义维度、自定义测量或表格计算。（如果您没有自定义字段部分，则无权创建自定义字段。）
- 选择测量的三点状更多菜单，然后选择过滤测量，以根据现有测量创建过滤出的自定义测量。
- 选择维度的三点状更多菜单，然后选择衡量类型（例如求和或计数），以根据维度创建自定义衡量。
浏览 SQL Runner 中列出的表
使用数据库标签页中的探索表选项，为连接中的任何表创建临时探索。这样，您就可以在对表进行建模之前对表使用 Looker，就像浏览 LookML 视图一样浏览表。
打开该表的“探索”后，您可以决定是否将该表添加到您的项目中。您还可以使用“探索”的 SQL 标签页查看 Looker 发送到数据库的 SQL 查询，然后使用在 SQL Runner 中打开按钮，将查询恢复到 SQL Runner。
- 选择数据库标签页。
- 在 SQL Runner 中，选择表的齿轮图标，然后选择探索表。
- Looker 会生成包含表视图的临时模型，然后显示“探索”。
- Looker 为表格中的每一列提供了一个维度字段。（这与 Looker 在项目开始时生成模型的方法相同。）
- Looker 会自动为所有日期字段添加时间范围。
- Looker 还包含一个计数测量。
使用探索表选项时，没有与“探索”相关联的 LookML 文件，它只是表的临时视图。
使用 SQL Runner 进行调试
SQL Runner 也是一种用于检查查询中的 SQL 错误的实用工具。
突出显示 SQL Runner 错误
SQL Runner 突出显示 SQL 命令中的错误位置，并在错误消息中包含错误的位置：
所提供的位置信息会因数据库方言而异。例如，MySQL 提供包含错误的行号，而 Redshift 提供错误的字符位置。其他数据库方言可能具有上述或其他行为之一。
SQL Runner 还会突出显示 SQL 命令中第一个语法错误的位置，方法是为其添加红色下划线并使用 x 标记该行。将指针悬停在 x 上可查看有关该错误的更多信息。解决此问题后，选择运行，看看查询中是否还有其他错误。
使用 SQL Runner 检查探索中的错误
如果您在探索中遇到 SQL 语法错误，可以使用 SQL Runner 确定错误的位置和错误类型，例如拼写错误或缺少命令。
- 在“探索”中，选择“数据”栏的 SQL 标签页。
- 选择 Open in SQL Runner，在 SQL Runner 中打开查询。
这会将探索生成的 SQL 复制到 SQL Runner。如 SQL Runner 错误突出显示部分所示，SQL Runner 会在 SQL 命令中突出显示错误的位置，并在错误消息中添加错误的位置。然后，您可以进行更改并在 SQL Runner 中重新运行查询，直到更正错误。
使用 SQL Runner 检查派生表中的错误
如需了解如何使用 SQL Runner 检查派生表中的 SQL 错误，请参阅使用 SQL Runner 测试派生表 Looker 社区帖子。