Конфигурационные параметры сервера (GUC)

Устанавливает имя приложения для клиентской сессии. Например, при подключении через psql будет установлено значение psql. Указание имени приложения позволяет отображать его в сообщениях лога и представлениях статистики.

Вызов командной строки для архивирования файлов журнала предзаписи (Write-Ahead Log, WAL), если значение archive_mode — on или always. Команда должна возвращать нулевой код выхода только при успешном выполнении.

Команда может содержать символы-заглушки:

Определяет, переносить ли завершенные сегменты файлов WAL в архивное хранилище с помощью команды archive_command.

Возможные значения:

Определяет, распознает ли парсер ввода массивов значение NULL без кавычек как null-элемент массива. По умолчанию on, что позволяет вводить массивы со значениями null. При значении off интерпретирует NULL как обычный элемент массива со строковым значением 'NULL'.

Максимальное время на завершение аутентификации клиента. Предотвращает бесконечное удержание подключений зависшими клиентами.

Определяет, можно ли представлять кавычку с помощью \' в строковом литерале. Предпочтительный стандартный для SQL способ — две кавычки (''), но PostgreSQL исторически также принимал \'. Однако использование \' создает риски безопасности, поскольку в некоторых кодировках клиента есть многобайтовые символы, где последний байт численно равен ASCII \.

Доступные значения:

Показывает размер дискового блока в байтах.

Задает имя для Bonjour. По умолчанию используется имя хоста, указанное пустой строкой. Эта опция игнорируется, если сервер не скомпилирован с поддержкой Bonjour.

При значении off отключает проверку тела функции при вызове CREATE FUNCTION. Отключение проверки полезно при восстановлении определений функций из дампа во избежание проблем с прямым обращением.

Интервал времени между проверками подключения клиента во время выполнения запросов, в миллисекундах. 0 отключает проверки подключения.

Устанавливает кодировку клиента (набор символов). По умолчанию используется та же кодировка, что и у базы данных. См. раздел Supported Character Sets в документации PostgreSQL.

Определяет уровни сообщений, отправляемые клиенту. Каждый уровень включает все последующие. Чем выше уровень, тем меньше сообщений отправляется. Сообщения уровня INFO всегда отправляются клиенту.

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

Для планировщика Postgres задает оценку затрат на обработку каждого оператора в условии WHERE. Измеряется как доля от затрат последовательного чтения страницы.

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

Указывает планировщику Postgres, сколько строк ожидается извлечь в запросе курсора. Это позволяет планировщику использовать информацию для оптимизации плана запроса. Значение по умолчанию 1 означает выборку всех строк.

Показывает, включены ли контрольные суммы для хранения данных в heap-хранилище базы данных. Использование контрольных сумм для heap-данных включается или отключается при инициализации системы; это нельзя изменить позже.

Страницы heap-данных содержат heap-таблицы, таблицы системного каталога, индексы и метаданные базы. Оптимизированное для добавления (append-optimized) хранилище имеет встроенную поддержку контрольных сумм, не связанную с этим параметром.

Greengage DB использует контрольные суммы для предотвращения загрузки поврежденных файловой системой данных в память, управляемую процессами базы. При включенных контрольных суммах heap-данных Greengage DB вычисляет и сохраняет контрольные суммы страниц heap-данных при записи на диск. При извлечении страницы с диска проверяется контрольная сумма. При неудачной проверке возвращается ошибка, и страница не загружается в управляемую память.

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

Задает каталоги данных Greengage DB для мастера и каждого сегмента на соответствующих хостах. Начальные значения считываются из файла конфигурации базы при инициализации кластера. Подробнее см. в разделе Создание файла конфигурации базы данных.

Устанавливает формат отображения дат и времени, а также правила интерпретации неоднозначных введенных значений даты. Переменная содержит две независимые компоненты: спецификацию формата вывода и спецификацию порядка год/месяц/день для ввода/вывода.

Включает использование имен пользователей на уровне базы данных. При on создавайте пользователей в формате username@dbname. Для создания обычных глобальных пользователей добавляйте @ к имени пользователя на стороне клиента.

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

Включает различные проверки (assertion check). Значение по умолчанию — off. Вы можете установить значение по умолчанию на on при сборке Greengage DB из исходного кода, используя опцию --enable-cassert.

Добавляет отступы в отладочный вывод для более читаемого формата. Требуется client_min_messages или log_min_messages на уровне DEBUG1 или ниже.

Для каждого запроса выводит дерево разбора. Требуется client_min_messages или log_min_messages на уровне DEBUG1 или ниже.

Для каждого запроса выводит план параллельного выполнения. Требуется client_min_messages или log_min_messages на уровне DEBUG1 или ниже.

Для каждого запроса выводит предварительный план запроса. Требуется client_min_messages или log_min_messages на уровне DEBUG1 или ниже.

Для каждого запроса выводит результат работы переписывателя запросов. Требуется client_min_messages или log_min_messages на уровне DEBUG1 или ниже.

Для каждого запроса выводит план слайсов запроса. Требуется client_min_messages или log_min_messages на уровне DEBUG1 или ниже.

