<service_name>!SPCS_GET_METRICS¶

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

구문¶

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

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

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

Operating on an object in a schema requires at least one privilege on the parent database and at least one privilege on the parent schema.

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

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

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

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

Copy

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

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

Copy

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

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

Copy