ポイント・イン・タイム・リカバリー

IBM Cloud® Databases for PostgreSQL 過去7日以内の利用可能な復旧時点へのポイント・イン・タイム復旧(PITR)に対応しています。 PITRは、バックアップを新しいデプロイメントに復元し、保持されているトランザクション・ログを指定された時点まで再生します。

ポイント・イン・タイム・リカバリ(PITR)では、インプレース・メジャー・バージョン・アップグレード(IPMVU)をまたぐトランザクションを再生することはできません。 アップグレード後、アップグレードタスクが開始される前の時点、またはアップグレード後のデプロイメントの最初のバックアップが完了した後の時点に復元することができます。 アップグレードから次のバックアップが完了するまでの間の時点への復元はサポートされていません。 バックアップが完了した後でも、特定の時点への復元はサービスによって拒否される場合があり、また、他の時点への復元は受け入れられるものの、復元処理の途中で失敗する場合があります。

アップグレードが正常に完了すると、サービスは自動的にバックアップをキューに登録します。 書き込みが再開されてからそのバックアップが完了するまでの間、利用可能な最新の復旧ポイントへの復元も失敗します。

アップグレードに失敗した場合は、 PostgreSQL のバージョンを確認してください: SHOW server_version;。 コマンドによってソースのバージョンが報告され、かつデプロイ先が書き込みを受け付けている場合は、オンデマンドのバックアップを実行してください。 それ以外の場合は、サポートまでお問い合わせください。 詳細については、「 IPMVU のバックアップと復旧」を 参照してください。

デプロイメントのUIにある「 バックアップと復元 」タブには、「 ポイント・イン・タイム復元 」の下に、すべてのPITR情報がまとめられています。

要求された復元時刻が、利用可能な最新のトランザクションよりも後の場合、復元操作は「 recovery ended before configured recovery target was reached 」というメッセージとともに失敗します。 この理由で復元が失敗した場合は、「 利用可能な最新の時点に復元 」を選択してください。 あるいは、「 過去7日間の特定の時点に復元 」を選択し、より前の日時を指定することもできます。 IPMVUの実行中、およびアップグレードされたデプロイメントの最初のバックアップが完了するまでは、利用可能な最新の時点への復元が失敗する可能性があります。

含まれている情報は、PITR できる最も古い時刻です。 CLI を使用して最も古いリカバリー・ポイントを検出するには、cdb postgresql earliest-pitr-timestamp コマンドを使用します。

ibmcloud cdb postgresql earliest-pitr-timestamp <INSTANCE_NAME_OR_CRN>

API を使用して最も古いリカバリー・ポイントを調べるには、/deployments/{id}/point_in_time_recovery_data エンドポイントを使用して、最も古い PITR 時刻を確認します。

{
    "point_in_time_recovery_data": {
        "earliest_point_in_time_recovery_time": "2019-09-09T23:16:00Z"
    }
}

回復

バックアップは新規デプロイメントにリストアされます。 新規デプロイメントがプロビジョニングを終了すると、バックアップ・ファイル内のデータが新規デプロイメントにリストアされます。 バックアップは、アカウント間でリストアすることもできますが、API を使用している場合で、かつ、リストアを実行するユーザーがソース・アカウントと宛先アカウントの両方へのアクセス権限を持っている場合に限られます。

デフォルトでは、新規デプロイメントは、リストア元のバックアップ時のソース・デプロイメントと同じディスクおよびメモリー割り振りに自動的にサイズ変更されます。 特に、デプロイメントの現在のサイズではない可能性がある PITR の場合には注意してください。 新規デプロイメントに割り振るリソース量を調整する必要がある場合は、UI、CLI、または API のフィールドを使用して新しいデプロイメントのサイズを変更します。 データとワークロードに十分な量を割り振ってください。デプロイメントに十分なリソースが指定されていない場合、リストアは失敗します。

ストレージとメモリーはソース・デプロイメントと同じにリストアされますが、新規インスタンスの固有のインスタンス構成は自動設定されません。 この場合は、リストア後の構成の再実行が必要になることがあります。 復元を実行する前に、インスタンスへの変更点( shared_buffers、 max_connections、 deadlock_timeout、 archive_timeout などのパラメータ)をすべて記録し、復元完了後にインスタンスの設定が正確になるようにしてください。

バックアップのリストア中にソース・デプロイメントを削除しないことが重要です。 古いデプロイメントを削除する前に、新規デプロイメントがプロビジョンされ、バックアップがリストアされるまで待機する必要があります。 デプロイメントを削除すると、そのバックアップも削除されてしまうため、復元が失敗するだけでなく、バックアップの復旧もできなくなる可能性があります。

UI でのリカバリー

PITR を開始するには、復元先の時刻を協定世界時で入力します。 リストア可能な最新の時刻にリストアする場合は、そのオプションを選択します。 Restore ボタンをクリックすると、新しいプロビジョニングUIが表示され、リカバリーのためのオプションがタブに表示されます。 サービスの詳細を入力し、リソースを割り当て、新しいデプロイメント用にデータベースのバージョン、暗号化、エンドポイントを設定します。 ポイント・イン・タイム・リカバリーをクリックして処理を開始する。

