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 함수로 쿼리 식별을 참고해요.

더 알아보기