query

本页中提及的 query 参数是探索的一部分。

query 也可以用作汇总表的一部分，如 aggregate_table 参数文档页面中所述。

用量

。
层次结构
explore
query
默认值
无

接受
用于定义查询的查询和子参数的名称

定义

您可以使用 query 参数为探索创建建模分析。建模分析会在空白“探索”页面的“快速入门”部分或“探索”功能运行完成后的“快速入门”弹出式窗口中列出。请参阅本页的示例部分，了解工作原理。

“模型分析”分析对初学者用户来说很有用，因为您可以指定维度、测量值、过滤条件和数据透视等元素，这些元素可能最具相关性、最富参考价值。

在 LookML 中定义查询

您可以使用“探索”功能来创建查询的基本 LookML，而不是从头开始创建查询的 LookML。如需了解详情，请参阅下一部分从探索中获取查询 LookML。

query 参数具有以下子参数：

参数名称 说明 示例
label （可选）为 query 添加标签。“标签”是指“探索”字段选择器中针对查询显示的内容。 label: "Weekly Sales Totals"
description 可以选择添加关于此查询的说明，以告知用户。在“探索”中，所有带有说明的查询都会有一个信息图标。说明文字会在用户将鼠标悬停在信息图标上时显示。
description: "Total value of all sales per day"
dimensions 要包含在查询中的“探索”维度列表（以英文逗号分隔）。dimensions 字段使用以下语法：
dimensions: [dimension1, dimension2, ...] 		dimensions:
  [orders.created_month, orders.country]
measures “探索”中要纳入到您的查询中的各项衡量结果（以英文逗号分隔）。measures 字段使用以下语法：
measures: [measure1, measure2, ...] 		measures:
  [orders.count]
filters 可以选择向 query 添加过滤条件。过滤条件添加到生成查询的 SQL 的 WHERE 子句中。
filters 字段使用以下语法：
filters: [field_name_1: "value1", field_name_2: "value2", ...] 		filters: [orders.country: "United States", orders.state: "California"]
limit （可选）指定查询的行数上限。 limit: 10
sorts （可选）为 query 指定排序字段和排序方向（升序或降序）。
sorts 字段使用以下语法：
sorts: [field1: asc|desc, field2: asc|desc, ...] 		sorts: [order_items.total_sales: asc]
pivots （可选）对查询的指定维度进行数据透视。pivots 字段使用以下语法：
pivots: [dimension1, dimension2, ...]
注意：pivots 参数中指定的字段也必须在查询的 dimensions 参数中指定。		 pivots: [created_quarter]
timezone 不支持 timezone 参数不适用于 explore 的子参数 query。explore 下的 query 使用 explore 所用的时区。

从“探索”中获取查询 LookML

作为一种快捷方式，Looker 开发者可以借用“探索”中用于生成 aggregate_table LookML 的功能，然后复制汇总表查询 LookML，并以此为起点，开始建模分析 LookML。

复制汇总表格的 LookML 时，您还可以复制根据模型估算的查询 LookML 中不需要的一些参数。具体而言，复制汇总表 LookML 后，您需要删除 aggregate_table 和 materialization 参数，因为它们仅适用于汇总表。（如需详细了解这些参数，请参阅 aggregate_table 参数文档页面。）

此外，汇总表格 query 参数仅支持根据模型估算的“探索”查询支持的部分参数。这意味着，在复制汇总表 query LookML 后，您就可以对根据模型估算的查询使用其他参数。请参阅此页面上的在 LookML 中定义查询部分，查看建模查询支持的参数的完整列表。

如需使用“探索”功能获取建模查询 LookML 的基础，请执行以下操作：

  1. 在“探索”中，选择要纳入建模查询的所有字段和过滤条件。
  2. 点击运行以获取结果。

  3. 从“探索”菜单中选择 Get LookML。此选项仅适用于 Looker 开发者。

  4. 点击汇总表格标签页。

  5. Looker 为汇总表的探索优化提供 LookML。我们可以使用汇总表的 query LookML 来对根据模型估算的“探索”查询进行修改。复制 LookML 并将其粘贴到关联的模型文件中，该文件位于“探索”优化上方的注释中。如果“探索”是在单独的探索文件（而非模型文件）中定义的，您可以向“探索”的文件而非模型文件添加优化。

    在这里，您可以修改用于建模查询的汇总表 LookML：

  6. 仅保留 query 参数及其子参数。删除 aggregate_table 和 materialization 参数，因为它们仅适用于汇总表格。

  7. 为查询添加名称。如本页面上的示例部分所示，该语法为：
    query: query_name

  8. （可选）为您的建模查询填写任何其他参数。请参阅此页面上的在 LookML 中定义查询部分，查看建模查询支持的参数的完整列表。

示例

此示例为 order_items 探索创建 order_count_by_month 模型查询：


explore: +order_items {
  query: order_count_by_month {
     description: "Number of orders placed by month in 2019"
     dimensions: [orders.created_month]
      measures: [orders.count]
     filters: [orders.created_date: "2019"]
    }
  }

然后，分析会显示在“快速入门”部分中的订单内容“探索”中。从“快速入门”部分选择分析，然后在“探索”中运行分析：

在“探索”中运行建模分析后，您可以按原样检查数据，也可以从分析开始，添加其他字段和测量值、更改过滤条件、创建可视化图表，或执行任何其他操作，在 Looker 中探索数据。您也可以点击“探索”名称旁边的闪电图标：

此操作会启动 Quick Start 弹出式窗口，您可以在其中选择新的分析：

选择“快速入门”分析可运行分析并替换之前的“探索”结果，同时保留现有过滤条件。如需详细了解“快速入门”数据分析中的过滤器行为，请参阅在 Looker 中探索数据文档页面中的“快速入门”过滤器行为部分。