チュートリアル: 移行サービスを使用して Amazon RDS for PostgreSQL から Azure Database for PostgreSQL にオフラインで移行する

Azure portal では、シンプルで直感的なウィザードベースのエクスペリエンスが提供され、移行の手順が示されます。 このチュートリアルで説明されている手順に従うと、データベースを Azure Database for PostgreSQL - フレキシブル サーバーにシームレスに転送でき、その強力な機能とスケーラビリティを活用できます。

Azure portal を使用して移行するには、まず移行タスクを構成し、ソースとターゲットに接続してから、移行を実行します。

移行タスクを構成する

移行サービスには、Azure portal に関する簡単なウィザード ベースのエクスペリエンスが付属しています。

1. Web ブラウザーを開き、ポータルに移動します。 資格情報を入力してサインインします。 既定のビューはサービス ダッシュボードです。

2. お使いの Azure Database for PostgreSQL フレキシブル サーバーに移動します。

3. フレキシブル サーバーの [概要] タブの左側のメニューで、下にスクロールして [移行] を選択します。

   

4. [作成] ボタンを選び、Amazon RDS for PostgreSQL からフレキシブル サーバーに移行します。

   注意

   移行サービスを初めて使用すると、最初の移行を開始するためのプロンプトが表示された空のグリッドが表示されます。

   フレキシブル サーバー ターゲットへの移行が既に作成されていると、グリッドには、試行された移行に関する情報が含まれます。

5. ウィザードベースの一連のタブを移動して移行を実行するには、[作成] ボタンを選択します。

   

セットアップ

ユーザーは、移行名、ソース サーバーの種類、オプション、モードなど、移行に関連する複数の詳細を指定する必要があります。

• 移行名は、このフレキシブル サーバーへの移行ごとの一意識別子です。 このフィールドで使用できる文字は英数字のみで、ハイフン (-) 以外の特殊文字は使用できません。 名前はハイフンから開始できず、1 つのターゲット サーバーに対して一意である必要があります。 同じフレキシブル サーバー ターゲットへの 2 つの移行の名前を同じにすることはできません。

• ソース サーバーの種類 - PostgreSQL ソースに応じて、Amazon RDS for PostgreSQL を選択できます。

• [移行オプション] - 移行をトリガーする前に検証を実行できます。 次のいずれかのオプションを選択できます。

  • [検証] - サーバーとデータベースがターゲットに移行できる状態になっていることを調べます。
  • [移行] - 検証をスキップして移行を始めます。
  • [検証と移行] - 移行をトリガーする前に検証を実行します。 検証エラーがない場合、移行がトリガーされます。

移行を行う前に事前移行検証を実行するために、[検証] または [検証して移行] オプションを常に選択することをお薦めします。

事前移行の検証の詳細については、事前移行に関するページを参照してください。

• 移行モードでは、移行のモードを選択できます。 [オフライン] が既定のオプションです。

[次へ: ソースに接続] ボタンを選択します。

ランタイム サーバーを選択する

移行ランタイム サーバーは、移行サービス内の特殊な機能であり、移行中に中間サーバーとして機能するように設計されています。 これは、ターゲット サーバーではない、別の Azure Database for PostgreSQL - フレキシブル サーバー インスタンスですが、プライベート ネットワーク経由でのみアクセスできるソース環境からのデータベースの移行を容易にするために使用されます。

ランタイム サーバーについて詳しくは、移行ランタイム サーバーに関する記事を参照してください。

ソースに接続する

[ソースに接続] タブでは、データベースのソースである [セットアップ] タブで選択したソースに関連する詳細を指定するように求められます。

