Controlar o uso da capacidade - Amazon Athena
Definir controles de DPU no nível do grupo de trabalhoDefinir controles de DPU com consultas individuaisMonitorar o uso de DPU

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/.

  2. No painel de navegação, escolha Global networks (Redes globais).

  3. Selecione um grupo de trabalho que use uma reserva de capacidade.

  4. Na guia Controles de execução, escolha Editar controles.

  5. 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.

  6. Escolha Salvar.

  7. (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. 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/.

  2. No painel de navegação, selecione Query editor (Editor de consultas).

  3. Selecione um grupo de trabalho que use uma reserva de capacidade.

  4. Escolha a guia Configurações da consulta.

  5. Na seção Controles de execução, escolha Editar controles.

  6. 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.

  7. 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/.

  2. No painel de navegação, selecione Query editor (Editor de consultas).

  3. Depois que uma consulta for concluída, visualize seu valor de DPU consumido no contêiner de resultados da consulta.

  4. Para ver o consumo de DPU de consultas anteriores:

    1. No painel de navegação, escolha Consultas recentes.

    2. Selecione o ícone de configurações para adicionar a coluna DPUs consumidas à tabela, caso ainda não esteja exibida.

    3. Analise o consumo de DPUs para cada consulta concluída.

  5. 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

  2. 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