予約の管理
[キャパシティ予約] ページでは、キャパシティ予約を表示および管理できます。DPU の追加や削減、ワークグループ割り当ての変更、予約のタグ付けやキャンセルなどの管理タスクを実行できます。
キャパシティ予約の表示および管理
https://console.aws.amazon.com/athena/
で Athena コンソールを開きます。 -
コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。
-
[管理]、[キャパシティ予約] を選択します。
-
[キャパシティ予約] ページでは、次のタスクを実行できます。
-
キャパシティ予約を作成するには、[キャパシティ予約を作成] を選択します。
-
検索ボックスを使用して、予約を名前または DPU の数でフィルタリングします。
-
ステータスドロップダウンメニューを選択して、キャパシティ予約ステータス ([アクティブ]、[キャンセル済み] など) でフィルタリングします。予約ステータスについては、「予約ステータスについて」を参照してください。
-
キャパシティ予約の詳細を表示するには、予約のリンクを選択します。予約の詳細ページには、[キャパシティの編集]、[ワークグループの追加]、[ワークグループの削除]、[予約のキャンセル] のオプションがあります。
-
予約を編集 (DPU を追加または削除するなど) するには、その予約のボタンを選択し、[編集] を選択します。
-
予約をキャンセルするには、その予約のボタンを選択し、[キャンセル] を選択します。
-
予約ステータスについて
キャパシティ予約の取りうるステータス値は、次の表のとおりです。
ステータス | 説明 |
---|---|
[保留中] | Athena はキャパシティリクエストを処理中です。キャパシティはクエリを実行する準備ができていません。 |
[アクティブ] | クエリを実行するためのキャパシティがあります。 |
[失敗] | キャパシティのリクエストは正常に完了しませんでした。キャパシティの充足は保証されないことに注意してください。予約に失敗した場合、アカウントの DPU 制限にカウントされます。利用状況を解放するには、予約をキャンセルする必要があります。 |
[更新保留中] | Athena は予約の変更を処理中です。たとえば、予約を編集して DPU を追加または削除すると、このステータスが表示されます。 |
[キャンセル中] | Athena は予約のキャンセルリクエストを処理中です。予約を使用していたワークグループでまだ実行中のクエリは完了できますが、ワークグループ内の他のクエリはオンデマンド (プロビジョニングされていない) キャパシティを使用します。 |
キャンセル済み |
キャパシティ予約のキャンセルが完了しました。キャンセルされた予約は、45 日間コンソールに残ります。45 日後、Athena は予約を削除します。この 45 日間は、その予約の編集や再使用はできませんが、過去の参照用に予約のタグを参照したり、詳細を確認したりすることはできます。 キャンセルされたキャパシティが後日再予約可能になる保証はありません。キャパシティを別の予約、AWS アカウント、AWS リージョン に移すことはできません。 |
アクティブ DPU とターゲット DPU について
Athena コンソールのキャパシティ予約のリストで、予約には 2 つの DPU 値 ([アクティブ DPU] と [ターゲット DPU]) が表示されます。
-
[アクティブ DPU] — 予約内でクエリを実行できる DPU の数。たとえば、DPU 100 個をリクエストし、そのリクエストが受理された場合、[アクティブ 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] と等しい時は、目標数に達しており、保留中の変更はありません。
これらの値をプログラムで取得するには、GetCapacityReservation API アクションを呼び出します。API では、[アクティブ DPU] および [ターゲット DPU] をそれぞれ、AllocatedDpus
および TargetDpus
と呼びます。
キャパシティ予約を編集する
キャパシティ予約を作成したら、DPU の数を調整したり、カスタムタグを追加または削除したりできます。
キャパシティ予約を編集するには
https://console.aws.amazon.com/athena/
で Athena コンソールを開きます。 -
コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。
-
[管理]、[キャパシティ予約] を選択します。
-
キャパシティ予約のリストで、次のいずれかを実行します。
-
予約の横にあるボタンを選択し、[編集] を選択します。
-
予約リンクを選択し、[編集] を選択します。
-
-
DPU の場合は、必要なデータ処理ユニットの数を 4 個単位で選択または入力します。設定できる DPU の最小数は 24 個です。詳細については、「DPU について」を参照してください。
注記
DPU は既存のキャパシティ予約にいつでも追加できます。ただし、予約を作成または予約に DPU を追加してから 1 時間後までは DPU 数を減らすことはできません。
-
(オプション) [タグ] で、[削除] を選択してタグを削除するか、[タグの追加] を選択して新しいタグを追加します。
-
[送信] を選択します。予約の詳細ページには、更新された構成が表示されます。
予約へのワークグループの追加
キャパシティ予約を作成すると、予約に最大 20 のワークグループを追加できます。予約にワークグループを追加すると、リザーブドキャパシティでどのクエリを実行すべきかを Athena に伝えます。予約に関連付けられていないワークグループからのクエリは、引き続きテラバイト (TB) ごとのスキャン済みデフォルト価格モデルを使用して実行されます。
予約に 2 つ以上のワークグループがある場合、それらのワークグループからのクエリはリザーブドキャパシティを使用できます。ワークグループの追加と削除は随時行うことができます。ワークグループを追加または削除しても、実行中のクエリは中断されません。
予約が保留中ステータスの場合、追加したワークグループからのクエリは、予約がアクティブになるまで、引き続きテラバイト (TB) ごとのスキャン済みデフォルト価格モデルを使用して実行されます。
キャパシティ予約に 1 つ以上のワークグループを追加するには
-
[キャパシティ予約] の詳細ページで、[ワークグループの追加] を選択します。
-
[ワークグループの追加] ページで、追加するワークグループを選択し、[ワークグループの追加] を選択します。1 つのワークグループを複数の予約に割り当てることはできません。
[キャパシティ予約] の詳細ページに、追加したワークグループが表示されます。これらのワークグループで実行されるクエリは、予約がアクティブなときに、予約したキャパシティを使用します。
予約からワークグループを削除する
ワークグループ専用のキャパシティが不要になった場合や、ワークグループを専用の予約に移動したい場合は、いつでも削除できます。予約からワークグループを削除するプロセスは簡単です。予約からワークグループを削除すると、削除されたワークグループからのクエリはデフォルトでオンデマンド (プロビジョニングされていない) キャパシティを使用するようになり、スキャンされたテラバイト (TB) に基づいて請求されます。
予約から 1 つ以上のワークグループを削除するには
-
キャパシティ予約の詳細ページで、削除するワークグループを選択します。
-
[ワークグループを削除] を選択します。[ワークグループを削除しますか?] のプロンプトが表示され、ワークグループを予約から削除する前に、現在アクティブなクエリがすべて終了することを通知します。
-
[削除] を選択します。キャパシティ予約の詳細ページには、削除されたワークグループがもう存在しないことが表示されます。
キャパシティ予約をキャンセルする
キャパシティ予約が不要になった場合は、キャンセルすることができます。予約を使用していたワークグループでまだ実行中のクエリは完了できますが、ワークグループ内の他のクエリは予約を使用しなくなります。
注記
キャンセルされたキャパシティが後日再予約可能になる保証はありません。キャパシティを別の予約、AWS アカウント、AWS リージョン に移すことはできません。
キャパシティ予約をキャンセルするには
https://console.aws.amazon.com/athena/
で Athena コンソールを開きます。 -
コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。
-
[管理]、[キャパシティ予約] を選択します。
-
キャパシティ予約のリストで、次のいずれかを実行します。
-
予約の横にあるボタンを選択し、[キャンセル] を選択します。
-
[予約リンク] を選択してから、[キャパシティ予約のキャンセル] を選択します。
-
-
[キャパシティ予約をキャンセルしますか?] プロンプトで [キャンセル] を入力し、[キャパシティ予約のキャンセル] を選択します。
予約のステータスが [キャンセル中] に変わり、キャンセルが進行中であることを知らせる進行状況バナーが表示されます。
キャンセルが完了すると、キャパシティ予約はそのまま残りますが、ステータスは [キャンセル済み] と表示されます。予約はキャンセル後 45 日で削除されます。この 45 日間は、キャンセルされた予約を編集したり再利用したりすることはできませんが、タグを参照、表示して、過去の履歴を参照することはできます。
キャパシティ予約の削除
キャンセルされたキャパシティ予約への参照をすべて削除したい場合は、予約を削除できます。予約は削除する前にキャンセルする必要があります。削除された予約はアカウントから直ちに削除され、参照できなくなります (ARN を使用する場合を含む)。
キャパシティ予約を削除するには
https://console.aws.amazon.com/athena/
で Athena コンソールを開きます。 -
コンソールのナビゲーションペインが表示されない場合は、左側の展開メニューをクリックします。
-
[管理]、[キャパシティ予約] を選択します。
-
キャパシティ予約のリストで、次のいずれかを実行します。
-
キャンセルされた予約の横にあるボタンを選択し、[アクション]、[削除] の順に選択します。
-
予約リンクを選択し、[削除] を選択します。
-
-
[キャパシティ予約を削除しますか?] プロンプトが表示されたら、[削除] を選択します。
バナーは、キャパシティ予約が正常に削除されたことを通知します。削除された予約は、キャパシティ予約のリストに表示されなくなります。