Amazon Redshift는 패치 198부터 새 Python UDF 생성을 더 이상 지원하지 않습니다. 기존 Python UDF는 2026년 6월 30일까지 계속 작동합니다. 자세한 내용은 [블로그 게시물](https://aws.amazon.com/blogs/big-data/amazon-redshift-python-user-defined-functions-will-reach-end-of-support-after-june-30-2026/)을 참조하세요.
# STV\$1QUERY\$1METRICS
사용자 정의 쿼리 대기열(서비스 클래스)에서 실행 중인 활성 쿼리의 지표 정보(처리된 행의 수, CPU 사용량, 입/출력, 디스크 사용량)가 저장됩니다. 완료된 쿼리의 지표를 보려면 [STL\$1QUERY\$1METRICS](r_STL_QUERY_METRICS.md) 시스템 테이블을 참조하십시오.
쿼리 지표는 1초 간격으로 샘플링됩니다. 결과적으로 동일한 쿼리라고 해도 다르게 실행하면 약간 다른 시간을 반환할 수 있습니다. 또한 1초 이내에 실행되는 쿼리 세그먼트는 기록되지 않을 수도 있습니다.
STV\$1QUERY\$1METRICS은 지표를 쿼리, 세그먼트 및 단계 수준으로 추적 및 집계합니다. 쿼리 세그먼트 및 단계에 대한 자세한 내용은 [쿼리 계획 및 실행 워크플로우](c-query-planning.md) 섹션을 참조하세요. 노드 조각에서 합산되는 지표도 `max_rows`, `cpu_time` 등 매우 많습니다. 노드 조각에 대한 자세한 내용은 [데이터 웨어하우스 시스템 아키텍처](c_high_level_system_architecture.md) 섹션을 참조하세요.
행이 지표를 보고하는 수준을 확인하고 싶으면 다음과 같이 `segment` 열과 `step_type` 열을 살펴보십시오.
+ `segment` 열과 `step_type` 열의 값이 모두 `-1`이면 행이 쿼리 수준에서 지표를 보고합니다.
+ `segment` 열이 `-1`이 아니고, `step_type` 열이 `-1`이면 행이 세그먼트 수준에서 지표를 보고합니다.
+ `segment` 열과 `step_type` 열의 값이 모두 `-1`이 아니면 행이 단계 수준에서 지표를 보고합니다.
STV\$1QUERY\$1METRICS는 모든 사용자에게 표시됩니다. 수퍼유저는 모든 행을 볼 수 있지만 일반 사용자는 자체 데이터만 볼 수 있습니다. 자세한 내용은 [시스템 테이블 및 뷰에 있는 데이터의 가시성](cm_chap_system-tables.md#c_visibility-of-data) 섹션을 참조하세요.
이 테이블의 데이터 중 일부 또는 전부는 SYS 모니터링 뷰인 [SYS\$1QUERY\$1DETAIL](SYS_QUERY_DETAIL.md)에서도 찾아볼 수 있습니다. SYS 모니터링 뷰의 데이터는 사용 및 이해가 더 쉽도록 형식이 지정되어 있습니다. 쿼리에 SYS 모니터링 뷰를 사용하는 것이 좋습니다.
## 테이블 열
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/dg/r_STV_QUERY_METRICS.html)
## 단계 유형
다음 표는 데이터베이스 사용자와 관련된 단계 유형을 나열한 것입니다. 내부 전용 단계 유형은 표에서 제외되었습니다. 단계 유형이 -1이면 단계 수준에서는 지표가 보고되지 않습니다.
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/dg/r_STV_QUERY_METRICS.html)
## 샘플 쿼리
CPU 시간이 높은(1,000초 이상) 활성 쿼리를 찾으려면 다음과 같이 쿼리를 실행합니다.
```
select query, cpu_time / 1000000 as cpu_seconds
from stv_query_metrics where segment = -1 and cpu_time > 1000000000
order by cpu_time;
query | cpu_seconds
------+------------
25775 | 9540
```
중첩 루프 조인을 사용하여 반환된 행의 수가 100만 개가 넘는 활성 쿼리를 찾으려면 다음과 같이 쿼리를 실행합니다.
```
select query, rows
from stv_query_metrics
where step_type = 15 and rows > 1000000
order by rows;
query | rows
------+-----------
25775 | 1580225854
```
실행 시간이 60초보다 크고, CPU 시간이 10초 미만인 활성 쿼리를 찾으려면 다음과 같이 쿼리를 실행하세요.
```
select query, run_time/1000000 as run_time_seconds
from stv_query_metrics
where segment = -1 and run_time > 60000000 and cpu_time < 10000000;
query | run_time_seconds
------+-----------------
25775 | 114
```