ApsaraDB RDS：全量備份資料上雲

2012及以上版本、2008 R2雲端硬碟

1. 執行如下命令，確認原資料庫當前的復原模式。

   SELECT
       name AS DatabaseName,
       recovery_model_desc AS RecoveryModel,
       state_desc AS State
   FROM sys.databases
   ORDER BY name;

   建議您在生產備份以上雲到RDS雲資料庫之前，將資料庫的復原模式改成FULL：

   ALTER DATABASE [db_simple] SET RECOVERY FULL WITH NO_WAIT;

2. 下載備份指令碼，用SSMS（SQL Server Management Studio）開啟備份指令碼。

3. 修改指令碼中SELECT語句中的如下參數，位於指令碼中YOU HAVE TO INIT PUBLIC VARIABLES HERE下。

   配置項	說明
   @backup_databases_list	需要備份的資料庫，多個資料庫以分號（;）或者半形逗號（,）分隔。
   @backup_type	備份類型。參數值如下： FULL：全量備份。 DIFF：差異備份。 LOG：記錄備份。
   @backup_folder	備份檔案所在的本地目錄。如不存在，會自動建立。
   @is_run	是否執行備份。參數值如下： 1：執行備份。 0：只做檢查，不執行備份。

4. 執行備份指令碼。

2008 R2高效能本地碟

1. 開啟Microsoft SQL Server Management Studio（SSMS）用戶端。

2. 登入待遷移的資料庫。

3. 執行如下命令，確認來源資料庫當前的復原模式。

   USE master;
   GO
   SELECT name, CASE recovery_model
   WHEN 1 THEN 'FULL'
   WHEN 2 THEN 'BULK_LOGGED'
   WHEN 3 THEN 'SIMPLE' END model FROM sys.databases
   WHERE name NOT IN ('master','tempdb','model','msdb');
   GO

   • 如果返回結果中的model值不為FULL，請執行步驟4。

   • 如果返回結果中的model值為FULL，請執行步驟5。

4. 執行如下命令，將來源資料庫的復原模式設定為FULL。

   ALTER DATABASE [dbname] SET RECOVERY FULL;
   GO
   ALTER DATABASE [dbname] SET AUTO_CLOSE OFF;
   GO

   重要

   復原模式設定為FULL後，會使SQL Server的日誌資訊增多，請確保具備足夠的硬碟空間。

5. 執行如下命令，備份來源資料庫。

   本案例中，將dbtestDatabase Backup至backup.bak檔案為例示範。

   USE master;
   GO
   BACKUP DATABASE [dbtest] to disk ='d:\backup\backup.bak' WITH COMPRESSION,INIT;
   GO

6. 執行如下命令，校正備份檔案的完整性。

   USE master
    GO
    RESTORE FILELISTONLY 
      FROM DISK = N'D:\backup\backup.bak';

   重要

   • 如果有結果集返回，代表備份檔案有效。

   • 如果提示錯誤，請重新執行備份操作。

7. 可選：執行如下命令，還原資料庫的復原模式。

   重要

   如果資料庫的復原模式原本就是FULL，無需執行本步驟。

   ALTER DATABASE [dbname] SET RECOVERY SIMPLE;
   GO

2012及以上版本、2008 R2雲端硬碟

1. 將備份檔案上傳至OSS前，您需先在OSS中建立儲存空間Bucket。

   • 若OSS中已存在Bucket，請確保該Bucket滿足以下要求：

     • Bucket儲存類型儲存類型為標準儲存。不能是低頻訪問儲存、Archive Storage、冷Archive Storage、深度冷Archive Storage。

     • Bucket未開啟服務端加密。

   • 若OSS中沒有Bucket，需要先行建立。（請確保已開通OSS服務）

     1. 登入OSS管理主控台，單擊Bucket列表，然後單擊建立Bucket。

     2. 配置如下關鍵參數，其他參數可以保持預設。

        重要

        • 建立的儲存空間主要用於本次資料上雲，只需配置關鍵參數即可，上雲完成後可以及時刪除以避免資料泄露及產生相關費用。

        • 建立Bucket時請勿開啟服務端加密。

        參數	說明	取值樣本
        Bucket 名稱	儲存空間名稱，全域唯一，設定後無法修改。 命名規則： 只能包括小寫字母、數字和短劃線（-）。 必須以小寫字母或者數字開頭和結尾。 長度必須在3~63字元之間。	migratetest
        地區	Bucket所屬的地區，如果您通過ECS內網上傳資料至Bucket中，且通過內網將資料恢複至RDS中，則需要三者地區保持一致。	華東1（杭州）
        儲存類型	選擇標準儲存。本文上雲操作不支援其他儲存類型的Bucket。	標準儲存

