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à. # Documentazione di riferimento dei parametri per la gestione del piano di query Aurora PostgreSQL È possibile impostare le preferenze per l’estensione `apg_plan_mgmt` utilizzando i parametri elencati in questa sezione. Questi sono disponibili nel parametro del cluster database personalizzato e nel gruppo di parametri DB associato al cluster database Aurora PostgreSQL. Questi parametri controllano il comportamento della funzionalità di gestione del piano di query e in che modo influenza l'ottimizzatore. Per informazioni su come impostare la gestione del piano di query, consulta [Attivazione della gestione del piano di query per Aurora PostgreSQL](AuroraPostgreSQL.Optimize.overview.md#AuroraPostgreSQL.Optimize.Enable). La modifica dei seguenti parametri non ha effetto se l’estensione `apg_plan_mgmt` non è impostata come descritto in tale sezione. Per informazioni sulla modifica dei parametri, consulta [Modifica dei parametri in un gruppo di parametri del cluster DB in Amazon Aurora](USER_WorkingWithParamGroups.ModifyingCluster.md) e [Gruppi di parametri database per istanze database Amazon Aurora](USER_WorkingWithDBInstanceParamGroups.md). **Topics** + [apg\$1plan\$1mgmt.capture\$1plan\$1baselines](#AuroraPostgreSQL.Optimize.Parameters.capture_plan_baselines) + [apg\$1plan\$1mgmt.plan\$1capture\$1threshold](#AuroraPostgreSQL.Optimize.Parameters.plan_capture_threshold) + [apg\$1plan\$1mgmt.explain\$1hashes](#AuroraPostgreSQL.Optimize.Parameters.explain_hashes) + [apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result](#AuroraPostgreSQL.Optimize.Parameters.log_plan_enforcement_result) + [apg\$1plan\$1mgmt.max\$1databases](#AuroraPostgreSQL.Optimize.Parameters.max_databases) + [apg\$1plan\$1mgmt.max\$1plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans) + [apg\$1plan\$1mgmt.plan\$1hash\$1version](#AuroraPostgreSQL.Optimize.Parameters.plan_hash_version) + [apg\$1plan\$1mgmt.plan\$1retention\$1period](#AuroraPostgreSQL.Optimize.Parameters.plan_retention_period) + [apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold](#AuroraPostgreSQL.Optimize.Parameters.unapproved_plan_execution_threshold) + [apg\$1plan\$1mgmt.use\$1plan\$1baselines](#AuroraPostgreSQL.Optimize.Parameters.use_plan_baselines) + [auto\$1explain.hashes](#AuroraPostgreSQL.Optimize.Parameters.auto_explain.hashes) ## apg\$1plan\$1mgmt.capture\$1plan\$1baselines Acquisisce i piani di esecuzione delle query generati dall'ottimizzatore per ogni istruzione SQL e li memorizza nella vista `dba_plans`. Per impostazione predefinita, il numero massimo di piani che è possibile memorizzare è 10.000, come specificato dal parametro `apg_plan_mgmt.max_plans`. Per informazioni di riferimento, consulta [apg\$1plan\$1mgmt.max\$1plans](#AuroraPostgreSQL.Optimize.Parameters.max_plans). Questo parametro può essere impostato nel gruppo di parametri del cluster database personalizzato o nel gruppo di parametri DB personalizzato. La modifica del valore di questo parametro non richiede un riavvio. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) Per ulteriori informazioni, consulta [Acquisizione dei piani di esecuzione Aurora PostgreSQL](AuroraPostgreSQL.Optimize.CapturePlans.md). ## apg\$1plan\$1mgmt.plan\$1capture\$1threshold Specifica una soglia in modo che se il costo totale del piano di esecuzione delle query è inferiore alla soglia, il piano non venga acquisito nella vista `apg_plan_mgmt.dba_plans`. La modifica del valore di questo parametro non richiede un riavvio. | Predefinita | Valori consentiti | Description | | --- | --- | --- | | 0 | 0 - 1.79769e\$1308 | Imposta la soglia del costo totale di esecuzione del piano di query `apg_plan_mgmt` per l'acquisizione dei piani. | Per ulteriori informazioni, consulta [Esame dei piani di query Aurora PostgreSQL nella vista dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md). ## apg\$1plan\$1mgmt.explain\$1hashes Specifica se `EXPLAIN [ANALYZE]` mostra `sql_hash` e `plan_hash` alla fine del relativo output. La modifica del valore di questo parametro non richiede un riavvio. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) ## apg\$1plan\$1mgmt.log\$1plan\$1enforcement\$1result Specifica se i risultati devono essere registrati per verificare se i piani gestiti dalla funzionalità di gestione dei piani di query vengono utilizzati correttamente. Quando viene utilizzato un piano generico archiviato, non verrà scritto alcun record nei file di log. La modifica del valore di questo parametro non richiede un riavvio. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) ## apg\$1plan\$1mgmt.max\$1databases Specifica il numero massimo di database sull'istanza di scrittura del cluster database Aurora PostgreSQL che possono utilizzare la gestione del piano di query. L'impostazione predefinita è 10 database. Se sull'istanza sono presenti più di 10 database, il valore dell'impostazione può essere modificato. Per scoprire quanti database sono presenti in una determinata istanza, connettersi all'istanza utilizzando `psql`. Quindi, utilizzare il metacomando psql, `\l`, per elencare i database. La modifica del valore di questo parametro richiede il riavvio dell'istanza affinché l'impostazione diventi effettiva. | Predefinita | Valori consentiti | Description | | --- | --- | --- | | 10 | 10-2147483647 | Numero massimo di database che possono utilizzare la gestione del piano di query sull’istanza. | Questo parametro può essere impostato nel gruppo di parametri del cluster database personalizzato o nel gruppo di parametri DB personalizzato. ## apg\$1plan\$1mgmt.max\$1plans Imposta il numero massimo di istruzioni SQL che il gestore del piano di query può mantenere nella visualizzazione `apg_plan_mgmt.dba_plans`. Si consiglia di impostare questo parametro su `10000` o superiore per tutte le versioni di Aurora PostgreSQL. Questo parametro può essere impostato nel gruppo di parametri del cluster database personalizzato o nel gruppo di parametri DB personalizzato. La modifica del valore di questo parametro richiede il riavvio dell'istanza affinché l'impostazione diventi effettiva. | Predefinita | Valori consentiti | Description | | --- | --- | --- | | 10000 | 10-2147483647 | Numero massimo di piani che possono essere archiviati nella vista `apg_plan_mgmt.dba_plans`. Il valore predefinito per Aurora PostgreSQL versione 10 e versioni precedenti è 1000. | Per ulteriori informazioni, consulta [Esame dei piani di query Aurora PostgreSQL nella vista dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md). ## apg\$1plan\$1mgmt.plan\$1hash\$1version Specifica i casi d'uso che il calcolo plan\$1hash è progettato per coprire. Una versione superiore di `apg_plan_mgmt.plan_hash_version` copre tutte le funzionalità della versione inferiore. Ad esempio, la versione 3 copre i casi d'uso supportati dalla versione 2. La modifica del valore di questo parametro deve essere seguita da una chiamata a `apg_plan_mgmt.validate_plans('update_plan_hash')`. Aggiorna i valori plan\$1hash in ogni database con apg\$1plan\$1mgmt installato e le voci nella tabella dei piani. Per ulteriori informazioni, consulta [Convalida dei piani](AuroraPostgreSQL.Optimize.Deleting.md#AuroraPostgreSQL.Optimize.Maintenance.ValidatingPlans) [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) ## apg\$1plan\$1mgmt.plan\$1retention\$1period Specifica il numero di giorni per cui si desidera mantenere i piani nella vista `apg_plan_mgmt.dba_plans` prima che vengano eliminati automaticamente. Per impostazione predefinita, un piano viene eliminato quando sono trascorsi 32 giorni dall'ultimo utilizzo del piano (la colonna `last_used` nella vista `apg_plan_mgmt.dba_plans`). Questa impostazione può essere modificata in un numero qualsiasi, 1 e valori superiori. La modifica del valore di questo parametro richiede il riavvio dell'istanza affinché l'impostazione diventi effettiva. | Predefinita | Valori consentiti | Description | | --- | --- | --- | | 32 | 1-2147483647 | Numero massimo di giorni dall'ultimo utilizzo di un piano prima che venga eliminato. | Per ulteriori informazioni, consulta [Esame dei piani di query Aurora PostgreSQL nella vista dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md). ## apg\$1plan\$1mgmt.unapproved\$1plan\$1execution\$1threshold Specifica una soglia di costo al di sotto della quale un piano non approvato può essere utilizzato dall'ottimizzatore. La soglia è 0 per impostazione predefinita, in modo che l'ottimizzatore non esegua piani non approvati. L'impostazione di questo parametro su una soglia di costo estremamente bassa, ad esempio 100, evita il sovraccarico di applicazione del piano nei piani banali. È inoltre possibile impostare questo parametro su un valore estremamente elevato, ad esempio 10000000, utilizzando lo stile reattivo di gestione del piano. Ciò consente all'ottimizzatore di utilizzare tutti i piani scelti senza generare sovraccarichi dovuti all'applicazione del piano. Tuttavia, quando viene trovato un piano errato, è possibile contrassegnarlo manualmente come "rejected" in modo che non venga utilizzato la volta successiva. Il valore di questo parametro rappresenta una stima dei costi per l'esecuzione di un determinato piano. Se il costo di un piano non approvato è inferiore a tale costo stimato, verrà utilizzato dall'ottimizzatore per l'istruzione SQL. I piani acquisiti e il relativo stato (Approvato, Non approvato) sono visibili nella vista `dba_plans`. Per ulteriori informazioni, consulta [Esame dei piani di query Aurora PostgreSQL nella vista dba\$1plans](AuroraPostgreSQL.Optimize.ViewPlans.md). La modifica del valore di questo parametro non richiede un riavvio. | Predefinita | Valori consentiti | Description | | --- | --- | --- | | 0 | 0-2147483647 | Costo del piano stimato al di sotto del quale viene utilizzato un piano non approvato. | Per ulteriori informazioni, consulta [Utilizzo dei piani gestiti per Aurora PostgreSQL](AuroraPostgreSQL.Optimize.UsePlans.md). ## apg\$1plan\$1mgmt.use\$1plan\$1baselines Specifica che l'ottimizzatore deve utilizzare uno dei piani approvati acquisiti e archiviati nella vista `apg_plan_mgmt.dba_plans`. Per impostazione predefinita, questo parametro è disattivato (false). Di conseguenza, l'ottimizzatore utilizzerà il piano a costo minimo che genera senza un'ulteriore valutazione. L'attivazione di questo parametro (impostandolo su true) obbliga l'ottimizzatore a scegliere un piano di esecuzione della query per l'istruzione dalla sua baseline del piano. Per ulteriori informazioni, consulta [Utilizzo dei piani gestiti per Aurora PostgreSQL](AuroraPostgreSQL.Optimize.UsePlans.md). Per trovare un'immagine che descrive questo processo, consulta [In che modo l'ottimizzatore sceglie quale piano eseguire.](AuroraPostgreSQL.Optimize.UsePlans.md#AuroraPostgreSQL.Optimize.UsePlans.ChoosePlans). Questo parametro può essere impostato nel gruppo di parametri del cluster database personalizzato o nel gruppo di parametri DB personalizzato. La modifica del valore di questo parametro non richiede un riavvio. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html) I tempi di risposta dei diversi piani acquisiti possono essere valutati e lo stato del piano modificato, in base alle esigenze. Per ulteriori informazioni, consulta [Miglioramento dei piani di query di Aurora PostgreSQL](AuroraPostgreSQL.Optimize.Maintenance.md). ## auto\$1explain.hashes Specifica se l'output di auto\$1explain mostra sql\$1hash e plan\$1hash. La modifica del valore di questo parametro non richiede un riavvio. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/AmazonRDS/latest/AuroraUserGuide/AuroraPostgreSQL.Optimize.Parameters.html)