

# 성능 개선 도우미 대시보드에서 더 많은 SQL 텍스트에 액세스
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

기본적으로 **상위 SQL(Top SQL)** 테이블의 각 행에는 각 SQL 문에 대해 500바이트의 SQL 텍스트가 표시됩니다.

![\[500바이트의 SQL\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


SQL 문이 500바이트를 초과하면 **상위 SQL** 테이블 아래의 **SQL 텍스트** 섹션에서 더 많은 텍스트를 볼 수 있습니다. 이 경우 **SQL 텍스트**에 표시된 쿼리의 최대 길이는 4KB입니다. 이 제한은 콘솔에 의해 도입되며 데이터베이스 엔진에서 설정한 제한에 따라 달라집니다. **SQL 텍스트**에 표시된 텍스트를 저장하려면 **다운로드**를 선택합니다.

**Topics**
+ [Amazon RDS 엔진 텍스트 크기 제한](#sql-text-engine-limits)
+ [Amazon RDS for PostgreSQL DB 인스턴스에 대한 SQL 텍스트 한도 설정](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [성능 개선 도우미 대시보드에서 SQL 텍스트 보기 및 다운로드](view-download-text.md)

## Amazon RDS 엔진 텍스트 크기 제한
<a name="sql-text-engine-limits"></a>

SQL 텍스트를 다운로드할 때 데이터베이스 엔진은 최대 길이를 결정합니다. 다음의 엔진별 제한에 해당하는 SQL 텍스트를 다운로드할 수 있습니다.


| DB 엔진 | 다운로드한 텍스트의 최대 길이 | 
| --- | --- | 
| Amazon RDS for MySQL 및 MariaDB | 성능 스키마가 활성화된 경우 길이는 4,096바이트로 고정됩니다. 성능 스키마가 활성화되지 않은 경우 길이는 65,535바이트로 고정됩니다. | 
| Amazon RDS for Microsoft SQL Server | 4,096자 | 
| Amazon RDS for Oracle | 1,000바이트 | 

성능 개선 도우미 콘솔의 **SQL 텍스트** 섹션은 엔진이 반환하는 최대값까지 표시합니다. 예들 들어, MySQL은 최대 1KB를 성능 개선 도우미에 반환하며, 원래 쿼리가 더 큰 경우에도 1KB만 수집하고 표시할 수 있습니다. 따라서 **SQL 텍스트**의 쿼리를 보거나 다운로드하면 성능 개선 도우미가 동일한 바이트 수를 반환합니다.

AWS CLI 또는 API, 성능 개선 도우미에는 콘솔이 적용하는 4KB 제한이 없으며, `DescribeDimensionKeys` 및 `GetResourceMetrics`로 최대 500바이트를 반환합니다.

**참고**  
`GetDimensionKeyDetails`는 전체 쿼리를 반환하지만 크기에는 엔진 제한이 적용됩니다.

# Amazon RDS for PostgreSQL DB 인스턴스에 대한 SQL 텍스트 한도 설정
<a name="USER_PerfInsights.UsingDashboard.SQLTextLimit"></a>

Amazon RDS for PostgreSQL은 텍스트를 다르게 처리합니다. DB 인스턴스 파라미터 `track_activity_query_size`를 사용하여 텍스트 크기 제한을 설정할 수 있습니다. 이 파라미터에는 다음과 같은 특성이 있습니다.

기본 텍스트 크기  
Amazon RDS for PostgreSQL 버전 9.6에서 `track_activity_query_size` 파라미터에 대한 기본 설정은 1,024바이트입니다. Amazon RDS for PostgreSQL 버전 10이상에서 기본 설정은 4,096바이트입니다.

최대 텍스트 크기  
Amazon RDS for PostgreSQL 버전 12 이하에 대한 `track_activity_query_size` 제한은 102,400바이트입니다. 버전 13 이상에서는 최대 1MB입니다.  
엔진이 성능 개선 도우미에 1MB를 반환하면 콘솔에는 처음 4KB만 표시됩니다. 쿼리를 다운로드하면 전체 1MB를 받을 수 있습니다. 이 경우 보기 및 다운로드하면 다른 바이트 수가 반환됩니다. `track_activity_query_size` DB 파라미터에 대한 자세한 내용은 PostgreSQL 설명서에서 [런타임 통계](https://www.postgresql.org/docs/current/runtime-config-statistics.html)를 참조하세요.

SQL 텍스트 크기를 늘리려면 `track_activity_query_size` 제한을 늘립니다. 파라미터를 수정하려면 Amazon RDS for PostgreSQL DB 인스턴스와 연결된 파라미터 그룹에서 파라미터 설정을 변경하세요.

**인스턴스가 기본 파라미터 그룹을 사용할 때 설정 변경**

1. 적절한 DB 엔진 및 DB 엔진 버전에 대해 새로운 DB 인스턴스 파라미터 그룹을 생성합니다.

1. 새 파라미터 그룹에 파라미터를 설정합니다.

1. 새 파라미터 그룹을 DB 인스턴스에 연결합니다.

DB 인스턴스 파라미터 설정에 대한 자세한 내용은 [Amazon RDS에서 DB 파라미터 그룹의 파라미터 수정](USER_WorkingWithParamGroups.Modifying.md) 단원을 참조하세요.

# 성능 개선 도우미 대시보드에서 SQL 텍스트 보기 및 다운로드
<a name="view-download-text"></a>

성능 개선 도우미 대시보드에서 SQL 텍스트를 보기 및 다운로드할 수 있습니다.

**성능 개선 도우미 대시보드에서 더 많은 SQL 텍스트를 보려면**

1. [https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)에서 Amazon RDS 콘솔을 엽니다.

1. 탐색 창에서 **성능 개선 도우미**을 선택합니다.

1. DB 인스턴스를 선택합니다.

1. 성능 개선 도우미 대시보드에서 아래로 스크롤하여 **상위 SQL** 탭으로 이동합니다.

1. 더하기(\$1) 기호를 선택하여 SQL 다이제스트를 펼치고 다이제스트의 하위 쿼리 중 하나를 선택합니다.

   500바이트 이상의 텍스트가 있는 SQL 문은 다음 이미지와 유사합니다.  
![\[라지 텍스트가 포함된 SQL 문\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. **SQL 텍스트** 탭까지 아래로 스크롤합니다.  
![\[SQL 정보 섹션에는 더 많은 SQL 텍스트가 표시됩니다.\]](http://docs.aws.amazon.com/ko_kr/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   성능 개선 도우미 대시보드는 각 SQL 문에 최대 4,096바이트를 표시할 수 있습니다.

1. (선택 사항) **복사**를 선택하여 표시된 SQL 문을 복사하거나 **다운로드**를 선택하여 최대 DB 엔진 한도까지 SQL 텍스트를 볼 수 있는 SQL 문을 다운로드합니다.
**참고**  
SQL 문을 복사하거나 다운로드하려면 팝업 차단 기능을 비활성화하세요.