2. 上傳備份檔案到OSS。

   本機資料庫備份完成後，請將備份檔案上傳到與您的RDS執行個體同地區的OSS Bucket中，兩者處於同一地區時可通過內網互連（不會產生外網流量費用），且資料上傳速度更快。您可以採用如下方法之一：

   使用ossbrowser工具上傳（推薦）

   1. 下載ossbrowser。

   2. 以Windows x64作業系統為例，解壓下載的oss-browser-win32-x64.zip壓縮包，雙擊運行oss-browser.exe應用程式。

   3. 使用AK登入方式，配置參數AccessKeyId和AccessKeySecret，其他參數保持預設，然後單擊登入。

      說明

      AccessKey用於身分識別驗證，確保資料安全，請妥善保管。

      

   4. 單擊目標Bucket，進入儲存空間。

   5. 單擊，選擇需要上傳的備份檔案，然後單擊開啟，即可將本地檔案上傳至OSS中。

   使用OSS控制台上傳

   說明

   如果備份檔案小於5 GB，建議您直接通過OSS控制台上傳備份檔案。

   1. 登入OSS管理主控台。

   2. 單擊Bucket列表，然後單擊目標Bucket名稱。

   3. 在檔案清單中，單擊上傳檔案。

   4. 您可以將備份檔案拖拽至待上傳檔案地區，也可以單擊掃描檔案，選擇需要上傳的備份檔案。

   5. 單擊頁面下方的上傳檔案，即可將本地備份檔案上傳至OSS中。

   使用OSS API分區上傳（以Python 3專案為例）

   說明

   如果備份檔案大於5 GB，建議您調用OSS API採用分區上傳的方式將備份檔案上傳到OSS Bucket中。

   # -*- coding: utf-8 -*-
   """
   Alibaba Cloud OSS Python SDK v2
   依賴：pip install alibabacloud-oss-v2
   """
   
   import os
   import sys
   from pathlib import Path
   import alibabacloud_oss_v2 as oss
   from alibabacloud_oss_v2 import exceptions as oss_ex
   
   
   def get_client_from_env(region: str, endpoint: str | None = None) -> oss.Client:
       """
       從環境變數建立 v2 用戶端。
       - 優先使用 Region（推薦），也支援自訂 Endpoint（可選）。
       - 同時相容 AK 與 STS：
           * AK: 需要 OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET
           * STS: 另需 OSS_SESSION_TOKEN（相容舊變數 OSS_SECURITY_TOKEN）
       """
       # 相容：如果使用者使用了老變數 OSS_SECURITY_TOKEN，則映射到 v2 期望的 OSS_SESSION_TOKEN
       sec_token_legacy = os.getenv("OSS_SECURITY_TOKEN")
       if sec_token_legacy and not os.getenv("OSS_SESSION_TOKEN"):
           os.environ["OSS_SESSION_TOKEN"] = sec_token_legacy
   
       ak = os.getenv("OSS_ACCESS_KEY_ID")
       sk = os.getenv("OSS_ACCESS_KEY_SECRET")
       st = os.getenv("OSS_SESSION_TOKEN")  # STS Token（可選）
   
       if not (ak and sk):
           raise ValueError("未找到有效 AK，請設定環境變數 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET。"
                            "如使用 STS，請同時設定 OSS_SESSION_TOKEN（或舊名 OSS_SECURITY_TOKEN）。")
   
       # 提示所用憑據類型
       if st:
           print("檢測到 STS Token（OSS_SESSION_TOKEN），使用 STS 憑證。")
       else:
           print("未檢測到 STS Token，使用 AccessKey (AK) 憑證。")
   
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
       cfg = oss.config.load_default()
       cfg.credentials_provider = credentials_provider
   
       # 基本網路設定
       cfg.region = region  # 例如：'cn-hangzhou'
       if endpoint:
           # 可選：自訂 Endpoint（如內網、加速、專有域）
           cfg.endpoint = endpoint
   
       # 也可以在此添加其它配置，如：cfg.use_accelerate_endpoint = True
       return oss.Client(cfg)
   
   
   def resumable_upload_file_v2(
       client: oss.Client,
       bucket_name: str,
       object_key: str,
       file_path: str,
       part_size: int = 1 * 1024 * 1024,
       parallel_num: int = 4,
       checkpoint_dir: str | None = None,
   ):
       """
       實現分區並發 + 斷點續傳上傳。
   
       :param client: 已初始化的 oss.Client
       :param bucket_name: 目標 Bucket 名稱
       :param object_key: 目標 Object Key（不包含 Bucket 名）
       :param file_path: 本地檔案完整路徑
       :param part_size: 分區大小（單位：位元組），預設 1MB
       :param parallel_num: 並發上傳線程數，預設 4
       :param checkpoint_dir: 斷點資訊儲存目錄；若為 None，則不啟用斷點續傳
       """
       file_path = str(file_path)
       if not Path(file_path).exists():
           raise FileNotFoundError(f"錯誤: 本地檔案未找到，請檢查 file_path 配置: {file_path}")
   
       # 構造 Uploader；根據是否傳入checkpoint_dir來啟用斷點續傳
       if checkpoint_dir:
           uploader = client.uploader(
               enable_checkpoint=True,
               checkpoint_dir=checkpoint_dir,
               part_size=part_size,
               parallel_num=parallel_num,
           )
       else:
           uploader = client.uploader(
               part_size=part_size,
               parallel_num=parallel_num,
           )
   
       print(f"開始上傳檔案: {file_path}")
       print(f"目標 Bucket: {bucket_name}")
       print(f"目標 Object: {object_key}")
       print(f"分區大小: {part_size} 位元組, 並發數: {parallel_num}")
       if checkpoint_dir:
           print(f"斷點續傳: 已啟用（checkpoint_dir={checkpoint_dir}）")
       else:
           print("斷點續傳: 未啟用（如需啟用請設定 checkpoint_dir）")
   
       # 執行上傳（Uploader 會自動根據大小選擇多/單分區並發上傳）
       result = uploader.upload_file(
           oss.PutObjectRequest(bucket=bucket_name, key=object_key),
           filepath=file_path,
       )
   
       print("-" * 30)
       print("檔案上傳成功!")
       print(f"HTTP Status: {result.status_code}")
       print(f"ETag: {result.etag}")
       print(f"請求 ID: {result.request_id}")
       # CRC64 校正值；v2 預設啟用資料校正
       print(f"CRC64: {result.hash_crc64}")
       print("-" * 30)
   
   
   def main():
       # 運行程式碼範例之前，請確保已設定相應的環境變數。
       # macOS/Linux:
       #   AK方式:
       #     export OSS_ACCESS_KEY_ID=YOUR_AK_ID
       #     export OSS_ACCESS_KEY_SECRET=YOUR_AK_SECRET
       #   STS方式:
       #     export OSS_ACCESS_KEY_ID=YOUR_STS_ID
       #     export OSS_ACCESS_KEY_SECRET=YOUR_STS_SECRET
       #     export OSS_SECURITY_TOKEN=YOUR_STS_TOKEN
       #
       # Windows:
       #   Powershell: $env:OSS_ACCESS_KEY_ID="YOUR_AK_ID"
       #   cmd: set OSS_ACCESS_KEY_ID=YOUR_AK_ID
   
       # ===================== 參數區（按需修改） =====================
       # Region 樣本：'cn-hangzhou'；建議優先使用 Region
       region = "cn-hangzhou"
   
       # 可選：自訂 Endpoint（如需內網、專有域、加速網域名稱等）
       # 例如：'https://oss-cn-hangzhou.aliyuncs.com'
       endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'  
   
       # Bucket 與 Object
       bucket_name = "examplebucket"
       object_key = "test.bak"
   
       # 待上傳的本地檔案完整路徑。
       # Windows樣本: r'D:\localpath\examplefile.txt'  (注意前面的 r)
       # macOS/Linux樣本: '/Users/test/examplefile.txt'
       file_path = r"D:\oss\test.bak"
   
       # 分區與並發
       part_size = 1 * 1024 * 1024  # 預設 1MB；OSS 要求單片最小 100KB
       parallel_num = 4
   
       # 斷點續傳目錄（傳 None 則不啟用；建議指定到一個可寫目錄）
       checkpoint_dir = str(Path.cwd() / ".oss_checkpoints")
       # =================== 參數區結束 ===================
   
       print("指令碼開始執行...")
       try:
           client = get_client_from_env(region=region, endpoint=endpoint)
           # 若啟用斷點續傳，確保目錄存在
           if checkpoint_dir:
               Path(checkpoint_dir).mkdir(parents=True, exist_ok=True)
   
           resumable_upload_file_v2(
               client=client,
               bucket_name=bucket_name,
               object_key=object_key,
               file_path=file_path,
               part_size=part_size,
               parallel_num=parallel_num,
               checkpoint_dir=checkpoint_dir,
           )
       except FileNotFoundError as e:
           print(e)
       except oss_ex.ServiceError as e:
           # OSS 服務端返回的錯誤
           print("\n發生 OSS 服務端錯誤。")
           print(f"HTTP Status: {getattr(e, 'status_code', 'N/A')}")
           print(f"Error Code: {getattr(e, 'code', 'N/A')}")
           print(f"Message: {getattr(e, 'message', 'N/A')}")
           print(f"Request ID: {getattr(e, 'request_id', 'N/A')}")
           print(f"Endpoint: {getattr(e, 'request_target', 'N/A')}")
       except oss_ex.BaseError as e:
           # SDK 本地/序列化/還原序列化/憑據等錯誤
           print("\n發生 OSS SDK 用戶端錯誤。")
           print(str(e))
       except Exception as e:
           print(f"\n發生未知錯誤: {e}")
   
   
   if __name__ == "__main__":
       main()

