Параметры PostgreSQL

Параметры создания сервиса

Эти параметры указываются в качестве parameters в методе CreateService.

При создании нового сервиса нужно обязательно указать параметры, отмеченные как Необходимые.

Если выбранная версия PostgreSQL поддерживает другие параметры, то их можно задать внутри параметра options.

version

Версия СУБД.

Необходимо	Тип данных	Допустимые значения
Да	String	10 11 12 13 14 15

replication_mode

Режим репликации в кластере Patroni. Доступен только при выборе опции Отказоустойчивый сервис.

Необходимо	Тип данных	Допустимые значения
Да, если выбрана опция Отказоустойчивый сервис	String	asynchronous synchronous synchronous_strict

autovacuum

Параметр, который управляет состоянием демона, запускающего автоочистку.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	String	ON/OFF	ON	N/A

autovacuum_max_workers

Максимальное число процессов автоочистки, которые могут выполняться одновременно (не считая процесс, запускающий автоочистку).

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–262143	3	= vCPU, min 3

autovacuum_vacuum_cost_delay

Задержка в миллисекундах при превышении предела стоимости, которая будет применяться при автоматических операциях VACUUM.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	-1 1–100	20 (вер. 10-11) 2 (вер. 12+)	N/A

autovacuum_vacuum_cost_limit

Предел, который учитывается при автоматических операциях VACUUM.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	-1 1–10000	-1	N/A

autovacuum_analyze_scale_factor

Процент от размера таблицы, который будет добавляться к autovacuum_analyze_threshold при выборе порога срабатывания команды ANALYZE.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Float	0–100	0.1	N/A

autovacuum_vacuum_scale_factor

Процент от размера таблицы, который будет добавляться к autovacuum_vacuum_threshold при выборе порога срабатывания команды VACUUM.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Float	0–100	0.2	N/A

max_connections

Максимальное число одновременных подключений к серверу БД.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–262143	100	200 × vCPU

shared_buffers

Объём памяти, который будет использовать сервер баз данных под буферы в разделяемой памяти. Ознакомиться с описанием можно здесь.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	16–1073741823	1024	25% RAM

wal_keep_segments

Минимальное число файлов имеющихся сегментов журнала, которые будут сохраняться в каталоге pg_xlog, чтобы сервер мог выбрать их при потоковой репликации. Параметр актуален только для следующих версий PostgreSQL: 10, 11, 12.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–2147483647	0	4

min_wal_size

Пока WAL занимает на диске меньше этого объёма в байтах, старые файлы WAL в контрольных точках всегда повторно используются, а не удаляются.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	32–2147483647 МиБ	80 МиБ	5% диска, не более 1 ГиБ

max_wal_size

Максимальный размер в байтах, до которого может вырастать WAL во время автоматических контрольных точек.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	2–2147483647 МиБ	1 ГиБ	10% диска, не более 8 ГиБ

wal_buffers

Объём разделяемой памяти, который будет использоваться для буферизации данных WAL, ещё не записанных на диск. Указывается в виде целого числа, означающего количество юнитов размером 8 КиБ.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	8–262143	1/32 shared buffers, не менее 8 (64 КиБ), но не более размера одного сегмента WAL	N/A

effective_cache_size

Параметр, на основании которого планировщик оценивает эффективный размер дискового кеша, доступного для одного запроса. Подробнее здесь.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1–2147483647	524288	N/A

work_mem

Объём памяти в байтах, который будет использоваться для внутренних операций сортировки и хеш-таблиц, прежде чем будут задействованы временные файлы на диске.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	64–2147483647 КиБ	4 МиБ	N/A

maintenance_work_mem

Максимальный объём памяти в байтах для операций обслуживания БД (VACUUM, CREATE INDEX и ALTER TABLE ADD FOREIGN KEY).

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	1 МиБ–2 ГиБ	64 МиБ	N/A

effective_io_concurrency

Допустимое количество параллельных операций ввода/вывода.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–1000	1	N/A

max_worker_processes

Максимальное количество фоновых процессов, которое можно запустить в текущей системе.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–262143	8	= vCPU

max_parallel_workers_per_gather

Максимальное количество рабочих процессов, которые могут запускаться одним узлом Gather. Параллельные рабочие процессы берутся из пула процессов, контролируемого параметром max_worker_processes.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–1024	2	vCPU/2

