ApsaraDB RDS:クラウド移行評価レポートの概要

RDSが空かどうかのチェック

[チェック項目:] RDS データベースのチェック

エラーメッセージ：

error: postgres not empty, check if any table exists

影響：移行では、移行先の ApsaraDB RDS for PostgreSQL インスタンスにデータが新規に書き込まれます。移行先にすでにデータベースやテーブルが存在する場合、移行は失敗するか、データが重複します。

[解決策：]

ApsaraDB RDS for PostgreSQL インスタンスから template0、template1、および postgres 以外のすべてのデータベースを削除します。次に、postgres データベースで、ha_health_check 以外のすべてのテーブルを削除します。

ソース接続性のチェック

このチェックでは、ソースのセルフマネージド PostgreSQL インスタンスと移行先の ApsaraDB RDS for PostgreSQL インスタンス間のネットワークおよび認証アクセスを検証します。6 つのサブチェックを実行します。

error: XX.XX.XX.XX is unapproachable

error: 5432 is unapproachable

error: cannot connect to source database by migratetest:123456

error: migratetest has no replication privilege

error: migratetest has no createrole privilege

ALTER ROLE migratetest CREATEROLE;

error: migratetest should be a member of pg_monitor to monitor replication status

GRANT pg_monitor TO migratetest;

ソースバージョンのチェック

[チェック項目:] メジャーバージョンの一貫性チェック

エラーメッセージ：

error: version mismatch, source version:10, current version:13.0

影響：メジャーバージョンをまたいだ移行はサポートされていません。ソースと移行先のメジャーエンジンバージョンが異なる場合、移行は失敗します。

[解決策：]

セルフマネージド PostgreSQL インスタンスと同じメジャーエンジンバージョンを実行する ApsaraDB RDS for PostgreSQL インスタンスを購入してください。

ソースglibcバージョンのチェック

[チェック項目：] ソース glibc バージョンの互換性を確認

警告メッセージ：

warning: source glibc version is not compatible with rds pg

影響：GNU C ライブラリ (glibc) のバージョンは、PostgreSQL が UTF-8 エンコーディングで文字をソートする方法に影響します。バージョン 2.28 では、異なる照合順序が導入されました。ソースと移行先で glibc のバージョンが異なる場合、C 以外の照合順序を持つテキストインデックスは、移行後に予期しない順序で結果を返し、クエリの正確性に影響を与える可能性があります。

[解決策：]

以下の診断クエリを実行して、データに対する実際のリスクを評価してください。

1. 現在の照合順序がデータに影響するかどうかを確認してください：

   • 結果が true の場合、照合順序は影響を受けません。これ以上の操作は必要ありません。

   • 結果が false の場合、ステップ 2 に進みます。

   BEGIN;
   CREATE TEMP TABLE testcollation(id varchar(20) COLLATE "en_US.utf8") ON COMMIT DROP;
   INSERT INTO testcollation VALUES('-1'),('1');
   SELECT id='1' FROM testcollation ORDER BY id LIMIT 1;
   ROLLBACK;

2. C 以外の照合順序を使用しているデータベースがあるかどうかを確認してください：

   • 行が返されない場合、移行に照合順序のリスクはありません。これ以上の対応は不要です。

   • 行が返された場合、ステップ 3 に進みます。

   SELECT datname, datcollate FROM pg_database WHERE datcollate NOT IN ('C', 'POSIX');

3. すべてのデータベースで、C 以外の照合順序を持つすべてのインデックスを特定してください：

   • 行が返されない場合、移行に照合順序のリスクはありません。

   • 行が返された場合、影響を受けるインデックスは移行後に正しくないソート結果を返す可能性があります。続行する前に、これらのインデックスがアプリケーションのクエリに影響するかどうかを評価してください。

   WITH result AS (
       WITH defcoll AS (
           SELECT datcollate AS coll
           FROM pg_database
           WHERE datname = current_database()
       )
       SELECT indrelid::regclass::text relname, indexrelid::regclass::text indexname,
           CASE WHEN c.collname = 'default'
               THEN defcoll.coll
               ELSE c.collname
           END AS collation
       FROM (SELECT indexrelid, indrelid, indcollation[i] coll FROM pg_index, generate_subscripts(indcollation, 1) g(i)) s
           JOIN pg_collation c ON coll=c.oid
           CROSS JOIN defcoll
       WHERE collprovider IN ('d', 'c') AND collname NOT IN ('C', 'POSIX')
   )
   SELECT result.relname, result.indexname, result.collation FROM result WHERE result.collation NOT IN ('C', 'POSIX');

ディスクサイズのチェック

[チェック項目：]ディスク容量が十分であることを確認

エラーメッセージ：

error: source_db_size > disk_size * 0.95

影響：ソースデータは、移行先の利用可能なストレージの 95% 以内に収まる必要があります。移行先のストレージが小さすぎる場合、完全バックアップの転送が途中で失敗し、移行先が不完全な状態になります。