2008 R2高效能本地碟

1. 將備份檔案上傳至OSS前，您需先在OSS中建立儲存空間Bucket。

   • 若OSS中已存在Bucket，請確保該Bucket滿足以下要求：

     • Bucket儲存類型儲存類型為標準儲存。不能是低頻訪問儲存、Archive Storage、冷Archive Storage、深度冷Archive Storage。

     • Bucket未開啟服務端加密。

   • 若OSS中沒有Bucket，需要先行建立。（請確保已開通OSS服務）

     1. 登入OSS管理主控台，單擊Bucket列表，然後單擊建立Bucket。

     2. 配置如下關鍵參數，其他參數可以保持預設。

        重要

        • 建立的儲存空間主要用於本次資料上雲，只需配置關鍵參數即可，上雲完成後可以及時刪除以避免資料泄露及產生相關費用。

        • 建立Bucket時請勿開啟服務端加密。

        參數	說明	取值樣本
        Bucket 名稱	儲存空間名稱，全域唯一，設定後無法修改。 命名規則： 只能包括小寫字母、數字和短劃線（-）。 必須以小寫字母或者數字開頭和結尾。 長度必須在3~63字元之間。	migratetest
        地區	Bucket所屬的地區，如果您通過ECS內網上傳資料至Bucket中，且通過內網將資料恢複至RDS中，則需要三者地區保持一致。	華東1（杭州）
        儲存類型	選擇標準儲存。本文上雲操作不支援其他儲存類型的Bucket。	標準儲存

