すべてのプロダクト
Search
ドキュメントセンター

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

最終更新日:May 23, 2025

PolarDB では、長期バックアップストレージ、既存データクエリ、バックアップ転送 (OSS など)、および監査要件のために、クラスタバックアップファイルをローカルシステムにダウンロードできます。

説明

ダウンロードしたバックアップデータは、PolarDB for MySQL クラスタに直接リストアすることはできません。最初に 自己管理 MySQL データベースにリストアできます。

リリース日

2023 年 11 月 24 日

説明

バックアップファイルのダウンロード機能はカナリアリリースであり、まもなく正式にリリースされる予定です。

課金

バックアップファイルが作成されると、システムはそれを Database Backup Service (DBS) の組み込みストレージに一時的に保存します。このファイルを指す一時ダウンロード URL が生成されます。バックアップファイルのダウンロード機能を使用すると、URL を使用してバックアップファイルをダウンロードできます。また、バックアップファイルを Object Storage Service (OSS) に転送することもできます。課金方法は、ダウンロード方法によって異なります。

説明
  • ダウンロードタスクが失敗した場合、料金は発生しません。

  • 当月のバックアップデータ量とアウトバウンドインターネットトラフィックを確認するには、PolarDB コンソール にアクセスし、クラスタの [設定と管理] > [バックアップとリストア] > [バックアップダウンロードリスト] ページに移動します。

ストレージ料金

  • URL: ストレージ料金は発生しません。

  • OSS: バックアップファイルは OSS に転送されます。 OSS ストレージ料金については、「ストレージ料金」をご参照ください。

ファイル変換料金

URL からバックアップファイルをダウンロードする場合でも、OSS にバックアップファイルを転送する場合でも、バックアップファイルが SQL、CSV、Parquet、または CSV-with-header 形式に変換されると、変換料金が発生します。形式変換の無料枠はありません。 価格は 0.03125 ドル/GB です。

インターネットトラフィック料金

  • URL:

    • 内部ネットワーク経由のダウンロード: 消費したトラフィックに対して課金されません。

    • インターネット経由のダウンロード: クラスタごとに毎月 500 GB の無料枠があります。無料枠を超えるデータ転送は、ダウンロードされたデータ量に基づいて課金されます。料金は毎日計算されます。具体的な料金については、「ネットワークトラフィック料金」をご参照ください。

    説明

    インターネット経由でバックアップをダウンロードするために発生する料金を相殺するために、サブスクリプション ネットワークプラン を購入することをお勧めします。ネットワークプランの容量が大きいほど、割引率が高くなります。

  • OSS: バックアップファイルを OSS に転送するためのトラフィック料金については、「トラフィック料金」をご参照ください。

前提条件

  • クラスタ: Enterprise Editionクラスター エディションのクラスタのみが、バックアップファイルのダウンロード機能をサポートしています。

  • 地域: 中国 (成都)、中国 (広州)、中国 (青島)、中国 (北京)、中国 (上海)、中国 (張家口)、中国 (杭州)、中国 (深セン)、中国 (香港)、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、日本 (東京)、シンガポール、米国 (シリコンバレー)、米国 (バージニア)、ドイツ (フランクフルト)。

    説明

    この機能は、まもなく他の地域でも利用可能になります。

  • その他:

    • 使用する RAM ユーザーには、バックアップファイルをダウンロードする権限があります。 RAM ユーザーに権限を付与する方法については、「RAM ユーザー権限」をご参照ください。

    • バックアップデータは暗号化されていません。暗号化された PolarDB クラスタは、バックアップファイルのダウンロードをサポートしていません。

制限事項

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

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

    • エクスポート非対応: 式インデックス、外部キー、生成列、非表示列、ビュー、関数、ストアドプロシージャ、システム変数、およびトリガー。

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

    GEOMETRYPOINTLINESTRINGPOLYGONMULTIPOINTMULTILINESTRINGMULTIPOLYGONGEOMETRYCOLLECTION

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

    information_schemamysqlperformance_schemasys__recycle_bin__

  • OSS ダウンロード方法を選択した場合は、OSS が 標準 ストレージタイプを使用していることを確認してください。ストレージタイプの変換方法については、「ストレージタイプの変換」をご参照ください。

    説明

    宛先 OSS バケットを 手動で作成する必要があります。バックアップファイルを保存するためのバケットをすでに作成している場合は、この手順を無視してください。

  • バックアップファイルのダウンロード機能は、レベル 1 バックアップファイル のダウンロードのみをサポートしています。

  • クラスタで コールドデータアーカイブ が有効になっている場合、アーカイブされたコールドデータをダウンロードすることはできません。

手順

