쿼리 상관 ID
쿼리 상관 ID (Query Correlation ID)
Pinot가 쿼리 상관 ID를 할당하고 재사용하는 방법이에요.
출처: 문서
본문
모든 Pinot 쿼리는 브로커와 서버 로그를 통해 추적할 수 있도록 상관 ID를 받아요.
기본 동작 (Default behavior)
Pinot는 브로커가 쿼리를 받으면 자동으로 상관 ID를 할당해요. 그 ID는 로깅 컨텍스트에 포함되며 클러스터를 통해 쿼리를 따라가는 데 사용할 수 있어요.
사용자 지정 ID (Custom IDs)
클라이언트가 이미 요청 식별자를 가졌다면 clientQueryId를 설정해 Pinot가 그것을 상관 ID로 사용하게 해요.
SET clientQueryId = 'query-2026-03-24-001';
SELECT * FROM stores LIMIT 10;
자체 ID를 제공할 때는 UUID 같은 높은 엔트로피 값을 사용하세요.
왜 중요한가 (Why it matters)
상관 ID는 다음과 같은 경우에 가장 유용해요.
- 단일 요청에 대한 로그 검색
- 나중에 쿼리 취소
- 애플리케이션 추적과 Pinot 쿼리 실행 연결
이 페이지가 다룬 내용
이 페이지는 Pinot가 쿼리 상관 ID를 할당하는 방법, 사용자 지정 ID를 제공하는 방법, 그리고 ID가 운영상 왜 중요한지를 다뤘어요.
다음 단계
실행 중인 쿼리를 중지해야 한다면 Query cancellation을 읽어 보세요.