Задает целевой уровень статистики по умолчанию (количество хранимых наиболее частых значений) для столбцов таблиц без индивидуальной настройки через ALTER TABLE SET STATISTICS. Большие значения могут улучшить качество оценок планировщика Postgres.

Табличное пространство по умолчанию для создания объектов (например, таблиц и индексов), если команда CREATE не указывает табличное пространство явно.

См. также Настройка табличных пространств по умолчанию.

Выбирает конфигурацию текстового поиска для вариантов функций текстового поиска без явного аргумента конфигурации. По умолчанию используется pg_catalog.simple, но initdb инициализирует файл конфигурации значением, соответствующим локали lc_ctype, если такая конфигурация найдена.

При выполнении на уровне изоляции SERIALIZABLE откладываемая (deferrable) транзакция только для чтения может быть задержана перед началом выполнения. Однако после начала она не несет накладных расходов на обеспечение сериализуемости, поэтому код сериализации не будет прерывать ее из-за параллельных обновлений, из-за чего это свойство полезно для длительных транзакций только для чтения.

Этот параметр контролирует откладываемость новых транзакций по умолчанию. На данный момент не влияет на транзакции чтения-записи или уровни изоляции ниже SERIALIZABLE. По умолчанию off.

Определяет уровень изоляции новых транзакций по умолчанию. Greengage DB обрабатывает read uncommitted так же, как read committed, а serializable — так же, как repeatable read.

Определяет статус "только для чтения" новых транзакций по умолчанию. Транзакция только для чтения не может изменять таблицы, кроме временных.

Если нужно открыть динамически загружаемый модуль, а имя файла в команде CREATE FUNCTION или LOAD не содержит компонента каталога (нет слеша), система ищет файл по этому пути. $libdir заменяется на каталог библиотек встроенного PostgreSQL. Там устанавливаются модули стандартной поставки PostgreSQL.

Задает предположение о размере доступного кеша диска для одного запроса для планировщика Postgres. Учитывается при оценке затрат индексного сканирования; большее значение повышает вероятность использования индексов, меньшее — последовательного сканирования. При настройке учитывайте общие буферы Greengage DB и долю кеша диска ядра для файлов данных. Учитывайте также ожидаемое количество параллельных запросов к разным таблицам, поскольку они будут использовать доступное пространство вместе. Параметр не влияет на размер выделенной памяти и не резервирует кеш диска ядра; используется только для оценки.

Устанавливается в единицах block_size (по умолчанию 32K) без указания единиц; например, 262144 для 8 ГБ. Можно указать размер напрямую; например, 1GB — это 32768 блоков. Утилита gpconfig и команда SHOW показывают размер в GB, MB или kB.

Включает или отключает использование планов bitmap-scan планировщиком Postgres. Обратите внимание: это не то же самое, что сканирование по bitmap-индексу (Bitmap Index Scan). Bitmap Scan динамически преобразует индексы в битовые карты в памяти, ускоряя выполнение сложных запросов к большим таблицам. Это применяется к запросам с несколькими предикатами на разных индексированных столбцах. Битовые карты для каждого столбца сравниваются, чтобы собрать конечный результат.

Включает или отключает использование планов групповой агрегации планировщиком Postgres.

Включает или отключает использование планов хеш-агрегации планировщиком Postgres.

Включает или отключает использование планов хеш-соединения планировщиком Postgres.

Включает или отключает использование планов сканирования только по индексу планировщиком Postgres.

Включает или отключает использование планов индексного сканирования планировщиком Postgres.

Включает или отключает использование планов соединения слиянием (merge join) планировщиком Postgres. Соединение слиянием основано на сортировке левой и правой таблиц с последующим параллельным сканированием. Оба типа данных должны поддерживать полную упорядоченность, а оператор соединения должен работать только для пар значений на одинаковых позициях в порядке сортировки. На практике это означает поведение как равенство.

Включает или отключает использование планов соединения вложенными циклами планировщиком Postgres. Отключение этого параметра снижает вероятность выбора таких планов планировщиком Postgres за счет добавления значения 10000000000 (1.0e10) к стоимости каждого узла Nested Loop. Обратите внимание, что это не отключает использование планов соединения вложенными циклами совсем, но снижает их использование до минимума, если есть альтернативы.

Включает или отключает использование планов последовательного сканирования планировщиком Postgres. Отключение этого параметра снижает вероятность выбора таких планов планировщиком Postgres за счет добавления значения 10000000000 (1.0e10) к стоимости каждого узла Seq Scan. Обратите внимание, что это не отключает использование планов последовательного сканирования совсем, но снижает их использование до минимума, если есть альтернативы.

Включает или отключает использование явных шагов сортировки планировщиком Postgres. Отключение этого параметра снижает вероятность выбора таких планов планировщиком Postgres за счет добавления значения 10000000000 (1.0e10) к стоимости каждого узла Sort. Обратите внимание, что это не отключает использование планов с явными сортировками совсем, но снижает их использование до минимума, если есть альтернативы.

Включает или отключает использование планов сканирования по идентификатору кортежа (TID) планировщиком Postgres.

При значении on выдается предупреждение при наличии обратного слеша (\) в обычном строковом литерале ('…​'). Для экранирования используйте синтаксис E'…​'.

