@aws-sdk/client-athena 3.450.0 → 3.454.0

package/README.md

@@ -17,9 +17,6 @@ Guide</i>.</p>
 driver or later with the Amazon Athena API. Earlier version drivers do not
 support the API. For more information and to download the driver, see <a href="https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html">Accessing
 Amazon Athena with JDBC</a>.</p>
-<p>For code samples using the Amazon Web Services SDK for Java, see <a href="https://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
-Code Samples</a> in the <i>Amazon Athena User
-Guide</i>.</p>
 
 ## Installing
 

package/dist-types/Athena.d.ts

@@ -491,9 +491,6 @@ export interface Athena {
  *             driver or later with the Amazon Athena API. Earlier version drivers do not
  *             support the API. For more information and to download the driver, see <a href="https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html">Accessing
  *                     Amazon Athena with JDBC</a>.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="https://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  */
 export declare class Athena extends AthenaClient implements Athena {
 }

package/dist-types/AthenaClient.d.ts

@@ -231,9 +231,6 @@ export interface AthenaClientResolvedConfig extends AthenaClientResolvedConfigTy
  *             driver or later with the Amazon Athena API. Earlier version drivers do not
  *             support the API. For more information and to download the driver, see <a href="https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html">Accessing
  *                     Amazon Athena with JDBC</a>.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="https://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  */
 export declare class AthenaClient extends __Client<__HttpHandlerOptions, ServiceInputTypes, ServiceOutputTypes, AthenaClientResolvedConfig> {
     /**

package/dist-types/commands/BatchGetQueryExecutionCommand.d.ts

@@ -87,6 +87,7 @@ export interface BatchGetQueryExecutionCommandOutput extends BatchGetQueryExecut
  * //         DataManifestLocation: "STRING_VALUE",
  * //         TotalExecutionTimeInMillis: Number("long"),
  * //         QueryQueueTimeInMillis: Number("long"),
+ * //         ServicePreProcessingTimeInMillis: Number("long"),
  * //         QueryPlanningTimeInMillis: Number("long"),
  * //         ServiceProcessingTimeInMillis: Number("long"),
  * //         ResultReuseInformation: { // ResultReuseInformation

package/dist-types/commands/CancelCapacityReservationCommand.d.ts

@@ -23,7 +23,10 @@ export interface CancelCapacityReservationCommandOutput extends CancelCapacityRe
 }
 /**
  * @public
- * <p>Cancels the capacity reservation with the specified name. Cancelled reservations remain in your account and will be deleted 45 days after cancellation. During the 45 days, you cannot re-purpose or reuse a reservation that has been cancelled, but you can refer to its tags and view it for historical reference. </p>
+ * <p>Cancels the capacity reservation with the specified name. Cancelled reservations
+ *             remain in your account and will be deleted 45 days after cancellation. During the 45
+ *             days, you cannot re-purpose or reuse a reservation that has been cancelled, but you can
+ *             refer to its tags and view it for historical reference. </p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CreateCapacityReservationCommand.d.ts

@@ -23,7 +23,8 @@ export interface CreateCapacityReservationCommandOutput extends CreateCapacityRe
 }
 /**
  * @public
- * <p>Creates a capacity reservation with the specified name and number of requested data processing units.</p>
+ * <p>Creates a capacity reservation with the specified name and number of requested data
+ *             processing units.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CreateNamedQueryCommand.d.ts

@@ -25,9 +25,6 @@ export interface CreateNamedQueryCommandOutput extends CreateNamedQueryOutput, _
  * @public
  * <p>Creates a named query in the specified workgroup. Requires that you have access to the
  *             workgroup.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteCapacityReservationCommand.d.ts

@@ -23,7 +23,11 @@ export interface DeleteCapacityReservationCommandOutput extends DeleteCapacityRe
 }
 /**
  * @public
- * <p>Deletes a cancelled capacity reservation. A reservation must be cancelled before it can be deleted. A deleted reservation is immediately removed from your account and can no longer be referenced, including by its ARN. A deleted reservation cannot be called by <code>GetCapacityReservation</code>, and  deleted reservations do not appear in the output of <code>ListCapacityReservations</code>.</p>
+ * <p>Deletes a cancelled capacity reservation. A reservation must be cancelled before it
+ *             can be deleted. A deleted reservation is immediately removed from your account and can
+ *             no longer be referenced, including by its ARN. A deleted reservation cannot be called by
+ *                 <code>GetCapacityReservation</code>, and deleted reservations do not appear in the
+ *             output of <code>ListCapacityReservations</code>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteNamedQueryCommand.d.ts

@@ -25,9 +25,6 @@ export interface DeleteNamedQueryCommandOutput extends DeleteNamedQueryOutput, _
  * @public
  * <p>Deletes the named query if you have access to the workgroup in which the query was
  *             saved.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetCapacityAssignmentConfigurationCommand.d.ts

@@ -23,7 +23,8 @@ export interface GetCapacityAssignmentConfigurationCommandOutput extends GetCapa
 }
 /**
  * @public
- * <p>Gets the capacity assignment configuration for a capacity reservation, if one exists.</p>
+ * <p>Gets the capacity assignment configuration for a capacity reservation, if one
+ *             exists.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetQueryExecutionCommand.d.ts

@@ -81,6 +81,7 @@ export interface GetQueryExecutionCommandOutput extends GetQueryExecutionOutput,
  * //       DataManifestLocation: "STRING_VALUE",
  * //       TotalExecutionTimeInMillis: Number("long"),
  * //       QueryQueueTimeInMillis: Number("long"),
+ * //       ServicePreProcessingTimeInMillis: Number("long"),
  * //       QueryPlanningTimeInMillis: Number("long"),
  * //       ServiceProcessingTimeInMillis: Number("long"),
  * //       ResultReuseInformation: { // ResultReuseInformation

package/dist-types/commands/GetQueryRuntimeStatisticsCommand.d.ts

@@ -44,6 +44,7 @@ export interface GetQueryRuntimeStatisticsCommandOutput extends GetQueryRuntimeS
  * //   QueryRuntimeStatistics: { // QueryRuntimeStatistics
  * //     Timeline: { // QueryRuntimeStatisticsTimeline
  * //       QueryQueueTimeInMillis: Number("long"),
+ * //       ServicePreProcessingTimeInMillis: Number("long"),
  * //       QueryPlanningTimeInMillis: Number("long"),
  * //       EngineExecutionTimeInMillis: Number("long"),
  * //       ServiceProcessingTimeInMillis: Number("long"),

package/dist-types/commands/ListNamedQueriesCommand.d.ts

@@ -26,9 +26,6 @@ export interface ListNamedQueriesCommandOutput extends ListNamedQueriesOutput, _
  * <p>Provides a list of available query IDs only for queries saved in the specified
  *             workgroup. Requires that you have access to the specified workgroup. If a workgroup is
  *             not specified, lists the saved queries for the primary workgroup.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListQueryExecutionsCommand.d.ts

@@ -24,12 +24,9 @@ export interface ListQueryExecutionsCommandOutput extends ListQueryExecutionsOut
 /**
  * @public
  * <p>Provides a list of available query execution IDs for the queries in the specified
- *             workgroup. If a workgroup is not specified, returns a list of query execution IDs for
+ *             workgroup. Athena keeps a query history for 45 days. If a workgroup is not specified, returns a list of query execution IDs for
  *             the primary workgroup. Requires you to have access to the workgroup in which the queries
  *             ran.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/PutCapacityAssignmentConfigurationCommand.d.ts

@@ -23,7 +23,9 @@ export interface PutCapacityAssignmentConfigurationCommandOutput extends PutCapa
 }
 /**
  * @public
- * <p>Puts a new capacity assignment configuration for a specified capacity reservation. If a capacity assignment configuration already exists for the capacity reservation, replaces the existing capacity assignment configuration.</p>
+ * <p>Puts a new capacity assignment configuration for a specified capacity reservation. If
+ *             a capacity assignment configuration already exists for the capacity reservation,
+ *             replaces the existing capacity assignment configuration.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/StartCalculationExecutionCommand.d.ts

@@ -25,6 +25,13 @@ export interface StartCalculationExecutionCommandOutput extends StartCalculation
  * @public
  * <p>Submits calculations for execution within a session. You can supply the code to run as
  *             an inline code block within the request.</p>
+ *          <note>
+ *             <p>The request syntax requires the
+ *                 <a>StartCalculationExecutionRequest$CodeBlock</a> parameter or the <a>CalculationConfiguration$CodeBlock</a>
+ *                     parameter, but not both. Because
+ *                 <a>CalculationConfiguration$CodeBlock</a> is deprecated, use the
+ *                 <a>StartCalculationExecutionRequest$CodeBlock</a> parameter instead.</p>
+ *          </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/StopQueryExecutionCommand.d.ts

@@ -25,9 +25,6 @@ export interface StopQueryExecutionCommandOutput extends StopQueryExecutionOutpu
  * @public
  * <p>Stops a query execution. Requires you to have access to the workgroup in which the
  *             query ran.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="http://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/TagResourceCommand.d.ts

@@ -24,14 +24,16 @@ export interface TagResourceCommandOutput extends TagResourceOutput, __MetadataB
 /**
  * @public
  * <p>Adds one or more tags to an Athena resource. A tag is a label that you
- *             assign to a resource. Each tag consists of a key and an optional value, both of which you define. For
- *             example, you can use tags to categorize Athena workgroups, data catalogs, or capacity reservations by purpose, owner, or environment. Use a consistent set of tag keys to make it easier to
- *             search and filter the resources in your account. For best practices, see
- *             <a href="https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html">Tagging Best Practices</a>. Tag keys can be from 1 to 128 UTF-8 Unicode
- *             characters, and tag values can be from 0 to 256 UTF-8 Unicode characters. Tags can use
- *             letters and numbers representable in UTF-8, and the following characters: + - = . _ : /
- *             @. Tag keys and values are case-sensitive. Tag keys must be unique per resource. If you
- *             specify more than one tag, separate them by commas.</p>
+ *             assign to a resource. Each tag consists of a key and an optional value, both of which
+ *             you define. For example, you can use tags to categorize Athena workgroups,
+ *             data catalogs, or capacity reservations by purpose, owner, or environment. Use a
+ *             consistent set of tag keys to make it easier to search and filter the resources in your
+ *             account. For best practices, see <a href="https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html">Tagging
+ *                 Best Practices</a>. Tag keys can be from 1 to 128 UTF-8 Unicode characters, and
+ *             tag values can be from 0 to 256 UTF-8 Unicode characters. Tags can use letters and
+ *             numbers representable in UTF-8, and the following characters: + - = . _ : / @. Tag keys
+ *             and values are case-sensitive. Tag keys must be unique per resource. If you specify more
+ *             than one tag, separate them by commas.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateCapacityReservationCommand.d.ts

@@ -23,7 +23,8 @@ export interface UpdateCapacityReservationCommandOutput extends UpdateCapacityRe
 }
 /**
  * @public
- * <p>Updates the number of requested data processing units for the capacity reservation with the specified name.</p>
+ * <p>Updates the number of requested data processing units for the capacity reservation
+ *             with the specified name.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/index.d.ts

@@ -10,9 +10,6 @@
  *             driver or later with the Amazon Athena API. Earlier version drivers do not
  *             support the API. For more information and to download the driver, see <a href="https://docs.aws.amazon.com/athena/latest/ug/connect-with-jdbc.html">Accessing
  *                     Amazon Athena with JDBC</a>.</p>
- *          <p>For code samples using the Amazon Web Services SDK for Java, see <a href="https://docs.aws.amazon.com/athena/latest/ug/code-samples.html">Examples and
- *                 Code Samples</a> in the <i>Amazon Athena User
- *             Guide</i>.</p>
  *
  * @packageDocumentation
  */

package/dist-types/models/models_0.d.ts

@@ -318,9 +318,9 @@ export declare const EncryptionOption: {
 export type EncryptionOption = (typeof EncryptionOption)[keyof typeof EncryptionOption];
 /**
  * @public
- * <p>If query and calculation results are encrypted in Amazon S3, indicates the encryption option
- *             used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) and key
- *             information.</p>
+ * <p>If query and calculation results are encrypted in Amazon S3, indicates the
+ *             encryption option used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) and
+ *             key information.</p>
  */
 export interface EncryptionConfiguration {
     /**
@@ -342,16 +342,16 @@ export interface EncryptionConfiguration {
 }
 /**
  * @public
- * <p>The location in Amazon S3 where query and calculation results are stored and the encryption
- *             option, if any, used for query and calculation results. These are known as "client-side settings". If
- *             workgroup settings override client-side settings, then the query uses the workgroup
- *             settings.</p>
+ * <p>The location in Amazon S3 where query and calculation results are stored and
+ *             the encryption option, if any, used for query and calculation results. These are known
+ *             as "client-side settings". If workgroup settings override client-side settings, then the
+ *             query uses the workgroup settings.</p>
  */
 export interface ResultConfiguration {
     /**
      * @public
-     * <p>The location in Amazon S3 where your query and calculation results are stored, such as
-     *                 <code>s3://path/to/query/bucket/</code>. To run the query, you must specify the
+     * <p>The location in Amazon S3 where your query and calculation results are stored,
+     *             such as <code>s3://path/to/query/bucket/</code>. To run the query, you must specify the
      *             query results location using one of the ways: either for individual queries using either
      *             this setting (client-side), or in the workgroup, using <a>WorkGroupConfiguration</a>. If none of them is set, Athena
      *             issues an error that no output location is provided. For more information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Working with query
@@ -362,11 +362,13 @@ export interface ResultConfiguration {
     OutputLocation?: string;
     /**
      * @public
-     * <p>If query and calculation results are encrypted in Amazon S3, indicates the encryption option
-     *             used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) and key information.
-     *             This is a client-side setting. If workgroup settings override client-side settings, then
-     *             the query uses the encryption configuration that is specified for the workgroup, and
-     *             also uses the location for storing query results specified in the workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a> and <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override Client-Side Settings</a>.</p>
+     * <p>If query and calculation results are encrypted in Amazon S3, indicates the
+     *             encryption option used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) and
+     *             key information. This is a client-side setting. If workgroup settings override
+     *             client-side settings, then the query uses the encryption configuration that is specified
+     *             for the workgroup, and also uses the location for storing query results specified in the
+     *             workgroup. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>
+     *             and <a href="https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html">Workgroup Settings Override Client-Side Settings</a>.</p>
      */
     EncryptionConfiguration?: EncryptionConfiguration;
     /**
@@ -489,6 +491,11 @@ export interface QueryExecutionStatistics {
      *             add the query back to the queue.</p>
      */
     QueryQueueTimeInMillis?: number;
+    /**
+     * @public
+     * <p>The number of milliseconds that Athena took to preprocess the query before submitting the query to the query engine.</p>
+     */
+    ServicePreProcessingTimeInMillis?: number;
     /**
      * @public
      * <p>The number of milliseconds that Athena took to plan the query processing
@@ -634,11 +641,11 @@ export interface QueryExecution {
     StatementType?: StatementType;
     /**
      * @public
-     * <p>The location in Amazon S3 where query and calculation results are stored and the encryption
-     *             option, if any, used for query results. These are known as "client-side settings". If
-     *             workgroup settings override client-side settings, then the query uses the location for
-     *             the query results and the encryption configuration that are specified for the
-     *             workgroup.</p>
+     * <p>The location in Amazon S3 where query and calculation results are stored and
+     *             the encryption option, if any, used for query results. These are known as "client-side
+     *             settings". If workgroup settings override client-side settings, then the query uses the
+     *             location for the query results and the encryption configuration that are specified for
+     *             the workgroup.</p>
      */
     ResultConfiguration?: ResultConfiguration;
     /**
@@ -676,7 +683,8 @@ export interface QueryExecution {
     /**
      * @public
      * <p>A list of values for the parameters in a query. The values are applied sequentially to
-     *             the parameters in the query in the order in which the parameters occur. The list of parameters is not returned in the response.</p>
+     *             the parameters in the query in the order in which the parameters occur. The list of
+     *             parameters is not returned in the response.</p>
      */
     ExecutionParameters?: string[];
     /**
@@ -741,15 +749,16 @@ export interface CancelCapacityReservationOutput {
 /**
  * @public
  * <p>A label that you assign to a resource. Athena resources include
- *             workgroups, data catalogs, and capacity reservations. Each tag consists of a key and an optional value, both of
- *             which you define. For example, you can use tags to categorize Athena
- *             resources by purpose, owner, or environment. Use a consistent set of
- *             tag keys to make it easier to search and filter the resources in your
- *             account. For best practices, see <a href="https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html">Tagging Best Practices</a>. Tag keys can be from 1 to 128 UTF-8 Unicode
- *             characters, and tag values can be from 0 to 256 UTF-8 Unicode characters. Tags can use
- *             letters and numbers representable in UTF-8, and the following characters: + - = . _ : /
- *             @. Tag keys and values are case-sensitive. Tag keys must be unique per resource. If you
- *             specify more than one tag, separate them by commas. </p>
+ *             workgroups, data catalogs, and capacity reservations. Each tag consists of a key and an
+ *             optional value, both of which you define. For example, you can use tags to categorize
+ *                 Athena resources by purpose, owner, or environment. Use a consistent set
+ *             of tag keys to make it easier to search and filter the resources in your account. For
+ *             best practices, see <a href="https://docs.aws.amazon.com/whitepapers/latest/tagging-best-practices/tagging-best-practices.html">Tagging
+ *                 Best Practices</a>. Tag keys can be from 1 to 128 UTF-8 Unicode characters, and
+ *             tag values can be from 0 to 256 UTF-8 Unicode characters. Tags can use letters and
+ *             numbers representable in UTF-8, and the following characters: + - = . _ : / @. Tag keys
+ *             and values are case-sensitive. Tag keys must be unique per resource. If you specify more
+ *             than one tag, separate them by commas. </p>
  */
 export interface Tag {
     /**
@@ -886,16 +895,6 @@ export interface CreateDataCatalogInput {
      *                                 <code>AwsDataCatalog</code> that already exists in your account, of
      *                             which you can have only one and cannot modify.</p>
      *                   </li>
-     *                   <li>
-     *                      <p>Queries that specify a Glue Data Catalog other than the default
-     *                                 <code>AwsDataCatalog</code> must be run on Athena engine
-     *                             version 2.</p>
-     *                   </li>
-     *                   <li>
-     *                      <p>In Regions where Athena engine version 2 is not available,
-     *                             creating new Glue data catalogs results in an
-     *                                 <code>INVALID_INPUT</code> error.</p>
-     *                   </li>
      *                </ul>
      *             </li>
      *          </ul>
@@ -1115,34 +1114,36 @@ export declare class ResourceNotFoundException extends __BaseException {
 }
 /**
  * @public
- * <p>Specifies the KMS key that is used to encrypt the user's data stores in Athena. This setting does not apply to Athena SQL workgroups.</p>
+ * <p>Specifies the customer managed KMS key that is used to encrypt the user's data stores
+ *             in Athena. When an Amazon Web Services managed key is used, this value is
+ *             null. This setting does not apply to Athena SQL workgroups.</p>
  */
 export interface CustomerContentEncryptionConfiguration {
     /**
      * @public
-     * <p>The KMS key that is used to encrypt the user's data stores in Athena.</p>
+     * <p>The customer managed KMS key that is used to encrypt the user's data stores in Athena.</p>
      */
     KmsKey: string | undefined;
 }
 /**
  * @public
  * <p>The configuration of the workgroup, which includes the location in Amazon S3
- *             where query and calculation results are stored, the encryption option, if any, used for query and calculation results,
- *             whether the Amazon CloudWatch Metrics are enabled for the workgroup and whether
- *             workgroup settings override query settings, and the data usage limits for the amount of
- *             data scanned per query or per workgroup. The workgroup settings override is specified in
- *                 <code>EnforceWorkGroupConfiguration</code> (true/false) in the
+ *             where query and calculation results are stored, the encryption option, if any, used for
+ *             query and calculation results, whether the Amazon CloudWatch Metrics are enabled for
+ *             the workgroup and whether workgroup settings override query settings, and the data usage
+ *             limits for the amount of data scanned per query or per workgroup. The workgroup settings
+ *             override is specified in <code>EnforceWorkGroupConfiguration</code> (true/false) in the
  *                 <code>WorkGroupConfiguration</code>. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>. </p>
  */
 export interface WorkGroupConfiguration {
     /**
      * @public
      * <p>The configuration for the workgroup, which includes the location in Amazon S3
-     *             where query and calculation results are stored and the encryption option, if any, used for query and calculation results. To run the query, you must specify the query results location using one of the
-     *             ways: either in the workgroup using this setting, or for individual queries
-     *             (client-side), using <a>ResultConfiguration$OutputLocation</a>. If none of
-     *             them is set, Athena issues an error that no output location is provided. For
-     *             more information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Working with query results, recent queries, and output files</a>.</p>
+     *             where query and calculation results are stored and the encryption option, if any, used
+     *             for query and calculation results. To run the query, you must specify the query results
+     *             location using one of the ways: either in the workgroup using this setting, or for
+     *             individual queries (client-side), using <a>ResultConfiguration$OutputLocation</a>. If none of them is set, Athena issues an error that no output location is provided. For more
+     *             information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Working with query results, recent queries, and output files</a>.</p>
      */
     ResultConfiguration?: ResultConfiguration;
     /**
@@ -1187,7 +1188,8 @@ export interface WorkGroupConfiguration {
     AdditionalConfiguration?: string;
     /**
      * @public
-     * <p>Role used in a session for accessing the user's resources.</p>
+     * <p>Role used in a Spark session for accessing the user's resources. This property applies
+     *             only to Spark-enabled workgroups.</p>
      */
     ExecutionRole?: string;
     /**
@@ -1199,8 +1201,13 @@ export interface WorkGroupConfiguration {
      * @public
      * <p>Enforces a minimal level of encryption for the workgroup for query and calculation
      *             results that are written to Amazon S3. When enabled, workgroup users can set
-     *             encryption only to the minimum level set by the administrator or higher when they submit queries.</p>
-     *          <p>The <code>EnforceWorkGroupConfiguration</code> setting takes precedence over the <code>EnableMinimumEncryptionConfiguration</code> flag. This means that if <code>EnforceWorkGroupConfiguration</code> is true, the <code>EnableMinimumEncryptionConfiguration</code> flag is ignored, and the workgroup configuration for encryption is used.</p>
+     *             encryption only to the minimum level set by the administrator or higher when they submit
+     *             queries.</p>
+     *          <p>The <code>EnforceWorkGroupConfiguration</code> setting takes precedence over the
+     *                 <code>EnableMinimumEncryptionConfiguration</code> flag. This means that if
+     *                 <code>EnforceWorkGroupConfiguration</code> is true, the
+     *                 <code>EnableMinimumEncryptionConfiguration</code> flag is ignored, and the workgroup
+     *             configuration for encryption is used.</p>
      */
     EnableMinimumEncryptionConfiguration?: boolean;
 }
@@ -1217,12 +1224,12 @@ export interface CreateWorkGroupInput {
      * @public
      * <p>Contains configuration information for creating an Athena SQL workgroup or
      *             Spark enabled Athena workgroup. Athena SQL workgroup
-     *             configuration includes the location in Amazon S3 where query and calculation results are stored,
-     *             the encryption configuration, if any, used for encrypting query results, whether the
-     *                 Amazon CloudWatch Metrics are enabled for the workgroup, the limit for the
-     *             amount of bytes scanned (cutoff) per query, if it is specified, and whether workgroup's
-     *             settings (specified with <code>EnforceWorkGroupConfiguration</code>) in the
-     *                 <code>WorkGroupConfiguration</code> override client-side settings. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>.</p>
+     *             configuration includes the location in Amazon S3 where query and calculation
+     *             results are stored, the encryption configuration, if any, used for encrypting query
+     *             results, whether the Amazon CloudWatch Metrics are enabled for the workgroup, the
+     *             limit for the amount of bytes scanned (cutoff) per query, if it is specified, and
+     *             whether workgroup's settings (specified with <code>EnforceWorkGroupConfiguration</code>)
+     *             in the <code>WorkGroupConfiguration</code> override client-side settings. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>.</p>
      */
     Configuration?: WorkGroupConfiguration;
     /**
@@ -1625,7 +1632,8 @@ export interface GetCalculationExecutionStatusResponse {
 export interface GetCapacityAssignmentConfigurationInput {
     /**
      * @public
-     * <p>The name of the capacity reservation to retrieve the capacity assignment configuration for.</p>
+     * <p>The name of the capacity reservation to retrieve the capacity assignment configuration
+     *             for.</p>
      */
     CapacityReservationName: string | undefined;
 }
@@ -1642,7 +1650,11 @@ export interface CapacityAssignment {
 }
 /**
  * @public
- * <p>Assigns Athena workgroups (and hence their queries) to capacity reservations. A capacity reservation can have only one capacity assignment configuration, but the capacity assignment configuration can be made up of multiple individual assignments. Each assignment specifies how Athena queries can consume capacity from the capacity reservation that their workgroup is mapped to.</p>
+ * <p>Assigns Athena workgroups (and hence their queries) to capacity
+ *             reservations. A capacity reservation can have only one capacity assignment
+ *             configuration, but the capacity assignment configuration can be made up of multiple
+ *             individual assignments. Each assignment specifies how Athena queries can
+ *             consume capacity from the capacity reservation that their workgroup is mapped to.</p>
  */
 export interface CapacityAssignmentConfiguration {
     /**
@@ -1662,7 +1674,8 @@ export interface CapacityAssignmentConfiguration {
 export interface GetCapacityAssignmentConfigurationOutput {
     /**
      * @public
-     * <p>The requested capacity assignment configuration for the specified capacity reservation.</p>
+     * <p>The requested capacity assignment configuration for the specified capacity
+     *             reservation.</p>
      */
     CapacityAssignmentConfiguration: CapacityAssignmentConfiguration | undefined;
 }
@@ -1691,7 +1704,8 @@ export declare const CapacityAllocationStatus: {
 export type CapacityAllocationStatus = (typeof CapacityAllocationStatus)[keyof typeof CapacityAllocationStatus];
 /**
  * @public
- * <p>Contains the submission time of a single allocation request for a capacity reservation and the most recent status of the attempted allocation.</p>
+ * <p>Contains the submission time of a single allocation request for a capacity reservation
+ *             and the most recent status of the attempted allocation.</p>
  */
 export interface CapacityAllocation {
     /**
@@ -1733,7 +1747,9 @@ export declare const CapacityReservationStatus: {
 export type CapacityReservationStatus = (typeof CapacityReservationStatus)[keyof typeof CapacityReservationStatus];
 /**
  * @public
- * <p>A reservation for a specified number of data processing units (DPUs). When a reservation is initially created, it has no DPUs. Athena allocates DPUs until the allocated amount equals the requested amount.</p>
+ * <p>A reservation for a specified number of data processing units (DPUs). When a
+ *             reservation is initially created, it has no DPUs. Athena allocates DPUs
+ *             until the allocated amount equals the requested amount.</p>
  */
 export interface CapacityReservation {
     /**
@@ -1758,7 +1774,8 @@ export interface CapacityReservation {
     AllocatedDpus: number | undefined;
     /**
      * @public
-     * <p>Contains the submission time of a single allocation request for a capacity reservation and the most recent status of the attempted allocation.</p>
+     * <p>Contains the submission time of a single allocation request for a capacity reservation
+     *             and the most recent status of the attempted allocation.</p>
      */
     LastAllocation?: CapacityAllocation;
     /**
@@ -1941,11 +1958,6 @@ export interface DataCatalog {
      *                                 <code>AwsDataCatalog</code> that already exists in your account, of
      *                             which you can have only one and cannot modify.</p>
      *                   </li>
-     *                   <li>
-     *                      <p>Queries that specify a Glue Data Catalog other than the default
-     *                                 <code>AwsDataCatalog</code> must be run on Athena engine
-     *                             version 2.</p>
-     *                   </li>
      *                </ul>
      *             </li>
      *          </ul>
@@ -2266,6 +2278,13 @@ export interface QueryRuntimeStatisticsTimeline {
      *             add the query back to the queue.</p>
      */
     QueryQueueTimeInMillis?: number;
+    /**
+     * @public
+     * <p>
+     *             The number of milliseconds that Athena spends on preprocessing before it submits the query to the engine.
+     *         </p>
+     */
+    ServicePreProcessingTimeInMillis?: number;
     /**
      * @public
      * <p>The number of milliseconds that Athena took to plan the query processing
@@ -2310,8 +2329,8 @@ export interface EngineConfiguration {
     /**
      * @public
      * <p>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.</p>
+     *             that orchestrates processing work and manages other executors in a notebook session. The
+     *             default is 1.</p>
      */
     CoordinatorDpuSize?: number;
     /**
@@ -2322,7 +2341,8 @@ export interface EngineConfiguration {
     /**
      * @public
      * <p>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.</p>
+     *             compute that a notebook session can request from Athena. The default is
+     *             1.</p>
      */
     DefaultExecutorDpuSize?: number;
     /**
@@ -2336,7 +2356,8 @@ export interface EngineConfiguration {
     AdditionalConfigs?: Record<string, string>;
     /**
      * @public
-     * <p>Specifies custom jar files and Spark properties for use cases like cluster encryption, table formats, and general Spark tuning.</p>
+     * <p>Specifies custom jar files and Spark properties for use cases like cluster encryption,
+     *             table formats, and general Spark tuning.</p>
      */
     SparkProperties?: Record<string, string>;
 }
@@ -2347,7 +2368,8 @@ export interface EngineConfiguration {
 export interface SessionConfiguration {
     /**
      * @public
-     * <p>The ARN of the execution role used for the session.</p>
+     * <p>The ARN of the execution role used in a Spark session to access user resources. This
+     *             property applies only to Spark-enabled workgroups.</p>
      */
     ExecutionRole?: string;
     /**
@@ -2362,9 +2384,9 @@ export interface SessionConfiguration {
     IdleTimeoutSeconds?: number;
     /**
      * @public
-     * <p>If query and calculation results are encrypted in Amazon S3, indicates the encryption option
-     *             used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) and key
-     *             information.</p>
+     * <p>If query and calculation results are encrypted in Amazon S3, indicates the
+     *             encryption option used (for example, <code>SSE_KMS</code> or <code>CSE_KMS</code>) and
+     *             key information.</p>
      */
     EncryptionConfiguration?: EncryptionConfiguration;
 }
@@ -2671,11 +2693,12 @@ export interface WorkGroup {
     /**
      * @public
      * <p>The configuration of the workgroup, which includes the location in Amazon S3
-     *             where query and calculation results are stored, the encryption configuration, if any, used for query and calculation results; whether the Amazon CloudWatch Metrics are enabled for the workgroup;
-     *             whether workgroup settings override client-side settings; and the data usage limits for
-     *             the amount of data scanned per query or per workgroup. The workgroup settings override
-     *             is specified in <code>EnforceWorkGroupConfiguration</code> (true/false) in the
-     *                 <code>WorkGroupConfiguration</code>. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>.</p>
+     *             where query and calculation results are stored, the encryption configuration, if any,
+     *             used for query and calculation results; whether the Amazon CloudWatch Metrics are
+     *             enabled for the workgroup; whether workgroup settings override client-side settings; and
+     *             the data usage limits for the amount of data scanned per query or per workgroup. The
+     *             workgroup settings override is specified in <code>EnforceWorkGroupConfiguration</code>
+     *             (true/false) in the <code>WorkGroupConfiguration</code>. See <a>WorkGroupConfiguration$EnforceWorkGroupConfiguration</a>.</p>
      */
     Configuration?: WorkGroupConfiguration;
     /**
@@ -3684,7 +3707,8 @@ export interface ListWorkGroupsOutput {
 export interface PutCapacityAssignmentConfigurationInput {
     /**
      * @public
-     * <p>The name of the capacity reservation to put a capacity assignment configuration for.</p>
+     * <p>The name of the capacity reservation to put a capacity assignment configuration
+     *             for.</p>
      */
     CapacityReservationName: string | undefined;
     /**
@@ -3732,7 +3756,7 @@ export interface StartCalculationExecutionRequest {
     CalculationConfiguration?: CalculationConfiguration;
     /**
      * @public
-     * <p>A string that contains the code of the calculation.</p>
+     * <p>A string that contains the code of the calculation. Use this parameter instead of <a>CalculationConfiguration$CodeBlock</a>, which is deprecated.</p>
      */
     CodeBlock?: string;
     /**
@@ -3881,7 +3905,11 @@ export interface StartSessionRequest {
     EngineConfiguration: EngineConfiguration | undefined;
     /**
      * @public
-     * <p>The notebook version. This value is supplied automatically for notebook sessions in the Athena console and is not required for programmatic session access. The only valid notebook version is <code>Athena notebook version 1</code>. If you specify a value for <code>NotebookVersion</code>, you must also specify a value for <code>NotebookId</code>. See <a>EngineConfiguration$AdditionalConfigs</a>.</p>
+     * <p>The notebook version. This value is supplied automatically for notebook sessions in
+     *             the Athena console and is not required for programmatic session access. The
+     *             only valid notebook version is <code>Athena notebook version 1</code>. If
+     *             you specify a value for <code>NotebookVersion</code>, you must also specify a value for
+     *                 <code>NotebookId</code>. See <a>EngineConfiguration$AdditionalConfigs</a>.</p>
      */
     NotebookVersion?: string;
     /**
@@ -3996,8 +4024,8 @@ export interface StopQueryExecutionOutput {
 export interface TagResourceInput {
     /**
      * @public
-     * <p>Specifies the ARN of the Athena resource to
-     *             which tags are to be added.</p>
+     * <p>Specifies the ARN of the Athena resource to which tags are to be
+     *             added.</p>
      */
     ResourceARN: string | undefined;
     /**
@@ -4307,8 +4335,8 @@ export interface UpdatePreparedStatementOutput {
 export interface ResultConfigurationUpdates {
     /**
      * @public
-     * <p>The location in Amazon S3 where your query and calculation results are stored, such as
-     *                 <code>s3://path/to/query/bucket/</code>. For more information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Working with query
+     * <p>The location in Amazon S3 where your query and calculation results are stored,
+     *             such as <code>s3://path/to/query/bucket/</code>. For more information, see <a href="https://docs.aws.amazon.com/athena/latest/ug/querying.html">Working with query
      *                 results, recent queries, and output files</a>. If workgroup settings override
      *             client-side settings, then the query uses the location for the query results and the
      *             encryption configuration that are specified for the workgroup. The "workgroup settings
@@ -4389,11 +4417,11 @@ export interface ResultConfigurationUpdates {
 /**
  * @public
  * <p>The configuration information that will be updated for this workgroup, which includes
- *             the location in Amazon S3 where query and calculation results are stored, the encryption option,
- *             if any, used for query results, whether the Amazon CloudWatch Metrics are enabled
- *             for the workgroup, whether the workgroup settings override the client-side settings, and
- *             the data usage limit for the amount of bytes scanned per query, if it is
- *             specified.</p>
+ *             the location in Amazon S3 where query and calculation results are stored, the
+ *             encryption option, if any, used for query results, whether the Amazon CloudWatch
+ *             Metrics are enabled for the workgroup, whether the workgroup settings override the
+ *             client-side settings, and the data usage limit for the amount of bytes scanned per
+ *             query, if it is specified.</p>
  */
 export interface WorkGroupConfigurationUpdates {
     /**
@@ -4455,20 +4483,28 @@ export interface WorkGroupConfigurationUpdates {
     AdditionalConfiguration?: string;
     /**
      * @public
-     * <p>Contains the ARN of the execution role for the workgroup</p>
+     * <p>The ARN of the execution role used to access user resources. This property applies
+     *             only to Spark-enabled workgroups.</p>
      */
     ExecutionRole?: string;
     /**
      * @public
-     * <p>Specifies the KMS key that is used to encrypt the user's data stores in Athena. This setting does not apply to Athena SQL workgroups.</p>
+     * <p>Specifies the customer managed KMS key that is used to encrypt the user's data stores
+     *             in Athena. When an Amazon Web Services managed key is used, this value is
+     *             null. This setting does not apply to Athena SQL workgroups.</p>
      */
     CustomerContentEncryptionConfiguration?: CustomerContentEncryptionConfiguration;
     /**
      * @public
      * <p>Enforces a minimal level of encryption for the workgroup for query and calculation
      *             results that are written to Amazon S3. When enabled, workgroup users can set
-     *             encryption only to the minimum level set by the administrator or higher when they submit queries. This setting does not apply to Spark-enabled workgroups.</p>
-     *          <p>The <code>EnforceWorkGroupConfiguration</code> setting takes precedence over the <code>EnableMinimumEncryptionConfiguration</code> flag. This means that if <code>EnforceWorkGroupConfiguration</code> is true, the <code>EnableMinimumEncryptionConfiguration</code> flag is ignored, and the workgroup configuration for encryption is used.</p>
+     *             encryption only to the minimum level set by the administrator or higher when they submit
+     *             queries. This setting does not apply to Spark-enabled workgroups.</p>
+     *          <p>The <code>EnforceWorkGroupConfiguration</code> setting takes precedence over the
+     *                 <code>EnableMinimumEncryptionConfiguration</code> flag. This means that if
+     *                 <code>EnforceWorkGroupConfiguration</code> is true, the
+     *                 <code>EnableMinimumEncryptionConfiguration</code> flag is ignored, and the workgroup
+     *             configuration for encryption is used.</p>
      */
     EnableMinimumEncryptionConfiguration?: boolean;
 }

package/dist-types/ts3.4/models/models_0.d.ts

@@ -114,6 +114,7 @@ export interface QueryExecutionStatistics {
   DataManifestLocation?: string;
   TotalExecutionTimeInMillis?: number;
   QueryQueueTimeInMillis?: number;
+  ServicePreProcessingTimeInMillis?: number;
   QueryPlanningTimeInMillis?: number;
   ServiceProcessingTimeInMillis?: number;
   ResultReuseInformation?: ResultReuseInformation;
@@ -528,6 +529,7 @@ export interface QueryRuntimeStatisticsRows {
 }
 export interface QueryRuntimeStatisticsTimeline {
   QueryQueueTimeInMillis?: number;
+  ServicePreProcessingTimeInMillis?: number;
   QueryPlanningTimeInMillis?: number;
   EngineExecutionTimeInMillis?: number;
   ServiceProcessingTimeInMillis?: number;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-athena",
   "description": "AWS SDK for JavaScript Athena Client for Node.js, Browser and React Native",
-  "version": "3.450.0",
+  "version": "3.454.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -21,42 +21,42 @@
   "dependencies": {
     "@aws-crypto/sha256-browser": "3.0.0",
     "@aws-crypto/sha256-js": "3.0.0",
-    "@aws-sdk/client-sts": "3.450.0",
-    "@aws-sdk/core": "3.445.0",
-    "@aws-sdk/credential-provider-node": "3.450.0",
-    "@aws-sdk/middleware-host-header": "3.449.0",
-    "@aws-sdk/middleware-logger": "3.449.0",
-    "@aws-sdk/middleware-recursion-detection": "3.449.0",
-    "@aws-sdk/middleware-signing": "3.449.0",
-    "@aws-sdk/middleware-user-agent": "3.449.0",
-    "@aws-sdk/region-config-resolver": "3.433.0",
-    "@aws-sdk/types": "3.449.0",
-    "@aws-sdk/util-endpoints": "3.449.0",
-    "@aws-sdk/util-user-agent-browser": "3.449.0",
-    "@aws-sdk/util-user-agent-node": "3.449.0",
-    "@smithy/config-resolver": "^2.0.16",
-    "@smithy/fetch-http-handler": "^2.2.4",
-    "@smithy/hash-node": "^2.0.12",
-    "@smithy/invalid-dependency": "^2.0.12",
-    "@smithy/middleware-content-length": "^2.0.14",
-    "@smithy/middleware-endpoint": "^2.1.3",
-    "@smithy/middleware-retry": "^2.0.18",
-    "@smithy/middleware-serde": "^2.0.12",
-    "@smithy/middleware-stack": "^2.0.6",
-    "@smithy/node-config-provider": "^2.1.3",
-    "@smithy/node-http-handler": "^2.1.8",
-    "@smithy/protocol-http": "^3.0.8",
-    "@smithy/smithy-client": "^2.1.12",
-    "@smithy/types": "^2.4.0",
-    "@smithy/url-parser": "^2.0.12",
-    "@smithy/util-base64": "^2.0.0",
+    "@aws-sdk/client-sts": "3.454.0",
+    "@aws-sdk/core": "3.451.0",
+    "@aws-sdk/credential-provider-node": "3.451.0",
+    "@aws-sdk/middleware-host-header": "3.451.0",
+    "@aws-sdk/middleware-logger": "3.451.0",
+    "@aws-sdk/middleware-recursion-detection": "3.451.0",
+    "@aws-sdk/middleware-signing": "3.451.0",
+    "@aws-sdk/middleware-user-agent": "3.451.0",
+    "@aws-sdk/region-config-resolver": "3.451.0",
+    "@aws-sdk/types": "3.451.0",
+    "@aws-sdk/util-endpoints": "3.451.0",
+    "@aws-sdk/util-user-agent-browser": "3.451.0",
+    "@aws-sdk/util-user-agent-node": "3.451.0",
+    "@smithy/config-resolver": "^2.0.18",
+    "@smithy/fetch-http-handler": "^2.2.6",
+    "@smithy/hash-node": "^2.0.15",
+    "@smithy/invalid-dependency": "^2.0.13",
+    "@smithy/middleware-content-length": "^2.0.15",
+    "@smithy/middleware-endpoint": "^2.2.0",
+    "@smithy/middleware-retry": "^2.0.20",
+    "@smithy/middleware-serde": "^2.0.13",
+    "@smithy/middleware-stack": "^2.0.7",
+    "@smithy/node-config-provider": "^2.1.5",
+    "@smithy/node-http-handler": "^2.1.9",
+    "@smithy/protocol-http": "^3.0.9",
+    "@smithy/smithy-client": "^2.1.15",
+    "@smithy/types": "^2.5.0",
+    "@smithy/url-parser": "^2.0.13",
+    "@smithy/util-base64": "^2.0.1",
     "@smithy/util-body-length-browser": "^2.0.0",
     "@smithy/util-body-length-node": "^2.1.0",
-    "@smithy/util-defaults-mode-browser": "^2.0.16",
-    "@smithy/util-defaults-mode-node": "^2.0.21",
-    "@smithy/util-endpoints": "^1.0.2",
-    "@smithy/util-retry": "^2.0.5",
-    "@smithy/util-utf8": "^2.0.0",
+    "@smithy/util-defaults-mode-browser": "^2.0.19",
+    "@smithy/util-defaults-mode-node": "^2.0.25",
+    "@smithy/util-endpoints": "^1.0.4",
+    "@smithy/util-retry": "^2.0.6",
+    "@smithy/util-utf8": "^2.0.2",
     "tslib": "^2.5.0",
     "uuid": "^8.3.2"
   },