ApsaraDB RDS:pg_dumpおよびpg_restoreを使用して、セルフマネージド型PostgreSQLインスタンスからApsaraDB RDS for PostgreSQLインスタンスにデータを移行する

手順

手順1: 移行するデータベースに関する情報を確認する

自己管理型PostgreSQLインスタンスに接続します。 psqlコマンドラインで、\lコマンドを実行してデータベースに関する情報を照会し、移行するデータベースのOwner、Encoding、Collate、およびCtypeの値を確認します。

この例では、testdbという名前のデータベースが移行されます。 データベースの情報が返されます。所有者はtestuser、EncodingはUTF8、Collateはen_US.UTF-8、Ctypeはen_US.UTF-8です。

                                                 List of databases
   Name    |  Owner   | Encoding |   Collate   |    Ctype    | ICU Locale | Locale Provider |   Access privileges
-----------+----------+----------+-------------+-------------+------------+-----------------+-----------------------
 postgres  | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 |            | libc            | =Tc/postgres         +
           |          |          |             |             |            |                 | postgres=CTc/postgres
 template0 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 |            | libc            | =c/postgres          +
           |          |          |             |             |            |                 | postgres=CTc/postgres
 template1 | postgres | UTF8     | en_US.UTF-8 | en_US.UTF-8 |            | libc            | =c/postgres          +
           |          |          |             |             |            |                 | postgres=CTc/postgres
 testdb    | testuser | UTF8     | en_US.UTF-8 | en_US.UTF-8 |            | libc            |
(4 rows)

ステップ2: ユーザーの移行

1. 自己管理型PostgreSQLインスタンスがデプロイされているサーバーに接続し、次のコマンドを実行して、移行するデータベースの所有者testuserをエクスポートします。

   pg_dumpall -g -h 127.0.0.1 -p 5432 -U testuser

   サンプル出力：

   説明

   コマンド出力の [ロール] セクションでは、testuserユーザーの権限に関連するステートメントを取得できます。

   --
   -- PostgreSQL database cluster dump
   --
   
   SET default_transaction_read_only = off;
   
   SET client_encoding = 'UTF8';
   SET standard_conforming_strings = on;
   
   --
   -- Roles
   --
   
   CREATE ROLE postgres;
   ALTER ROLE postgres WITH SUPERUSER INHERIT CREATEROLE CREATEDB LOGIN REPLICATION BYPASSRLS;
   CREATE ROLE testuser;
   ALTER ROLE testuser WITH SUPERUSER INHERIT CREATEROLE CREATEDB LOGIN REPLICATION BYPASSRLS PASSWORD 'SCRAM-SHA-256$4096:0IEvNqWupQsGcaoDS3SX****3U=';
   
   --
   -- User Configurations
   --
   
   --
   -- PostgreSQL database cluster dump complete
   --

2. 特権アカウントを使用してRDSインスタンスに接続します。 詳細については、「ApsaraDB RDS For PostgreSQLインスタンスへの接続」をご参照ください。

3. 取得したSQL文で、testuserユーザーの権限に関連するSUPERUSERをrds_SUPERUSERに変更します。 RDSインスタンスで、自己管理型PostgreSQLインスタンスのtestuserユーザーと同じ権限を持つアカウントを作成します。

   CREATE ROLE testuser;
   ALTER ROLE testuser WITH rds_SUPERUSER INHERIT CREATEROLE CREATEDB LOGIN REPLICATION BYPASSRLS PASSWORD 'SCRAM-SHA-256$4096:0IEvNqWupQsGcaoDS3SX****3U=';

手順3: RDSインスタンスでのターゲットデータベースの作成

1. 特権アカウントを使用してRDSインスタンスに接続します。

2. ターゲットデータベースを作成します。 ターゲットデータベースが、自己管理型PostgreSQLインスタンスのソースデータベースと同じ文字セット、同じCollate、およびCtype設定であることを確認します。 たとえば、ターゲットデータベースには、手順1で取得したソースデータベースと同じ設定が必要です。EncodingはUTF8、Collateはen_US.UTF-8、Ctypeはen_US.UTF-8です。

   CREATE DATABASE <Name of the destination database> WITH OWNER <Database owner> TEMPLATE template0 ENCODING 'UTF8' LC_CTYPE 'en_US.UTF-8' LC_COLLATE 'en_US.UTF-8';

   説明

   • ターゲットデータベースの名前は、自己管理型PostgreSQLインスタンスのソースデータベースの名前とは異なる場合があります。

   • ターゲットデータベースの所有者は、自己管理型PostgreSQLインスタンスのソースデータベースの所有者と同じである必要があります。

ステップ4: データの移行

次のいずれかの方法を使用して、データを移行できます。

• 自己管理型PostgreSQLインスタンスがデプロイされているサーバーがRDSインスタンスに接続できる場合は、オンライン移行を使用することを推奨します。

• セルフマネージドPostgreSQLインスタンスがデプロイされているサーバーがRDSインスタンスに接続できない場合は、オフライン移行を使用することを推奨します。 具体的には、pg_dumpを使用してデータをファイルにエクスポートし、RDSインスタンスが接続するホストにファイルをコピーしてから、pg_restoreを使用してファイルをRDSインスタンスにインポートします。

関連ドキュメント

ビジネス要件に基づいて、このトピックのコマンドのパラメーターをさらに設定できます。 詳しくは、以下のドキュメントをご参照ください。

• pg_dump

• pg_restore

• pg_dumpall