Задает уровень детализации использования памяти в EXPLAIN ANALYZE. Возможные значения (от меньшего к большему):

Корректирует количество отображаемых цифр для чисел с плавающей точкой, включая float4, float8 и геометрические типы данных. Значение параметра добавляется к стандартному количеству цифр. Можно установить до 3 для добавления значимых цифр — полезно для дампов float-данных, требующих точного восстановления. Отрицательное значение уменьшает количество цифр.

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

Включает селективность проверок NULL для внешних соединений.

Задает пороговое соотношение (в процентах) скрытых строк к общим строкам, при котором запускается уплотнение (compaction) файлов сегмента при VACUUM без опции FULL ("ленивый" вакуум). Если соотношение скрытых строк в файле сегмента меньше порога, уплотнение не выполняется и выводится сообщение в журнал.

Определяет, может ли Greengage DB запускать автоматический сбор статистики при изменении таблицы не владельцем.

По умолчанию false: Greengage DB не запускает автоматический сбор статистики для таблиц, измененных не владельцем.

При true Greengage DB также запускает автоматический сбор статистики, когда:

Изменяется только суперпользователем.

Задает режим запуска автоматического сбора статистики с помощью ANALYZE. Значение on_no_stats запускает сбор при CREATE TABLE AS SELECT, INSERT и COPY на таблицах без существующей статистики.

Значение on_change запускает сбор только при превышении порога строк gp_autostats_on_change_threshold. Операции, при которых сбор статистики запускается со значением on_change: CREATE TABLE AS SELECT, UPDATE, DELETE, INSERT, COPY.

По умолчанию on_no_stats.

Задает режим запуска автоматического сбора статистики с помощью ANALYZE для операторов в функциях на процедурных языках. Значение none отключает сбор. Значение on_no_stats запускает сбор при использовании CREATE TABLE AS SELECT, INSERT и COPY в функциях на таблицах без статистики.

Значение on_change запускает сбор только при превышении порога строк gp_autostats_on_change_threshold. Операции, при которых сбор статистики запускается со значением on_change: CREATE TABLE AS SELECT, UPDATE, DELETE, INSERT, COPY.

Задает порог автоматического сбора статистики при значении gp_autostats_mode on_change. При превышении количества затронутых строк добавляется ANALYZE и собирается статистика для таблицы.

При запуске сессии и запроса в Greengage DB система создает группы (gang) рабочих процессов на каждом сегменте для его выполнения. После завершения работы рабочие процессы сегментов уничтожаются, кроме кешируемого количества, задаваемого этим параметром. Меньшее значение экономит ресурсы сегмент-хостов, большее — улучшает производительность для пользователей с множеством сложных запросов подряд.

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

Тайм-аут отправки данных не отвечающим клиентам Greengage DB во время обработки запроса. 0 отключает тайм-аут, Greengage DB ждет бесконечно. При достижении тайм-аута запрос отменяется с сообщением:

Локальный ID содержимого сегмента:

По умолчанию (off) Greengage DB вычисляет выделение памяти для ресурсных групп по gp_segment_configuration.hostname. При значении on для вычисления памяти сегментов используется gp_segment_configuration.address.

Контролирует создание таблицы Greengage DB командой CREATE TABLE или CREATE TABLE AS без выражения DISTRIBUTED BY.

Для CREATE TABLE при значении off (по умолчанию) без DISTRIBUTED BY Greengage DB выбирает ключ распределения следующим образом:

При значении параметра on без указания DISTRIBUTED BY:

Для CREATE TABLE AS без указания распределения:

Локальный DBID содержимого сегмента.

Количество секунд задержки процесса Greengage DB после фатальной внутренней ошибки.

Задает значения по умолчанию для опций хранения таблицы при создании с помощью команды CREATE TABLE:

Укажите несколько значений опций хранения через запятую.

Можно задавать опции хранения этим параметром вместо указания в выражении WITH команды CREATE TABLE. Опции, указанные в CREATE TABLE, имеют приоритет над значениями параметра.

Не все комбинации опций хранения допустимы. При недопустимых опциях возвращается ошибка. См. описание команды CREATE TABLE для информации об опциях хранения таблицы.

Значения по умолчанию можно задать для базы данных и пользователя. При задании параметра на разных уровнях используется следующий порядок приоритета (от высшего к низшему), когда пользователь подключается к базе данных и создает таблицы:

Значение параметра не кумулятивно. Например, если параметр задает appendoptimized и compresstype для базы, а пользователь задает orientation, то значения базы для appendoptimized и compresstype игнорируются.

Этот пример команды ALTER DATABASE задает по умолчанию orientation и compresstype для базы mytest:

Для создания AO-таблицы с колоночным хранением и сжатием RLE в базе mytest пользователю достаточно указать appendoptimized=TRUE в WITH.

Этот пример команды утилиты gpconfig задает опции хранения по умолчанию для системы Greengage DB. При указании нескольких опций значение должно быть в одинарных кавычках.

Этот пример команды gpconfig показывает значение параметра. Значение параметра должно быть одинаковым на мастере Greengage DB и всех сегментах.

