PolarDB では、クラスターのバックアップセットからローカルマシンにバックアップファイルをダウンロードできます。これらのファイルは、長期保存、履歴データクエリ、Object Storage Service (OSS) などの他の場所へのバックアップ転送、または監査に使用できます。
ダウンロードしたバックアップデータは、PolarDB for MySQL クラスターに直接復元することはできません。代わりに、ダウンロードしたバックアップファイルを自己管理型 MySQL データベースに復元できます。
リリース日
2023 年 11 月 24 日
バックアップファイルのダウンロード機能は現在、段階的にリリースされています。
課金
バックアップファイルは、URL を使用してダウンロード (DBS ストレージに一時的に保存) するか、ご利用の Object Storage Service (OSS) に転送することでダウンロードできます。課金方法は宛先によって異なります。
ダウンロードタスクが失敗した場合、料金は発生しません。
PolarDB コンソールに移動します。クラスターの詳細ページで、 を選択して、[今月のバックアップコンピューティングデータ量] と [今月のインターネット経由のアウトバウンドトラフィック] を表示します。
ストレージ料金
URL：ファイルは DBS ストレージに一時的に保存されます。ストレージ料金は発生しません。
OSS：ファイルはご利用の OSS バケットに転送されます。詳細については、「Object Storage Service (OSS) のストレージ料金」をご参照ください。
バックアップセット変換料金
ダウンロード先が URL か OSS かに関わらず、バックアップセットを SQL、CSV、Parquet、またはヘッダー付き CSV 形式に変換する際に変換料金が発生します。このサービスには無料クォータはありません。課金基準は 1 GB あたり 0.03125 米ドルです。
トラフィック料金
URL：
内部ネットワーク経由のダウンロードは無料です。
インターネット経由のダウンロード：クラスターごとに月間 500 GB の無料クォータが提供されます。このクォータを超える使用量は従量課金制で請求されます。料金はダウンロードされたデータ量に基づいて日次で請求されます。単価の詳細については、「ネットワーク料金」をご参照ください。
説明サブスクリプションネットワークプランを購入して、インターネット経由でのバックアップダウンロードにかかるネットワークトラフィック料金を相殺できます。より大きなネットワークプランほど割引率が高くなります。
OSS：ファイルはご利用の OSS バケットに転送されます。トラフィック料金の詳細については、「Object Storage Service (OSS) のトラフィック料金」をご参照ください。
前提条件
クラスター：バックアップファイルのダウンロード機能は、クラスター版 シリーズの Enterprise Edition クラスターでのみサポートされています。
リージョン：中国 (成都)、中国 (広州)、中国 (青島)、中国 (北京)、中国 (上海)、中国 (張家口)、中国 (杭州)、中国 (深セン)、中国 (香港)、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、日本 (東京)、シンガポール、米国 (シリコンバレー)、米国 (バージニア)、ドイツ (フランクフルト)。
説明他のリージョンも近日中にサポートされる予定です。
その他：
Resource Access Management (RAM) ユーザーは、バックアップファイルをダウンロードする権限を持っている必要があります。RAM ユーザーに権限を付与する方法については、「RAM ユーザー権限」をご参照ください。
バックアップデータは暗号化されていないため、暗号化された PolarDB クラスターからバックアップファイルをダウンロードすることはできません。
制限事項
すべてのテーブル構造をエクスポートできるわけではありません：
エクスポート可能な情報：列情報、主キーインデックス、非主キーインデックス、一意なインデックス、パーティションテーブル情報、テーブルエンジン、テーブルレベルまたはデータベースレベルの文字セットと照合順序。
エクスポートできない情報：式インデックス、外部キー、生成列、隠し列、ビュー、関数、ストアドプロシージャ、システム変数、トリガー。
空間データ型のフィールドはサポートされていません。データに以下の型のフィールドが含まれている場合、変換タスクは失敗します：
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 です。ビジネスニーズに基づいてフォーマットを選択してください。
関連する注意事項を読み、チェックボックスを選択してから、[完了] をクリックします。ページは自動的に [バックアップダウンロードリスト] タブに移動します。ダウンロードタスクが完了するのを待ちます。
説明バックアップファイルのダウンロード機能では、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 ユーザー権限
バックアップファイルのダウンロード機能は、認証に RAM 権限管理を使用します。RAM を使用して、ダウンロードリンク文字列を取得するために必要な権限をアカウントに付与できます。
RAM ユーザーにバックアップファイルのダウンロード権限を付与する
ダウンロードタスクの作成やクエリなど、バックアップダウンロード機能を使用できない場合は、RAM ユーザーにデータディザスタリカバリ (AliyunDBSFullAccess) を管理する権限が付与されているか確認してください。詳細については、「RAM ユーザーに権限を付与する」をご参照ください。
RAM ユーザーにバックアップファイルのダウンロードリンク取得権限を拒否する
RAM ユーザーがバックアップと復元機能を使用する権限は必要だが、ダウンロードリンクを取得する権限は拒否する必要がある場合は、カスタム権限ポリシーを作成できます。このポリシーは、RAM ユーザーがダウンロードリンクを取得するための API 操作を呼び出す権限を拒否します。以下はサンプルスクリプトです：
{
"Version": "1",
"Statement": [
{
"Effect": "Deny",
"Action": "dbs:DescribeDownloadBackupSetStorageInfo",
"Resource": "*"
}
]
}カスタム権限ポリシーを作成した後、それを RAM ユーザーに付与します。これにより、RAM ユーザーはダウンロードリンクを取得する権限を拒否されます。
読み取り専用 RAM ユーザーにバックアップファイルのダウンロードを許可する
セキュリティ上の理由から、PolarDB リソースに対する読み取り専用権限 (AliyunPolardbReadOnlyAccess) のみを持つ RAM ユーザーは、バックアップファイルをダウンロードできません。
読み取り専用 RAM ユーザーがバックアップファイルをダウンロードする権限を必要とする場合は、ユーザーにデータディザスタリカバリの読み取り専用権限 (AliyunDBSReadOnlyAccess) を付与できます。この権限が付与されると、RAM ユーザーは作成されたバックアップダウンロードタスクのダウンロードリンクを表示できます。詳細については、「RAM ユーザーに権限を付与する」をご参照ください。
