

# Performance Insights ダッシュボードでより多くの SQL テキストにアクセスする
<a name="USER_PerfInsights.UsingDashboard.SQLTextSize"></a>

デフォルトでは、[**トップ SQL**] テーブルの各行には SQL ステートメントごとに 500 バイトの SQL テキストが表示されます。

![\[500 バイトの SQL\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


SQL ステートメントのサイズが 500 バイトを超える場合、**[Top SQL]** (トップ SQL) テーブルの **[SQL text]** (SQL テキスト) セクションでテキストの表示量を増やすことができます。この場合、**[SQL text]** (SQL テキスト) に表示されるテキストの最大長は 4 KB です。コンソールで導入されるこの制限には、データベースエンジンによって設定された制限が適用されます。**[SQL text]** (SQL テキスト) に表示されているテキストを保存するには、**[Download]** (ダウンロード) を選択します。

**Topics**
+ [Amazon RDS エンジン のテキストサイズの制限](#sql-text-engine-limits)
+ [Amazon RDS for PostgreSQL DB インスタンスの SQL テキスト制限の設定](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [Performance Insights ダッシュボードでの SQL テキストの表示とダウンロード](view-download-text.md)

## Amazon RDS エンジン のテキストサイズの制限
<a name="sql-text-engine-limits"></a>

SQL テキストをダウンロードするときに、データベースエンジンがテキストの最大長を決定します。エンジンごとのダウンロードできる SQL テキストの上限は次のとおりです。


| DB エンジン | ダウンロードされるテキストの最大長 | 
| --- | --- | 
| Amazon RDS for MySQL および MariaDB | Performance Schema が有効になっている場合、長さは 4,096 バイトに固定されます。Performance Schema が有効になっていない場合、長さは 65,535 バイトに固定されます。 | 
| Amazon RDS for Microsoft SQL Server | 4,096 文字 | 
| 「Amazon RDS for Oracle」 | 1,000 バイト | 

Performance Insights コンソールの **[SQL text]** (SQL テキスト) では、エンジンが返すテキストが最大値まで表示できます。例えば、 MySQL は、Performance Insights に対して最大 1 KB を返します。元のクエリが大きい場合でも、収集して表示できるのは 1 KB のみです。したがって、**[SQL text]** (SQL テキスト) でクエリを表示するか、ダウンロードすると、Performance Insights は同じバイト数を返します。

AWS CLI または API を使用する場合、Performance Insights には、コンソールで適用される 4 KB の制限がありません。`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 以降の場合、最大値は 1 MB です。  
エンジンが Performance Insights に対して 1 MB を返す場合、コンソールでは最初の 4 KB のみが表示されます。クエリをダウンロードする場合、1 MB すべてを取得できます。この場合、表示する場合とダウンロードする場合では異なるバイト数が返されます。`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)」を参照してください。

# Performance Insights ダッシュボードでの SQL テキストの表示とダウンロード
<a name="view-download-text"></a>

Performance Insights ダッシュボードで、SQL テキストを表示およびダウンロードできます。

**Performance Insights ダッシュボードで SQL テキストの表示量を増やすには**

1. Amazon RDS コンソール ([https://console.aws.amazon.com/rds/](https://console.aws.amazon.com/rds/)) を開きます。

1. ナビゲーションペインで、[**Performance Insights**] を選択します。

1. DB インスタンスを選択します。

1. Performance Insights ダッシュボードの **[トップ SQL]** タブまでスクロールします。

1. プラス記号を選択して SQL ダイジェストを展開し、ダイジェストの子クエリのいずれかを選択します。

   500 バイトを超える SQL ステートメントは、次のイメージのように表示されます。  
![\[テキストサイズが大きい SQL ステートメント\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. 下部にある [**SQL テキスト**] タブまでスクロールします。  
![\[SQL 情報セクションに SQL テキストがさらに表示される\]](http://docs.aws.amazon.com/ja_jp/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   Performance Insights ダッシュボードは、各 SQL ステートメントの最大 4,096 バイトまでを表示できます。

1. (オプション) [**コピー**] を選択して、表示された SQL ステートメントをコピーするか、[**ダウンロード**] を選択して、DB エンジンに応じた最大サイズの SQL ステートメントをダウンロードします。
**注記**  
SQL ステートメントをコピーまたはダウンロードするには、ポップアップブロッカーを無効にします。