Максимальное количество повторных отправок TCP keepalive-сообщений от диспетчера запросов (Query Dispatcher, QD) к исполнителю запросов (Query Executor, QE). Контролирует количество последовательно потерянных сообщений до признания соединения между QD и QE потерянным.

Время в секундах между отправками TCP keepalive-сообщений от диспетчера запросов к исполнителю запросов.

Интервал в секундах между повторами (retransmit) TCP keepalive-сообщений от диспетчера запросов к исполнителю запросов.

Интервал в секундах, с которым процесс восстановления распределенной транзакции (DTX) проверяет неподтвержденные и незавершенные транзакции. Используется для очистки брошенных транзакций.

Временной порог (в секундах) для обнаружения потенциально брошенных транзакций процессом восстановления DTX. Если подготовленная транзакция не подтверждена или отменена за это время, она подлежит восстановлению.

Включает планы, которые могут динамически исключать сканирование партиций.

Включает или отключает двухфазную агрегацию для вычисления одного агрегата с DISTINCT. Применяется только к подзапросам с одной функцией агрегата с DISTINCT.

Включает или отключает трехфазную агрегацию и соединение для агрегатов с DISTINCT. Применяется к подзапросам с одним или более агрегатами с DISTINCT.

Включает или отключает прямую отправку целевых планов для запросов, которые обращаются к данным на одном сегменте. При значении on запросы к строкам одного сегмента отправляются только на этот сегмент (а не на все сегменты). Значительно сокращает время ответа за счет исключения использования интерконнекта. При включении увеличивает использование CPU на мастере.

Управляет доступностью выражения EXCHANGE DEFAULT PARTITION для ALTER TABLE. По умолчанию off. В этом случае выражение недоступно, команда ALTER TABLE выдает ошибку при его указании.

При значении on Greengage DB выдает предупреждение о возможных некорректных результатах из-за некорректных данных в партиции по умолчанию.

При значении on планировщик Postgres планирует вставки единичных строк напрямую в нужный сегмент (без перемещения). Значительно улучшает производительность вставок одной строки.

Контролирует включение глобального детектора взаимных блокировок (Global Deadlock Detector) Greengage DB для одновременных UPDATE и DELETE на heap-таблицах. По умолчанию off — глобальный детектор выключен. В этом случае Greengage DB выполняет операции вставки и удаления на heap-таблицах последовательно.

При включении глобального детектора взаимных блокировок разрешаются параллельные обновления, детектор определяет взаимоблокировки и прерывает их, отменяя процессы, выполняющие самые новые транзакции.

Включает или отключает агенты сбора данных для базы gpperfmon.

Включает или отключает сбор данных на один узел для вычисления агрегатов с DISTINCT в запросах группировки расширения. При включении этого параметра и gp_enable_groupext_distinct_pruning планировщик Postgres выбирает план с меньшей стоимостью.

Включает или отключает трехфазную агрегацию и соединения для вычисления агрегатов с DISTINCT в запросах группировки расширения. Обычно генерирует план с меньшей стоимостью, предпочтительный для планировщика Postgres.

Включает использование планировщиком индексных сканирований с лимитом для оптимизации функций MIN() и MAX() на индексированных столбцах.

Включает или отключает использование двух- и трехфазных параллельных планов агрегации планировщиком Postgres. Применяется к любым подзапросам с агрегацией. При off отключаются gp_enable_agg_distinct и gp_enable_agg_distinct_pruning.

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

Включает двухфазное удаление дубликатов для SELECT DISTINCT (не SELECT COUNT(DISTINCT)). При включении добавляет дополнительный SORT DISTINCT перед перемещением. В случаях, когда это значительно уменьшает число строк, дополнительный SORT DISTINCT дешевле передачи строк по интерконнекту.

Включает сбор метрик запросов. При включении Greengage DB собирает метрики во время выполнения запроса. По умолчанию off.

Включает использование планировщиками GPORCA и Postgres оценочного размера таблицы (pg_relation_size()), если для нее нет статистики. По умолчанию при отсутствии статистики используется оценка числа строк по умолчанию. Такое поведение улучшает время оптимизации и снижает нагрузку на ресурсные очереди, но может дать неоптимальные планы.

Параметр игнорируется для корневой партиции партиционированной таблицы. При включенном GPORCA и отсутствии статистики корневой партиции всегда используется значение по умолчанию. Используйте ANALYZE ROOTPARTITION для сбора статистики корневой партиции. См. Сбор статистики с помощью ANALYZE.

Включает удаление дубликатов во время сортировки.

Включает выполнение операции LIMIT во время сортировки. Эффективнее при необходимости получения первых limit_number строк.

Включает или отключает внешние таблицы, выполняющие команды ОС или скрипты на сегмент-хостах (CREATE EXTERNAL TABLE EXECUTE). Необходимо при использовании gpperfmon или MapReduce.

Включает pushdown фильтров при чтении из внешних таблиц. При невозможности pushdown запрос выполняется без фильтрации на уровне источника данных. Фильтры применяются к результату внутри Greengage DB. Подробнее о внешних таблицах см. в статье Обзор внешних таблиц.

Задает количество сегментов для сканирования данных внешних таблиц. Предотвращает перегрузку системы процессами сканирования и недостаток ресурсов для параллельных операций. Применяется только к внешним таблицам, использующим протокол gpfdist://.

