Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Aggiornamenti per la gestione del piano di query PostgreSQL di Aurora
L' AWS `apg_plan_mgmt`estensione fornisce al cluster Aurora PostgreSQL DB la funzionalità di gestione del piano di query. Consente di gestire i piani di esecuzione delle query generati dall'ottimizzatore per le applicazioni SQL per una maggiore stabilità e per impedire le regressioni. Per ulteriori informazioni, consulta [Gestione dei piani di esecuzione delle query per Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) nella *Guida per l'utente di Amazon Aurora*.
**Topics**
+ [Versioni PostgreSQL 17](#auroraqpm-version17)
+ [Versioni di PostgreSQL 16](#auroraqpm-version16)
+ [Versioni di PostgreSQL 15](#auroraqpm-version15)
+ [Versioni di PostgreSQL 14](#auroraqpm-version14)
+ [Versioni di PostgreSQL 13](#auroraqpm-version13)
+ [Versioni di PostgreSQL 12](#auroraqpm-version12)
+ [Versione 2.3 dell'estensione apg\$1plan\$1mgmt di Aurora PostgreSQL](#auroraqpm-version.23)
+ [Versione 2.1 dell'estensione apg\$1plan\$1mgmt di Aurora PostgreSQL](#auroraqpm-version.21)
+ [Versione 2.0 dell'estensione Aurora PostgreSQL apg\$1plan\$1mgmt](#auroraqpm-version.20)
+ [Versione 1.0.1 dell'estensione Aurora PostgreSQL apg\$1plan\$1mgmt](#auroraqpm-version.101)
## Versioni PostgreSQL 17
**Topics**
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 17.9, 6 aprile 2026](#auroraqpm-version17-179)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 17.7, 18 dicembre 2025](#auroraqpm-version17-177)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 17.5, 30 giugno 2025](#auroraqpm-version17-175)
+ [apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 17.4, 1 maggio 2025](#auroraqpm-version17-174)
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 17.9, 6 aprile 2026
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 17.9 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato risolto un problema in Query Plan Management che impediva l'acquisizione dei piani.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 17.7, 18 dicembre 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 17.7 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato aggiunto un miglioramento nella gestione del piano di query per recuperare automaticamente gli elenchi di parametri archiviati dalle versioni precedenti.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 17.5, 30 giugno 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 17.5 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione delle scansioni bitmap parallele quando è presente un operatore. BitmapOr/BitmapAnd
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione dei piani in cui più partizioni di tabella venivano unite a un'unica partizione di tabella.
+ È stato risolto un problema nella gestione del piano di query con l'applicazione dei nodi Append su una singola partizione di tabella.
+ Il `apg_plan_mgmt` ruolo nella gestione del piano di query è riservato e non può più essere creato, modificato o eliminato dagli utenti.
+ È stato risolto un problema nella gestione degli elenchi di parametri delle versioni precedenti della gestione dei piani di query.
### apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 17.4, 1 maggio 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.8 per Aurora PostgreSQL 17.4 includono quanto segue:
**Nuove funzionalità**
+ La gestione dei piani di query può applicare piani con una trasformazione delle subquery correlata.
+ La gestione dei piani di query può imporre piani con una cache delle subquery correlata.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'elenco dei parametri che causava un errore o il riavvio durante l'interrogazione, la `dba_plans` visualizzazione o la chiamata `validate_plans` e `evolve_plan_baselines` le funzioni nella gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione di piani ottimizzati correlando qualsiasi trasformazione nella gestione del piano di Query.
+ È stato risolto un problema nella gestione del piano di query relativo all'esecuzione di un'istruzione di utilità subito dopo l'installazione dell'estensione o il ripristino della memoria condivisa.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani per le interrogazioni con chiamate a funzioni immutabili nella gestione dei piani di query.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani nella gestione dei piani di query.
## Versioni di PostgreSQL 16
**Topics**
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 16.13, 6 aprile 2026](#auroraqpm-version16-1613)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 16.11, 18 dicembre 2025](#auroraqpm-version16-1611)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 16.9, 30 giugno 2025](#auroraqpm-version16-169)
+ [apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 16.8, 8 aprile 2025](#auroraqpm-version16-168)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 16.6, 27 dicembre 2024](#auroraqpm-version16-166)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 16.3](#auroraqpm-version16-163)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 16.2](#auroraqpm-version16-162)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 16.1](#auroraqpm-version16-161)
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 16.13, 6 aprile 2026
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 16.13 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato risolto un problema in Query Plan Management che impediva l'acquisizione dei piani.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 16.11, 18 dicembre 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 16.11 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato aggiunto un miglioramento nella gestione del piano di query per recuperare automaticamente gli elenchi di parametri archiviati dalle versioni precedenti.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 16.9, 30 giugno 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 16.9 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione delle scansioni bitmap parallele quando è presente un operatore. BitmapOr/BitmapAnd
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione dei piani in cui più partizioni di tabella venivano unite a un'unica partizione di tabella.
+ È stato risolto un problema nella gestione del piano di query con l'applicazione dei nodi Append su una singola partizione di tabella.
+ Il `apg_plan_mgmt` ruolo nella gestione del piano di query è riservato e non può più essere creato, modificato o eliminato dagli utenti.
+ È stato risolto un problema nella gestione degli elenchi di parametri delle versioni precedenti della gestione dei piani di query.
### apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 16.8, 8 aprile 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.8 per Aurora PostgreSQL 16.8 includono quanto segue:
**Nuove funzionalità**
+ La gestione dei piani di query può applicare piani con una trasformazione delle subquery correlata.
+ La gestione dei piani di query può imporre piani con una cache delle subquery correlata.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'elenco dei parametri che causava un errore o il riavvio durante l'interrogazione, la `dba_plans` visualizzazione o la chiamata `validate_plans` e `evolve_plan_baselines` le funzioni nella gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione di piani ottimizzati correlando qualsiasi trasformazione nella gestione del piano di Query.
+ È stato risolto un problema nella gestione del piano di query relativo all'esecuzione di un'istruzione di utilità subito dopo l'installazione dell'estensione o il ripristino della memoria condivisa.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani per le query con chiamate a funzioni immutabili nella gestione dei piani di query.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani nella gestione dei piani di Query.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 16.6, 27 dicembre 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 16.6 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'acquisizione del piano sulla replica nella gestione del piano di query, a causa del quale l'array di memoria condivisa nella replica si esauriva.
+ È stato risolto un problema con il Query Plan Management Background Worker che impediva l'applicazione del periodo di conservazione del piano e l'aggiornamento della data dell'ultimo utilizzo.
+ È stato risolto un problema relativo al lavoro in background per la gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione dei piani di gestione dei piani di query contenenti scansioni bitmap.
+ È stato risolto un problema relativo alla gestione dei piani di interrogazione a causa del quale i piani venivano acquisiti in modo errato per funzioni o procedure con più query.
+ È stato risolto un problema relativo all'acquisizione dei piani di esecuzione delle query annidate nella gestione dei piani di query.
+ È stato risolto un problema relativo all'acquisizione dei piani nella gestione dei piani di query con il protocollo di query esteso.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 16.3
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 16.3 includono quanto segue:
**Nuove funzionalità**
+ Non è più necessario aggiornare il. `plan_hash_version` Dopo l'aggiornamento del motore di database, QPM abilita automaticamente le nuove funzionalità. Non è necessario intraprendere alcuna azione per rendere disponibili nuove funzionalità.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti più di 64 tabelle partizionate.
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti l'operatore Append.
+ È stato risolto un problema con QPM validate\$1plans con l'azione update\$1plan\$1hash.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 16.2
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 16.2 includono quanto segue:
**Nuove funzionalità**
+ QPM può applicare piani con operatori Aggregate.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema a causa del quale l'eliminazione di un database non comportava la rimozione dei piani acquisiti associati dalla memoria condivisa.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti visualizzazioni.
+ Miglioramenti nell'applicazione del piano Parallel Append.
+ È stato risolto un problema relativo all'acquisizione del piano.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti nodi di raccolta.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 16.1
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 16.1 includono quanto segue:
**Nuove funzionalità**
+ Le strutture del piano verranno aggiornate all'ultima versione del formato come parte dell'azione `update_plan_hash` per la funzione `apg_plan_mgmt.validate_plans`.
+ È stato aggiunto il supporto per l'applicazione parallela di Append come parte dell'applicazione delle query parallele. Per applicare correttamente i nodi di aggiunta paralleli, è necessario completare le seguenti operazioni:
1. Imposta `apg_plan_mgmt.plan_hash_version` su 5.
1. Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Miglioramenti aggiuntivi**
+ Miglioramento delle prestazioni nel calcolo dell'hash del piano.
+ È stato migliorato l'utilizzo della memoria per le strutture dei piani che contengono piani secondari ripetitivi.
+ È stato risolto un problema nell'applicazione delle query parallele in cui `GatherMerge` non veniva applicato.
+ È stato risolto un problema a causa del quale il costo stimato del piano applicato non era corretto.
+ È stato risolto un problema relativo all'applicazione dei piani approvati in cui la struttura conteneva tabelle e piani secondari partizionati.
## Versioni di PostgreSQL 15
**Topics**
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 15.17, 6 aprile 2026](#auroraqpm-version15-1517)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 15.15, 18 dicembre 2025](#auroraqpm-version15-1515)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 15.13, 30 giugno 2025](#auroraqpm-version15-1513)
+ [apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 15.12, 8 aprile 2025](#auroraqpm-version15-1512)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 15.10, 27 dicembre 2024](#auroraqpm-version15-1510)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 15.8, 30 settembre 2024](#auroraqpm-version15-158)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 15.7, 8 agosto 2024](#auroraqpm-version15-157)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 15.6](#auroraqpm-version15-156)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 15.5](#auroraqpm-version15-155)
+ [apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 15.4](#auroraqpm-version15-154)
+ [apg\$1plan\$1mgmt versione 2.4 per Aurora PostgreSQL 15.3](#auroraqpm-version15-153)
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 15.17, 6 aprile 2026
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 15.17 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato risolto un problema in Query Plan Management che impediva l'acquisizione dei piani.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 15.15, 18 dicembre 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 15.15 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato aggiunto un miglioramento nella gestione del piano di query per recuperare automaticamente gli elenchi di parametri archiviati dalle versioni precedenti.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 15.13, 30 giugno 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 15.13 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione delle scansioni bitmap parallele quando è presente un operatore. BitmapOr/BitmapAnd
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione dei piani in cui più partizioni di tabella venivano unite a un'unica partizione di tabella.
+ È stato risolto un problema nella gestione del piano di query con l'applicazione dei nodi Append su una singola partizione di tabella.
+ Il `apg_plan_mgmt` ruolo nella gestione del piano di query è riservato e non può più essere creato, modificato o eliminato dagli utenti.
+ È stato risolto un problema nella gestione degli elenchi di parametri delle versioni precedenti della gestione dei piani di query.
### apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 15.12, 8 aprile 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.8 per Aurora PostgreSQL 15.12 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'elenco dei parametri che causava un errore o il riavvio durante l'interrogazione, la `dba_plans` visualizzazione o la chiamata `validate_plans` e `evolve_plan_baselines` le funzioni nella gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione di piani ottimizzati correlando qualsiasi trasformazione nella gestione del piano di Query.
+ È stato risolto un problema nella gestione del piano di query relativo all'esecuzione di un'istruzione di utilità subito dopo l'installazione dell'estensione o il ripristino della memoria condivisa.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani per le query con chiamate a funzioni immutabili nella gestione dei piani di query.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani nella gestione dei piani di Query.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 15.10, 27 dicembre 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 15.10 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'acquisizione del piano sulla replica nella gestione del piano di query, a causa del quale l'array di memoria condivisa nella replica si esauriva.
+ È stato risolto un problema con il Query Plan Management Background Worker che impediva l'applicazione del periodo di conservazione del piano e l'aggiornamento della data dell'ultimo utilizzo.
+ È stato risolto un problema relativo al lavoro in background per la gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione dei piani di gestione dei piani di query contenenti scansioni bitmap.
+ È stato risolto un problema relativo alla gestione dei piani di interrogazione a causa del quale i piani venivano acquisiti in modo errato per funzioni o procedure con più query.
+ È stato risolto un problema relativo all'acquisizione dei piani di esecuzione delle query annidate nella gestione dei piani di query.
+ È stato risolto un problema relativo all'acquisizione dei piani nella gestione dei piani di query con il protocollo di query esteso.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 15.8, 30 settembre 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 15.8 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione dei piani di gestione dei piani di query contenenti Hash Aggregates.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 15.7, 8 agosto 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 15.7 includono quanto segue:
**Nuove funzionalità**
+ Non è più necessario aggiornare il. `plan_hash_version` Dopo l'aggiornamento del motore di database, QPM abilita automaticamente le nuove funzionalità. Non è necessario intraprendere alcuna azione per rendere disponibili nuove funzionalità.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti più di 64 tabelle partizionate.
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti l'operatore Append.
+ È stato risolto un problema con QPM validate\$1plans con l'azione update\$1plan\$1hash.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 15.6
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 15.6 includono quanto segue:
**Nuove funzionalità**
+ QPM può applicare piani con operatori Aggregate.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema a causa del quale l'eliminazione di un database non comportava la rimozione dei piani acquisiti associati dalla memoria condivisa.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti visualizzazioni.
+ Miglioramenti nell'applicazione del piano Parallel Append.
+ È stato risolto un problema relativo all'acquisizione del piano.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti nodi di raccolta.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 15.5
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 15.5 includono quanto segue:
**Nuove funzionalità**
+ Le strutture del piano verranno aggiornate all'ultima versione del formato come parte dell'azione `update_plan_hash` per la funzione `apg_plan_mgmt.validate_plans`.
+ È stato aggiunto il supporto per l'applicazione parallela di Append come parte dell'applicazione delle query parallele. Per applicare correttamente i nodi di aggiunta paralleli, è necessario completare le seguenti operazioni:
1. Imposta `apg_plan_mgmt.plan_hash_version` su 5.
1. Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Miglioramenti aggiuntivi**
+ Miglioramento delle prestazioni nel calcolo dell'hash del piano.
+ È stato migliorato l'utilizzo della memoria per le strutture dei piani che contengono piani secondari ripetitivi.
+ È stato risolto un problema nell'applicazione delle query parallele in cui `GatherMerge` non veniva applicato.
+ È stato risolto un problema a causa del quale il costo stimato del piano applicato non era corretto.
+ È stato risolto un problema relativo all'applicazione dei piani approvati in cui la struttura conteneva tabelle e piani secondari partizionati.
### apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 15.4
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.5 per Aurora PostgreSQL 15.4 includono quanto segue:
**Nuove funzionalità**
+ QPM può imporre ai piani di query di avere operatori paralleli ad eccezione del nodo Parallel Append. Per applicare correttamente i piani di query parallele, devi effettuare le seguenti operazioni dopo l'aggiornamento alla versione 15.4 o 14.9:
+ Imposta `apg_plan_mgmt.plan_hash_version` su 4 o a un valore superiore.
+ Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Riacquisisci i piani approvati con il nodo Gather in plan\$1outline.
+ QPM può applicare piani di query con i nodi Materialise. Per applicare i nodi Materialise, devi effettuare le seguenti operazioni dopo l'aggiornamento alla versione 15.4 o 14.9:
+ Imposta `apg_plan_mgmt.plan_hash_version` su 4 o a un valore superiore.
+ Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Per acquisire i piani di query dalle repliche, devi aggiornare l'estensione `apg_plan_mgmt` chiamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ Per non consentire a QPM di acquisire alcun piano di query, devi specificare `apg_plan_mgmt.plan_capture_threshold`.
**Miglioramenti aggiuntivi**
+ Miglioramento delle prestazioni di calcolo. `plan_hash`
### apg\$1plan\$1mgmt versione 2.4 per Aurora PostgreSQL 15.3
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.4 per Aurora PostgreSQL 15.3 includono quanto segue:
**Nuove funzionalità**
+ È stato introdotto un nuovo parametro GUC auto\$1explain.hashes. Quando è impostato su true (valore predefinito: false), sql\$1hash e plan\$1hash vengono mostrati alla fine del risultato della spiegazione automatica.
+ È stato introdotto un nuovo parametro GUC apg\$1plan\$1mgmt.explain\$1hashes. Quando è impostato su true (impostazione predefinita: false), il risultato EXPLAIN mostra sql\$1hash e plan\$1hash anche senza l'opzione true degli hash.
+ È stato introdotto un nuovo parametro GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. A seconda del valore (predefinito: none), i risultati dell'applicazione del piano vengono scritti nei file di log di Postgres.
+ È stata introdotta una nuova versione di calcolo dell'hash del piano per supportare le tabelle partizionate. Gli utenti devono impostare apg\$1plan\$1mgmt.plan\$1hash\$1version su 3 e chiamare apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') in ogni database con `apg_plan_mgmt` installato e le voci nella tabella dei piani.
+ QPM può applicare piani di query con i nodi Memoize.
+ La funzione `apg_plan_mgmt.copy_outline` può accettare un nuovo quinto argomento, `force_update_target_plan_hash`. Se è impostato su true, l'hash del piano di destinazione verrà aggiornato anche se il piano di origine non è riproducibile per il piano sql\$1hash di destinazione.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione del piano delle istruzioni preparato da JDBC.
+ Parità migliorata per quanto riguarda queryid tra pg\$1stat\$1statements e apg\$1plan\$1mgmt.dba\$1plans.
+ È stato risolto un problema di applicazione del piano quando i nomi degli indici terminano con delle cifre.
+ La funzione apg\$1plan\$1mgmt.copy\$1outline ora copia environment\$1variables.
+ Il valore minimo di apg\$1plan\$1mgmt.plan\$1retention\$1period è stato modificato a 1 da 32.
+ La gestione del piano di query può ora salvare i piani per le query in transazioni di sola lettura dai nodi di scrittura.
+ È stato risolto un problema nella funzione apg\$1plan\$1mgmt.evolve\$1plan\$1baselines.
+ È stato risolto un problema che poteva causare l'indisponibilità quando è abilitata apg\$1plan\$1mgmt.
Per informazioni su come installare, aggiornare e utilizzare l'`apg_plan_mgmt`estensione , consulta la sezione [Gestione dei piani di esecuzione delle query per Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) nella *Guida per l'utente di Amazon Aurora*.
## Versioni di PostgreSQL 14
**Topics**
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 14.22, 6 aprile 2026](#auroraqpm-version14-1422)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 14.20, 18 dicembre 2025](#auroraqpm-version14-1420)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 14.18, 30 giugno 2025](#auroraqpm-version14-1418)
+ [apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 14.17, 8 aprile 2025](#auroraqpm-version14-1417)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 14.15, 27 dicembre 2024](#auroraqpm-version14-1415)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 14.12, 8 agosto 2024](#auroraqpm-version14-1412)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 14.11](#auroraqpm-version14-1411)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 14.10](#auroraqpm-version14-1410)
+ [apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 14.9](#auroraqpm-version14-149)
+ [apg\$1plan\$1mgmt versione 2.4 per Aurora PostgreSQL 14.8](#auroraqpm-version14-148)
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 14.22, 6 aprile 2026
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 14.22 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato risolto un problema in Query Plan Management che impediva l'acquisizione dei piani.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 14.20, 18 dicembre 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 14.20 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato aggiunto un miglioramento nella gestione del piano di query per recuperare automaticamente gli elenchi di parametri archiviati dalle versioni precedenti.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 14.18, 30 giugno 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 14.18 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione delle scansioni bitmap parallele quando è presente un operatore. BitmapOr/BitmapAnd
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione dei piani in cui più partizioni di tabella venivano unite a un'unica partizione di tabella.
+ È stato risolto un problema nella gestione del piano di query con l'applicazione dei nodi Append su una singola partizione di tabella.
+ Il `apg_plan_mgmt` ruolo nella gestione del piano di query è riservato e non può più essere creato, modificato o eliminato dagli utenti.
+ È stato risolto un problema nella gestione degli elenchi di parametri delle versioni precedenti della gestione dei piani di query.
### apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 14.17, 8 aprile 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.8 per Aurora PostgreSQL 14.17 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'elenco dei parametri che causava un errore o il riavvio durante l'interrogazione, la `dba_plans` visualizzazione o la chiamata `validate_plans` e `evolve_plan_baselines` le funzioni nella gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione di piani ottimizzati correlando qualsiasi trasformazione nella gestione del piano di Query.
+ È stato risolto un problema nella gestione del piano di query relativo all'esecuzione di un'istruzione di utilità subito dopo l'installazione dell'estensione o il ripristino della memoria condivisa.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani per le query con chiamate a funzioni immutabili nella gestione dei piani di query.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani nella gestione dei piani di Query.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 14.15, 27 dicembre 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 14.15 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'acquisizione del piano sulla replica nella gestione del piano di query, a causa del quale l'array di memoria condivisa nella replica si esauriva.
+ È stato risolto un problema con il Query Plan Management Background Worker che impediva l'applicazione del periodo di conservazione del piano e l'aggiornamento della data dell'ultimo utilizzo.
+ È stato risolto un problema relativo al lavoro in background per la gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione dei piani di gestione dei piani di query contenenti scansioni bitmap.
+ È stato risolto un problema relativo alla gestione dei piani di interrogazione a causa del quale i piani venivano acquisiti in modo errato per funzioni o procedure con più query.
+ È stato risolto un problema relativo all'acquisizione dei piani di esecuzione delle query annidate nella gestione dei piani di query.
+ È stato risolto un problema relativo all'acquisizione dei piani nella gestione dei piani di query con il protocollo di query esteso.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 14.12, 8 agosto 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 14.12 includono quanto segue:
**Nuove funzionalità**
+ Non è più necessario aggiornare il. `plan_hash_version` Dopo l'aggiornamento del motore di database, QPM abilita automaticamente le nuove funzionalità. Non è necessario intraprendere alcuna azione per rendere disponibili nuove funzionalità.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti più di 64 tabelle partizionate.
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti l'operatore Append.
+ È stato risolto un problema con QPM validate\$1plans con l'azione update\$1plan\$1hash.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 14.11
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 14.11 includono quanto segue:
**Nuove funzionalità**
+ QPM può applicare piani con operatori Aggregate.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema a causa del quale l'eliminazione di un database non comportava la rimozione dei piani acquisiti associati dalla memoria condivisa.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti visualizzazioni.
+ Miglioramenti nell'applicazione del piano Parallel Append.
+ È stato risolto un problema relativo all'acquisizione del piano.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti nodi di raccolta.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 14.10
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 14.10 includono quanto segue:
**Nuove funzionalità**
+ Le strutture del piano verranno aggiornate all'ultima versione del formato come parte dell'azione `update_plan_hash` per la funzione `apg_plan_mgmt.validate_plans`.
+ È stato aggiunto il supporto per l'applicazione parallela di Append come parte dell'applicazione delle query parallele. Per applicare correttamente i nodi di aggiunta paralleli, è necessario completare le seguenti operazioni:
1. Imposta `apg_plan_mgmt.plan_hash_version` su 5.
1. Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Miglioramenti aggiuntivi**
+ Miglioramento delle prestazioni nel calcolo dell'hash del piano.
+ È stato migliorato l'utilizzo della memoria per le strutture dei piani che contengono piani secondari ripetitivi.
+ È stato risolto un problema nell'applicazione delle query parallele in cui `GatherMerge` non veniva applicato.
+ È stato risolto un problema a causa del quale il costo stimato del piano applicato non era corretto.
+ È stato risolto un problema relativo all'applicazione dei piani approvati in cui la struttura conteneva tabelle e piani secondari partizionati.
### apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 14.9
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.5 per Aurora PostgreSQL 14.9 includono quanto segue:
**Nuove funzionalità**
+ QPM può imporre ai piani di query di avere operatori paralleli ad eccezione del nodo Parallel Append. Per applicare correttamente i piani di query parallele, devi effettuare le seguenti operazioni dopo l'aggiornamento alla versione 15.4 o 14.9:
+ Imposta `apg_plan_mgmt.plan_hash_version` su 4 o a un valore superiore.
+ Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Riacquisisci i piani approvati con il nodo Gather in plan\$1outline.
+ QPM può applicare piani di query con i nodi Materialise. Per applicare i nodi Materialise, devi effettuare le seguenti operazioni dopo l'aggiornamento alla versione 15.4 o 14.9:
+ Imposta `apg_plan_mgmt.plan_hash_version` su 4 o a un valore superiore.
+ Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Per acquisire i piani di query dalle repliche, devi aggiornare l'estensione `apg_plan_mgmt` chiamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ Per non consentire a QPM di acquisire alcun piano di query, devi specificare `apg_plan_mgmt.plan_capture_threshold`.
**Miglioramenti aggiuntivi**
+ Miglioramento delle prestazioni di calcolo. `plan_hash`
### apg\$1plan\$1mgmt versione 2.4 per Aurora PostgreSQL 14.8
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.4 per Aurora PostgreSQL 14.8 includono quanto segue:
**Nuove funzionalità**
+ È stato introdotto un nuovo parametro GUC auto\$1explain.hashes. Quando è impostato su true (valore predefinito: false), sql\$1hash e plan\$1hash vengono mostrati alla fine del risultato della spiegazione automatica.
+ È stato introdotto un nuovo parametro GUC apg\$1plan\$1mgmt.explain\$1hashes. Quando è impostato su true (impostazione predefinita: false), il risultato EXPLAIN mostra sql\$1hash e plan\$1hash anche senza l'opzione true degli hash.
+ È stato introdotto un nuovo parametro GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. A seconda del valore (predefinito: none), i risultati dell'applicazione del piano vengono scritti nei file di log di Postgres.
+ È stata introdotta una nuova versione di calcolo dell'hash del piano per supportare le tabelle partizionate. Gli utenti devono impostare apg\$1plan\$1mgmt.plan\$1hash\$1version su 3 e chiamare apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') in ogni database con `apg_plan_mgmt` installato e le voci nella tabella dei piani.
+ QPM può applicare piani di query con i nodi Memoize.
+ La funzione `apg_plan_mgmt.copy_outline` può accettare un nuovo quinto argomento, `force_update_target_plan_hash`. Se è impostato su true, l'hash del piano di destinazione verrà aggiornato anche se il piano di origine non è riproducibile per il piano sql\$1hash di destinazione.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione del piano delle istruzioni preparato da JDBC.
+ Parità migliorata per quanto riguarda queryid tra pg\$1stat\$1statements e apg\$1plan\$1mgmt.dba\$1plans.
+ È stato risolto un problema di applicazione del piano quando i nomi degli indici terminano con delle cifre.
+ La funzione apg\$1plan\$1mgmt.copy\$1outline ora copia environment\$1variables.
+ Il valore minimo di apg\$1plan\$1mgmt.plan\$1retention\$1period è stato modificato a 1 da 32.
+ La gestione del piano di query può ora salvare i piani per le query in transazioni di sola lettura dai nodi di scrittura.
+ È stato risolto un problema nella funzione apg\$1plan\$1mgmt.evolve\$1plan\$1baselines.
+ È stato risolto un problema che poteva causare l'indisponibilità quando è abilitata apg\$1plan\$1mgmt.
Per informazioni su come installare, aggiornare e utilizzare l'`apg_plan_mgmt`estensione , consulta la sezione [Gestione dei piani di esecuzione delle query per Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) nella *Guida per l'utente di Amazon Aurora*.
## Versioni di PostgreSQL 13
**Topics**
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 13.23, 18 dicembre 2025](#auroraqpm-version13-1323)
+ [apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 13.21, 30 giugno 2025](#auroraqpm-version13-1321)
+ [apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 13.20, 8 aprile 2025](#auroraqpm-version13-1320)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 13.18, 27 dicembre 2024](#auroraqpm-version13-1318)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 13.15, 8 agosto 2024](#auroraqpm-version13-1315)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 13.14](#auroraqpm-version13-1314)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 13.13](#auroraqpm-version13-1313)
+ [apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 13.12](#auroraqpm-version13-1312)
+ [apg\$1plan\$1mgmt versione 2.4 per Aurora PostgreSQL 13.11](#auroraqpm-version13-1311)
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 13.23, 18 dicembre 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 13.23 includono quanto segue:
**Miglioramenti relativi alle estensioni**
+ È stato aggiunto un miglioramento nella gestione del piano di query per recuperare automaticamente gli elenchi di parametri archiviati dalle versioni precedenti.
### apg\$1plan\$1mgmt versione 2.9 per Aurora PostgreSQL 13.21, 30 giugno 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.9 per Aurora PostgreSQL 13.21 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione delle scansioni bitmap parallele quando è presente un operatore. BitmapOr/BitmapAnd
+ È stato risolto un problema nella gestione del piano di interrogazione con l'applicazione dei piani in cui più partizioni di tabella venivano unite a un'unica partizione di tabella.
+ È stato risolto un problema nella gestione del piano di query con l'applicazione dei nodi Append su una singola partizione di tabella.
+ Il `apg_plan_mgmt` ruolo in Query Plan Management è riservato e non può più essere creato, modificato o eliminato dagli utenti.
+ È stato risolto un problema nella gestione degli elenchi di parametri delle versioni precedenti di Query Plan Management.
### apg\$1plan\$1mgmt versione 2.8 per Aurora PostgreSQL 13.20, 8 aprile 2025
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.8 per Aurora PostgreSQL 13.20 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'elenco dei parametri che causava un errore o il riavvio durante l'interrogazione, la `dba_plans` visualizzazione o la chiamata `validate_plans` e `evolve_plan_baselines` le funzioni nella gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione di piani ottimizzati correlando qualsiasi trasformazione nella gestione del piano di Query.
+ È stato risolto un problema nella gestione del piano di query relativo all'esecuzione di un'istruzione di utilità subito dopo l'installazione dell'estensione o il ripristino della memoria condivisa.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani per le query con chiamate a funzioni immutabili nella gestione dei piani di query.
+ È stato risolto un problema relativo all'applicazione, alla convalida e all'evoluzione dei piani nella gestione dei piani di Query.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 13.18, 27 dicembre 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 13.18 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'acquisizione del piano sulla replica nella gestione del piano di query, a causa del quale l'array di memoria condivisa nella replica si esauriva.
+ È stato risolto un problema con il Query Plan Management Background Worker che impediva l'applicazione del periodo di conservazione del piano e l'aggiornamento della data dell'ultimo utilizzo.
+ È stato risolto un problema relativo al lavoro in background per la gestione del piano di query.
+ È stato risolto un problema relativo all'applicazione dei piani di gestione dei piani di query contenenti scansioni bitmap.
+ È stato risolto un problema relativo alla gestione dei piani di interrogazione a causa del quale i piani venivano acquisiti in modo errato per funzioni o procedure con più query.
+ È stato risolto un problema relativo all'acquisizione dei piani di esecuzione delle query annidate nella gestione dei piani di query.
+ È stato risolto un problema relativo all'acquisizione dei piani nella gestione dei piani di query con il protocollo di query esteso.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 13.15, 8 agosto 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 13.15 includono quanto segue:
**Nuove funzionalità**
+ Non è più necessario aggiornare il. `plan_hash_version` Dopo l'aggiornamento del motore di database, QPM abilita automaticamente le nuove funzionalità. Non è necessario intraprendere alcuna azione per rendere disponibili nuove funzionalità.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti più di 64 tabelle partizionate.
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti l'operatore Append.
+ È stato risolto un problema con QPM validate\$1plans con l'azione update\$1plan\$1hash.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 13.14
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 13.14 includono quanto segue:
**Nuove funzionalità**
+ QPM può applicare piani con operatori Aggregate.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema a causa del quale l'eliminazione di un database non comportava la rimozione dei piani acquisiti associati dalla memoria condivisa.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti visualizzazioni.
+ Miglioramenti nell'applicazione del piano Parallel Append.
+ È stato risolto un problema relativo all'acquisizione del piano.
+ È stato risolto un problema relativo all'applicazione dei piani contenenti nodi di raccolta.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 13.13
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 13.13 includono quanto segue:
**Nuove funzionalità**
+ Le strutture del piano verranno aggiornate all'ultima versione del formato come parte dell'azione `update_plan_hash` per la funzione `apg_plan_mgmt.validate_plans`.
+ È stato aggiunto il supporto per l'applicazione parallela di Append come parte dell'applicazione delle query parallele. Per applicare correttamente i nodi di aggiunta paralleli, è necessario completare le seguenti operazioni:
1. Imposta `apg_plan_mgmt.plan_hash_version` su 5.
1. Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
**Miglioramenti aggiuntivi**
+ Miglioramento delle prestazioni nel calcolo dell'hash del piano.
+ È stato migliorato l'utilizzo della memoria per le strutture dei piani che contengono piani secondari ripetitivi.
+ È stato risolto un problema nell'applicazione delle query parallele in cui `GatherMerge` non veniva applicato.
+ È stato risolto un problema a causa del quale il costo stimato del piano applicato non era corretto.
+ È stato risolto un problema relativo all'applicazione dei piani approvati in cui la struttura conteneva tabelle e piani secondari partizionati.
### apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 13.12
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.5 per Aurora PostgreSQL 13.12 includono quanto segue:
**Nuove funzionalità**
+ QPM può imporre ai piani di query di avere operatori paralleli ad eccezione del nodo Parallel Append. Per applicare correttamente i piani di query parallele, devi effettuare le seguenti operazioni dopo l'aggiornamento alla versione 15.4 o 14.9:
+ Imposta `apg_plan_mgmt.plan_hash_version` su 4 o a un valore superiore.
+ Chiama `apg_plan_mgmt.validate_plans('update_plan_hash')`.
+ Riacquisisci i piani approvati con il nodo Gather in plan\$1outline.
+ Per acquisire i piani di query dalle repliche, devi aggiornare l'estensione `apg_plan_mgmt` chiamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ Per non consentire a QPM di acquisire alcun piano di query, devi specificare `apg_plan_mgmt.plan_capture_threshold`.
### apg\$1plan\$1mgmt versione 2.4 per Aurora PostgreSQL 13.11
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.4 per Aurora PostgreSQL 13.11 includono quanto segue:
**Nuove funzionalità**
+ È stato introdotto un nuovo parametro GUC auto\$1explain.hashes. Quando è impostato su true (valore predefinito: false), sql\$1hash e plan\$1hash vengono mostrati alla fine del risultato della spiegazione automatica.
+ È stato introdotto un nuovo parametro GUC apg\$1plan\$1mgmt.explain\$1hashes. Quando è impostato su true (impostazione predefinita: false), il risultato EXPLAIN mostra sql\$1hash e plan\$1hash anche senza l'opzione true degli hash.
+ È stato introdotto un nuovo parametro GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. A seconda del valore (predefinito: none), i risultati dell'applicazione del piano vengono scritti nei file di log di Postgres.
+ È stata introdotta una nuova versione di calcolo dell'hash del piano per supportare le tabelle partizionate. Gli utenti devono impostare apg\$1plan\$1mgmt.plan\$1hash\$1version su 3 e chiamare apg\$1plan\$1mgmt.validate\$1plans('update\$1plan\$1hash') in ogni database con `apg_plan_mgmt` installato e le voci nella tabella dei piani.
+ La funzione `apg_plan_mgmt.copy_outline` può accettare un nuovo quinto argomento, `force_update_target_plan_hash`. Se è impostato su true, l'hash del piano di destinazione verrà aggiornato anche se il piano di origine non è riproducibile per il piano sql\$1hash di destinazione.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione del piano delle istruzioni preparato da JDBC.
+ È stato risolto un problema di applicazione del piano quando i nomi degli indici terminano con delle cifre.
+ La funzione apg\$1plan\$1mgmt.copy\$1outline ora copia environment\$1variables.
+ Il valore minimo di apg\$1plan\$1mgmt.plan\$1retention\$1period è stato modificato a 1 da 32.
+ La gestione del piano di query può ora salvare i piani per le query in transazioni di sola lettura dai nodi di scrittura.
+ È stato risolto un problema nella funzione apg\$1plan\$1mgmt.evolve\$1plan\$1baselines.
+ È stato risolto un problema che poteva causare l'indisponibilità quando è abilitata apg\$1plan\$1mgmt.
Per informazioni su come installare, aggiornare e utilizzare l'`apg_plan_mgmt`estensione , consulta la sezione [Gestione dei piani di esecuzione delle query per Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) nella *Guida per l'utente di Amazon Aurora*.
## Versioni di PostgreSQL 12
**Topics**
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 12.22, 27 dicembre 2024](#auroraqpm-version12-1222)
+ [apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 12.19, 8 agosto 2024](#auroraqpm-version12-1219)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 12.18](#auroraqpm-version12-1218)
+ [apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 12.17](#auroraqpm-version12-1217)
+ [apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 12.16](#auroraqpm-version12-1216)
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 12.22, 27 dicembre 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 12.22 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'acquisizione del piano sulla replica nella gestione del piano di query, a causa del quale l'array di memoria condivisa nella replica si esauriva.
+ È stato risolto un problema con il Query Plan Management Background Worker che impediva l'applicazione del periodo di conservazione del piano e l'aggiornamento della data dell'ultimo utilizzo.
+ È stato risolto un problema relativo al lavoro in background per la gestione del piano di query.
### apg\$1plan\$1mgmt versione 2.7 per Aurora PostgreSQL 12.19, 8 agosto 2024
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.7 per Aurora PostgreSQL 12.19 includono quanto segue:
**Nuove funzionalità**
+ Non è più necessario aggiornare il. `plan_hash_version` Dopo l'aggiornamento del motore di database, QPM abilita automaticamente le nuove funzionalità. Non è necessario intraprendere alcuna azione per rendere disponibili nuove funzionalità.
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti più di 64 tabelle partizionate.
+ È stato risolto un problema relativo all'applicazione dei piani QPM contenenti l'operatore Append.
+ È stato risolto un problema con QPM validate\$1plans con l'azione update\$1plan\$1hash.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 12.18
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 12.18 includono quanto segue:
**Miglioramenti aggiuntivi**
+ È stato risolto un problema relativo all'acquisizione del piano.
### apg\$1plan\$1mgmt versione 2.6 per Aurora PostgreSQL 12.17
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.6 per Aurora PostgreSQL 12.17 includono quanto segue:
**Nuove funzionalità**
+ Le strutture del piano verranno aggiornate all'ultima versione del formato come parte dell'azione `update_plan_hash` per la funzione `apg_plan_mgmt.validate_plans`.
### apg\$1plan\$1mgmt versione 2.5 per Aurora PostgreSQL 12.16
I miglioramenti all'`apg_plan_mgmt`estensione nella versione 2.5 per Aurora PostgreSQL 12.16 includono quanto segue:
**Nuove funzionalità**
+ Per acquisire i piani di query dalle repliche, devi aggiornare l'estensione `apg_plan_mgmt` chiamando ALTER EXTENSION apg\$1plan\$1mgmt UPDATE.
+ Per non consentire a QPM di acquisire alcun piano di query, devi specificare `apg_plan_mgmt.plan_capture_threshold`.
## Versione 2.3 dell'estensione apg\$1plan\$1mgmt di Aurora PostgreSQL
I miglioramenti all'estensione `apg_plan_mgmt` nella versione 2.3 includono quanto segue:
**Nuove caratteristiche dell'estensione**
+ Supporto per una nuova funzione, `apg_plan_mgmt.copy_outline`. Questa funzione consente di copiare un hash del piano e uno schema del piano da un hash SQL e un hash del piano a un altro. Utilizza questa funzione quando desideri copiare un piano che utilizza suggerimenti in altre istruzioni simili senza utilizzare l'istruzione hint in linea ad ogni occorrenza. Se la query di destinazione aggiornata genera un piano non valido, questa funzione restituisce un errore ed esegue il rollback dell'aggiornamento. Per ulteriori informazioni, consulta [Informazioni di riferimento sulle funzioni per la gestione del piano di query Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Functions.html#AuroraPostgreSQL.Optimize.Functions.copy_outline) nella *Guida per l'utente di Amazon Aurora*.
**Miglioramenti relativi alle estensioni**
+ La funzionalità di gestione del piano di query ora salva i piani per le query che si trovano all'interno di procedure e blocchi DO. Per le versioni di `apg_plan_mgmt` precedenti alla versione 2.3, questa era una limitazione.
Per informazioni su come installare, aggiornare e utilizzare l'`apg_plan_mgmt`estensione , consulta la sezione [Gestione dei piani di esecuzione delle query per Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) nella *Guida per l'utente di Amazon Aurora*.
## Versione 2.1 dell'estensione apg\$1plan\$1mgmt di Aurora PostgreSQL
I miglioramenti all'estensione `apg_plan_mgmt` nella versione 2.1per urora PostgreSQL 11.20 includono quanto segue:
**Nuove funzionalità delle estensioni in Aurora PostgreSQL 11.20**
+ È stato introdotto un nuovo parametro GUC apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result. A seconda del valore (predefinito: none), i risultati dell'applicazione del piano vengono scritti nei file di log di Postgres.
**Miglioramenti delle estensioni in Aurora PostgreSQL 11.20**
+ È stato risolto un problema relativo all'applicazione del piano delle istruzioni preparato da JDBC.
Per informazioni su come installare, aggiornare e utilizzare l'`apg_plan_mgmt`estensione , consulta la sezione [Gestione dei piani di esecuzione delle query per Aurora PostgreSQL](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.html) nella *Guida per l'utente di Amazon Aurora*.
## Versione 2.0 dell'estensione Aurora PostgreSQL apg\$1plan\$1mgmt
Le modifiche apportate all'estensione `apg_plan_mgmt` per la versione 2.0 includono le seguenti:
**Nuove caratteristiche dell'estensione**
1. È ora possibile gestire tutte le query all'interno delle funzioni SQL, a prescindere che contengano o meno parametri.
1. Ora puoi gestire tutte le interrogazioni all'interno delle PL/pgSQL funzioni, indipendentemente dal fatto che abbiano o meno parametri.
1. È ora possibile gestire tutte le query in piani generici, a prescindere che contengano o meno parametri. Per ulteriori informazioni sui piani generici e i piani personalizzati, consulta l'istruzione `PREPARE` nella [documentazione di PostgreSQL](https://www.postgresql.org/docs/current/sql-prepare.html).
1. È ora possibile utilizzare la gestione del piano di query per imporre l'uso di tipi specifici di metodi di aggregazione nei piani di query.
**Miglioramenti relativi alle estensioni**
1. È ora possibile salvare piani con una dimensione fino a 8 KB maggiore rispetto all'impostazione del parametro `max_worker_processes`. In precedenza, la dimensione massima del piano era di 8 KB.
1. Sono stati corretti bug per istruzioni preparate senza nome come quelle di JDBC.
1. In precedenza, quando si provava a eseguire `CREATE EXTENSION apg_plan_mgmt` quando non era caricato in `shared_preload_libraries`, la connessione back-end PostgreSQL veniva rimossa. Ora, viene stampato un messaggio di errore e la connessione non viene rimossa.
1. Il valore predefinito di `cardinality_error` in `apg_plan_mgmt.plans table` è NULL, ma può essere impostato su -1 durante la funzione `apg_plan_mgmt.evolve_plan_baselines`. NULL è ora utilizzato in modo coerente.
1. I piani vengono ora salvati per query che fanno riferimento a tabelle temporanee.
1. Il numero massimo predefinito di piani è aumentato da 1000 a 10000.
1. I seguenti parametri pgss sono obsoleti perché al posto di tali parametri deve essere utilizzata la modalità di acquisizione del piano automatica.
+ `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`
## Versione 1.0.1 dell'estensione Aurora PostgreSQL apg\$1plan\$1mgmt
Le modifiche all'estensione `apg_plan_mgmt` per la versione 1.0.1 includono le seguenti:
**Nuove caratteristiche dell'estensione**
1. La funzione `validate_plans` ha un nuovo valore `action` chiamato `update_plan_hash`. Questa azione aggiorna l'ID `plan_hash` per i piani che non possono essere riprodotti esattamente. Il valore `update_plan_hash` consente inoltre di correggere un piano riscrivendo l'SQL. Puoi registrare il piano buono come piano `Approved` per l'SQL di origine. Di seguito è riportato un esempio di utilizzo dell'azione `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. È disponibile una nuova funzione `get_explain_stmt` che genera il testo di una nuova istruzione `EXPLAIN` per l'istruzione SQL specificata. Essa include i parametri `sql_hash`, `plan_hash` e `explain_options`.
Il parametro `explain_options` può essere un elenco separato da virgole di opzioni `EXPLAIN` valide, come mostrato di seguito.
```
analyze,verbose,buffers,hashes,format json
```
Se il parametro `explain_options` è NULL o una stringa vuota, la funzione `get_explain_stmt` genera un'istruzione `EXPLAIN` semplice.
Per creare uno script `EXPLAIN` per il carico di lavoro o una parte di esso, utilizzare le opzioni `\a` , `\t` e `\o` per reindirizzare l'output a un file. Ad esempio, puoi creare uno script `EXPLAIN` per le istruzioni top-k (top-ranked) utilizzando la visualizzazione `pg_stat_statements` PostgreSQL ordinata in base al `total_time` in ordine `DESC`.
1. La posizione precisa dell'operatore query parallelo Gather è determinata dai costi e può variare sensibilmente nel tempo Per evitare che tali differenze invalidino l'intero piano, la gestione del piano di query calcola ora lo stesso `plan_hash` anche se gli operatori Gather si spostano in posizioni differenti nella struttura della pianificazione.
1. Il supporto viene aggiunto per le istruzioni non parametrizzate all'interno delle funzioni pl/pgsql.
1. Il sovraccarico si riduce quando l'estensione `apg_plan_mgmt` viene installata su più database nello stesso cluster, mentre si accede contemporaneamente a due o più database. Inoltre, in questa release viene risolto un bug nell'area che impediva di archiviare i piani nella memoria condivisa.
**Miglioramenti relativi alle estensioni**
1. Miglioramenti alla funzione `evolve_plan_baselines`.
1. La funzione `evolve_plan_baselines` calcola ora un parametro `cardinality_error` su tutti i nodi nel piano. Utilizzando questo parametro, è possibile identificare un qualsiasi piano in cui l'errore di stima della cardinalità è grave e la qualità del piano è più incerta. Le istruzioni a lunga esecuzione con valori `cardinality_error` elevati sono candidati a priorità elevata per l'ottimizzazione delle query.
1. I report generati da `evolve_plan_baselines` ora includono `sql_hash`, `plan_hash` e il piano `status`.
1. Ora è possibile consentire a `evolve_plan_baselines` di approvare in anticipo i piani `Rejected`.
1. Il significato di `speedup_factor` per `evolve_plan_baselines` ora è sempre relativo ai piani di base. Ad esempio, un valore di 1.1 ora indica una velocità del 10% superiore rispetto al piano di base. Un valore di 0.9 indica una velocità del 10% inferiore rispetto al piano di base. Il confronto viene effettuato utilizzando il solo tempo di esecuzione invece del tempo totale.
1. La funzione `evolve_plan_baselines` ora prepara la cache in un nuovo modo. Lo fa eseguendo il piano di base, quindi rieseguendo il piano di base, infine eseguendo una volta il piano candidato. In precedenza, `evolve_plan_baselines` eseguiva il piano candidato due volte. Questo approccio viene aggiunto significativamente al tempo di esecuzione, specialmente per i piani candidati lenti. Tuttavia, l'esecuzione doppia del piano candidato è più affidabile quando il piano candidato un indice non utilizzato nel piano di base.
1. La gestione del piano di query non salva più i piani che si riferiscono alle viste o alle tabelle del sistema, alle tabelle temporanee o alle tabelle proprie della gestione del piano di query.
1. Le correzioni dei bug includono la memorizzazione immediata di un piano nella cache una volta salvato e la correzione di un bug che causava la chiusura del back-end.