적용 대상:예 Databricks Runtime 18.2 이상으로 ![]()
정수 요약과 세트 유니온을 사용해 튜플스케치와 쎄타 스케치를 병합합니다.
Syntax
tuple_union_theta_integer ( first, second [, lgNomEntries [, mode ]] )
Arguments
- first: 정수 요약이 포함된 이진 형식의 TupleSketch입니다.
-
둘째: 집계 함수와 같은
theta_sketch_agg이진 형식의 쎄타 스케치. -
lgNomEntries: 명목 항목의 log-base-2를 지정하는 선택적
INTEGER리터럴입니다. 4에서 26 사이여야 합니다. 기본값은 12입니다. -
mode: 집계 모드를 지정하는 선택적
STRING리터럴입니다. 유효한 값:'sum','min','max''alwaysone'. 기본값은'sum'입니다.
Returns
BINARY 정수 요약이 포함된 병합된 TupleSketch를 포함하는 값입니다.
first 또는 second이 NULL이면 결과는 NULL입니다.
Notes
- 인수 순서는 고정되어 있습니다:
first반드시 튜플스케치여야 하고second쎄타 스케치여야 합니다. 스케치 유형을 역순으로 넘기면 TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY이 올라갑니다. - 쎄타 스케치 키는 다음과 같은
mode기본 정수 요약이 할당됩니다:0에 대해'sum', 에 대한 최대'min'INTEGER값, 에 대한 최소INTEGER값'max', 또는1에 대해'alwaysone'. - 키가 두 스케치에 모두 등장하면, 요약 값은 에 따라
mode결합됩니다.
일반적인 오류 조건
- TUPLE_INVALID_INPUT_SKETCH_BUFFER
- TUPLE_INVALID_INPUT_SKETCH_BUFFER_FAMILY (잘못된 입력 스케치 버퍼 패밀리의 튜플)
- THETA_INVALID_INPUT_SKETCH_BUFFER
- THETA_INVALID_INPUT_SKETCH_BUFFER_FAMILY
- SKETCH_INVALID_LG_NOM_ENTRIES
- DATATYPE_MISMATCH. TYPE_CHECK_FAILURE_WITH_HINT
- TUPLE_INVALID_SKETCH_MODE
Examples
> SELECT tuple_sketch_estimate_integer(
tuple_union_theta_integer(
tuple_sketch_agg_integer(col1, val1),
theta_sketch_agg(col2)
)
) FROM VALUES (1, 1, 4), (2, 2, 5), (3, 3, 6) tab(col1, val1, col2);
6.0