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à.
Parametri di configurazione
È possibile configurare il comportamento e le prestazioni di analisi utilizzando i parametri di configurazione di PostgreSQL. È possibile impostare questi parametri a livello di sessione, database, utente o gruppo di parametri del cluster DB utilizzando i comandi PostgreSQL standard.
Argomenti
La tabella seguente elenca tutti i parametri di configurazione dell'analisi.
| Nome del parametro | Description | Predefinita | Modificabile da |
|---|---|---|---|
aurora_analytics.enabled |
Abilita l'estensione aurora_analytics |
false |
Gruppo di parametri |
aurora_analytics.query_mem |
(KB) Imposta la memoria massima che può essere utilizzata da una singola aurora_analytics query. |
Derivato (ad esempio, 4 GB) | Qualsiasi utente |
aurora_analytics.lowercase_unquoted_column_name |
Mette in minuscolo i nomi delle colonne senza virgolette quando si aurora_analytics deducono colonne di tabelle esterne. |
true |
Qualsiasi utente |
aurora_analytics.skip_unsupported_columns |
Ignora le colonne con tipi di dati non supportati o nomi in conflitto quando si deducono colonne di tabelle esterne. aurora_analytics |
false |
Qualsiasi utente |
aurora_analytics.enable_logging |
Abilita la registrazione peraurora_analytics. |
true |
rds_superuser |
aurora_analytics.logging_level |
Imposta la registrazione dettagliata per. aurora_analytics |
WARNING |
rds_superuser |
aurora_analytics.track_detailed_metrics |
Raccoglie metriche dettagliate sulle prestazioni per query per. aurora_analytics |
false |
Qualsiasi utente |
aurora_analytics.enabled
Abilita l'estensione. aurora_analytics
| Proprietà | Valore |
|---|---|
| Default (Predefinito) | false |
| Valori validi | true, false |
| Tipo | Booleano |
| Tipo di applicazione | Dinamico |
| Scope | DB cluster parameter group (Gruppo di parametri del cluster database) |
Questo parametro è lo switch principale per la funzionalità di analisi. Impostalo true nel gruppo di parametri del cluster DB per abilitare la funzionalità. Poiché si tratta di un parametro dinamico, la modifica viene applicata immediatamente senza riavvio. Una volta abilitata, è possibile installare l'estensione (CREATE EXTENSION aurora_analytics) in ogni database.
aurora_analytics.query_mem
(KB) Imposta la memoria massima che una singola query può utilizzare. aurora_analytics
| Proprietà | Valore |
|---|---|
| Default (Predefinito) | Derivato dalla memoria di istanza (ad esempio, 4 GB) |
| Valori validi | Stringa con unità (ad esempio'2GB','16GB') o numero intero in kilobyte (kB) |
| Tipo | Memoria |
| Contesto | User-settable |
| Scope | Sessione, utente, database, gruppo di parametri |
Questo parametro controlla la memoria massima che il motore di esecuzione dell'analisi alloca per l'elaborazione di una singola query. Questa memoria viene utilizzata per tabelle hash, ordinamento, buffer di aggregazione e risultati intermedi. È possibile specificare il valore come stringa con un suffisso unitario (ad esempio'4GB') o come numero intero in kilobyte (kB), dove 1 kB è 1024 byte, seguendo la convenzione di unità di memoria PostgreSQL.
Quando l'utilizzo della memoria di una query si avvicina a questo limite, il motore trasferisce i risultati intermedi nell'archiviazione locale temporanea. Lo spilling consente il completamento della query ma con prestazioni ridotte.
Calcolo predefinito
Aurora ricava l'impostazione predefinita dalla memoria dell'istanza, utilizzando il più piccolo dei tre termini:
query_mem = LEAST( 48 GiB, -- ceiling for the derived default DBInstanceClassMemory x 12.5%, -- lower bound on smaller instances DBInstanceClassMemory x 3.125% + 8 GiB -- lower bound on larger instances )
La tabella seguente mostra i valori predefiniti approssimativi per classe di istanza:
| Classe di istanza | Memoria di istanza | Impostazione predefinita query_mem |
|---|---|---|
db.r8gd.large |
16 GB | ~2 GB |
db.r8gd.xlarge |
32 GB | ~4 GB |
db.r8gd.2xlarge |
64 GB | ~8 GB |
db.r8gd.4xlarge |
128 GB | ~12 GB |
db.r8gd.8xlarge |
256 GB | ~16 GB |
db.r8gd.16xlarge |
512 GB | ~24 GB |
Questi valori sono approssimativi perché la derivazione utilizzaDBInstanceClassMemory, che è leggermente inferiore alla memoria nominale della classe di istanze.
Nota
SHOW aurora_analytics.query_memrestituisce il valore richiesto, non necessariamente il valore utilizzato dal motore. Il limite effettivo è limitato alla memoria dell'istanza meno la memoria riservata alle strutture condivise del motore. L'impostazione di un valore maggiore riesce, ma il motore utilizza ancora il valore limitato.
Quando aumentare questo valore:
-
Le query falliscono a causa di errori di memoria esaurita.
-
Si eseguono aggregazioni e join complessi che elaborano milioni di righe.
-
Sono in corso poche sessioni analitiche simultanee.
Quando diminuire questo valore:
-
Molti utenti simultanei eseguono interrogazioni analitiche.
-
Si osserva la pressione della memoria nell'istanza DB.
Esempi di utilizzo
Imposta limiti diversi per diversi ruoli utente:
-- Heavy analytics users ALTER USER data_scientist SET aurora_analytics.query_mem = '16GB'; -- Light reporting users ALTER USER dashboard_user SET aurora_analytics.query_mem = '8GB';
Utilizza un'impostazione a livello di sessione per una query complessa specifica:
SET aurora_analytics.query_mem = '16GB'; SELECT complex_aggregation FROM ft_large_table; RESET aurora_analytics.query_mem;
Nota
Come procedura ottimale, assicurati che concurrent_sessions x query_mem non superi circa il 30% della memoria dell'istanza.
aurora_analytics.lowercase_unquoted_column_name
Mette in minuscolo i nomi delle colonne senza virgolette quando si deducono colonne di tabelle esterne. aurora_analytics
| Proprietà | Valore |
|---|---|
| Default (Predefinito) | true |
| Valori validi | true, false |
| Tipo | Booleano |
| Contesto | User-settable |
| Scope | Sessione, utente, database, gruppo di parametri |
Quando Aurora PostgreSQL deduce lo schema di una tabella esterna (creata con parentesi vuote), legge i nomi delle colonne dai metadati Parquet o Iceberg. I file Parquet spesso contengono nomi di colonna composti da maiuscole e minuscole come o. OrderDate CustomerID
Se impostato su true (impostazione predefinita), i nomi delle colonne sono in minuscolo per seguire il comportamento degli identificatori senza virgolette standard di PostgreSQL. Ad esempio OrderDate diventa orderdate.
Se impostato su, i nomi di colonna composti da lettere maiuscole e minuscole vengono mantenuti. false È necessario utilizzare identificatori tra virgolette per farvi riferimento (ad esempio,). SELECT "OrderDate" FROM ft_orders
Nota
Lascia questo parametro impostato su true (impostazione predefinita) per un'esperienza PostgreSQL più naturale.
aurora_analytics.skip_unsupported_columns
Salta le colonne con tipi di dati non supportati o nomi in conflitto quando si deducono colonne di tabelle esterne. aurora_analytics
| Proprietà | Valore |
|---|---|
| Default (Predefinito) | false |
| Valori validi | true, false |
| Tipo | Booleano |
| Contesto | User-settable |
| Scope | Sessione, utente, database, gruppo di parametri |
Se impostato su false (impostazione predefinita), Aurora PostgreSQL genera un errore se rileva un tipo di colonna non supportato durante l'inferenza dello schema.
Quando è impostata su, le colonne non supportate vengono ignorate automaticamente. true La tabella esterna viene creata con solo le colonne supportate, permettendo di interrogare i dati rimanenti.
Imposta questo parametro su true quando i dati di origine contengono una combinazione di tipi di colonne supportati e non supportati e hai bisogno solo di un sottoinsieme di colonne.
aurora_analytics.enable_logging
Abilita la registrazione per. aurora_analytics
| Proprietà | Valore |
|---|---|
| Default (Predefinito) | true |
| Valori validi | true, false |
| Tipo | Booleano |
| Contesto | Solo rds_superuser |
| Scope | Sessione, utente, database, gruppo di parametri |
Se abilitato, il motore di analisi scrive messaggi di diagnostica nel log degli errori di PostgreSQL al livello di dettaglio specificato da. aurora_analytics.logging_level
aurora_analytics.logging_level
Imposta la registrazione dettagliata per. aurora_analytics
| Proprietà | Valore |
|---|---|
| Default (Predefinito) | WARNING |
| Valori validi | DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1, INFO, NOTICE, WARNING, ERROR, LOG, FATAL, PANIC |
| Tipo | Enum |
| Contesto | Solo rds_superuser |
| Scope | Sessione, utente, database, gruppo di parametri |
Questo parametro controlla la verbosità dei messaggi del motore di analisi scritti nel log degli errori di PostgreSQL. Usa DEBUG1 o superiore per la risoluzione dei problemi. Utilizza WARNING (impostazione predefinita) o ERROR per i carichi di lavoro di produzione per ridurre al minimo il volume dei registri.
Questo parametro deve aurora_analytics.enable_logging essere impostato su. true
aurora_analytics.track_detailed_metrics
Raccoglie metriche dettagliate sulle prestazioni per query per. aurora_analytics
| Proprietà | Valore |
|---|---|
| Default (Predefinito) | false |
| Valori validi | true, false |
| Tipo | Booleano |
| Contesto | User-settable |
| Scope | Sessione, utente, database, gruppo di parametri |
Se abilitata, Aurora PostgreSQL raccoglie metriche dettagliate per query, come i rapporti di accesso alla cache e le statistiche sul trasferimento dei dati. È possibile recuperare queste metriche utilizzando le funzioni di statistica di analisi.
Abilita questo parametro quando devi analizzare le prestazioni della cache o diagnosticare query lente. Per ulteriori informazioni, consulta Gestione delle risorse.
