Control del uso de la capacidad - Amazon Athena
Configuración de los controles de la DPU a nivel de grupo de trabajoConfiguración de los controles de la DPU con consultas individualesSupervisión del uso de DPU

Control del uso de la capacidad

Para controlar la cantidad de DPU que Athena asigna a sus consultas, puede configurar controles de DPU máximos o mínimos. Puede configurarlos a nivel de grupo de trabajo para establecer controles de referencia para todas las consultas, o a nivel de consulta individual para un control detallado. Esto le proporciona un control directo sobre el rendimiento de las consultas, la simultaneidad de la carga de trabajo y el costo.

  • Al establecer un número máximo de DPU, se evita que las consultas consuman más capacidad de la especificada. Esto facilita el control de la simultaneidad de costos y cargas de trabajo. Por ejemplo, si su reserva de capacidad tiene 200 DPU, si establece el máximo de DPU por consulta en 8, podrá ejecutar 25 consultas simultáneamente. Si aumenta la reserva a 400 DPU, puede ejecutar 50 consultas simultáneamente.

  • Al establecer un número mínimo de DPU, se asegura de que las consultas se ejecuten con el número mínimo de DPU deseado. Esto resulta útil si se conoce de antemano el perfil de uso de la capacidad típico de las consultas.

nota

Los controles de uso de la DPU solo se aplican a las consultas ejecutadas con reservas de capacidad.

nota

Para usar la misma cantidad de DPU para todas las consultas, use el mismo valor para la DPU mínima y máxima.

Configuración de los controles de la DPU a nivel de grupo de trabajo

Configure los controles de la DPU a nivel de grupo de trabajo para administrar los costos y controlar el rendimiento de la carga de trabajo del grupo de trabajo que elija. Los controles de la DPU configurados a nivel de grupo de trabajo se aplican a todas las consultas cuando está habilitada la opción Anular la configuración del lado del cliente.

Configuración de los controles de DPU mediante la consola

  1. Abra la consola de Athena en https://console.aws.amazon.com/athena/.

  2. En el panel de navegación, elija Workgroups (Redes globales).

  3. Seleccione un grupo de trabajo que utilice una reserva de capacidad.

  4. En la pestaña Controles de ejecución, elija Editar controles.

  5. Configura lo siguiente:

    • En el caso de la DPU mínima por consulta, introduzca un valor entre 4 y 124 en incrementos de 4.

    • En el caso de la DPU máxima por consulta, introduzca un valor entre 4 y 124 en incrementos de 4.

  6. Seleccione Save.

  7. (Opcional) Seleccione Anular la configuración del cliente para aplicar esta configuración e ignorar las configuraciones de DPU a nivel de consulta.

Configuración de los controles de DPU mediante la AWS CLI

  • Utilice el comando update-work-group para configurar los controles de la DPU para un grupo de trabajo:

    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"
                        }
                    }
                ]
        }}'

    Si establece EnforceWorkGroupConfiguration en true, la configuración del grupo de trabajo anulará cualquier control de DPU especificado en el nivel de consulta cuando se envíe mediante StartQueryExecution. Esto garantiza una asignación coherente de recursos en todas las consultas del grupo de trabajo.

Configuración de los controles de la DPU con consultas individuales

Establezca controles de DPU a nivel de consulta cuando necesite un control detallado con consultas que tengan diferentes requisitos de recursos. Los controles de la DPU a nivel de consulta tienen prioridad sobre la configuración a nivel de grupo de trabajo, a menos que el grupo de trabajo tenga habilitada la opción Anular la configuración del cliente.

Configuración de los controles de DPU para una consulta mediante la consola

  1. Abra la consola de Athena en https://console.aws.amazon.com/athena/.

  2. En el panel de navegación, seleccione Query Editor (Editor de consultas).

  3. Seleccione un grupo de trabajo que utilice una reserva de capacidad.

  4. Seleccione la pestaña de configuración de consultas.

  5. En la sección Controles de ejecución, elija Editar controles.

  6. Configura lo siguiente:

    • En el caso de la DPU mínima por consulta, introduzca un valor entre 4 y 124 en incrementos de 4.

    • En el caso de la DPU máxima por consulta, introduzca un valor entre 4 y 124 en incrementos de 4.

  7. Seleccione Save.

Configuración de los controles de DPU para una consulta mediante la AWS CLI

  • Utilice el comando start-query-execution con el 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"
                }
            }
        ]}'

La relación entre la configuración de la DPU a nivel de consulta y a nivel de grupo de trabajo depende de la configuración del grupo de trabajo:

  • Cuando la opción Anular la configuración del cliente está habilitada, los controles de la DPU a nivel de grupo de trabajo tienen prioridad sobre cualquier configuración a nivel de consulta. Esto garantiza un uso coherente de recursos en todas las consultas del grupo de trabajo especificado.

  • Cuando la opción Anular la configuración del cliente no está habilitada, los controles de la DPU a nivel de consulta tienen prioridad sobre la configuración a nivel de grupo de trabajo. Esto ofrece flexibilidad para optimizar las consultas individuales.

Si no especifica los controles de la DPU en ninguno de los niveles, Athena asigna automáticamente la capacidad en función de la complejidad de las consultas.

nota

En el caso de las consultas DDL, el valor máximo para las DPU mínimas es 4. Al configurar una cantidad mínima más alta para las consultas DPU se produce un error.

Supervisión del uso de DPU

Tras completar las consultas, puede ver su uso de DPU. Athena proporciona métricas de uso de DPU a través de la consola, operaciones de API y CloudWatch.

Visualización del consumo de DPU en la consola

  1. Abra la consola de Athena en https://console.aws.amazon.com/athena/.

  2. En el panel de navegación, seleccione Query Editor (Editor de consultas).

  3. Una vez completada la consulta, consulte su valor de DPU consumida en el contenedor de resultados de la consulta.

  4. Visualización del consumo de DPU en consultas anteriores:

    1. Elija Consultas recientes en el panel de navegación.

    2. Seleccione el icono de configuración para añadir la columna DPU consumida a la tabla si aún no se ha mostrado.

    3. Revise el consumo de DPU de cada consulta completada.

  5. Si lo desea, en el editor de consultas, seleccione la pestaña Estadísticas de consultas y revise la DPU consumida.

Recuperación del consumo de DPU mediante la API

  1. Use las siguientes operaciones de la API para recuperar el consumo de DPU mediante programación:

    • GetQueryExecution: devuelve los detalles de ejecución de una consulta específica

    • BatchGetQueryExecution: devuelve los detalles de ejecución de varias consultas

  2. Ejemplo de uso de la AWS CLI:

    aws athena get-query-execution \
  --query-execution-id "123e4567-e89b-12d3-a456-426614174000"

    La respuesta incluye el campo DpuCount del objeto Statistics:

    {
  "QueryExecution": {
    "Statistics": {
      "DpuCount": 8
    }
  }
}
Supervisión del uso de DPU con CloudWatch