SYSTEM$ESTIMATE_QUERY_ACCELERATION
SYSTEM$ESTIMATE_QUERY_ACCELERATION (쿼리 가속 추정)
이전에 실행된 쿼리에 대해, 그 쿼리가 쿼리 가속 서비스의 혜택을 받을 자격이 있는지 지정하는 JSON 객체를 반환해요. 쿼리가 쿼리 가속 자격이 있으면 출력에는 다양한 쿼리 가속 배율 인자에 대한 예상 쿼리 실행 시간이 포함돼요.
출처: Snowflake SQL Reference - SYSTEM$ESTIMATE_QUERY_ACCELERATION
본문
구문
SYSTEM$ESTIMATE_QUERY_ACCELERATION( '<query_id>' )
매개변수
query_id
쿼리 ID예요. 쿼리 ID는 지난 14일 이내에 실행된 쿼리여야 해요. 그렇지 않으면 상태가 invalid예요.
출력
이 함수는 아래에 설명된 속성을 가진 JSON 객체를 반환해요:
eligible: 쿼리가 쿼리 가속의 혜택을 받을 수 있어요.ineligible: 쿼리가 쿼리 가속의 혜택을 받을 수 없어요.accelerated: 쿼리가 이미 가속되었어요.invalid: 지정한 ID의 쿼리를 찾지 못했어요.upperLimitScaleFactor: estimatedQueryTimes 객체에서 가장 높은 쿼리 가속 배율 인자의 번호. 쿼리의 상태가 쿼리 가속 자격이 없으면 이 필드는 0으로 설정돼요.
estimatedQueryTimes 객체에서 각 이름/값 쌍은 쿼리 가속 배율 인자와 그 배율 인자에서의 예상 쿼리 실행 시간을 지정해요.
다음 예시는 배율 인자 1, 2, 4, 8에 대한 예상 쿼리 실행 시간을 나열해요:
...
"estimatedQueryTimes" : {
"1" : 171,
"2": 152,
"4": 133,
"8": 120
}
...
사용 참고 사항
- 예상 쿼리 시간은 분석 목적으로만 제공되며 보장되지 않아요.
- 예상 쿼리 시간은 쿼리가 쿼리 가속 서비스가 배율 인자에 따라 할당한 모든 컴퓨팅 리소스로 처리된다는 가정을 기반으로 계산돼요.
- 예상 쿼리 시간은 동시성(concurrency)을 고려하지 않아요.
예시
예시 쿼리는 SYSTEM$ESTIMATE_QUERY_ACCELERATION 함수로 쿼리 식별을 참고해요.