2. 上傳備份檔案到OSS。

   本機資料庫備份完成後，請將備份檔案上傳到與您的RDS執行個體同地區的OSS Bucket中，兩者處於同一地區時可通過內網互連（不會產生外網流量費用），且資料上傳速度更快。您可以採用如下方法之一：

   使用ossbrowser工具上傳（推薦）

   1. 下載ossbrowser。

   2. 以Windows x64作業系統為例，解壓下載的oss-browser-win32-x64.zip壓縮包，雙擊運行oss-browser.exe應用程式。

   3. 使用AK登入方式，配置參數AccessKeyId和AccessKeySecret，其他參數保持預設，然後單擊登入。

      說明

      AccessKey用於身分識別驗證，確保資料安全，請妥善保管。

      

   4. 單擊目標Bucket，進入儲存空間。

   5. 單擊，選擇需要上傳的備份檔案，然後單擊開啟，即可將本地檔案上傳至OSS中。

   使用OSS控制台上傳

   說明

   如果備份檔案小於5 GB，建議您直接通過OSS控制台上傳備份檔案。

   1. 登入OSS管理主控台。

   2. 單擊Bucket列表，然後單擊目標Bucket名稱。

   3. 在檔案清單中，單擊上傳檔案。

   4. 您可以將備份檔案拖拽至待上傳檔案地區，也可以單擊掃描檔案，選擇需要上傳的備份檔案。

   5. 單擊頁面下方的上傳檔案，即可將本地備份檔案上傳至OSS中。

   使用OSS API分區上傳（以Python 3專案為例）

   說明

   如果備份檔案大於5 GB，建議您調用OSS API採用分區上傳的方式將備份檔案上傳到OSS Bucket中。

   # -*- coding: utf-8 -*-
   """
   Alibaba Cloud OSS Python SDK v2
   依賴：pip install alibabacloud-oss-v2
   """
   
   import os
   import sys
   from pathlib import Path
   import alibabacloud_oss_v2 as oss
   from alibabacloud_oss_v2 import exceptions as oss_ex
   
   
   def get_client_from_env(region: str, endpoint: str | None = None) -> oss.Client:
       """
       從環境變數建立 v2 用戶端。
       - 優先使用 Region（推薦），也支援自訂 Endpoint（可選）。
       - 同時相容 AK 與 STS：
           * AK: 需要 OSS_ACCESS_KEY_ID / OSS_ACCESS_KEY_SECRET
           * STS: 另需 OSS_SESSION_TOKEN（相容舊變數 OSS_SECURITY_TOKEN）
       """
       # 相容：如果使用者使用了老變數 OSS_SECURITY_TOKEN，則映射到 v2 期望的 OSS_SESSION_TOKEN
       sec_token_legacy = os.getenv("OSS_SECURITY_TOKEN")
       if sec_token_legacy and not os.getenv("OSS_SESSION_TOKEN"):
           os.environ["OSS_SESSION_TOKEN"] = sec_token_legacy
   
       ak = os.getenv("OSS_ACCESS_KEY_ID")
       sk = os.getenv("OSS_ACCESS_KEY_SECRET")
       st = os.getenv("OSS_SESSION_TOKEN")  # STS Token（可選）
   
       if not (ak and sk):
           raise ValueError("未找到有效 AK，請設定環境變數 OSS_ACCESS_KEY_ID 和 OSS_ACCESS_KEY_SECRET。"
                            "如使用 STS，請同時設定 OSS_SESSION_TOKEN（或舊名 OSS_SECURITY_TOKEN）。")
   
       # 提示所用憑據類型
       if st:
           print("檢測到 STS Token（OSS_SESSION_TOKEN），使用 STS 憑證。")
       else:
           print("未檢測到 STS Token，使用 AccessKey (AK) 憑證。")
   
       credentials_provider = oss.credentials.EnvironmentVariableCredentialsProvider()
       cfg = oss.config.load_default()
       cfg.credentials_provider = credentials_provider
   
       # 基本網路設定
       cfg.region = region  # 例如：'cn-hangzhou'
       if endpoint:
           # 可選：自訂 Endpoint（如內網、加速、專有域）
           cfg.endpoint = endpoint
   
       # 也可以在此添加其它配置，如：cfg.use_accelerate_endpoint = True
       return oss.Client(cfg)
   
   
   def resumable_upload_file_v2(
       client: oss.Client,
       bucket_name: str,
       object_key: str,
       file_path: str,
       part_size: int = 1 * 1024 * 1024,
       parallel_num: int = 4,
       checkpoint_dir: str | None = None,
   ):
       """
       實現分區並發 + 斷點續傳上傳。
   
       :param client: 已初始化的 oss.Client
       :param bucket_name: 目標 Bucket 名稱
       :param object_key: 目標 Object Key（不包含 Bucket 名）
       :param file_path: 本地檔案完整路徑
       :param part_size: 分區大小（單位：位元組），預設 1MB
       :param parallel_num: 並發上傳線程數，預設 4
       :param checkpoint_dir: 斷點資訊儲存目錄；若為 None，則不啟用斷點續傳
       """
       file_path = str(file_path)
       if not Path(file_path).exists():
           raise FileNotFoundError(f"錯誤: 本地檔案未找到，請檢查 file_path 配置: {file_path}")
   
       # 構造 Uploader；根據是否傳入checkpoint_dir來啟用斷點續傳
       if checkpoint_dir:
           uploader = client.uploader(
               enable_checkpoint=True,
               checkpoint_dir=checkpoint_dir,
               part_size=part_size,
               parallel_num=parallel_num,
           )
       else:
           uploader = client.uploader(
               part_size=part_size,
               parallel_num=parallel_num,
           )
   
       print(f"開始上傳檔案: {file_path}")
       print(f"目標 Bucket: {bucket_name}")
       print(f"目標 Object: {object_key}")
       print(f"分區大小: {part_size} 位元組, 並發數: {parallel_num}")
       if checkpoint_dir:
           print(f"斷點續傳: 已啟用（checkpoint_dir={checkpoint_dir}）")
       else:
           print("斷點續傳: 未啟用（如需啟用請設定 checkpoint_dir）")
   
       # 執行上傳（Uploader 會自動根據大小選擇多/單分區並發上傳）
       result = uploader.upload_file(
           oss.PutObjectRequest(bucket=bucket_name, key=object_key),
           filepath=file_path,
       )
   
       print("-" * 30)
       print("檔案上傳成功!")
       print(f"HTTP Status: {result.status_code}")
       print(f"ETag: {result.etag}")
       print(f"請求 ID: {result.request_id}")
       # CRC64 校正值；v2 預設啟用資料校正
       print(f"CRC64: {result.hash_crc64}")
       print("-" * 30)
   
   
   def main():
       # 運行程式碼範例之前，請確保已設定相應的環境變數。
       # macOS/Linux:
       #   AK方式:
       #     export OSS_ACCESS_KEY_ID=YOUR_AK_ID
       #     export OSS_ACCESS_KEY_SECRET=YOUR_AK_SECRET
       #   STS方式:
       #     export OSS_ACCESS_KEY_ID=YOUR_STS_ID
       #     export OSS_ACCESS_KEY_SECRET=YOUR_STS_SECRET
       #     export OSS_SECURITY_TOKEN=YOUR_STS_TOKEN
       #
       # Windows:
       #   Powershell: $env:OSS_ACCESS_KEY_ID="YOUR_AK_ID"
       #   cmd: set OSS_ACCESS_KEY_ID=YOUR_AK_ID
   
       # ===================== 參數區（按需修改） =====================
       # Region 樣本：'cn-hangzhou'；建議優先使用 Region
       region = "cn-hangzhou"
   
       # 可選：自訂 Endpoint（如需內網、專有域、加速網域名稱等）
       # 例如：'https://oss-cn-hangzhou.aliyuncs.com'
       endpoint = 'https://oss-cn-hangzhou.aliyuncs.com'  
   
       # Bucket 與 Object
       bucket_name = "examplebucket"
       object_key = "test.bak"
   
       # 待上傳的本地檔案完整路徑。
       # Windows樣本: r'D:\localpath\examplefile.txt'  (注意前面的 r)
       # macOS/Linux樣本: '/Users/test/examplefile.txt'
       file_path = r"D:\oss\test.bak"
   
       # 分區與並發
       part_size = 1 * 1024 * 1024  # 預設 1MB；OSS 要求單片最小 100KB
       parallel_num = 4
   
       # 斷點續傳目錄（傳 None 則不啟用；建議指定到一個可寫目錄）
       checkpoint_dir = str(Path.cwd() / ".oss_checkpoints")
       # =================== 參數區結束 ===================
   
       print("指令碼開始執行...")
       try:
           client = get_client_from_env(region=region, endpoint=endpoint)
           # 若啟用斷點續傳，確保目錄存在
           if checkpoint_dir:
               Path(checkpoint_dir).mkdir(parents=True, exist_ok=True)
   
           resumable_upload_file_v2(
               client=client,
               bucket_name=bucket_name,
               object_key=object_key,
               file_path=file_path,
               part_size=part_size,
               parallel_num=parallel_num,
               checkpoint_dir=checkpoint_dir,
           )
       except FileNotFoundError as e:
           print(e)
       except oss_ex.ServiceError as e:
           # OSS 服務端返回的錯誤
           print("\n發生 OSS 服務端錯誤。")
           print(f"HTTP Status: {getattr(e, 'status_code', 'N/A')}")
           print(f"Error Code: {getattr(e, 'code', 'N/A')}")
           print(f"Message: {getattr(e, 'message', 'N/A')}")
           print(f"Request ID: {getattr(e, 'request_id', 'N/A')}")
           print(f"Endpoint: {getattr(e, 'request_target', 'N/A')}")
       except oss_ex.BaseError as e:
           # SDK 本地/序列化/還原序列化/憑據等錯誤
           print("\n發生 OSS SDK 用戶端錯誤。")
           print(str(e))
       except Exception as e:
           print(f"\n發生未知錯誤: {e}")
   
   
   if __name__ == "__main__":
       main()

