PolarDB:バックアップファイルのダウンロード

リリース日

2023年11月24日

シナリオ

PolarDBは、完全なデータ復元と個々のデータベースまたはテーブルの復元に加えて、バックアップダウンロード機能を提供します。 次の目的で、クラスターのバックアップファイルをコンピューターにダウンロードできます。

• バックアップファイル内のデータを照会します。

• 特定の時点でデータを照会します。

• バックアップファイルをコンピュータに保存します。

• 監査用のバックアップファイルをダウンロードします。

• バックアップファイルをObject Storage Service (OSS) バケットにアップロードします。

課金

ダウンロード用に生成されたファイル変換とインターネットトラフィックに対して課金されます。

前提条件

{
    "Version": "1",
    "Statement": [
        {
            "Effect": "Deny",
            "Action": "dbs:DescribeDownloadBackupSetStorageInfo",
            "Resource": "*"
        }
    ]
}

制限事項

• バックアップダウンロード機能を使用すると、ほとんどのスキーマをエクスポートできます。 ただし、一部のスキーマはエクスポートできません。

  • 列情報、主キーインデックス、非主キーインデックス、一意インデックス、パーティションテーブル情報、テーブルエンジン、テーブルレベルまたはデータベースレベルの文字セットと文字照合順序をエクスポートできます。

  • 式インデックス、外部キー、生成された列、非表示の列、ビュー、関数、ストアドプロシージャ、システム変数、またはトリガーをエクスポートすることはできません。

• バックアップダウンロード機能は、空間データ型のフィールドをサポートしていません。 PolarDBクラスターに次の空間データ型のフィールドが含まれている場合、バックアップファイルの変換は失敗します。

  GEOMETRY、POINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、およびGEOMETRYCOLLECTION

• PolarDBクラスターからエクスポートするCSVファイルには、次のシステムデータベースは含まれません。

  information_schema、mysql、performance_schema、sys、および __recycle_bin_

• Download DestinationパラメーターをOSSに設定した場合、標準ストレージクラスのみがサポートされます。 ストレージクラスを変更する方法については、「ストレージクラスの変換」をご参照ください。

• レベル1バックアップファイルのデータのみダウンロードできます。 レベル2バックアップファイルのデータはダウンロードできません。

• クラスターでコールドデータアーカイブが有効になっている場合、アーカイブされたコールドデータはダウンロードできません。 詳細については、「コールドデータのアーカイブ」をご参照ください。

手順

1. PolarDB コンソールにログインします。 左上隅のリージョンを選択し、クラスターのIDをクリックして 概要 ページに移動します。

2. 左側のナビゲーションウィンドウで、[バックアップとリカバリ] をクリックします。

3. [バックアップと復元] ページで、[データバックアップ] をクリックします。

4. バックアップセットを見つけて、アクション 列の [クラスターバックアップのダウンロード] をクリックします。

   

   説明

   • デフォルトでは、PolarDBコンソールには、直近の8日間に生成されたバックアップセットが表示されます。 8日前に生成されたバックアップセットを表示する場合は、デフォルトの時間範囲を変更する必要があります。

   • [クラスターバックアップのダウンロード] が表示されない場合は、クラスターのメジャーエンジンのバージョンまたはリージョンが [前提条件] に記載されている要件を満たしているかどうかを確認します。

5. ウィザードの [時点とバックアップセット] ステップで、[時点でダウンロード] または [バックアップセットでダウンロード] を選択し、[次へ] をクリックします。

   

6. ウィザードの [インスタンス、データベース、およびテーブル] ステップで、[次へ] をクリックします。

   説明

   デフォルトでは、インスタンスダウンロードが選択されています。

7. ウィザードの [宛先とフォーマット] ステップで、ダウンロード先とフォーマットを設定します。

   重要

   • 効率を確保するために、Download DestinationパラメーターをOSSに設定することを推奨します。

   • バックアップダウンロードタスクは、開始後はキャンセルできません。

   • OSS (推奨): PolarDBはバックアップデータをOSSに直接書き込みます。 OSSバケットのバケット名とディレクトリプレフィックスを設定する必要があります。

     説明

     OSSリソースへのアクセス権限がない場合は、コンソールの指示に従って [権限付与] > [権限付与ポリシーの確認] をクリックします。 権限が付与されたら、バックアップダウンロードタスクのパラメーターを設定します。

   • URL: PolarDBは内部または外部URLを提供します。 URLを使用してバックアップデータをダウンロードできます。

     説明

     • URLメソッドを使用してバックアップデータをダウンロードすると、ダウンロードされたデータはDBSの内蔵ストレージに保存されます。 詳細については、「組み込みストレージとOSS」をご参照ください。

     • URLのダウンロードにはデータパッケージが含まれるため、追加の待ち時間が必要です。 このパッケージングプロセスの期間は、バックアップセットの論理サイズに大きく依存します。 バックアップセットの論理サイズが1テラバイトを超える場合は、[OSS] を選択することを推奨します。

     

8. ダウンロード形式パラメーターを設定します。

   説明

   Download FormatパラメーターをCSV、SQL、Parquet、またはCSV-with-headerに設定できます。

9. 指示を読んで選択し、[完了] をクリックします。