max_parallel_maintenance_workers

Максимальное количество рабочих процессов, которые могут запускаться одной служебной командой. Параметр актуален только для PostgreSQL, начиная с версии 11 и выше.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–1024	2	vCPU/2

max_parallel_workers

Максимальное количество рабочих процессов, которое система сможет поддерживать для параллельных запросов.

Необходимо	Тип данных	Допустимые значения	По умолчанию	Auto
Нет	Integer	0–1024	8	= vCPU

monitoring

Подключение к сервису мониторинга.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Для всех сервисов, кроме Prometheus	Есть	Boolean	true false	false

monitor_by

Идентификатор сервиса мониторинга. Указанный сервис должен быть развёрнут в том же проекте, что и текущий сервис.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения
Да, если передан параметр monitoring = true. Если monitoring = false, передача параметра невозможна	Есть	String	ID сервиса мониторинга, расположенного в том же VPC, что и текущий сервис

monitoring_labels

Метки, которые будут назначены метрикам мониторируемого сервиса в сервисе мониторинга.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения
Нет. Если monitoring = false, передача параметра невозможна	Есть	Dict	Имя метки может содержать цифры, латинские буквы, символ подчёркивания. Значение метки может содержать любые ASCII-символы.

logging

Подключение к сервису логирования.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Для всех сервисов, кроме ELK и Prometheus	Есть	Boolean	true false	false

log_to

Идентификатор сервиса логирования. Логируемый сервис должен быть развёрнут в том же проекте, что и текущий сервис.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да, если передан параметр logging = true. Если logging = false, передача параметра невозможна	Есть	String	ID сервиса мониторинга, расположенного в том же VPC, что и текущий сервис

logging_tags

Теги, которые будут назначены записям журнала текущего сервиса в сервисе логирования.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет. Если logging = false, передача параметра невозможна	Есть	List of strings	Строка не более 256 символов

options

Контейнер для других параметров PostgreSQL.

Примечание

Если имя параметра включает точку, то его нельзя передать в контейнере для дополнительных параметров. Свяжитесь с технической поддержкой, если вам необходимо использовать такой параметр.

Необходимо	Тип данных	Допустимые значения
Нет	Dict	N/A

Параметры создания пользователя

Эти параметры указываются в поле parameters объекта User при передаче последнего в параметре users метода ModifyService.

Свойство Возможность редактирования указывает, возможно ли изменение значения параметра после создания пользователя.

password

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да	Есть	String	Не должен содержать символы ', ", ` и \	N/A

Параметры создания базы данных

Эти параметры указываются в поле parameters объекта Database при передаче последнего в параметре databases метода ModifyService.

Свойство Возможность редактирования указывает, возможно ли изменение значения параметра после создания базы данных.

С помощью параметров backup_id и backup_db_name осуществляется восстановление базы данных из имеющейся резервной копии. Информацию об имеющихся резервных копиях можно получить с помощью метода ListBackups.

owner

Имя пользователя, который является владельцем БД. Должен быть одним из существующих пользователей. Такого пользователя нельзя удалить, пока он является владельцем базы данных.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да	Есть	String	Существующий пользователь базы данных	N/A

locale

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Любое корректное значение кодировки	ru_RU.UTF-8

encoding

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Любое корректное значение кодировки	UTF8

extensions

Список расширений, которые будут активированы для данной БД.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Есть	Array of strings	address_standardizer address_standardizer_data_us amcheck autoinc bloom btree_gin btree_gist citext cube dblink dict_int dict_xsyn earthdistance fuzzystrmatch hstore intarray isn lo ltree moddatetime pg_buffercache pg_trgm pg_visibility pgcrypto pgrowlocks pgstattuple postgis postgis_tiger_geocoder postgis_topology postgres_fdw seg tablefunc tcn timescaledb tsm_system_rows tsm_system_time unaccent uuid-ossp xml2	N/A

backup_id

Идентификатор резервной копии базы данных.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Нет	Нет	String	Идентификатор существующей резервной копии базы данных	N/A

backup_db_name

Имя базы данных из резервной копии, указанной в параметре backup_id.

Необходимо	Возможность редактирования	Тип данных	Допустимые значения	По умолчанию
Да, если указан backup_id	Нет	String	Имя базы данных, содержащейся в резервной копии	N/A