클라이언트 라이브러리
클라이언트 라이브러리 (Client libraries)
Java, JDBC, Python, Go용 Pinot 클라이언트 라이브러리로 애플리케이션을 구축해요.
출처: 문서
본문
애플리케이션 코드가 BI 도구나 페더레이션 SQL 엔진을 거치지 않고 Pinot를 직접 쿼리해야 할 때 클라이언트 라이브러리를 사용해요. 클라이언트 경로는 broker 인지 라우팅, 비동기 쿼리, prepared statements, 또는 Pinot 결과 집합 직접 접근을 원할 때 가장 좋아요.
여기에 속하는 것
| Client | Best for | Notes |
|---|---|---|
| Java | JVM 서비스 및 라이브러리 | blocking 및 async 실행, prepared statements, 요청 추적, tenant 인지 broker 선택을 가진 네이티브 쿼리 클라이언트. 동일한 org.apache.pinot:pinot-java-client:1.4.0 아티팩트가 controller 지향 Java admin client도 제공. |
| JDBC | SQL 우선 애플리케이션 및 BI 플래밍 | SQL 도구에 임베드하기 쉬운 표준 JDBC 인터페이스. 링크된 문서는 org.apache.pinot:pinot-jdbc-client:1.4.0 사용. |
| Python | 데이터 앱, 노트북, SQLAlchemy 워크플로우 | pinotdb를 통한 DB-API 및 SQLAlchemy 지원. 링크된 문서는 pinotdb 0.3.2+의 SQL API 지원과 0.2.x의 구버전 PQL 호환성을 언급. |
| Go | Go로 작성된 서비스 및 배치 도구 | 직접 SQL 실행과 응답 검사를 가진 네이티브 Go 클라이언트. |
선택 방법
JVM 애플리케이션에서 가장 직접적인 Pinot 네이티브 API 표면을 원한다면 Java를 선택하세요. broker 라우팅 SQL 실행에는 Java 쿼리 클라이언트를, JVM 코드가 테이블, 스키마, 세그먼트, 인스턴스, tenant, 작업에 대한 controller REST API를 필요로 하면 Java admin client를 사용하세요. 소비 도구가 데이터베이스 드라이버를 기대하면 JDBC를 선택하세요. 노트북 친화적 또는 ORM 친화적 연결이 필요하면 Python을, Go 서비스나 파이프라인에서 얇은 클라이언트를 원하면 Go를 선택하세요.
Java와 JDBC 클라이언트 문서는 둘 다 현재 설치 예시에서 1.4.0 아티팩트를 사용해요. 클라이언트 문서를 새로 고칠 때 의존성 버전이 어긋나지 않도록 이 두 예시를 일치시켜 유지하세요.