쿼리 취소
쿼리 취소 (Query Cancellation)
실행 중인 Pinot 쿼리를 중지하는 방법이에요.
출처: 문서
본문
쿼리가 여전히 실행 중이고 끝나기 전에 중지해야 할 때 쿼리 취소를 사용해요.
먼저 추적 활성화
쿼리 취소는 브로커와 서버 모두에서 쿼리 추적이 활성화되어 있어야 해요.
pinot.server.enable.query.cancellation=true
pinot.broker.enable.query.cancellation=true
권장 흐름: 클라이언트 쿼리 ID로 취소
가장 깔끔한 취소 흐름은 쿼리에 clientQueryId를 설정한 다음 그 ID로 취소하는 것이에요.
SET clientQueryId = 'query-2026-03-24-001';
SELECT * FROM stores LIMIT 100;
그런 다음 일치하는 ID로 취소해요.
curl -X DELETE 'http://localhost:9000/queryClient/query-2026-03-24-001'
클라이언트 쿼리 ID는 로그의 상관 ID(correlation ID)로도 사용할 수 있으므로 프로그램에 가장 좋은 옵션이에요.
대체 흐름: 내부 브로커 ID로 취소
클라이언트 쿼리 ID를 제어하지 못하면 Pinot는 브로커가 할당한 내부 ID로도 쿼리를 취소할 수 있어요. 이 흐름은 브로커와 내부 쿼리 ID가 모두 필요하기 때문에 운영상 더 번거로워요.
이 페이지가 다룬 내용
이 페이지는 취소의 사전 요구 사항, 권장되는 클라이언트 쿼리 ID 흐름, 내부 ID 대체 흐름을 다뤘어요.
다음 단계
로그나 추적을 위해 쿼리 ID가 필요하다면 Correlation IDs를 읽어 보세요.