クラスターバックアップファイルのダウンロード方法 - PolarDB

リリース日

2023 年 11 月 24 日

説明

バックアップファイルダウンロード機能はカナリアリリース中であり、段階的に展開されます。

課金

バックアップファイルは URL 経由 (Database Backup Service (DBS) に一時保存) またはお客様の OSS へ転送してダウンロードできます。ダウンロード先によって料金が異なります。

説明

ダウンロードタスクが失敗した場合、料金は発生しません。
PolarDB コンソールで、クラスターの 設定と管理 > バックアップと復元 > バックアップのダウンロードリスト に移動して、[月次バックアップ変換量] と [月次アウトバウンドインターネットトラフィック] を表示できます。

ストレージ料金

URL：ファイルは DBS の組み込みストレージに一時保存されます。ストレージ料金は発生しません。
OSS：ファイルはお客様の OSS バケットに転送されます。OSS ストレージ料金の詳細については、OSS ストレージ料金をご参照ください。

バックアップセット変換料金

バックアップセットを SQL、CSV、Parquet、CSV-with-header 形式に変換する場合、ダウンロード先が URL であっても OSS であっても変換料金が発生します。この変換には無料枠はありません。料金は GB あたり 0.03125 米ドルです。

トラフィック料金

URL：
- 内部ネットワーク経由のダウンロード：無料です。
- インターネット経由のダウンロード：クラスターごとに月間 500 GB の無料枠が提供されます。無料枠を超えるデータ転送には従量課金が適用されます。料金はダウンロードされたデータ量に基づいて毎日計算されます。料金の詳細については、ネットワーク料金をご参照ください。
説明
インターネット経由でバックアップをダウンロードする際のネットワークトラフィック料金をカバーするため、サブスクリプションデータ転送プランの購入を推奨します。データ転送プランの容量が大きいほど、割引率が高くなります。
OSS：ファイルはお客様の OSS バケットに転送されます。トラフィック料金の詳細については、OSS トラフィック料金をご参照ください。

前提条件

クラスター: この機能は、エンタープライズ版クラスターの Cluster Edition でのみ利用可能です。
リージョン：中国 (成都) 、中国 (広州) 、中国 (青島) 、中国 (北京) 、中国 (上海) 、中国 (張家口) 、中国 (杭州) 、中国 (深セン) 、香港 (中国) 、マレーシア (クアラルンプール) 、インドネシア (ジャカルタ) 、日本 (東京) 、シンガポール、米国 (シリコンバレー) 、米国 (バージニア) 、ドイツ (フランクフルト) 。

説明
この機能は近日中に他のリージョンでも利用可能になります。
その他：
- RAM ユーザーはバックアップファイルをダウンロードする権限を持っている必要があります。RAM ユーザーに権限を付与するには、RAM ユーザー権限をご参照ください。
- バックアップデータは暗号化されていません。暗号化された PolarDB クラスターからバックアップファイルをダウンロードすることはできません。
- クラスターまたはインスタンスごとに、一度に 1 つのダウンロードタスク (実行中または失敗したもの) のみが許可されます。

制限事項

ダウンロードプロセスでは、ほとんどのテーブル構造がエクスポートされますが、すべてではありません。
- エクスポート対象：列情報、プライマリキーインデックス、非プライマリキーインデックス、ユニークインデックス、パーティションテーブル情報、テーブルエンジン、テーブルまたはデータベースレベルの文字セットと照合順序。
- エクスポート対象外：式インデックス、外部キー、生成列、非表示列、ビュー、関数、ストアドプロシージャ、システム変数、トリガー。
データに以下の空間データ型のフィールドが含まれている場合、変換タスクは失敗します。

GEOMETRY、POINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTION
エクスポートされたファイルには、以下のシステムデータベースは含まれません。

information_schema、mysql、performance_schema、sys、__recycle_bin__
ダウンロード先として OSS を選択した場合、OSS バケットのストレージクラスはStandardにする必要があります。ストレージクラスを変更するには、「ストレージクラスの変換」をご参照ください。

説明
OSS バケットは手動で作成する必要があります。バックアップファイルを保存するためのバケットをすでに作成している場合は、この手順をスキップできます。
レベル 1 バックアップからのみデータをダウンロードできます。レベル 2 バックアップからのデータはダウンロードできません。
クラスターでコールドデータアーカイブが有効になっている場合、バックアップセットをダウンロードすることはできません。
ダウンロード対象のデータベースまたはテーブルの名前にスラッシュ (/) が含まれている場合、ダウンロードタスクは失敗します。

