# Gerenciar a capacidade de processamento de consulta Você pode usar as reservas de capacidade para obter capacidade dedicada de processamento sem servidor para as consultas que você executa no Athena. Com as reservas de capacidade, você pode aproveitar os recursos de gerenciamento de workloads que ajudam a priorizar, controlar e escalar suas workloads mais importantes. Por exemplo, você pode adicionar capacidade para controlar o número de consultas que poderão ser executadas simultaneamente, escolher quais workloads poderão usar a capacidade e compartilhar a capacidade entre as workloads. A capacidade é sem servidor e totalmente gerenciada pelo Athena, sendo mantida para você pelo tempo que for necessário. A configuração é fácil, e não é necessário alterar suas consultas SQL. Para obter capacidade de processamento para suas consultas, crie uma reserva de capacidade, especifique o número de unidades de processamento de dados (DPUs) necessárias e atribua um ou mais grupos de trabalho à reserva. Os grupos de trabalho têm um papel importante no uso das reservas de capacidade. Os grupos de trabalho permitem organizar consultas em agrupamentos lógicos ou usar casos. Com as reservas de capacidade, atribua seletivamente a capacidade aos grupos de trabalho para controlar como as consultas de cada grupo de trabalho se comportam e como são faturadas. Para obter mais informações sobre grupos de trabalho, consulte [Usar grupos de trabalho para controlar o acesso a consultas e os custos](workgroups-manage-queries-control-costs.md). A atribuição de grupos de trabalho às reservas de capacidade permite que você dê prioridade a essas consultas porque elas são executadas em sua capacidade reservada e não contam para sua cota de consultas DDL e DML. Por exemplo, você pode alocar capacidade para um grupo de trabalho usado para consultas urgentes de relatórios financeiros para isolá-las de consultas menos essenciais em outro grupo de trabalho. Isso proporciona uma execução de consultas previsível para workloads essenciais, permitindo que outras workloads sejam executadas de forma independente. Você pode usar reservas de capacidade e grupos de trabalho juntos para cumprir diferentes requisitos. Estes são alguns dos cenários de exemplo: + **Isolar consultas importantes**: para garantir que uma workload importante tenha a capacidade necessária quando você precisar, crie uma reserva de capacidade e atribua seu grupo de trabalho à reserva. Somente as consultas do grupo de trabalho designado usam a capacidade de processamento da sua reserva. Por exemplo, para garantir a execução confiável de consultas que oferecem suporte a uma aplicação de produção, atribua o grupo de trabalho de produção dessas consultas a uma reserva de capacidade. Ao desenvolver consultas, use um grupo de trabalho separado que não esteja associado a uma reserva e mova as consultas para o grupo de produção quando estiverem prontas. + **Compartilhar capacidade entre workloads semelhantes**: diversas workloads podem compartilhar a capacidade de uma reserva. Isso permite que você obtenha um custo previsível para essas workloads e controle sua simultaneidade. Por exemplo, se você tiver workloads agendadas que tolerem atrasos no início da execução das consultas, é possível atribuir seus grupos de trabalho a uma única reserva. Isso libera sua cota de consultas DDL e DML para consultas interativas executadas na mesma conta, garantindo que essas consultas comecem com o mínimo de atraso. ## Noções básicas de DPUs A capacidade é medida em unidades de processamento de dados (DPUs). As DPUs representam os recursos sem servidor de computação e memória usados pelo Athena para acessar e processar dados para você. Uma DPU normalmente fornece 4 vCPUs e 16 GB de memória. O número de DPUs que você mantém influencia o número de consultas que você pode executar simultaneamente. Por exemplo, uma reserva com 256 DPUs permite aproximadamente duas vezes mais consultas simultâneas do que uma reserva com 128 DPUs. Para obter informações sobre como fazer a estimativa de seus requisitos de capacidade, consulte [Determinar requisitos de capacidade](capacity-management-requirements.md). Para obter informações de preço, consulte [Preços do Amazon Athena](https://aws.amazon.com/athena/pricing/). ## Considerações e limitações + Você pode usar reservas de capacidade e faturamento por consulta, com base nos dados verificados, ao mesmo tempo na mesma conta. + As consultas executadas em reservas de capacidade não contam para sua cota de consultas DDL e DML. + Se sua capacidade estiver ocupada atendendo outras consultas, as consultas recém-enviadas serão enfileiradas até que a capacidade esteja disponível. O tempo máximo permitido na fila é de dez horas. + Um grupo de trabalho pode ser atribuído a apenas uma reserva de capacidade por vez. Você pode atribuir um total de 20 grupos de trabalho a uma única reserva. Quando você atribui vários grupos de trabalho a uma reserva, a capacidade é compartilhada entre os grupos de trabalho e alocada às consultas com base na ordem de envio. Pode haver variação na ordem de execução devido à forma como o Athena aloca dinamicamente a capacidade às consultas. + O Athena aloca automaticamente entre 4 e 124 DPUs para consultas DML com base em sua complexidade. Cada consulta DDL consome 4 DPUs. Para obter mais informações, consulte os seguintes tópicos: + [Determinar requisitos de capacidade](capacity-management-requirements.md) + [Controlar o uso da capacidade](capacity-management-control-capacity-usage.md) + O número mínimo de DPUs necessário com cada reserva de capacidade é 4. Para obter informações de preço, consulte [Preços do Amazon Athena](https://aws.amazon.com/athena/pricing/). + É possível criar até 100 reservas de capacidade com até mil DPUs por conta e por região. Caso precise de mais de mil DPUs para seu caso de uso, entre em contato com [athena-feedback@amazon.com](mailto:athena-feedback@amazon.com?subject=Athena Provisioned Capacity DPU Limit Request). + As solicitações de capacidade não são garantidas e podem levar até 30 minutos para serem concluídas. A capacidade não é transferível para outra reserva de capacidade, Conta da AWS ou Região da AWS. + A métrica do `DPUConsumed` CloudWatch é por grupo de trabalho, não por reserva. Assim, se você mover um grupo de trabalho de uma reserva para outra, a métrica `DPUConsumed` incluirá dados de quando o grupo de trabalho pertencia à primeira reserva. Para obter mais informações sobre o uso de métricas do CloudWatch no Athena, consulte [Monitorar métricas de consultas do Athena com o CloudWatch](query-metrics-viewing.md). + Para excluir um grupo de trabalho que tenha sido atribuído a uma reserva, remova antes o grupo de trabalho da reserva. + Grupos de trabalho configurados para usar o Apache Spark não são compatíveis. + As reservas de capacidade não estão disponíveis nas seguintes Regiões da AWS comerciais: + Israel (Tel Aviv) + Oriente Médio (Emirados Árabes Unidos) + Oriente Médio (Bahrein) + Ásia-Pacífico (Nova Zelândia) **Topics** + [Noções básicas de DPUs](#capacity-management-understanding-dpus) + [Considerações e limitações](#capacity-management-considerations-limitations) + [Determinar requisitos de capacidade](capacity-management-requirements.md) + [Criar reservas de capacidade](capacity-management-creating-capacity-reservations.md) + [Controlar o uso da capacidade](capacity-management-control-capacity-usage.md) + [Ajustar a capacidade reservada](capacity-management-automatically-adjust-capacity.md) + [Gerenciar reservas](capacity-management-managing-reservations.md) + [Políticas do IAM para reservas de capacidade](capacity-reservations-iam-policy.md) + [APIs de reserva de capacidade do Athena](capacity-management-api-list.md) # Determinar requisitos de capacidade Antes de criar uma reserva de capacidade, é possível fazer uma estimativa da capacidade necessária para atribuir a ela o número correto de DPUs. E depois que a reserva estiver em uso, convém verificar se a reserva tem capacidade insuficiente ou excessiva. Este tópico descreve as técnicas que você pode usar para fazer essas estimativas e também descreve algumas ferramentas da AWS para avaliar o uso e o custo. **Topics** + [Estimar a capacidade necessária](#capacity-management-requirements-estimating) + [Sinais da necessidade de mais capacidade](#capacity-management-requirements-insufficient-capacity) + [Verificar a capacidade ociosa](#capacity-management-requirements-idle-capacity) + [Monitoramento do consumo de DPUs](#capacity-management-requirements-monitoring-dpu-consumption) ## Estimar a capacidade necessária Ao estimar os requisitos de capacidade, é útil considerar duas perspectivas: a quantidade de capacidade que uma consulta específica pode exigir e a quantidade de capacidade que você pode precisar em geral. ### Estimar os requisitos de capacidade por consulta Para determinar o número de DPUs que uma consulta pode exigir, é possível usar as seguintes diretrizes: + As consultas DDL consomem 4 DPUs. + As consultas DML normalmente consomem entre 4 e 124 DPUs. O Athena determina o número de DPUs necessárias para uma consulta DML quando a consulta é enviada. O número varia conforme o tamanho dos dados, o formato de armazenamento, a estrutura da consulta e outros fatores. Geralmente, o Athena tenta selecionar o número de DPUs mais baixo e mais eficiente. Se o Athena determinar que é necessário obter mais capacidade computacional para que a consulta seja concluída com êxito, ele aumentará o número de DPUs atribuídas à consulta. ### Estimar os requisitos de capacidade específicos da workload Para determinar a quantidade de capacidade necessária para executar várias consultas ao mesmo tempo, considere as diretrizes gerais na tabela a seguir: **** | Consultas simultâneas | DPUs necessárias | | --- | --- | | 10 | 40 ou mais | | 20 | 96 ou mais | | 30 ou mais | 240 ou mais | O número real de DPUs necessárias depende de suas metas e padrões de análise. Por exemplo, se você quiser que as consultas comecem imediatamente sem filas, determine o pico de demanda simultânea de consultas e provisione o número de DPUs de acordo. Você pode provisionar menos DPUs do que sua demanda de pico, mas o enfileiramento poderá ocorrer quando ocorrer o pico de demanda. Quando ocorre o enfileiramento, o Athena mantém as consultas em uma fila e as executa quando a capacidade torna-se disponível. Se sua meta for executar consultas dentro de um orçamento fixo, você poderá usar a [Calculadora de preços da AWS](https://calculator.aws/#/addService/Athena) para determinar o número de DPUs que cabem em seu orçamento. Por fim, lembre-se de que o tamanho dos dados, o formato de armazenamento e a forma como uma consulta é escrita influenciam as DPUs necessárias para uma consulta. Para aumentar a performance da consulta, é possível compactar ou particionar os dados ou convertê-los para formatos em colunas. Para obter mais informações, consulte [Otimizar a performance do Athena](performance-tuning.md). ## Sinais da necessidade de mais capacidade Mensagens de erro de capacidade insuficiente e enfileiramento de consultas são duas indicações de que a capacidade atribuída é inadequada. Se as consultas falharem com uma mensagem de erro de capacidade insuficiente, o número de DPUs da reserva de capacidade provavelmente será muito baixo para a consulta. Por exemplo, se você tiver uma reserva com 24 DPUs e executar uma consulta que exija mais de 24 DPUs, a consulta falhará. Para monitorar esse erro de consulta, use os [eventos do EventBridge](athena-events.md) do Athena. Tente adicionar mais DPUs e executar a consulta novamente. Se muitas consultas estiverem em fila, significa que a capacidade foi totalmente utilizada por outras consultas. Para reduzir o enfileiramento, realize uma destas ações: + Adicione DPUs à reserva para aumentar a simultaneidade de consultas. + Remova grupos de trabalho da reserva para liberar capacidade para outras consultas. Para verificar se há excesso de filas de consultas, use a [métrica do CloudWatch](query-metrics-viewing.md) de tempo de fila de consultas do Athena para os grupos de trabalho na sua reserva de capacidade. Se o valor estiver acima de seu limite preferencial, você poderá adicionar DPUs à reserva de capacidade. ## Verificar a capacidade ociosa Para verificar a capacidade ociosa, você pode diminuir o número de DPUs na reserva ou aumentar a workload e observar os resultados. **Para verificar a capacidade ociosa** 1. Execute um destes procedimentos: + Reduza o número de DPUs da reserva (reduza os recursos disponíveis) + Adicione grupos de trabalho à reserva (aumente a workload) 1. Use o [CloudWatch](query-metrics-viewing.md) para medir o tempo da fila de consultas. 1. Se o tempo de espera ultrapassar um nível desejável, realize uma destas ações: + Remova grupos de trabalho + Adicione DPUs à reserva de capacidade 1. Após cada alteração, verifique a performance e o tempo da fila de consultas. 1. Continue ajustando a workload ou a contagem de DPUs para atingir o equilíbrio desejado. Caso não queira manter a capacidade fora de um período de tempo preferencial, você pode [cancelar](capacity-management-cancelling-a-capacity-reservation.md) a reserva e criar outra reserva posteriormente. Porém, mesmo que você tenha cancelado recentemente a capacidade de outra reserva, as solicitações de nova capacidade não são garantidas e as novas reservas demoram para serem criadas. ## Monitoramento do consumo de DPUs Depois que suas consultas forem executadas, você poderá visualizar as DPUs consumidas por suas consultas para ajudar a refinar suas estimativas de capacidade. O Athena fornece métricas de consumo de DPU por meio do console, de operações de API e do CloudWatch. Essas informações ajudam a identificar consultas que consomem mais ou menos recursos do que o esperado e a otimizar sua alocação de capacidade com base em dados reais. Para obter informações detalhadas sobre como visualizar e monitorar o consumo de DPUs, consulte [Monitorar o uso de DPU](capacity-management-control-capacity-usage.md#capacity-management-monitor-dpu-usage). ## Ferramentas para avaliar requisitos de capacidade e custo Você pode usar os serviços e recursos da AWS a seguir para medir o uso e os custos do Athena. ### métricas do CloudWatch É possível configurar o Athena para publicar métricas relacionadas a consultas no Amazon CloudWatch no nível do grupo de trabalho. Depois que você habilitar as métricas para o grupo de trabalho, as métricas das consultas do grupo de trabalho serão exibidas no console do Athena na página de detalhes do grupo de trabalho. Para obter informações sobre as métricas do Athena publicadas no CloudWatch e suas dimensões, consulte [Monitorar métricas de consultas do Athena com o CloudWatch](query-metrics-viewing.md). ### Métricas de uso do CloudWatch Você pode usar as métricas de uso do CloudWatch para fornecer visibilidade de como a conta usa os recursos, exibindo o uso do serviço atual nos gráficos e painéis do CloudWatch. Para o Athena, as métricas de disponibilidade para uso correspondem às [cotas de serviço](service-limits.md) da AWS para o Athena. Também é possível configurar alarmes que alertem você quando o uso se aproximar de uma cota de serviço. Para obter mais informações, consulte [Monitorar métricas de uso do Athena com o CloudWatch](monitoring-athena-usage-metrics.md). ### Eventos do Amazon EventBridge Você pode usar o Amazon Athena com o Amazon EventBridge para receber notificações em tempo real sobre o estado das consultas. Quando o estado de uma consulta enviada é alterado, o Athena publica um evento no EventBridge que contém informações sobre a transição de estado da consulta. É possível gravar regras simples para eventos do seu interesse e realizar ações automatizadas quando um evento corresponder a uma regra. Para obter mais informações, consulte os recursos a seguir. + [Monitorar eventos de consulta do Athena com o EventBridge](athena-events.md) + [O que é o Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) + [Eventos do Amazon EventBridge](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html) ### Tags No Athena, as reservas de capacidade são compatíveis com etiquetas. Uma etiqueta consiste em uma chave e um valor. Para rastrear seus custos no Athena, você pode usar etiquetas de alocação de custos geradas pela AWS. A AWS utiliza as etiquetas de alocação de custos para organizar os custos de recursos em seu [Relatório de Custos e Uso](https://docs.aws.amazon.com/cur/latest/userguide/what-is-cur.html). Isso facilita a categorização e o controle de seus custos na AWS. Para ativar as etiquetas de alocação de custos para o Athena, use o [console do Gerenciamento de Faturamento e Custos da AWS](https://console.aws.amazon.com/billing/). Para obter mais informações, consulte os recursos a seguir. + [Marcar recursos do Athena com tags](tags.md) + [Como ativar as etiquetas de alocação de custos geradas pela AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/activate-built-in-tags.html) + [Usar etiquetas de alocação de custos da AWS](https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html) # Criar reservas de capacidade Para começar, crie uma reserva de capacidade com o número de DPUs necessárias e atribua um ou mais grupos de trabalho que usarão essa capacidade nas consultas. É possível ajustar sua capacidade posteriormente, conforme necessário, para fornecer uma performance mais consistente ou gerenciar melhor os custos. Para obter informações sobre como fazer a estimativa de seus requisitos de capacidade, consulte [Determinar requisitos de capacidade](capacity-management-requirements.md). **Importante** As solicitações de capacidade não são garantidas e podem levar até 30 minutos para serem concluídas. **Para criar uma reserva de capacidade** 1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda. 1. Escolha **Administração**, **Reservas de capacidade**. 1. Escolha **Criar reserva de capacidade**. 1. Na página **Criar reserva de capacidade**, em **Nome da reserva de capacidade**, insira o nome. O nome deve ser exclusivo, conter de 1 a 128 caracteres e usar apenas os seguintes caracteres: A-Z, 0-9, \$1 (sublinhado), . (ponto) e - (hífen). Não é possível alterar o nome depois de criar a reserva. 1. Em **DPU**, escolha ou insira o número de unidades de processamento de dados (DPUs) que deseja em incrementos de 4. Para obter mais informações, consulte [Noções básicas de DPUs](capacity-management.md#capacity-management-understanding-dpus). 1. (Opcional) Expanda a opção **Etiquetas** e escolha **Adicionar nova etiqueta** para adicionar um ou mais pares de chave/valor personalizados para associar ao recurso de reserva de capacidade. Para obter mais informações, consulte [Marcar recursos do Athena com tags](tags.md). 1. Escolha **Revisar**. 1. No prompt **Confirmar criação de reserva de capacidade**, confirme o número de DPUs, a Região da AWS e outras informações. Se você aceitar, escolha **Enviar**. Na página de detalhes, o **Status** da reserva de capacidade é exibido como **Pendente**. Quando sua capacidade de reserva estiver disponível para executar consultas, o status será exibido como **Ativa**. Neste ponto, você está pronto para adicionar um ou mais grupos de trabalho à reserva. Para obter as etapas, consulte [Adicionar grupos de trabalho a uma reserva](capacity-management-adding-workgroups-to-a-reservation.md). # Controlar o uso da capacidade Você pode controlar o número de DPUs que o Athena aloca para suas consultas definindo controles de DPU máximo ou mínimo. Você pode configurá-los no nível do grupo de trabalho para estabelecer controles de linha de base para todas as consultas, ou no nível de consulta individual para um controle refinado. Isso lhe dá controle direto sobre a performance da consulta, a simultaneidade das workloads e os custos. + Quando você define um número máximo de DPUs, as consultas são impedidas de consumir mais capacidade do que você especifica. Isso simplifica o controle de custos e a simultaneidade das workloads. Por exemplo, se sua reserva de capacidade tiver 200 DPU, definir a DPU máxima por consulta como 8 permitirá que você execute 25 consultas simultaneamente. Se você aumentar sua reserva para 400 DPUs, poderá executar 50 consultas simultaneamente. + Ao definir um número mínimo de DPU, você garante que as consultas sejam executadas com o número mínimo desejado de DPUs. Isso é útil quando você sabe com antecedência o perfil típico de uso da capacidade das suas consultas. **nota** Os controles de uso de DPUs se aplicam somente às consultas executadas com reservas de capacidade. **nota** Para usar o mesmo número de DPUs para todas as consultas, use o mesmo valor para a DPU mínima e máxima. ## Definir controles de DPU no nível do grupo de trabalho Defina controles de DPU no nível do grupo de trabalho para gerenciar os custos e controlar a performance das workloads para o grupo de trabalho que você escolher. Os controles de DPU definidos no nível do grupo de trabalho se aplicam a todas as consultas quando a opção **Substituir as configurações do lado do cliente** está habilitada. **Para definir os controles de DPU usando o console** 1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. No painel de navegação, escolha **Global networks** (Redes globais). 1. Selecione um grupo de trabalho que use uma reserva de capacidade. 1. Na guia **Controles de execução**, escolha **Editar controles**. 1. Configure o seguinte: + Em **DPU mínimo por consulta**, insira um valor entre 4 e 124 em incrementos de 4. + Em **DPU máximo por consulta**, insira um valor entre 4 e 124 em incrementos de 4. 1. Escolha **Salvar**. 1. (Opcional) Selecione **Substituir as configurações do lado do cliente** para aplicar essas configurações e ignorar as configurações de DPU no nível de consulta. **Para definir controles de DPU usando a AWS CLI** + Use o comando `update-work-group` para definir controles de DPU para um grupo de trabalho: ``` aws athena update-work-group \ --work-group my_workgroup \ --configuration-updates '{ "EngineConfiguration": { "Classifications": [ { "Name": "athena-query-engine-properties", "Properties": { "max-dpu-count" : "24", "min-dpu-count" : "12" } } ] }}' ``` Se você definir `EnforceWorkGroupConfiguration` como `true`, as configurações do grupo de trabalho substituirão quaisquer controles de DPU especificados no nível da consulta quando enviados via [StartQueryExecution](https://docs.aws.amazon.com/athena/latest/APIReference/API_StartQueryExecution.html). Isso garante uma alocação consistente de recursos em todas as consultas no grupo de trabalho. ## Definir controles de DPU com consultas individuais Defina controles de DPU no nível de consulta quando precisar de um controle refinado com consultas que tenham requisitos de recursos diferentes. Os controles de DPU no nível da consulta têm precedência sobre as configurações no nível do grupo de trabalho, a menos que o grupo de trabalho tenha a opção **Substituir as configurações do lado do cliente** habilitada. **Para definir controles de DPU para uma consulta usando o console** 1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. No painel de navegação, selecione **Query editor (Editor de consultas)**. 1. Selecione um grupo de trabalho que use uma reserva de capacidade. 1. Escolha a guia **Configurações da consulta**. 1. Na seção **Controles de execução**, escolha **Editar controles**. 1. Configure o seguinte: + Em **DPU mínimo por consulta**, insira um valor entre 4 e 124 em incrementos de 4. + Em **DPU máximo por consulta**, insira um valor entre 4 e 124 em incrementos de 4. 1. Escolha **Salvar**. **Para definir controles de DPU para uma consulta usando a AWS CLI** + Use o comando `start-query-execution` com o parâmetro `engine-configuration`: ``` aws athena start-query-execution \ --query-string "SELECT * FROM my_table LIMIT 10" \ --work-group "my_workgroup" \ --engine-configuration '{ "Classifications": [ { "Name": "athena-query-engine-properties", "Properties": { "max-dpu-count" : "32", "min-dpu-count" : "8" } } ]}' ``` A relação entre as configurações de DPU no nível da consulta e no nível do grupo de trabalho depende da configuração do seu grupo de trabalho: + Quando a opção **Substituir as configurações do lado do cliente** está habilitada, os controles de DPU no nível do grupo de trabalho têm precedência sobre qualquer configuração no nível da consulta. Isso garante o uso consistente dos recursos para todas as consultas no grupo de trabalho especificado. + Quando a opção **Substituir as configurações do lado do cliente** não está habilitada, os controles de DPU no nível da consulta têm precedência sobre as configurações no nível do grupo de trabalho. Isso oferece flexibilidade para otimizar as consultas individuais. Se você não especificar controles de DPU em nenhum dos níveis, o Athena alocará automaticamente a capacidade com base na complexidade da consulta. **nota** Para consultas DDL, o valor máximo para o mínimo de DPU é 4. Definir um mínimo mais alto para consultas DDL resulta em erro. ## Monitorar o uso de DPU Após as consultas serem concluídas, você pode visualizar seu uso de DPUs. O Athena fornece métricas de uso de DPU por meio do console, de operações de API e do CloudWatch. **Para ver o consumo de DPUs no console** 1. Abra o console do Athena em [https://console.aws.amazon.com/athena/](https://console.aws.amazon.com/athena/home). 1. No painel de navegação, selecione **Query editor (Editor de consultas)**. 1. Depois que uma consulta for concluída, visualize seu valor de **DPU consumido** no contêiner de resultados da consulta. 1. Para ver o consumo de DPU de consultas anteriores: 1. No painel de navegação, escolha **Consultas recentes**. 1. Selecione o ícone de configurações para adicionar a coluna **DPUs consumidas** à tabela, caso ainda não esteja exibida. 1. Analise o consumo de DPUs para cada consulta concluída. 1. Opcionalmente, no **Editor de consultas**, escolha a guia **Estatísticas da consulta** e revise as **DPUs consumidas**. **Para recuperar o consumo de DPU usando a API** 1. Use as seguintes operações de API para recuperar o consumo de DPU de forma programática: + `GetQueryExecution`: retorna detalhes da execução de uma consulta específica + `BatchGetQueryExecution`: retorna detalhes da execução de várias consultas 1. Exemplo: usando a AWS CLI: ``` aws athena get-query-execution \ --query-execution-id "123e4567-e89b-12d3-a456-426614174000" ``` A resposta inclui o campo `DpuCount` no objeto `Statistics`: ``` { "QueryExecution": { "Statistics": { "DpuCount": 8 } } } ``` **Para monitorar o uso de DPU com o CloudWatch** + O Athena publica métricas relacionadas a consultas no CloudWatch que ajudam você a monitorar a utilização da capacidade e outros dados de performance. Para saber mais, consulte [Monitorar métricas de consultas do Athena com o CloudWatch](query-metrics-viewing.md). # Ajustar a capacidade reservada Você pode ajustar automaticamente a capacidade da sua reserva em resposta à utilização das workloads usando a solução de ajuste de escala automático do Athena. Ele adiciona capacidade automaticamente quando a utilização excede o limite configurado e remove a capacidade durante períodos de baixa utilização para reduzir custos. Você pode personalizar seu comportamento definindo diferentes limites de utilização, quantidades mínimas e máximas de DPU, incrementos de escalabilidade e frequência de avaliação de utilização. Isso elimina os ajustes manuais de capacidade e ajuda você a equilibrar os requisitos de performance com a otimização de custos. Você implanta essa solução sem servidor usando um modelo do CloudFormation. Ele cria uma máquina de estado do Step Functions que monitora as métricas de utilização e toma decisões de escalabilidade. Você pode personalizar ainda mais o modelo ou a máquina de estado para atender às suas necessidades específicas. Para começar, use o console do Athena e escolha **Configurar o ajuste de escala automático** na página de detalhes da reserva de capacidade, que redireciona você para o CloudFormation com o modelo pré-carregado. Como alternativa, siga o procedimento abaixo. ## Pré-requisitos + É necessária uma reserva de capacidade ativa + Permissões do IAM necessárias para implantar pilhas do CloudFormation e criar recursos do Step Functions ## Iniciar a pilha do CloudFormation Esse modelo automatizado do CloudFormation implanta a solução de ajuste de escala automático da reserva de capacidade do Athena. Você deve concluir as etapas aplicáveis em [Pré-requisitos](#capacity-management-auto-scaling-prerequisites) antes de iniciar a pilha. [https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?&templateURL=https:%2F%2Fathena-downloads.s3.us-east-1.amazonaws.com%2F%2Ftemplates%2F%2Fcapacity-reservation-scaling%2F%2Fstate-machine%2F%2Fathena-capacity-reservation-scaling-template-v1.1.yaml](https://console.aws.amazon.com/cloudformation/home?region=us-east-1#/stacks/new?&templateURL=https:%2F%2Fathena-downloads.s3.us-east-1.amazonaws.com%2F%2Ftemplates%2F%2Fcapacity-reservation-scaling%2F%2Fstate-machine%2F%2Fathena-capacity-reservation-scaling-template-v1.1.yaml) **Para iniciar a solução de ajuste de escala automático** 1. Faça login no [Console de Gerenciamento da AWS](https://console.aws.amazon.com/) e selecione o botão para iniciar o modelo `AWSAccelerator-InstallerStack` do CloudFormation. 1. O modelo é iniciado na região Leste dos EUA (Norte da Virgínia) por padrão. Para iniciar a solução em outra Região da AWS, use o seletor de região na barra de navegação do console. 1. Na página **Criar pilha**, verifique se o URL do modelo está na caixa de texto **URL do Amazon S3** e escolha **Avançar**. 1. Na página **Especificar detalhes da pilha**, atribua um nome para a sua pilha de soluções. 1. Em **Parâmetros**, revise os parâmetros do modelo dessa solução e modifique-os conforme requerido. Esta solução usa os seguintes valores padrão. **** [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/pt_br/athena/latest/ug/capacity-management-automatically-adjust-capacity.html) **nota** Todos os valores de DPU devem ser múltiplos de 4 para atender aos requisitos de reserva de capacidade do Athena. 1. Escolha **Avançar**. 1. Na página **Configurar opções de pilha**, selecione **Avançar**. 1. Na página **Revisar e criar**, revise e confirme as configurações. Marque a caixa de seleção confirmando que o modelo poderá criar recursos do IAM. 1. Escolha **Enviar** para implantar a pilha. Você pode visualizar o status da pilha no console do CloudFormation, na coluna **Status**. Você receberá o status `CREATE_COMPLETE` em poucos minutos. # 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/](https://console.aws.amazon.com/athena/home). 1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda. 1. Escolha **Administração**, **Reservas de capacidade**. 1. 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 de status de reserva](#capacity-management-understanding-reservation-status). + 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](capacity-management-editing-capacity-reservations.md), [adicionar grupos de trabalho](capacity-management-adding-workgroups-to-a-reservation.md), [remover grupos de trabalho](capacity-management-removing-a-workgroup-from-a-reservation.md) e [cancelar](capacity-management-cancelling-a-capacity-reservation.md) 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 de 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. | | Failed | 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 de 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](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html). A API refere-se à **DPU ativa** e à **DPU de destino** como `AllocatedDpus` e `TargetDpus`. **Topics** + [Noções básicas de status de reserva](#capacity-management-understanding-reservation-status) + [Noções básicas de DPUs ativas e DPUs de destino](#capacity-management-understanding-dpu-status) + [Editar reservas de capacidade](capacity-management-editing-capacity-reservations.md) + [Adicionar grupos de trabalho a uma reserva](capacity-management-adding-workgroups-to-a-reservation.md) + [Remover um grupo de trabalho de uma reserva](capacity-management-removing-a-workgroup-from-a-reservation.md) + [Cancelar uma reserva de capacidade](capacity-management-cancelling-a-capacity-reservation.md) + [Excluir uma reserva de capacidade](capacity-management-deleting-a-capacity-reservation.md) # 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/](https://console.aws.amazon.com/athena/home). 1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda. 1. Escolha **Administração**, **Reservas de capacidade**. 1. 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**. 1. Em **DPU**, escolha ou insira o número de unidades de processamento de dados desejada. Para obter mais informações, consulte [Noções básicas de DPUs](capacity-management.md#capacity-management-understanding-dpus). **nota** Você pode solicitar a adição de DPUs a uma reserva de capacidade ativa a qualquer momento. Você pode solicitar a redução das DPUs de uma reserva de capacidade ativa quando tiver decorrido 1 minuto desde que a reserva se tornou ativa ou desde que as DPUs foram adicionadas pela última vez. Quando você solicita a redução de DPUs, o Athena prioriza a remoção de DPUs ociosas em vez de DPUs ativas. Se as consultas estiverem consumindo DPUs marcadas para remoção, o Athena aguarda a conclusão das consultas antes de remover as DPUs. 1. Em **Etiquetas**, selecione **Remover** para remover uma etiqueta ou escolha **Adicionar etiqueta** para adicionar uma nova etiqueta. 1. 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**. 1. 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 e são faturadas 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. 1. 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. 1. 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/](https://console.aws.amazon.com/athena/home). 1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda. 1. Escolha **Administração**, **Reservas de capacidade**. 1. 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**. 1. 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/](https://console.aws.amazon.com/athena/home). 1. Se o painel de navegação do console não estiver visível, escolha o menu de expansão à esquerda. 1. Escolha **Administração**, **Reservas de capacidade**. 1. 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**. 1. 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. # Políticas do IAM para reservas de capacidade Para controlar o acesso a reservas de capacidade, use permissões do IAM no nível do recurso ou políticas do IAM baseadas em identidade. Sempre que você usar as políticas do IAM, siga as práticas recomendadas do IAM. Para obter mais informações, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*. O procedimento a seguir é específico ao Athena. Para obter informações específicas do IAM, acesse os links listados no fim desta seção. Para obter informações sobre exemplos de políticas de reservas de capacidade do JSON, consulte [Exemplo de políticas de reserva de capacidade](example-policies-capacity-reservations.md). **Para usar o editor visual no console do IAM para criar uma política de reserva de capacidade** 1. Faça login no Console de gerenciamento da AWS e abra o console do IAM em [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/). 1. No painel de navegação à esquerda, escolha **Policies (Políticas)** e **Create policy (Criar política)**. 1. Na guia **Editor visual**, selecione **Escolher um serviço**. Em seguida, escolha o Athena para adicionar à política. 1. Escolha **Select actions (Selecionar ações)** e defina as ações para adicionar à política. O editor visual mostra as ações disponíveis no Athena. Para obter mais informações, consulte [Ações, recursos e chaves de condição do Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html) na *Referência de autorização do serviço*. 1. Escolha **adicionar ações** para digitar uma ação específica ou use caracteres curinga (\$1) para especificar várias ações. Por padrão, a política que você está criando permite as ações que você escolhe. Se você escolher uma ou mais ações compatíveis com as permissões no nível do recurso `capacity-reservation` no Athena, o editor listará o recurso `capacity-reservation`. 1. Escolha **Recursos** para especificar as reservas de capacidade específicas de sua política. Para obter exemplos de políticas de reserva de capacidade do JSON, consulte [Exemplo de políticas de reserva de capacidade](example-policies-capacity-reservations.md). 1. Especifique o recurso `capacity-reservation` da seguinte forma: ``` arn:aws:athena:::capacity-reservation/ ``` 1. Selecione **Review Policy (Revisar política)**, digite um **Name (Nome)** e uma **Description (Descrição)** (opcional) para a política que você está criando. Revise o resumo da política para ter certeza de que você concedeu as permissões que pretendia. 1. Escolha **Criar política** para salvar sua nova política. 1. Anexe essa política baseada em política a um usuário, um grupo ou uma função. Para obter mais informações, consulte os seguintes tópicos na *Referência de autorização do serviço* e no *Manual do usuário do IAM*: + [Ações, recursos e chaves de condição do Amazon Athena](https://docs.aws.amazon.com/service-authorization/latest/reference/list_amazonathena.html) + [Criar políticas com o editor visual](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor) + [Adicionar e remover políticas do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) + [Controlar o acesso aos recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_controlling.html#access_controlling-resources) Para obter exemplos de políticas de reserva de capacidade do JSON, consulte [Exemplo de políticas de reserva de capacidade](example-policies-capacity-reservations.md). Para obter uma lista completa de ações do Amazon Athena, consulte os nomes das ações de API na [Referência de API do Amazon Athena](https://docs.aws.amazon.com/athena/latest/APIReference/). # Exemplo de políticas de reserva de capacidade Esta seção inclui exemplos de políticas que você pode usar para habilitar várias ações nas reservas de capacidade. Sempre que você usar as políticas do IAM, siga as práticas recomendadas do IAM. Para obter mais informações, consulte [Práticas recomendadas de segurança no IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/best-practices.html) no *Guia do usuário do IAM*. A reserva de capacidade é um recurso do IAM gerenciado pelo Athena. Portanto, se sua política de reserva de capacidade utiliza ações que usam `capacity-reservation` como entrada, especifique o ARN da reserva de capacidade da seguinte maneira: ``` "Resource": [arn:aws:athena:::capacity-reservation/] ``` Em que `` é o nome da reserva de capacidade. Por exemplo, para uma reserva de capacidade denominada `test_capacity_reservation`, especifique-a como recurso da seguinte forma: ``` "Resource": ["arn:aws:athena:us-east-1:123456789012:capacity-reservation/test_capacity_reservation"] ``` Para obter uma lista completa de ações do Amazon Athena, consulte os nomes das ações de API na [Referência de API do Amazon Athena](https://docs.aws.amazon.com/athena/latest/APIReference/). Para obter mais informações sobre as políticas do IAM, consulte [Criar políticas com o editor visual](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html#access_policies_create-visual-editor) no *Guia do usuário do IAM*. **Example Exemplo de política para listar reservas de capacidade** A política a seguir permite que todos os usuários listem todas as reservas de capacidade. **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "athena:ListCapacityReservations" ], "Resource": "*" } ] } ``` **Example Exemplo de política para operações de gerenciamento** A política a seguir permite que o usuário crie, cancele, obtenha detalhes e atualize a reserva de capacidade `test_capacity_reservation`. A política também permite que o usuário atribua `workgroupA` e `workgroupB` a `test_capacity_reservation`. **** ``` { "Version":"2012-10-17", "Statement":[ { "Effect": "Allow", "Action": [ "athena:CreateCapacityReservation", "athena:GetCapacityReservation", "athena:CancelCapacityReservation", "athena:UpdateCapacityReservation", "athena:GetCapacityAssignmentConfiguration", "athena:PutCapacityAssignmentConfiguration" ], "Resource": [ "arn:aws:athena:us-east-1:123456789012:capacity-reservation/test_capacity_reservation", "arn:aws:athena:us-east-1:123456789012:workgroup/workgroupA", "arn:aws:athena:us-east-1:123456789012:workgroup/workgroupB" ] } ] } ``` # APIs de reserva de capacidade do Athena A lista a seguir contém links de referência para as ações de API de reserva de capacidade do Athena. Para obter estruturas de dados e outras ações de API do Athena, consulte [https://docs.aws.amazon.com/athena/latest/APIReference/](https://docs.aws.amazon.com/athena/latest/APIReference/) (Referência para APIs do Amazon Athena). + [CancelCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_CancelCapacityReservation.html) + [CreateCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_CreateCapacityReservation.html) + [DeleteCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_DeleteCapacityReservation.html) + [GetCapacityAssignmentConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityAssignmentConfiguration.html) + [GetCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_GetCapacityReservation.html) + [ListCapacityReservations](https://docs.aws.amazon.com/athena/latest/APIReference/API_ListCapacityReservations.html) + [PutCapacityAssignmentConfiguration](https://docs.aws.amazon.com/athena/latest/APIReference/API_PutCapacityAssignmentConfiguration.html) + [UpdateCapacityReservation](https://docs.aws.amazon.com/athena/latest/APIReference/API_UpdateCapacityReservation.html)