本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 從 Amazon S3 下載封存的重做日誌
<a name="Appendix.Oracle.CommonDBATasks.download-redo-logs"></a>

您可以使用 `rdsadmin.rdsadmin_archive_log_download` 套件下載資料庫執行個體上的封存重做日誌。如果封存的重做日誌不在資料庫執行個體上，您可能想要從 Amazon S3 再次下載這些日誌。然後，您可以挖掘日誌或使用它們來恢復或複寫資料庫。

**注意**  
您無法在僅供讀取複本執行個體上下載封存重做日誌。

## 下載封存的重做日誌：基本步驟
<a name="Appendix.Oracle.CommonDBATasks.download-redo-logs.basic-process"></a>

封存重做日誌的可用性取決於下列保留政策：
+ 備份保留政策 — Amazon S3 提供此政策之內的日誌。移除此政策之外的日誌。
+ 封存日誌保留政策 — 您的資料庫執行個體提供此政策之內的日誌。移除此政策之外的日誌。

如果日誌不在您的執行個體上，但受到備份保留期間的保護，請使用 `rdsadmin.rdsadmin_archive_log_download` 再次下載。RDS for Oracle 會將日誌儲存至資料庫執行個體上的 `/rdsdbdata/log/arch` 目錄。

**從 Amazon S3 下載封存的重做日誌**

1. 設定您的保留期間，以確保您下載的封存重做日誌在您需要保留期間之內。務必 `COMMIT` 您的變更。

   RDS 會根據封存的日誌保留政策保留您下載的日誌檔，從日誌下載的時間開始。若要了解如何設定保留政策，請參閱 [保留封存的重做日誌](Appendix.Oracle.CommonDBATasks.RetainRedoLogs.md)。

1. 最多等待 5 分鐘，讓封存日誌保留政策變更生效。

1. 使用 `rdsadmin.rdsadmin_archive_log_download` 從 Amazon S3 下載封存的重做日誌。

   如需更多詳細資訊，請參閱 [下載單一封存重做日誌](#Appendix.Oracle.CommonDBATasks.download-redo-logs.single-log) 及 [下載一系列的封存重做日誌](#Appendix.Oracle.CommonDBATasks.download-redo-logs.series)。
**注意**  
RDS 會在下載前自動檢查可用的儲存空間。如果要求的日誌會耗用高百分比的空間，您會收到提醒。

1. 確認日誌已成功從 Amazon S3 下載。

   您可在 bdump 檔案之中檢視下載任務的狀態。bdump 檔案的路徑名稱是 `/rdsdbdata/log/trace/dbtask-task-id.log`。在上述的下載步驟中，您執行的 `SELECT` 陳述式會傳回 `VARCHAR2` 資料類型的任務 ID。如需更多詳細資訊，請參閱 [監控檔案傳輸狀態](oracle-s3-integration.using.md#oracle-s3-integration.using.task-status) 中的類似範例。

## 下載單一封存重做日誌
<a name="Appendix.Oracle.CommonDBATasks.download-redo-logs.single-log"></a>

若要將單一封存重做日誌下載至 `/rdsdbdata/log/arch` 目錄，請使用 `rdsadmin.rdsadmin_archive_log_download.download_log_with_seqnum`。此程序具有下列參數。


****  

| 參數名稱 | 資料類型 | 預設 | 必要 | 描述 | 
| --- | --- | --- | --- | --- | 
|  `seqnum`  |  數字  |  —  |  是  |  封存重做日誌的序號。  | 

下列範例會下載序號為 20 的日誌。

```
SELECT rdsadmin.rdsadmin_archive_log_download.download_log_with_seqnum(seqnum => 20) 
       AS TASK_ID 
FROM   DUAL;
```

## 下載一系列的封存重做日誌
<a name="Appendix.Oracle.CommonDBATasks.download-redo-logs.series"></a>

若要將一系列的封存重做日誌下載至 `/rdsdbdata/log/arch` 目錄，請使用 `download_logs_in_seqnum_range`。您的下載限制為每個請求 300 個日誌。`download_logs_in_seqnum_range` 程序具有下列參數。


****  

| 參數名稱 | 資料類型 | 預設 | 必要 | 描述 | 
| --- | --- | --- | --- | --- | 
|  `start_seq`  |  數字  |  —  |  是  |  系列的起始序號。  | 
|  `end_seq`  |  數字  |  —  |  是  |  系列的結束序號。  | 

下列範例會下載序列 50 到 100 的日誌。

```
SELECT rdsadmin.rdsadmin_archive_log_download.download_logs_in_seqnum_range(start_seq => 50, end_seq => 100) 
       AS TASK_ID 
FROM   DUAL;
```