Gerenciar reservas

Visualize e gerencie suas reservas de capacidade na página Reservas de capacidade. Você pode realizar tarefas de gerenciamento, como adicionar ou reduzir DPUs, modificar atribuições de grupos de trabalho e etiquetar ou cancelar reservas.

Para visualizar e gerenciar reservas de capacidade

1. Abra o console do Athena em https://console.aws.amazon.com/athena/.

2. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

3. Escolha Administração, Reservas de capacidade.

4. Na página de reserva de capacidade, é possível realizar estas tarefas:

   • Para criar uma reserva de capacidade, escolha Criar reserva de capacidade.

   • Use a caixa de pesquisa para filtrar reservas por nome ou número de DPUs.

   • Escolha o menu suspenso de status para filtrar por status de reserva de capacidade (por exemplo, Ativa ou Cancelada). Para obter informações sobre status de reservas, consulte Noções básicas sobre status de reserva.

   • Para visualizar os detalhes de uma reserva de capacidade, escolha o link da reserva. A página de detalhes da reserva contém opções para editar a capacidade, adicionar grupos de trabalho, remover grupos de trabalho e cancelar a reserva.

   • Para editar uma reserva (por exemplo, adicionar ou remover DPUs), selecione o botão da reserva e escolha Editar.

   • Para cancelar uma reserva, selecione o botão da reserva e escolha Cancelar.

Noções básicas sobre status de reserva

A tabela a seguir descreve os possíveis valores de status de uma reserva de capacidade.

Status	Descrição
Pendente	O Athena está processando sua solicitação de capacidade. A capacidade não está pronta para executar consultas.
Ativo	A capacidade está disponível para executar consultas.
Com falha	A solicitação de capacidade não foi concluída com êxito. O cumprimento das solicitações de capacidade não é garantido. As reservas com falha contam para os limites de DPU da conta. Para liberar o uso, é necessário cancelar a reserva.
Atualização pendente	O Athena está processando uma alteração na reserva. Por exemplo, esse status ocorre depois que você edita a reserva para adicionar ou remover DPUs.
Cancelando	O Athena está processando uma solicitação para cancelar a reserva. As consultas que ainda estiverem em execução nos grupos de trabalho que estavam usando a reserva poderão ser concluídas, mas outras consultas do grupo de trabalho usarão capacidade sob demanda (não provisionada).
Cancelado	O cancelamento da reserva de capacidade foi concluído. As reservas canceladas permanecerão no console por 45 dias. Após 45 dias, o Athena excluirá a reserva. Durante os 45 dias, não será possível reaproveitar ou reutilizar a reserva, mas você poderá consultar as etiquetas e visualizar os detalhes para referência histórica. Não é garantido que a capacidade cancelada será reservada novamente em uma data futura. A capacidade não pode ser transferida para outra reserva, Conta da AWS ou Região da AWS.

Noções básicas sobre DPUs ativas e DPUs de destino

Na lista de reservas de capacidade no console Athena, a reserva exibe dois valores de DPU: DPU ativa e DPU de destino.

• DPU ativa: o número de DPUs que estão disponíveis na reserva para executar consultas. Por exemplo, se você solicitar 100 DPUs e a solicitação for atendida, a DPU ativa exibirá 100.

• DPU de destino: o número de DPUs para as quais a reserva está sendo transferida. A DPU de destino exibe um valor diferente da DPU ativa quando uma reserva está sendo criada ou há um aumento ou uma diminuição no número de DPUs pendente.

Por exemplo, depois que você enviar uma solicitação para criar uma reserva com 24 DPUs, o Status da reserva será Pendente, a DPU ativa será 0 e a DPU de destino será 24.

Se você tiver uma reserva com 100 DPUs e editar a reserva para solicitar um aumento de 20 DPUs, o Status será Atualização pendente, a DPU ativa será 100 e a DPU de destino será 120.

Se você tiver uma reserva com 100 DPUs e editar a reserva para solicitar uma redução de 20 DPUs, o Status será Atualização pendente, a DPU ativa será 100 e a DPU de destino será 80.

Durante essas transições, o Athena trabalha ativamente para adquirir ou reduzir o número de DPUs com base na solicitação. Quando a DPU ativa torna-se igual à DPU de destino, o número de destino foi atingido e não há alterações pendentes.

Para recuperar esses valores de forma programática, você pode chamar a ação da API GetCapacityReservation. A API refere-se à DPU ativa e à DPU de destino como AllocatedDpus e TargetDpus.

Editar reservas de capacidade

Após criar uma reserva de capacidade, você pode ajustar o número de DPUs e adicionar ou remover as etiquetas personalizadas.

Para editar uma reserva de capacidade

1. Abra o console do Athena em https://console.aws.amazon.com/athena/.

2. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

3. Escolha Administração, Reservas de capacidade.

4. Na lista de reservas de capacidade, siga um destes procedimentos:

   • Selecione o botão ao lado da reserva e escolha Editar.

   • Escolha o link da reserva e depois Editar.

5. Em DPU, escolha ou insira o número de unidades de processamento de dados desejada em incrementos de 4. O número mínimo de DPUs que você pode ter é 24. Para ter mais informações, consulte Noções básicas sobre DPUs.

   nota

   Você pode adicionar DPUs a uma reserva de capacidade existente a qualquer momento. Porém, você não pode diminuir o número de DPUs até 1 hora depois de criar a reserva ou adicionar DPUs a ela.

