18.17. Опции разработчика#

18.17. Опции разработчика

18.17. Опции разработчика
Назад	Наверх	Глава 18. Конфигурация сервера	Начало	Далее

18.17. Опции разработчика #

Следующие параметры предназначены для тестирования разработчиками и никогда не должны использоваться в производственной базе данных. Однако некоторые из них могут быть использованы для восстановления серьезно поврежденных баз данных. Поэтому они были исключены из примера файла postgresql.conf. Обратите внимание, что для работы многих из этих параметров требуются специальные флаги компиляции исходного кода.

allow_in_place_tablespaces (boolean) #

Позволяет создавать табличные пространства в виде каталогов в pg_tblspc, если для команды CREATE TABLESPACE. указана пустая строка расположения. Параметр предназначен для тестирования сценариев репликации, в которых основной и резервный серверы работают на одной машине. Такие каталоги могут мешать инструментам резервного копирования, которые ожидают наличие только символических ссылок в этом месте. Изменять эту настройку могут только суперпользователи и пользователи с соответствующими привилегиями SET.

allow_system_table_mods (boolean) #

Позволяет изменять структуру системных таблиц, а также выполнять определенные другие рискованные действия с системными таблицами. В противном случае, даже для суперпользователей это не разрешено. Неразумное использование этой настройки может привести к потере данных или серьезному повреждению базы данных. Только суперпользователи и пользователи с соответствующим привилегией SET могут изменять эту настройку.

backtrace_functions (string) #

Этот параметр содержит список имен функций на языке C, разделенных запятыми. Если возникает ошибка и имя внутренней функции на языке C, где произошла ошибка, совпадает со значением из списка, то вместе с сообщением об ошибке в журнал сервера записывается трассировка стека. Это может использоваться для отладки конкретных областей исходного кода.

Поддержка трассировки стека не доступна на всех платформах, и качество трассировок зависит от параметров компиляции.

Только суперпользователи и пользователи с соответствующим привилегией SET могут изменять это настройку.

backtrace_on_internal_error (boolean) #

Если этот параметр включен и возникает ошибка с кодом ошибки XX000 (внутренняя ошибка; см. также Приложение A), то трассировка стека записывается в журнал сервера вместе с сообщением об ошибке. Это можно использовать для отладки таких внутренних ошибок, которые обычно не возникают в рабочей среде. По умолчанию выключено.

Только суперпользователи и пользователи с соответствующим привилегией SET могут изменять это настройку.

debug_discard_caches (integer) #

Когда установлено значение 1, каждая запись кеша системного каталога инвалидируется при первой возможности, независимо от того, произошло ли что-то, что могло бы сделать ее недействительной. Кеширование системных каталогов фактически отключается, поэтому сервер будет работать крайне медленно. Более высокие значения запускают рекурсивое аннулирование кеша, что еще медленнее и полезно только для тестирования логики кеширования. Значение по умолчанию 0 выбирает нормальное поведение кеширования каталогов.

Этот параметр может быть очень полезен при попытке вызвать трудно воспроизводимые ошибки, связанные с одновременными изменениями каталога, но в остальных случаях он редко нужен. См. файлы исходного кода inval.c и pg_config_manual.h для получения подробной информации.

Этот параметр поддерживается, когда DISCARD_CACHES_ENABLED был определен во время компиляции (что происходит автоматически при использовании опции configure --enable-cassert). В производственных сборках его значение всегда будет 0, и попытки установить другое значение вызовут ошибку.

debug_io_direct (string) #

Попросить ядро минимизировать эффекты кэширования для данных отношений и файлов WAL, используя O_DIRECT (большинство Unix-подобных систем).

Может быть установлено в пустую строку (по умолчанию), чтобы отключить использование прямого ввода-вывода, или в список операций, разделённых запятыми, для которых следует использовать прямой ввод-вывод. Допустимые значения: data для основных файлов данных, wal для файлов WAL и wal_init для файлов WAL при их первоначальном выделении. Этот параметр может быть установлен только при запуске сервера.

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

В настоящее время эта функция снижает производительность и предназначена только для тестирования разработчиками.

debug_parallel_query (enum) #

Позволяет использовать параллельные запросы в тестовых целях даже в тех случаях, когда не ожидается повышения производительности. Допустимые значения debug_parallel_query: off (использовать параллельный режим только тогда, когда ожидается улучшение производительности), on (принудительно использовать параллельный запрос для всех запросов, для которых это считается безопасным), и regress (как on, но с дополнительными изменениями поведения, как объяснено ниже).

Более конкретно, установка on для этого значения добавит узел Gather в начало любого плана запроса, для которого это кажется безопасным, так что запрос выполняется внутри параллельного рабочего процесса. Даже когда параллельный рабочий процесс недоступен или не может быть использован, операции, такие как запуск подтранзакции, которые запрещены в контексте параллельного запроса, будут запрещены, если планировщик считает, что это вызовет сбой запроса. Если возникают сбои или неожиданные результаты при установке этого параметра, некоторые функции, используемые запросом, могут потребовать пометки PARALLEL UNSAFE (или, возможно, PARALLEL RESTRICTED).

