この付録と次の付録にはPostgreSQL配布物のcontribディレクトリにあるモジュールに関する情報があります。 ここには、移植用のツール、解析ユーティリティ、限定した利用者を対象にしていること、または、主ソースツリーに含めるには実験的すぎることが主な理由でPostgreSQLのコアシステムにはないプラグイン機能が含まれます。 これはその有用性を妨げるものではありません。

この付録では、contribにあるエクステンションやその他のサーバプラグインモジュールを説明します。 付録Gは、ユーティリティプログラムをカバーしています。

ソース配布から構築する場合、"world"を対象に構築しない限り、これらのモジュールは自動的に構築されません(ステップ 2参照)。 次のコマンドを実行することで、これらすべてを構築しインストールすることができます。

make
make install

設定されたソースツリーのcontribディレクトリにあります。 あるいは、選択した1つのモジュールのみを構築しインストールするには、そのモジュールのサブディレクトリで同じコマンドを行ってください。 多くのモジュールにはリグレッションテストがあり、以下を

make check

インストール前に実行、または以下を

make installcheck

PostgreSQLサーバが動いている状態で実行できます。

PostgreSQLのパッケージ化されたバージョンを使用している場合は通常、例えばpostgresql-contribのような別途副パッケージとしてこれらのモジュールが利用可能です。

多くのモジュールは新しいユーザ定義関数、演算子、型を提供します。 こうしたモジュールの1つを使用できるようにするためには、コードをインストールした後に、新しいSQLオブジェクトをデータベースサーバに登録する必要があります。 これはCREATE EXTENSIONコマンドを実行することで行われます。 新しいデータベースでは、以下のように簡単に行うことができます。

CREATE EXTENSION module_name;

このコマンドは現在のデータベースの中にのみ新しいSQLオブジェクトを登録します。 このため、そのモジュールの機能を利用可能にさせたいデータベース毎にこのコマンドを実行しなければなりません。 その拡張が今後作成されるデータベースにデフォルトでコピーされるようにtemplate1データベースに対して実行する方法もあります。

これら全てのモジュールについてCREATE EXTENSIONはデータベーススーパーユーザによって実行される必要がありますが、モジュールが「trusted」と見なされる場合は現在のデータベースに対してCREATE権限を持つユーザであれば誰でも実行することができます。 信頼されているモジュールは、以降の節でそのように識別されています。 一般的に信頼されているモジュールとは、データベース外の機能へのアクセスを提供できないモジュールのことです。

多くのモジュールはユーザが選択したスキーマ内にそのオブジェクトをインストールすることができます。 これを行うためにはCREATE EXTENSIONコマンドにSCHEMA schema_nameを追加してください。 デフォルトでは、オブジェクトは現在の作成対象スキーマ内に格納され、そのスキーマのデフォルトはpublicです。

しかしながら、いくつかのモジュールはこの意味での「エクステンション」ではなく、例えばshared_preload_librariesといった他の方法でサーバにロードされることに注意してください。 各モジュールの詳細はドキュメントを参照してください。