symmetric_aggregates

사용

explore: explore_name {
  symmetric_aggregates: yes
}
계층 구조
symmetric_aggregates
기본값
yes

수락함
불리언(yes 또는 no)

정의

symmetric_aggregates 파라미터는 지정된 Explore 내에서 대칭 집계를 적용할지 여부를 결정합니다. symmetric_aggregates가 사용 설정된 경우 조인으로 인해 팬아웃이 발생하더라도 집계 함수는 올바른 결과를 반환합니다. 대칭 집계에 대한 자세한 내용은 대칭 집계 이해 권장사항 페이지를 참고하고, 대칭 집계로 해결되는 팬아웃 문제는 SQL 팬아웃 문제 커뮤니티 게시물을 참고하세요.

기본적으로 Looker 내의 모든 Explore에 대칭 집계가 사용 설정됩니다. 즉, SQL 언어가 대칭 집계를 지원하는 경우 Explore에서 해당 기능을 사용 중지하려는 경우에만 symmetric_aggregates 파라미터를 포함해야 합니다.

예시

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.와 같은 오류가 발생할 수 있습니다.

값이 큰 측정값을 집계할 때 대칭 집계의 백그라운드 계산으로 인해 소수점 오버플로 오류가 발생할 수 있습니다. 14자리를 초과하는 매우 큰 값(10,000,000,000,000보다 큰 값)에 대해 Looker가 왼쪽 조인으로 대칭 집계(예: 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