最終更新日 2024年05月31日(金)

拡張機能では、機能の関連する部分 (データ型や関数など) をまとめてバンドルし、1 つのコマンドでデータベースにインストールすることができます。Heroku Postgres は、多くの Postgres 拡張機能のほか、拡張機能システムの一部としてバンドルされていないフルテキスト検索などの機能をサポートしています。PostGIS 空間データベース拡張機能も使用できます。この記事の次の拡張機能のみがサポートされており、Heroku Postgres にインストールできます。

サポートされている拡張機能の一覧については、データベースのクエリを実行してください。

$ echo 'show extwlist.extensions' | heroku pg:psql
     extwlist.extensions
-----------------------------
...bloom,btree_gin,btree_gist,cube,dblink,dict_int...

拡張機能のインストール

いずれかのサポートされている拡張機能を作成するには、heroku pg:psql​ でセッションを開き、適切な CREATE EXTENSION​ コマンドを実行します。

$ heroku pg:psql DATABASE_URL -a example-app
--> Connecting to postgresql-octagonal-12345
psql (13.2, server 11.12 (Ubuntu 11.12-1.pgdg16.04+1))
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

example-app::DATABASE=> CREATE EXTENSION hstore;
CREATE EXTENSION
example-app::DATABASE=>

すべてのプランのすべての Heroku Postgres データベースで、拡張機能はデフォルトで public​ スキーマにインストールされます。特定のスキーマに拡張機能をインストールするには、CREATE EXTENSION​ コマンドを WITH SCHEMA​ と共に実行します。

$ heroku pg:psql DATABASE_URL -a example-app
--> Connecting to postgresql-octagonal-12345
psql (13.2, server 11.12 (Ubuntu 11.12-1.pgdg16.04+1))
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

example-app::DATABASE=> CREATE EXTENSION hstore WITH SCHEMA schema_name;
CREATE EXTENSION
example-app::DATABASE=>

拡張機能のアップグレード

Heroku Postgres アドオンで拡張機能のアップグレードが有効になっているかどうかを確認するには、heroku pg:info​ コマンドを実行して、Upgradable Extensions​ 行を確認します。この値が No​ に設定されている場合、次の定期的なメンテナンス後に拡張機能がアップグレード可能になります。

=== DATABASE_URL
Plan:                  Standard 0
Status:                Available
Data Size:             2.15 GB
Tables:                4
PG Version:            15.2
Connections:           32/120
Connection Pooling:    Available
Credentials:           1
Fork/Follow:           Available
Rollback:              earliest from 2023-04-21 17:14 UTC
Created:               2023-04-17 19:06
Region:                us
Data Encryption:       In Use
Continuous Protection: On
Enhanced Certificates: Off
Upgradable Extensions: Yes
Maintenance:           not required
Maintenance window:    Mondays 17:30 to 21:30 UTC
Add-on:                postgresql-trapezoidal-57207

拡張機能をアップグレードするには、heroku pg:psql​ セッションで、アップグレードする拡張機能に対して、ALTER EXTENSION​ コマンドを実行します。

$ heroku pg:psql DATABASE_URL -a example-app
--> Connecting to postgresql-octagonal-12345
psql (13.2, server 11.12 (Ubuntu 11.12-1.pgdg16.04+1))
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

example-app::DATABASE=> CREATE EXTENSION btree_gin VERSION '1.0';
CREATE EXTENSION
example-app::DATABASE=> ALTER EXTENSION btree_gin UPDATE to '1.1';
ALTER EXTENSION
example-app::DATABASE=>

拡張機能の削除

既存の拡張機能をデータベースから削除するには、heroku pg:psql​ でセッションを開き、適切な DROP EXTENSION​ コマンドを実行します。

$ heroku pg:psql DATABASE_URL -a example-app
--> Connecting to postgresql-octagonal-12345
psql (13.2, server 11.12 (Ubuntu 11.12-1.pgdg16.04+1))
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

example-app::DATABASE=> DROP EXTENSION hstore;
DROP EXTENSION
example-app::DATABASE=>

拡張機能の表示

拡張機能がインストールされているスキーマを確認するには、heroku pg:psql​ でセッションを開き、\dx​ コマンドを実行します。

intense-mesa-15917::DATABASE=> \dx
                                           List of installed extensions
       Name        | Version |   Schema   |                              Description
--------------------+---------+------------+------------------------------------------------------------------------
pg_stat_statements | 1.10    | public     | track planning and execution statistics of all SQL statements executed
plpgsql            | 1.0     | pg_catalog | PL/pgSQL procedural language
(2 rows)

