| Документация по PostgreSQL 8.4.2 | ||||
|---|---|---|---|---|
| Prev | Fast Backward | Fast Forward | Next | |
Данное приложение содержит информацию о модулях, которые находятся в каталоге contrib дистрибутива PostgreSQL. Они включают инструменты портирования, утилиты анализа и встраеваемые возможности, которые не являются частью ядра системы PostgreSQL, в основном потому, что они предназначены для узкого круга пользователей или находятся на слишком экспериментальной стадии, чтобы быть частью главного дерева исходных текстов. Однако, это не означает, что их нельзя использовать.
Когда происходит сборка из исходных кодов, эти модули не собираются автоматически. Вы можете собрать и установить их все запустив:
gmake gmake install
в каталоге contrib дерева исходных текстов; или собрать и установить только выборочные модули, выполнив те же самые команды в подкаталогах модулей. Многие из этих модулей имеют регрессивные тесты, которые могут быть запущены командами:
gmake installcheck
один раз при запуске сервера PostgreSQL. (Обратите внимание, что gmake check не поддерживаеся; чтобы выполнить тестирование, вы должны иметь работающий сервер баз данных для выполнения этих тестов и собранные и установленные модули.)
Если вы испольузете уже готовый пакет PostgreSQL, данные модули обычно сделаны доступными в виде отдельного подпакет, такого как postgresql-contrib.
Многие модули предоставляют новые функции определённые пользователем, операторы или типы. Чтобы сделать возможным использование одного из этих модулей, после того как вы установили код, вам нужно зарегистрировать новые объекты в СУБД, с помощью запуска SQL команд в файле .sql, которые предоставляется модулем. Например:
psql -d dbname -f SHAREDIR/contrib/module.sql
Здесь, SHAREDIR означает "share" каталог установки (pg_config --sharedir ответит вам что это за каталог). В большинстве случаев этот скрипт должен быть запущен суперпользователем СУБД.
Вам необходимо запустить .sql файл в каждой базе данных, для которой вы хотите сделать доступной функциональность модуля. В качестве альтернативы, запустить его в базе данных template1, чтобы модуль в будущем по умолчанию копировался в создаваемые затем базы данных.
Вы можете изменить первую команду в .sql файле, чтобы указать схему в базе данных, для которой будут созданы объекты модуля. По умолчанию, они помещаются в схему public.
После обновлений подверсий в рамках одной версии PostgreSQL, запускайте установочный скрипт снова, даже если объекты модуля могут быть переданы из старой подверсии с помощью dump и restore. Это позволит вам получить уверенность, что любые новые функции в модуле будут доступны, а все необходимые изменения будут выполнены.