[解決策：]

1. ソースインスタンスの合計データサイズを確認してください (結果は MB 単位)：

   SELECT SUM(pg_database_size(pg_database.datname))/1024/1024 AS size FROM pg_database;

2. 必要なストレージを計算してください。移行先のストレージは、ソースのデータサイズの 110% 以上である必要があります。たとえば、ソースが 100 GB を使用している場合、移行先には少なくとも 110 GB の利用可能なストレージが必要です。

3. ApsaraDB RDS for PostgreSQL インスタンスのストレージを拡張してください。手順については、「インスタンス仕様の変更」をご参照ください。

wal_keep_sizeのチェック

[チェック項目：] WAL 保持サイズが十分に大きいことを確認

警告メッセージ：

warning: wal_keep_size X MB is too small. Try to set wal_keep_segments or wal_keep_size large enough ensure pg_basebackup success

影響： 移行中、pg_basebackup はソースデータベースのフル スナップショットを転送します。このとき、ソースが pg_basebackup によるデータコピーよりも速く WAL を生成し、かつソースが十分な WAL セグメントを保持していない場合、pg_basebackup は「WAL segment has been removed」エラーで失敗します。

[解決策：]

ApsaraDB RDS for PostgreSQL インスタンスの WAL 保持設定を増やし、pg_basebackup の失敗のリスクを低減します:

• PostgreSQL 13 以降: wal_keep_size の値を増やします。

• PostgreSQL 13 未満: wal_keep_segments の値を増やします。

PostgreSQL 13 より前のバージョンでは、2 つのパラメーターの関係は wal_keep_size = wal_keep_segments × wal_segment_size です。

仕様パラメータのチェック

[チェック項目:] 仕様パラメーターが大きすぎないか確認

エラーメッセージ：

error: max_connections too large, value=XXX
error: max_prepared_transactions too large, value=XXX

影響: 移行元インスタンスの max_connections または max_prepared_transactions が、移行先 RDS インスタンスの対応する値の 100 倍を超えている場合、移行サービスがレプリケーションリンクを確立する際に、移行先インスタンスの起動に失敗する可能性があります。

[解決策：]

ソースインスタンスで max_connections と max_prepared_transactions を、移行先の値の 100 倍以内になるように減らします。

max_connections および max_prepared_transactions への変更を反映させるには、ソース PostgreSQL インスタンスの再起動が必要です。

RDSユーザーのチェック

[チェック項目：] rds システムユーザーが占有されているかどうかの確認

警告メッセージ：

warning: Check if rds system user is occupied ...XXX will be reused in rds

影響: ApsaraDB RDS for PostgreSQL は、アカウント aurora、replicator、および pgxxx を内部システム用として予約しています。これらのアカウントがソースインスタンスに存在する場合、移行によって移行先でそれらの設定が上書きされ、管理機能が破損する恐れがあります。

[解決策：]

自己管理型の PostgreSQL インスタンスでは、アカウント aurora、replicator、および pgxxx を使用しないようにしてください。

拡張機能のチェック

このチェックでは、ソースのセルフマネージド PostgreSQL インスタンスと移行先の ApsaraDB RDS for PostgreSQL インスタンス間の拡張機能の互換性を検証します。3 つのサブチェックを実行します。

error: Check source supported extensions XXX not supported

DROP EXTENSION <拡張機能名>;

error: Check source extensions with higher version XXX

DROP EXTENSION <拡張機能名>;
CREATE EXTENSION <拡張機能名> VERSION '<移行先のバージョン>';

warning: Check source extensions with lower version XXX

PostgreSQLシステムカタログのチェック

このチェックでは、ソースインスタンスのシステムカタログを検査し、ApsaraDB RDS for PostgreSQL と互換性のない設定がないか確認します。4 つのサブチェックを実行します。

error: disallowed language exist in databases [xxx, xxx], the languages allowed are [c, internal, sql, plpgsql, pltcl, plperl].

DROP LANGUAGE <言語名>;

error: large object exist in databases [xxx, xxx].

error: default acl settings exist in databases [xxx, xxx].

warning: Invalid system tables: [pg_parameter_acl, pg_db_role_setting], these system tables should be empty.

予約済みロールの権限チェック

チェック内容：ソースインスタンスのアカウントに対し、許可されていない予約済みロールの権限が付与されているかを確認します。

エラーメッセージ：

error: some disallowed reserved roles [pg_write_server_files] are granted to user. you should revoke these roles from their members

影響: ApsaraDB RDS for PostgreSQL は、マネージド環境で許可されていないサーバーファイルシステムの操作へのアクセスを提供する pg_write_server_files などの特定の組み込みロールを制限します。これらのロールがソースインスタンスのアカウントに付与されている場合、移行は失敗します。

[解決策：]

ソースインスタンスのすべてのアカウントから、許可されていない予約済みロールを取り消してください。例：

REVOKE pg_write_server_files FROM "user";