Table of Contents [expand]
最終更新日 2025年03月28日(金)
このガイドでは、Postgres データベースを DigitalOcean Managed PostgreSQL から Heroku Postgres に移行するプロセスについて説明します。このガイドでは、DigitalOcean Spaces Object Storage を使用してデータベースダンプファイルを保存します。移行を開始する前に、「Heroku Postgres への移行の準備」のステップを完了していることを確認してください。
データベースのサイズを取得する
ほとんどの場合、データベースのサイズが 100 GB 未満であれば、ダンプと復元の移行戦略が適しています。DigitalOcean のマネージドデータベースでは、Web UI を通じて、または psql クライアントによるデータベースへのクエリを通じて、データベースのサイズを見積もることができます。DigitalOcean プロジェクトで、Databases (データベース) ページに移動し、データベースをクリックします。次に、Insights (インサイト) タブに移動します。
Insights (インサイト) ページには、Disk Usage (ディスク使用量) グラフがあります。このグラフには、データベースが現在使用しているディスク容量が、インスタンスに割り当てられている全体のストレージの割合として表示されます。データベースページの上部を見ると、このデータベースインスタンスには 10 GB のディスクがあることがわかります。また、1 GB の RAM があり、1 つの vCPU で実行されます。
この例では、ストレージはこのインスタンスの合計 10 GB の 2.37%、約 237 MB です。ただし、この数値には、システムファイル、インストールなど、管理されたインスタンスで実行しているシステムのすべてのストレージが含まれます。そのため、実際のデータベースサイズはこの数値のほんの一部にすぎません。
より正確なサイズを読み取るには、データベースインスタンスに接続して list databases \l+ コマンドを使用します。Overview (概要) タブに移動すると、データベースの Postgres 資格情報を確認できます。そこに、Connection Details (接続の詳細) セクションがあります。
ドロップダウンから Connection string を選択し、Copy (コピー) をクリックします。psql クライアントを使用するための接続文字列には、次の形式を使用します。
postgres://DB_USERNAME:DB_PASSWORD@DB_HOST:DB_PORT/DB_NAME
サンプルデータベースの名前は defaultdb であるため、以下のコマンドでデータベースを psql クライアントに接続します。
$ psql postgresql://doadmin:thisismypassword@db-postgresql-nyc3-36003-do-user-10788997-0.g.db.ondigitalocean.com:25060/defaultdb
接続すると、list databases \l+ コマンドでデータベースのサイズを表示できます。
$ psql=> \l+
List of databases
Name | Owner | Encoding | Collate | Size |
----------------+-----------+----------+-------------+--------+
defaultdb | doadmin | UTF8 | en_US.UTF-8 | 56 MB |
Size 列はデータベースのサイズが 56 MB であることを示しています。
データベースのサイズに適した Heroku Postgres プランを確認するには、「適切な Heroku Postgres プランの選択」を参照してください。
データベースダンプを準備する
開始する前に、システムを読み取り専用モードに設定するか、連動するすべてのサービスをオフラインにして、エンドユーザーに現在のメンテナンスステータスを通知します。
データベースが Heroku アプリにアタッチされている場合は、アプリをメンテナンスモードにします。
データをバックアップする
移行を実行する前に、DigitalOcean にデータベースの最新のバックアップがあることを確認してください。DigitalOcean は、Postgres のマネージドデータベースのスナップショットバックアップを定期的に取得します。DigitalOcean は、毎日自動的に生成されるバックアップを最大 7 日間保持します。データベースのリストで、オプションアイコンをクリックすると、実行できるアクションが表示されます。利用可能なバックアップを確認するには、Restore from backup (バックアップから復元) をクリックします。
データベースをローカルファイルにダンプする
pg_dump を使用して、DigitalOcean データベースをローカルファイルにダンプします。
$ pg_dump postgres://DB_USERNAME:DB_PASSWORD@DB_HOST:DB_PORT/DB_NAME \
-Fc -b -v \
-f /tmp/data-for-migration.sql
このコマンドの実行にかかる時間は、データベースのサイズによって異なります。/tmp/data-for-migration.sql のファイルサイズを監視し、長いプロセスが実行中であることを確認します。
ファイルを DigitalOcean Spaces Object Storage にアップロードする
Heroku では、URL でアクセスできるファイルから Postgres データベースを復元できます。DigitalOcean からのこの移行では、データバックアップファイルを DigitalOcean から Spaces Object Storage にアップロードできます。
まず、バケットを作成します。この例では、バケットに postgres-for-migration という名前を付けました。
バケットを作成したら、「データベースをローカルファイルにダンプする」のステップの /tmp/data-for-migration.sql ファイルをアップロードします。
復元移行を実行する
Heroku アプリを作成する
Heroku CLI を使用して Heroku アカウントにログインします。
$ heroku login
次に、Heroku アプリを作成し、postgres-migration-from-do のように名前を付けます。
$ heroku apps:create psql-migration-from-do
Creating ⬢ psql-migration-from-do... done
Heroku Postgres アドオンを作成する
Heroku アプリを作成したら、適切なプランで Heroku Postgres アドオンを追加します。「データベースのサイズを取得する」で取得したデータベース情報に基づいて、Essential-1 Postgres プランを使用します。
$ heroku addons:create \
--app psql-migration-from-do \
heroku-postgresql:essential-1
Creating heroku-postgresql:essential-1 on ⬢ psql-migration-from-do... ~$0.013/hour (max $9/month)
Database should be available soon
postgresql-colorful-15568 is being created in the background. The app will restart when complete...
Use heroku addons:info postgresql-colorful-15568 to check creation progress
Use heroku addons:docs heroku-postgresql to view documentation
Heroku は、Heroku アプリ向けに Postgres データベースのプロビジョニングを開始し、一意の名前を指定します。数分以内にデータベース名を指定して以下のコマンドを実行し、作成したデータベースを確認できます。
$ heroku addons:info postgresql-colorful-15568
=== postgresql-colorful-15568
Attachments: psql-migration-from-do::DATABASE
Installed at: Fri Oct 18 2024 08:30:00 GMT-0700 (Mountain Standard Time)
Max Price: $9/month
Owning app: psql-migration-from-do
Plan: heroku-postgresql:essential-1
Price: ~$0.013/hour
State: created
Heroku Postgres に必要な拡張機能をインストールする
データを移行する前に、DigitalOcean Postgres インスタンスで使用していた拡張機能をインストールします。
まず、Heroku Postgres インスタンスにすでにインストールされている拡張機能を確認するため、pg:psql を使用して Heroku Postgres インスタンスに接続します。
$ heroku pg:psql --app psql-migration-from-do
--> Connecting to postgresql-colorful-15568
psql (16.4 (Ubuntu 16.4-1.pgdg20.04+1), server 16.2)
SSL connection (protocol: TLSv1.3, cipher: TLS_AES_256_GCM_SHA384, compression: off)
Type "help" for help.
psql=> \dx
List of installed extensions
Name | Version | Schema | Description
--------------------+---------+------------+-------------------------------
pg_stat_statements | 1.10 | public | track planning and executio...
plpgsql | 1.0 | pg_catalog | PL/pgSQL procedural language
(2 rows)
DigitalOcean で使用していた拡張機能のうち、Heroku Postgres にまだインストールされていないものがあればインストールします。この例では、tablefunc および uuid-ossp の拡張機能です。
$ psql=> CREATE EXTENSION IF NOT EXISTS tablefunc;
CREATE EXTENSION
psql=> CREATE EXTENSION IF NOT EXISTS "uuid-ossp";
CREATE EXTENSION
psql=> \dx
List of installed extensions
Name | Version | Schema | Description
--------------------+---------+------------+-------------------------------
pg_stat_statements | 1.10 | public | track planning and execution…
plpgsql | 1.0 | pg_catalog | PL/pgSQL procedural language
tablefunc | 1.0 | public | functions that manipulate…
uuid-ossp | 1.1 | public | generate universally unique…
(4 rows)
サポートされている拡張機能とそのインストール方法については、「Heroku Postgres での拡張機能、PostGIS、フルテキスト検索辞書」を参照してください。
DigitalOcean Spaces Object Storage 内のファイルの署名付き URL を取得する
次に、pg_dump バックアップから新しい Heroku Postgres データベースにすべてのデータを復元します。これには、バックアップファイルを指す URL が必要です。DigitalOcean Spaces Object Storage で作成したバケットは公開されませんが、アップロードしたファイルを指す一時的な URL を生成できます。ファイルのアクションから、Quick Share (クイック共有) を選択します。
このボタンをクリックすると、生成された共有リンクの有効期限を設定できるダイアログが開きます。適切な有効期限 (1 時間など) を選択し、パス形式のファイル URL をコピーします。
この例では、データベースダンプファイルの署名付き URL は以下のようになります。
https://nyc3.digitaloceanspaces.com/postgres-for-migration/data-from-digital-ocean-for-migration.sql?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=DO00WBC3C3CKELBPQD34%2F20241017%2Fnyc3%2Fs3%2Faws4_request&X-Amz-Date=20241017T045603Z&X-Amz-Expires=3600&X-Amz-SignedHeaders=host&X-Amz-Signature=9e1a55f759fdd42ee9d…
Heroku で復元する
署名付き URL が取得できたら、Heroku pg:backups:restore コマンドを使用して、DigitalOcean のファイルから Heroku Postgres データベースを復元します。コマンドは次のようになります。
$ heroku pg:backups:restore 'DIGITAL-OCEAN-SHARE-URL-IN-QUOTES' \
--app psql-migration-from-do \
--confirm psql-migration-from-do
Use Ctrl-C at any time to stop monitoring progress; the backup will continue restoring.
Use heroku pg:backups to check progress.
Stop a running restore with heroku pg:backups:cancel.
Starting restore of [DIGITAL-OCEAN-SHARE-URL] to postgresql-colorful-15568... done
Restoring... done
このコマンドでは次の点に留意してください。
- DigitalOcean の署名付き URL を貼り付ける場合は、必ず引用符で囲みます。
--app 引数を提供し、操作するアプリケーションと対応するデータベースを Heroku に指示します。- このコマンドは破壊的であるため、確認が必要です。
--confirm 引数を提供しない場合は、続行する前に操作の確認を求められます。
カスタム設定を移行する
/tmp/settings_postgres.csv というファイルに DigitalOcean Postgres の構成を保存したのと同様に、以下のコマンドを使用して、Heroku Postgres の構成も保存できます。
$ heroku pg:psql --app psql-migration-from-do \
-c "\copy (select * from pg_settings) to '/tmp/settings_heroku.csv' with (format csv, header true);"
Heroku Postgres の設定と DigitalOcean Postgres の設定を比較します。DigitalOcean Postgres の設定から構成を見つけて、Heroku Postgres インスタンスに再適用します。
移行が完了したことをテストで検証する
テストを実施して、データが正常に移行されたことを検証することをお勧めします。テストでは以下のことを実施できます。
- 2 つのデータベース間でテーブル数を比較する。
- 2 つのデータベース間で各テーブルの行数を比較する。
- 2 つのデータベース間でクエリ結果を比較する。
- 新しいデータベースでさまざまな受け入れテストを実施し、適切な動作とパフォーマンスを検証する。
既存のアプリケーションとサービスを接続する
データベースの移行が完了したことを確認したら、既存のアプリケーションとサービスを新しいデータベースに接続します。
Heroku Postgres の資格情報を取得する
Heroku Postgres アドオンを作成すると、Heroku は DATABASE_URL という新しい環境変数を自動的に設定します。これには、新しいデータベースの資格情報と接続情報が含まれています。変数を取得するには、heroku config:get コマンドを実行します。
$ heroku config:get DATABASE_URL --app psql-migration-from-do
postgres://ub85ophvo36b70:p1eefcd0113725be7d6942302511c7f07c60a355628e8888673cf639a0dc42576@cbhk6rs82poqi7.cluster-czrs8kj4isg7.us-east-1.rds.amazonaws.com:5432/de14engn2aht91
heroku:pg:credentials コマンドで資格情報を検索することもできます。
Postgres URI は次の形式に従うため、個々の部分を解析できます。
postgres://DB_USERNAME:DB_PASSWORD@DB_HOST:DB_PORT/DB_NAME
連動するシステムを更新してテストする
この情報を使用して、Heroku Postgres に接続するように既存のシステムを更新します。各システムをテストして、接続が完了したことを確認します。
まとめ
アプリケーションとサービスが Heroku Postgres に接続され、想定どおりに実行されるようになったため、メンテナンスウィンドウを終了して、エンドユーザーの全面的なアクセスを復元できます。
移行が成功し、DigitalOcean データベースが不要になったことが確認できたら、完全に削除できます。
移行が完了すると、Heroku Postgres の柔軟性と低コストの利便性を活用できるようになります。データベースの使用についての詳細は、Heroku Postgres のドキュメントを参照してください。