18.4. Потребление ресурсов #
18.4.1. Память #
shared_buffers(integer) #Задаёт объём памяти, который будет использовать сервер баз данных для буферов в разделяемой памяти. По умолчанию это обычно 128 мегабайт (
128MB), но может быть и меньше, если конфигурация вашего ядра накладывает дополнительные ограничения (это определяется в процессе initdb). Это значение не должно быть меньше 128 килобайт. Однако для хорошей производительности обычно требуются гораздо большие значения. Если это значение задаётся без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Минимальное допустимое значение зависит от величиныBLCKSZ. Задать этот параметр можно только при запуске сервера.Если вы используете выделенный сервер с объёмом ОЗУ 1 ГБ и более, разумным начальным значением
shared_buffersбудет 25% от объёма памяти. Существуют варианты нагрузки, при которых эффективны будут и ещё большие значенияshared_buffers, но так как Postgres Pro использует и кеш операционной системы, выделять дляshared_buffersболее 40% ОЗУ вряд ли будет полезно. При увеличенииshared_buffersобычно требуется соответственно увеличитьmax_wal_size, чтобы растянуть процесс записи большого объёма новых или изменённых данных на более продолжительное время.В системах с объёмом ОЗУ меньше 1 ГБ стоит ограничиться меньшим процентом ОЗУ, чтобы оставить достаточно места операционной системе.
huge_pages(enum) #Определяет, будут ли огромные страницы запрашиваться из основной области общей памяти. Допустимые значения:
try(по умолчанию),onиoff. Задать этот параметр можно только при запуске сервера. Когда параметрhuge_pagesравенtry, сервер будет пытаться запрашивать огромные страницы, но если это ему не удастся, вернётся к стандартному поведению. Со значениемon, если получить огромные страницы не удастся, сервер не будет запущен. Со значениемoffбольшие страницы не будут запрашиваться. Фактическое состояние огромных страниц показывается серверной переменной huge_pages_status.В настоящее время это поддерживается в Linux и в Windows. В других системах значение
tryпросто игнорируется. В Linux эта поддержка обеспечивается, только когда параметрshared_memory_typeимеет значениеmmap(по умолчанию).В результате использования огромных страниц уменьшаются таблицы страниц, и процессор тратит меньше времени на управление памятью, что приводит к увеличению быстродействия. За более подробной информацией об использовании огромных страниц в Linux обратитесь к Подразделу 17.4.5.
Огромные страницы в Windows называются большими страницами. Чтобы использовать их, необходимо дать пользователю Windows, от имени которого работает Postgres Pro, право блокировать страницы. Для назначения пользователю этого права вы можете воспользоваться средством управления групповой политикой Windows (gpedit.msc). Чтобы сервер баз данных запускался в командной строке как отдельный процесс, а не как служба Windows, приглашение командной строки должно запускаться от имени администратора или должен быть отключён механизм UAC (User Access Control, Контроль учётных записей пользователей). Когда UAC включён, в обычном командном приглашении пользователь лишается права блокировать большие страницы в памяти.
Заметьте, что этот параметр влияет только на основную область общей памяти. В операционных системах, таких как Linux, FreeBSD и Illumos огромные страницы (также называемые «суперстраницами» или «большими» страницами) могут также автоматически использоваться при обычном выделении памяти, без явного запроса со стороны Postgres Pro. В Linux это называется «прозрачными огромными страницами» (Transparent Huge Pages, THP). Известно, что это приводит к снижению быстродействия Postgres Pro в некоторых системах Linux у ряда пользователей, поэтому использовать этот механизм в настоящее время не рекомендуется (в отличие от явного использования
huge_pages).huge_page_size(integer) #Задаёт размер огромных страниц, если их использование включено параметром huge_pages. Значение по умолчанию — ноль (
0). При таком значении будет использоваться размер огромных страниц, заданный в системе по умолчанию. Этот параметр можно установить только при запуске сервера.На современных 64-битных серверных платформах доступны, в частности, следующие размеры страниц:
2MBи1GB(Intel и AMD),16MBи16GB(IBM POWER), и64kB,2MB,32MBи1GB(ARM). Подробнее использование и администрирование огромных страниц освещается в Подразделе 17.4.5.Отличные от нуля значения в настоящее время поддерживаются только в Linux.
temp_buffers(integer) #Задаёт максимальный объём памяти, выделяемой для временных буферов в каждом сеансе. Эти существующие только в рамках сеанса буферы используются исключительно для работы с временными таблицами. Если это значение задаётся без единиц измерения, оно считается заданным в блоках (размер которых равен
BLCKSZбайт, обычно это 8 КБ). Значение по умолчанию — 8 мегабайт (8MB). (ЕслиBLCKSZотличен от 8 КБ, значение по умолчанию корректируется пропорционально.) Этот параметр можно изменить в отдельном сеансе, но только до первого обращения к временным таблицам; после этого изменения его значения не будут влиять на текущий сеанс.Сеанс выделяет временные буферы по мере необходимости до достижения предела, заданного параметром
temp_buffers. Если сеанс не задействует временные буферы, то для него хранятся только дескрипторы буферов, которые занимают около 64 байт (в количествеtemp_buffers). Однако если буфер действительно используется, он будет дополнительно занимать 8192 байта (илиBLCKSZбайт, в общем случае).max_prepared_transactions(integer) #Задаёт максимальное число транзакций, которые могут одновременно находиться в «подготовленном» состоянии (см. PREPARE TRANSACTION). При нулевом значении (по умолчанию) механизм подготовленных транзакций отключается. Задать этот параметр можно только при запуске сервера.
Если использовать транзакции не планируется, этот параметр следует обнулить, чтобы не допустить непреднамеренного создания подготовленных транзакций. Если же подготовленные транзакции применяются, то
max_prepared_transactions, вероятно, должен быть не меньше, чем max_connections, чтобы подготовить транзакцию можно было в каждом сеансе.Для ведомого сервера значение этого параметра должно быть больше или равно значению на ведущем. В противном случае на ведомом сервере не будут разрешены запросы.
work_mem(integer) #Задаёт базовый максимальный объём памяти, который будет использоваться во внутренних операциях при обработке запросов (например, для сортировки или хеш-таблиц), прежде чем будут задействованы временные файлы на диске. Если это значение задаётся без единиц измерения, оно считается заданным в килобайтах. Значение по умолчанию — четыре мегабайта (
4MB). Заметьте, что в сложных запросах одновременно могут выполняться несколько операций сортировки и хеширования, и при этом примерно этот объём памяти может использоваться в каждой операции, прежде чем данные начнут вытесняться во временные файлы. Кроме того, такие операции могут выполняться одновременно в разных сеансах. Таким образом, общий объём памяти может многократно превосходить значениеwork_mem; это следует учитывать, выбирая подходящее значение. Операции сортировки используются дляORDER BY,DISTINCTи соединений слиянием. Хеш-таблицы используются при соединениях и агрегировании по хешу, мемоизации узлов, а также обработке подзапросовINс применением хеша.Операции вычисления хеша обычно более требовательны к памяти, чем равнозначные им операции сортировки. Поэтому ограничение памяти для хеш-таблиц определяется произведением
work_memиhash_mem_multiplierи может превышать обычный базовый объёмwork_mem.Примечание
Планировщик Postgres Pro может некорректно оценить размер хеш-таблицы при операциях вычисления хеша. Если одна или несколько порций данных в хеш-таблице настолько большие, что не помещаются в выделенную память, превышая ограничение по памяти, и при этом данные в хеш-таблице невозможно поделить на большее количество порций, планировщик будет пытаться разместить каждую порцию в памяти, даже если её размер превышает упомянутое ограничение.
Таким образом, при операциях вычисления хеша для больших наборов данных потребление памяти может резко возрастать, если данные в полученных хеш-таблицах невозможно разделить на достаточное количество порций.
hash_mem_multiplier(floating point) #Используется для определения максимального объёма памяти, который может выделяться для операций с хешированием. Итоговый объём определяется произведением
work_memиhash_mem_multiplier. Значение по умолчанию равно 2.0, то есть для операций с хешированием может использоваться объём, вдвое превышающий базовое значениеwork_mem.Значение
hash_mem_multiplierимеет смысл увеличить, когда постоянно наблюдается вытеснение данных на диск при выполнении запросов, а прямолинейное увеличениеwork_memприводит к дефициту памяти (обычно проявляющемуся в ошибках «нехватка памяти»). В этих случаях действующее по умолчанию значение 2.0 обычно является оптимальным при смешанной нагрузке, а значения 2.0–8.0 могут быть эффективны там, гдеwork_memуже увеличено до 40 Мбайт или более.maintenance_work_mem(integer) #Задаёт максимальный объём памяти для операций обслуживания БД, в частности
VACUUM,CREATE INDEXиALTER TABLE ADD FOREIGN KEY. Если это значение задаётся без единиц измерения, оно считается заданным в килобайтах. Значение по умолчанию — 64 мегабайта (64MB). Так как в один момент времени в сеансе может выполняться только одна такая операция и обычно они не запускаются параллельно, это значение вполне может быть гораздо большеwork_mem. Увеличение этого значения может привести к ускорению операций очистки и восстановления БД из копии.Учтите, что когда выполняется автоочистка, этот объём может быть выделен autovacuum_max_workers раз, поэтому не стоит устанавливать значение по умолчанию слишком большим. Возможно, будет лучше управлять объёмом памяти для автоочистки отдельно, изменяя autovacuum_work_mem.
autovacuum_work_mem(integer) #Задаёт максимальный объём памяти, который будет использовать каждый рабочий процесс автоочистки. Если это значение задаётся без единиц измерения, оно считается заданным в килобайтах. При действующем по умолчанию значении
-1этот объём определяется значением maintenance_work_mem. Этот параметр не влияет на поведение командыVACUUM, выполняемой в других контекстах. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.vacuum_buffer_usage_limit(integer) #Указывает размер стратегии доступа к буферам, используемой командами
VACUUMиANALYZE. Значение0позволит операции использовать любое количествоshared_buffers. В противном случае допустимые размеры варьируются от128 kBдо16 GB. Если указанный размер превышает 1/8 размераshared_buffers, он автоматически ограничивается этим значением. Значение по умолчанию:2 MB. Если это значение задаётся без единиц измерения, оно считается заданным в килобайтах. Этот параметр можно задать в любой момент. Его также можно переопределить для VACUUM и ANALYZE при передаче параметраBUFFER_USAGE_LIMIT. С большим значением параметра командыVACUUMиANALYZEмогут выполняться быстрее, но при слишком большом значении многие полезные страницы могут вытесняться из общих буферов.logical_decoding_work_mem(integer) #Задаёт максимальный объём памяти, используемой для логического декодирования, после превышения которого некоторые декодированные изменения будут вымещаться на локальный диск. Тем самым ограничивается объём памяти, используемой подключениями потоковой логической репликации. По умолчанию его значение — 64 мегабайта (
64MB). Так как каждое подключение репликации использует один буфер заданного размера, а количество таких подключений к одному серверу обычно невелико (оно ограничивается значениемmax_wal_senders), значение данного параметра вполне можно сделать достаточно большим, намного превышающимwork_mem, чтобы минимизировать объём вымещаемых на диск декодируемых изменений.commit_timestamp_buffers(integer) #Задаёт объём памяти, используемый для кеширования содержимого
pg_commit_ts(см. Таблицу 64.1). Если значение указано без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Значение по умолчанию —0, которое означает, что будет использованоshared_buffers/512 блоков, но не более 1024 и не менее 16 блоков. Этот параметр можно задать только при запуске сервера.multixact_member_buffers(integer) #Задаёт объём общей памяти, используемый для кеширования содержимого
pg_multixact/members(см. Таблицу 64.1). Если это значение задаётся без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Значение по умолчанию —32. Задать этот параметр можно только при запуске сервера.multixact_offset_buffers(integer) #Задаёт объём общей памяти, используемый для кеширования содержимого
pg_multixact/offsets(см. Таблицу 64.1). Если это значение задаётся без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Значение по умолчанию —16. Задать этот параметр можно только при запуске сервера.notify_buffers(integer) #Задаёт объём общей памяти, используемый для кеширования содержимого
pg_notify(см. Таблицу 64.1). Если значение указано без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Значение по умолчанию —16. Этот параметр можно задать только при запуске сервера.serializable_buffers(integer) #Задаёт объём общей памяти, используемый для кеширования содержимого
pg_serial(см. Таблицу 64.1). Если это значение задаётся без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Значение по умолчанию —32. Задать этот параметр можно только при запуске сервера.subtransaction_buffers(integer) #Задаёт объём памяти, используемый для кеширования содержимого
pg_subtrans(см. Таблицу 64.1). Если значение указано без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Значение по умолчанию —0, которое означает, что будет использованоshared_buffers/512 блоков, но не более 1024 и не менее 16 блоков. Этот параметр можно задать только при запуске сервера.transaction_buffers(integer) #Задаёт объём памяти, используемый для кеширования содержимого
pg_xact(см. Таблицу 64.1). Если значение указано без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Значение по умолчанию —0, которое означает, что будет использованоshared_buffers/512 блоков, но не более 1024 и не менее 16 блоков. Этот параметр можно задать только при запуске сервера.max_stack_depth(integer) #Задаёт максимальную безопасную глубину стека для исполнителя. В идеале это значение должно равняться предельному размеру стека, ограниченному ядром (который устанавливается командой
ulimit -sили аналогичной), за вычетом запаса примерно в мегабайт. Этот запас необходим, потому что сервер проверяет глубину стека не в каждой процедуре, а только в потенциально рекурсивных процедурах, например, при вычислении выражений. Если это значение задаётся без единиц измерения, оно считается заданным в килобайтах. Значение по умолчанию — два мегабайта (2MB) — выбрано с большим запасом, так что риск переполнения стека минимален. Но с другой стороны, его может быть недостаточно для выполнения сложных функций. Изменить этот параметр могут только суперпользователи и пользователи с соответствующим правомSET.Если
max_stack_depthбудет превышать фактический предел ядра, то функция с неограниченной рекурсией сможет вызвать крах отдельного процесса сервера. В системах, где Postgres Pro может определить предел, установленный ядром, он не позволит установить для этого параметра небезопасное значение. Однако эту информацию выдают не все системы, поэтому выбирать это значение следует с осторожностью.shared_memory_type(enum) #Выбирает механизм разделяемой памяти, используя который сервер будет работать с основной областью общей памяти, содержащей общие буферы Postgres Pro и другие общие данные. Допустимые варианты:
mmap(для выделения анонимных блоков разделяемой памяти с помощьюmmap),sysv(для выделения разделяемой памяти System V функциейshmget) иwindows(для выделения разделяемой памяти в Windows). Не все варианты поддерживаются на разных платформах; первый из поддерживаемых данной платформой вариантов становится для неё вариантом по умолчанию. Применятьsysv, который нигде не выбирается по умолчанию, вообще не рекомендуется, так как для выделения большого объёма памяти (см. Подраздел 17.4.1) обычно требуется нестандартная настройка ядра. Задать этот параметр можно только при запуске сервера.dynamic_shared_memory_type(enum) #Выбирает механизм динамической разделяемой памяти, который будет использоваться сервером. Допустимые варианты:
posix(для выделения разделяемой памяти POSIX функциейshm_open),sysv(для выделения разделяемой памяти System V функциейshmget),windows(для выделения разделяемой памяти в Windows) иmmap(для эмуляции разделяемой памяти через отображение в память файлов, хранящихся в каталоге данных). Не все варианты поддерживаются на разных платформах; по умолчанию обычно выбирается первый из поддерживаемых данной платформой вариантов. Применятьmmap, который нигде не выбирается по умолчанию, вообще не рекомендуется, так как операционная система может периодически записывать на диск изменённые страницы, что создаст дополнительную нагрузку; однако это может быть полезно для отладки, когда каталогpg_dynshmemнаходится на RAM-диске или когда другие механизмы разделяемой памяти недоступны. Задать этот параметр можно только при запуске сервера.min_dynamic_shared_memory(integer) #Задаёт объём памяти, который должен быть выделен при запуске сервера для параллельных запросов. Если выделен недостаточный объём памяти или она уже занята одновременно выполняющимися запросами, новые параллельные запросы временно запрашивают дополнительную разделяемую память у операционной системы согласно значению
dynamic_shared_memory_type(это может приводить к замедлению вследствие накладных расходов на управление памятью). На выделение памяти в соответствии с указаниемmin_dynamic_shared_memoryвлияет параметрhuge_pagesв тех операционных системах, где он поддерживается; в системе, поддерживающей автоматическое управление большими страницами, их использование вероятнее всего даст положительный эффект. Значение по умолчанию —0(память не выделяется). Этот параметр можно установить только при запуске сервера.
18.4.2. Диск #
temp_file_limit(integer) #Задаёт максимальный объём дискового пространства, который сможет использовать один процесс для временных файлов, например, при сортировке и хешировании, или для сохранения удерживаемого курсора. Транзакция, которая попытается превысить этот предел, будет отменена. Если это значение задаётся без единиц измерения, оно считается заданным в килобайтах. Значение
-1(по умолчанию) означает, что предел отсутствует. Изменить этот параметр могут только суперпользователи и пользователи с соответствующим правомSET.Этот параметр ограничивает общий объём, который могут занимать в момент времени все временные файлы, задействованные в данном процессе Postgres Pro. Следует отметить, что это не касается файлов явно создаваемых временных таблиц; ограничивается только объём временных файлов, которые создаются неявно при выполнении запросов.
file_extend_method(enum) #Определяет метод расширения файлов данных во время массовых операций, таких как
COPY. Первое доступное значение используется как значение по умолчанию и зависит от операционной системы:При значении
posix_fallocate(Unix) используется стандартный интерфейс POSIX для выделения места на диске, но этот интерфейс поддерживается не во всех системах. Если для параметра установлено это значение, но оно не поддерживается нижележащей файловой системой, значение автоматически меняется наwrite_zeros. В текущих версиях BTRFS при использовании этого значения отключается сжатие. Это значение по умолчанию в системах, в которых присутствует функцияposix_fallocate.При значении
write_zerosрасширение файлов происходит путём добавления блоков с нулевыми байтами. Это значение по умолчанию в системах, в которых отсутствует функцияposix_fallocate.
Метод
write_zerosвсегда применяется, если файлы с данными расширяются на 8 блоков или меньше.max_notify_queue_pages(integer) #Задаёт максимальное количество выделенных страниц для очереди NOTIFY / LISTEN. Значение по умолчанию — 1048576. Для страниц размером 8 КБ позволяет использовать до 8 ГБ дискового пространства. Задать этот параметр можно только при запуске сервера.
18.4.3. Использование ресурсов ядра #
max_files_per_process(integer) #Задаёт максимальное число файлов, которые могут быть одновременно открыты каждым серверным подпроцессом. Значение по умолчанию — 1000 файлов. Если ядро реализует безопасное ограничение по процессам, об этом параметре можно не беспокоиться. Но на некоторых платформах (а именно, в большинстве систем BSD) ядро позволяет отдельному процессу открыть больше файлов, чем могут открыть несколько процессов одновременно. Если вы столкнётесь с ошибками «Too many open files» (Слишком много открытых файлов), попробуйте уменьшить это число. Задать этот параметр можно только при запуске сервера.
18.4.4. Задержка очистки по стоимости #
Во время выполнения команд VACUUM и ANALYZE система ведёт внутренний счётчик, в котором суммирует оцениваемую стоимость различных выполняемых операций ввода-вывода. Когда накопленная стоимость превышает предел (vacuum_cost_limit), процесс, выполняющий эту операцию, засыпает на некоторое время (vacuum_cost_delay). Затем счётчик сбрасывается и процесс продолжается.
Данный подход реализован для того, чтобы администраторы могли снизить влияние этих команд на параллельную работу с базой, за счёт уменьшения нагрузки на подсистему ввода-вывода. Очень часто не имеет значения, насколько быстро выполнятся команды обслуживания (например, VACUUM и ANALYZE), но очень важно, чтобы они как можно меньше влияли на выполнение других операций с базой данных. Администраторы имеют возможность управлять этим, настраивая задержку очистки по стоимости.
По умолчанию этот режим отключён для выполняемых вручную команд VACUUM. Чтобы включить его, нужно установить в vacuum_cost_delay ненулевое значение.
vacuum_cost_delay(floating point) #Продолжительность времени, в течение которого будет простаивать процесс, превысивший предел стоимости. Если это значение задаётся без единиц измерения, оно считается заданным в миллисекундах. Значение по умолчанию равно нулю, то есть задержка очистки отсутствует. При положительных значениях интенсивность очистки будет зависеть от стоимости.
При настройке интенсивности очистки для
vacuum_cost_delayобычно выбираются довольно небольшие значения, вплоть до 1 миллисекунды и меньше. Хотя вvacuum_cost_delayможно задавать дробные значения в миллисекундах, такие задержки могут быть неточными на старых платформах. На таких платформах для увеличения интенсивностиVACUUMпо сравнению с уровнем, обеспечиваемым при задержке 1 мс, потребуется настраивать другие параметры стоимости очистки. Тем не менее имеет смысл выбирать настолько малую задержкуvacuum_cost_delay, насколько может обеспечить платформа; большие задержки не будут полезны.vacuum_cost_page_hit(integer) #Примерная стоимость очистки буфера, оказавшегося в общем кеше. Это подразумевает блокировку пула буферов, поиск в хеш-таблице и сканирование содержимого страницы. По умолчанию этот параметр равен одному.
vacuum_cost_page_miss(integer) #Примерная стоимость очистки буфера, который нужно прочитать с диска. Это подразумевает блокировку пула буферов, поиск в хеш-таблице, чтение требуемого блока с диска и сканирование его содержимого. По умолчанию этот параметр равен 2.
vacuum_cost_page_dirty(integer) #Примерная стоимость очистки, при которой изменяется блок, не модифицированный ранее. В неё включается дополнительная стоимость ввода-вывода, связанная с записью изменённого блока на диск. По умолчанию этот параметр равен 20.
vacuum_cost_limit(integer) #Общая стоимость, при накоплении которой процесс очистки будет засыпать на время, указанное в
vacuum_cost_delay. По умолчанию — 200.
Примечание
Некоторые операции устанавливают критические блокировки и поэтому должны завершаться как можно быстрее. Во время таких операций задержка очистки по стоимости не осуществляется, так что накопленная за это время стоимость может намного превышать установленный предел. Во избежание ненужных длительных задержек в таких случаях, фактическая задержка вычисляется по формуле vacuum_cost_delay * accumulated_balance / vacuum_cost_limit и ограничивается максимумом, равным vacuum_cost_delay * 4.
18.4.5. Фоновая запись #
В числе специальных процессов сервера есть процесс фоновой записи, задача которого — осуществлять запись «грязных» (новых или изменённых) общих буферов на диск. Когда количество чистых общих буферов считается недостаточным, данный процесс записывает грязные буферы в файловую систему и помечает их как чистые. Это снижает вероятность того, что серверные процессы, выполняющие запросы пользователей, не смогут найти чистые буферы и им придётся сбрасывать грязные буферы самостоятельно. Однако процесс фоновой записи увеличивает общую нагрузку на подсистему ввода-вывода, так как он может записывать неоднократно изменяемую страницу несколько раз, тогда как её можно было бы записать всего один раз в контрольной точке. Параметры, рассматриваемые в данном подразделе, позволяют настроить поведение фоновой записи для конкретных нужд.
bgwriter_delay(integer) #Задаёт задержку между раундами активности процесса фоновой записи. Во время раунда этот процесс осуществляет запись некоторого количества загрязнённых буферов (это настраивается следующими параметрами). Затем он засыпает на время
bgwriter_delay, и всё повторяется снова. Однако если в пуле не остаётся загрязнённых буферов, он может быть неактивен более длительное время, не зависящее отbgwriter_delay. Если это значение задаётся без единиц измерения, оно считается заданным в миллисекундах. По умолчанию этот параметр равен 200 миллисекундам (200ms). Обратите внимание, что в некоторых системах разрешение таймера составляет 10 мс, поэтому если задать вbgwriter_delayзначение, не кратное 10, фактически будет получен тот же результат, что и со следующим за ним кратным 10. Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.bgwriter_lru_maxpages(integer) #Задаёт максимальное число буферов, которое сможет записать процесс фоновой записи за раунд активности. При нулевом значении фоновая запись отключается. (Учтите, что на контрольные точки, которые управляются отдельным вспомогательным процессом, это не влияет.) По умолчанию значение этого параметра — 100 буферов. Задать этот параметр можно только в
postgresql.confили в командной строке при запуске сервера.bgwriter_lru_multiplier(floating point) #Число загрязнённых буферов, записываемых в очередном раунде, зависит от того, сколько новых буферов требовалось серверным процессам в предыдущих раундах. Средняя недавняя потребность умножается на
bgwriter_lru_multiplierи предполагается, что именно столько буферов потребуется на следующем раунде. Процесс фоновой записи будет записывать на диск и освобождать буферы, пока число чистых буферов не достигнет целевого значения. (При этом число буферов, записываемых за раунд, ограничивается сверху параметромbgwriter_lru_maxpages.) Таким образом, со множителем, равным 1.0, записывается ровно столько буферов, сколько требуется по предположению («точно по плану»). Увеличение этого множителя даёт некоторую страховку от резких скачков потребностей, тогда как уменьшение отражает намерение оставить некоторый объём записи для серверных процессов. По умолчанию он равен 2.0. Этот параметр можно установить только в файлеpostgresql.confили в командной строке при запуске сервера.bgwriter_flush_after(integer) #Когда процессом фоновой записи записывается больше заданного объёма данных, сервер даёт указание ОС произвести запись этих данных в нижележащее хранилище. Это ограничивает объём «грязных» данных в страничном кеше ядра и уменьшает вероятность затормаживания при выполнении
fsyncв конце контрольной точки или когда ОС сбрасывает данные на диск большими порциями в фоне. Часто это значительно уменьшает задержки транзакций, но бывают ситуации (особенно когда объём рабочей нагрузки больше shared_buffers, но меньше страничного кеша ОС), когда производительность может упасть. Этот параметр действует не на всех платформах. Если значение параметра задаётся без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Он может принимать значение от0(при этом управление отложенной записью отключается) до 2 мегабайт (2MB). Значение по умолчанию —512kBв Linux и0в других ОС. (ЕслиBLCKSZотличен от 8 КБ, значение по умолчанию и максимум корректируются пропорционально.) Задать этот параметр можно только вpostgresql.confили в командной строке при запуске сервера.
С маленькими значениями bgwriter_lru_maxpages и bgwriter_lru_multiplier уменьшается активность ввода-вывода со стороны процесса фоновой записи, но увеличивается вероятность того, что запись придётся производить непосредственно серверным процессам, что замедлит выполнение запросов.
18.4.6. Асинхронное поведение #
backend_flush_after(integer) #Когда одним обслуживающим процессом записывается больше заданного объёма данных, сервер даёт указание ОС произвести запись этих данных в нижележащее хранилище. Это ограничивает объём «грязных» данных в страничном кеше ядра и уменьшает вероятность затормаживания при выполнении
fsyncв конце контрольной точки или когда ОС сбрасывает данные на диск большими порциями в фоне. Часто это значительно сокращает задержки транзакций, но бывают ситуации (особенно когда объём рабочей нагрузки больше shared_buffers, но меньше страничного кеша ОС), когда производительность может упасть. Этот параметр действует не на всех платформах. Если значение параметра задаётся без единиц измерения, оно считается заданным в блоках (размер которых равенBLCKSZбайт, обычно это 8 КБ). Он может принимать значение от0(при этом управление отложенной записью отключается) до 2 мегабайт (2MB). По умолчанию он имеет значение0, то есть это поведение отключено. (ЕслиBLCKSZотличен от 8 КБ, максимальное значение корректируется пропорционально.)effective_io_concurrency(integer) #Задаёт допустимое число параллельных операций ввода-вывода, которое говорит Postgres Pro о том, сколько операций ввода-вывода могут быть выполнены одновременно. Чем больше это число, тем больше операций ввода-вывода будет пытаться выполнить параллельно Postgres Pro в отдельном сеансе. Допустимые значения лежат в интервале от 1 до 1000, а нулевое значение отключает асинхронные запросы ввода-вывода. В настоящее время этот параметр влияет только на сканирование по битовой карте.
Для магнитных носителей хорошим начальным значением этого параметра будет число отдельных дисков, составляющих массив RAID 0 или RAID 1, в котором размещена база данных. (Для RAID 5 следует исключить один диск (как диск с чётностью).) Однако если база данных часто обрабатывает множество запросов в различных сеансах, и при небольших значениях дисковый массив может быть полностью загружен. Если продолжать увеличивать это значение при полной загрузке дисков, это приведёт только к увеличению нагрузки на процессор. Диски SSD и другие виды хранилища в памяти часто могут обрабатывать множество параллельных запросов, так что оптимальным числом может быть несколько сотен.
Асинхронный ввод-вывод зависит от эффективности функции
posix_fadvise, которая отсутствует в некоторых операционных системах. В случае её отсутствия попытка задать для этого параметра любое ненулевое значение приведёт к ошибке. В некоторых системах (например, в Solaris), эта функция присутствует, но на самом деле ничего не делает.Значение по умолчанию равно 1 в системах, где это поддерживается, и 0 в остальных. Это значение можно переопределить для таблиц в определённом табличном пространстве, установив одноимённый параметр табличного пространства (см. ALTER TABLESPACE).
maintenance_io_concurrency(integer) #Этот параметр подобен
effective_io_concurrency, но используется для операций обслуживания, которые выполняются в различных клиентских сеансах.Значение по умолчанию равно 10 в системах, где это поддерживается, и 0 в остальных. Это значение можно переопределить для таблиц в определённом табличном пространстве, установив одноимённый параметр табличного пространства (см. ALTER TABLESPACE).
io_combine_limit(integer) #Задаёт наибольший размер ввода-вывода в операциях, объединяющих ввод-вывод. Если это значение задаётся без единиц измерения, оно считается заданным в блоках (размер которых равен
BLCKSZбайт, обычно это 8 КБ). Значение по умолчанию — 128 КБ.max_worker_processes(integer) #Задаёт максимальное число фоновых процессов, которое может поддерживаться в текущем кластере. Этот параметр можно задать только при запуске сервера. Значение по умолчанию — 8.
Для ведомого сервера значение этого параметра должно быть больше или равно значению на ведущем. В противном случае на ведомом сервере не будут разрешены запросы.
Одновременно с изменением этого значения также может быть полезно изменить max_parallel_workers, max_parallel_maintenance_workers, и max_parallel_workers_per_gather.
max_parallel_workers_per_gather(integer) #Задаёт максимальное число рабочих процессов, которые могут запускаться одним узлом
GatherилиGather Merge. Параллельные рабочие процессы берутся из пула процессов, контролируемого параметром max_worker_processes, в количестве, ограничиваемом значением max_parallel_workers. Учтите, что запрошенное количество рабочих процессов может быть недоступно во время выполнения. В этом случае план будет выполняться с меньшим числом процессов, что может быть неэффективно. Значение по умолчанию — 2. Значение 0 отключает параллельное выполнение запросов.Учтите, что параллельные запросы могут потреблять значительно больше ресурсов, чем не параллельные, так как каждый рабочий процесс является отдельным процессом и оказывает на систему примерно такое же влияние, как дополнительный пользовательский сеанс. Это следует учитывать, выбирая значение этого параметра, а также настраивая другие параметры, управляющие использованием ресурсов, например work_mem. Ограничения ресурсов, такие как
work_mem, применяются к каждому рабочему процессу отдельно, что означает, что общая нагрузка для всех процессов может оказаться гораздо больше, чем при обычном использовании одного процесса. Например, параллельный запрос, задействующий 4 рабочих процесса, может использовать в 5 раз больше времени процессора, объёма памяти, ввода-вывода и т. д., по сравнению с запросом, не задействующим рабочие процессы вовсе.За дополнительными сведениями о параллельных запросах обратитесь к Главе 15.
max_parallel_maintenance_workers(integer) #Задаёт максимальное число рабочих процессов, которые могут запускаться одной служебной командой. В настоящее время параллельные процессы может использовать
CREATE INDEXпри построении индекса-B-дерева или BRIN иVACUUMбез указанияFULL. Параллельные рабочие процессы берутся из пула процессов, контролируемого параметром max_worker_processes, в количестве, ограничиваемом значением max_parallel_workers. Учтите, что запрошенное количество рабочих процессов может быть недоступно во время выполнения. В этом случае служебная операция будет выполняться с меньшим числом процессов, чем ожидалось. Значение по умолчанию — 2. Значение 0 отключает использование параллельных исполнителей служебными командами.Заметьте, что параллельно выполняемые служебные команды не должны потреблять значительно больше памяти, чем равнозначные непараллельные операции. Это отличает их от параллельных запросов, при выполнении которых ограничения ресурсов действуют на отдельные рабочие процессы. Для параллельных служебных команд ограничение ресурсов
maintenance_work_memсчитается действующим на команду в целом, вне зависимости от числа параллельных рабочих процессов. Тем не менее параллельные служебные команды могут гораздо больше нагружать процессор и каналы ввода-вывода.max_parallel_workers(integer) #Задаёт максимальное число рабочих процессов, которое кластер сможет поддерживать для параллельных операций. Значение по умолчанию — 8. При увеличении или уменьшения этого значения также может иметь смысл скорректировать max_parallel_maintenance_workers и max_parallel_workers_per_gather. Заметьте, что значение данного параметра, превышающее max_worker_processes, не будет действовать, так как параллельные рабочие процессы берутся из пула рабочих процессов, ограничиваемого этим параметром.
parallel_leader_participation(boolean) #Позволяет ведущему процессу выполнять план запроса ниже узлов
GatherиGather Merge, не ожидая рабочие процессы. По умолчанию этот параметр включён (on). Значениеoffснижает вероятность блокировки рабочих процессов в случае, если ведущий процесс будет читать кортежи недостаточно быстро, но тогда ведущему приходится дожидаться запуска рабочих процессов, и только затем выдавать первые кортежи. Степень положительного или отрицательного влияния ведущего зависит от типа плана, числа рабочих процессов и длительности запроса.
18.4. Resource Consumption #
18.4.1. Memory #
shared_buffers(integer) #Sets the amount of memory the database server uses for shared memory buffers. The default is typically 128 megabytes (
128MB), but might be less if your kernel settings will not support it (as determined during initdb). This setting must be at least 128 kilobytes. However, settings significantly higher than the minimum are usually needed for good performance. If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. (Non-default values ofBLCKSZchange the minimum value.) This parameter can only be set at server start.If you have a dedicated database server with 1GB or more of RAM, a reasonable starting value for
shared_buffersis 25% of the memory in your system. There are some workloads where even larger settings forshared_buffersare effective, but because Postgres Pro also relies on the operating system cache, it is unlikely that an allocation of more than 40% of RAM toshared_bufferswill work better than a smaller amount. Larger settings forshared_buffersusually require a corresponding increase inmax_wal_size, in order to spread out the process of writing large quantities of new or changed data over a longer period of time.On systems with less than 1GB of RAM, a smaller percentage of RAM is appropriate, so as to leave adequate space for the operating system.
huge_pages(enum) #Controls whether huge pages are requested for the main shared memory area. Valid values are
try(the default),on, andoff. This parameter can only be set at server start. Withhuge_pagesset totry, the server will try to request huge pages, but fall back to the default if that fails. Withon, failure to request huge pages will prevent the server from starting up. Withoff, huge pages will not be requested. The actual state of huge pages is indicated by the server variable huge_pages_status.At present, this setting is supported only on Linux and Windows. The setting is ignored on other systems when set to
try. On Linux, it is only supported whenshared_memory_typeis set tommap(the default).The use of huge pages results in smaller page tables and less CPU time spent on memory management, increasing performance. For more details about using huge pages on Linux, see Section 17.4.5.
Huge pages are known as large pages on Windows. To use them, you need to assign the user right “Lock pages in memory” to the Windows user account that runs Postgres Pro. You can use Windows Group Policy tool (gpedit.msc) to assign the user right “Lock pages in memory”. To start the database server on the command prompt as a standalone process, not as a Windows service, the command prompt must be run as an administrator or User Access Control (UAC) must be disabled. When the UAC is enabled, the normal command prompt revokes the user right “Lock pages in memory” when started.
Note that this setting only affects the main shared memory area. Operating systems such as Linux, FreeBSD, and Illumos can also use huge pages (also known as “super” pages or “large” pages) automatically for normal memory allocation, without an explicit request from Postgres Pro. On Linux, this is called “transparent huge pages” (THP). That feature has been known to cause performance degradation with Postgres Pro for some users on some Linux versions, so its use is currently discouraged (unlike explicit use of
huge_pages).huge_page_size(integer) #Controls the size of huge pages, when they are enabled with huge_pages. The default is zero (
0). When set to0, the default huge page size on the system will be used. This parameter can only be set at server start.Some commonly available page sizes on modern 64 bit server architectures include:
2MBand1GB(Intel and AMD),16MBand16GB(IBM POWER), and64kB,2MB,32MBand1GB(ARM). For more information about usage and support, see Section 17.4.5.Non-default settings are currently supported only on Linux.
temp_buffers(integer) #Sets the maximum amount of memory used for temporary buffers within each database session. These are session-local buffers used only for access to temporary tables. If this value is specified without units, it is taken as blocks, that is
BLCKSZbytes, typically 8kB. The default is eight megabytes (8MB). (IfBLCKSZis not 8kB, the default value scales proportionally to it.) This setting can be changed within individual sessions, but only before the first use of temporary tables within the session; subsequent attempts to change the value will have no effect on that session.A session will allocate temporary buffers as needed up to the limit given by
temp_buffers. The cost of setting a large value in sessions that do not actually need many temporary buffers is only a buffer descriptor, or about 64 bytes, per increment intemp_buffers. However if a buffer is actually used an additional 8192 bytes will be consumed for it (or in general,BLCKSZbytes).max_prepared_transactions(integer) #Sets the maximum number of transactions that can be in the “prepared” state simultaneously (see PREPARE TRANSACTION). Setting this parameter to zero (which is the default) disables the prepared-transaction feature. This parameter can only be set at server start.
If you are not planning to use prepared transactions, this parameter should be set to zero to prevent accidental creation of prepared transactions. If you are using prepared transactions, you will probably want
max_prepared_transactionsto be at least as large as max_connections, so that every session can have a prepared transaction pending.When running a standby server, you must set this parameter to the same or higher value than on the primary server. Otherwise, queries will not be allowed in the standby server.
work_mem(integer) #Sets the base maximum amount of memory to be used by a query operation (such as a sort or hash table) before writing to temporary disk files. If this value is specified without units, it is taken as kilobytes. The default value is four megabytes (
4MB). Note that a complex query might perform several sort and hash operations at the same time, with each operation generally being allowed to use as much memory as this value specifies before it starts to write data into temporary files. Also, several running sessions could be doing such operations concurrently. Therefore, the total memory used could be many times the value ofwork_mem; it is necessary to keep this fact in mind when choosing the value. Sort operations are used forORDER BY,DISTINCT, and merge joins. Hash tables are used in hash joins, hash-based aggregation, memoize nodes and hash-based processing ofINsubqueries.Hash-based operations are generally more sensitive to memory availability than equivalent sort-based operations. The memory limit for a hash table is computed by multiplying
work_membyhash_mem_multiplier. This makes it possible for hash-based operations to use an amount of memory that exceeds the usualwork_membase amount.Note
The Postgres Pro planner may incorrectly estimate the hash table size when doing hash-based operations. If the hash table is organized in a such manner that one or several batches are so big that they do not fit into the allocated memory, exceeding the memory limit, and the hash table can not be splitted into more batches, then the planner will try to place each batch into the memory in order to complete the query even if a single batch exceeds the aforementioned limit.
Therefore, the memory consumption could dramatically increase when doing hash-based operations on large datasets that produce hash tables, which can not be splitted into a large number of batches.
hash_mem_multiplier(floating point) #Used to compute the maximum amount of memory that hash-based operations can use. The final limit is determined by multiplying
work_membyhash_mem_multiplier. The default value is 2.0, which makes hash-based operations use twice the usualwork_membase amount.Consider increasing
hash_mem_multiplierin environments where spilling by query operations is a regular occurrence, especially when simply increasingwork_memresults in memory pressure (memory pressure typically takes the form of intermittent out of memory errors). The default setting of 2.0 is often effective with mixed workloads. Higher settings in the range of 2.0 - 8.0 or more may be effective in environments wherework_memhas already been increased to 40MB or more.maintenance_work_mem(integer) #Specifies the maximum amount of memory to be used by maintenance operations, such as
VACUUM,CREATE INDEX, andALTER TABLE ADD FOREIGN KEY. If this value is specified without units, it is taken as kilobytes. It defaults to 64 megabytes (64MB). Since only one of these operations can be executed at a time by a database session, and an installation normally doesn't have many of them running concurrently, it's safe to set this value significantly larger thanwork_mem. Larger settings might improve performance for vacuuming and for restoring database dumps.Note that when autovacuum runs, up to autovacuum_max_workers times this memory may be allocated, so be careful not to set the default value too high. It may be useful to control for this by separately setting autovacuum_work_mem.
autovacuum_work_mem(integer) #Specifies the maximum amount of memory to be used by each autovacuum worker process. If this value is specified without units, it is taken as kilobytes. It defaults to -1, indicating that the value of maintenance_work_mem should be used instead. The setting has no effect on the behavior of
VACUUMwhen run in other contexts. This parameter can only be set in thepostgresql.conffile or on the server command line.-
vacuum_buffer_usage_limit(integer) # Specifies the size of the Buffer Access Strategy used by the
VACUUMandANALYZEcommands. A setting of0will allow the operation to use any number ofshared_buffers. Otherwise valid sizes range from128 kBto16 GB. If the specified size would exceed 1/8 the size ofshared_buffers, the size is silently capped to that value. The default value is2MB. If this value is specified without units, it is taken as kilobytes. This parameter can be set at any time. It can be overridden for VACUUM and ANALYZE when passing theBUFFER_USAGE_LIMIToption. Higher settings can allowVACUUMandANALYZEto run more quickly, but having too large a setting may cause too many other useful pages to be evicted from shared buffers.logical_decoding_work_mem(integer) #Specifies the maximum amount of memory to be used by logical decoding, before some of the decoded changes are written to local disk. This limits the amount of memory used by logical streaming replication connections. It defaults to 64 megabytes (
64MB). Since each replication connection only uses a single buffer of this size, and an installation normally doesn't have many such connections concurrently (as limited bymax_wal_senders), it's safe to set this value significantly higher thanwork_mem, reducing the amount of decoded changes written to disk.commit_timestamp_buffers(integer) #Specifies the amount of memory to use to cache the contents of
pg_commit_ts(see Table 64.1). If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The default value is0, which requestsshared_buffers/512 up to 1024 blocks, but not fewer than 16 blocks. This parameter can only be set at server start.multixact_member_buffers(integer) #Specifies the amount of shared memory to use to cache the contents of
pg_multixact/members(see Table 64.1). If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The default value is32. This parameter can only be set at server start.multixact_offset_buffers(integer) #Specifies the amount of shared memory to use to cache the contents of
pg_multixact/offsets(see Table 64.1). If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The default value is16. This parameter can only be set at server start.notify_buffers(integer) #Specifies the amount of shared memory to use to cache the contents of
pg_notify(see Table 64.1). If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The default value is16. This parameter can only be set at server start.serializable_buffers(integer) #Specifies the amount of shared memory to use to cache the contents of
pg_serial(see Table 64.1). If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The default value is32. This parameter can only be set at server start.subtransaction_buffers(integer) #Specifies the amount of shared memory to use to cache the contents of
pg_subtrans(see Table 64.1). If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The default value is0, which requestsshared_buffers/512 up to 1024 blocks, but not fewer than 16 blocks. This parameter can only be set at server start.transaction_buffers(integer) #Specifies the amount of shared memory to use to cache the contents of
pg_xact(see Table 64.1). If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The default value is0, which requestsshared_buffers/512 up to 1024 blocks, but not fewer than 16 blocks. This parameter can only be set at server start.max_stack_depth(integer) #Specifies the maximum safe depth of the server's execution stack. The ideal setting for this parameter is the actual stack size limit enforced by the kernel (as set by
ulimit -sor local equivalent), less a safety margin of a megabyte or so. The safety margin is needed because the stack depth is not checked in every routine in the server, but only in key potentially-recursive routines. If this value is specified without units, it is taken as kilobytes. The default setting is two megabytes (2MB), which is conservatively small and unlikely to risk crashes. However, it might be too small to allow execution of complex functions. Only superusers and users with the appropriateSETprivilege can change this setting.Setting
max_stack_depthhigher than the actual kernel limit will mean that a runaway recursive function can crash an individual backend process. On platforms where Postgres Pro can determine the kernel limit, the server will not allow this variable to be set to an unsafe value. However, not all platforms provide the information, so caution is recommended in selecting a value.shared_memory_type(enum) #Specifies the shared memory implementation that the server should use for the main shared memory region that holds Postgres Pro's shared buffers and other shared data. Possible values are
mmap(for anonymous shared memory allocated usingmmap),sysv(for System V shared memory allocated viashmget) andwindows(for Windows shared memory). Not all values are supported on all platforms; the first supported option is the default for that platform. The use of thesysvoption, which is not the default on any platform, is generally discouraged because it typically requires non-default kernel settings to allow for large allocations (see Section 17.4.1). This parameter can only be set at server start.dynamic_shared_memory_type(enum) #Specifies the dynamic shared memory implementation that the server should use. Possible values are
posix(for POSIX shared memory allocated usingshm_open),sysv(for System V shared memory allocated viashmget),windows(for Windows shared memory), andmmap(to simulate shared memory using memory-mapped files stored in the data directory). Not all values are supported on all platforms; the first supported option is usually the default for that platform. The use of themmapoption, which is not the default on any platform, is generally discouraged because the operating system may write modified pages back to disk repeatedly, increasing system I/O load; however, it may be useful for debugging, when thepg_dynshmemdirectory is stored on a RAM disk, or when other shared memory facilities are not available. This parameter can only be set at server start.min_dynamic_shared_memory(integer) #Specifies the amount of memory that should be allocated at server startup for use by parallel queries. When this memory region is insufficient or exhausted by concurrent queries, new parallel queries try to allocate extra shared memory temporarily from the operating system using the method configured with
dynamic_shared_memory_type, which may be slower due to memory management overheads. Memory that is allocated at startup withmin_dynamic_shared_memoryis affected by thehuge_pagessetting on operating systems where that is supported, and may be more likely to benefit from larger pages on operating systems where that is managed automatically. The default value is0(none). This parameter can only be set at server start.
18.4.2. Disk #
temp_file_limit(integer) #Specifies the maximum amount of disk space that a process can use for temporary files, such as sort and hash temporary files, or the storage file for a held cursor. A transaction attempting to exceed this limit will be canceled. If this value is specified without units, it is taken as kilobytes.
-1(the default) means no limit. Only superusers and users with the appropriateSETprivilege can change this setting.This setting constrains the total space used at any instant by all temporary files used by a given Postgres Pro process. It should be noted that disk space used for explicit temporary tables, as opposed to temporary files used behind-the-scenes in query execution, does not count against this limit.
file_extend_method(enum) #Specifies the method used to extend data files during bulk operations such as
COPY. The first available option is used as the default, depending on the operating system:posix_fallocate(Unix) uses the standard POSIX interface for allocating disk space, but is missing on some systems. If it is present but the underlying file system doesn't support it, this option silently falls back towrite_zeros. Current versions of BTRFS are known to disable compression when this option is used. This is the default on systems that have the function.write_zerosextends files by writing out blocks of zero bytes. This is the default on systems that don't have the functionposix_fallocate.
The
write_zerosmethod is always used when data files are extended by 8 blocks or fewer.max_notify_queue_pages(integer) #Specifies the maximum amount of allocated pages for NOTIFY / LISTEN queue. The default value is 1048576. For 8 KB pages it allows to consume up to 8 GB of disk space. This parameter can only be set at server start.
18.4.3. Kernel Resource Usage #
max_files_per_process(integer) #Sets the maximum number of simultaneously open files allowed to each server subprocess. The default is one thousand files. If the kernel is enforcing a safe per-process limit, you don't need to worry about this setting. But on some platforms (notably, most BSD systems), the kernel will allow individual processes to open many more files than the system can actually support if many processes all try to open that many files. If you find yourself seeing “Too many open files” failures, try reducing this setting. This parameter can only be set at server start.
18.4.4. Cost-based Vacuum Delay #
During the execution of VACUUM and ANALYZE commands, the system maintains an internal counter that keeps track of the estimated cost of the various I/O operations that are performed. When the accumulated cost reaches a limit (specified by vacuum_cost_limit), the process performing the operation will sleep for a short period of time, as specified by vacuum_cost_delay. Then it will reset the counter and continue execution.
The intent of this feature is to allow administrators to reduce the I/O impact of these commands on concurrent database activity. There are many situations where it is not important that maintenance commands like VACUUM and ANALYZE finish quickly; however, it is usually very important that these commands do not significantly interfere with the ability of the system to perform other database operations. Cost-based vacuum delay provides a way for administrators to achieve this.
This feature is disabled by default for manually issued VACUUM commands. To enable it, set the vacuum_cost_delay variable to a nonzero value.
vacuum_cost_delay(floating point) #The amount of time that the process will sleep when the cost limit has been exceeded. If this value is specified without units, it is taken as milliseconds. The default value is zero, which disables the cost-based vacuum delay feature. Positive values enable cost-based vacuuming.
When using cost-based vacuuming, appropriate values for
vacuum_cost_delayare usually quite small, perhaps less than 1 millisecond. Whilevacuum_cost_delaycan be set to fractional-millisecond values, such delays may not be measured accurately on older platforms. On such platforms, increasingVACUUM's throttled resource consumption above what you get at 1ms will require changing the other vacuum cost parameters. You should, nonetheless, keepvacuum_cost_delayas small as your platform will consistently measure; large delays are not helpful.vacuum_cost_page_hit(integer) #The estimated cost for vacuuming a buffer found in the shared buffer cache. It represents the cost to lock the buffer pool, lookup the shared hash table and scan the content of the page. The default value is one.
vacuum_cost_page_miss(integer) #The estimated cost for vacuuming a buffer that has to be read from disk. This represents the effort to lock the buffer pool, lookup the shared hash table, read the desired block in from the disk and scan its content. The default value is 2.
vacuum_cost_page_dirty(integer) #The estimated cost charged when vacuum modifies a block that was previously clean. It represents the extra I/O required to flush the dirty block out to disk again. The default value is 20.
vacuum_cost_limit(integer) #This is the accumulated cost that will cause the vacuuming process to sleep for
vacuum_cost_delay. The default is 200.
Note
There are certain operations that hold critical locks and should therefore complete as quickly as possible. Cost-based vacuum delays do not occur during such operations. Therefore it is possible that the cost accumulates far higher than the specified limit. To avoid uselessly long delays in such cases, the actual delay is calculated as vacuum_cost_delay * accumulated_balance / vacuum_cost_limit with a maximum of vacuum_cost_delay * 4.
18.4.5. Background Writer #
There is a separate server process called the background writer, whose function is to issue writes of “dirty” (new or modified) shared buffers. When the number of clean shared buffers appears to be insufficient, the background writer writes some dirty buffers to the file system and marks them as clean. This reduces the likelihood that server processes handling user queries will be unable to find clean buffers and have to write dirty buffers themselves. However, the background writer does cause a net overall increase in I/O load, because while a repeatedly-dirtied page might otherwise be written only once per checkpoint interval, the background writer might write it several times as it is dirtied in the same interval. The parameters discussed in this subsection can be used to tune the behavior for local needs.
bgwriter_delay(integer) #Specifies the delay between activity rounds for the background writer. In each round the writer issues writes for some number of dirty buffers (controllable by the following parameters). It then sleeps for the length of
bgwriter_delay, and repeats. When there are no dirty buffers in the buffer pool, though, it goes into a longer sleep regardless ofbgwriter_delay. If this value is specified without units, it is taken as milliseconds. The default value is 200 milliseconds (200ms). Note that on some systems, the effective resolution of sleep delays is 10 milliseconds; settingbgwriter_delayto a value that is not a multiple of 10 might have the same results as setting it to the next higher multiple of 10. This parameter can only be set in thepostgresql.conffile or on the server command line.bgwriter_lru_maxpages(integer) #In each round, no more than this many buffers will be written by the background writer. Setting this to zero disables background writing. (Note that checkpoints, which are managed by a separate, dedicated auxiliary process, are unaffected.) The default value is 100 buffers. This parameter can only be set in the
postgresql.conffile or on the server command line.bgwriter_lru_multiplier(floating point) #The number of dirty buffers written in each round is based on the number of new buffers that have been needed by server processes during recent rounds. The average recent need is multiplied by
bgwriter_lru_multiplierto arrive at an estimate of the number of buffers that will be needed during the next round. Dirty buffers are written until there are that many clean, reusable buffers available. (However, no more thanbgwriter_lru_maxpagesbuffers will be written per round.) Thus, a setting of 1.0 represents a “just in time” policy of writing exactly the number of buffers predicted to be needed. Larger values provide some cushion against spikes in demand, while smaller values intentionally leave writes to be done by server processes. The default is 2.0. This parameter can only be set in thepostgresql.conffile or on the server command line.bgwriter_flush_after(integer) #Whenever more than this amount of data has been written by the background writer, attempt to force the OS to issue these writes to the underlying storage. Doing so will limit the amount of dirty data in the kernel's page cache, reducing the likelihood of stalls when an
fsyncis issued at the end of a checkpoint, or when the OS writes data back in larger batches in the background. Often that will result in greatly reduced transaction latency, but there also are some cases, especially with workloads that are bigger than shared_buffers, but smaller than the OS's page cache, where performance might degrade. This setting may have no effect on some platforms. If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The valid range is between0, which disables forced writeback, and2MB. The default is512kBon Linux,0elsewhere. (IfBLCKSZis not 8kB, the default and maximum values scale proportionally to it.) This parameter can only be set in thepostgresql.conffile or on the server command line.
Smaller values of bgwriter_lru_maxpages and bgwriter_lru_multiplier reduce the extra I/O load caused by the background writer, but make it more likely that server processes will have to issue writes for themselves, delaying interactive queries.
18.4.6. Asynchronous Behavior #
backend_flush_after(integer) #Whenever more than this amount of data has been written by a single backend, attempt to force the OS to issue these writes to the underlying storage. Doing so will limit the amount of dirty data in the kernel's page cache, reducing the likelihood of stalls when an
fsyncis issued at the end of a checkpoint, or when the OS writes data back in larger batches in the background. Often that will result in greatly reduced transaction latency, but there also are some cases, especially with workloads that are bigger than shared_buffers, but smaller than the OS's page cache, where performance might degrade. This setting may have no effect on some platforms. If this value is specified without units, it is taken as blocks, that isBLCKSZbytes, typically 8kB. The valid range is between0, which disables forced writeback, and2MB. The default is0, i.e., no forced writeback. (IfBLCKSZis not 8kB, the maximum value scales proportionally to it.)effective_io_concurrency(integer) #Sets the number of concurrent disk I/O operations that Postgres Pro expects can be executed simultaneously. Raising this value will increase the number of I/O operations that any individual Postgres Pro session attempts to initiate in parallel. The allowed range is 1 to 1000, or zero to disable issuance of asynchronous I/O requests. Currently, this setting only affects bitmap heap scans.
For magnetic drives, a good starting point for this setting is the number of separate drives comprising a RAID 0 stripe or RAID 1 mirror being used for the database. (For RAID 5 the parity drive should not be counted.) However, if the database is often busy with multiple queries issued in concurrent sessions, lower values may be sufficient to keep the disk array busy. A value higher than needed to keep the disks busy will only result in extra CPU overhead. SSDs and other memory-based storage can often process many concurrent requests, so the best value might be in the hundreds.
Asynchronous I/O depends on an effective
posix_fadvisefunction, which some operating systems lack. If the function is not present then setting this parameter to anything but zero will result in an error. On some operating systems (e.g., Solaris), the function is present but does not actually do anything.The default is 1 on supported systems, otherwise 0. This value can be overridden for tables in a particular tablespace by setting the tablespace parameter of the same name (see ALTER TABLESPACE).
maintenance_io_concurrency(integer) #Similar to
effective_io_concurrency, but used for maintenance work that is done on behalf of many client sessions.The default is 10 on supported systems, otherwise 0. This value can be overridden for tables in a particular tablespace by setting the tablespace parameter of the same name (see ALTER TABLESPACE).
io_combine_limit(integer) #Controls the largest I/O size in operations that combine I/O. If this value is specified without units, it is taken as blocks, that is
BLCKSZbytes, typically 8kB. The default is 128kB.max_worker_processes(integer) #Sets the maximum number of background processes that the cluster can support. This parameter can only be set at server start. The default is 8.
When running a standby server, you must set this parameter to the same or higher value than on the primary server. Otherwise, queries will not be allowed in the standby server.
When changing this value, consider also adjusting max_parallel_workers, max_parallel_maintenance_workers, and max_parallel_workers_per_gather.
max_parallel_workers_per_gather(integer) #Sets the maximum number of workers that can be started by a single
GatherorGather Mergenode. Parallel workers are taken from the pool of processes established by max_worker_processes, limited by max_parallel_workers. Note that the requested number of workers may not actually be available at run time. If this occurs, the plan will run with fewer workers than expected, which may be inefficient. The default value is 2. Setting this value to 0 disables parallel query execution.Note that parallel queries may consume very substantially more resources than non-parallel queries, because each worker process is a completely separate process which has roughly the same impact on the system as an additional user session. This should be taken into account when choosing a value for this setting, as well as when configuring other settings that control resource utilization, such as work_mem. Resource limits such as
work_memare applied individually to each worker, which means the total utilization may be much higher across all processes than it would normally be for any single process. For example, a parallel query using 4 workers may use up to 5 times as much CPU time, memory, I/O bandwidth, and so forth as a query which uses no workers at all.For more information on parallel query, see Chapter 15.
max_parallel_maintenance_workers(integer) #Sets the maximum number of parallel workers that can be started by a single utility command. Currently, the parallel utility commands that support the use of parallel workers are
CREATE INDEXwhen building a B-tree or BRIN index, andVACUUMwithoutFULLoption. Parallel workers are taken from the pool of processes established by max_worker_processes, limited by max_parallel_workers. Note that the requested number of workers may not actually be available at run time. If this occurs, the utility operation will run with fewer workers than expected. The default value is 2. Setting this value to 0 disables the use of parallel workers by utility commands.Note that parallel utility commands should not consume substantially more memory than equivalent non-parallel operations. This strategy differs from that of parallel query, where resource limits generally apply per worker process. Parallel utility commands treat the resource limit
maintenance_work_memas a limit to be applied to the entire utility command, regardless of the number of parallel worker processes. However, parallel utility commands may still consume substantially more CPU resources and I/O bandwidth.max_parallel_workers(integer) #Sets the maximum number of workers that the cluster can support for parallel operations. The default value is 8. When increasing or decreasing this value, consider also adjusting max_parallel_maintenance_workers and max_parallel_workers_per_gather. Also, note that a setting for this value which is higher than max_worker_processes will have no effect, since parallel workers are taken from the pool of worker processes established by that setting.
-
parallel_leader_participation(boolean) # Allows the leader process to execute the query plan under
GatherandGather Mergenodes instead of waiting for worker processes. The default ison. Setting this value tooffreduces the likelihood that workers will become blocked because the leader is not reading tuples fast enough, but requires the leader process to wait for worker processes to start up before the first tuples can be produced. The degree to which the leader can help or hinder performance depends on the plan type, number of workers and query duration.