3. 設定備份檔案的連結有效時間，並擷取檔案的連結地址。

   1. 登入OSS 管理主控台。

   2. 單擊Bucket 列表，然後單擊目標Bucket名稱。

   3. 在左側導覽列，選擇檔案管理 > 檔案清單。

   4. 單擊目標Database Backup檔案操作列的詳情，在彈出面板中，將到期時間 (秒)修改為28800秒，即8小時。

      重要

      將備份檔案從OSS遷移至RDS時，需要使用備份檔案的連結地址，如果超過了連結有效時間，將導致資料移轉失敗。

   5. 單擊複製檔案URL，擷取檔案的連結地址。

      

   6. 修改擷取到的資料備份檔案連結地址。

      預設擷取的是檔案的外網串連地址，如需通過內網遷移資料，您需要將檔案連結地址中的Endpoint改成內網Endpoint。

      例如，備份檔案的連結地址為http://rdstest.oss-cn-shanghai.aliyuncs.com/testmigraterds_20170906143807_FULL.bak?Expires=15141****&OSSAccessKeyId=TMP****，您需要將連結地址中的oss-cn-shanghai.aliyuncs.com修改為oss-cn-shanghai-internal.aliyuncs.com。

      重要

      不同的網路類型、不同地區所對應的內網Endpoint不同。具體詳情，請參見訪問網域名稱和資料中心。

