PostgreSQL TimescaleDB settings
PostgreSQL TimescaleDB settings affect the performance of the database cluster. When you create a PostgreSQL TimescaleDB database cluster, the values for all settings are set automatically. The values are selected to ensure high cluster performance and vary depending on the cluster configuration and PostgreSQL version.
If the automatic values are not suitable for your application, set your own values at cluster creation or change settings in an already created cluster.
We recommend that you change the settings only when necessary — incorrect values can reduce cluster performance. When scaling the cluster, some settings are automatically replaced with valid values.
View list of settings
See a detailed description of the settings in official PostgreSQL documentation.
You can view a list of settings that can be changed by cluster creation or customization.
If you have changed settings, you can see a list of all changes.
- В control panels go to Cloud platform → Databases.
- Open the cluster page → tab Settings.
- In the block DBMS settings displays the previously changed settings — name and value.
Change settings
Changing some parameters in the settings causes the databases in the cluster to reboot — the cluster may be unavailable during this time. These settings depend on the version of PostgreSQL TimescaleDB — check them out list.
- В control panels go to Cloud platform → Databases.
- Open the cluster page → tab Settings.
- In the block DBMS settings click Modify and specify the new values.
- Click Save
List of settings that require a reboot
- autovacuum_freeze_max_age;
- autovacuum_max_workers;
- autovacuum_multixact_freeze_max_age;
- max_files_per_process;
- max_pred_locks_per_transaction;
- max_prepared_transactions;
- old_snapshot_threshold;
- track_activity_query_size;
- max_connections;
- max_locks_per_transaction;
- max_worker_processes;
- shared_buffers.
Settings when scaling a cluster
Any DBMS parameter has the limits of acceptable values. When cluster scaling (configuration change) values of some settings are automatically changed to valid values so that the cluster can operate.
When the cluster is scaled up and moves to status ACTIVE
you'll be able to set the new values — change settings.
A list of settings that change values when the cluster is scaled:
shared_buffers
;effective_cache_size
;maintenance_work_mem
;max_worker_processes
;max_parallel_workers
;autovacuum_max_workers
;vacuum_cost_limit
;max_parallel_workers_per_gather
;max_maintenance_workers
.