6. Em Etiquetas, selecione Remover para remover uma etiqueta ou escolha Adicionar etiqueta para adicionar uma nova etiqueta.

7. Selecione Enviar. A página de detalhes da reserva mostra a configuração atualizada.

Adicionar grupos de trabalho a uma reserva

Depois de criar uma reserva de capacidade, é possível adicionar até 20 grupos de trabalho à reserva. Adicionar um grupo de trabalho a uma reserva informa ao Athena quais consultas deverão ser executadas na capacidade reservada. As consultas de grupos de trabalho que não estão associados a uma reserva continuam sendo executadas usando o modelo de preço padrão por terabyte (TB) verificado.

Quando uma reserva tem dois ou mais grupos de trabalho, as consultas desses grupos de trabalho podem usar a capacidade da reserva. É possível adicionar e remover grupos de trabalho a qualquer momento. Quando você adicionar ou remover grupos de trabalho, as consultas em execução não serão interrompidas.

Quando a reserva está pendente, as consultas dos grupos de trabalho que você adicionou continuam sendo executadas usando o modelo de preço padrão por terabyte (TB) verificado até que a reserva torne-se ativa.

Para adicionar um ou mais grupos de trabalho à reserva de capacidade

1. Na página de detalhes da reserva de capacidade, escolha Adicionar grupos de trabalho.

2. Na página Adicionar grupos de trabalho, selecione os grupos de trabalho que deseja adicionar e escolha Adicionar grupos de trabalho. Não é possível atribuir um grupo de trabalho a mais de uma reserva.

   A página de detalhes da reserva de capacidade lista os grupos de trabalho que você adicionou. As consultas executadas nesses grupos de trabalho usarão a capacidade que você reservou quando a reserva estiver ativa.

Remover um grupo de trabalho de uma reserva

Caso não precise mais de capacidade dedicada para um grupo de trabalho ou se quiser mover um grupo de trabalho para sua própria reserva, poderá removê-lo a qualquer momento. A remoção de um grupo de trabalho de uma reserva é um processo simples. Depois de remover um grupo de trabalho de uma reserva, as consultas do grupo de trabalho removido usam como padrão a capacidade sob demanda (não provisionada) e são cobradas com base nos terabytes (TB) verificados.

Para remover um ou mais grupos de trabalho de uma reserva

1. Na página de detalhes da reserva de capacidade, selecione os grupos de trabalho que deseja remover.

2. Escolha Remover grupos de trabalho. O prompt Remover grupos de trabalho? informa que todas as consultas ativas no momento serão concluídas antes que o grupo de trabalho seja removido da reserva.

3. Escolha Remover. A página de detalhes da reserva de capacidade mostra que os grupos de trabalho removidos não estão mais presentes.

Cancelar uma reserva de capacidade

Caso não queira mais usar uma reserva de capacidade, você pode cancelá-la. As consultas que ainda estiverem em execução nos grupos de trabalho que estavam usando a reserva poderão ser concluídas, mas outras consultas do grupo de trabalho não usarão mais a reserva.

nota

Não é garantido que a capacidade cancelada será reservada novamente em uma data futura. A capacidade não pode ser transferida para outra reserva, Conta da AWS ou Região da AWS.

Para cancelar uma reserva de capacidade

1. Abra o console do Athena em https://console.aws.amazon.com/athena/.

2. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

3. Escolha Administração, Reservas de capacidade.

4. Na lista de reservas de capacidade, siga um destes procedimentos:

   • Selecione o botão ao lado da reserva e escolha Cancelar.

   • Escolha o link da reserva e escolha Cancelar reserva de capacidade.

5. No prompt Cancelar reserva de capacidade?, insira cancel e escolha Cancelar reserva de capacidade.

   O status da reserva é alterado para Cancelando e um banner de progresso informa que o cancelamento está em andamento.

   Quando o cancelamento for concluído, a reserva de capacidade permanecerá, mas o status será exibido como Cancelada. A reserva será excluída 45 dias após o cancelamento. Durante os 45 dias, não será possível reaproveitar ou reutilizar a reserva que foi cancelada, mas você poderá consultar as etiquetas e visualizá-la para referência histórica.

Excluir uma reserva de capacidade

Se você quiser remover todas as referências a uma reserva de capacidade cancelada, poderá excluir a reserva. Uma reserva deve ser cancelada para poder ser excluída. Uma reserva excluída é imediatamente removida da conta e não pode mais ser referenciada, nem por seu ARN.

Para excluir uma reserva de capacidade

1. Abra o console do Athena em https://console.aws.amazon.com/athena/.

2. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda.

3. Escolha Administração, Reservas de capacidade.

4. Na lista de reservas de capacidade, siga um destes procedimentos:

   • Selecione o botão ao lado da reserva e escolha Ações, Excluir.

   • Escolha o link da reserva e depois Excluir.

5. No prompt Excluir reserva de capacidade?, escolha Excluir.

   Um banner informa que a reserva de capacidade foi excluída com sucesso. A reserva excluída não aparece mais na lista de reservas de capacidade.