SPCS_GET_METRICS

SPCS_GET_METRICS

지정한 서비스에 대해 Snowflake가 수집한 메트릭을 반환해요. 자세한 내용은 플랫폼 메트릭 접근(Access platform metrics) 문서를 참고해요.

출처: Snowflake SQL Reference - SPCS_GET_METRICS

본문

구문

<service_name>!SPCS_GET_METRICS(
    [ START_TIME => <constant_expr> ],
    [ END_TIME => <constant_expr> ] )

인자

START_TIME => constant_expr

  • 메트릭을 가져올 시간 범위의 시작 시각(TIMESTAMP_LTZ 형식)이에요. 날짜·시간·타임스탬프 데이터를 만드는 데 쓸 수 있는 함수는 날짜 및 시간 함수(Date & time functions) 문서를 참고해요. START_TIME을 지정하지 않으면 기본값은 하루 전이에요.

END_TIME => constant_expr

  • 메트릭을 가져올 시간 범위의 종료 시각(TIMESTAMP_LTZ 형식)이에요. END_TIME을 지정하지 않으면 기본값은 현재 타임스탬프예요.

출력

이 함수는 다음 열을 반환해요.

열 데이터 타입 설명
TIMESTAMP TIMESTAMP_NTZ Snowflake가 메트릭을 수집한 협정 세계시(UTC) 타임스탬프예요.
METRIC_NAME VARCHAR 메트릭의 이름이에요.
VALUE VARCHAR 메트릭의 값이에요.
UNIT VARCHAR 반환된 메트릭의 단위예요.
INSTANCE_ID NUMBER 메트릭이 서비스 인스턴스와 관련이 있다면 해당 서비스 인스턴스의 이름이에요.
CONTAINER_NAME VARCHAR 메트릭이 컨테이너와 관련이 있다면 해당 컨테이너의 이름이에요. 예를 들어 볼륨 메트릭에는 컨테이너 이름이 없어요.
RESOURCE VARCHAR 메트릭과 관련된 하드웨어(예: GPU)예요. 이 열은 채워지지 않아요.
RECORD OBJECT 메트릭 정보를 제공하는 키-값 쌍이에요.
RECORD_ATTRIBUTES OBJECT 메트릭에 대한 추가 정보를 제공하는 키-값 쌍이에요.

접근 제어 요구 사항

이 작업을 실행하는 데 사용되는 역할은 최소한 다음 권한을 보유해야 해요.

권한 객체 참고
MONITOR Service

스키마의 객체에 대해 작업하려면 상위 데이터베이스에 대한 권한이 하나 이상이고 상위 스키마에 대한 권한이 하나 이상이어야 해요.

지정된 권한 집합으로 사용자 지정 역할을 만드는 방법은 사용자 지정 역할 만들기(Creating custom roles) 문서를 참고해요. 보호 가능한 객체를 대상으로 SQL 작업을 수행할 때 역할과 권한 부여에 대한 일반 정보는 접근 제어 개요(Overview of Access Control) 문서를 참고해요.

사용법 참고 사항

  • 출력에 메트릭이 나타나기까지 몇 분이 걸릴 수 있어요.

예제

지난 하루(기본값) 동안 my_test_job 작업에 대해 Snowflake가 수집한 메트릭을 가져와요.

SELECT * FROM TABLE(mydb.myschema.my_test_job!SPCS_GET_METRICS());

지난 3일 동안 my_test_job 작업에 대해 Snowflake가 수집한 메트릭을 가져와요.

SELECT * from TABLE(mydb.myschema.my_test_job!SPCS_GET_METRICS(start_time => DATEADD('day', -3, CURRENT_TIMESTAMP())));

main이라는 컨테이너의 spcs_get_metrics 작업 인스턴스 0에서 지난 하루 동안의 메트릭을 가져와요.

SELECT * FROM TABLE(mydb.myschema.my_test_job!SPCS_GET_METRICS())
 WHERE instance_id = 0 AND container_name = 'main';

더 알아보기