symmetric_aggregates

用途

explore: explore_name {
  symmetric_aggregates: yes
}
階層
symmetric_aggregates
デフォルト値
yes

許可
ブール値(yes または no)

定義

symmetric_aggregates パラメータは、特定の Explore 内に対称集計を適用するかどうかを決定します。symmetric_aggregates がオンの場合、結合によってファンアウトが発生しても、集計関数は正しい結果を返します。対称集計については、対称集計についてのベスト プラクティス ページで詳しく説明されています。また、対称集計で解決されるファンアウトの問題については、SQL ファンアウトの問題のコミュニティ投稿で説明されています。

デフォルトでは、Looker 内のすべての Explore で対称集計が有効になっています。つまり、SQL 言語が対称集計をサポートしている場合、symmetric_aggregates パラメータを含める必要があるのは、Explore でその機能を無効にする場合のみです。

例

product Explore の対称集計を有効にします。

explore: product {
  symmetric_aggregates: yes  # the default value, could be excluded
}

customer Explore の対称集計をオフにします。

explore: customer {
  symmetric_aggregates: no
}

注意点

対称集計がオフの場合は、結合を慎重に作成する

対称集計は、結合によってファンアウトが発生した場合に、計算で誤った結果が返されないように保護します。したがって、使用している言語が対称集計をサポートしていない場合や、symmetric_aggregates: no を設定した場合は、Looker で結合を実行するときに注意が必要です。

symmetric_aggregates: no が設定されている場合(またはデータベース言語が対称集計をサポートしていない場合)に、結合によってファンアウトが発生すると、Looker は、type: count のメジャー(ビューで主キーが定義されている場合、Looker は COUNT DISTINCT に変換します)を除き、ファンアウトされたデータに対して集計メジャーを計算しません。

  • デフォルトの LookML ランタイム(new_lookml_runtime: yes)を使用している場合、ファンアウト全体で他の集計メジャーを含むクエリを実行すると、Looker はエラー Field '(?)' cannot be calculated in this query because the data has fanned out. を返します。
  • 以前の LookML ランタイム(new_lookml_runtime: no と以前の LookML ランタイムを使用するレガシー機能が有効になっている場合)では、Looker はこれらの集計メジャーを Explore フィールド ピッカーから削除し、クエリで無視します。

このファンアウトの問題とその回避策については、コミュニティ投稿の SQL ファンアウトの問題で詳しく説明されています。

すべてのデータベース言語が、対称集計のある中央値とパーセンタイルのメジャー タイプをサポートしているわけではありません。

対称集計が有効になっている場合、結合にファンアウトが含まれると、Looker は percentile メジャータイプと median メジャータイプを percentile_distinct と median_distinct に自動的に変換します。対称集計をサポートするすべてのデータベース言語が、percentile_distinct メジャータイプと median_distinct メジャータイプをサポートしているわけではありません。データベース言語がこれらのメジャータイプをサポートしているかどうかは、メジャータイプのドキュメント ページで確認できます。

SQL dialect doesn't support Symmetric Aggregates with percentiles, field ignored. のようなエラーが表示された場合は、データベース言語が percentile_distinct と median_distinct のメジャータイプをサポートしていないことを示しています。この問題を回避するには、メジャータイプを type: number に変更し、sql: median(${dimension}) で集計関数を指定します。ただし、これにより対称集計が無効になります。

対称集計と Value Overflow エラー

ダッシュボードをダウンロードまたは表示しようとすると、A LookML model issue occurred. Non-unique value/primary key (or sql_distinct_key), value overflow or collision when computing sum. などのエラーが発生することがあります。

大きな値を持つメジャーを集計する場合、対称集計のバックグラウンド計算で 10 進数のオーバーフロー エラーが発生することがあります。10 進数のオーバーフロー エラーは、Looker が 14 桁を超える非常に大きな値(10,000,000,000,000 を超える値)に対して左結合を使用して対称集計(type: sum など)を実行しようとしたときに発生します。

この問題を解決するには、precision パラメータを使用して 5 以下に設定します。次に例を示します。

measure: average_value {
  type: average
  precision: 5
  sql: ${value} ;;
}

対称集計の言語 サポート

対称集計を使用できるかどうかは、Looker 接続で使用されているデータベース言語によって異なります。Looker の最新リリースでは、次の言語が集約テーブルの自動認識をサポートしています。

方言 サポート対象
Actian Avalanche
Amazon Athena
Amazon Aurora MySQL
Amazon Redshift
Amazon Redshift 2.1+
Amazon Redshift Serverless 2.1+
Apache Druid
Apache Druid 0.13.x - 0.17.x
Apache Druid 0.18+
Apache Hive 2.3+
Apache Hive 3.1.2+
Apache Spark 3+
ClickHouse
ClickHouse 26+
Cloudera Impala 3.1+
Cloudera Impala 3.1+ with Native Driver
Cloudera Impala with Native Driver
DataVirtuality
Databricks
Denodo 7
Denodo 8 & 9
Dremio
Dremio 11+
Dremio 26+ with Arrow Flight SQL
Exasol
Google BigQuery Legacy SQL
Google BigQuery Standard SQL
Google Cloud AlloyDB for PostgreSQL
Google Cloud PostgreSQL
Google Cloud SQL
Google Spanner
Greenplum
HyperSQL
IBM Netezza
MariaDB
Microsoft Azure PostgreSQL
Microsoft Azure SQL Database
Microsoft Azure Synapse Analytics
Microsoft SQL Server 2008+
Microsoft SQL Server 2012+
Microsoft SQL Server 2016
Microsoft SQL Server 2017+
MongoBI
MongoSQL
MySQL
MySQL 8.0.12+
Oracle
Oracle ADWC
PostgreSQL 9.5+
PostgreSQL pre-9.5
PrestoDB
PrestoSQL
SAP HANA
SAP HANA 2+
SingleStore
SingleStore 7+
Snowflake
Teradata
Trino
Vector
Vertica