<service_name>!SPCS_GET_METRICS¶

Snowflake가 지정된 서비스에 대해 수집한 메트릭을 반환합니다. 자세한 내용은 플랫폼 메트릭에 액세스하기 섹션을 참조하십시오.

참고

이 함수는 릴리스 9.20 이상에서 생성된 서비스 및 작업에 대해서만 지원됩니다.

구문¶

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

Copy

START_TIME => constant_expr

메트릭을 검색할 시간 범위의 시작 시간(TIMESTAMP_LTZ 형식)입니다. 데이터, 시간 및 타임스탬프 데이터를 구성하는 데 사용할 수 있는 함수에 대해서는 날짜 및 시간 함수 섹션을 참조하세요.

START_TIME 이 지정되지 않은 경우, 기본값은 1일 전입니다.

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	메트릭에 대한 추가 정보를 제공하는 키-값 페어입니다.

이 작업을 실행하는 데 사용되는 역할 에는 최소한 다음 권한 이 있어야 합니다.

권한	오브젝트	참고
OWNERSHIP	서비스

스키마의 모든 오브젝트에 대해 작업을 수행하려면 상위 데이터베이스 및 스키마에 대한 USAGE 권한.

지정된 권한 세트로 사용자 지정 역할을 만드는 방법에 대한 지침은 사용자 지정 역할 만들기 섹션을 참조하십시오.

보안 오브젝트 에 대해 SQL 작업을 수행하기 위한 역할과 권한 부여에 대한 일반적인 정보는 액세스 제어의 개요 섹션을 참조하십시오.

Snowflake가 지난 하루 동안 my_test_job 작업에 대해 수집한 메트릭을 검색합니다. 하루가 기본값입니다.

SELECT * FROM TABLE(my_test_job!SPCS_GET_METRICS());

Copy

Snowflake가 지난 3일 동안 my_test_job 작업에 대해 수집한 메트릭을 검색합니다.

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

Copy

이름이 main 인 컨테이너의 spcs_get_metrics 작업 인스턴스 0 에 대해 지난 하루 동안의 메트릭을 검색합니다.

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

Copy