# 在 Performance Insights 控制面板中访问更多 SQL 文本
访问更多 SQL 文本

预设情况下，**Top SQL**（主要 SQL）表中的每行为每个 SQL 语句显示 500 字节的 SQL 文本。

![\[500 字节的 SQL\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/perf-insights-top-sql-bytes.png)


当 SQL 语句超过 500 字节时，您可以在 **Top SQL**（主要 SQL）表下的 **SQL text**（SQL 文本）部分中查看更多文本。在这种情况下，**SQL text**（SQL 文本）中显示的文本的最大长度为 4KB。此限制由控制台引入，并受数据库引擎设置的限制的约束。要保存 **SQL text**（SQL 文本）中显示的文本，请选择 **Download**（下载）。

**Topics**
+ [

## Amazon RDS 引擎 的文本大小限制
](#sql-text-engine-limits)
+ [

# 为 Amazon RDS for PostgreSQL 数据库实例设置 SQL 文本限制
](USER_PerfInsights.UsingDashboard.SQLTextLimit.md)
+ [

# 在 Performance Insights 控制面板中查看和下载 SQL 文本
](view-download-text.md)

## Amazon RDS 引擎 的文本大小限制


下载 SQL 文本时，数据库引擎将确定文本的最大长度。您可以下载最多为以下每个引擎限制的 SQL 文本。


| 数据库引擎 | 已下载文本的最大长度 | 
| --- | --- | 
| Amazon RDS for MySQL 和 MariaDB | 当启用性能架构时，长度固定为 4096 字节。如果未启用性能架构，则长度固定为 65535 字节。 | 
| Amazon RDS for Microsoft SQL Server | 4,096 个字符 | 
| Amazon RDS for Oracle | 1,000 字节 | 

性能详情控制台的 **SQL text**（SQL 文本）部分最多显示引擎返回的最大长度的文本。例如，如果 MySQL 最多返回 1 KB 到 Performance Insights，则只能收集并显示 1 KB，即使原始查询较大。因此，当您在 **SQL text**（SQL 文本）中查看查询或下载查询时，性能详情将返回相同的字节数。

如果您使用 Amazon CLI 或 API，则性能详情没有控制台强制实施的 4KB 限制。`DescribeDimensionKeys` 和 `GetResourceMetrics` 返回最多 500 字节。

**注意**  
`GetDimensionKeyDetails` 将返回完整的查询，但大小受引擎限制约束。

# 为 Amazon RDS for PostgreSQL 数据库实例设置 SQL 文本限制
设置 SQL 文本限制

Amazon RDS for PostgreSQL 以不同的方式处理文本。您可以使用数据库实例参数 `track_activity_query_size` 设置文本大小限制。该参数具有以下特征：

默认文本大小  
在 Amazon RDS for PostgreSQL 版本 9.6 中，`track_activity_query_size` 参数的默认设置为 1024 字节。在 Amazon RDS for PostgreSQL 版本 10 或更高版本中，默认值为 4096 字节。

最大文本大小  
对于 Amazon RDS for PostgreSQL 版本 12 及更低版本，`track_activity_query_size` 的限制为 102400 字节。版本 13 及更高版本的最大值为 1 MB。  
如果引擎返回 1 MB 至 Performance Insights，则控制台仅显示前 4 KB。如果您下载查询，您将得到完整的 1 MB。在这种情况下，查看和下载返回不同的字节数。有关 `track_activity_query_size` 数据库实例参数的更多信息，请参阅 PostgreSQL 文档中的[运行时统计数据](https://www.postgresql.org/docs/current/runtime-config-statistics.html)。

要增加 SQL 文本大小，请增加 `track_activity_query_size` 限制。要修改参数，请更改与 Amazon RDS for PostgreSQL 数据库实例关联的参数组中的参数设置。

**在实例使用默认参数组时更改设置**

1. 为相应数据库引擎和数据库引擎版本创建新的数据库实例参数组。

1. 在新参数组中设置参数。

1. 将新参数组与数据库实例相关联。

有关设置数据库实例参数的信息，请参阅 [在 Amazon RDS 中修改数据库参数组中的参数](USER_WorkingWithParamGroups.Modifying.md)。

# 在 Performance Insights 控制面板中查看和下载 SQL 文本
查看和下载 SQL 文本

在 Performance Insights 控制面板中，您可以查看或下载 SQL 文本。

**在 Performance Insights 控制面板中查看更多 SQL 文本**

1. 通过以下网址打开 Amazon RDS 控制台：[https://console.aws.amazon.com/rds/](https://console.amazonaws.cn/rds/)。

1. 在导航窗格中，选择 **Performance Insights**。

1. 选择一个数据库实例。

1. 在性能详情控制面板中向下滚动到**主要 SQL** 选项卡。

1. 选择加号来展开 SQL 摘要，然后选择该摘要的子查询之一。

   具有大于 500 字节的文本的 SQL 语句如下图所示。  
![\[具有大文本的 SQL 语句\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-1.png)

1. 向下滚动至 **SQL text**（SQL 文本）选项卡。  
![\[SQL 信息部分显示更多 SQL 文本\]](http://docs.amazonaws.cn/AmazonRDS/latest/UserGuide/images/perf-insights-large-text-2.png)

   Performance Insights 控制面板可以为每个 SQL 语句最多显示 4096 字节。

1. （可选）选择**复制**来复制所显示的 SQL 语句，或选择**下载**来下载 SQL 语句以查看不超过数据库引擎限制的 SQL 文本。
**注意**  
要复制或下载 SQL 语句，请禁用弹出窗口阻止程序。