• サーバー名 - ソース PostgreSQL インスタンスのホスト名または IP アドレスを指定します
• ポート - ソース サーバーのポート番号
• サーバー管理者ログイン名 - ソース PostgreSQL サーバーのユーザー名
• パスワード - ソース PostgreSQL サーバーのパスワード
• SSL モード - サポートされている値が優先されかつ必要です。 ソース PostgreSQL サーバーの SSL が OFF の場合は、SSLMODE=prefer を使用します。 ソース サーバーの SSL が ON の場合は、SSLMODE=require を使用します。 SSL 値は postgresql.conf ファイルで決定できます。
• テスト接続 - ターゲットとソースの間の接続テストを実行します。 接続が成功すると、ユーザーは次の手順に進むことができます。ターゲットとソースの間のネットワークの問題を特定し、ソースのユーザー名/パスワードを確認する必要があります。 テスト接続の確立には数分かかります。

テスト接続が成功したら、[次へ: 移行ターゲットの選択] ボタンを選択します。

移行ターゲットを選択する

[移行ターゲットの選択] タブには、サブスクリプション名、リソース グループ、サーバー名、場所、PostgreSQL バージョンなど、フレキシブル サーバーのメタデータが表示されます。

• 管理者ユーザー名 - ターゲット PostgreSQL サーバーの管理者ユーザー名
• パスワード - ターゲット PostgreSQL サーバーのパスワード
• カスタム FQDN/IP (省略可能): カスタム FQDN/IP フィールドは省略可能であり、ターゲットがカスタム DNS サーバーの背後にある場合、またはターゲットにカスタム DNS 名前空間があり、特定の FQDN または IP アドレス経由でのみアクセス可能な場合に使用できます。 たとえば、これには flexibleserver.example.com や 198.1.0.2 などのエントリ、または flexibleserver.postgres.database.azure.com のような PostgreSQL FQDN を含めることができます (カスタム DNS サーバーに DNS ゾーン postgres.database.azure.com が含まれるか、このゾーンのクエリを 168.63.129.16 に転送し、FQDN が Azure のパブリックまたはプライベート DNS ゾーンで解決される場合)。
• テスト接続 - ターゲットとソースの間の接続テストを実行します。 接続が成功すると、ユーザーは次の手順に進むことができます。 それ以外の場合は、ターゲットとソースの間のネットワークの問題を特定し、ターゲットのユーザー名/パスワードを確認する必要があります。 テスト接続には、ターゲットとソースの間の接続を確立するのに数分かかります

テスト接続が成功したら、[次へ: 移行のデータベースの選択] を選択します

移行するデータベースを選択する

[移行するデータベースの選択] タブで、移行元の PostgreSQL サーバーから移行するユーザー データベースの一覧を選択できます。
データベースを選択した後、[次へ: 概要] を選択します

まとめ

[概要] タブには、検証または移行を作成するためのソースとターゲットの詳細がすべてまとめられます。 詳細を確認し、[検証して移行の開始] ボタンを選択します。

移行を監視する

[検証して移行の開始] ボタンを選択後、数秒で検証または移行の作成が成功したことを示す通知が表示されます。 フレキシブル サーバーの [移行] ページのインスタンスにリダイレクトされます。 エントリは InProgress 状態で、PerformingPreRequisiteSteps サブ状態です。 ワークフローでは、移行インフラストラクチャを設定し、ネットワーク接続をチェックするのに 2～3 分かかります。

移行を表示するグリッドには、[名前]、[状態]、[移行モード]、[移行の種類]、[ソース サーバー]、[ソース サーバーの種類]、[データベース]、** [期間]、[開始時刻] の列があります。 エントリは、開始日時の降順に表示され、最新のエントリが先頭に表示されます。 [更新] ボタンを使って、検証または移行の状態を最新の状態に更新できます。

移行の詳細

グリッドで移行の名前を選んで、関連する詳細を表示します。

[セットアップ] タブで、[検証して移行] として移行オプションを選択しました。 このシナリオでは、最初に検証が実行されてから移行が開始されます。 PerformingPreRequisiteSteps サブ状態が完了すると、ワークフローは Validation in Progress サブ状態になります。

• 検証にエラーがある場合、移行は Failed 状態になります。

• 検証がエラーなしで完了すると、移行が開始され、ワークフローは Migrating Data のサブストレートに移ります。

検証の詳細は、インスタンス レベルとデータベース レベルで使用できます。

