Keyboard shortcuts

Press ← or → to navigate between chapters

Press ? to show this help

Press Esc to hide this help

Pipeline Builder 변환 참조

변환은 파이프라인 단계에서 테이블, 파일과 미디어 입력을 처리합니다. Table과 Files는 연산이 받는 입력 표현을 구분하며, Column<T>는 T 자료형의 열 선택, Expression<T>는 T 값을 계산하는 표현식입니다. ColumnPredicate는 입력 스키마의 열을 선택하는 조건으로 행 필터의 Boolean 표현식과 다릅니다.

Batch, Faster, Streaming 지원은 변환마다 다릅니다. 특히 스트리밍의 키 지정, 순서 위반 제거, 이벤트 시각 정렬은 서로 다른 동작입니다. 키를 지정하는 것만으로 과거 데이터의 순서가 복구되지는 않습니다.

입출력 예시의 데이터셋 식별자는 입력 테이블을 구분하는 예시값입니다. 실제 파이프라인에서는 해당 입력 리소스를 선택하고 열 이름, 자료형과 출력 스키마를 구성합니다.

구조체

구조체 필드를 개별 열로 추출하거나 펼칩니다.

변환식별자지원 실행 방식
여러 구조체 필드 추출getManyStructFieldsV1Batch, Faster
구조체 펼치기flattenStructV2Batch, Faster, Streaming

날짜와 시간

날짜와 타임스탬프를 시간 구간으로 나누어 분포를 계산합니다.

변환식별자지원 실행 방식
날짜 분포dateDistributionV1Batch

데이터 정리

중복 행과 열 이름 등 데이터셋 구조를 정리합니다.

변환식별자지원 실행 방식
행 필터filterV1Batch, Faster, Streaming
열 이름 정규화normalizeColumnNamesV1Batch, Faster, Streaming
열 이름 변경renameColumnsV1Batch, Faster, Streaming
열 이름 대문자화uppercaseColumnNamesV1Batch, Faster, Streaming

배열

배열의 원소를 데이터셋의 열로 펼칩니다.

변환식별자지원 실행 방식
배열 원소를 열로 추출arrayToColumnsV1Batch, Faster

숫자 분포

숫자 열의 값을 지정한 구간으로 나누어 분포를 계산합니다.

변환식별자지원 실행 방식
숫자 분포numericDistributionV2Batch, Faster

열, 행과 실행 제어

열 선택과 표현식 적용, 파일 합치기, 파티션, 정렬 및 스트리밍 상태 제어를 구성합니다.

변환식별자지원 실행 방식
표현식 하나 적용applyExpressionV1Batch, Faster, Streaming
여러 표현식 적용projectV1Batch, Faster, Streaming
윈도에 연산 적용applyOverWindowV1Streaming
여러 열에 조건부 적용projectOnConditionV1Batch, Faster, Streaming
타임스탬프와 워터마크 지정assignTimestampsAndWatermarksV1Streaming
파티션 병합coalesceV1Batch, Faster
아직 계산하지 않은 키의 표현식computeExpressionIfAbsentV1Batch, Faster
열 제거dropV1Batch, Faster, Streaming
중복 행 제거dropDuplicatesV1Batch, Faster
빈 파일 생성emptyFileV1Batch
빈 미디어 집합 파일 생성emptyMediaSetFileV1Batch, Streaming
빈 테이블 생성emptyTableV1Batch, Faster, Streaming
하트비트 감지heartbeatDetectionV2Streaming
K-means 군집화kmeansV1Batch
중복 행 유지keepDuplicatesV1Batch, Faster
키 지정keyByV3Streaming
수동 입력 테이블manuallyEnteredTableV1Batch, Faster, Streaming
새 연산자 체인newOperatorChainV1Streaming
데이터 재파티셔닝repartitionV1Batch, Faster
행 크기 추정rowSizeV1Batch
열 선택selectV1Batch, Faster, Streaming
데이터 정렬sortV2Batch, Faster
조건으로 출력 분리splitOnConditionV1Batch, Faster
텍스트 블록textBlockV1Batch, Faster, Streaming
시간 범위 내 중복 제거timeBoundedDropDuplicatesV3Streaming
시간 범위 내 순서 위반 제거timeBoundedDropOutOfOrderTransformV1Streaming
이벤트 시각 순서 정렬timeBoundedEventTimeSortV1Streaming

조인

