Быстрый старт
Развертывание
Моделирование данных
Подключение
Запись данных
Миграция
Запросы
Операции и обслуживание
Типовое обслуживание
Секционирование
Резервное копирование и восстановление
Масштабирование
Зеркалирование
Управление ресурсами
Безопасность
Мониторинг
Настройка производительности
Устранение неполадок
Справочник
Руководство по инструментам
Типы данных
Хранилище данных
Выполняющая система
Потоковая передача
Восстановление после сбоев
Конфигурация
Индексы
Расширения
Справочник по SQL
Часто задаваемые вопросы
Утилита gpconfig позволяет пользователям устанавливать, сбрасывать или просматривать параметры конфигурации в файлах postgresql.conf на всех экземплярах кластера YMatrix (Master, Segments и Mirrors). При установке параметра можно дополнительно указать отдельное значение для Master. Например, параметр max_connections требует разного значения на Master и на Segments. Используйте опцию --masteronly, чтобы задать или сбросить глобальные параметры либо параметры, применяемые только к Master.
Не все параметры могут быть настроены с помощью gpconfig. Например, нельзя использовать её для установки параметра port, который различается для каждого экземпляра Segment. Воспользуйтесь опцией -l, чтобы отобразить полный список поддерживаемых параметров конфигурации.
Когда параметр устанавливается с помощью gpconfig, его значение добавляется в конец файла postgresql.conf. Когда параметр удаляется с помощью gpconfig, он комментируется в файле postgresql.conf, и используется значение по умолчанию. Если вы удалите параметр, а затем позже снова добавите его с новым значением, в файле postgresql.conf будет существовать две записи: одна закомментированная, другая — активная в конце файла.
После установки параметра может потребоваться перезапуск кластера или перезагрузка файла postgresql.conf, чтобы изменения вступили в силу. Требуется ли перезапуск, зависит от конкретного параметра.
Чтобы отобразить текущее значение параметра в системе, используйте опцию -s.
Если при изменении параметра с помощью gpconfig вы получаете следующую ошибку:
GUC Validation Failed: mars3.degrade_min_run_size cannot be changed under normal conditions. Please refer to gpconfig documentation.это означает, что параметр защищён. Чтобы изменение вступило в силу, необходимо добавить опцию --skipvalidation. Например:
gpconfig -c optimizer_force_multistage_agg -v false --skipvalidationДля подключения к экземпляру MXMaster и получения конфигурации системы gpconfig использует следующие переменные окружения:
| Опция | Описание |
|---|---|
| -c param_name или --change param_name | Изменяет параметр конфигурации, добавляя новую запись в конец файла postgresql.conf |
| -v value или --value value | Задаёт значение параметра, указанного опцией -c. По умолчанию это значение применяется ко всем Segments, Mirrors, Master и Standby. Значения параметров, не являющиеся одиночными символами или цифрами, должны быть заключены в одинарные кавычки (''). Для строк, содержащих пробелы или специальные символы, используйте двойные одинарные кавычки или обратный слеш для экранирования ('' или \') |
| -m master_value или --mastervalue master_value | Устанавливает отдельное значение для Master и Standby при настройке параметра, отличное от значения, используемого на Segments |
| --masteronly | Если указано, gpconfig изменяет только файл postgresql.conf на Master |
| -r param_name или --remove param_name | Удаляет параметр конфигурации, комментируя его в файле postgresql.conf |
| -l или --list | Отображает все параметры конфигурации, которые можно изменить с помощью gpconfig |
| -s param_name или --show param_name | Показывает текущее значение указанного параметра конфигурации на всех экземплярах (Master и Segments) в кластере YMatrix. Отображаемое значение отражает текущую активную настройку; если кластер не был перезапущен после изменения, показывается старое значение |
| --file | Отображает значение параметра, как оно определено в файле postgresql.conf на всех экземплярах (Master и Segments). Эти значения могут быть ещё неактивны, если кластер не был перезапущен. Нельзя использовать вместе с опцией --file-compare |
| --file-compare | Сравнивает текущее активное значение параметра в кластере YMatrix (Master и Segments) со значением в файле postgresql.conf. Если значения различаются, отображаются значения со всех хостов. Если совпадают — выводится сводный отчёт. Нельзя использовать вместе с опцией --file |
| --skipvalidation | Пропускает проверки корректности при установке параметра. Используйте эту опцию с осторожностью |
| --verbose | Отображает дополнительную информацию в логах во время выполнения команды |
| --debug | Устанавливает уровень вывода логов в режим отладки |
| ? или -h или --help | Отображает справочную информацию |
Просмотр конфигурации shared_buffers:
gpconfig -s shared_buffersУстановка gp_resource_manager в значение queue:
gpconfig -c gp_resource_manager -v queueУстановка max_connections в 180 на Segments и 60 на Master:
gpconfig -c max_connections -v 180 -m 60