# EngineConfiguration


The engine configuration for the workgroup, which includes the minimum/maximum number of Data Processing Units (DPU) that queries should use when running in provisioned capacity. If not specified, Athena uses default values (Default value for min is 4 and for max is Minimum of 124 and allocated DPUs).

To specify DPU values for PC queries the WG containing EngineConfiguration should have the following values: The name of the Classifications should be `athena-query-engine-properties`, with the only allowed properties as `max-dpu-count` and `min-dpu-count`.

## Contents


 ** AdditionalConfigs **   <a name="athena-Type-EngineConfiguration-AdditionalConfigs"></a>
Contains additional notebook engine `MAP<string, string>` parameter mappings in the form of key-value pairs. To specify an Athena notebook that the Jupyter server will download and serve, specify a value for the [StartSession:NotebookVersion](API_StartSession.md#athena-StartSession-request-NotebookVersion) field, and then add a key named `NotebookId` to `AdditionalConfigs` that has the value of the Athena notebook ID.  
Type: String to string map  
Key Length Constraints: Minimum length of 1. Maximum length of 255.  
Key Pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*`   
Value Length Constraints: Maximum length of 51200.  
Required: No

 ** Classifications **   <a name="athena-Type-EngineConfiguration-Classifications"></a>
The configuration classifications that can be specified for the engine.  
Type: Array of [Classification](API_Classification.md) objects  
Required: No

 ** CoordinatorDpuSize **   <a name="athena-Type-EngineConfiguration-CoordinatorDpuSize"></a>
The number of DPUs to use for the coordinator. A coordinator is a special executor that orchestrates processing work and manages other executors in a notebook session. The default is 1.  
Type: Integer  
Valid Range: Fixed value of 1.  
Required: No

 ** DefaultExecutorDpuSize **   <a name="athena-Type-EngineConfiguration-DefaultExecutorDpuSize"></a>
The default number of DPUs to use for executors. An executor is the smallest unit of compute that a notebook session can request from Athena. The default is 1.  
Type: Integer  
Valid Range: Fixed value of 1.  
Required: No

 ** MaxConcurrentDpus **   <a name="athena-Type-EngineConfiguration-MaxConcurrentDpus"></a>
The maximum number of DPUs that can run concurrently.  
Type: Integer  
Valid Range: Minimum value of 2. Maximum value of 5000.  
Required: No

 ** SparkProperties **   <a name="athena-Type-EngineConfiguration-SparkProperties"></a>
Specifies custom jar files and Spark properties for use cases like cluster encryption, table formats, and general Spark tuning.  
Type: String to string map  
Key Length Constraints: Minimum length of 1. Maximum length of 255.  
Key Pattern: `[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\t]*`   
Value Length Constraints: Maximum length of 51200.  
Required: No

## See Also


For more information about using this API in one of the language-specific AWS SDKs, see the following:
+  [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/athena-2017-05-18/EngineConfiguration) 
+  [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/athena-2017-05-18/EngineConfiguration) 
+  [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/athena-2017-05-18/EngineConfiguration)