(推奨) PolarDB コンソール

  1. PolarDB コンソール にログオンします。左側のナビゲーションウィンドウで、[クラスタ] をクリックします。左上隅で、クラスタのリージョンを選択します。クラスタリストで、クラスタを見つけて、その ID をクリックして [基本情報] ページに移動します。

  2. 左側のナビゲーションウィンドウで、[設定と管理] > [バックアップとリストア] をクリックします。

  3. [データバックアップ] タブをクリックします。ダウンロードするバックアップセットを見つけ、[操作] 列の [クラスタバックアップのダウンロード] をクリックします。

    image

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

    • [クラスタバックアップのダウンロード] が使用できない場合は、クラスタのデータベースエディション、エディション、および地域が 前提条件 を満たしているかどうかを確認してください。

  4. ウィザードの [ポイントインタイムとバックアップセット] ステップで、[ポイントインタイム別にダウンロード] または [バックアップセット別にダウンロード] を選択し、ページの左下隅にある [次へ] をクリックします。

    image.png

  5. ウィザードの インスタンス、データベース、およびテーブル[次へ][インスタンスのダウンロード] ステップで、ページの左下隅にある をクリックします。デフォルトでは、 が選択されています。

  6. ウィザードの [宛先と形式] ステップで、ダウンロード先と形式を選択します。

    重要
    • ダウンロード先を OSS に設定することをお勧めします。これはより時間効率的です。

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

    • バックアップファイルのダウンロードタスクには料金が発生します。料金については、「課金」をご参照ください。

    (推奨) OSS

    ダウンロード先が OSS の場合、データは OSS に直接書き込まれます。使用後は必要に応じて削除できます。

    1. OSS バケット名とディレクトリプレフィックス (xx/xx など) を入力します。

      説明
      • OSS バケットを 手動で作成する必要があります。バックアップファイルを保存するためのバケットをすでに作成している場合は、それを直接入力できます。

      • OSS ストレージタイプは 標準 である必要があります。ストレージタイプを変換する方法については、「ストレージタイプの変換」をご参照ください。

    2. ダウンロード形式を選択します。現在、ダウンロード形式は CSV、SQL、Parquet、または CSV-with-header に設定できます。ビジネス要件に基づいて選択できます。

    3. 関連情報を読み、確認し、[完了] をクリックします。ページは自動的に [バックアップダウンロードリスト] タブにジャンプし、そこでタスクの完了を待ちます。

      説明
      • バックアップファイルのダウンロード機能では、DBS サービスがクラウド リソースにアクセスするための認証が必要です。以前にアクセス権限を承認していない場合は、コンソールのプロンプトに従って [承認] > [承認の確認] をクリックします。権限が付与されたら、高度なダウンロードタスクのパラメータを設定します。

      • 計算変換ではサービス側の計算リソースの競合が必要になるため、一時的なリソース割り当てエラーが発生し、ダウンロードエラーが発生する可能性があります。また、サポートされていない一部の特殊なデータ形式もダウンロードエラーの原因となる可能性があります。ダウンロードタスクが失敗した場合は、再試行するか、DBS テクニカルサポートに連絡してください。

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

    4. バックアップファイルの表示: ダウンロードタスクのステータスが [成功] の場合、ダウンロードは完了です。対応する OSS バケットでファイルを表示できます。

    URL

    ダウンロード先が URL の場合、システムは変換されたデータを DBS 組み込みストレージに一時的に保存します。このプロセスではストレージ料金は発生しません

    説明

    URL ダウンロードにはデータのパッケージングが含まれるため、追加の待ち時間が必要になります。このパッケージングプロセスにかかる時間は、バックアップセットの論理サイズに大きく依存します。論理バックアップサイズが大きい場合 (1 TB 超など) は、OSS にダウンロードすることをお勧めします。

    1. ダウンロード形式を選択します。現在、ダウンロード形式は CSV、SQL、Parquet、または CSV-with-header に設定できます。ビジネス要件に基づいて選択できます。

    2. 関連情報を読み、確認し、[完了] をクリックします。ページは自動的に [バックアップダウンロードリスト] タブにジャンプし、そこでタスクの完了を待ちます。

      説明
      • バックアップファイルのダウンロード機能では、DBS サービスがクラウド リソースにアクセスするための認証が必要です。以前にアクセス権限を承認していない場合は、コンソールのプロンプトに従って [承認] > [承認の確認] をクリックします。権限が付与されたら、バックアップダウンロードタスクのパラメータを設定します。

      • 計算変換ではサービス側の計算リソースの競合が必要になるため、一時的なリソース割り当てエラーが発生し、ダウンロードエラーが発生する可能性があります。また、サポートされていない一部の特殊なデータ形式もダウンロードエラーの原因となる可能性があります。ダウンロードタスクが失敗した場合は、再試行するか、DBS テクニカルサポートに連絡してください。

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

    3. バックアップファイルの表示: ダウンロードタスクのステータスが [成功] の場合、ダウンロードは完了です。[ダウンロード先] 列の [リンクの生成] をクリックし、リンクの [有効期間] を設定し、[リンクの生成] をクリックして、生成された内部または外部ネットワークリンクを介してバックアップデータをダウンロードできます。

      説明
      • ダウンロードタスクが完了してから 3 日以内 にダウンロード URL を取得できます。 URL の有効期間は 5 分から 1 日まで設定でき、デフォルトの有効期間は 2 時間です。

      • 完了したタスクは 3 日後に期限切れ になり (ダウンロードリンクは期限切れになります)、タスクの期限切れ後に対応するデータがクリーンアップされます (クリーンアップはタスクの期限切れ後しばらくしてから自動的に実行されます)。指定された期間内にデータを保持していないが、データを使用したい場合は、新しいダウンロードタスクを開始し、新しいダウンロード URL を取得する必要があります。

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

      • サードパーティのダウンロードツールを使用してバックアップファイルをダウンロードすると、追加のトラフィックが発生し、追加料金が発生する可能性があります。注意して進めてください。具体的なダウンロード方法については、「ダウンロードコマンド」をご参照ください。