Интервал в секундах для переподключения отключенного зеркала перед тем, как процесс обнаружения сбоев (ftsprobe) отметит его как вышедшее из строя (down).

Задает интервал опроса процесса обнаружения сбоев (ftsprobe). Время обнаружения сбоя сегмента примерно равно этому значению.

Количество попыток подключения к сегменту процессом ftsprobe перед сообщением о сбое.

Допустимый тайм-аут для подключения к сегменту процессом ftsprobe до того, как он будет отмечен потерянным (down).

Максимальное количество попыток установления репликационного соединения между основным сегментом и зеркалом. При превышении этого лимита ftsprobe прекращает попытки и отмечает зеркало как вышедшее из строя (down).

Задает интервал выполнения фонового процесса глобального детектора взаимных блокировок (Global Deadlock Detector).

Задает частоту отправки информации о выполнении запросов от серверных процессов Greengage DB агентам сбора данных для базы gpperfmon. Операции запросов за интервал отправляются по UDP агентам мониторинга сегментов. При чрезмерной потере UDP-пакетов в долгих и сложных запросах увеличьте значение.

Задает целевую плотность хеш-таблицы для операций хеш-соединения. Меньшее значение создает большие хеш-таблицы, повышая производительность соединения.

При значении n Greengage DB прекращает обработку входных строк при импорте через COPY или из внешней таблицы, если первые n строк содержат ошибки формата. Если среди первых n строк есть корректная, обработка продолжается.

0 отключает лимит.

Выражение SEGMENT REJECT LIMIT в COPY или определении внешней таблицы также ограничивает число отклоненных строк.

Размер общей памяти для метрик запросов, в килобайтах. По умолчанию 5120, максимум 131072. Если при запуске значение gp_enable_query_metrics установлено в on, Greengage DB выделяет общую память для метрик. Память делится на заголовок и набор слотов. Количество слотов зависит от числа параллельных запросов и узлов плана выполнения. Значение по умолчанию 5120 рассчитано на 250 параллельных запросов по 120 узлов. При значении gp_enable_query_metrics off или исчерпании слотов метрики хранятся в локальной памяти.

Задает стратегию привязки адресов для интерконнекта между сокетами сегмент-хостов. Возможные значения: unicast или wildcard (по умолчанию).

Размер таблицы истории курсоров для UDP-интерконнекта. Увеличьте при зависании пользовательских функций с множеством параллельных курсоров. По умолчанию 128.

Интервал (в секундах) отладочного логирования интерконнекта при значении gp_log_interconnect DEBUG. По умолчанию 10 секунд.

Сообщения содержат информацию о связи между рабочими процессами сегментов Greengage DB. Эта информация может использоваться для отладки сетевых проблем.

Метод управления потоком для UDPIFC-интерконнекта Greengage DB:

Минимальное количество повторов перед сообщением о тайм-ауте передачи в интерконнекте.

Задает минимальный тайм-аут повторной передачи (Retransmission Timeout, RTO) для интерконнекта на основе UDP, в миллисекундах.

Задает прокси-порты для Greengage DB при значении параметра gp_interconnect_type proxy. В остальных случаях игнорируется. По умолчанию пустая строка ("").

При gp_interconnect_type=proxy укажите порты для мастера, резервного мастера и всех основных и зеркальных сегментов в формате:

Первые три поля (db_id, cont_id, seg_address) можно взять из таблицы gp_segment_configuration. Четвертое — прокси-порт для мастера или сегмента.

Значение нужно указывать в одинарных кавычках. Следующий пример вызова gpconfig показывает значение для мастера и одного сегмента:

Пример настройки см. в статье Настройка прокси для интерконнекта.

Количество данных в очереди получателя UDPIFC-интерконнекта на каждом узле (при отсутствии доступного места данные будут утеряны, и отправитель должен переслать их заново). Увеличение значения повышает использование памяти, но может улучшить производительность. Разумно использовать значения от 1 до 10. При перекосе данных рекомендуется увеличить значение. Значительное увеличение повышает общее потребление памяти.

Время ожидания (в секундах) завершения настройки интерконнекта перед тайм-аутом.

Количество данных в очереди отправителя UDPIFC-интерконнекта на каждом узле. Увеличение повышает потребление памяти, но может улучшить производительность. Разумно использовать значения от 1 до 4. Значительное увеличение повышает общее потребление памяти.

Размер очереди прослушивания для TCP-сокетов интерконнекта. Рекомендуется настраивать вместе с параметрами ядра net.core.somaxconn и net.ipv4.tcp_max_syn_backlog.

Период проверки таймера для UDP-интерконнекта, в миллисекундах.

Период таймера для UDP-интерконнекта, в миллисекундах.

Время ожидания (в секундах) завершения сетевой передачи трафика интерконнекта перед тайм-аутом.

Задает сетевой протокол для интерконнекта Greengage DB.

UDPIFC (по умолчанию) — UDP с управлением потоком для интерконнекта. Метод управления потоком задается параметром gp_interconnect_fc_method.

При использовании TCP для интерконнекта лимит количества сегментов — 1000 или меньше при сложных запросах с большим количеством слайсов.

