데이터셋 프로젝션 활성화와 빌드

프로젝션을 사용하려면 데이터셋에서 Noho 기능을 활성화하고, 조회 패턴에 맞는 프로젝션을 만든 뒤 데이터를 채우는 빌드를 구성해야 합니다. 프로젝션 정의를 만드는 것만으로 조회용 데이터가 준비되는 것은 아닙니다.

Noho 활성화

변환에서 출력할 때 options={"noho": "true"}를 지정할 수 있습니다. 다음 예제는 입력 데이터를 새 출력에 쓰면서 해당 옵션을 설정합니다. 경로는 실제 데이터셋으로 지정합니다.

from transforms.api import Input, Output, transform


@transform(
    output_dataset=Output("/examples/projections/enabled"),
    input_dataset=Input("/examples/projections/source"),
)
def enable_projection_support(output_dataset, input_dataset):
    dataframe = input_dataset.dataframe()
    output_dataset.write_dataframe(dataframe, options={"noho": "true"})

데이터셋 Details의 스키마 편집에서도 구성할 수 있습니다. 화면의 설정 위치는 customMetadata.options.noho이며 값은 문자열 "true"입니다. 기존 열 스키마, 형식과 다른 옵션은 유지하고 필요한 옵션을 추가합니다.

{
  "customMetadata": {
    "options": {
      "noho": "true"
    }
  }
}

이 JSON은 옵션의 위치를 보여 주는 부분 구성입니다. 데이터셋의 전체 스키마를 이 조각으로 대체하지 않습니다.

스키마의 Noho 옵션

Projections 탭과 열 선택

Noho가 활성화되어 있고 데이터셋 편집 권한이 있으면 Projections 탭이 표시됩니다. Add new projection을 선택합니다.

Projections 탭 열기

새 프로젝션 추가

일반적으로 All columns를 선택합니다. 질의가 일부 열만 사용한다면 Only Columns로 필요한 열만 포함하거나 Excluding Columns로 특정 열을 제외할 수 있습니다. 프로젝션은 자신이 포함한 열이나 그 부분집합을 읽는 요청에만 사용할 수 있습니다.

포함할 열 범위 선택

최적화 유형

유형	구성
`Filtering`	필터 열을 순서대로 지정합니다. 그 목록의 선두 연속 부분에 대한 조건을 최적화합니다. 범위 조회가 필요하면 `Range Scans Required`를 사용하며 비기본형 열 제약도 확인합니다.
`Joining`	조인 열 집합과 버킷 수를 지정합니다. 조인 열은 정확히 일치해야 하며 다른 버킷 데이터와 결합하려면 버킷 수까지 같아야 합니다.

필터와 조인 최적화 선택