

 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/)을 참조하세요.

# 쿼리 기록 데이터 보기
<a name="performance-metrics-query-history"></a>

Amazon Redshift의 쿼리 기록 지표를 사용하여 다음을 수행할 수 있습니다.
+ 쿼리 성능 문제를 격리하고 진단합니다.
+ 동일한 타임라인에서 쿼리 실행 시간 지표와 클러스터 성능 지표를 비교하여 두 지표가 어떻게 관련되는지 확인합니다. 그러면 속도가 느린 쿼리를 식별하거나, 병목 현상 쿼리를 발견하거나, 워크로드 클러스터의 크기의 조정 필요성을 결정하는 데 도움이 됩니다.
+ 타임라인에서 선택하여 특정 쿼리의 세부 정보로 드릴다운합니다. **쿼리 ID** 및 기타 속성이 그래프 아래의 행에 표시되면 쿼리를 선택하여 쿼리 세부 정보를 볼 수 있습니다. 세부 정보에는 쿼리의 SQL 문, 실행 세부 정보 및 쿼리 계획 등이 포함됩니다. 자세한 내용은 [쿼리 세부 정보 보기 및 분석](performance-metrics-query-execution-details.md) 섹션을 참조하세요.
+ 로드 작업이 성공적으로 완료되고 SLA(서비스 수준 계약)를 충족하는지 확인합니다.

**쿼리 기록 데이터를 표시하려면**

1. AWS Management Console에 로그인한 후 [https://console.aws.amazon.com/redshiftv2/](https://console.aws.amazon.com/redshiftv2/)에서 Amazon Redshift 콘솔을 엽니다.

1. 탐색 메뉴에서 **클러스터(Clusters)**를 선택한 후 목록에서 클러스터 이름을 선택하여 세부 정보를 엽니다. 클러스터의 세부 정보가 표시됩니다. 여기에는 **클러스터 성능**, **쿼리 모니터링**, **데이터베이스**, **데이터 공유**, **일정**, **유지 관리** 및 **속성** 탭이 포함될 수 있습니다.

1. 쿼리에 대한 지표를 보려면 **Query monitoring(쿼리 모니터링)** 탭을 선택합니다.

1. **쿼리 모니터링** 섹션에서 **쿼리 기록** 탭을 선택합니다.

   창의 컨트롤을 사용하여 **쿼리 목록**과 **클러스터 지표** 간에 전환할 수 있습니다.

   **쿼리 목록**을 선택하면 탭에 다음과 같은 그래프가 포함됩니다.
   + [**쿼리 실행 시간(Query runtime)**] – 타임라인의 쿼리 활동입니다. 이 그래프를 사용하여 동일한 기간에 실행 중인 쿼리를 확인합니다. 쿼리를 선택하여 더 많은 쿼리 실행 세부 정보를 확인합니다. X축에는 선택한 기간이 표시됩니다. 그래프로 된 쿼리를 실행 중, 완료됨, 로드 등을 기준으로 필터링할 수 있습니다. 각 막대는 쿼리를 나타내고 막대의 길이는 막대의 시작부터 끝까지 실행 시간을 나타냅니다. 쿼리에는 SQL 데이터 조작 문(예: SELECT, INSERT, DELETE)과 로드(예: COPY)가 포함될 수 있습니다. 기본적으로 가장 긴 실행 쿼리 100개가 선택한 기간 동안 표시됩니다.
   + [**쿼리 및 로드(Queries and loads)**] – 클러스터에서 실행된 쿼리 및 로드 목록입니다. 이 창에는 쿼리가 현재 실행 중인 경우 **쿼리를 종료하는** 옵션이 포함되어 있습니다.

   **클러스터 지표**를 선택하면 이 탭에는 다음 그래프가 포함됩니다.
   + [**쿼리 실행 시간(Query runtime)**] – 타임라인의 쿼리 활동입니다. 이 그래프를 사용하여 동일한 기간에 실행 중인 쿼리를 확인합니다. 쿼리를 선택하여 더 많은 쿼리 실행 세부 정보를 확인합니다.
   + [**CPU 사용률(CPU utilization)**] – 리더 노드별 클러스터의 CPU 사용률 및 계산 노드의 평균입니다.
   + [**사용된 스토리지 용량(Storage capacity used)**] – 사용된 스토리지 용량의 백분율입니다.
   + [**활성 데이터베이스 연결(Active database connections)**] – 클러스터에 대한 활성 데이터베이스 연결 수입니다.

쿼리 기록 그래프로 작업할 때는 다음 사항을 고려하십시오.
+ **쿼리 실행 시간** 차트에서 특정 쿼리를 나타내는 막대를 선택하여 해당 쿼리에 대한 세부 정보를 확인합니다. **쿼리 및 로드** 목록에서 쿼리 ID를 선택하여 세부 정보를 확인할 수도 있습니다.
+ 스와이프하여 **쿼리 실행 시간** 차트의 섹션을 선택하여 특정 기간을 표시하도록 확대할 수 있습니다.
+ **쿼리 실행 시간** 차트에서 선택한 필터로 모든 데이터를 고려하려면 **쿼리 및 로드** 목록에 나열된 모든 페이지를 앞으로 이동합니다.
+ **설정 기어 아이콘**으로 표시되는 기본 설정 창을 사용하여 [**쿼리 및 로드(Queries and loads)**] 목록에 표시되는 열과 행 수를 변경할 수 있습니다.
+ **쿼리 및 로드** 목록은 왼쪽 탐색기의 **쿼리** 아이콘, **쿼리 및 로드**를 탐색하여 표시할 수도 있습니다. 자세한 내용은 [쿼리 및 로드 보기](performance-metrics-queries.md) 섹션을 참조하세요.

## 쿼리 기록 그래프
<a name="performance-metrics-query-history-examples"></a>

다음은 새 Amazon Redshift 콘솔에 표시되는 그래프의 예입니다.

**참고**  
Amazon Redshift 콘솔 그래프에는 최신 100,000개의 쿼리에 대한 데이터만 포함됩니다.
+ **쿼리 실행 시간**   
![\[같은 시간대에 어떤 쿼리가 실행되고 있는지 타임라인에 쿼리 활동을 표시하는 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/query-history-query-runtime.png)
+ **쿼리 및 로드**   
![\[시작 시간, 기간, 상태, 쿼리 ID 등의 속성을 열로 하여 쿼리 및 로드 목록을 표시하는 테이블입니다.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/query-history-queries-and-loads.png)
+ **CPU 사용률**   
![\[15분 단위로 CPU 사용률을 보여주는 선 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/query-history-cpu-utilization.png)
+ **사용된 스토리지 용량**   
![\[15분 단위로 사용된 스토리지 용량의 백분율을 보여주는 선 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/query-history-storage-capacity-used.png)
+ **활성 데이터베이스 연결**   
![\[15분 단위로 활성 데이터베이스 연결 수를 보여주는 선 그래프입니다.\]](http://docs.aws.amazon.com/ko_kr/redshift/latest/mgmt/images/query-history-active-database-connections.png)