PROXY подразумевает использование протокола TCP и прокси для связи мастера с сегментами и между сегментами при выполнении запросов. При значении PROXY необходимо задать прокси-порты для мастера и сегментов в параметре gp_interconnect_proxy_addresses. Информацию о настройке прокси для интерконнекта Greengage DB см. в статье Настройка прокси для интерконнекта.

При значении on сохраняет блокировки на всех конечных партициях AO-таблиц, задействованных в запросе, до конца транзакции. Помогает избежать редких проблем видимости при выполнении запросов, например, read beyond eof при параллельном выполнении VACUUM на конечных партициях.

Задает формат файлов логов. При использовании административной схемы gp_toolkit файлы логов должны иметь формат CSV.

Контролирует логирование команд, вызывающих переполнение подтранзакций.

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

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

Значение по умолчанию оптимально для большинства сред.

Размер блока сериализации кортежей для интерконнекта Greengage DB, в байтах.

Лимит максимального количества уровней в иерархии партиций. По умолчанию 0 — лимит не установлен.

Максимальный несжатый размер плана запроса, умноженный на количество Motion-операторов (слайсов) в плане. При превышении этого размера запрос отменяется с ошибкой. Значение 0 означает, что размеры планов не отслеживаются.

Значения можно указать в kB (по умолчанию), MB или GB. Например, значение 200 эквивалентно 200kB. Значение 1GB — 1024MB или 1048576kB.

Лимит слотов общей памяти для узлов сканирования на один серверный процесс.

Максимальное количество слайсов (частей плана, выполняемых на сегментах), генерируемых запросом. При превышении этого числа возникает ошибка и запрос не выполняется. По умолчанию 0 — без лимита.

Выполнение запросов с большим числом слайсов снижает производительность. Пример: запрос, включающий UNION или UNION ALL над сложными представлениями. Используйте EXPLAIN ANALYZE для анализа слайсов.

Максимальное количество слайсов (частей плана, выполняемых на сегментах), генерируемых запросом. При превышении этого числа возникает ошибка и запрос не выполняется. По умолчанию 0 — без лимита.