操作手順

(推奨) コンソールの使用

PolarDB コンソールにログインします。左側のナビゲーションペインで、クラスター をクリックします。クラスターが配置されているリージョンを選択し、クラスター ID をクリックしてクラスターの詳細ページに移動します。
左側のナビゲーションペインで、設定と管理 > バックアップと復元をクリックします。
データバックアップ タブで、目的のバックアップセットを見つけ、操作列の クラスターのバックアップのダウンロード をクリックします。
説明
- デフォルトでは、コンソールには過去 8 日間のバックアップが表示されます。それ以前のバックアップを表示するには、時間範囲を変更する必要があります。
- クラスターのバックアップのダウンロード ボタンが表示されない場合は、お使いのクラスターの製品バージョンまたはリージョンが前提条件を満たしていることを確認してください。
タイムポイントとバックアップセットのダウンロード ステップで、時点ごとにダウンロードする または バックアップセットごとにダウンロードする を選択し、次へをクリックします。

**[バックアップセットでダウンロード]** を選択した場合は、**[バックアップセット]** ドロップダウンリストから対象のバックアップセットを選択します。
インスタンスとライブラリテーブルのダウンロード ステップで、次へをクリックします。インスタンスのダウンロード オプションはあらかじめ選択されており、変更できません。
ターゲットとフォーマットのダウンロード ステップで、ダウンロード先とフォーマットを選択し、設定を完了します。
重要
- 時間を節約するため、ダウンロード先として OSS を選択することを推奨します。
- バックアップダウンロードタスクは、開始後にキャンセルすることはできません。
- バックアップダウンロードタスクには料金が発生します。詳細については、「課金」をご参照ください。
(推奨) OSS

ダウンロード先として OSS を選択すると、データはお客様の OSS バケットに直接書き込まれます。ダウンロード完了後、必要に応じてデータを削除できます。
1. OSS バケット名とディレクトリプレフィックス (xx/xx など) を入力します。
  説明
  
  OSS バケットは手動で作成する必要があります。バックアップファイルを保存するためのバケットをすでに作成している場合は、その名前を直接入力できます。
  
  OSS バケットのストレージクラスはStandardである必要があります。ストレージクラスを変更するには、「ストレージクラスを変換する」をご参照ください。
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. バックアップファイルの表示: ダウンロードタスクのステータスが成功の場合、ダウンロードは完了です。ダウンロード対象 列で、Generate URL をクリックし、有効期間 を設定した後、Generate URL をクリックします。その後、生成された内部 URL またはパブリック URL を使用してバックアップデータをダウンロードできます。
  説明
  
  ダウンロードリンクは、タスク完了後 3 日以内 に取得できます。リンクの有効期間は 5 分から 1 日まで設定できます。デフォルトの有効期間は 2 時間です。
  
  完了したタスクは 3 日後に期限切れとなり、その時点でダウンロードリンクも期限切れになります。期限切れのタスクのデータは、期限切れ後に自動的に削除されます。データがまだ必要な場合は、新しいダウンロードタスクを開始して新しいダウンロードリンクを取得する必要があります。
  
  ダウンロードリンクを保存し、データ漏洩を防ぐために機密を保持してください。
  
  サードパーティのダウンロードツールを使用すると、追加のダウンロードトラフィックが発生し、追加料金が発生する可能性があります。これらのツールは慎重に使用してください。推奨されるダウンロード方法については、ダウンロードコマンドをご参照ください。

API の使用

DescribeDownloadSupport API：クラスターがバックアップファイルダウンロード機能をサポートしているかどうかを照会します。

