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

# 管理保留
<a name="capacity-management-managing-reservations"></a>

您可以在**容量保留**頁面上檢視和管理您的容量保留。您可以執行管理任務，例如新增或減少 DPU、修改工作群組指派，以及標記或取消保留。

**若要檢視和管理容量保留**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

1. 選擇**管理**、**容量保留**。

1. 在容量保留頁面上，您可以執行下列任務：
   + 若要建立容量保留，請選擇**建立容量保留**。
   + 使用搜尋方塊，依名稱或 DPU 數目篩選保留。
   + 選擇狀態下拉式選單，依容量保留狀態進行篩選 (例如，**作用中**或**已取消**)。如需有關保留狀態的詳細資訊，請參閱 [了解保留狀態](#capacity-management-understanding-reservation-status)。
   + 若要檢視容量保留的詳細資訊，請選擇保留的連結。保留的詳細資訊頁面包括以下選項：[編輯容量](capacity-management-editing-capacity-reservations.md)、[新增工作群組](capacity-management-adding-workgroups-to-a-reservation.md)、[移除工作群組](capacity-management-removing-a-workgroup-from-a-reservation.md)以及[取消](capacity-management-cancelling-a-capacity-reservation.md)保留。
   + 若要編輯保留 (例如，透過新增或移除 DPU)，請選取保留的按鈕，然後選擇**編輯**。
   + 若要取消預留，請選取保留按鈕，然後選擇**取消**。

## 了解保留狀態
<a name="capacity-management-understanding-reservation-status"></a>

下表說明容量保留的可能狀態值。


****  

| 狀態 | Description | 
| --- | --- | 
| 待定 | Athena 正在處理您的容量請求。容量尚未準備好執行查詢。 | 
| Active (作用中) | 容量可用於執行查詢。 | 
| 失敗 | 您的容量請求未成功完成。請注意，無法保證滿足容量請求。失敗的保留會計入您的帳戶 DPU 限制。若要釋出使用量，您必須取消保留。 | 
| 更新待定 | Athena 正在處理保留的變更。例如，在您編輯保留以新增或移除 DPU 之後，就會發生此狀態。 | 
| 取消 | Athena 正在處理取消保留的請求。仍在使用保留的工作群組中執行的查詢可以完成，但工作群組中的其他查詢將使用隨選 (未佈建的) 容量。 | 
| 已取消 |  容量保留取消完成。已取消的保留會在主控台中保留 45 天。45 天後，Athena 將刪除保留。在這 45 天期間，您無法重新規劃或重複使用保留，但您可以參考其標籤並檢視其詳細資訊以供歷史參考。 無法保證可在未來日期重新保留取消的容量。容量無法轉移到另一個保留， AWS 帳戶 或 AWS 區域。  | 

## 了解作用中 DPU 和目標 DPU
<a name="capacity-management-understanding-dpu-status"></a>

在 Athena 主控台的容量保留清單中，您的保留會顯示兩個 DPU 值：**作用中 DPU** 和**目標 DPU**。
+ **作用中 DPU** – 保留中可用來執行查詢的 DPU 數目。例如，如果您請求 100 個 DPU，且您的請求已滿足，則**作用中 DPU** 會顯示 **100**。
+ **目標 DPU** – 您的保留正在移至的 DPU 數目。在建立保留或待定增加或減少 DPU 數目時，**目標 DPU** 顯示的值會與**作用中 DPU** 不同。

例如，在您提交請求以建立具有 24 個 DPU 的保留之後，保留**狀態**將為**待定**，**作用中 DPU** 將為 **0**，而**目標 DPU** 將為 **24**。

如果您的保留有 100 個 DPU，並編輯您的保留以請求增加 20 個 DPU，則**狀態**將為**更新待定**，**作用中 DPU** 將為 **100**，而**目標 DPU** 將為 **120**。

如果您的保留有 100 個 DPU，並編輯您的保留以請求減少 20 個 DPU，則**狀態**將為**更新待定**，**作用中 DPU** 將為 **100**，而**目標 DPU** 將為 **80**。

在這些轉換期間，Athena 會根據您的請求積極獲取或減少 DPU 數目。當**作用中 DPU** 等於**目標 DPU** 時，則達到目標數目，且沒有任何待定變更。

若要以程式設計方式擷取這些值，您可以呼叫 [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html) API 動作。該 API 將**作用中 DPU** 和**目標 DPU** 稱為 `AllocatedDpus` 和 `TargetDpus`。

**Topics**
+ [了解保留狀態](#capacity-management-understanding-reservation-status)
+ [了解作用中 DPU 和目標 DPU](#capacity-management-understanding-dpu-status)
+ [編輯容量保留](capacity-management-editing-capacity-reservations.md)
+ [將工作群組新增至保留](capacity-management-adding-workgroups-to-a-reservation.md)
+ [從保留中移除工作群組](capacity-management-removing-a-workgroup-from-a-reservation.md)
+ [取消容量保留](capacity-management-cancelling-a-capacity-reservation.md)
+ [刪除容量保留](capacity-management-deleting-a-capacity-reservation.md)

# 編輯容量保留
<a name="capacity-management-editing-capacity-reservations"></a>

建立容量保留後，您可以調整其 DPU 數目，以及新增或移除其自訂標籤。

**若要編輯容量保留**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

1. 選擇**管理**、**容量保留**。

1. 在容量保留清單中，執行下列任意一項：
   + 選取保留旁邊的按鈕，然後選擇**編輯**。
   + 選擇保留連結，然後選擇**編輯**。

1. 針對 **DPU**，選擇或輸入您想要的資料處理單位數量。如需詳細資訊，請參閱[了解 DPU](capacity-management.md#capacity-management-understanding-dpus)。
**注意**  
您可以隨時請求將 DPUs 新增至作用中容量保留。
當保留變為作用中或上次新增 DPUs後已超過 1 分鐘時，您可以請求從作用中容量保留減少 DPUs。
當您請求減少 DPUs 時，Athena 會優先移除閒置DPUs而非作用中DPUs。如果查詢正在使用標記為移除DPUs，Athena 會等待查詢完成，然後再移除 DPUs。

1. (選用) 針對**標籤**，選擇**移除**以移除標籤，或選擇**新增標籤**以新增標籤。

1. 選擇**提交**。保留詳細資訊頁面會顯示更新的組態。

# 將工作群組新增至保留
<a name="capacity-management-adding-workgroups-to-a-reservation"></a>

建立容量保留後，您最多可以將 20 個工作群組新增至保留。將工作群組新增至保留會告訴 Athena 應該在預留容量上執行哪些查詢。來自未與保留關聯的工作群組查詢，會繼續使用預設的每 TB 掃描定價模式執行。

當保留有兩個或多個工作群組時，來自這些工作群組的查詢可以使用保留的容量。您可以隨時新增和移除工作群組。新增或移除工作群組時，不會中斷正在執行的查詢。

當您的保留處於待定狀態時，來自您新增的工作群組的查詢會繼續使用預設的每 TB 掃描定價模式執行，直到保留變為作用中。

**若要將一或多個工作群組新增至您的容量保留**

1. 在容量保留的詳細資訊頁面上，選擇**新增工作群組**。

1. 在**新增工作群組**頁面上，選取要新增的工作群組，然後選擇**新增工作群組**。您不能將一個工作群組指派至多個預留。

   容量保留的詳細資訊頁面會列出您新增的工作群組。在這些工作群組中執行的查詢，將使用您在保留處於作用中狀態時保留的容量。

# 從保留中移除工作群組
<a name="capacity-management-removing-a-workgroup-from-a-reservation"></a>

如果您不再需要工作群組專用容量，或想要將工作群組移至其自己的保留中，您可以隨時將其移除。從保留移除工作群組輕鬆簡單。從保留中移除工作群組後，從移除的工作群組查詢會使用隨需容量返回 ，並根據掃描的 TB (TB) 計費。

**若要從保留移除一或多個工作群組**

1. 在容量保留之詳細資料頁面上，選取您要移除的工作群組。

1. 選擇**移除工作群組**。**是否移除工作群組？**提示會通知您，在將工作群組從保留中移除之前，將會完成所有目前作用中的查詢。

1. 選擇**移除**。容量保留的詳細資訊頁面會顯示移除的工作群組不再存在。

# 取消容量保留
<a name="capacity-management-cancelling-a-capacity-reservation"></a>

如果您不想再使用容量保留，則可將其取消。仍在使用保留的工作群組中執行的查詢將可完成，但工作群組中的其他查詢將不再使用保留。

**注意**  
無法保證可在未來日期重新保留取消的容量。容量無法轉移至其他保留， AWS 帳戶 或 AWS 區域。

**若要取消容量保留**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

1. 選擇**管理**、**容量保留**。

1. 在容量保留清單中，執行下列任意一項：
   + 選取保留旁邊的按鈕，然後選擇**取消**。
   + 選擇容量連結，然後選擇**取消容量保留**。

1. 畫面出現**是否取消容量保留？**提示時，輸入**取消**，然後選擇**取消容量保留**。

   保留的狀態會變更為**取消中**，且進度橫幅會通知您正在取消。

   取消完成後，容量保留仍會保留，但其狀態會顯示為**已取消**。保留將在取消後 45 天刪除。在這 45 天期間，您無法重新規劃或重複使用已取消的保留，但您可以參考其標籤並檢視其詳細資訊以供歷史參考。

# 刪除容量保留
<a name="capacity-management-deleting-a-capacity-reservation"></a>

如果您要移除已取消的容量保留的所有參考，您可以刪除保留。必須先取消保留，然後才可將其刪除。刪除的保留會立即從您的帳戶中移除，且無法再參考，包括其 ARN。

**若要刪除容量保留**

1. 前往 [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home) 開啟 Athena 主控台。

1. 如果未顯示主控台的導覽窗格，請選擇左側的展開選單。

1. 選擇**管理**、**容量保留**。

1. 在容量保留清單中，執行下列任意一項：
   + 選取已取消的保留旁邊的按鈕，然後選擇**動作**、**刪除**。
   + 選擇保留連結，然後選擇**刪除**。

1. 畫面出現**是否刪除容量保留？**提示時，選擇**刪除**。

   畫面會出現橫幅，通知您已成功刪除容量保留。刪除的保留不再出現在容量保留清單中。