# aurora\_stat\_plans
<a name="aurora_stat_plans"></a>

Exibe uma linha para cada plano de execução monitorado. 

## Sintaxe
<a name="aurora_stat_plans-syntax"></a>

 

```
aurora_stat_plans(
    showtext
)
```

## Argumentos
<a name="aurora_stat_plans-arguments"></a>
+ showtext: mostra a consulta e o texto do plano. Os valores válidos são NULL, true ou false. True mostrará a consulta e o texto do plano.

## Tipo de retorno
<a name="aurora_stat_plans-return-type"></a>

Exibe uma linha para cada plano monitorado que contém todas as colunas de `aurora_stat_statements` e as colunas adicionais a seguir.
+ planid: identificador do plano.
+ explain\_plan: explica o texto do plano.
+ plan\_type:
  + `no plan`: nenhum plano foi capturado.
  + `estimate`: plano capturado com custos estimados.
  + `actual`: plano capturado com EXPLAIN ANALYZE.
+ plan\_captured\_time: última vez que um plano foi capturado.

## Observações de uso
<a name="aurora_stat_plans-usage-notes"></a>

`aurora_compute_plan_id` deve estar habilitado e `pg_stat_statements` deve estar em `shared_preload_libraries` para que os planos sejam monitorados.

O número de planos disponíveis é controlado pelo valor definido no parâmetro `pg_stat_statements.max`. Quando `aurora_compute_plan_id` está habilitado, é possível monitorar os planos até esse valor especificado em `aurora_stat_plans`.

Essa função está disponível para o Aurora PostgreSQL versões 14.10, 15.5 e todas as outras versões posteriores.

## Exemplos
<a name="aurora_stat_plans-examples"></a>

No exemplo abaixo, os dois planos que são para o identificador de consulta -5471422286312252535 são capturados e as estatísticas das declarações são monitoradas pelo planid.

```
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)
```