説明
API レスポンスで機能がサポートされていないことが示された場合は、クラスターの製品バージョンとリージョンが前提条件を満たしているか確認してください。
CreateDownload API：バックアップファイルダウンロードタスクを作成します。
説明
- バックアップダウンロード機能では、DBS がお客様のクラウドリソースにアクセスするための AliyunDBSDefaultRole 権限を付与する必要があります。これらの権限を付与していない場合は、まずコンソールを使用して権限を付与できます。
- TargetType (ダウンロード先タイプ) が OSS の場合、まず宛先バケットを手動で作成し、そのストレージクラスが Standard であることを確認する必要があります。
- TargetType (ダウンロード先タイプ) が URL の場合、返された TaskId (タスク ID) を保存して、ダウンロードリンクを取得する必要があります。
- バックアップダウンロードタスクは、開始後にキャンセルすることはできません。
- バックアップダウンロードタスクには料金が発生します。詳細については、「課金」をご参照ください。
(オプション) DescribeDownloadTask API：クラスターのバックアップダウンロードタスクのステータスとその他の詳細を表示します。
バックアップファイルの取得：
- ダウンロード先が OSS の場合、システムはデータをお客様の OSS バケットに直接書き込み、そこで確認できます。
- ダウンロード先が URL の場合、DescribeDownloadBackupSetStorageInfo API を呼び出してダウンロードリンクを取得できます。
  説明
  - ダウンロードリンクは、タスク完了後 3 日以内 に取得できます。リンクの有効期間は 5 分から 1 日まで設定できます。デフォルトの有効期間は 2 時間です。
  - 完了したタスクは 3 日後に期限切れとなり、その時点でダウンロードリンクも期限切れになります。期限切れのタスクのデータは、期限切れ後に自動的に削除されます。データがまだ必要な場合は、新しいダウンロードタスクを開始して新しいダウンロードリンクを取得する必要があります。
  - ダウンロードリンクを保存し、データ漏洩を防ぐために機密を保持してください。
  - サードパーティのダウンロードツールを使用すると、追加のダウンロードトラフィックが発生し、追加料金が発生する可能性があります。これらのツールは慎重に使用してください。推奨されるダウンロード方法については、ダウンロードコマンドをご参照ください。

よくある質問

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

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

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

ダウンロードしたバックアップファイルをセルフマネージド MySQL データベースにリストアできます。

ダウンロードしたバックアップファイルをローカル 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 クラスターに直接リストアすることはできません。まずバックアップファイルをセルフマネージド MySQL データベースにリストアしてから、Data Transmission Service (DTS) を使用してセルフマネージド MySQL データベースから PolarDB for MySQL へデータを移行する必要があります。

付録

RAM ユーザー権限

この機能は RAM を使用して権限を管理します。これらの権限を設定して、どの RAM ユーザーがダウンロードリンクを取得できるかを制御できます。

RAM ユーザーにダウンロード権限を付与

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

RAM ユーザーによるダウンロードリンク取得のブロック

RAM ユーザーがバックアップと復元機能を使用する権限は必要だが、バックアップファイルのダウンロードリンクを取得できないようにする必要がある場合、ダウンロードリンクを取得する API を呼び出す権限を拒否するカスタムポリシーを作成できます。以下はポリシーのサンプルスクリプトです。

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

カスタムポリシーを作成した後、そのポリシーを RAM ユーザーにアタッチします。これにより、RAM ユーザーによるダウンロードリンクの取得がブロックされます。

読み取り専用ユーザーにバックアップのダウンロードを許可

セキュリティ上の理由から、**PolarDB の読み取り専用権限 (AliyunPolardbReadOnlyAccess) のみを持つ RAM ユーザーは、バックアップファイルをダウンロードできません。

この場合、RAM ユーザーがバックアップファイルをダウンロードする権限が必要な場合は、**データディザスタリカバリの読み取り専用権限 (AliyunDBSReadOnlyAccess) を付与できます。この権限が付与されると、RAM ユーザーは完了したバックアップタスクのダウンロードリンクを表示できます。権限の付与方法の詳細については、RAM ユーザー権限の管理をご参照ください。

ダウンロードコマンド

説明

ダウンロード速度が 64 KB/s を下回ると、ダウンロードが中断される可能性があります。ダウンロード中は安定したネットワーク接続を確保してください。
ossfs でマウントされたディスクにバックアップファイルをダウンロードする場合、ossfs の [multipart_size] パラメーターを調整する必要がある場合があります。デフォルトでは、このパラメーターは最大 100 GB のサイズのファイルをサポートします。バックアップファイルが 100 GB を超える場合、ダウンロードは失敗します。ossfs とそのパラメーターの詳細については、「ossfs」および「マウントオプション」をご参照ください。
wget および curl コマンドを使用してバックアップファイルをダウンロードすることを推奨します。他のサードパーティツールを使用すると、重複ダウンロードが発生する可能性があります。つまり、ダウンロードされるデータ量がバックアップファイルサイズよりも大きくなります。ダウンロードはパブリックネットワークトラフィックを使用するため、超過データ転送に対しても課金されます。

wget

nohup wget -c -t 0 "backup_file_download_URL" -O /path/to/destination_filename > /path/to/download.log &

パラメータ

パラメータ	説明
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_filename > /path/to/download.log &