As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Atualizações de gerenciamento do plano de consultas do Aurora PostgreSQL
A AWS `apg_plan_mgmt` extensão fornece ao seu cluster de banco de dados Aurora PostgreSQL o recurso de gerenciamento do plano de consulta. Ele permite que você gerencie os planos de execução de consultas gerados pelo otimizador para suas aplicações SQL, visando uma maior estabilidade e prevenção de regressões. Para obter mais informações, consulte [Gerenciar planos de execução de consultas do Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) no *Guia do usuário do Amazon Aurora*.
**Topics**
+ [Versões do PostgreSQL 17](#auroraqpm-version17)
+ [Versões 16 do PostgreSQL](#auroraqpm-version16)
+ [Versões 15 do PostgreSQL](#auroraqpm-version15)
+ [Versões 14 do PostgreSQL](#auroraqpm-version14)
+ [Versões 13 do PostgreSQL](#auroraqpm-version13)
+ [Versões 12 do PostgreSQL](#auroraqpm-version12)
+ [Versão 2.3 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL](#auroraqpm-version.23)
+ [Versão 2.1 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL](#auroraqpm-version.21)
+ [Versão 2.0 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL](#auroraqpm-version.20)
+ [Versão 1.0.1 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL](#auroraqpm-version.101)
## Versões do PostgreSQL 17
**Topics**
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 17.9, 6 de abril de 2026](#auroraqpm-version17-179)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 17.7, 18 de dezembro de 2025](#auroraqpm-version17-177)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 17.5, 30 de junho de 2025](#auroraqpm-version17-175)
+ [apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 17.4, 1º de maio de 2025](#auroraqpm-version17-174)
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 17.9, 6 de abril de 2026
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 17.9 incluem o seguinte:
**Melhorias de extensão**
+ Corrigido um problema no Gerenciamento do Plano de Consulta que fazia com que os planos não fossem capturados.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 17.7, 18 de dezembro de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 17.7 incluem o seguinte:
**Melhorias de extensão**
+ Foi adicionada uma melhoria no Gerenciamento do Plano de Consulta para recapturar automaticamente as listas de parâmetros armazenadas nas versões anteriores.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 17.5, 30 de junho de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 17.5 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de digitalizações paralelas de bitmap quando um BitmapOr/BitmapAnd operador estava presente.
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de planos em que várias partições de tabela são unidas a uma partição de tabela.
+ Corrigido um problema no gerenciamento do plano de consulta com a imposição de nós do Append em cima de uma única partição de tabela.
+ A `apg_plan_mgmt` função no gerenciamento do plano de consulta é reservada e não pode mais ser criada, alterada ou descartada pelos usuários.
+ Corrigido um problema no tratamento de listas de parâmetros de versões anteriores do gerenciamento do plano de consulta.
### apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 17.4, 1º de maio de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.8 para o Aurora PostgreSQL 17.4 incluem o seguinte:
**Novos recursos**
+ O gerenciamento do plano de consulta pode impor planos com transformação de subconsulta correlacionada.
+ O gerenciamento do plano de consulta pode impor planos com cache de subconsulta correlacionado.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a lista de parâmetros que causava um erro ou uma reinicialização durante a consulta, `dba_plans` exibição ou chamada `validate_plans` e `evolve_plan_baselines` funções no gerenciamento do plano de consulta.
+ Foi corrigido um problema com a aplicação de planos otimizados pela correlação de qualquer transformação no gerenciamento do plano do Query.
+ Corrigido um problema no gerenciamento do plano de consulta com a execução de uma instrução de utilitário imediatamente após a instalação da extensão ou a redefinição da memória compartilhada.
+ Corrigido um problema na aplicação, validação e evolução de planos para consultas com chamadas para funções imutáveis no gerenciamento do plano de consulta.
+ Corrigido um problema na aplicação, validação e evolução dos planos no gerenciamento do plano de consulta.
## Versões 16 do PostgreSQL
**Topics**
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 16.13, 6 de abril de 2026](#auroraqpm-version16-1613)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 16.11, 18 de dezembro de 2025](#auroraqpm-version16-1611)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 16.9, 30 de junho de 2025](#auroraqpm-version16-169)
+ [apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 16.8, 8 de abril de 2025](#auroraqpm-version16-168)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 16.6, 27 de dezembro de 2024](#auroraqpm-version16-166)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 16.3](#auroraqpm-version16-163)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 16.2](#auroraqpm-version16-162)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 16.1](#auroraqpm-version16-161)
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 16.13, 6 de abril de 2026
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 16.13 incluem o seguinte:
**Melhorias de extensão**
+ Corrigido um problema no Gerenciamento do Plano de Consulta que fazia com que os planos não fossem capturados.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 16.11, 18 de dezembro de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 16.11 incluem o seguinte:
**Melhorias de extensão**
+ Foi adicionada uma melhoria no Gerenciamento do Plano de Consulta para recapturar automaticamente as listas de parâmetros armazenadas nas versões anteriores.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 16.9, 30 de junho de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 16.9 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de digitalizações paralelas de bitmap quando um BitmapOr/BitmapAnd operador estava presente.
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de planos em que várias partições de tabela são unidas a uma partição de tabela.
+ Corrigido um problema no gerenciamento do plano de consulta com a imposição de nós do Append em cima de uma única partição de tabela.
+ A `apg_plan_mgmt` função no gerenciamento do plano de consulta é reservada e não pode mais ser criada, alterada ou descartada pelos usuários.
+ Corrigido um problema no tratamento de listas de parâmetros de versões anteriores do gerenciamento do plano de consulta.
### apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 16.8, 8 de abril de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.8 para o Aurora PostgreSQL 16.8 incluem o seguinte:
**Novos recursos**
+ O gerenciamento do plano de consulta pode impor planos com transformação de subconsulta correlacionada.
+ O gerenciamento do plano de consulta pode impor planos com cache de subconsulta correlacionado.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a lista de parâmetros que causava um erro ou uma reinicialização durante a consulta, `dba_plans` exibição ou chamada `validate_plans` e `evolve_plan_baselines` funções no gerenciamento do plano de consulta.
+ Foi corrigido um problema com a aplicação de planos otimizados pela correlação de qualquer transformação no gerenciamento do plano do Query.
+ Corrigido um problema no gerenciamento do plano de consulta com a execução de uma instrução de utilitário imediatamente após a instalação da extensão ou a redefinição da memória compartilhada.
+ Corrigido um problema na aplicação, validação e evolução de planos para consultas com chamadas para funções imutáveis no gerenciamento do plano de consultas.
+ Corrigido um problema na aplicação, validação e evolução de planos no gerenciamento de planos do Query.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 16.6, 27 de dezembro de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 16.6 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a captura do plano na réplica no gerenciamento do plano de consulta em que a matriz de memória compartilhada na réplica ficava cheia.
+ Corrigido um problema com o funcionário em segundo plano de gerenciamento do plano de consulta que fazia com que o período de retenção do plano não fosse imposto e a data da última utilização não fosse atualizada.
+ Corrigido um problema relacionado ao funcionário em segundo plano de gerenciamento do plano de consulta.
+ Corrigido um problema com a aplicação dos planos de gerenciamento do plano de consulta contendo digitalizações de bitmap.
+ Corrigido um problema com o gerenciamento do plano de consulta em que os planos eram capturados incorretamente para funções ou procedimentos com várias consultas.
+ Corrigido um problema com a captura de planos de execuções de consultas aninhadas no gerenciamento do plano de consulta.
+ Corrigido um problema com a captura de planos no gerenciamento do plano de consulta com o protocolo de consulta estendido.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 16.3
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 16.3 incluem o seguinte:
**Novos recursos**
+ Você não precisa mais atualizar `plan_hash_version` o. Depois de atualizar o mecanismo de banco de dados, o QPM ativa automaticamente novos recursos. Você não precisa realizar nenhuma ação para que novos recursos sejam disponibilizados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação de planos QPM contendo mais de 64 tabelas particionadas.
+ Corrigido um problema com a aplicação dos planos QPM contendo o operador Append.
+ Corrigido um problema com o QPM validate\$1plans com a ação update\$1plan\$1hash.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 16.2
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 16.2 incluem o seguinte:
**Novos recursos**
+ O QPM pode aplicar planos com operadores agregados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema em que a eliminação de um banco de dados não removia os planos capturados associados da memória compartilhada.
+ Corrigido um problema com a aplicação de planos contendo visualizações.
+ Melhorias na aplicação do plano Parallel Append.
+ Corrigido um problema relacionado à captura do plano.
+ Corrigido um problema com a aplicação de planos contendo nós de coleta.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 16.1
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 16.1 incluem o seguinte:
**Novos recursos**
+ A descrição do plano será atualizada para a versão de formato mais recente como parte da ação `update_plan_hash` para a função `apg_plan_mgmt.validate_plans`.
+ Adicionado suporte à aplicação paralela de Append como parte da aplicação da consulta paralela. Para aplicar os nós de anexação paralelos corretamente, você deve fazer o seguinte:
1. Defina `apg_plan_mgmt.plan_hash_version` como 5.
1. Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Melhorias e aprimoramentos adicionais**
+ Melhoria de desempenho no cálculo de hash do plano.
+ Utilização aprimorada da memória para descrições de planos que contêm subplanos repetitivos.
+ Corrigido um problema na aplicação paralela de consultas em que `GatherMerge` não podia ser aplicada.
+ Corrigido um problema em que o custo estimado do plano aplicado estava incorreto.
+ Corrigido um problema na aplicação dos planos aprovados em que a descrição contém tabelas e subplanos particionados.
## Versões 15 do PostgreSQL
**Topics**
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 15.17, 6 de abril de 2026](#auroraqpm-version15-1517)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 15.15, 18 de dezembro de 2025](#auroraqpm-version15-1515)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 15.13, 30 de junho de 2025](#auroraqpm-version15-1513)
+ [apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 15.12, 8 de abril de 2025](#auroraqpm-version15-1512)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 15.10, 27 de dezembro de 2024](#auroraqpm-version15-1510)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 15.8, 30 de setembro de 2024](#auroraqpm-version15-158)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 15.7, 8 de agosto de 2024](#auroraqpm-version15-157)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 15.6](#auroraqpm-version15-156)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 15.5](#auroraqpm-version15-155)
+ [apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 15.4](#auroraqpm-version15-154)
+ [apg\$1plan\$1mgmt versão 2.4 para Aurora PostgreSQL 15.3](#auroraqpm-version15-153)
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 15.17, 6 de abril de 2026
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 15.17 incluem o seguinte:
**Melhorias de extensão**
+ Corrigido um problema no Gerenciamento do Plano de Consulta que fazia com que os planos não fossem capturados.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 15.15, 18 de dezembro de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 15.15 incluem o seguinte:
**Melhorias de extensão**
+ Foi adicionada uma melhoria no Gerenciamento do Plano de Consulta para recapturar automaticamente as listas de parâmetros armazenadas nas versões anteriores.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 15.13, 30 de junho de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 15.13 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de digitalizações paralelas de bitmap quando um BitmapOr/BitmapAnd operador estava presente.
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de planos em que várias partições de tabela são unidas a uma partição de tabela.
+ Corrigido um problema no gerenciamento do plano de consulta com a imposição de nós do Append em cima de uma única partição de tabela.
+ A `apg_plan_mgmt` função no gerenciamento do plano de consulta é reservada e não pode mais ser criada, alterada ou descartada pelos usuários.
+ Corrigido um problema no tratamento de listas de parâmetros de versões anteriores do gerenciamento do plano de consulta.
### apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 15.12, 8 de abril de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.8 para o Aurora PostgreSQL 15.12 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a lista de parâmetros que causava um erro ou uma reinicialização durante a consulta, `dba_plans` exibição ou chamada `validate_plans` e `evolve_plan_baselines` funções no gerenciamento do plano de consulta.
+ Foi corrigido um problema com a aplicação de planos otimizados pela correlação de qualquer transformação no gerenciamento do plano do Query.
+ Corrigido um problema no gerenciamento do plano de consulta com a execução de uma instrução de utilitário imediatamente após a instalação da extensão ou a redefinição da memória compartilhada.
+ Corrigido um problema na aplicação, validação e evolução de planos para consultas com chamadas para funções imutáveis no gerenciamento do plano de consultas.
+ Corrigido um problema na aplicação, validação e evolução de planos no gerenciamento de planos do Query.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 15.10, 27 de dezembro de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 15.10 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a captura do plano na réplica no gerenciamento do plano de consulta em que a matriz de memória compartilhada na réplica ficava cheia.
+ Corrigido um problema com o funcionário em segundo plano de gerenciamento do plano de consulta que fazia com que o período de retenção do plano não fosse imposto e a data da última utilização não fosse atualizada.
+ Corrigido um problema relacionado ao funcionário em segundo plano de gerenciamento do plano de consulta.
+ Corrigido um problema com a aplicação dos planos de gerenciamento do plano de consulta contendo digitalizações de bitmap.
+ Corrigido um problema com o gerenciamento do plano de consulta em que os planos eram capturados incorretamente para funções ou procedimentos com várias consultas.
+ Corrigido um problema com a captura de planos de execuções de consultas aninhadas no gerenciamento do plano de consulta.
+ Corrigido um problema com a captura de planos no gerenciamento do plano de consulta com o protocolo de consulta estendido.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 15.8, 30 de setembro de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 15.8 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação dos planos de gerenciamento do plano de consulta contendo agregados de hash.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 15.7, 8 de agosto de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 15.7 incluem o seguinte:
**Novos recursos**
+ Você não precisa mais atualizar `plan_hash_version` o. Depois de atualizar o mecanismo de banco de dados, o QPM ativa automaticamente novos recursos. Você não precisa realizar nenhuma ação para que novos recursos sejam disponibilizados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação de planos QPM contendo mais de 64 tabelas particionadas.
+ Corrigido um problema com a aplicação dos planos QPM contendo o operador Append.
+ Corrigido um problema com o QPM validate\$1plans com a ação update\$1plan\$1hash.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 15.6
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 15.6 incluem o seguinte:
**Novos recursos**
+ O QPM pode aplicar planos com operadores agregados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema em que a eliminação de um banco de dados não removia os planos capturados associados da memória compartilhada.
+ Corrigido um problema com a aplicação de planos contendo visualizações.
+ Melhorias na aplicação do plano Parallel Append.
+ Corrigido um problema relacionado à captura do plano.
+ Corrigido um problema com a aplicação de planos contendo nós de coleta.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 15.5
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 15.5 incluem o seguinte:
**Novos recursos**
+ A descrição do plano será atualizada para a versão de formato mais recente como parte da ação `update_plan_hash` para a função `apg_plan_mgmt.validate_plans`.
+ Adicionado suporte à aplicação paralela de Append como parte da aplicação da consulta paralela. Para aplicar os nós de anexação paralelos corretamente, você deve fazer o seguinte:
1. Defina `apg_plan_mgmt.plan_hash_version` como 5.
1. Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Melhorias e aprimoramentos adicionais**
+ Melhoria de desempenho no cálculo de hash do plano.
+ Utilização aprimorada da memória para descrições de planos que contêm subplanos repetitivos.
+ Corrigido um problema na aplicação paralela de consultas em que `GatherMerge` não podia ser aplicada.
+ Corrigido um problema em que o custo estimado do plano aplicado estava incorreto.
+ Corrigido um problema na aplicação dos planos aprovados em que a descrição contém tabelas e subplanos particionados.
### apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 15.4
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.5 para o Aurora PostgreSQL 15.4 incluem o seguinte:
**Novos recursos**
+ O QPM pode impor que os planos de consulta tenham operadores paralelos, exceto o nó Parallel Append. Para aplicar corretamente os planos de consulta paralela, é necessário fazer o seguinte após a atualização para 15.4 ou 14.9:
+ Defina `apg_plan_mgmt.plan_hash_version` como 4 ou superior.
+ Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Recapture planos aprovados que tenham o nó Gather em plan\$1outline.
+ O QPM pode impor planos de consulta com os nós do Materialize. Para aplicar os nós do Materialize, é necessário fazer o seguinte após a atualização para a versão 15.4 ou 14.9:
+ Defina `apg_plan_mgmt.plan_hash_version` como 4 ou superior.
+ Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Para capturar planos de consulta de réplicas, é necessário atualizar a extensão `apg_plan_mgmt` chamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ É preciso especificar `apg_plan_mgmt.plan_capture_threshold` para não permitir que o QPM capture quaisquer planos de consulta.
**Melhorias e aprimoramentos adicionais**
+ Melhoria de desempenho no `plan_hash` cálculo.
### apg\$1plan\$1mgmt versão 2.4 para Aurora PostgreSQL 15.3
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.4 para o Aurora PostgreSQL 15.3 incluem o seguinte:
**Novos recursos**
+ Introduzido um novo GUC auto\$1explain.hashes. Quando definido como true (padrão: false), sql\$1hash e plan\$1hash são mostrados no final do resultado da explicação automática.
+ Introduzido um novo GUC apg\$1plan\$1mgmt.explain\$1hashes. Quando definido como true (padrão: false), o resultado EXPLAIN mostra sql\$1hash e plan\$1hash mesmo sem a opção hashes verdadeira.
+ Introduzido um novo GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. Dependendo de seu valor (padrão: nenhum), os resultados da aplicação do plano são gravados nos arquivos de log do Postgres.
+ Introduzida uma nova versão de cálculo de hash do plano para oferecer suporte a tabelas particionadas. Os usuários precisam definir apg\$1plan\$1mgmt.plan\$1hash\$1version como 3 e chamar apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') em cada banco de dados com `apg_plan_mgmt` instalado e entradas na tabela de planos.
+ O QPM pode impor planos de consulta com os nós do Memoize.
+ A função `apg_plan_mgmt.copy_outline` pode receber um novo quinto argumento, `force_update_target_plan_hash`. Se for definido como verdadeiro, o hash do plano de destino será atualizado mesmo que o plano de origem não seja reproduzível para o sql\$1hash de destino.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação do plano de declarações preparadas pelo JDBC.
+ Paridade aprimorada em relação ao queryid entre pg\$1stat\$1statements e apg\$1plan\$1mgmt.dba\$1plans.
+ Corrigido um problema de aplicação do plano quando os nomes dos índices terminavam com dígitos.
+ A função apg\$1plan\$1mgmt.copy\$1outline agora copia environment\$1variables.
+ O valor mínimo de apg\$1plan\$1mgmt.plan\$1retention\$1period muda de 32 para 1.
+ O gerenciamento do plano de consulta agora pode salvar planos para consultas em transações somente leitura dos nós do gravador.
+ Corrigido um problema na função apg\$1plan\$1mgmt.evolve\$1plan\$1baselines.
+ Correção de um problema que poderia causar indisponibilidade quando apg\$1plan\$1mgmt estava habilitado.
Para saber como instalar, atualizar e usar a extensão `apg_plan_mgmt`, consulte [Gerenciamento de planos de execução de consultas para o Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) no *Guia do usuário do Amazon Aurora*.
## Versões 14 do PostgreSQL
**Topics**
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 14.22, 6 de abril de 2026](#auroraqpm-version14-1422)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 14.20, 18 de dezembro de 2025](#auroraqpm-version14-1420)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 14.18, 30 de junho de 2025](#auroraqpm-version14-1418)
+ [apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 14.17, 8 de abril de 2025](#auroraqpm-version14-1417)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 14.15, 27 de dezembro de 2024](#auroraqpm-version14-1415)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 14.12, 8 de agosto de 2024](#auroraqpm-version14-1412)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 14.11](#auroraqpm-version14-1411)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 14.10](#auroraqpm-version14-1410)
+ [apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 14.9](#auroraqpm-version14-149)
+ [apg\$1plan\$1mgmt versão 2.4 para Aurora PostgreSQL 14.8](#auroraqpm-version14-148)
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 14.22, 6 de abril de 2026
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 14.22 incluem o seguinte:
**Melhorias de extensão**
+ Corrigido um problema no Gerenciamento do Plano de Consulta que fazia com que os planos não fossem capturados.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 14.20, 18 de dezembro de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 14.20 incluem o seguinte:
**Melhorias de extensão**
+ Foi adicionada uma melhoria no Gerenciamento do Plano de Consulta para recapturar automaticamente as listas de parâmetros armazenadas nas versões anteriores.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 14.18, 30 de junho de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 14.18 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de digitalizações paralelas de bitmap quando um BitmapOr/BitmapAnd operador estava presente.
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de planos em que várias partições de tabela são unidas a uma partição de tabela.
+ Corrigido um problema no gerenciamento do plano de consulta com a imposição de nós do Append em cima de uma única partição de tabela.
+ A `apg_plan_mgmt` função no gerenciamento do plano de consulta é reservada e não pode mais ser criada, alterada ou descartada pelos usuários.
+ Corrigido um problema no tratamento de listas de parâmetros de versões anteriores do gerenciamento do plano de consulta.
### apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 14.17, 8 de abril de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.8 para o Aurora PostgreSQL 14.17 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a lista de parâmetros que causava um erro ou uma reinicialização durante a consulta, `dba_plans` exibição ou chamada `validate_plans` e `evolve_plan_baselines` funções no gerenciamento do plano de consulta.
+ Foi corrigido um problema com a aplicação de planos otimizados pela correlação de qualquer transformação no gerenciamento do plano do Query.
+ Corrigido um problema no gerenciamento do plano de consulta com a execução de uma instrução de utilitário imediatamente após a instalação da extensão ou a redefinição da memória compartilhada.
+ Corrigido um problema na aplicação, validação e evolução de planos para consultas com chamadas para funções imutáveis no gerenciamento do plano de consultas.
+ Corrigido um problema na aplicação, validação e evolução de planos no gerenciamento de planos do Query.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 14.15, 27 de dezembro de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 14.15 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a captura do plano na réplica no gerenciamento do plano de consulta em que a matriz de memória compartilhada na réplica ficava cheia.
+ Corrigido um problema com o funcionário em segundo plano de gerenciamento do plano de consulta que fazia com que o período de retenção do plano não fosse imposto e a data da última utilização não fosse atualizada.
+ Corrigido um problema relacionado ao funcionário em segundo plano de gerenciamento do plano de consulta.
+ Corrigido um problema com a aplicação dos planos de gerenciamento do plano de consulta contendo digitalizações de bitmap.
+ Corrigido um problema com o gerenciamento do plano de consulta em que os planos eram capturados incorretamente para funções ou procedimentos com várias consultas.
+ Corrigido um problema com a captura de planos de execuções de consultas aninhadas no gerenciamento do plano de consulta.
+ Corrigido um problema com a captura de planos no gerenciamento do plano de consulta com o protocolo de consulta estendido.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 14.12, 8 de agosto de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 14.12 incluem o seguinte:
**Novos recursos**
+ Você não precisa mais atualizar `plan_hash_version` o. Depois de atualizar o mecanismo de banco de dados, o QPM ativa automaticamente novos recursos. Você não precisa realizar nenhuma ação para que novos recursos sejam disponibilizados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação de planos QPM contendo mais de 64 tabelas particionadas.
+ Corrigido um problema com a aplicação dos planos QPM contendo o operador Append.
+ Corrigido um problema com o QPM validate\$1plans com a ação update\$1plan\$1hash.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 14.11
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 14.11 incluem o seguinte:
**Novos recursos**
+ O QPM pode aplicar planos com operadores agregados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema em que a eliminação de um banco de dados não removia os planos capturados associados da memória compartilhada.
+ Corrigido um problema com a aplicação de planos contendo visualizações.
+ Melhorias na aplicação do plano Parallel Append.
+ Corrigido um problema relacionado à captura do plano.
+ Corrigido um problema com a aplicação de planos contendo nós de coleta.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 14.10
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 14.10 incluem o seguinte:
**Novos recursos**
+ A descrição do plano será atualizada para a versão de formato mais recente como parte da ação `update_plan_hash` para a função `apg_plan_mgmt.validate_plans`.
+ Adicionado suporte à aplicação paralela de Append como parte da aplicação da consulta paralela. Para aplicar os nós de anexação paralelos corretamente, você deve fazer o seguinte:
1. Defina `apg_plan_mgmt.plan_hash_version` como 5.
1. Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Melhorias e aprimoramentos adicionais**
+ Melhoria de desempenho no cálculo de hash do plano.
+ Utilização aprimorada da memória para descrições de planos que contêm subplanos repetitivos.
+ Corrigido um problema na aplicação paralela de consultas em que `GatherMerge` não podia ser aplicada.
+ Corrigido um problema em que o custo estimado do plano aplicado estava incorreto.
+ Corrigido um problema na aplicação dos planos aprovados em que a descrição contém tabelas e subplanos particionados.
### apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 14.9
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.5 para o Aurora PostgreSQL 14.9 incluem o seguinte:
**Novos recursos**
+ O QPM pode impor que os planos de consulta tenham operadores paralelos, exceto o nó Parallel Append. Para aplicar corretamente os planos de consulta paralela, é necessário fazer o seguinte após a atualização para 15.4 ou 14.9:
+ Defina `apg_plan_mgmt.plan_hash_version` como 4 ou superior.
+ Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Recapture planos aprovados que tenham o nó Gather em plan\$1outline.
+ O QPM pode impor planos de consulta com os nós do Materialize. Para aplicar os nós do Materialize, é necessário fazer o seguinte após a atualização para a versão 15.4 ou 14.9:
+ Defina `apg_plan_mgmt.plan_hash_version` como 4 ou superior.
+ Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Para capturar planos de consulta de réplicas, é necessário atualizar a extensão `apg_plan_mgmt` chamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ É preciso especificar `apg_plan_mgmt.plan_capture_threshold` para não permitir que o QPM capture quaisquer planos de consulta.
**Melhorias e aprimoramentos adicionais**
+ Melhoria de desempenho no `plan_hash` cálculo.
### apg\$1plan\$1mgmt versão 2.4 para Aurora PostgreSQL 14.8
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.4 para o Aurora PostgreSQL 14.8 incluem o seguinte:
**Novos recursos**
+ Introduzido um novo GUC auto\$1explain.hashes. Quando definido como true (padrão: false), sql\$1hash e plan\$1hash são mostrados no final do resultado da explicação automática.
+ Introduzido um novo GUC apg\$1plan\$1mgmt.explain\$1hashes. Quando definido como true (padrão: false), o resultado EXPLAIN mostra sql\$1hash e plan\$1hash mesmo sem a opção hashes verdadeira.
+ Introduzido um novo GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. Dependendo de seu valor (padrão: nenhum), os resultados da aplicação do plano são gravados nos arquivos de log do Postgres.
+ Introduzida uma nova versão de cálculo de hash do plano para oferecer suporte a tabelas particionadas. Os usuários precisam definir apg\$1plan\$1mgmt.plan\$1hash\$1version como 3 e chamar apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') em cada banco de dados com `apg_plan_mgmt` instalado e entradas na tabela de planos.
+ O QPM pode impor planos de consulta com os nós do Memoize.
+ A função `apg_plan_mgmt.copy_outline` pode receber um novo quinto argumento, `force_update_target_plan_hash`. Se for definido como verdadeiro, o hash do plano de destino será atualizado mesmo que o plano de origem não seja reproduzível para o sql\$1hash de destino.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação do plano de declarações preparadas pelo JDBC.
+ Paridade aprimorada em relação ao queryid entre pg\$1stat\$1statements e apg\$1plan\$1mgmt.dba\$1plans.
+ Corrigido um problema de aplicação do plano quando os nomes dos índices terminavam com dígitos.
+ A função apg\$1plan\$1mgmt.copy\$1outline agora copia environment\$1variables.
+ O valor mínimo de apg\$1plan\$1mgmt.plan\$1retention\$1period muda de 32 para 1.
+ O gerenciamento do plano de consulta agora pode salvar planos para consultas em transações somente leitura dos nós do gravador.
+ Corrigido um problema na função apg\$1plan\$1mgmt.evolve\$1plan\$1baselines.
+ Correção de um problema que poderia causar indisponibilidade quando apg\$1plan\$1mgmt estava habilitado.
Para saber como instalar, atualizar e usar a extensão `apg_plan_mgmt`, consulte [Gerenciamento de planos de execução de consultas para o Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) no *Guia do usuário do Amazon Aurora*.
## Versões 13 do PostgreSQL
**Topics**
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 13.23, 18 de dezembro de 2025](#auroraqpm-version13-1323)
+ [apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 13.21, 30 de junho de 2025](#auroraqpm-version13-1321)
+ [apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 13.20, 8 de abril de 2025](#auroraqpm-version13-1320)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 13.18, 27 de dezembro de 2024](#auroraqpm-version13-1318)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 13.15, 8 de agosto de 2024](#auroraqpm-version13-1315)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 13.14](#auroraqpm-version13-1314)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 13.13](#auroraqpm-version13-1313)
+ [apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 13.12](#auroraqpm-version13-1312)
+ [apg\$1plan\$1mgmt versão 2.4 para Aurora PostgreSQL 13.11](#auroraqpm-version13-1311)
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 13.23, 18 de dezembro de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 13.23 incluem o seguinte:
**Melhorias de extensão**
+ Foi adicionada uma melhoria no Gerenciamento do Plano de Consulta para recapturar automaticamente as listas de parâmetros armazenadas nas versões anteriores.
### apg\$1plan\$1mgmt versão 2.9 para Aurora PostgreSQL 13.21, 30 de junho de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.9 para o Aurora PostgreSQL 13.21 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de digitalizações paralelas de bitmap quando um BitmapOr/BitmapAnd operador estava presente.
+ Corrigido um problema no gerenciamento do plano de consulta com a aplicação de planos em que várias partições de tabela são unidas a uma partição de tabela.
+ Corrigido um problema no gerenciamento do plano de consulta com a imposição de nós do Append em cima de uma única partição de tabela.
+ A `apg_plan_mgmt` função no Gerenciamento do Plano de Consulta é reservada e não pode mais ser criada, alterada ou descartada pelos usuários.
+ Corrigido um problema no tratamento de listas de parâmetros de versões anteriores do Gerenciamento do Plano de Consulta.
### apg\$1plan\$1mgmt versão 2.8 para Aurora PostgreSQL 13.20, 8 de abril de 2025
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.8 para o Aurora PostgreSQL 13.20 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a lista de parâmetros que causava um erro ou uma reinicialização durante a consulta, `dba_plans` exibição ou chamada `validate_plans` e `evolve_plan_baselines` funções no gerenciamento do plano de consulta.
+ Foi corrigido um problema com a aplicação de planos otimizados pela correlação de qualquer transformação no gerenciamento do plano do Query.
+ Corrigido um problema no gerenciamento do plano de consulta com a execução de uma instrução de utilitário imediatamente após a instalação da extensão ou a redefinição da memória compartilhada.
+ Corrigido um problema na aplicação, validação e evolução de planos para consultas com chamadas para funções imutáveis no gerenciamento do plano de consultas.
+ Corrigido um problema na aplicação, validação e evolução de planos no gerenciamento de planos do Query.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 13.18, 27 de dezembro de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 13.18 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a captura do plano na réplica no gerenciamento do plano de consulta em que a matriz de memória compartilhada na réplica ficava cheia.
+ Corrigido um problema com o funcionário em segundo plano de gerenciamento do plano de consulta que fazia com que o período de retenção do plano não fosse imposto e a data da última utilização não fosse atualizada.
+ Corrigido um problema relacionado ao funcionário em segundo plano de gerenciamento do plano de consulta.
+ Corrigido um problema com a aplicação dos planos de gerenciamento do plano de consulta contendo digitalizações de bitmap.
+ Corrigido um problema com o gerenciamento do plano de consulta em que os planos eram capturados incorretamente para funções ou procedimentos com várias consultas.
+ Corrigido um problema com a captura de planos de execuções de consultas aninhadas no gerenciamento do plano de consulta.
+ Corrigido um problema com a captura de planos no gerenciamento do plano de consulta com o protocolo de consulta estendido.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 13.15, 8 de agosto de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 13.15 incluem o seguinte:
**Novos recursos**
+ Você não precisa mais atualizar `plan_hash_version` o. Depois de atualizar o mecanismo de banco de dados, o QPM ativa automaticamente novos recursos. Você não precisa realizar nenhuma ação para que novos recursos sejam disponibilizados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação de planos QPM contendo mais de 64 tabelas particionadas.
+ Corrigido um problema com a aplicação dos planos QPM contendo o operador Append.
+ Corrigido um problema com o QPM validate\$1plans com a ação update\$1plan\$1hash.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 13.14
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 13.14 incluem o seguinte:
**Novos recursos**
+ O QPM pode aplicar planos com operadores agregados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema em que a eliminação de um banco de dados não removia os planos capturados associados da memória compartilhada.
+ Corrigido um problema com a aplicação de planos contendo visualizações.
+ Melhorias na aplicação do plano Parallel Append.
+ Corrigido um problema relacionado à captura do plano.
+ Corrigido um problema com a aplicação de planos contendo nós de coleta.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 13.13
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 13.13 incluem o seguinte:
**Novos recursos**
+ A descrição do plano será atualizada para a versão de formato mais recente como parte da ação `update_plan_hash` para a função `apg_plan_mgmt.validate_plans`.
+ Adicionado suporte à aplicação paralela de Append como parte da aplicação da consulta paralela. Para aplicar os nós de anexação paralelos corretamente, você deve fazer o seguinte:
1. Defina `apg_plan_mgmt.plan_hash_version` como 5.
1. Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Melhorias e aprimoramentos adicionais**
+ Melhoria de desempenho no cálculo de hash do plano.
+ Utilização aprimorada da memória para descrições de planos que contêm subplanos repetitivos.
+ Corrigido um problema na aplicação paralela de consultas em que `GatherMerge` não podia ser aplicada.
+ Corrigido um problema em que o custo estimado do plano aplicado estava incorreto.
+ Corrigido um problema na aplicação dos planos aprovados em que a descrição contém tabelas e subplanos particionados.
### apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 13.12
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.5 para o Aurora PostgreSQL 13.12 incluem o seguinte:
**Novos recursos**
+ O QPM pode impor que os planos de consulta tenham operadores paralelos, exceto o nó Parallel Append. Para aplicar corretamente os planos de consulta paralela, é necessário fazer o seguinte após a atualização para 15.4 ou 14.9:
+ Defina `apg_plan_mgmt.plan_hash_version` como 4 ou superior.
+ Chame `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Recapture planos aprovados que tenham o nó Gather em plan\$1outline.
+ Para capturar planos de consulta de réplicas, é necessário atualizar a extensão `apg_plan_mgmt` chamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ É preciso especificar `apg_plan_mgmt.plan_capture_threshold` para não permitir que o QPM capture quaisquer planos de consulta.
### apg\$1plan\$1mgmt versão 2.4 para Aurora PostgreSQL 13.11
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.4 para o Aurora PostgreSQL 13.11 incluem o seguinte:
**Novos recursos**
+ Introduzido um novo GUC auto\$1explain.hashes. Quando definido como true (padrão: false), sql\$1hash e plan\$1hash são mostrados no final do resultado da explicação automática.
+ Introduzido um novo GUC apg\$1plan\$1mgmt.explain\$1hashes. Quando definido como true (padrão: false), o resultado EXPLAIN mostra sql\$1hash e plan\$1hash mesmo sem a opção hashes verdadeira.
+ Introduzido um novo GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. Dependendo de seu valor (padrão: nenhum), os resultados da aplicação do plano são gravados nos arquivos de log do Postgres.
+ Introduzida uma nova versão de cálculo de hash do plano para oferecer suporte a tabelas particionadas. Os usuários precisam definir apg\$1plan\$1mgmt.plan\$1hash\$1version como 3 e chamar apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') em cada banco de dados com `apg_plan_mgmt` instalado e entradas na tabela de planos.
+ A função `apg_plan_mgmt.copy_outline` pode receber um novo quinto argumento, `force_update_target_plan_hash`. Se for definido como verdadeiro, o hash do plano de destino será atualizado mesmo que o plano de origem não seja reproduzível para o sql\$1hash de destino.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação do plano de declarações preparadas pelo JDBC.
+ Corrigido um problema de aplicação do plano quando os nomes dos índices terminavam com dígitos.
+ A função apg\$1plan\$1mgmt.copy\$1outline agora copia environment\$1variables.
+ O valor mínimo de apg\$1plan\$1mgmt.plan\$1retention\$1period muda de 32 para 1.
+ O gerenciamento do plano de consulta agora pode salvar planos para consultas em transações somente leitura dos nós do gravador.
+ Corrigido um problema na função apg\$1plan\$1mgmt.evolve\$1plan\$1baselines.
+ Correção de um problema que poderia causar indisponibilidade quando apg\$1plan\$1mgmt estava habilitado.
Para saber como instalar, atualizar e usar a extensão `apg_plan_mgmt`, consulte [Gerenciamento de planos de execução de consultas para o Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) no *Guia do usuário do Amazon Aurora*.
## Versões 12 do PostgreSQL
**Topics**
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 12.22, 27 de dezembro de 2024](#auroraqpm-version12-1222)
+ [apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 12.19, 8 de agosto de 2024](#auroraqpm-version12-1219)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 12.18](#auroraqpm-version12-1218)
+ [apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 12.17](#auroraqpm-version12-1217)
+ [apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 12.16](#auroraqpm-version12-1216)
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 12.22, 27 de dezembro de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 12.22 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a captura do plano na réplica no gerenciamento do plano de consulta em que a matriz de memória compartilhada na réplica ficava cheia.
+ Corrigido um problema com o funcionário em segundo plano de gerenciamento do plano de consulta que fazia com que o período de retenção do plano não fosse imposto e a data da última utilização não fosse atualizada.
+ Corrigido um problema relacionado ao funcionário em segundo plano de gerenciamento do plano de consulta.
### apg\$1plan\$1mgmt versão 2.7 para Aurora PostgreSQL 12.19, 8 de agosto de 2024
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.7 para o Aurora PostgreSQL 12.19 incluem o seguinte:
**Novos recursos**
+ Você não precisa mais atualizar `plan_hash_version` o. Depois de atualizar o mecanismo de banco de dados, o QPM ativa automaticamente novos recursos. Você não precisa realizar nenhuma ação para que novos recursos sejam disponibilizados.
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema com a aplicação de planos QPM contendo mais de 64 tabelas particionadas.
+ Corrigido um problema com a aplicação dos planos QPM contendo o operador Append.
+ Corrigido um problema com o QPM validate\$1plans com a ação update\$1plan\$1hash.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 12.18
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 12.18 incluem o seguinte:
**Melhorias e aprimoramentos adicionais**
+ Corrigido um problema relacionado à captura do plano.
### apg\$1plan\$1mgmt versão 2.6 para Aurora PostgreSQL 12.17
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.6 para o Aurora PostgreSQL 12.17 incluem o seguinte:
**Novos recursos**
+ A descrição do plano será atualizada para a versão de formato mais recente como parte da ação `update_plan_hash` para a função `apg_plan_mgmt.validate_plans`.
### apg\$1plan\$1mgmt versão 2.5 para Aurora PostgreSQL 12.16
Os aprimoramentos na `apg_plan_mgmt` extensão na versão 2.5 para o Aurora PostgreSQL 12.16 incluem o seguinte:
**Novos recursos**
+ Para capturar planos de consulta de réplicas, é necessário atualizar a extensão `apg_plan_mgmt` chamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ É preciso especificar `apg_plan_mgmt.plan_capture_threshold` para não permitir que o QPM capture quaisquer planos de consulta.
## Versão 2.3 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL
As melhorias na extensão `apg_plan_mgmt` na versão 2.3 incluem o seguinte:
**Novos atributos da extensão**
+ Suporte para uma nova função, a função `apg_plan_mgmt.copy_outline`. Esta função permite copiar um hash de plano e um esboço de plano de um hash SQL e um hash de plano para outro. Use essa função quando quiser copiar um plano que usa dicas para outras instruções semelhantes sem usar a instrução de dica em linha em cada ocorrência. Se a atualização na consulta resultar em um plano inválido, a função gerará um erro e reverterá a atualização. Para ter mais informações, consulte [Referência de funções para o gerenciamento do plano de consultas do Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Functions.html#AuroraPostgreSQL.Optimize.Functions.copy_outline) no *Guia de usuário do Amazon Aurora*.
**Melhorias de extensão**
+ O atributo de gerenciamento do plano de consulta agora salva os planos para consultas que estão dentro dos procedimentos e dos bloqueios de DO. Para versões do `apg_plan_mgmt` anteriores à versão 2.3, isso tem sido uma limitação.
Para saber como instalar, atualizar e usar a extensão `apg_plan_mgmt`, consulte [Gerenciamento de planos de execução de consultas para o Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) no *Guia do usuário do Amazon Aurora*.
## Versão 2.1 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL
As melhorias na extensão `apg_plan_mgmt` na versão 2.1 para o Aurora PostgreSQL 11.20 incluem o seguinte:
**Novos atributos de extensão no Aurora PostgreSQL 11.20**
+ Introduzido um novo GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. Dependendo de seu valor (padrão: nenhum), os resultados da aplicação do plano são gravados nos arquivos de log do Postgres.
**Melhorias de extensão no Aurora PostgreSQL 11.20**
+ Corrigido um problema com a aplicação do plano de declarações preparadas pelo JDBC.
Para saber como instalar, atualizar e usar a extensão `apg_plan_mgmt`, consulte [Gerenciamento de planos de execução de consultas para o Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) no *Guia do usuário do Amazon Aurora*.
## Versão 2.0 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL
As alterações da extensão `apg_plan_mgmt` para a versão 2.0 incluem o seguinte:
**Novos recursos da extensão**
1. Agora é possível gerenciar todas as consultas dentro de funções SQL, se elas tiverem parâmetros ou não.
1. Agora você pode gerenciar todas as consultas dentro das PL/pgSQL funções, tenham elas parâmetros ou não.
1. Agora é possível gerenciar consultas em planos genéricos, se elas tiverem parâmetros ou não. Para saber mais sobre planos genéricos em relação a planos personalizados, consulte a instrução `PREPARE` na [documentação do PostgreSQL](https://www.postgresql.org/docs/current/sql-prepare.html).
1. Agora é possível usar o gerenciamento de planos de consultas para impor o uso de tipos específicos de métodos agregados em planos de consulta.
**Melhorias de extensão**
1. Agora é possível salvar planos com um tamanho de até 8 KB vezes a configuração do parâmetro `max_worker_processes`. Anteriormente, o tamanho máximo do plano era de 8 KB.
1. Corrigidos bugs para declarações preparadas sem nome, como as do JDBC.
1. Anteriormente, ao tentar fazer `CREATE EXTENSION apg_plan_mgmt` quando ele não estava carregado nas `shared_preload_libraries`, a conexão de backend do PostgreSQL era descartada. Agora, uma mensagem de erro é impressa e a conexão não é descartada.
1. O valor padrão do `cardinality_error` na `apg_plan_mgmt.plans table` é NULL, mas pode ser definido como -1 durante a função `apg_plan_mgmt.evolve_plan_baselines`. NULL agora é usado consistentemente.
1. Os planos agora são salvos para consultas que fazem referência a tabelas temporárias.
1. O número máximo padrão de planos foi aumentado de 1.000 para 10.000.
1. Os parâmetros pgss a seguir estão defasados porque o modo automático de captura de plano deve ser usado em vez desses parâmetros.
+ `apg_plan_mgmt.pgss_min_calls`
+ `apg_plan_mgmt.pgss_min_mean_time_ms`
+ `apg_plan_mgmt.pgss_min_stddev_time_ms`
+ `apg_plan_mgmt.pgss_min_total_time_ms`
## Versão 1.0.1 da extensão apg\$1plan\$1mgmt do Aurora PostgreSQL
As alterações da extensão `apg_plan_mgmt` para a versão 1.0.1 incluem o seguinte:
**Novos recursos da extensão**
1. A função `validate_plans` tem um novo valor `action` chamado `update_plan_hash`. Esta ação atualiza o ID `plan_hash` para planos que não podem ser reproduzidos exatamente. O valor `update_plan_hash` também permite que você corrija um plano reescrevendo o SQL. Depois, você pode registrar o plano bom como um plano `Approved` para o SQL original. Segue-se um exemplo de uso da ação `update_plan_hash`.
```
UPDATE apg_plan_mgmt.plans SET plan_hash = new _plan_hash, plan_outline = good_plan_outline
WHERE sql_hash = bad_plan_sql_hash AND plan_hash = bad_plan_plan_hash;
SELECT apg_plan_mgmt.validate_plans(bad_plan_sql_hash, bad_plan_plan_hash, 'update_plan_hash');
SELECT apg_plan_mgmt.reload();
```
1. Está disponível uma nova função `get_explain_stmt` que gera o texto de uma instrução `EXPLAIN` para a instrução SQL especificada. Ela inclui os parâmetros `sql_hash`, `plan_hash` e `explain_options`.
O parâmetro `explain_options` pode ser qualquer lista separada por vírgulas de opções de `EXPLAIN` válidas, conforme mostrado a seguir.
```
analyze,verbose,buffers,hashes,format json
```
Se o parâmetro `explain_options` for NULL ou uma string vazia, a função `get_explain_stmt` gerará uma instrução `EXPLAIN` simples.
Para criar um script de `EXPLAIN` para sua workload ou para uma parte dela, use as opções `\a`, `\t` e `\o` para redirecionar a saída para um arquivo. Por exemplo, é possível criar um script de `EXPLAIN` para as instruções de classificação superior (top-K) usando a visualização `pg_stat_statements` do PostgreSQL classificada por `total_time` em ordem `DESC`.
1. O local exato do operador de consulta paralela Gather é determinado por custos, e pode ser alterado levemente ao longo do tempo. Para evitar que essas diferenças invalidem o plano inteiro, o gerenciamento de planos de consultas agora calcula o mesmo `plan_hash` que os operadores Gather sejam movidos para locais diferentes na árvore de planos.
1. Adicionado suporte a instruções não parametrizadas em funções pl/pgsql.
1. O custo indireto é reduzido quando a extensão `apg_plan_mgmt` é instalada em vários bancos de dados no mesmo cluster enquanto dois ou mais bancos de dados estão sendo acessados simultaneamente. Além disso, essa versão corrigiu um bug nessa área que fazia com que os planos não fossem armazenados na memória compartilhada.
**Melhorias de extensão**
1. Melhorias na função `evolve_plan_baselines`.
1. A função `evolve_plan_baselines` agora calcula uma métrica de `cardinality_error` sobre todos os nós no plano. Usando essa métrica, é possível identificar qualquer plano em que o erro de estimativa da cardinalidade é grande, e a qualidade do plano é mais duvidosa. Instruções de execução longa com valores altos de `cardinality_error` são candidatas de alta prioridade para ajuste de consultas.
1. Os relatórios gerados por `evolve_plan_baselines` agora incluem `sql_hash`, `plan_hash` e o `status` do plano.
1. Agora, você pode permitir que `evolve_plan_baselines` aprovem planos anteriormente `Rejected`.
1. O significado de `speedup_factor` para `evolve_plan_baselines` agora sempre é relativo ao plano de linha de base. Por exemplo, um valor de 1.1 agora significa 10 por cento mais rápido que o plano de linha de base. Um valor de 0,9 significa 10 por cento mais lento que o plano de linha de base. A comparação é feita usando somente o tempo de execução em vez do tempo total.
1. A função `evolve_plan_baselines` agora aquece o cache de uma nova maneira. Ela faz isso executando o plano de linha de base duas vezes e executando o plano candidato uma vez. Anteriormente, `evolve_plan_baselines` executava o plano candidato duas vezes. Essa abordagem aumentou significativamente o tempo de execução, principalmente para planos candidatos lentos. No entanto, a execução do plano candidato duas vezes é mais confiável quando o plano candidato usa um índice que não é usado no plano de linha de base.
1. O gerenciamento de planos de consultas não salva mais planos que fazem referência a tabelas ou visualizações do sistema ou a tabelas do próprio gerenciamento de planos de consultas.
1. As correções de bugs incluem o armazenamento em cache de um plano imediatamente quando salvo e a correção de um bug que fazia com que o backend fosse encerrado.