# 예약 관리
<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**와 다른 값이 표시됩니다.

예를 들어 DPU가 24개인 예약을 생성하는 요청을 제출하면 예약 **상태**는 **대기 중**, **활성 DPU**는 **0**, **대상 DPU**는 **24**로 표시됩니다.

DPU가 100개인 예약에서 예약을 편집하여 DPU를 20개로 늘리도록 요청하는 경우 **상태**는 **업데이트 대기 중**, **활성 DPU**는 **100**, **대상 DPU**는 **120**으로 표시됩니다.

DPU가 100개인 예약에서 예약을 편집하여 DPU를 20개로 줄이도록 요청하는 경우 **상태**는 **업데이트 대기 중**, **활성 DPU**는 **100**, **대상 DPU**는 **80**으로 표시됩니다.

이러한 전환 중에 Athena는 사용자 요청에 따라 DPU 수를 확보하거나 줄이기 위해 적극적으로 노력합니다. **활성 DPU**가 **대상 DPU**와 같아지면 대상 수에 도달한 것이며 대기 중인 변경 사항은 없습니다.

이러한 값을 프로그래밍 방식으로 검색하기 위해 [GetCapacityReserve](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. **용량 예약을 삭제하시겠습니까?** 프롬프트에서 **삭제**를 선택합니다.

   용량 예약이 삭제되었음을 알리는 배너가 나타납니다. 삭제된 예약은 더 이상 용량 예약 목록에 표시되지 않습니다.