データ型

外部データラッパー

関数

統計

インデックスの種類

フルテキスト検索辞書

さらに、次の辞書はデフォルトでインストールされるため、拡張機能システムを使用して作成する必要はありません。

$ heroku pg:psql
=> \dFd
                             List of text search dictionaries
   Schema   |      Name       |                        Description
------------+-----------------+-------------------------------
 pg_catalog | danish_stem     | snowball stemmer for danish language
 pg_catalog | dutch_stem      | snowball stemmer for dutch language
 pg_catalog | english_stem    | snowball stemmer for english language
 pg_catalog | finnish_stem    | snowball stemmer for finnish language
 pg_catalog | french_stem     | snowball stemmer for french language
 pg_catalog | german_stem     | snowball stemmer for german language
 pg_catalog | hungarian_stem  | snowball stemmer for hungarian language
 pg_catalog | italian_stem    | snowball stemmer for italian language
 pg_catalog | norwegian_stem  | snowball stemmer for norwegian language
 pg_catalog | portuguese_stem | snowball stemmer for portuguese language
 pg_catalog | romanian_stem   | snowball stemmer for romanian language
 pg_catalog | russian_stem    | snowball stemmer for russian language
 pg_catalog | simple          | simple dictionary: just lower case and check for stopword
 pg_catalog | spanish_stem    | snowball stemmer for spanish language
 pg_catalog | swedish_stem    | snowball stemmer for swedish language
 pg_catalog | turkish_stem    | snowball stemmer for turkish language

dblink

dblink​: Postgres データベース間のクエリのサポートを追加します。dblink​を使用すると、個別の Heroku Postgres データベース間で、または外部の Postgres データベースとの間でクエリを実行できます。

pg_stat_​statements

pg_stat_​statements​ モジュールは、サーバーによって実行されているすべての SQL ステートメントの実行統計を追跡するための手段を提供します。

使用法

pg_stat_statements​ を使用すると、パフォーマンスの問題を追跡できます。これにより、実行された各クエリとそれに関連するコストを表示する pg_stat_statements​ という名前のビューが表示されます。これには、クエリが実行された回数、全体としてかかった合計のシステム実行時間、全体としてヒットした共有メモリ内のブロックの合計数が含まれます。

PostGIS

PostGIS​ モジュールは、PostgreSQL オブジェクトリレーショナルデータベースに地理オブジェクトのサポートを追加します。実際上、PostGIS は PostgreSQL サーバーを “空間的に有効にする” ため、地理情報システム (GIS) のバックエンド空間データベースとして使用できます。

要件

PostGIS は、すべての Heroku Postgres データベースプラン​で使用できます。

Heroku Postgres でサポートされている PostGIS のバージョンは次のとおりです。

• PostGIS v2.5、PostgreSQL 13 以前で実行されているデータベースの場合
• PostGIS v3.3、PostgreSQL 14 以降で実行されているデータベースの場合

プロビジョニング

データベースが上記の要件を満たしている限り、他の拡張機能と同様に PostGIS を追加できます。

PostGIS を既存の Heroku Postgres データベースにインストールするには、psql​ セッションを開き、CREATE EXTENSION postgis;​ を実行します。

$ heroku pg:psql DATABASE_URL -a example-app
--> Connecting to postgresql-octagonal-12345
psql (13.2, server 11.12 (Ubuntu 11.12-1.pgdg16.04+1))
SSL connection (protocol: TLSv1.2, cipher: ECDHE-RSA-AES256-GCM-SHA384, bits: 256, compression: off)
Type "help" for help.

example-app::DATABASE=> CREATE EXTENSION postgis;
CREATE EXTENSION

データベースに PostGIS がインストールされているかどうかを確認するには、psql​ から次のクエリを実行します。

=> SELECT postgis_version();
            postgis_version
---------------------------------------
 2.5 USE_GEOS=1 USE_PROJ=1 USE_STATS=1
(1 row)

pgvector

Heroku Postgres の pgvector​ 拡張機能により、ベクトルデータタイプのサポートが追加されます。「Heroku Postgres での pgvector​」を参照してください。

サポートされなくなった拡張機能

Heroku はプラットフォームで廃止された拡張機能を削除します。

• PLV8 - この拡張機能の Heroku ベータ期間中、Debian/Ubuntu での PG11+ に対する PLV8 パッケージのメンテナンスは廃止されました。詳細は、ここ​を参照してください。これが変更された場合、PLV8 を再び設定します。
• chkpass​ は Postgres 11 以降ではサポートされていません。
• xml2​ は廃止されました​。