个查询

此页面涉及 探索的一部分 query 参数。

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

用法

explore: explore_name {
  query: query_name {
    dimensions: [dimension1, dimension2, ... ]
    measures: [measure1, measure2, ... ]
    label: "Display Name in Field Picker"
    description: "Information about this query"
    pivots: [dimension1, dimension2, ... ]
    sorts: [field1: asc, field2: desc, ... ]
    filters: [field1: "value1", field2: "value2", ... ]
    limit: 100
  }
  ...
}
层次结构
explore
query
默认值
无

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

定义

您可以使用 query 参数为探索创建模型分析。模型分析会列在空白探索的快速入门部分，或在探索已运行后列在“快速入门”弹出式窗口中。如需了解其运作方式，请参阅本页面上的示例部分。

对于 Looker 初学者来说，模型分析非常有用，因为您可以指定可能最相关且最有用的维度、度量、过滤条件和透视。

在 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, ...]

NOTE：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 中定义查询部分。

如需使用 Explore 获取模型化查询 LookML 的基础，请执行以下操作：

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

  3. 从“探索操作”齿轮菜单中选择获取 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"]
    }
  }

用户可以从“订单项”探索的“快速入门”部分运行“快速入门”分析。