Описание

postgres - это сервер баз данных Tantor BE. Чтобы клиентское приложение могло получить доступ к базе данных, оно подключается (через сеть или локально) к запущенному экземпляру postgres. Затем экземпляр postgres запускает отдельный серверный процесс для обработки соединения.

Каждый экземпляр postgres всегда управляет данными ровно одного кластера баз данных. Кластер баз данных - это набор баз данных, хранящихся в общем месте файловой системы (область “данных”). На одной системе может работать несколько экземпляров postgres одновременно, при условии, что они используют разные области данных и разные порты для обмена данными (см. ниже). При запуске postgres необходимо знать местоположение области данных. Местоположение должно быть указано с помощью опции -D или переменной среды PGDATA; нет значения по умолчанию. Обычно -D или PGDATA указывают непосредственно на каталог области данных, созданный initdb. Другие возможные варианты расположения файлов обсуждаются в Раздел 18.2.

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

Команда postgres также может быть вызвана в однопользовательском режиме. Основное использование этого режима - во время загрузки системы с помощью initdb. Иногда он используется для отладки или восстановления после сбоя; следует отметить, что запуск однопользовательского сервера не является идеальным для отладки сервера, так как реалистичное взаимодействие между процессами и блокировка не происходят. При вызове в однопользовательском режиме из оболочки пользователь может вводить запросы, и результаты будут выводиться на экран, но в форме, которая более полезна для разработчиков, чем для конечных пользователей. В однопользовательском режиме сессийый пользователь будет установлен для пользователя с идентификатором 1, и этому пользователю будут предоставлены неявные привилегии суперпользователя. Этот пользователь на самом деле не обязан существовать, поэтому однопользовательский режим может использоваться для ручного восстановления после определенного вида случайного повреждения системных каталогов.

Опции

postgres принимает следующие аргументы командной строки. Для подробного обсуждения опций см. Глава 18. Вы можете сэкономить время, набирая большинство из этих опций, настроив файл конфигурации. Некоторые (безопасные) опции также могут быть установлены из подключающегося клиента способом, зависящим от приложения, чтобы применяться только для этой сессии. Например, если переменная среды PGOPTIONS установлена, то клиенты на основе libpq передадут эту строку серверу, который будет интерпретировать ее как опции командной строки postgres.

Окружение

Диагностика

Сообщение об ошибке, упоминающее semget или shmget, вероятно, указывает на то, что вам нужно настроить ваше ядро для предоставления достаточного количества общей памяти и семафоров. Для получения дополнительной информации см. Раздел 17.4. Возможно, вы сможете отложить перенастройку ядра, уменьшив значение shared_buffers для уменьшения потребления общей памяти Tantor BE и/или уменьшив значение max_connections для уменьшения потребления семафоров.

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

$ ps ax | grep postgres

или

$ ps -ef | grep postgres

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

Сообщение об ошибке, указывающее на невозможность привязки к порту, может указывать на то, что этот порт уже используется каким-то другим процессом, не связанным с PostgreSQL. Также можно получить эту ошибку, если вы завершите postgres и сразу же перезапустите его, используя тот же порт; в этом случае вам просто нужно подождать несколько секунд, пока операционная система не закроет порт, прежде чем попытаться снова. Наконец, вы можете получить эту ошибку, если вы указываете номер порта, который ваша операционная система считает зарезервированным. Например, многие версии Unix считают порты с номерами меньше 1024 "доверенными" и разрешают доступ к ним только суперпользователю Unix.

Примечания

Утилита-команда pg_ctl может быть использована для безопасного и комфортного запуска и остановки сервера postgres.

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

Для нормального завершения сервера postgres можно использовать сигналы SIGTERM, SIGINT или SIGQUIT. Первый сигнал будет ждать завершения всех клиентов перед выходом, второй принудительно отключит всех клиентов, а третий немедленно завершит работу без правильного выключения, что приведет к запуску процедуры восстановления при перезапуске.

Сигнал SIGHUP перезагружает файлы конфигурации сервера. Также возможно отправить сигнал SIGHUP отдельному процессу сервера, но это обычно не имеет смысла.

Чтобы отменить выполняющийся запрос, отправьте сигнал SIGINT процессу, выполняющему эту команду. Чтобы корректно завершить бэкенд-процесс, отправьте сигнал SIGTERM этому процессу. См. также функции pg_cancel_backend и pg_terminate_backend в разделе Раздел 9.27.2 для SQL-совместимых эквивалентов этих двух действий.

Сервер postgres использует сигнал SIGQUIT для указания подчиненным процессам сервера завершиться без нормальной очистки. Этот сигнал не должен использоваться пользователями. Также не рекомендуется отправлять сигнал SIGKILL процессу сервера - основной процесс postgres будет интерпретировать это как сбой и принудительно завершит все сопряженные процессы в рамках процедуры восстановления после сбоя.

Ошибки

Опции -- не будут работать в операционных системах FreeBSD или OpenBSD. Вместо этого используйте опцию -c. Это ошибка в затронутых операционных системах; будущая версия Tantor BE предоставит обходное решение, если это не будет исправлено.

Однопользовательский режим

Для запуска сервера в однопользовательском режиме используйте команду вида

postgres --single -D /usr/local/pgsql/data other-options my_database

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

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

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

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

Чтобы завершить сессию, введите EOF (обычно используется сочетание клавиш Control+D). Если вы ввели какой-либо текст с момента последнего завершающего символа команды, то EOF будет принят как завершающий символ команды, и для выхода потребуется еще один EOF.

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

Примеры

Чтобы запустить postgres в фоновом режиме с использованием значений по умолчанию, введите:

$ nohup postgres >logfile 2>&1 </dev/null &

Для запуска postgres с определенным портом, например, 1234:

$ postgres -p 1234

Для подключения к этому серверу с помощью psql укажите этот порт с помощью опции -p:

$ psql -p 1234

или установите переменную среды PGPORT:

$ export PGPORT=1234
$ psql

Именованные параметры времени выполнения могут быть установлены в любом из этих стилей:

$ postgres -c work_mem=1234
$ postgres --work-mem=1234

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

См. также

initdb, pg_ctl