aurora_stat_plans

Devuelve una fila por cada plan de ejecución rastreado.

Sintaxis

aurora_stat_plans(
    showtext
)

Argumentos

• showtext: muestra el texto de la consulta y del plan. Los valores válidos son NULL, true y false. True mostrará el texto de la consulta y del plan.

Tipo de retorno

Devuelve una fila para cada plan rastreado que contiene todas las columnas de aurora_stat_statements y las siguientes columnas adicionales.

• planid: identificador del plan

• explain_plan: explica el texto del plan

• plan_type:

  • no plan - no se capturó ningún plan

  • estimate - plan capturado con costos estimados

  • actual - plan capturado con EXPLAIN ANALYZE

• plan_captured_time: última vez que se capturó un plan

Notas de uso

aurora_compute_plan_id debe estar activado y pg_stat_statements debe ser shared_preload_libraries para que se realice un seguimiento de los planes.

El número de planes disponibles se controla mediante el valor establecido en el parámetro pg_stat_statements.max. Cuando compute_plan_id está habilitado, puede realizar un seguimiento de los planes hasta el valor especificado en aurora_stat_plans.

Esta función está disponible desde Aurora PostgreSQL versiones 14.10, 15.5, y para todas las demás versiones posteriores.

Ejemplos

En el ejemplo siguiente, se capturan los dos planes que corresponden al identificador de consulta -5471422286312252535 y el planid rastrea las estadísticas de los estados.

db1=# select calls, total_exec_time, planid, plan_captured_time, explain_plan
db1-# from aurora_stat_plans(true)
db1-# where queryid = '-5471422286312252535'   

calls    |  total_exec_time   |   planid    |      plan_captured_time       |                           explain_plan                           
---------+--------------------+-------------+-------------------------------+------------------------------------------------------------------
 1532632 |  3209846.097107853 |  1602979607 | 2023-10-31 03:27:16.925497+00 | Update on pgbench_branches                                      +
         |                    |             |                               |   ->  Bitmap Heap Scan on pgbench_branches                      +
         |                    |             |                               |         Recheck Cond: (bid = 76)                                +
         |                    |             |                               |         ->  Bitmap Index Scan on pgbench_branches_pkey          +
         |                    |             |                               |               Index Cond: (bid = 76)
   61365 | 124078.18012200127 | -2054628807 | 2023-10-31 03:20:09.85429+00  | Update on pgbench_branches                                      +
         |                    |             |                               |   ->  Index Scan using pgbench_branches_pkey on pgbench_branches+
         |                    |             |                               |         Index Cond: (bid = 17)