PolarDB支援將叢集備份組對應的備份檔案下載到您的本地，用於長期儲存備份、查詢備份中的歷史資料、進行備份轉存（如OSS）以及審計等業務情境的需求。
下載的備份資料無法直接用於恢複到PolarDB MySQL版叢集，您可以將下載的備份檔案恢複至自建MySQL資料庫。
發布時間
2023年11月24日
當前備份檔案下載功能灰階發布中，將陸續開放。
費用說明
備份檔案下載功能支援使用URL下載（暫存在DBS內建儲存中）或轉存至您的OSS。不同下載目標的收費方式存在差異，具體如下：
若下載任務失敗，則不會產生任何費用。
您可以進入PolarDB控制台，在叢集的中，查看當月備份計算資料量和當月外網流出流量。
儲存費用
URL：暫存在DBS內建儲存中，不收取儲存費用。
OSS：轉存至您的OSS中。具體儲存費用，請參見Object Storage Service的儲存費用。
備份組轉換費用
無論下載目標是URL還是OSS，在將備份組轉換為SQL、CSV、Parquet或CSV-with-header格式時，都會收取相應的轉換費用，且無免費額度。具體計費標準為0.03125美元/GB。
流量費用
URL：
內網下載：免費。
外網下載：免費額度為500 GB/月/叢集，超出免費額度的部分將隨用隨付，根據下載資料量每天計費一次。具體費用單價，請參見網路費用。
說明建議您購買訂用帳戶的網路包，可以抵扣帳號下外網下載備份產生的網路流量費用，網路包容量越大折扣越高。
OSS：轉存至您的OSS中。具體流量費用，請參見Object Storage Service的流量費用。
前提條件
叢集：僅企業版叢集中的叢集版系列支援備份檔案下載功能。
地區：西南1（成都）、華南3（廣州）、華北1（青島）、華北2（北京）、華東2（上海）、華北3（張家口）、華東1（杭州）、華南1（深圳）、中國香港、馬來西亞（吉隆坡）、印尼（雅加達）、日本（東京）、新加坡、美國（矽谷）、美國（維吉尼亞）、德國（法蘭克福）。
說明其餘地區將陸續上線。
其他：
RAM帳號需要具備下載備份檔案的許可權。如需為RAM帳號授權，請參見RAM帳號許可權說明。
備份資料未加密，加密的PolarDB叢集不支援下載備份檔案。
對於同一個叢集或執行個體，同一時間只能存在一個正在運行中或失敗的任務。
使用限制
僅支援匯出大部分的表結構，部分結構資訊暫不支援匯出：
支援匯出：列資訊、主鍵索引、非主鍵索引、唯一索引、分區表資訊、表引擎、表層級或庫層級的字元集與字元定序。
不支援匯出：運算式索引、外鍵、產生列、隱藏列、視圖、函數、預存程序、系統變數、觸發器。
不支援空間資料類型的欄位。當資料包含了以下類型的欄位時，轉換任務會失敗：
GEOMETRY、POINT、LINESTRING、POLYGON、MULTIPOINT、MULTILINESTRING、MULTIPOLYGON、GEOMETRYCOLLECTION
匯出的檔案中不包含如下系統庫：
information_schema、mysql、performance_schema、sys、__recycle_bin__
若選擇下載目標為OSS時，OSS的儲存類型需為標準儲存。如需轉換儲存類型，請參見儲存類型轉換。
說明OSS Bucket需手動建立。如您已建立了用於存放備份檔案的Bucket，請忽略。
若叢集開啟了冷資料歸檔，則不支援進行備份組下載。
下載的庫表名稱中若包含“/”字元，將導致任務失敗。
操作步驟
（推薦）控制台操作
登入PolarDB控制台，在左側導覽列單擊集群列表，選擇叢集所在地區，並單擊目的地組群ID進入叢集詳情頁。
在左側導覽列中，單擊。
在資料備份列表中，單擊目標備份組右側操作列的叢集備份下載。
說明預設展示近8天內的備份資料，如需查看8天前的備份，請修改時間範圍。
如控制台頁面沒有叢集備份下載按鈕，請確認您的叢集產品版本或所在地區是否滿足前提條件。
在下載時間點與備份組流程下方，選擇按時間點下載或按備份組下載，並單擊頁面左下角的下一步。
在下載執行個體與庫表流程下方，單擊頁面左下角的下一步。此處固定為執行個體下載。
在下載目標與格式流程下方，選擇下載目標與格式，並完成配置。
重要推薦您選擇下載目標為OSS，該方式更節省時間。
備份下載任務一旦開始，不可取消。
備份下載任務將產生相應的費用。具體詳情，請參見費用說明。
（推薦）OSS
下載目標為OSS是將資料直接寫入您的OSS中。使用完成後，您可按需自行刪除。
填寫您OSS的Bucket Name以及目錄首碼（如xx/xx）。
選擇下載格式，當前支援設定下載格式為CSV、SQL、Parquet、CSV-with-header。您可根據實際業務需求進行選擇。
閱讀並勾選相關須知內容，單擊完成。頁面自動跳轉至備份下載列表頁簽，等待任務下載完成。
說明備份檔案下載功能需要授權DBS服務擷取您的雲資源，如果您在此之前未授權過存取權限，可按照控制台介面提示單擊。授權成功後，您可返回之前已編輯的進階下載配置介面，按如上操作填寫資訊即可。
由於計算轉換需要在服務側競爭計算資源，可能會出現臨時資源分派失敗而導致下載失敗。此外，某些不支援的特殊資料格式也可能導致下載失敗。當任務失敗時，建議您先嘗試重試下載任務或聯絡DBS技術支援人員。
對於失敗的任務，不會產生任何費用。
查看備份檔案：若下載任務的狀態為成功，則表示已下載成功，您可以前往對應的OSS Bucket中查看。
URL
下載目標為URL時，系統會將轉換的資料暫存在DBS內建儲存中，此過程不會收取儲存費用。
說明使用URL下載涉及到資料打包，需要額外的等待時間長度，具體與備份組的備份邏輯大小有關。若備份邏輯大小較大（如超過1 TB），建議您選擇下載到OSS。
選擇下載格式，當前支援設定下載格式為CSV、SQL、Parquet、CSV-with-header。您可根據實際業務需求進行選擇。
閱讀並勾選相關須知內容，單擊完成。頁面自動跳轉至備份下載列表頁簽，等待任務下載完成。
說明備份檔案下載功能需要授權DBS服務擷取您的雲資源，如果您在此之前未授權過存取權限，可按照控制台介面提示單擊。授權成功後，您可返回之前已編輯的進階下載配置介面，按如上操作填寫資訊即可。
由於計算轉換需要在服務側競爭計算資源，可能會出現臨時資源分派失敗而導致下載失敗。此外，某些不支援的特殊資料格式也可能導致下載失敗。當任務失敗時，建議您先嘗試重試下載任務或聯絡DBS技術支援人員。
對於失敗的任務，不會產生任何費用。
查看備份檔案：若下載任務的狀態為成功，則表示已下載成功，您可以單擊下載目標列的產生連結，設定連結有效期間並單擊產生連結，即可通過產生的內網或外網連結下載備份資料。
說明您可在下載任務完成後三天內擷取下載連結，連結有效期間範圍可設定為5分鐘~1天，預設有效期間為2小時。
完成的任務三天后將到期（下載連結將到期），任務到期後其對應資料會被清理（清理在任務到期後一段時間自動執行）。因此，如有業務需求，請重新發起下載任務擷取新的下載連結。
請您及時儲存下載連結，避免泄露。
使用一些第三方下載軟體下載備份檔案時可能會產生額外下載流量，從而導致額外計費，建議您謹慎使用。具體下載方法，請參見下載命令。
API操作
DescribeDownloadSupport：查詢您的叢集是否支援備份檔案下載功能。
說明若API返回不支援，請確認您的叢集產品版本或所在地區是否滿足前提條件。
CreateDownload：建立備份檔案下載任務。
（可選）DescribeDownloadTask：查看當前叢集的備份檔案下載任務資訊，包括下載任務的狀態。
擷取備份檔案：
下載目標類型為OSS時，系統會將資料直接寫入您的OSS中，您可以在相應的Bucket中查看。
下載目標類型為URL時，您可以使用DescribeDownloadBackupSetStorageInfo來擷取下載連結。
說明您可在下載任務完成後三天內擷取下載連結，連結有效期間範圍可設定為5分鐘~1天，預設有效期間為2小時。
完成的任務三天后將到期（下載連結將到期），任務到期後其對應資料會被清理（清理在任務到期後一段時間自動執行）。因此，如有業務需求，請重新發起下載任務擷取新的下載連結。
請您及時儲存下載連結，避免泄露。
使用一些第三方下載軟體下載備份檔案時可能會產生額外下載流量，從而導致額外計費，建議您謹慎使用。具體下載方法，請參見下載命令。
常見問題
附錄
RAM帳號許可權說明
備份檔案下載功能的鑒權能力依賴於RAM的許可權管理，您可以通過RAM為您的帳號配置擷取下載連結串的許可權。
授予RAM帳號下載備份檔案的許可權
如果您無法正常使用下載備份功能（例如建立、查詢下載任務），請檢查您的RAM帳號是否已添加管理資料災備的許可權（AliyunDBSFullAccess）。如何授權，請參見管理RAM使用者的許可權。
禁止RAM帳號擷取備份檔案的下載連結
如果您的RAM帳號需要擁有備份恢複的使用許可權，但需要禁止該RAM帳號擷取備份檔案的下載連結，您可以建立自訂權限原則禁止RAM帳號調用擷取下載連結的介面，參考指令碼如下：
{
"Version": "1",
"Statement": [
{
"Effect": "Deny",
"Action": "dbs:DescribeDownloadBackupSetStorageInfo",
"Resource": "*"
}
]
}自訂權限原則建立完成後，請將該自訂權限原則授權到您的RAM帳號中。此時，您的RAM帳號就會被禁止擷取下載連結。
允許唯讀RAM帳號下載備份檔案
基於安全形度考慮，若RAM帳號對PolarDB資源的許可權為唯讀訪問資料庫POLARDB的許可權（AliyunPolardbReadOnlyAccess），則該唯讀RAM帳號無法下載備份檔案。
在這種情況下，如果該RAM帳號需要具有下載備份檔案的許可權，可以為該RAM帳號授予唯讀訪問資料災備的許可權（AliyunDBSReadOnlyAccess）。授權後，該RAM帳號就可以查看已建立的備份下載任務對應的下載連結了。如何授權，請參見管理RAM使用者的許可權。