두 입력의 일치 관계로 행을 결합합니다. 외부 조인, 안티/세미 조인, 조회 및 캐싱 조인의 보존 범위를 구분합니다.

변환식별자지원 실행 방식
안티 조인complexAntiJoinV1Batch, Faster
교차 조인complexCrossJoinV1Batch, Faster
첫 입력 열 기준 합치기firstUnionByNameV1Batch, Faster
내부 조인complexInnerJoinV1Batch, Faster
데이터셋 조인joinV2Batch, Faster, Streaming
KNN 조인complexKnnJoinV1Batch
왼쪽 조인complexLeftJoinV1Batch, Faster
왼쪽 조회 조인leftLookupJoinV2Streaming
매핑 조인mappingJoinV1Batch, Faster
공통 열 기준 합치기narrowUnionByNameV1Batch, Faster
외부 캐싱 조인: 선택 열 지정frontendOuterCachingJoinV3Streaming
외부 캐싱 조인: 이벤트 시각 기준outerCachingJoinV3Streaming
외부 조인complexOuterJoinV1Batch, Faster
세미 조인complexSemiJoinV1Batch, Faster
열 이름으로 합치기unionByNameV1Batch, Faster, Streaming
모든 열 기준 합치기wideUnionByNameV1Batch, Faster, Streaming

지리공간

거리와 교차, 최근접 이웃으로 지리공간 데이터를 결합합니다. 좌표계와 메모리 요구 조건이 연산별로 다릅니다.

변환식별자지원 실행 방식
거리 기반 내부 조인geoDistanceInnerJoinV1Batch
거리 기반 왼쪽 조인geoDistanceLeftJoinV1Batch
교차 도형 내부 조인geoIntersectionInnerJoinV1Batch, Streaming
교차 도형 왼쪽 안티 조인geoIntersectionAntiJoinV1Streaming
교차 도형 왼쪽 조인geoIntersectionLeftJoinV1Batch, Streaming
도형 교차 조인geoIntersectionJoinV1Batch
도형 KNN 내부 조인geoKnnInnerJoinV1Batch
도형 KNN 왼쪽 조인geoKnnLeftJoinV1Batch
점 사이 3차원 거리 내부 조인geoPointToPoint3dDistanceInnerJoinV1Batch

집계

그룹, 피벗과 윈도 안에서 값을 집계합니다. 스트리밍 집계는 윈도와 트리거, 누적 모드의 조건을 따릅니다.

변환식별자지원 실행 방식
그룹 집계aggregateV1Batch, Faster
조건에 맞는 열 집계aggregateOnConditionV1Batch, Faster
윈도 집계aggregateOverWindowV2Streaming
빈발 패턴 탐색fpGrowthV1Batch
피벗pivotV1Batch, Faster
윈도별 열 계산windowedProjectV1Batch, Faster, Streaming
계층별 Rollup 집계rollUpV1Batch, Faster
상위 행 선택topRowV2Batch, Faster
UnpivotunpivotV1Batch, Faster, Streaming
윈도 표현식 적용windowV1Batch, Faster

파일과 미디어 입력

파일, 미디어 집합과 메타데이터를 읽거나 해석합니다. 형식, 스키마, 파일 묶음과 미리보기 권한의 조건을 확인합니다.

변환식별자지원 실행 방식
미디어 집합을 테이블 행으로 변환loadMediaSetReferencesV2Batch
gzip 파일 압축 해제ungzipFilesV1Batch
tar 파일 압축 해제untarFilesV1Batch
파일 메타데이터를 행으로 추출extractFileMetadataAsRowsV1Batch, Faster
CSV 파일에서 행 추출parseCsvV1Batch
이메일 파일에서 행 추출extractEmailDataAsRowsV1Batch
텍스트 파일에서 행 추출parseTextFileV1Batch
GeoJSON 파일에서 행 추출parseGeoJsonV1Batch
JSON 파일에서 행 추출parseJsonV1Batch
Excel 파일에서 행 추출parseExcelV2Batch
XML 파일에서 행 추출xmlTagExtractV1Batch
Shapefile에서 행 추출parseShapefileV1Batch
파일 필터filterFilesV1Batch
데이터셋 미디어 참조 가져오기loadMediaReferencesV1Batch
KML 파일을 도형 목록으로 해석parseKmlFilesV1Batch
파일 데이터셋 합치기unionFilesV1Batch
ZIP 파일 압축 해제unzipFilesV1Batch