Azure データベースから Heroku Postgres への移行

Table of Contents [expand]

データベースのサイズを取得する
データベースダンプを準備する
復元移行を実行する
移行が完了したことをテストで検証する
既存のアプリケーションとサービスを接続する
まとめ

最終更新日 2025年03月28日(金)

このガイドでは、Postgres データベースを Azure Database から Heroku Postgres に移行するプロセスについて説明します。このガイドでは、Azure Storage を使用してデータベースダンプファイルを保存します。移行を開始する前に、「Heroku Postgres への移行の準備」のステップを完了していることを確認してください。

データベースのサイズを取得する

ほとんどの場合、データベースのサイズが 100 GB 未満であれば、ダンプと復元の移行戦略が適しています。Azure には、データベースのサイズを判断する方法がいくつかあります。Azure リソースのリストからデータベースを選択したら、Monitoring > Metrics (モニタリング > メトリクス) に移動し、チャートの Database Size メトリクスを選択します。

Azure のデータベースサイズ

この例では、データベースのサイズは 80 MB 未満です。

より正確なサイズを読み取るには、データベースインスタンスに接続して list databases \l+ コマンドを使用します。接続の詳細を確認するには、Settings > Connect (設定 > 接続) に移動します。

Azure の接続の詳細

さまざまな export ステートメントは、データベース接続文字列の値を示しています。psql クライアントを使用するための接続文字列には、次の形式を使用します。

postgres://DB_USERNAME:DB_PASSWORD@DB_HOST:DB_PORT/DB_NAME

Azure データベースでは、最初にデータベースを作成するときにデータベース管理者のユーザー名とパスワードを設定します。

サンプルデータベースの名前は postgres であるため、以下のコマンドでデータベースを psql クライアントに接続します。

$ psql postgresql://dbadmin:mypassword@prep-for-migration.postgres.database.azure.com:5432/postgres

接続すると、list databases \l+ コマンドでデータベースのサイズを表示できます。

$ psql=> \l+

                        List of databases
    Name        | Owner    | Encoding |   Collate   | Size   |
----------------+----------+----------+-------------+--------+
 postgres       | postgres | UTF8     | en_US.UTF-8 | 76 MB  |

Size 列はデータベースのサイズが 76 MB であることを示しています。

データベースのサイズに適した Heroku Postgres プランを確認するには、「適切な Heroku Postgres プランの選択」を参照してください。

データベースダンプを準備する

開始する前に、システムを読み取り専用モードに設定するか、連動するすべてのサービスをオフラインにして、エンドユーザーに現在のメンテナンスステータスを通知します。

データベースが Heroku アプリにアタッチされている場合は、アプリをメンテナンスモードにします。

データをバックアップする

移行を実行する前に、Azure にデータベースの最新のバックアップがあることを確認してください。Settings > Backup and restore (設定 > バックアップと復元) に移動します。Azure が自動的に実行して保持する最新のバックアップの一覧が表示されます。

Azure のバックアップ

データベースをローカルファイルにダンプする

pg_dump を使用して、Azure データベースをローカルファイルにダンプします。

$ 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 のファイルサイズを監視し、長いプロセスが実行中であることを確認します。

ファイルを Azure Storage にアップロードする

Heroku では、URL でアクセスできるファイルから Postgres データベースを復元できます。この Azure Database for PostgreSQL からの移行では、データバックアップファイルを Azure Storage にアップロードし、そのファイルの署名付き URL を取得できます。

まず、Blob コンテナを作成します。この例では、バケットに postgres-for-migration という名前を付けました。

Azure でコンテナを作成する

セキュリティ保護のため、必ずコンテナのアクセスレベルを Private (no anonymous access) に設定してください。

Azure プライベート

Azure Storage は保存中のデータを自動的に暗号化します。

Azure での暗号化

Blob コンテナを作成したら、「データベースをローカルファイルにダンプする」のステップの /tmp/data-for-migration.sql ファイルをアップロードします。

Azure でファイルをアップロードする

復元移行を実行する

Heroku アプリを作成する

Heroku CLI を使用して Heroku アカウントにログインします。

$ heroku login

次に、Heroku アプリを作成し、postgres-migration-from-azure のように名前を付けます。

$ heroku apps:create psql-migration-from-azure
Creating ⬢ psql-migration-from-azure... done

Heroku Postgres アドオンを作成する

Heroku アプリを作成したら、適切なプランで Heroku Postgres アドオンを追加します。「データベースのサイズを取得する」で取得したデータベース情報に基づいて、Essential-1 Postgres プランを使用します。

$ heroku addons:create \
    --app psql-migration-from-azure \
    heroku-postgresql:essential-1
Creating heroku-postgresql:essential-1 on ⬢ psql-migration-from-azure... ~$0.013/hour (max $9/month)
Database should be available soon
postgresql-clear-97314 is being created in the background. The app will restart when complete...
Use heroku addons:info postgresql-clear-97314 to check creation progress
Use heroku addons:docs heroku-postgresql to view documentation

Heroku は、Heroku アプリ向けに Postgres データベースのプロビジョニングを開始し、一意の名前を指定します。数分以内にデータベースを指定して以下のコマンドを実行し、作成したデータベースを確認できます。

$ heroku addons:info postgresql-clear-97314
=== postgresql-clear-97314

Attachments:  psql-migration-from-azure::DATABASE
Installed at: Tue Oct 01 2024 11:00:00 GMT-0700 (Mountain Standard Time)
Max Price:    $9/month
Owning app:   psql-migration-from-azure
Plan:         heroku-postgresql:essential-1
Price:        ~$0.013/hour
State:        created

Heroku Postgres に必要な拡張機能をインストールする

データを移行する前に、Azure データベースインスタンスで使用していた拡張機能をインストールします。

