管理预留 - Amazon Athena
了解预留状态了解活动 DPU 和目标 DPU编辑容量预留向预留添加工作组从预留中移除工作组取消容量预留删除容量预留
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

管理预留

您可以在容量预留页面上查看和管理您的容量预留。您可以执行诸多管理任务，例如添加或减少 DPU、修改工作组分配以及标记或取消预留。

查看和管理容量预留

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

  2. 如果控制台导航窗格不可见，请选择左侧的扩展菜单。

  3. 选择管理、容量预留。

  4. 在容量预留页面上，可以执行以下任务：

    • 要创建容量预留，请选择创建容量预留。

    • 使用搜索框按 DPU 的名称或数量筛选预留。

    • 选择状态下拉菜单以按容量预留状态（例如，活动或已取消）进行筛选。有关预留状态的更多信息，请参阅 了解预留状态。

    • 要查看容量预留的详细信息，请选择预留链接。预留的详细信息页面包含用于编辑容量、添加工作组、删除工作组和取消预留的选项。

    • 要编辑预留（例如，通过添加或移除 DPU），请选择预留对应的按钮，然后选择编辑。

    • 要取消预订，请选择预留对应的按钮，然后选择取消。

了解预留状态

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

Status 描述
待处理 Athena 正在处理您的容量请求。容量未就绪，无法运行查询。
处于活动状态 容量可用于运行查询。
已失败 您的容量请求未成功完成。请注意，无法保证完成容量请求。失败的预留将计入您的账户 DPU 限制。要释放用量，必须取消预留。
待更新 Athena 正在处理预留更改。例如，在编辑预留以添加或删除 DPU 之后，就会出现该状态。
正在取消 Athena 正在处理取消预留请求。允许正在使用预留的工作组中仍在运行的查询完成，但工作组中的其他查询将使用按需（未预置）容量。
已取消

容量预留取消已完成。已取消预留将在控制台中保留 45 天。45 天后，Athena 将删除该预留。在 45 天内，您不能重新利用或重复使用该预留，但是可以引用其标签并查看其详细信息以供历史参考。

无法保证已取消容量在未来可以重新预留。容量无法转移到另一个预留 Amazon Web Services 账户 或 Amazon Web Services 区域。

了解活动 DPU 和目标 DPU

在 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 API 操作。API 将活动 DPU 和目标 DPU 称为 AllocatedDpus 和 TargetDpus。

编辑容量预留

在创建容量预留后，您可以调整其 DPU 数并添加或移除其自定义标签。

编辑容量预留

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

  2. 如果控制台导航窗格不可见，请选择左侧的扩展菜单。

  3. 选择管理、容量预留。

  4. 在容量预留列表中，执行以下操作之一：

    • 选择预留旁的按钮，然后选择编辑。

    • 选择预留链接，然后选择编辑。

  5. 对于 DPU，选择或输入所需的数据处理单元数，增量为 4。您至少可以具有 24 个 DPU。有关更多信息，请参阅 了解 DPU。

    注意

    您可以随时向现有容量预留添加 DPU。但是，在创建预留或向其添加 DPU 后的 1 小时内，无法减少 DPU 数。

  6. （可选）对于标签，选择移除移除标签，或选择添加新标签添加新标签。

  7. 选择提交。预留的详细信息页面将显示更新后的配置。

向预留添加工作组

在创建容量预留后，最多可以向预留添加 20 个工作组。向预留添加工作组即会告知 Athena 应对预留容量执行的查询。来自与预留无关的工作组的查询将继续使用默认的每 TB 扫描定价模型运行。

当预留具有两个或多个工作组时，来自这些工作组的查询可以使用预留容量。您可以随时添加和移除工作组。在添加或移除工作组时，正在运行的查询不会中断。

当您的预留处于待处理状态时，来自您添加的工作组的查询将继续使用默认每 TB 扫描定价模型运行，直到预留变为活动状态为止。

向容量预留添加一个或多个工作组

  1. 在容量预留的详细信息页面中，选择添加工作组。

  2. 在添加工作组页面中，选择要添加的工作组，然后选择添加工作组。无法将一个或多个工作组分配给预留。

    容量预留的详细信息页面列出了已添加的工作组。在这些工作组中运行的查询将在预留处于活动状态时使用预留的容量。

从预留中移除工作组

如果您不再需要工作组的专用容量或想要将工作组移至其自己的预留，则可以随时移除该工作组。将工作组从预留中移除这一过程很简单。在从预留中移除工作组后，已移除工作组中的查询默认为使用按需（非预置）容量，并根据扫描的 TB 进行计费。

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

  1. 在容量预留的详细信息页面中，选择要移除的工作组。

  2. 选择移除工作组。是否移除工作组？提示会通知您在将工作组从预留中移除之前将完成所有当前处于活动状态的查询。

  3. 选择移除。容量预留的详细信息页面将不再显示已移除工作组。

取消容量预留

如果您不再需要容量预留，则可以将其取消。允许正在使用预留的工作组中仍在运行的查询完成，但工作组中的其他查询将不再使用该预留。

注意

无法保证已取消容量在未来可以重新预留。容量无法转移到另一个预留 Amazon Web Services 账户 或 Amazon Web Services 区域。

取消容量预留

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

  2. 如果控制台导航窗格不可见，请选择左侧的扩展菜单。

  3. 选择管理、容量预留。

  4. 在容量预留列表中，执行以下操作之一：

    • 选择预留旁的按钮，然后选择取消。

    • 选择预留链接，然后选择创建容量预留。

  5. 在是否取消容量预订？提示，输入取消，然后选择取消容量预留。

    预订状态将更改为正在取消，并显示一个进度横幅，通知您正在进行取消。

    在取消完成后，容量预留仍存在，但其状态显示为已取消。将在取消 45 天后删除该预留。在 45 天内，您不能重新利用或重复使用已取消预留，但是可以引用其标签并查看该预留以供历史参考。

删除容量预留

如果要移除所有对已取消容量预留的引用，可以删除该预留。必须取消预留，然后才能将其删除。已删除预留将立即从您的账户中移除，且无法再进行引用，包括其 ARN。

删除容量预留

  1. 从 https://console.aws.amazon.com/athena/ 打开 Athena 控制台。

  2. 如果控制台导航窗格不可见，请选择左侧的扩展菜单。

  3. 选择管理、容量预留。

  4. 在容量预留列表中，执行以下操作之一：

    • 选择已取消预留旁的按钮，然后选择操作、删除。

    • 选择预留链接，然后选择删除。

  5. 在是否删除容量预留？提示时，选择删除。

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