Выполнение запросов с большим числом слайсов снижает производительность. Пример: запрос, включающий UNION или UNION ALL над сложными представлениями. Используйте EXPLAIN ANALYZE` для анализа слайсов.

Задает оценку затрат планировщика Postgres для оператора Motion (перемещение строк между сегментами), как долю от затрат последовательного чтения страницы. При 0 используется значение в два раза большее, чем cpu_tuple_cost.

При запуске сессии и запроса Greengage DB создает группы (gang) рабочих процессов на сегментах для его выполнения. gp_print_create_gang_time контролирует вывод дополнительной информации о создании этих групп, включая их повторное использование и максимальное и минимальное время подключения к сегменту.

По умолчанию false — дополнительная информация не выводится.

Для обработки ошибок одной строки в COPY и SELECT внешних таблиц задает количество обработанных строк перед началом расчета SEGMENT REJECT LIMIT <n> PERCENT.

При включении пытается создать дамп ядра при фатальной ошибке сервера.

Используется ресурсной группой для распределения памяти между операторами запроса.

При значении auto Greengage DB распределяет память по лимитам группы: фиксированный размер для операторов, требующих мало памяти, остаток — требующим много памяти.

При значении eager_free Greengage DB использует память более оптимально за счет перераспределения освобожденной памяти от завершенных операторов на поздние стадии запроса.

Включает или отключает соблюдение лимитов параллельных транзакций ресурсных групп. По умолчанию false — лимиты соблюдаются.

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

При значении true запрос выполняется следующим образом:

Задается на уровне сессии. Установка в транзакции или функции невозможна.

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

При значении true запросы выводятся из-под лимитов ресурсных групп, если они:

Включает режим "жесткого потолка" (ceiling enforcement mode) при распределении CPU ресурсным группам по процентам. При отключении используется эластичный режим (elastic mode). См. Процент CPU: CPU_RATE_LIMIT.

Определяет максимальный процент системных CPU-ресурсов для ресурсных групп на каждом сегментном узле Greengage DB.

Задает приоритет CPU для процессов Greengage DB над процессами, не относящимися к Greengage DB, при включенных ресурсных группах. Например, значение 10 устанавливает соотношение 10:1 в пользу Greengage DB.

Определяет, пересчитывает ли Greengage DB максимальный объем памяти, доступный одному запросу на сегмент-хосте в ресурсной группе. По умолчанию false — Greengage DB рассчитывает максимальный объем памяти на сегмент-хосте по конфигурации памяти и количеству основных сегментов на мастер-хосте. При значении true Greengage DB пересчитывает максимальный объем памяти на сегмент-хосте по памяти и количеству основных сегментов на этом сегмент-хосте.

Определяет максимальный процент системной памяти для ресурсных групп на каждом сегментном узле Greengage DB.

Например: кластер Greengage DB использует значение gp_resource_group_memory_limit по умолчанию 0.7, и на сегмент-хосте sdw1 работают 4 основных и 4 зеркальных сегмента. Greengage DB выделяет каждому основному сегменту хоста sdw1 (0.7 / 4 = 0.175) общей системной памяти. Если в результате сбоя 2 зеркальных сегмента хоста sdw1 станут основными, все 4 исходных основных сегмента продолжают потреблять свои доли памяти 0.175, и 2 новых основных сегмента получат по (0.7 / 6 = 0.116) памяти. Общее выделение памяти на хосте sdw1 составит 0.7 + (0.116 * 2) = 0.932, что превышает лимит gp_resource_group_memory_limit.

Отменяет выполнение функции pg_resgroup_move_query(), которая переносит запросы между ресурсными группами, при ожидании дольше указанного времени в миллисекундах.

Отменяет транзакцию в очереди ресурсной группы при ожидании дольше указанного времени в миллисекундах. Лимит применяется к каждой транзакции отдельно. По умолчанию 0 — ожидание может быть бесконечным.

Определяет схему управления ресурсами в кластере Greengage DB: ресурсные группы или ресурсные очереди. По умолчанию используются ресурсные очереди.

Включает функции управления памятью Greengage DB. Алгоритм eager_free использует то, что операторы не работают одновременно. План запроса разделяется на стадии: память каждой стадии освобождается при ее завершении и передается следующей.

При значении auto — использование памяти контролируется через statement_mem и лимиты очередей. При значении none — функции отключены.

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

Задает количество единиц CPU на каждый сегмент на сегмент-хосте. При использовании зеркалирования сегментов используйте для расчета количество основных сегментов на хосте. Учитывайте все доступные ОС ядра, включая виртуальные.

Например, в кластере с 10-ядерными сегмент-хостами с 4 основными сегментами на каждом установите значение 2.5 (10/4). Для основного и резервного мастеров выделите все доступные на их хостах ядра (10).

Неверные настройки приводят к недоиспользованию CPU или некорректной приоритизации.

Интервал (в миллисекундах) оценки текущего использования CPU процессом очистки (sweeper). При активации нового оператора приоритет оценивается на следующем интервале.

Роль серверного процесса: DISPATCH для мастера, EXECUTE для сегментов.

Минимальный размер безопасной записи для AO-таблиц в экспериментальных (non-mature) файловых системах. При значении больше нуля данные AO-таблиц дополняются во время записи до этого размера для защиты от повреждений из-за ошибок файловой системы. Каждая экспериментальная файловая система имеет известный безопасный размер; его необходимо указать в параметре при работе на этой системе. Обычно это размер, кратный extent файловой системы; например, Linux ext3 — 4096 байт, поэтому обычно используется значение 32768.

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

Количество основных сегментов, предполагаемых планировщиком Postgres для оценок затрат и размеров. При 0 — фактическое количество. Это значение влияет на оценки числа пересылаемых строк в Motion-операторах.

Версия сервера строкой. Может содержать текстовый модификатор, дополняющий числовую версию, например beta.

Версия сервера в виде целого числа. Это число гарантированно возрастает и может использоваться для сравнений. Мажорная версия выводится как есть, а минорная и патч — с дополнением нулями до двух цифр.

Системный ID сессии клиента. Начинается с 1 при первом запуске мастера.

При включении серверный процесс (postmaster) привязывается к CPU при запуске.

Включает использование статистики дочерних таблиц планировщиком Postgres при планировании запросов к родительской таблице.

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

Включает расширенное отслеживание ожидающих удалений для предотвращения накопления "брошенных" (orphaned) файлов. При отключении отключается хранение relation-узлов в shmem, дамп в WAL и удаление файлов при восстановлении.

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

Задает объем памяти (в мегабайтах), который могут потреблять все процессы postgres активного сегмента. Если запрос приводит к превышению этого лимита, память не выделяется и запрос не выполняется. Это локальный параметр — он задается для всех сегментов (основных и зеркальных). В значении параметра указывайте только число, например 4096 для установки лимита 4096 МБ.

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

Сначала рассчитайте gp_vmem — доступную память Greengage DB на хосте:

где SWAP — доступный размер файла подкачки и RAM — память хоста в гигабайтах.

Далее рассчитайте max_acting_primary_segments. Это максимальное число основных сегментов, которые могут работать на хосте в случае, когда зеркальные сегменты активированы из-за сбоя. Например, при расположении на 4 хостах с 8 основными сегментами на каждом сбой одного хоста приводит к активации 2-3 зеркал на каждом из оставшихся хостов. Значение max_acting_primary_segments в этом случае равно 11 (8 основных сегментов и 3 активированных зеркальных).

gp_vmem_protect_limit рассчитывается по формуле ниже. Значение нужно перевести в мегабайты.

При ожидании большого количества spill-файлов во время работы, используйте расчет с учетом их количества:

Подробная информация о мониторинге и управлении spill-файлами приведена в статье Управление spill-файлами.

На основе значения gp_vmem можно рассчитать значение параметра ядра ОС vm.overcommit_ratio. Этот параметр устанавливается на каждом хосте Greengage DB.

При потреблении процессом-исполнителем больше указанного объема памяти (в МБ) процесс не кешируется для следующих запросов. В системах с множеством подключений или простаивающих процессов следует уменьшить это значение для освобождения памяти сегментов. Локальный параметр.

Определяет, сжимаются ли временные spill-файлы, создаваемые на дисках операциями хеш-агрегации или хеш-соединения.

При использовании в кластере SATA-дисков сжатие снижает IO-нагрузку на диск.

Подробнее о сжатии spill-файлов см. в разделе Сжатие.

Лимит дополнительной памяти для всех сжатых spill-файлов из одного набора, в килобайтах. При достижении лимита последующие файлы не сжимаются. 0 отключает лимит.

См. также Сжатие.

Максимальное количество временных spill-файлов на запрос на сегмент. Файлы создаются при исчерпании доступной запросу памяти. При превышении лимита запрос завершается.

0 — без ограничений.

Максимальный размер диска для временных spill-файлов одного запроса на каждом сегменте, в килобайтах. По умолчанию 0 — лимит не применяется.

Максимальный общий размер диска для всех выполняемых запросов на spill-файлы на каждом сегменте, в килобайтах. По умолчанию 0 — лимит не применяется.

Время ожидания (в секундах) до возврата ошибки при попытке подключения или записи на сервер gpfdist, а gpfdist не отвечает. По умолчанию 300 (5 минут). 0 отключает тайм-аут.

Задает номер порта для gpperfmon.

Действует только при включенном data_checksums.

Greengage DB использует контрольные суммы для предотвращения загрузки поврежденных данных из файловой системы в память СУБД.

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

По умолчанию off, изменяется только суперпользователем.

Показывает, собран ли PostgreSQL с поддержкой 64-битных целочисленных дат/времени.

Задает формат вывода значений интервалов:

Подробнее см. в разделе Date/Time Types документации PostgreSQL.

Планировщик Postgres переписывает явные выражения JOIN в списки FROM-элементов, если размер итогового возвращаемого списка не превышает это значение. По умолчанию равно from_collapse_limit, что подходит для большинства случаев. Значение 1 запрещает переупорядочивание JOIN. Значения между 1 и from_collapse_limit — компромисс времени планирования и качества плана (более высокие значения приводят к лучшим планам).

Определяет, обрабатывать ли имена пользователей Kerberos без учета регистра. По умолчанию учитывается регистр (off).

Задает расположение файла ключа сервера Kerberos.

См. также GSSAPI-аутентификация с использованием FreeIPA.

Показывает локаль сортировки текстовых данных. Значение определяется при инициализации кластера Greengage DB.

Показывает локаль классификации символов. Значение определяется при инициализации кластера Greengage DB.

Задает язык сообщений. Доступны локали, установленные в операционной системе; их можно посмотреть командой locale -a. Значение по умолчанию наследуется от окружения сервера. В некоторых системах категория отсутствует. В этом случае значение параметра ни на что не влияет. Кроме того, возможно отсутствие переводов на выбранный язык. В этом случае сообщения будут выводиться на английском.

Задает локаль форматирования денежных сумм, например, при использовании функций to_char. Доступны локали, установленные в операционной системе; их можно посмотреть командой locale -a. Значение по умолчанию наследуется от окружения сервера.

Задает локаль форматирования чисел, например, при использовании функций to_char. Доступны локали, установленные в операционной системе; их можно посмотреть командой locale -a. Значение по умолчанию наследуется от окружения сервера.

Задает локаль форматирования значений дат и времени.

Задает TCP/IP-адреса для прослушивания подключений клиентов в виде списка имена хостов или IP-адресов через запятую. Значение * соответствует всем доступным IP-интерфейсам. Пустой список — подключения возможны только через сокеты домена Unix.

Список библиотек для загрузки в начале клиентской сессии; разделяется запятыми.

Прерывает команду при ожидании блокировки таблицы, индекса, строки или другого объекта дольше указанного времени в миллисекундах. Лимит применяется к каждой попытке блокировки отдельно. Применяется как к явным запросам блокировок (LOCK TABLE, SELECT FOR UPDATE), так и к неявным блокировкам. При log_min_error_statement=ERROR или ниже прерванная команда логируется. Значение 0 (по умолчанию) отключает мониторинг ожидания блокировок.

В отличие от statement_timeout, срабатывает только при ожидании блокировок. При ненулевом statement_timeout установка такого же или большего значения lock_timeout бессмысленна, поскольку тайм-аут выражения наступит раньше.

Greengage DB использует deadlock_timeout и gp_global_deadlock_detector_period для определения локальных и глобальных взаимоблокировок. Если значение lock_timeout меньше этих тайм-аутов, Greengage DB прервет команду до проверки взаимоблокировок.

Логирует информацию об автоматических операциях ANALYZE, связанных с gp_autostats_mode и gp_autostats_on_change_threshold.

Задает минимальное время выполнения (в миллисекундах), выше которого действия автоматического вакуумирования (autovacuum) логируются. 0 — логируются все действия. -1 отключает логирование.

Включает логирование контрольных точек и точек перезапуска сервера. Сообщения лога включают статистику: количество записанных буферов и время записи.

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

Выводит в лог сервера строку при завершении клиентской сессии с указанием длительности сессии.

При значении on добавляет в лог подробное сообщение о передаче оператора.

Логирует длительность каждого завершенного оператора, удовлетворяющего log_statement.

Контролирует детальность сообщений в журнале сервера.