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 탐색 분석에서 대칭 집계 또는 뷰의 행이 중복될 수 있는 계산이 필요한 쿼리의 경우 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