REST / gRPC APIs
REST / gRPC APIs
REST 및 gRPC API를 통해 Pinot에 직접 접근해요.
출처: 문서
본문
Pinot는 애플리케이션이 데이터와 클러스터 관리를 직접 제어할 수 있는 REST 및 gRPC API를 노출해요.
- REST (SQL):
/query/sql및/query엔드포인트로 broker에 대한 SQL 쿼리. 기존 HTTP 도구, 컬(curl), 스크립트와 잘 어울려요. - gRPC (SQL): 대용량 결과 집합에 대해 효율적 스트리밍을 제공하는 broker의 gRPC 쿼리 서버. Java/Python/Go 클라이언트를 사용하는 스트리밍 워크로드에 적합해요.
- Controller REST API: 테이블, 스키마, 세그먼트, tenant, 인스턴스 및 작업 관리용.
상세 엔드포인트 참조는 API reference에서 확인할 수 있어요.
REST SQL 쿼리 예시
curl -X POST http://localhost:8000/query/sql \
-H "Content-Type: application/json" \
-d '{"sql":"SELECT count(*) FROM baseballStats LIMIT 1"}'
gRPC 시작하기
gRPC 쿼리 서버는 broker에서 수신 대기하며 스트리밍 읽기를 지원해요.
# broker gRPC 포트는 기본값 8090
# broker 구성에서 gRPC 서버를 활성화했는지 확인
상세 사항은 API reference를 참조하세요.
언제 무엇을 사용할까
- 단일 결과 집합 쿼리와 스크립팅용 → REST SQL.
- 대용량 결과 집합을 스트리밍으로 받아야 하는 경우 → gRPC.
- 테이블/스키마/세그먼트 관리용 → Controller REST API.