함수 개요
함수 개요 (Functions)
Pinot 함수 계열을 살펴보고 올바른 실행 엔진 안내로 이동해요.
출처: 문서
본문
이 섹션은 Pinot SQL 함수의 진입점이에요. 목표는 탐색입니다: 함수 계열을 선택하고 single-stage 엔진에서 쿼리 안전한지 이해한 다음 전체 문법이나 예시가 필요할 때 상세 페이지로 이동하세요.
대부분의 핵심 함수 계열은 두 엔진 모두에서 동작해요. Window 함수는 multi-stage 엔진이 필요하며, 함수 인덱스의 엔진 열이 특정 함수의 지원 실행 모델을 확인하는 가장 빠른 방법이에요.
계열별 탐색
| Family | Typical use | Engine signal | Detailed docs |
|---|---|---|---|
| Aggregation | 메트릭, distinct counts, sketches, percentiles | Both, window 지향 몇 가지 제외. | Aggregation Functions |
| Array | Multi-value 및 배열 조작 | Both | Array Functions |
| Binary | 해싱 및 인코딩 | Both | Binary Functions |
| DateTime | 버케팅, 자르기, epoch 변환 | Both | DateTime Functions |
| Funnel | 퍼널 분석 | Both | Funnel Functions |
| Geospatial | 공간 조건자 및 기하 변환 | Both | GeoSpatial Functions |
| Hash | 해시 기반 분포 및 라우팅 헬퍼 | Both | Hash Functions |
| IP Address | 네트워크 및 서브넷 검사 | Both | IP Address Functions |
| JSON | 경로 추출, 포맷, 타입화된 JSON 접근 | Both, query-safe 타입화 변형 포함. | JSON Functions |
| Math | 산술 및 숫자 성형 | Both | Math Functions |
| Miscellaneous | 유틸리티 조건자 및 헬퍼 | Both | Miscellaneous Functions |
| Null handling | Null 인지 쿼리 동작 | Both, null 지원 활성화 시 | Null Handling Functions |
| Sketch | 근사 분석 헬퍼 | Both | Sketch Functions |
| Statistical | 분산 및 공분산 함수 | Both | Statistical Functions |
| String | 대소문자, 자르기, 토큰화, regex, 포맷 | Both | String Functions |
| Trigonometric | 사인, 코사인 및 관련 수학 | Both | Trigonometric Functions |
| Type conversion | Cast 유사 및 변환 헬퍼 | Both | Type Conversion Functions |
| UDFs | 사용자 지정 확장 지점 | 구현에 따라 다름 | User-Defined Functions |
| Vector / similarity | 임베딩 및 유사도 검색 헬퍼 | Both, 지원되는 곳 | Vector / Similarity Functions |
| Window | 순위, 프레임, 롤링 계산 | Multi-stage only | Window Functions |
수집 시점 변환 (Ingestion-time transformations)
레코드를 Pinot에 넣기 전에 모양을 다듬는다면 원시 함수 카탈로그에서 시작하는 대신 큐레이팅된 변환 안내를 사용하세요.
변환 안내는 타입화된 JSON 접근, 문자열 성형, 날짜/시간 변환, multi-value 헬퍼를 포함해 스키마 업데이트, 수집 구성, 쿼리 프로젝션에서 가장 자주 사용되는 함수를 함께 모아요.
엔진 선택
쿼리가 single-stage 엔진에 속하는지 multi-stage 엔진에 속하는지 결정한다면 먼저 결정 안내를 사용한 다음 여기로 돌아와 관련된 함수 계열을 확인하세요.
이 페이지에서 다룬 내용
- 주요 Pinot 함수 계열과 각 계열의 엔진 신호.
- 수집 시점 변환 안내로 갈 곳.
- 함수가 많은 쿼리 형태를 선택하기 전에 사용할 엔진 결정 안내.
다음 단계
- 필요한 문법과 예시에 대한 함수 계열 페이지를 열고, 쿼리를 작성하기 전에 엔진 제약을 확인하세요.