• インスタンス レベルでの検証

  • 接続チェック、ソース バージョン (つまり PostgreSQL バージョン >= 9.5)、サーバー パラメーター チェック (Azure Database for PostgreSQL - フレキシブル サーバーのサーバー パラメーターで拡張機能が有効になっている場合) に関連する検証が含まれます。

• データベース レベルでの検証

  • これには、フレキシブル サーバーである Azure Database for PostgreSQL での拡張機能と照合順序のサポートに関連する個々のデータベースの検証が含まれています。

検証と移行の状態は、[移行の詳細] ページで確認できます。

移行の状態には、次のものがあります。

移行の状態

移行サブ状態

検証のサブ状態

移行の取り消し

進行中の検証または移行は取り消すことができます。 ワークフローを取り消すには、InProgress 状態である必要があります。 Succeeded または Failed 状態の検証または移行を取り消すことはできません。

• 移行を取り消すと、ターゲット サーバーでそれ以上移行アクティビティは行われなくなり、Canceled 状態になります。 取り消しアクションでは、ターゲット サーバー上で移行サービスによって行われたすべての変更がロールバックされます。

この記事では、PostgreSQL データベースを Amazon RDS for PostgreSQL から Azure Database for PostgreSQL に移行するための Azure CLI の使用について説明します。 Azure CLI には、データベースの移行など、さまざまなタスクを実行できる強力で柔軟なコマンド ライン インターフェイスが用意されています。 この記事で説明されている手順に従うと、データベースを Azure にシームレスに転送でき、その強力な機能とスケーラビリティを活用できます。

移行サービスでの Azure CLI の詳細については、移行サービス用に Azure CLI を設定する方法に関するページを参照してください。

CLI がインストールされたら、コマンド プロンプトを開き、以下のコマンドを使用して自分の Azure アカウントにログインします。

az login

移行タスクを構成する

移行を開始するには、移行の詳細を含む JSON ファイルを作成する必要があります。 この JSON ファイルには、次の情報が含まれています:

• 以下のプレースホルダー << >> を JSON 行で編集し、CLI が呼び出されている <<filename>>.json としてローカル コンピューター内にこれらを格納します。 このチュートリアルでは、ファイルを C:\migration-CLI\migration_body.json に保存しました

{
"properties": {
"SourceDBServerResourceId": "<<source hostname or IP address>>:<<port>>@<<username>>",
        "SecretParameters": {
            "AdminCredentials": {
                "SourceServerPassword": "<<Source Password>>",
                "TargetServerPassword": "<<Target Password>>"
            },
			"targetServerUserName": "<<Target username>>"
        },
        "DBsToMigrate": "<<comma separated list of databases in a array like - ["ticketdb","timedb","inventorydb"]>>",
        "OverwriteDBsInTarget": "true",
        "sourceType": "AWS_RDS",
        "sslMode": "Require"
    }
}

• 次のコマンドを実行して、移行が実行されているかどうかを確認します。 移行名は、Azure Database for PostgreSQL フレキシブル サーバー ターゲット内の移行全体で一意です。

  az postgres flexible-server migration list --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --filter All
  

• 上記の手順では、移行は実行されないため、次のコマンドを実行して新しい移行を開始します

  az postgres flexible-server migration create --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1 --migration-mode offline --migration-option ValidateAndMigrate --properties "C:\migration-cli\migration_body.json"
  

• 次のコマンドを実行して、前の手順で移行状態を開始します。 移行名を指定して、移行の状態を確認できます

  az postgres flexible-server migration show --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1
  

• 移行の進行状況の状態が Azure CLI に表示されます。

• Azure portal で Azure Database for PostgreSQL フレキシブル サーバーの状態を確認することもできます。

• cancel コマンドを使用して、進行中の移行の試行を取り消すことができます。 このコマンドは、特定の移行の試行を停止し、ターゲット サーバー上でのすべての変更をロールバックします。 移行を削除する CLI コマンドを次に示します。

  az postgres flexible-server migration update cancel --subscription 11111111-1111-1111-1111-111111111111 --resource-group my-learning-rg --name myflexibleserver --migration-name migration1