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 ストレージからのデータファイルブロックの読み取りにかかった合計時間をミリ秒単位で追跡します。それ以外の場合、値はゼロです。詳細については、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 を参照してください。

使用に関する注意事項

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

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

  • 15.4 以降の 15 バージョン

  • 14.9 以降の 14 バージョン

例

次の例は、すべての pg_stat_statements 列を保持し、末尾に新しい列を 5 つ追加する方法を示しています。

=> select * from aurora_stat_statements(true) where queryid=-7342090857217643794;    
-[ RECORD 1 ]---------+--------------------------------------------------
userid                | 10
dbid                  | 16419
toplevel              | t
queryid               | -7342090857217643794
query                 | CREATE TABLE quad_point_tbl AS                   +
                      |     SELECT point(unique1,unique2) AS p FROM tenk1
plans                 | 0
total_plan_time       | 0
min_plan_time         | 0
max_plan_time         | 0
mean_plan_time        | 0
stddev_plan_time      | 0
calls                 | 1
total_exec_time       | 571.844376
min_exec_time         | 571.844376
max_exec_time         | 571.844376
mean_exec_time        | 571.844376
stddev_exec_time      | 0
rows                  | 10000
shared_blks_hit       | 462
shared_blks_read      | 422
shared_blks_dirtied   | 0
shared_blks_written   | 55
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         | 170.634621
blk_write_time        | 0
wal_records           | 0
wal_fpi               | 0
wal_bytes             | 0
storage_blks_read     | 47
orcache_blks_hit      | 375
storage_blk_read_time | 124.505772
local_blk_read_time   | 0
orcache_blk_read_time | 44.684038