cancel_grouping_fields

用法

explore: explore_name {
  cancel_grouping_fields: [
    fully_scoped_field,
    fully_scoped_field,
    ...
  ]
}

层次结构 模型文件 explore cancel_grouping_fields

默认值 无 接受 包含完全限定字段名称的逗号分隔列表的方括号 特殊规则 必须使用 view_name.field_name 语法完整指定每个字段 如果查询中包含指标，则无法正常运行 不能与 relationship: one_to_many 或 relationship: many_to_many 结合使用

定义

cancel_grouping_fields 可让您阻止 Looker 向其生成的 SQL 添加 GROUP BY 子句。如果用户包含您指定的任何字段，Looker 将不会进行分组。此功能通常用于提高对超大型表的查询性能。除非在极少数的特殊情况下，否则您应仅包含表中每行独有的字段，例如主键。

由于 Looker 度量表示 SQL 聚合函数，而这些函数需要 GROUP BY 子句才能正常运行，因此您应注意，cancel_grouping_fields 不适用于包含度量的任何查询。此外，使用 relationship: one_to_many 或 relationship: many_to_many 时，cancel_grouping_fields 不起作用。

最后，请注意，您列出的字段必须具有完整的作用域。换句话说，它们应写为 view_name.field_name，而不是简单地写为 field_name。

示例

如果用户在字段选择器中选择了订单 ID，则不将结果分组：

explore: order {
  cancel_grouping_fields: [order.id]
}

如果用户在字段选择器中选择了订单 ID 或订单哈希，则不应对结果进行分组：

explore: order {
  cancel_grouping_fields: [order.id, order.hash]
}

如果用户在字段选择器中选择了人员 ID 或 DNA ID，则不应对结果进行分组：

explore: person {
  cancel_grouping_fields: [person.id, dna.id]
  join: dna {
    sql_on: ${person.dna_id} = ${dna.id} ;;
    relationship: one_to_one
  }
}

常见挑战

cancel_grouping_fields 需要完全限定的字段名称

如果您单独编写字段名称，Looker 中的大多数参数都会根据参数的使用位置来假定视图名称。cancel_grouping_fields 不会以这种方式运行，而是要求您同时写入视图名称和字段名称。

例如，您可能认为以下代码可以正常运行，并且 id 会被解读为字段选择器中显示的订单 ID：

explore: order {
  cancel_grouping_fields: [id]
}

但事实并非如此，您会收到错误消息。您必须改为编写以下代码：

explore: order {
  cancel_grouping_fields: [order.id]
}

当选择任何指定字段时，系统都会触发 cancel_grouping_fields，而无需选择所有字段

如果您在 cancel_grouping_fields 中指定了多个字段，那么当用户选择列表中的任何字段时，系统都会取消分组。用户无需选择列表中的所有字段。因此，多列主键不适用于 cancel_grouping_fields。

注意事项

Looker 正常运行不需要 cancel_grouping_fields。用于改进大型表的查询

在手动编写 SQL 时，除非绝对必要，否则大多数人不会添加 GROUP BY 子句。在某些情况下，Looker 还会避免使用不必要的 GROUP BY 子句。如果查询中的某个维度已定义为您所用探索的主键（通过使用 primary_key 参数），则 GROUP BY 子句将被舍弃。

不过，在某些情况下，即使不是主键，其他维度仍可定义唯一的行。在这些情况下，Looker 可能会生成不必要的 GROUP BY，因为按维度分组是 Looker 运作方式的基本组成部分。在大多数情况下，这不会造成任何问题。结果会以您期望的方式显示，而且速度很快。

不过，在某些非常大的表中，不必要的 GROUP BY 子句可能会延长查询时间。这是使用 cancel_grouping_fields 的理想情况。