メインコンテンツまでスキップ

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 17PostgreSQL 16PostgreSQL 15PostgreSQL 14
pg_cronPostgreSQL 内で SQL ステートメントを定期的に実行するジョブスケジューラーです。1.6.81.6.81.6.81.6.8
pg_partman時間または ID に基づく partition を管理し、partition の作成と保守を自動化します。5.5.05.5.05.5.05.5.0
pg_partman_bgwpg_partman の保守処理を自動で実行する background worker です。5.5.05.5.05.5.05.5.0
pgaudit監査とコンプライアンスのために、database へのアクセスと操作を記録します。17.116.11.7.11.6.3
pglogicalPostgreSQL database 間の logical replication を提供します。2.4.82.4.82.4.82.4.8
pgvector (vector)vector を保存し、AI・RAG アプリケーション向けの similarity search を実行します。0.8.70.8.70.8.70.8.7
PostGIS (postgis)地理空間データの保存、処理、クエリを可能にします。3.6.43.6.43.6.43.6.4
postgis_rasterGIS システムで raster データを保存、処理します。3.6.43.6.43.6.43.6.4
postgis_tiger_geocoder米国の TIGER データに基づく geocoding と逆 geocoding を提供します。3.6.43.6.43.6.43.6.4
postgis_topology空間データの topology を管理、処理します。3.6.43.6.43.6.43.6.4
pgroutingPostGIS データ上でルート計算と地理的なネットワーク分析を行う機能を追加します。4.0.24.0.24.0.24.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 を設定してください。

ExtensionDependency注意事項
pg_partman_bgwpg_partmanpg_partman_bgw は pg_partman の background worker であり、独立した SQL extension ではありません。CREATE EXTENSION pg_partman を実行すれば worker も利用できます。個別に CREATE EXTENSION を実行する必要はありません。
pglogicalparameter wal_level = logicalパラメータ設定の手順に従い、Parameters タブで wal_level を変更します。この変更を反映するには PostgreSQL の再起動が必要なため、影響を抑えるためにオフピーク時間帯に実施してください。
postgis_raster、postgis_tiger_geocoder、postgis_topology、pgroutingpostgis先に 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_librariesextension に Database Engine レベルの設定が必要。設定の確認について FPT Support にお問い合わせください。
extension already existsextension はこの database ですでに有効化されている。有効化済みの extension を確認するのクエリで確認してください。

次のステップ​

関連リソース​