2012及以上版本、2008 R2雲端硬碟

1. 訪問RDS執行個體列表，在上方選擇地區，然後單擊目標執行個體ID。

2. 在左側功能表列中選擇備份恢複。

3. 單擊頁面上方的OSS備份資料恢複上雲。

4. 在資料匯入嚮導頁面，單擊兩次下一步，進入資料匯入步驟。

   說明

   • 首次使用OSS備份資料恢複上雲功能，需授權RDS帳號訪問OSS，請單擊授權地址並同意授權，否則會因許可權問題導致OSS Bucket下拉式清單為空白。

   • 在該頁面選不到目標檔案時，請檢查OSS內備份檔案尾碼是否符合要求（可在本文注意事項查看尾碼要求），並確保RDS執行個體與OSS Bucket處於同一地區。

5. 設定如下參數。

   配置項	說明
   資料庫名	備份資料匯入目標RDS執行個體上的資料庫名，名稱需要符合SQL Server官方限制。 重要 進行上雲操作前，請確保目標執行個體上不存在與備份檔案指定要還原的資料庫名稱相同的資料庫，也不存在相同名稱的未附加資料庫檔案。若都不存在，則可以使用備份組中同名資料庫檔案名稱還原資料庫。 如果目標執行個體上存在與備份檔案指定要還原的資料庫名稱相同的資料庫，或者存在同名的未附加資料庫檔案，上雲操作將失敗。
   OSS Bucket	選擇備份檔案所在的OSS Bucket。
   OSS檔案清單	單擊右側按鈕，可以按照備份檔案名首碼模糊尋找，會展示檔案名稱、檔案大小和更新時間。請選擇需要上雲的備份檔案。
   上雲方案	開啟資料庫（只有一個全量備份檔案）：全量上雲，適合僅有一個完全備份檔案上雲的情境。本操作選擇開啟資料庫（只有一個全量備份檔案），此時CreateMigrateTask中的BackupMode = FULL並且IsOnlineDB = True。 不開啟資料庫（還有差異備份或記錄檔）：增量上雲，適合有完全備份檔案加上記錄備份（或者差異備份檔案）上雲的情境，此時CreateMigrateTask中的BackupMode = UPDF 並且IsOnlineDB = False。
   一致性檢查方式	非同步執行DBCC：在開啟資料庫時系統不做DBCC CheckDB，而是在開啟資料庫任務結束以後，非同步執行DBCC CheckDB操作，以此節約開啟資料庫操作的時間開銷（資料庫比較大，DBCC CheckDB非常耗時），減少您的業務停機時間。如果您對業務停機時間要求非常敏感，且不關心DBCC CheckDB結果，建議使用非同步執行DBCC。此時CreateMigrateTask 中的CheckDBMode = AsyncExecuteDBCheck。 同步執行DBCC：相對於非同步執行DBCC，有的使用者非常關心DBCC CheckDB的結果，以此來找出使用者線下資料庫資料一致性錯誤。此時，建議您選擇同步執行DBCC，影響是會拉長開啟資料庫的時間。此時CreateMigrateTask 中的CheckDBMode = SyncExecuteDBCheck。