Установка этого значения на regress имеет все те же эффекты, что и установка его на on, а также некоторые дополнительные эффекты, предназначенные для облегчения автоматизированного тестирования регрессии. Обычно сообщения от параллельного рабочего процесса включают строку контекста, указывающую на это, но установка значения regress подавляет эту строку, чтобы вывод был таким же, как при выполнении без параллельности. Кроме того, узлы Gather, добавленные к планам с помощью этой настройки, скрыты в выводе EXPLAIN, чтобы вывод соответствовал тому, что было бы получено, если бы эта настройка была отключена.

ignore_system_indexes (boolean) #

Игнорировать системные индексы при чтении системных таблиц (но все же обновлять индексы при изменении таблиц). Это полезно при восстановлении поврежденных системных индексов. Этот параметр нельзя изменить после начала сессии.

post_auth_delay (integer) #

Количество времени для задержки при запуске нового процесса сервера после прохождения процедуры аутентификации. Это предназначено для того, чтобы разработчики имели возможность присоединиться к процессу сервера с помощью отладчика. Если это значение указано без единиц измерения, оно считается заданным в секундах. Значение нуль (по умолчанию) отключает задержку. Этот параметр нельзя изменить после начала сессии.

pre_auth_delay (integer) #

Количество времени для задержки сразу после создания нового процесса сервера перед выполнением процедуры аутентификации. Это предназначено для того, чтобы разработчики имели возможность присоединиться к процессу сервера с помощью отладчика для отслеживания неправильного поведения при аутентификации. Если это значение указано без единиц измерения, оно считается заданным в секундах. Значение нуль (по умолчанию) отключает задержку. Этот параметр может быть установлен только в файле postgresql.conf или в командной строке сервера.

trace_notify (boolean) #

Генерирует большой объем отладочного вывода для команд LISTEN и NOTIFY. client_min_messages или log_min_messages должны быть DEBUG1 или ниже, чтобы отправить этот вывод в клиентские или серверные журналы соответственно.

trace_recovery_messages (enum) #

Включает запись отладочного вывода, связанного с восстановлением, который в противном случае не будет записываться. Этот параметр позволяет пользователю переопределить нормальную настройку log_min_messages, но только для конкретных сообщений. Он предназначен для использования при отладке горячего резервного копирования. Допустимые значения: DEBUG5, DEBUG4, DEBUG3, DEBUG2, DEBUG1 и LOG. По умолчанию используется значение LOG, которое не влияет на принятие решений о записи. Другие значения приводят к записи отладочных сообщений, связанных с восстановлением, с этим или более высоким приоритетом, как если бы они имели приоритет LOG; для обычных настроек log_min_messages это приводит к их безусловной отправке в журнал сервера. Этот параметр может быть установлен только в файле postgresql.conf или в командной строке сервера.

trace_sort (boolean) #

Если включено, выводить информацию о использовании ресурсов во время сортировки. Этот параметр доступен только если макрос TRACE_SORT был определен при компиляции Tantor BE. (Однако, TRACE_SORT в настоящее время определен по умолчанию).

trace_locks (boolean) #

Если включено, выводится информация о использовании блокировок. Выводимая информация включает тип операции блокировки, тип блокировки и уникальный идентификатор объекта, который блокируется или разблокируется. Также включены битовые маски для типов блокировок, уже предоставленных для этого объекта, а также для типов блокировок, ожидающих этого объекта. Для каждого типа блокировки также выводится количество предоставленных блокировок и ожидающих блокировок, а также их общее количество. Пример вывода в журнале показан здесь:

LOG:  LockAcquire: new: lock(0xb7acd844) id(24688,24696,0,0,0,1)
      grantMask(0) req(0,0,0,0,0,0,0)=0 grant(0,0,0,0,0,0,0)=0
      wait(0) type(AccessShareLock)
LOG:  GrantLock: lock(0xb7acd844) id(24688,24696,0,0,0,1)
      grantMask(2) req(1,0,0,0,0,0,0)=1 grant(1,0,0,0,0,0,0)=1
      wait(0) type(AccessShareLock)
LOG:  UnGrantLock: updated: lock(0xb7acd844) id(24688,24696,0,0,0,1)
      grantMask(0) req(0,0,0,0,0,0,0)=0 grant(0,0,0,0,0,0,0)=0
      wait(0) type(AccessShareLock)
LOG:  CleanUpLock: deleting: lock(0xb7acd844) id(24688,24696,0,0,0,1)
      grantMask(0) req(0,0,0,0,0,0,0)=0 grant(0,0,0,0,0,0,0)=0
      wait(0) type(INVALID)

Подробности о структуре, которая будет выгружена, можно найти в файле src/include/storage/lock.h.