API

  1. DescribeDownloadSupport: クラスタがバックアップファイルのダウンロード機能をサポートしているかどうかを確認します。

    説明

    API が機能がサポートされていないことを返す場合は、クラスタのデータベースエディション、エディション、および地域が 前提条件 を満たしているかどうかを確認してください。

  2. CreateDownload: バックアップファイルのダウンロードタスクを作成します。

    説明
    • バックアップファイルをダウンロードするには、DBS サービスがクラウド リソースにアクセスすることを許可する AliyunDBSDefaultRole 権限が必要です。

    • OSS ダウンロード方法を使用する場合は、最初に対応する OSS バケットを 手動で作成し、OSS が 標準 ストレージタイプを使用していることを確認してください。

    • URL ダウンロード方法を使用する場合は、返されたパラメータ TaskId (タスク ID) を保存して、ダウンロードリンクを取得します。

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

    • バックアップファイルのダウンロードタスクには料金が発生します。料金については、「課金」をご参照ください。

  3. (オプション) DescribeDownloadTask: ダウンロードタスクステータスを含む、クラスタのバックアップファイルダウンロードタスク情報を表示します。

  4. バックアップファイルの取得:

    • OSS ダウンロード方法を使用する場合、システムはバックアップデータを OSS に直接書き込み、対応するバケットでデータを表示できます。

    • URL ダウンロード方法を使用する場合は、DescribeDownloadBackupSetStorageInfo を使用してダウンロードリンクを取得できます。

      説明
      • ダウンロードタスクが完了してから 3 日以内 にダウンロード URL を取得できます。 URL の有効期間は 5 分から 1 日まで設定でき、デフォルトの有効期間は 2 時間です。

      • 完了したタスクは 3 日後に期限切れ になり (ダウンロードリンクは期限切れになります)、タスクの期限切れ後に対応するデータがクリーンアップされます (クリーンアップはタスクの期限切れ後しばらくしてから自動的に実行されます)。指定された期間内にデータを保持していないが、データを使用したい場合は、新しいダウンロードタスクを開始し、新しいダウンロード URL を取得する必要があります。

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

      • サードパーティのダウンロードツールを使用してバックアップファイルをダウンロードすると、追加のトラフィックが発生し、追加料金が発生する可能性があります。注意して進めてください。具体的なダウンロード方法については、「ダウンロードコマンド」をご参照ください。

FAQ

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

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

ダウンロードしたデータバックアップファイルとログバックアップファイルはどのように使用しますか?

ダウンロードしたバックアップファイルをローカルの MySQL データベースに復元するときに、ERROR 1148 (42000): The used command is not allowed with this MySQL version というエラーが発生した場合はどうすればよいですか?

MySQL データベースで show variables like 'local_infile'; // ローカルファイルのインポート設定を確認 クエリ スクリプトを実行します。結果が OFF の場合は、set global local_infile = 1; // ローカルファイルのインポートを有効化 文を実行してファイルのインポートを有効にします。上記操作が完了したら、インポート スクリプトを再度実行します。

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

ダウンロードしたバックアップファイルは圧縮されているため、通常、PolarDB コンソールに表示されるバックアップサイズよりも小さくなります。ファイルを解凍して、データが完全かどうかを確認できます。

