PolarDB では、クラスターバックアップセットからローカルシステムにバックアップファイルをダウンロードできます。これらのファイルは、長期保存、履歴データクエリ、Object Storage Service (OSS) などの他のサービスへのバックアップ転送、および監査に使用できます。
PolarDB for MySQL クラスターに、ダウンロードしたバックアップデータを直接復元することはできません。ダウンロードしたバックアップファイルは、自己管理型 MySQL データベースに復元できます。
リリース日
2023 年 11 月 24 日
バックアップファイルのダウンロード機能は段階的にリリースされており、順次展開されます。
課金
バックアップファイルのダウンロード機能では、URL を使用するか、Object Storage Service (OSS) に転送することでファイルをダウンロードできます。URL を使用してダウンロードされたファイルは、一時的に DBS ストレージに保存されます。課金方法は、次のセクションで説明するように、ダウンロード先によって異なります。
ダウンロードタスクが失敗した場合、料金は発生しません。
PolarDB コンソールに移動します。 で、クラスターの [月次バックアップコンピューティングデータ量] と [月次アウトバウンドインターネットトラフィック] を表示できます。
ストレージ料金
URL：ファイルは一時的に DBS ストレージに保存されます。ストレージ料金は発生しません。
OSS：ファイルはご利用の OSS に転送されます。ストレージ料金の詳細については、「Object Storage Service のストレージ料金」をご参照ください。
バックアップセット変換料金
ダウンロード先が URL または OSS のいずれであっても、バックアップセットを SQL、CSV、Parquet、またはヘッダー付き CSV 形式に変換するための変換料金が発生します。フォーマット変換に利用できる無料クォータはありません。料金レートは 1 GB あたり 0.03125 米ドルです。
トラフィック料金
URL：
内部ネットワークダウンロード：無料です。
インターネットダウンロード：クラスターごとに月間 500 GB の無料クォータが提供されます。無料クォータを超えるトラフィックは従量課金制で課金されます。料金はダウンロードされたデータ量に基づいて毎日計算されます。料金の詳細については、「ネットワーク料金」をご参照ください。
説明サブスクリプションのネットワークプランを購入して、インターネット経由でバックアップをダウンロードする際のネットワークトラフィック料金を相殺できます。容量の大きいネットワークプランほど、割引率が高くなります。
OSS：ファイルはご利用の OSS に転送されます。トラフィック料金の詳細については、「Object Storage Service のトラフィック料金」をご参照ください。
前提条件
クラスター：[クラスター] シリーズの Enterprise Edition クラスターのみがバックアップファイルのダウンロード機能をサポートします。
リージョン：中国 (成都)、中国 (広州)、中国 (青島)、中国 (北京)、中国 (上海)、中国 (張家口)、中国 (杭州)、中国 (深セン)、中国 (香港)、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、日本 (東京)、シンガポール、米国 (シリコンバレー)、米国 (バージニア)、ドイツ (フランクフルト)。
説明この機能は、他のリージョンでもまもなく利用可能になります。
その他：
RAM ユーザーには、バックアップファイルをダウンロードする権限が必要です。RAM ユーザーに権限を付与する方法の詳細については、「RAM ユーザー権限」をご参照ください。
バックアップデータは暗号化されていません。暗号化された PolarDB クラスターからバックアップファイルをダウンロードすることはできません。
1 つのクラスターまたはインスタンスで同時に実行できるダウンロードタスクは 1 つだけです。前のタスクが実行中または失敗した場合、新しいタスクを開始することはできません。
制限事項
ほとんどのテーブル構造をエクスポートできます。ただし、一部の構造情報はエクスポートできません。
エクスポートがサポートされているもの：列情報、主キーインデックス、非主キーインデックス、一意なインデックス、パーティションテーブル情報、テーブルエンジン、およびテーブルレベルまたはデータベースレベルの文字セットと照合順序。
エクスポートがサポートされていないもの：式インデックス、外部キー、生成列、非表示列、ビュー、関数、ストアドプロシージャ、システム変数、およびトリガー。
空間データ型のフィールドはサポートされていません。データに次の型のフィールドが含まれている場合、変換タスクは失敗します。
GEOMETRY、POINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTION
エクスポートされたファイルには、次のシステムデータベースは含まれません。
information_schema、mysql、performance_schema、sys、__recycle_bin__
ダウンロード先として OSS を選択した場合、OSS バケットは [標準] ストレージクラスを使用する必要があります。ストレージクラスを変換するには、「ストレージクラスの変換」をご参照ください。
説明OSS バケットを手動で作成する必要があります。バックアップファイルを保存するためにすでにバケットを作成している場合は、このステップを無視してください。
バックアップファイルのダウンロード機能は、レベル 1 バックアップデータのみのダウンロードをサポートします。レベル 2 バックアップデータのダウンロードはサポートしていません。
クラスターでコールドデータアーカイブが有効になっている場合、バックアップセットをダウンロードすることはできません。
ダウンロードするデータベースまたはテーブルの名前にスラッシュ (/) が含まれている場合、タスクは失敗します。
操作手順
(推奨) コンソールの使用
PolarDB コンソールにログインします。左側のナビゲーションウィンドウで、クラスター をクリックします。クラスターが配置されているリージョンを選択し、対象のクラスターの ID をクリックします。
左側のナビゲーションウィンドウで、 をクリックします。
[データバックアップリスト] タブで、対象のバックアップセットを見つけ、[操作] 列の [クラスターバックアップのダウンロード] をクリックします。
説明デフォルトでは、コンソールには過去 8 日間のバックアップデータが表示されます。8 日より古いバックアップを表示するには、時間範囲を変更してください。
[クラスターバックアップのダウンロード] ボタンが表示されない場合は、ご利用のクラスターのエディションまたはリージョンが前提条件を満たしているか確認してください。
[ポイントインタイムとバックアップセットのダウンロード] ステップで、[ポイントインタイムでダウンロード] または [バックアップセットでダウンロード] を選択し、ページ左下の [次へ] をクリックします。
[インスタンスとデータベース/テーブルのダウンロード] ステップで、ページ左下の [次へ] をクリックします。デフォルトでは [インスタンスのダウンロード] が選択されています。
[ダウンロード先とフォーマット] ステップで、ダウンロード先とフォーマットを選択し、設定を完了します。
重要ダウンロード先として OSS を選択することを推奨します。より高速だからです。
バックアップダウンロードタスクは、開始後にキャンセルすることはできません。
バックアップダウンロードタスクには料金が発生します。詳細については、「課金」をご参照ください。
(推奨) OSS
ダウンロード先として OSS を選択した場合、データは直接ご利用の OSS バケットに書き込まれます。使用後に必要に応じてデータを削除できます。
OSS バケット名と、xx/xx などのディレクトリプレフィックスを入力します。
説明OSS バケットを手動で作成する必要があります。バックアップファイルを保存するためにすでにバケットを作成している場合は、その名前を直接入力できます。
OSS バケットのストレージクラスは [標準] である必要があります。ストレージクラスの変換方法の詳細については、「ストレージクラスの変換」をご参照ください。
ダウンロードフォーマットを選択します。ダウンロードフォーマットは、CSV、SQL、Parquet、またはヘッダー付き CSV に設定できます。
規約を読み、チェックボックスを選択して同意します。[完了] をクリックします。ページは自動的に [バックアップダウンロードリスト] タブにリダイレクトされます。ダウンロードタスクが完了するまで待ちます。
説明バックアップファイルのダウンロード機能では、Database Backup Service (DBS) にクラウドリソースへのアクセス権限を付与する必要があります。権限を付与していない場合は、コンソールのプロンプトに従って をクリックしてください。権限付与が成功したら、高度なダウンロード設定ページに戻り、設定を完了します。
変換プロセスは、サーバー側のコンピューティングリソースを競合します。一時的なリソース割り当ての失敗により、ダウンロードが失敗することがあります。サポートされていないデータ形式が原因でダウンロードが失敗することもあります。タスクが失敗した場合は、ダウンロードタスクを再試行するか、DBS ヘルプデスクにお問い合わせください。
失敗したタスクに対して料金は発生しません。
バックアップファイルを表示します。タスクのステータスが [成功] の場合、ダウンロードは完了です。対応する OSS バケットに移動してファイルを表示できます。
URL
ダウンロード先として URL を選択した場合、システムは変換されたデータを一時的に DBS ストレージに保存します。このプロセスではストレージ料金は発生しません。
説明URL によるダウンロードには、データのパッケージングが含まれ、余分な待機時間が必要です。必要な時間は、バックアップセットの論理サイズによって異なります。論理バックアップサイズが大きい場合 (1 TB 超など)、バックアップを OSS にダウンロードすることを推奨します。
ダウンロードフォーマットを選択します。ダウンロードフォーマットは、CSV、SQL、Parquet、またはヘッダー付き CSV に設定できます。
規約を読み、チェックボックスを選択して同意します。[完了] をクリックします。ページは自動的に [バックアップダウンロードリスト] タブにリダイレクトされます。ダウンロードタスクが完了するまで待ちます。
説明バックアップファイルのダウンロード機能では、DBS にクラウドリソースへのアクセス権限を付与する必要があります。権限を付与していない場合は、コンソールのプロンプトに従って をクリックしてください。権限付与が成功したら、高度なダウンロード設定ページに戻り、設定を完了します。
変換プロセスは、サーバー側のコンピューティングリソースを競合します。一時的なリソース割り当ての失敗により、ダウンロードが失敗することがあります。サポートされていないデータ形式が原因でダウンロードが失敗することもあります。タスクが失敗した場合は、ダウンロードタスクを再試行するか、DBS ヘルプデスクにお問い合わせください。
失敗したタスクに対して料金は発生しません。
バックアップファイルを表示します。タスクのステータスが [成功] の場合、ダウンロードは完了です。[ダウンロード先] 列の [リンクの生成] をクリックします。リンクの [有効期間] を設定し、[リンクの生成] をクリックします。その後、生成された内部またはパブリックネットワークリンクを使用してバックアップデータをダウンロードできます。
説明ダウンロードリンクは、タスク完了後 3 日以内に取得できます。リンクの有効期間は 5 分から 1 日です。デフォルトの有効期間は 2 時間です。
完了したタスクは 3 日後に有効期限が切れ、ダウンロードリンクも有効期限が切れます。タスクの有効期限が切れると、そのデータは自動的に削除されます。データが必要な場合は、新しいダウンロードタスクを開始して新しいリンクを取得してください。
ダウンロードリンクは、漏洩を防ぐためにすぐに保存してください。
サードパーティ製のソフトウェアを使用してバックアップファイルをダウンロードすると、余分なネットワークトラフィックが発生し、追加料金が発生する可能性があります。このようなソフトウェアは注意して使用してください。具体的なダウンロード方法の詳細については、「ダウンロードコマンド」をご参照ください。
API 操作
DescribeDownloadSupport：ご利用のクラスターがバックアップファイルのダウンロード機能をサポートしているかどうかをクエリします。
説明API の応答が、この機能がサポートされていないことを示している場合は、ご利用のクラスターのエディションまたはリージョンが前提条件を満たしているか確認してください。
CreateDownload：バックアップファイルのダウンロードタスクを作成します。
説明バックアップファイルのダウンロード機能では、DBS にクラウドリソースへのアクセス権限 (
AliyunDBSDefaultRole権限) を付与する必要があります。権限を付与していない場合は、まずコンソールで権限を付与できます。TargetType (ダウンロード先タイプ) を OSS に設定する場合、まず対応するバケットを手動で作成する必要があります。OSS バケットのストレージクラスは [標準] である必要があります。
TargetType (ダウンロード先タイプ) を URL に設定する場合、返された
TaskId(タスク ID) パラメーターを保持して、ダウンロードリンクを取得します。バックアップダウンロードタスクは、開始後にキャンセルすることはできません。
バックアップダウンロードタスクには料金が発生します。詳細については、「課金」をご参照ください。
(オプション) DescribeDownloadTask：タスクステータスを含む、現在のクラスターのバックアップファイルダウンロードタスクに関する情報を表示します。
バックアップファイルを取得します。
ダウンロード先タイプが OSS の場合、システムはデータを直接ご利用の OSS に書き込みます。対応するバケットでデータを表示できます。
ダウンロード先タイプが URL の場合、DescribeDownloadBackupSetStorageInfo を使用してダウンロードリンクを取得できます。
説明ダウンロードリンクは、タスク完了後 3 日以内に取得できます。リンクの有効期間は 5 分から 1 日です。デフォルトの有効期間は 2 時間です。
完了したタスクは 3 日後に有効期限が切れ、ダウンロードリンクも有効期限が切れます。タスクの有効期限が切れると、そのデータは自動的に削除されます。データが必要な場合は、新しいダウンロードタスクを開始して新しいリンクを取得してください。
ダウンロードリンクは、漏洩を防ぐためにすぐに保存してください。
サードパーティ製のソフトウェアを使用してバックアップファイルをダウンロードすると、余分なネットワークトラフィックが発生し、追加料金が発生する可能性があります。このようなソフトウェアは注意して使用してください。具体的なダウンロード方法の詳細については、「ダウンロードコマンド」をご参照ください。
よくある質問
付録
RAM ユーザー権限
バックアップファイルのダウンロード機能の認証は、Resource Access Management (RAM) の権限管理に依存します。RAM を使用して、アカウントがダウンロードリンク文字列を取得するための権限を設定できます。
RAM ユーザーにバックアップファイルをダウンロードする権限を付与する
ダウンロードタスクの作成やクエリなど、バックアップダウンロード機能を使用できない場合は、RAM ユーザーにデータディザスタリカバリ (AliyunDBSFullAccess) を管理する権限が付与されているか確認してください。権限の付与方法の詳細については、「RAM ユーザー権限の管理」をご参照ください。
RAM ユーザーにバックアップファイルダウンロードリンクを取得する権限を拒否する
RAM ユーザーがバックアップと復元機能を使用する権限を必要とするが、バックアップファイルダウンロードリンクを取得する権限を拒否する必要がある場合は、カスタム権限ポリシーを作成して、RAM ユーザーがダウンロードリンクを取得する API 操作を呼び出す権限を拒否できます。次のサンプルスクリプトはリファレンスを提供します。
{
"Version": "1",
"Statement": [
{
"Effect": "Deny",
"Action": "dbs:DescribeDownloadBackupSetStorageInfo",
"Resource": "*"
}
]
}カスタムポリシーを作成した後、ポリシーを RAM ユーザーに付与します。その後、RAM ユーザーはダウンロードリンクを取得する権限を拒否されます。
読み取り専用の RAM ユーザーにバックアップファイルのダウンロードを許可する
セキュリティ上の理由から、RAM ユーザーが PolarDB リソースに対する読み取り専用権限 (AliyunPolardbReadOnlyAccess) しか持たない場合、RAM ユーザーはバックアップファイルをダウンロードできません。
この場合、RAM ユーザーがバックアップファイルをダウンロードする権限を必要とする場合は、ユーザーにデータディザスタリカバリに対する読み取り専用権限 (AliyunDBSReadOnlyAccess) を付与できます。権限付与後、RAM ユーザーは作成されたバックアップダウンロードタスクのダウンロードリンクを表示できます。権限の付与方法の詳細については、「RAM ユーザー権限の管理」をご参照ください。