6. 單擊確定。

   請耐心等待上雲任務完成，您可以單擊重新整理以查看任務的最新狀態。如上雲任務失敗，請根據任務描述提示排查錯誤，具體可參見本文常見錯誤。

   說明

   資料上雲完成後，系統會根據RDS執行個體的自動備份策略在指定的備份時間（該時間可手動調整）發起備份，產生的備份組將包含已上雲的資料，您可以在RDS執行個體詳情頁的備份恢複頁面查看。

   如果尚未到達備份時間點，但您急需在雲上產生備份，也可以選擇進行手動備份。

2008 R2高效能本地碟

1. 訪問RDS執行個體列表，在上方選擇地區，然後單擊目標執行個體ID。

2. 在左側導覽列，單擊資料庫管理。

3. 找到目標資料庫，單擊操作列的從OSS上的備份檔案遷入。

   

4. 在資料匯入嚮導對話方塊中，閱讀提示內容，單擊下一步。

5. 閱讀OSS上傳的相關提示內容，單擊下一步。

6. 在備份檔案OSS URL欄中填寫備份檔案在OSS的連結地址，單擊確定。

   

   說明

   RDS SQL Server 2008 R2高效能本地碟執行個體當前僅支援將全量備份檔案一次性遷入雲上的方案。

2012及以上版本、2008 R2雲端硬碟

訪問RDS執行個體左側導覽列備份恢複頁面，在備份資料上雲記錄頁簽內查看備份上雲記錄，包括任務狀態、任務開始和結束時間等。預設展示最近一周的記錄，可按需調整時間區間。

2008 R2高效能本地碟

訪問RDS執行個體左側導覽列資料上雲頁面，然後找到目標遷移任務來查看資料移轉的進度。