FPT PostgreSQL でサポートされている extension を使用する
FPT Database Engine では、プリインストールされた PostgreSQL extension により、ジョブのスケジュール実行、監査、データ同期から vector 検索、空間データの処理まで、運用とデータ処理のさまざまなニーズに合わせて database の機能を拡張できます。extension は Database Engine レベルでプリインストールされており、必要な extension を SQL コマンドで有効化します。
適用範囲
- 2026年11月20日以降に作成された PostgreSQL cluster には、サポート対象の extension がプリインストールされています。
- 2026年11月20日より前に作成された PostgreSQL cluster には、extension はプリインストールされていません。既存の cluster でこれらの extension を使用したい場合は、FPT Support にお問い合わせください。対応可否を確認し、適切な方法をご案内します。
- プリインストールされていても、有効化されているわけではありません。extension を使用する database で
CREATE EXTENSIONを実行する必要があります。
サポート対象の extension
| Extension | 説明 | PostgreSQL 17 | PostgreSQL 16 | PostgreSQL 15 | PostgreSQL 14 |
|---|---|---|---|---|---|
pg_cron | PostgreSQL 内で SQL ステートメントを定期的に実行するジョブスケジューラーです。 | 1.6.8 | 1.6.8 | 1.6.8 | 1.6.8 |
pg_partman | 時間または ID に基づく partition を管理し、partition の作成と保守を自動化します。 | 5.5.0 | 5.5.0 | 5.5.0 | 5.5.0 |
pg_partman_bgw | pg_partman の保守処理を自動で実行する background worker です。 | 5.5.0 | 5.5.0 | 5.5.0 | 5.5.0 |
pgaudit | 監査とコンプライアンスのために、database へのアクセスと操作を記録します。 | 17.1 | 16.1 | 1.7.1 | 1.6.3 |
pglogical | PostgreSQL database 間の logical replication を提供します。 | 2.4.8 | 2.4.8 | 2.4.8 | 2.4.8 |
pgvector (vector) | vector を保存し、AI・RAG アプリケーション向けの similarity search を実行します。 | 0.8.7 | 0.8.7 | 0.8.7 | 0.8.7 |
PostGIS (postgis) | 地理空間データの保存、処理、クエリを可能にします。 | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
postgis_raster | GIS システムで raster データを保存、処理します。 | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
postgis_tiger_geocoder | 米国の TIGER データに基づく geocoding と逆 geocoding を提供します。 | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
postgis_topology | 空間データの topology を管理、処理します。 | 3.6.4 | 3.6.4 | 3.6.4 | 3.6.4 |
pgrouting | PostGIS データ上でルート計算と地理的なネットワーク分析を行う機能を追加します。 | 4.0.2 | 4.0.2 | 4.0.2 | 4.0.2 |
コード形式で表記した名前が、CREATE EXTENSION に指定する名前です。pgvector の場合は pgvector ではなく vector を指定します。
前提条件
- 2026年11月20日以降に作成された PostgreSQL cluster。
psql、pgAdmin、またはその他の PostgreSQL クライアントで、extension を使用する database に接続していること。Floating IP で database に接続するを参照してください。- database への接続に使用するアカウントに、extension を作成する権限が付与されていること。
- 使用中の PostgreSQL バージョンについて、サポート対象の extension に記載されている extension であること。
利用可能な extension を確認する
対象の database で次のクエリを実行します。サポート対象の extension が default_version とともに表示されます。installed_version に値がある場合、その extension はこの database で有効化済みです。
SELECT name, default_version, installed_version, comment
FROM pg_available_extensions
ORDER BY name;
extension を有効化する
EXTENSION_NAME をサポート対象一覧の名前に置き換えます。
CREATE EXTENSION IF NOT EXISTS EXTENSION_NAME;
たとえば、pgvector と PostGIS を有効化するには次のように実行します。
CREATE EXTENSION IF NOT EXISTS vector;
CREATE EXTENSION IF NOT EXISTS postgis;
一部の extension は、事前に別の extension の有効化または parameter の設定が必要です。有効化する前に dependency のある extension を確認してください。
有効化済みの extension を確認する
SELECT extname, extversion
FROM pg_extension
ORDER BY extname;
psql では、代わりに \dx を実行することもできます。
extension は現在の database でのみ有効化されます。別の database で使用するには、その database に接続して CREATE EXTENSION を再度実行してください。
extension を削除する
extension が不要になった場合は、次のコマンドで削除できます。
DROP EXTENSION IF EXISTS EXTENSION_NAME;
extension を削除すると、vector 型や geometry 型の列など、その extension に依存する database オブジェクトに影響する場合があります。DROP EXTENSION を実行する前に、依存関係を確認してください。
dependency のある extension
一部の extension は、別の extension または engine の parameter に依存しています。使用する extension を有効化する前に、依存する extension を有効化するか、適切な parameter を設定してください。
| Extension | Dependency | 注意事項 |
|---|---|---|
pg_partman_bgw | pg_partman | pg_partman_bgw は pg_partman の background worker であり、独立した SQL extension ではありません。CREATE EXTENSION pg_partman を実行すれば worker も利用できます。個別に CREATE EXTENSION を実行する必要はありません。 |
pglogical | parameter wal_level = logical | パラメータ設定の手順に従い、Parameters タブで wal_level を変更します。この変更を反映するには PostgreSQL の再起動が必要なため、影響を抑えるためにオフピーク時間帯に実施してください。 |
postgis_raster、postgis_tiger_geocoder、postgis_topology、pgrouting | postgis | 先に PostGIS を有効化してから、PostGIS に依存する extension を有効化します。 |
よくあるエラーと対処方法
| 症状 | 考えられる原因 | 対処方法 |
|---|---|---|
extension が pg_available_extensions に表示されない。 | cluster が 2026年11月20日より前に作成された、または使用中の PostgreSQL バージョンでその extension がサポートされていない。 | cluster の作成日と PostgreSQL バージョンを確認し、FPT Support にお問い合わせください。 |
permission denied to create extension | アカウントに extension を作成する権限がない。 | 接続に使用しているアカウントの database 権限を確認してください。 |
must be loaded via shared_preload_libraries | extension に Database Engine レベルの設定が必要。 | 設定の確認について FPT Support にお問い合わせください。 |
extension already exists | extension はこの database ですでに有効化されている。 | 有効化済みの extension を確認するのクエリで確認してください。 |
次のステップ
- パラメータ設定。
pglogicalを使用する前にwal_level = logicalを設定します - Backup & Restore の概要。データが依存している extension を削除する前に backup を取得します