이 부록과 다음 부록에는 PostgreSQL 배포판의 contrib 디렉터리에 포함 되어 있는 확장 모듈과 확장 응용 프로그램들에 대한 정보를 다룬다. 여기서는 소개하고 있는 포팅 도구들, 분석 도구들, 기본 PostgreSQL 시스템에 포함되어 있지 않은 부가 모듈들은 실험적이거나, 범용적이지 않은 것들이지만, 유용하게 쓰일 수 있으며, 충분히 안정적이다.

여기서는 contrib 안에 있는 서버 확장 모듈들에 대해서 소개한다. 부가 확장 응용 프로그램에 대해서는 부록 G에서 소개한다.

소스 배포판에서 이 확장 모듈들은 자동으로 만들어지지 않는다. 만들려면, "world" 타켓을 지정해야한다 (단계 2 참조). contrib 디렉터리에서 직접 만들고 설치하려면:

make
make install

이 작업은 먼저 configure 명령으로 빌드 환경이 구축되어야 한다. 각 개별 모듈을 각각 설치하려면, 그 해당 디렉터리로 이동해서 같은 작업을 하면 된다. 또한 많은 모듈들이 단위 테스트를 지원함으로 이 작업을 하려면 다음 명령어로 진행할 수 있다:

make check

설치 전 테스트는 다음과 같이 한다:

make installcheck

이 작업은 PostgreSQL 서버가 실행 중이어야 한다.

미리 컴파일 된 패키지들로 이 모듈을 설치하려면, PostgreSQL 패키지들 가운데, postgresql-contrib 이름으로 패키지 이름으로 대부분 배포된다. 이것을 설치하면 된다.

많은 모듈들이 새로운 사용자 정의 함수, 연산자, 자료형을 제공한다. 이 모듈에서 제공하는 이것들을 사용하려면, 코드에서 설치를 끝내고 나서 데이터베이스 시스템에 새로운 SQL 객체들을 등록해 주어야 사용할 수 있다. 이런 일련의 작업을 CREATE EXTENSION 명령어로 손쉽게 할 수 있다. 새로운 확장 모듈을 해당 데이터베이스 설치하려면, 데이터베이스 접속 후 다음과 같은 명령을 실행하면 된다:

CREATE EXTENSION 확장모듈이름;

이 작업은 현재 접속해 있는 데이터베이스에 한정 되어 작동한다. 필요하다면, 서버에 있는 여러 데이터베이스에 해당 모듈을 사용하고싶다면, 각각 이 명령을 실행해 주거나, template1 데이터베이스에 설치해서 새로 만들어지는 데이터베이스에 대해서는 자동으로 설치되도록 할 수도 있을 것이다.

“trusted” 표시가된 모듈이 아니면, 신뢰할 수 없는 모듈임으로 이런 모듈들은 데이터베이스 슈퍼유저이거나, 해당 데이터베이스를 대상으로 CREATE 권한이 있는 사용자만 설치할 수 있다. 신뢰할 수 있는 모듈은 다음 다음 섹션들에서 각각 언급한다. 일반적으로, 신뢰할 수 있는 모듈이란 데이터베이스 범위 밖의 일은 하지 못하도록 기능이 한정적인 것들을 말한다.

많은 모듈들은 설치될 스키마를 직접 지정할 수 있도록 한다. 이렇게 하려면, CREATE EXTENSION 명령 구문에, SCHEMA 스키마이름 형태로 추가해 주면 된다. 이 값을 지정하지 않으면, public 스키마에 필요한 객체들이 만들어진다.

하나 주의할 사항은 몇 확장 모듈은 shared_preload_libraries 환경 설정 값으로 해당 라이브러리가 서버 실행 시 먼저 로딩 되어야하는 경우도 있다. 이런 모듈들은 개별 모듈 설명서에서 소개하고 있으니, 그 부분을 참고 해야한다.