QUERY_HISTORY , QUERY_HISTORY_BY_*¶

구문¶

QUERY_HISTORY(
      [ END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_SESSION(
      [ SESSION_ID => <constant_expr> ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_USER(
      [ USER_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

QUERY_HISTORY_BY_WAREHOUSE(
      [ WAREHOUSE_NAME => '<string>' ]
      [, END_TIME_RANGE_START => <constant_expr> ]
      [, END_TIME_RANGE_END => <constant_expr> ]
      [, RESULT_LIMIT => <num> ] )

인자¶

모든 인자는 선택 사항입니다.

END_TIME_RANGE_START => constant_expr , . END_TIME_RANGE_END => constant_expr

쿼리 실행이 완료된 지난 7일 이내의 시간 범위(TIMESTAMP_LTZ 형식):

• END_TIME_RANGE_END 를 지정하지 않으면 함수는 여전히 실행 중인 쿼리를 포함하여 모든 쿼리를 반환합니다.

• END_TIME_RANGE_END 가 CURRENT_TIMESTAMP 이면 함수는 완료된 쿼리만 반환합니다.

시간 범위가 지난 7일 이내에 속하지 않는 경우, 오류가 반환됩니다.

참고

시작 또는 종료 시간을 지정하지 않는 경우, 지정된 제한까지를 범위로 하여 가장 최근 쿼리가 반환됩니다.

SESSION_ID => constant_expr

QUERY_HISTORY_BY_SESSION에만 적용

세션 또는 CURRENT_SESSION 의 숫자 식별자입니다. 지정된 세션의 쿼리만 반환됩니다.

기본값: CURRENT_SESSION

USER_NAME => 'string'

QUERY_HISTORY_BY_USER에만 적용

사용자 로그인 이름 또는 CURRENT_USER 를 지정하는 문자열입니다. 지정된 사용자가 실행한 쿼리만 반환됩니다. 로그인 이름은 작은따옴표로 묶어야 합니다. 또한, 로그인 이름에 공백, 대/소문자 혼합 문자 또는 특수 문자가 포함된 경우, 이름을 작은따옴표 안에 큰따옴표로 묶어야 합니다(예: '"User 1"' vs 'user1').

기본값: CURRENT_USER

WAREHOUSE_NAME => 'string'

QUERY_HISTORY_BY_WAREHOUSE에만 적용

웨어하우스 이름 또는 CURRENT_WAREHOUSE 를 지정하는 문자열입니다. 해당 웨어하우스에서 실행한 쿼리만 반환됩니다. 웨어하우스 이름은 작은따옴표로 묶어야 합니다. 또한, 웨어하우스 이름에 공백, 대/소문자 혼합 문자 또는 특수 문자가 포함된 경우, 이름을 작은따옴표 안에 큰따옴표로 묶어야 합니다(예: '"My Warehouse"' vs 'mywarehouse').

기본값: CURRENT_WAREHOUSE

RESULT_LIMIT => num

함수가 반환하는 최대 행 수를 지정하는 숫자:

일치하는 행의 수가 이 제한보다 큰 경우, 지정된 제한까지를 범위로 하여 종료 시간이 가장 최근인 쿼리(또는 여전히 실행 중인 쿼리)가 반환됩니다.

범위: 1 ~ 10000

기본값: 100.

사용법 노트¶

• 현재 사용자가 실행한 쿼리를 반환합니다. 또한, 실행 역할이나, 계층의 상위 역할에 쿼리가 실행된 웨어하우스에 대한 MONITOR 또는 OPERATE 권한이 있을 때 모든 사용자가 실행한 쿼리를 반환합니다. 자세한 내용은 가상 웨어하우스 권한 섹션을 참조하십시오.

• Information Schema 테이블 함수를 호출할 때 세션에는 사용 중인 INFORMATION_SCHEMA 스키마가 있거나 또는 함수 이름이 정규화되어야 합니다. 자세한 내용은 Snowflake Information Schema 섹션을 참조하십시오.

• EXTERNAL_FUNCTION_TOTAL_INVOCATIONS, EXTERNAL_FUNCTION_TOTAL_SENT_ROWS, EXTERNAL_FUNCTION_TOTAL_RECEIVED_ROWS, EXTERNAL_FUNCTION_TOTAL_SENT_BYTES, EXTERNAL_FUNCTION_TOTAL_RECEIVED_BYTES 열의 값은 다음을 비롯한 여러 요인의 영향을 받습니다.

  • SQL 문에 있는 외부 함수의 수입니다.

  • 각 원격 서비스에 보낸 배치당 행 수입니다.

  • 일시적인 오류(예: 예상 시간 내에 응답이 수신되지 않았기 때문)로 인한 재시도 횟수입니다.

출력¶

이 함수는 다음 열을 반환합니다.

1(1,2,3,4)

이 열은 2023_06 동작 변경 번들이 활성화된 경우에만 존재합니다. 이 열은 쿼리 해시 기능의 일부입니다.

QUERY_TYPE 열의 잠재적 값은 다음과 같습니다.

• CREATE_USER

• CREATE_ROLE

• CREATE_NETWORK_POLICY

• ALTER_ROLE

• ALTER_NETWORK_POLICY

• ALTER_ACCOUNT

• DROP_SEQUENCE

• DROP_USER

• DROP_ROLE

• DROP_NETWORK_POLICY

• RENAME_NETWORK_POLICY

• REVOKE

예¶

다음과 같이 현재 세션에서 실행된 최대 100개의 쿼리를 검색합니다.

select *
from table(information_schema.query_history_by_session())
order by start_time;

Copy

다음과 같이 현재 사용자가 실행한(또는 현재 사용자에게 MONITOR 권한이 있는 웨어하우스에서 모든 사용자가 실행한) 마지막 100개의 쿼리를 검색합니다.

select *
from table(information_schema.query_history())
order by start_time;

Copy

다음과 같이 지난 1시간 동안 현재 사용자가 실행한(또는 현재 사용자에게 MONITOR 권한이 있는 웨어하우스에서 모든 사용자가 실행한) 마지막 100개의 쿼리를 검색합니다.

select *
from table(information_schema.query_history(dateadd('hours',-1,current_timestamp()),current_timestamp()))
order by start_time;

Copy

다음과 같이 지난 7일 동안, 지정된 30분 시간 블록 내에 현재 사용자가 실행한(또는 현재 사용자에게 MONITOR 권한이 있는 웨어하우스에서 모든 사용자가 실행한) 모든 쿼리를 검색합니다.

select *
  from table(information_schema.query_history(
    END_TIME_RANGE_START=>to_timestamp_ltz('2017-12-4 12:00:00.000 -0700'),
    END_TIME_RANGE_END=>to_timestamp_ltz('2017-12-4 12:30:00.000 -0700')));

Copy