ダウンロードしたバックアップファイルを別の PolarDB クラスタに直接リストアできますか?

ダウンロードしたバックアップファイルを別の PolarDB クラスタに直接リストアすることはできません。最初に バックアップファイルを自己管理 MySQL データベースにリストアし、次に DTS を使用して 自己管理 MySQL から PolarDB for MySQL クラスタにデータを移行できます。

RAM ユーザー権限

RAM ユーザー権限

バックアップファイルのダウンロード機能は、権限管理に RAM を使用します。 RAM ユーザーにバックアップファイルのダウンロード権限を付与または制限することで、バックアップファイルのダウンロードを制御できます。

バックアップファイルをダウンロードする権限を付与する

バックアップファイルのダウンロード機能 (ダウンロードタスクの作成やクエリなど) を使用できない場合は、データディザスタリカバリ管理権限 (AliyunDBSFullAccess) が RAM ユーザーに付与されているかどうかを確認してください。権限の付与方法については、「RAM ユーザーに権限を付与する」をご参照ください。

RAM ユーザーがバックアップファイルのダウンロード URL を取得できないようにする

RAM ユーザーにバックアップとリストア機能を使用させたいが、ダウンロード URL を取得させたくない場合は、カスタムポリシーを作成することで、RAM ユーザーがダウンロード URL を取得するための API を呼び出せないようにすることができます。サンプルスクリプト:

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

カスタムポリシーを作成したら、付与 それを RAM ユーザーに付与します。これにより、RAM ユーザーはダウンロード URL を取得できなくなります。

読み取り専用 RAM ユーザーがバックアップファイルをダウンロードできるようにする

セキュリティを確保するために、PolarDB データベースへの読み取り専用権限 (AliyunPolardbReadOnlyAccess) を持つ RAM ユーザーは、バックアップファイルをダウンロードできません。

RAM ユーザーがバックアップファイルをダウンロードする必要がある場合は、データディザスタリカバリへの読み取り専用アクセス権限 (AliyunDBSReadOnlyAccess) をユーザーに付与します。これにより、RAM ユーザーは既存のバックアップダウンロードタスクのダウンロードリンクを表示できます。権限の付与方法については、「RAM ユーザーに権限を付与する」をご参照ください。

image.png

ダウンロードコマンド

説明
  • ダウンロード速度が 64 KB/秒より遅い場合、ダウンロードが中断される可能性があります。バックアップファイルをダウンロードする際は、最適なネットワーク状態を確保することをお勧めします。

  • OSSFS マウント済みディスクにバックアップファイルをダウンロードする場合は、OSSFS の [multipart_size] パラメーターを調整します。デフォルトでは、このパラメーターは最大 100 GB のファイルサイズをサポートしています。バックアップファイルが 100 GB を超えると、ダウンロードは失敗します。詳細については、「OSSFS」および「マウントオプション」をご参照ください。

  • バックアップファイルのダウンロードには、このトピックで提供されている wget コマンドと curl コマンドを使用することをお勧めします。サードパーティツールを使用してバックアップファイルをダウンロードすると、バックアップファイルが複数回ダウンロードされる可能性があります。その結果、ダウンロードされるデータ量がバックアップファイルのサイズよりも大きくなり、インターネット経由で超過データ量をダウンロードするために消費されたトラフィックに対して課金される可能性があります。

wget

nohup wget -c -t 0 "backup file download URL" -O destination file path and name > redirect log information to a specific log file &

パラメーター

パラメーター

説明

nohup

ターミナルが誤って閉じられた場合、またはセッションが切断された場合でも、ダウンロードが続行されるようにします。ダウンロードが完了すると、プロセスは自動的に終了します。

-c

再開可能なダウンロードを有効にします。

-t

リトライ試行回数。 0 に設定すると、無制限にリトライされます。

-O

宛先ファイルのパスと名前を指定します。

nohup wget -c -t 0 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -O /backup/examplebackup.tar.gz > /tmp/download.log &

curl

nohup curl -C - --retry 10 "backup file download URL" -o custom file name > redirect log information to a specific log file &

パラメーター

パラメーター

説明

nohup

ターミナルが誤って閉じられた場合、またはセッションが切断された場合でも、ダウンロードが続行されるようにします。ダウンロードが完了すると、プロセスは自動的に終了します。

-C -

再開可能なダウンロードを有効にします。

--retry

リトライ試行回数。

-o

宛先ファイルのパスと名前を指定します。

nohup curl -C - --retry 10 "http://dbs-xxx.aliyuncs.com/xxx.tar.gz?xxx" -o /backup/examplebackup.tar.gz > /tmp/download.log &