Key Protect を使用しており、キーをお持ちの場合は、復旧には CLI を使用する必要があります。利便性を考慮し、専用のコマンドが用意されています。

CLI でのリカバリー

リソース・コントローラーはデータベース・デプロイメントのプロビジョニングをサポートしており、プロビジョニングとリストアはリソース・コントローラーの CLI で実行します。 resource service-instance-create コマンドを使用します。

PITR では、point_in_time_recovery_time パラメーターと point_in_time_recovery_deployment_id パラメーターを使用します。 point_in_time_recovery_deployment_idはソース・デプロイメントの ID であり、point_in_time_recovery_timeはリストア先の協定世界時のタイム・スタンプです。 使用可能な最新の特定時点にリストアするには、"point_in_time_recovery_time":" "を使用します。

ibmcloud resource service-instance-create <databases-for-postgresql> <INSTANCE_NAME> <REGION> -p '{"point_in_time_recovery_deployment_id":"DEPLOYMENT_ID", "point_in_time_recovery_time":"TIMESTAMP", "version":" "}'

バックアップの詳細ビューでは、特定のバックアップまたは PITR のために事前に構成されたコマンドを利用できます。

CLI を使用してリストアする場合は、オプション・パラメーターを使用できます。 これらを使用してリソースをカスタマイズするか、新規デプロイメントで BYOK 暗号化用の Key Protect 鍵を使用します。

ibmcloud resource service-instance-create <databases-for-postgresql> <INSTANCE_NAME> standard <REGION> <--service-endpoints SERVICE_ENDPOINTS_TYPE> -p
'{"point_in_time_recovery_deployment_id":"DEPLOYMENT_ID", "point_in_time_recovery_time":"TIMESTAMP","key_protect_key":"KEY_PROTECT_KEY_CRN", "members_disk_allocation_mb":"DESIRED_DISK_IN_MB", "members_memory_allocation_mb":"DESIRED_MEMORY_IN_MB", "members_cpu_allocation_count":"NUMBER_OF_CORES", "version":" "}'

API でのリカバリー

リソース・コントローラーはデータベース・デプロイメントのプロビジョニングをサポートしており、プロビジョニングとリストアはリソース・コントローラー API で実行します。 リソース・コントローラー API を使用してバックアップからリストアする前に、リソース・コントローラー API を使用するために必要なステップを完了する必要があります。

すべての情報が表示されると、作成要求 POST が /resource_instances エンドポイントに送信されます。

curl -X POST \
  https://resource-controller.cloud.ibm.com/v2/resource_instances \
  -H 'Authorization: Bearer <>' \
  -H 'Content-Type: application/json' \
    -d '{
    "name": "<INSTANCE_NAME>",
    "target": "<REGION>",
    "resource_group": "<RESOURCE_GROUP>",
    "resource_plan_id": "<SERVICE_ID>",
    "parameters": {
      "point_in_time_recovery_time": "<TIMESTAMP>",
      "point_in_time_recovery_deployment_id": "<DEPLOYMENT_ID>"
    }
  }'

パラメーターの name、target、resource_group、resource_plan_id はすべて必須です。 target は、新規デプロイメントを配置するリージョンで、ソース・デプロイメントとは別のリージョンにすることもできます。 eu-deバックアップを別のリージョンにリストアする場合を除き、リージョン間リストアがサポートされます。

PITR では、point_in_time_recovery_time パラメーターと point_in_time_recovery_deployment_id パラメーターを使用します。 point_in_time_recovery_deployment_idはソース・デプロイメントの ID であり、point_in_time_recovery_timeはリストア先の協定世界時のタイム・スタンプです。 使用可能な最新の特定時点にリストアするには、"point_in_time_recovery_time":" "を使用します。

これらのパラメータを、リクエスト本文の parameters オブジェクトに指定してください。 リソースの割り当てをカスタマイズしたり、 Key Protect キーを使用したりするには、該当するパラメータを同じオブジェクトに追加してください: key_protect_key、 members_disk_allocation_mb、 members_memory_allocation_mb、および members_cpu_allocation_count。

PITR の検証

リカバリー時間が正しいことを確認するには、データベース・ログを確認してください。 データベースのログを参照するには、ロギングとの統合をデプロイメントにセットアップする必要があります。

リカバリーを実行すると、データは最新の増分バックアップからリストアされます。 WAL ログからの未解決のトランザクションは、リカバリーした時点までデータベースをリストアするために使用されます。 復旧が完了し、トランザクションが実行されると、ログには次のようなメッセージが表示されます

LOG:  last completed transaction was at log time 2019-09-03 19:40:48.997696+00

デプロイメントに直近のフルバックアップがあり、そのバックアップ後にリプレイが必要なアクティビティがない場合、リカバリはログに記録されません。 この場合、通常は復旧は成功しますが、ログにはデータベースが復元された正確な時刻を示すエントリは記録されません。