まず、Heroku Postgres インスタンスにすでにインストールされている拡張機能を確認するため、pg:psql を使用して Heroku Postgres インスタンスに接続します。

$ heroku pg:psql --app psql-migration-from-azure
--> Connecting to postgresql-clear-97314
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)

Azure で使用していた拡張機能のうち、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、フルテキスト検索辞書」を参照してください。

Azure Storage 内のファイルの署名付き URL を取得する

次に、pg_dump バックアップから新しい Heroku Postgres データベースにすべてのデータを復元します。これには、バックアップファイルを指す URL が必要です。Azure Storage で、共有アクセス署名 (SAS) を作成します。

Azure SAS

作成する SAS が Blob サービス向けで、リソースの種類が Object であること、Read 権限があることを確認します。

Azure SAS 設定

適切な有効期限の開始期間と終了期間 (次の 1 時間にわたるウィンドウなど) を設定します。最後に、Generate SAS and connection string (SAS と接続文字列を生成) をクリックします。

Azure で SAS を生成する

Azure Storage ルートフォルダーへのアクセスを提供する Blob service SAS URL が表示されます。次の例のようになります。

https://myazureobjectstorage.blob.core.windows.net/?sv=2022-11-02&ss=b&srt=o&sp=r&se=2024-10-02T01:23:25Z&st=2024-10-01T17:23:25Z&spr=https&sig=mPrWUfttKrIOP5lkUQh8kd8PY7ZhXbL3WCqj5YbhpjU%3D

ドメインは、Azure ストレージアカウントの名前と一致します。この例では myazureobjectstorage.blob.core.windows.net です。ドメインの後に、コンテナの名前とアクセスするファイルの名前を追加します。次に、署名を含むすべてのクエリパラメータを追加します。

この例では、データベースダンプファイルの署名付き URL は以下のようになります。

https://myazureobjectstorage.blob.core.windows.net/postgres-for-migration/data-for-migration.sql?sv=2022-11-02&ss=b&srt=o&sp=r&se=2024-10-02T01:23:25Z&st=2024-10-01T17:23:25Z&spr=https&sig=mPrWUfttKrIOP5lkUQh8kd8PY7ZhXbL3WCqj5YbhpjU%3D

Heroku で復元する

署名付き URL が取得できたら、Heroku pg:backups:restore コマンドを使用して、Azure Storage のファイルから Heroku Postgres データベースを復元します。コマンドは次のようになります。

$ heroku pg:backups:restore 'AZURE-SIGNED-URL-IN-QUOTES' \
    --app psql-migration-from-azure \
    --confirm psql-migration-from-azure

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 [AZURE-SIGNED-URL] to postgresql-clear-97314... done
Restoring... done

このコマンドでは次の点に留意してください。

Azure の署名付き URL を貼り付ける場合は、必ず引用符で囲みます。
--app 引数を提供し、操作するアプリケーションと対応するデータベースを Heroku に指示します。
このコマンドは破壊的であるため、確認が必要です。--confirm 引数を提供しない場合は、続行する前に操作の確認を求められます。

カスタム設定を移行する

/tmp/settings_postgres.csv というファイルに Azure データベースの構成を保存したのと同様に、以下のコマンドを使用して、Heroku Postgres の構成も保存できます。

$ heroku pg:psql --app psql-migration-from-azure \
    -c "\copy (select * from pg_settings) to '/tmp/settings_heroku.csv' with (format csv, header true);"

Heroku Postgres の設定と Azure データベースの設定を比較します。Azure の設定から構成を見つけて、Heroku Postgres インスタンスに再適用します。

移行が完了したことをテストで検証する

テストを実施して、データが正常に移行されたことを検証することをお勧めします。テストでは以下のことを実施できます。

2 つのデータベース間でテーブル数を比較する。
2 つのデータベース間で各テーブルの行数を比較する。
2 つのデータベース間でクエリ結果を比較する。
新しいデータベースでさまざまな受け入れテストを実施し、適切な動作とパフォーマンスを検証する。

既存のアプリケーションとサービスを接続する

データベースの移行が完了したことを確認したら、既存のアプリケーションとサービスを新しいデータベースに接続します。

Heroku Postgres の資格情報を取得する

Heroku Postgres アドオンを作成すると、Heroku は DATABASE_URL という新しい環境変数を自動的に設定します。これには、新しいデータベースの資格情報と接続情報が含まれています。変数を取得するには、heroku config:get コマンドを実行します。

$ heroku config:get DATABASE_URL --app psql-migration-from-azure

postgres://u53ijh9udlpj3m:p5018c7e2c6db5882d6b7a09914b27cc0114443dd427dd5f62c1e6b83ed1f099c@c2ihhcf1divl18.cluster-czrs8kj4isg7.us-east-1.rds.amazonaws.com:5432/d9ad4c48p98fc6

heroku:pg:credentials コマンドで資格情報を検索することもできます。

Postgres URI は次の形式に従うため、個々の部分を解析できます。

postgres://DB_USERNAME:DB_PASSWORD@DB_HOST:DB_PORT/DB_NAME

連動するシステムを更新してテストする

この情報を使用して、Heroku Postgres に接続するように既存のシステムを更新します。各システムをテストして、接続が完了したことを確認します。

まとめ

アプリケーションとサービスが Heroku Postgres に接続され、想定どおりに実行されるようになったため、メンテナンスウィンドウを終了して、エンドユーザーの全面的なアクセスを復元できます。

移行が完了し、Azure データベースが不要になったことが確認できたら、完全に削除できます。

Azure でデータベースを削除する

移行が完了すると、Heroku Postgres の柔軟性と低コストの利便性を活用できるようになります。データベースの使用についての詳細は、Heroku Postgres のドキュメントを参照してください。

Categories