aurora_stat_statements - Amazon Aurora
構文引数戻り型使用に関する注意事項例

aurora_stat_statements

すべての pg_stat_statements 列を表示し、最後にさらに列を追加します。

構文

aurora_stat_statements(showtext boolean)

引数

showtext boolean

戻り型

すべての pg_stat_statements 列と以下の追加列を含む SETOF レコード。pg_stat_statements 列の詳細については、「pg_stat_statements」を参照してください。

この関数の統計情報は pg_stat_statements_reset() を使用してリセットできます。

  • storage_blks_read - このステートメントによって Aurora ストレージから読み取られた共有ブロックの総数。

  • orcache_blks_hit - このステートメントによる Optimized Reads キャッシュヒットの総数。

  • storage_blk_read_time - track_io_timing を有効にすると、ステートメントが Aurora ストレージからの共有ブロックの読み取りにかかった合計時間をミリ秒単位で追跡します。それ以外の場合、値は 0 です。詳細については、track_io_timing を参照してください。

  • local_blk_read_time - track_io_timing を有効にすると、ステートメントがローカルブロックの読み取りにかかった合計時間をミリ秒単位で追跡します。それ以外の場合、値は 0 です。詳細については、track_io_timing を参照してください。

  • orcache_blk_read_time - track_io_timing を有効にすると、ステートメントが Optimized Reads キャッシュから共有ブロックを読み取るのにかかった合計時間をミリ秒単位で追跡します。それ以外の場合は 0 です。詳細については、track_io_timing を参照してください。

  • total_plan_peakmem - このステートメントへのすべての呼び出しの計画フェーズ中のピークメモリ値の合計。ステートメント計画中の平均ピークメモリを表示するには、この値を呼び出し回数で割ります。

  • min_plan_peakmem – このステートメントへのすべての呼び出しの計画中に検出された最小のピークメモリ値。

  • max_plan_peakmem – このステートメントへのすべての呼び出しで検出された、計画中の最大のピークメモリ値。

  • total_exec_peakmem - このステートメントへのすべての呼び出しに対する実行フェーズ中のピークメモリ値の合計。ステートメント実行中の平均ピークメモリを表示するには、この値を呼び出し回数で割ります。

  • min_exec_peakmem – このステートメントへのすべての呼び出しで実行中に検出された最小のピークメモリ値。

  • max_exec_peakmem – このステートメントへのすべての呼び出しで実行中に検出された最大のピークメモリ値。

注記

total_plan_peakmen、min_plan_peakmem、および max_plan_peakmem は、設定 pg_stat_statements.track_planning がオンになっている場合にのみモニタリングされます。

使用に関する注意事項

aurora_stat_statements() 関数を使用するには、shared_preload_libraries パラメータに pg_stat_statements 拡張子を含める必要があります。

この関数は、次の Aurora PostgreSQL バージョンで使用できます。

  • 15.4 以降の 15 バージョン

  • 14.9 以降の 14 バージョン

ピークメモリを表示する列は、次のバージョンから使用できます。

  • 16.3 以降のバージョン

  • 15.7 以降のバージョン

  • 14.12 以降のバージョン

例

次の例は、すべての pg_stat_statements 列を保持し、末尾に新しい列を 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