最終更新日 2023年03月10日(金)

Heroku Postgres​ は、Heroku が直接提供するマネージド SQL データベースサービスです。PostgreSQL ドライバーを使用して、Heroku が公式にサポートする​すべての言語を含むどの言語の Heroku Postgres データベースにもアクセスできます。

データベースを管理するためのさまざまな Heroku CLI コマンド​に加え、Heroku Postgres には、Web ダッシュボード​、クエリを共有するためのデータクリップ​、およびその他の複数の役立つ機能が用意されています。

Heroku Postgres プランについて

Heroku Postgres は、Essential、Standard、Premium、Private、Shield というサービスの異なる層にまたがる、さまざまなプランを提供しています。各プランが提供する内容の詳細については、「Choosing the Right Heroku Postgres Plan​」(適切な Heroku Postgres プランの選択) を参照してください。

Heroku Postgres プランの価格情報は、Heroku Postgres アドオンページ​で確認できます。

アプリの要件が最終的に、選択した初期プランで提供されたリソースより大きくなりすぎた場合、簡単にデータベースをアップグレード​できます。

Heroku Postgres のプロビジョニング

Heroku Postgres データベースをプロビジョニングする方法についての詳細は、「Heroku Postgres のプロビジョニング​」を参照してください。

ローカルの設定

Heroku では、Postgres をローカルで実行して環境間でのパリティを確保​することをお勧めします。Heroku Postgres をローカル環境で実行するための設定方法についての詳細は、「Heroku Postgres のローカル設定​」を参照してください。

プライマリデータベースの指定

DATABASE_URL​ 環境設定は、アプリのプライマリ Heroku Postgres データベースの URL を指定します。1 つのデータベースを持つアプリの場合は、その URL がこの環境設定に自動的に割り当てられます。

複数の Postgres データベースを持つアプリの場合は、heroku pg:promote​ でプライマリデータベースを設定します。一般的なユースケースには、リーダー/フォロワー高可用性設定​、またはデータベースアップグレードプロセス​の一部が含まれます。

アプリケーション間での Heroku Postgres の共有

heroku addons:attach​ コマンドを使用して、単一の Heroku Postgres データベースを複数のアプリ間で共有できます。

$ heroku addons:attach my-originating-app::DATABASE --app example-app
Attaching postgresql-addon-name to example-app... done
Setting HEROKU_POSTGRESQL_BRONZE vars and restarting example-app... done, v11

アタッチされたデータベースの URL は、名前形式 HEROKU_POSTGRESQL_[COLOR]_URL​ で環境設定に割り当てられます。この例では、環境設定の名前は HEROKU_POSTGRESQL_BRONZE_URL​ です。

共有されるデータベースは、必ずしも、共有されるいずれか特定のアプリのプライマリデータベースではありません。共有されたデータベースをプロモートするには、他のデータベースに使用した同じコマンド​を使用します。

別のアプリとの Heroku Postgres インスタンスの共有を停止するには、heroku addons:detach​ コマンドを使用します。

$ heroku addons:detach HEROKU_POSTGRESQL_BRONZE --app example-app
Detaching HEROKU_POSTGRESQL_BRONZE to postgresql-addon-name from example-app... done
Unsetting HEROKU_POSTGRESQL_BRONZE config vars and restarting example-app... done, v11

バージョンのサポート

PostgreSQL プロジェクトは毎年、新しいメジャーバージョンをリリースします。Heroku Postgres では、そのリリースの直後に各メジャーバージョンがサポートされます。Heroku Postgres のバージョンサポートについての詳細は、「Heroku Postgres Version Support​」(Heroku Postgres のバージョンサポート) を参照してください。

従来のインフラストラクチャ

Heroku は場合によって、インフラストラクチャの古いバージョンを非推奨にします。従来のインフラストラクチャの非推奨化​に関する記事を参照してください。

パフォーマンス分析

パフォーマンス分析についての詳細は、「Heroku Postgres のパフォーマンス分析​」を参照してください。

CLI の使用

CLI を使用した Heroku Postgres の管理についての詳細は、「CLI を使用した Heroku Postgres の管理​」を参照してください。

Heroku Postgres への接続

Heroku Postgres への接続についての詳細は、「Heroku Postgres への接続​」を参照してください。

プラン間の移行

データベースプラン間の更新および移行​に関するこの詳細なガイドを参照してください。

データの所在

データベースがプロビジョニングされると、そのデータベースに関連付けられたデータは、それが作成されるリージョン内で保管されます。ただし、Heroku Postgres に付随する一部のサービスや、このデータベース群を管理するシステムは、プロビジョニングされたデータベースと同じリージョン内に配置されません。

• ディザスタリカバリーの Postgres Continuous Protection​ は、データベースが置かれている同じリージョンにベースバックアップおよびログ先行書き込みを保管します。
• Common Runtime のログは、アプリが内部で実行中の同じリージョンにルーティングされます。たとえば、us​ リージョン内のアプリのログは、us​ インフラストラクチャ経由でルーティングされます。 *Private Space 内のアプリのログは、そのスペース自体と同じリージョン内に留まります。たとえば、東京スペース内のアプリのログは、東京のインフラストラクチャ経由でルーティングされます。コンプライアンス要件が厳格なアプリを Shield Private Space​ にデプロイできます。ここでは Logplex の代わりに Private Space Logging​ を使用してログがルーティングされます。
• Heroku Postgres クエリおよびエラーのログ記録は、heroku addons:create heroku-postgres:...​ でデータベースを作成するときに --block-logs​ フラグを使用することによってブロックできます。
• PG バックアップ​スナップショットは米国で保管されます。別のリージョン内の論理バックアップを取得するには、「Heroku Postgres の論理バックアップ​」を参照してください。
• データクリップは米国で保管されます。

ログのブロック

アドオン作成時に、データベースに対して実行されるクエリのログ記録を防止するためにフラグを渡すことができます。このオプションが有効になっている場合は、データベースがプロビジョニングされた後に、それを無効にすることはできません。有効になった後、それを無効にするには、新しいデータベースへの移行が必要になります。

$ heroku addons:create heroku-postgresql:standard-0 -a example-app --block-logs

アドオンの削除

Heroku Postgres データベースを削除するには、アドオンを破棄する必要があります。

$ heroku addons:destroy heroku-postgresql

同じ種類のデータベースが 2 つある場合は、その環境設定名を使用してアドオンを削除する必要があります。たとえば、HEROKU_POSTGRESQL_GRAY_URL​ データベースを削除するには、次のコマンドを実行します。

$ heroku addons:destroy HEROKU_POSTGRESQL_GRAY

削除されたデータベースが DATABASE_URL​ で使用されていたのと同じものであった場合は、その DATABASE_URL​ 環境設定がアプリで設定解除されます。

サポート

Heroku Postgres のサポートとランタイムの問題はすべて、いずれかの Heroku サポートチャネル​経由で送信してください。