autogenerate_primary_keys

사용

  autogenerate_primary_keys: yes
계층 구조
view
autogenerate_primary_keys

- 또는 -

explore
autogenerate_primary_keys
기본값
아니요

특수 규칙

정의

autogenerate_primary_keys 매개변수가 사용 설정되면 Looker는 LookML에 명시적으로 정의되지 않은 뷰에 대해 임시 고유 키를 생성합니다. 자동 생성된 기본 키를 사용하면 대칭 집계와 일대다 개수를 올바르게 계산할 수 있습니다. 기본 키는 쿼리 런타임에 생성되며 쿼리 간에 유지되지 않습니다.

autogenerate_primary_keys 매개변수는 뷰와 Explore 모두에서 지원됩니다.

  • 뷰의 경우 autogenerate_primary_keys: yes로 뷰를 정의하면 Looker는 행 중복을 방지하기 위해 기본 키가 필요한 뷰에 대한 쿼리의 기본 키를 생성합니다. 기본 키로 정의된 필드가 이미 있는 뷰에 autogenerate_primary_keys: yes를 추가하면 Looker IDE에 LookML 유효성 검사 경고가 표시됩니다.

  • Explore의 경우 autogenerate_primary_keys: yes로 Explore를 정의하면 Looker는 행 중복을 방지하기 위해 기본 키가 필요한 Explore 쿼리에 필요한 각 Explore 뷰의 기본 키를 생성합니다.

    • Looker는 primary_key: yes로 정의된 필드가 없는 Explore의 뷰에 대해서만 기본 키를 생성합니다. 뷰에 primary_key: yes로 정의된 필드가 있는 경우 Looker는 뷰의 기본 키를 사용합니다.
    • Looker는 뷰가 해당 Explore를 통해 쿼리될 때만 Explore의 뷰에 대한 기본 키를 생성합니다. autogenerate_primary_keys: yes로 정의되지 않은 다른 Explore를 통해 동일한 뷰가 쿼리되고 뷰 자체가 autogenerate_primary_keys: yes로 정의되지 않은 경우 Looker는 뷰에 대한 기본 키를 생성하지 않습니다.

예

다음은 order_items 뷰를 조인하는 orders Explore입니다. Explore는 autogenerate_primary_keys: yes로 정의됩니다.

explore: orders {
  autogenerate_primary_keys: yes
  join: order_items {
    sql_on: ${orders.id} = ${order_items.order_id} ;;
    relationship: one_to_many
  }
}

뷰의 행이 중복될 수 있는 대칭 집계 또는 계산이 필요한 orders Explore에 대한 쿼리의 경우 Looker는 orders 또는 order_items 뷰에 대한 고유 키를 자동으로 생성합니다.

알아 두어야 할 사항

autogenerate_primary_keys: yes 사용에 관한 다음 사항에 유의하세요.

  • autogenerate_primary_keys를 사용 설정하면 기존 쿼리의 동작이 변경될 수 있습니다. 이전에 기본 키가 누락되어 Looker가 쿼리에서 삭제해야 했던 측정값이 이제 결과에 포함되므로 일부 보고서에서 호환성이 손상되는 변경사항이 발생할 수 있습니다.
  • 기본 키를 자동 생성하면 필요한 추가 계산으로 인해 쿼리 시간이 늘어날 수 있습니다.
  • Looker가 쿼리에 대한 기본 키를 생성하면 해당 기본 키는 Explore에서 선택하거나 시각화할 수 없는 임시 런타임 기본 키입니다.

autogenerate_primary_keys의 언어 지원

autogenerate_primary_keys를 사용할 수 있는지 여부는 Looker 연결에서 사용하는 데이터베이스 언어에 따라 다릅니다. 최신 버전의 Looker에서 다음 언어는 autogenerate_primary_keys를 지원합니다.

  • Google BigQuery 표준 SQL
  • Amazon Redshift
  • Amazon Redshift 2.1 이상
  • Amazon Redshift Serverless 2.1 이상
  • Google Cloud PostgreSQL
  • Greenplum
  • Microsoft Azure PostgreSQL
  • MySQL 8.0.12 이상
  • PostgreSQL pre-9.5