10. [バックアップダウンロード] タブが表示されます。

    重要

    • バックアップファイルをダウンロードすると、ファイル変換料金とインターネットトラフィック料金が請求されます。 詳細については、「課金ルール」をご参照ください。

    • サードパーティのダウンロードツールを使用してバックアップファイルをダウンロードすると、追加のトラフィックが生成され、追加料金が発生する可能性があります。 作業は慎重に行ってください。 詳細については、「ダウンロードコマンド」をご参照ください。

    • コンピューティングリソースは、ダウンロードされたバックアップセットを変換するために競合する。 その結果、一時的なリソース割り当てが失敗し、ダウンロードタスクが失敗する可能性があります。 ダウンロードタスクは、サポートされていない特別なデータ形式のために失敗する場合もあります。 ダウンロードタスクが失敗した場合は、再試行するか、DBSテクニカルサポートにお問い合わせください。

    • 失敗したタスクに対して料金は発生しません。

    • Download DestinationパラメーターをOSSに設定し、タスクのステータスがRunningからFinishedに変更された場合、ダウンロードは成功します。 指定されたOSSバケットでダウンロードしたファイルを表示して使用できます。

      説明

      この方法を使用すると、データはOSSバケットに直接ダウンロードされます。 ビジネス要件に基づいてデータを使用および削除できます。

    • [Download Destination] パラメーターをURLに設定し、タスクのステータスが [Finished] に変更された場合、[Download Destination] 列の [Generate Link] をクリックします。 [リンクの生成] ダイアログボックスで、[有効期間] パラメーターを設定し、[リンクの生成] をクリックします。 その後、生成されたURLを使用してバックアップデータをダウンロードできます。

      重要

      • タスク終了後3日以内にURLを取得できます。 URLの有効期間は5分から1日です。 デフォルトの有効期間は2時間です。

      • 完了したタスクは3日で期限切れになります。 タスクの有効期限が切れると、URLは無効になります。

      • タスクの有効期限が切れると、一定期間後に対応するデータが自動的に削除されます。 データを使用する場合は、新しいダウンロードタスクを開始し、新しいダウンロードURLを取得する必要があります。

      • できるだけ早い機会にURLを保存し、URLの機密を保持することをお勧めします。

よくある質問

• ダウンロードしたデータバックアップファイルとログバックアップファイルを使用するにはどうすればよいですか?

  自己管理型MySQLデータベースにダウンロードしたバックアップファイルのデータを復元できます。 詳細については、「スナップショットバックアップファイルを使用してPolarDBクラスターのデータを自己管理型MySQLデータベースに復元する」をご参照ください。

• バックアップダウンロード機能を使用してダウンロードしたバックアップファイルのデータを自己管理型のMySQLデータベースに復元するときに、エラー1148 (42000): 使用中のコマンドはこのMySQLバージョンで許可されていません。

  自己管理MySQLデータベースでSHOW VARIABLES LIKE 'local_infile'; ステートメントを実行します。 出力でOFFが返された場合は、SETステートメントを実行してグローバルlocal_infileパラメーターを1に設定し、ファイルのインポートを有効にします。 上記の操作を実行した後、インポートスクリプトを再実行します。

• PolarDBコンソールに表示されるバックアップファイルのサイズが、ダウンロードしたファイルのサイズと異なるのはなぜですか。

  ダウンロードしたバックアップファイルは圧縮されています。 その結果、ダウンロードされたバックアップファイルのサイズは、PolarDBコンソールに表示されるファイルサイズよりも小さくなります。 バックアップファイルからデータを復元した後、データの整合性を確認できます。

• PolarDBコンソールからダウンロードしたバックアップファイルを別のPolarDBクラスターに直接復元できますか。

  バックアップファイルを別のPolarDBクラスターに直接復元することはできません。 バックアップファイルを別のPolarDBクラスターに復元する場合は、次の操作を実行します。バックアップファイルを自己管理型MySQLデータベースに復元してから、自己管理型データベースから必要なPolarDBクラスターにデータを移行します。 詳細については、「スナップショットバックアップファイルを使用してPolarDBクラスターのデータを自己管理型MySQLデータベースに復元する」および「自己管理型MySQLデータベースから」をご参照ください。

• 進行中のバックアップダウンロードタスクをキャンセルできますか?

  いいえ、起動後にバックアップダウンロードタスクをキャンセルすることはできません。

ダウンロードコマンド

ここでは, バックアップファイルのダウンロードに使用するコマンドについて说明します。

Command: nohup wget -c -t 0 "The URL of the backup file to download" -O The destination path and file name > The file to which the downloaded data is saved &
Example: nohup wget -c -t 0 "https://example.aliyundoc.com/examplebackup.qp.xb" -O /backup/examplebackup.qp.xb > /tmp/download.log &
The following section describes the options in the preceding command:
-t 0: enables an unlimited number of retries. 
-c: enables resumable uploads. 
-O: specifies the destination path and file name. 
nohup: prevents the download from being interrupted when you accidentally replicate data or disconnect your database client during the download. If you specify this option, the download process automatically exits after the download is completed.

Command: nohup curl -C - --retry 10 "The URL of the backup file to download" -o The user-defined name of the downloaded backup file > The file to which the downloaded data is saved &
Example: nohup curl -C - --retry 10 "https://example.aliyundoc.com/examplebackup.qp.xb" -o backup.qp.xb > /tmp/download.log &
The following section describes the options in the preceding command:
--retry 10: enables up to 10 retries if the download fails. 
-C -: enables resumable uploads. 
-o: specifies the destination path and file name. 
nohup: prevents the download from being interrupted when you accidentally replicate data or disconnect your database client during the download. If you specify this option, the download process automatically exits after the download is completed.

関連する API