

# aurora\$1stat\$1statements
<a name="aurora_stat_statements"></a>

显示所有 `pg_stat_statements` 列并在最后添加更多列。

## 语法
<a name="aurora_stat_statements-syntax"></a>

 

```
aurora_stat_statements(showtext boolean)
```

## 参数
<a name="aurora_stat_statements-arguments"></a>

*showtext boolean*

## 返回类型
<a name="aurora_stat_statements-return-type"></a>

包含所有 `pg_stat_statements` 列和以下附加列的 SETOF 记录。有关 `pg_stat_statements` 列的更多信息，请参阅 [https://www.postgresql.org/docs/current/pgstatstatements.html](https://www.postgresql.org/docs/current/pgstatstatements.html)。

您可以使用 `pg_stat_statements_reset()` 重置此函数的统计信息。
+ `storage_blks_read` – 从该语句的 aurora 存储中读取的共享块总数。
+ `orcache_blks_hit` – 此语句中优化型读取缓存命中总数。
+ `storage_blk_read_time` – 如果已启用 `track_io_timing`，它将跟踪语句从 aurora 存储中读取共享块所花费的总时间（以毫秒为单位），否则该值为零。有关更多信息，请参阅 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `local_blk_read_time` – 如果已启用 `track_io_timing`，它将跟踪语句读取本地块所花费的总时间（以毫秒为单位），否则该值为零。有关更多信息，请参阅 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `orcache_blk_read_time` – 如果已启用 `track_io_timing`，它将跟踪语句从优化型读取缓存中读取共享块所花费的总时间（以毫秒为单位），否则该值为零。有关更多信息，请参阅 [track\$1io\$1timing](https://www.postgresql.org/docs/current/runtime-config-statistics.html#GUC-TRACK-IO-TIMING)。
+ `total_plan_peakmem` – 对此语句的所有调用在计划阶段的峰值内存值的总和。要查看语句在计划期间的平均峰值内存，请将该值除以调用数。
+ `min_plan_peakmem` – 在计划期间，在对此语句的所有调用中看到的最小峰值内存值。
+ `max_plan_peakmem` – 在计划期间，在对此语句的所有调用中看到的最大峰值内存值。
+ `total_exec_peakmem` – 对此语句的所有调用在执行阶段的峰值内存值的总和。要查看语句在执行期间的平均峰值内存，请将该值除以调用数。
+ `min_exec_peakmem` – 在对此语句的所有调用的执行期间，出现的最小峰值内存值，以字节为单位。
+ `max_exec_peakmem` – 在对此语句的所有调用的执行期间，出现的最大峰值内存值，以字节为单位。

**注意**  
仅当设置 `pg_stat_statements.track_planning` 为开启时，`total_plan_peakmen`、`min_plan_peakmem` 和 `max_plan_peakmem` 才会受到监控。

## 使用说明
<a name="aurora_stat_statements-usage-notes"></a>

要使用 aurora\$1stat\$1statements() 函数，必须在 `shared_preload_libraries` 参数中包含 `pg_stat_statements` 扩展。

此函数可用于以下 Aurora PostgreSQL 版本：
+ 15.4 及更高的 15 版本
+ 14.9 及更高的 14 版本

以下版本中提供了显示峰值内存的列：
+ 16.3 及更高版本
+ 15.7 及更高版本
+ 14.12 及更高版本

## 示例
<a name="aurora_stat_statements-examples"></a>

以下示例显示了它如何携带所有 pg\$1stat\$1statements 列并在最后附加 11 个新列：

```
=> select * from aurora_stat_statements(true) where query like 'with window_max%';
-[ RECORD 1 ]----------+------------------------------------------------------------------------------------------------
userid                 | 16409
dbid                   | 5
toplevel               | t
queryid                | -8347523682669847482
query                  | with window_max as (select custid, max(scratch) over (order by scratch rows between $1 preceding 
and $2 following) wmax from ts) select sum(wmax), max(custid) from window_max
plans                  | 0
total_plan_time        | 0
min_plan_time          | 0
max_plan_time          | 0
mean_plan_time         | 0
stddev_plan_time       | 0
calls                  | 4
total_exec_time        | 254.105121
min_exec_time          | 57.503164000000005
max_exec_time          | 68.687418
mean_exec_time         | 63.52628025
stddev_exec_time       | 5.150765359979643
rows                   | 4
shared_blks_hit        | 200192
shared_blks_read       | 0
shared_blks_dirtied    | 0
shared_blks_written    | 0
local_blks_hit         | 0
local_blks_read        | 0
local_blks_dirtied     | 0
local_blks_written     | 0
temp_blks_read         | 0
temp_blks_written      | 0
blk_read_time          | 0
blk_write_time         | 0
temp_blk_read_time     | 0
temp_blk_write_time    | 0
wal_records            | 0
wal_fpi                | 0
wal_bytes              | 0
jit_functions          | 0
jit_generation_time    | 0
jit_inlining_count     | 0
jit_inlining_time      | 0
jit_optimization_count | 0
jit_optimization_time  | 0
jit_emission_count     | 0
jit_emission_time      | 0
storage_blks_read      | 0
orcache_blks_hit       | 0
storage_blk_read_time  | 0
local_blk_read_time    | 0
orcache_blk_read_time  | 0
total_plan_peakmem     | 0
min_plan_peakmem       | 0
max_plan_peakmem       | 0
total_exec_peakmem     | 6356224
min_exec_peakmem       | 1589056
max_exec_peakmem       | 1589056
```