Если вы думаете о распространении своих модулей расширения Tantor SE-1C, настройка портативной системы сборки для них может быть довольно сложной. Поэтому установка Tantor SE-1C предоставляет инфраструктуру сборки для расширений, называемую PGXS, чтобы простые модули расширения могли быть построены просто на уже установленном сервере. PGXS предназначен в основном для расширений, включающих код на C, хотя его можно использовать и для расширений, состоящих только из SQL. Обратите внимание, что PGXS не предназначен для универсальной системы сборки, которая может использоваться для сборки любого программного обеспечения, взаимодействующего с Tantor SE-1C; он просто автоматизирует общие правила сборки для простых модулей расширения сервера. Для более сложных пакетов вам может потребоваться написать свою собственную систему сборки.

Для использования инфраструктуры PGXS для вашего расширения, необходимо написать простой makefile. В makefile вам нужно установить некоторые переменные и включить глобальный makefile PGXS. Вот пример, который создает модуль расширения с именем isbn_issn, состоящий из общей библиотеки, содержащей некоторый код на языке C, файла управления расширением, SQL-скрипта, файла включения (требуется только в случае, если другие модули могут обращаться к функциям расширения без использования SQL) и текстового файла документации.

MODULES = isbn_issn
EXTENSION = isbn_issn
DATA = isbn_issn--1.0.sql
DOCS = README.isbn_issn
HEADERS_isbn_issn = isbn_issn.h

PG_CONFIG = pg_config
PGXS := $(shell $(PG_CONFIG) --pgxs)
include $(PGXS)

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

Установите одну из этих трех переменных, чтобы указать, что нужно построить:

Следующие переменные также могут быть установлены:

Поместите данный сборочный файл Makefile в каталог, который содержит ваше расширение. Затем вы можете выполнить make для компиляции и make install для установки вашего модуля. По умолчанию расширение компилируется и устанавливается для установки Tantor SE-1C, соответствующей первой программе pg_config, найденной в вашем PATH. Вы можете использовать другую установку, установив переменную PG_CONFIG, указывающую на программу pg_config, либо внутри makefile, либо в командной строке make.

Также можно запустить make в каталоге, находящемся вне исходного дерева вашего расширения, если нужно сохранить отдельный каталог сборки. Эта процедура также называется VPATH build. Вот как:

mkdir build_dir
cd build_dir
make -f /path/to/extension/source/tree/Makefile
make -f /path/to/extension/source/tree/Makefile install

В качестве альтернативы, вы можете настроить каталог для сборки с использованием VPATH аналогично тому, как это делается для основного кода. Один из способов сделать это - использовать скрипт ядра config/prep_buildtree. После выполнения этого действия вы можете собрать, установив переменную make VPATH следующим образом:

make VPATH=/path/to/extension/source/tree
make VPATH=/path/to/extension/source/tree install

Эта процедура может работать с большим разнообразием структур каталогов.

Скрипты, перечисленные в переменной REGRESS, используются для регрессионного тестирования вашего модуля, которое может быть вызвано с помощью команды make installcheck после выполнения команды make install. Для этого необходимо иметь работающий сервер Tantor SE-1C. Файлы скриптов, перечисленные в переменной REGRESS, должны находиться в подкаталоге с именем sql/ в каталоге вашего расширения. Эти файлы должны иметь расширение .sql, которое не должно быть включено в список REGRESS в файле makefile. Для каждого теста также должен быть файл с ожидаемым выводом в подкаталоге с именем expected/, с тем же именем и расширением .out. Команда make installcheck выполняет каждый тестовый скрипт с помощью утилиты psql и сравнивает полученный вывод с соответствующим ожидаемым файлом. Любые различия будут записаны в файл regression.diffs в формате diff -c. Обратите внимание, что попытка запустить тест, для которого отсутствует ожидаемый файл, будет отмечена как “проблема”, поэтому убедитесь, что у вас есть все ожидаемые файлы.

Скрипты, перечисленные в переменной ISOLATION, используются для тестирования поведения параллельных сессий с вашим модулем, которые можно вызвать с помощью команды make installcheck после выполнения команды make install. Для этого должен быть запущен сервер Tantor SE-1C. Файлы скриптов, перечисленные в переменной ISOLATION, должны находиться в подкаталоге specs/ в каталоге вашего расширения. Эти файлы должны иметь расширение .spec, которое не должно быть включено в список ISOLATION в файле makefile. Для каждого теста также должен быть файл с ожидаемым выводом в подкаталоге expected/ с тем же именем и расширением .out. Команда make installcheck выполняет каждый тестовый скрипт и сравнивает полученный вывод с соответствующим ожидаемым файлом. Любые различия будут записаны в файле output_iso/regression.diffs в формате diff -c. Обратите внимание, что попытка запустить тест, для которого отсутствует ожидаемый файл, будет отображена как “проблема”, поэтому убедитесь, что у вас есть все ожидаемые файлы.

TAP_TESTS enables the use of TAP tests. Data from each run is present in a subdirectory named tmp_check/