# 管理预留
<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>

下表描述了容量预留的可能状态值。


****  

| Status | 说明 | 
| --- | --- | 
| 待处理 | Athena 正在处理您的容量请求。容量未就绪，无法运行查询。 | 
| 活跃 | 容量可用于运行查询。 | 
| 已失败 | 您的容量请求未成功完成。请注意，无法保证完成容量请求。失败的预留将计入您的账户 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)。
**注意**  
您可以随时申请向现有容量预留添加 DPU。
在预留变为活动预留 1 分钟后或上次添加 DPU 时，您可以请求从活动容量预留中减少 DPU。
当您请求减少 DPU 时，Athena 会优先移除空闲 DPU，而不是移除活动 DPU。如果查询正在消耗标记为要移除的 DPU，Athena 会等待查询完成，然后再移除 DPU。

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）进行计费。

**移除预留中的一个或多个工作组**

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. 在**是否删除容量预留？**提示时，选择**删除**。

   将显示一个横幅，通知您容量预留已成功删除。已删除预留将不再出现在容量预留列表中。