함수 개요

함수 개요 (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 함수 계열과 각 계열의 엔진 신호.
  • 수집 시점 변환 안내로 갈 곳.
  • 함수가 많은 쿼리 형태를 선택하기 전에 사용할 엔진 결정 안내.

다음 단계

  • 필요한 문법과 예시에 대한 함수 계열 페이지를 열고, 쿼리를 작성하기 전에 엔진 제약을 확인하세요.

더 알아보기 (Learn more)