aws-sdk-athena 1.34.0 → 1.35.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6124706949529375528b9b8836fda732bba51a965b6c2dac4a28c33cc84cf584
-  data.tar.gz: df8c05c17797cd917c624825eed2a69668c0c708fa650cf41907ac6672a331b2
+  metadata.gz: 28f71cbb3b6c90e76ef89f3334b884af46b0cd66287aa08d01f9bb2083038313
+  data.tar.gz: 33fd54da2031d1bc723ff234e8a1399fdf5afefbf3a62a338a2857c6e3fdee22
 SHA512:
-  metadata.gz: 33be8f0bbbcc75f9b729a6e717ea13e5973f949ca6a02a4fcc623399e7070546c795d89b6f9193274ac8b128cb59a1907955eeb9b2d4aa3c2fccd932064fb89e
-  data.tar.gz: b7825754983fae555f14f49f87f3e802faf7fb0aa8d7adb1458f77d07727320311493b75372522c43ecf03d783132f7e36e64be4c6830e715bfa4efe5cd3e3ff
+  metadata.gz: 33bed14929a74ba6638c86a8dae9cd92dc9c427dbf35b062f47fbad0537385cce7c4ae3d2daa3c378dd0ccf174c518e7a567fbf001e096654da2292a9d1b0d5f
+  data.tar.gz: 62668dfec48e622fd8d75cd8e8182e5c1f1d98c6198ce7e11e54cb212846b3b6bdf062594353982364586b78c1f086ae57d577d259e4d8eb16d7eb16b1d217a2

data/lib/aws-sdk-athena.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @!group service
 module Aws::Athena
 
-  GEM_VERSION = '1.34.0'
+  GEM_VERSION = '1.35.0'
 
 end

data/lib/aws-sdk-athena/client.rb

@@ -430,6 +430,8 @@ module Aws::Athena
     #   resp.query_executions[0].statistics.query_planning_time_in_millis #=> Integer
     #   resp.query_executions[0].statistics.service_processing_time_in_millis #=> Integer
     #   resp.query_executions[0].work_group #=> String
+    #   resp.query_executions[0].engine_version.selected_engine_version #=> String
+    #   resp.query_executions[0].engine_version.effective_engine_version #=> String
     #   resp.unprocessed_query_execution_ids #=> Array
     #   resp.unprocessed_query_execution_ids[0].query_execution_id #=> String
     #   resp.unprocessed_query_execution_ids[0].error_code #=> String
@@ -454,8 +456,14 @@ module Aws::Athena
     #   underscore, at sign, or hyphen characters.
     #
     # @option params [required, String] :type
-    #   The type of data catalog to create: `LAMBDA` for a federated catalog,
-    #   `GLUE` for AWS Glue Catalog, or `HIVE` for an external hive metastore.
+    #   The type of data catalog to create: `LAMBDA` for a federated catalog
+    #   or `HIVE` for an external hive metastore.
+    #
+    #   <note markdown="1"> Do not use the `GLUE` type. This refers to the `AwsDataCatalog` that
+    #   already exists in your account, of which you can have only one.
+    #   Specifying the `GLUE` type will result in an `INVALID_INPUT` error.
+    #
+    #    </note>
     #
     # @option params [String] :description
     #   A description of the data catalog to be created.
@@ -487,8 +495,6 @@ module Aws::Athena
     #
     #       `function=lambda_arn `
     #
-    #   * The `GLUE` type has no parameters.
-    #
     # @option params [Array<Types::Tag>] :tags
     #   A list of comma separated tags to add to the data catalog that is
     #   created.
@@ -630,6 +636,10 @@ module Aws::Athena
     #       publish_cloud_watch_metrics_enabled: false,
     #       bytes_scanned_cutoff_per_query: 1,
     #       requester_pays_enabled: false,
+    #       engine_version: {
+    #         selected_engine_version: "NameString",
+    #         effective_engine_version: "NameString",
+    #       },
     #     },
     #     description: "WorkGroupDescriptionString",
     #     tags: [
@@ -712,7 +722,7 @@ module Aws::Athena
     #
     # @option params [Boolean] :recursive_delete_option
     #   The option to delete the workgroup and its contents even if the
-    #   workgroup contains any named queries.
+    #   workgroup contains any named queries or query executions.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -764,7 +774,7 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Returns a database object for the specfied database and data catalog.
+    # Returns a database object for the specified database and data catalog.
     #
     # @option params [required, String] :catalog_name
     #   The name of the data catalog that contains the database to return.
@@ -873,6 +883,8 @@ module Aws::Athena
     #   resp.query_execution.statistics.query_planning_time_in_millis #=> Integer
     #   resp.query_execution.statistics.service_processing_time_in_millis #=> Integer
     #   resp.query_execution.work_group #=> String
+    #   resp.query_execution.engine_version.selected_engine_version #=> String
+    #   resp.query_execution.engine_version.effective_engine_version #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution AWS API Documentation
     #
@@ -1035,6 +1047,8 @@ module Aws::Athena
     #   resp.work_group.configuration.publish_cloud_watch_metrics_enabled #=> Boolean
     #   resp.work_group.configuration.bytes_scanned_cutoff_per_query #=> Integer
     #   resp.work_group.configuration.requester_pays_enabled #=> Boolean
+    #   resp.work_group.configuration.engine_version.selected_engine_version #=> String
+    #   resp.work_group.configuration.engine_version.effective_engine_version #=> String
     #   resp.work_group.description #=> String
     #   resp.work_group.creation_time #=> Time
     #
@@ -1135,6 +1149,46 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Returns a list of engine versions that are available to choose from,
+    # including the Auto option.
+    #
+    # @option params [String] :next_token
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the `NextToken` from the response object of
+    #   the previous page call.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of engine versions to return in this request.
+    #
+    # @return [Types::ListEngineVersionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListEngineVersionsOutput#engine_versions #engine_versions} => Array&lt;Types::EngineVersion&gt;
+    #   * {Types::ListEngineVersionsOutput#next_token #next_token} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_engine_versions({
+    #     next_token: "Token",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.engine_versions #=> Array
+    #   resp.engine_versions[0].selected_engine_version #=> String
+    #   resp.engine_versions[0].effective_engine_version #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListEngineVersions AWS API Documentation
+    #
+    # @overload list_engine_versions(params = {})
+    # @param [Hash] params ({})
+    def list_engine_versions(params = {}, options = {})
+      req = build_request(:list_engine_versions, params)
+      req.send_request(options)
+    end
+
     # 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
@@ -1393,6 +1447,8 @@ module Aws::Athena
     #   resp.work_groups[0].state #=> String, one of "ENABLED", "DISABLED"
     #   resp.work_groups[0].description #=> String
     #   resp.work_groups[0].creation_time #=> Time
+    #   resp.work_groups[0].engine_version.selected_engine_version #=> String
+    #   resp.work_groups[0].engine_version.effective_engine_version #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListWorkGroups AWS API Documentation
@@ -1601,8 +1657,13 @@ module Aws::Athena
     #
     # @option params [required, String] :type
     #   Specifies the type of data catalog to update. Specify `LAMBDA` for a
-    #   federated catalog, `GLUE` for AWS Glue Catalog, or `HIVE` for an
-    #   external hive metastore.
+    #   federated catalog or `HIVE` for an external hive metastore.
+    #
+    #   <note markdown="1"> Do not use the `GLUE` type. This refers to the `AwsDataCatalog` that
+    #   already exists in your account, of which you can have only one.
+    #   Specifying the `GLUE` type will result in an `INVALID_INPUT` error.
+    #
+    #    </note>
     #
     # @option params [String] :description
     #   New or modified text that describes the data catalog.
@@ -1634,8 +1695,6 @@ module Aws::Athena
     #
     #       `function=lambda_arn `
     #
-    #   * The `GLUE` type has no parameters.
-    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -1696,6 +1755,10 @@ module Aws::Athena
     #       bytes_scanned_cutoff_per_query: 1,
     #       remove_bytes_scanned_cutoff_per_query: false,
     #       requester_pays_enabled: false,
+    #       engine_version: {
+    #         selected_engine_version: "NameString",
+    #         effective_engine_version: "NameString",
+    #       },
     #     },
     #     state: "ENABLED", # accepts ENABLED, DISABLED
     #   })
@@ -1722,7 +1785,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.35.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-athena/client_api.rb

@@ -52,6 +52,8 @@ module Aws::Athena
     DescriptionString = Shapes::StringShape.new(name: 'DescriptionString')
     EncryptionConfiguration = Shapes::StructureShape.new(name: 'EncryptionConfiguration')
     EncryptionOption = Shapes::StringShape.new(name: 'EncryptionOption')
+    EngineVersion = Shapes::StructureShape.new(name: 'EngineVersion')
+    EngineVersionsList = Shapes::ListShape.new(name: 'EngineVersionsList')
     ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     ExpressionString = Shapes::StringShape.new(name: 'ExpressionString')
@@ -78,6 +80,8 @@ module Aws::Athena
     ListDataCatalogsOutput = Shapes::StructureShape.new(name: 'ListDataCatalogsOutput')
     ListDatabasesInput = Shapes::StructureShape.new(name: 'ListDatabasesInput')
     ListDatabasesOutput = Shapes::StructureShape.new(name: 'ListDatabasesOutput')
+    ListEngineVersionsInput = Shapes::StructureShape.new(name: 'ListEngineVersionsInput')
+    ListEngineVersionsOutput = Shapes::StructureShape.new(name: 'ListEngineVersionsOutput')
     ListNamedQueriesInput = Shapes::StructureShape.new(name: 'ListNamedQueriesInput')
     ListNamedQueriesOutput = Shapes::StructureShape.new(name: 'ListNamedQueriesOutput')
     ListQueryExecutionsInput = Shapes::StructureShape.new(name: 'ListQueryExecutionsInput')
@@ -91,6 +95,7 @@ module Aws::Athena
     Long = Shapes::IntegerShape.new(name: 'Long')
     MaxDataCatalogsCount = Shapes::IntegerShape.new(name: 'MaxDataCatalogsCount')
     MaxDatabasesCount = Shapes::IntegerShape.new(name: 'MaxDatabasesCount')
+    MaxEngineVersionsCount = Shapes::IntegerShape.new(name: 'MaxEngineVersionsCount')
     MaxNamedQueriesCount = Shapes::IntegerShape.new(name: 'MaxNamedQueriesCount')
     MaxQueryExecutionsCount = Shapes::IntegerShape.new(name: 'MaxQueryExecutionsCount')
     MaxQueryResults = Shapes::IntegerShape.new(name: 'MaxQueryResults')
@@ -268,6 +273,12 @@ module Aws::Athena
     EncryptionConfiguration.add_member(:kms_key, Shapes::ShapeRef.new(shape: String, location_name: "KmsKey"))
     EncryptionConfiguration.struct_class = Types::EncryptionConfiguration
 
+    EngineVersion.add_member(:selected_engine_version, Shapes::ShapeRef.new(shape: NameString, location_name: "SelectedEngineVersion"))
+    EngineVersion.add_member(:effective_engine_version, Shapes::ShapeRef.new(shape: NameString, location_name: "EffectiveEngineVersion"))
+    EngineVersion.struct_class = Types::EngineVersion
+
+    EngineVersionsList.member = Shapes::ShapeRef.new(shape: EngineVersion)
+
     GetDataCatalogInput.add_member(:name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "Name"))
     GetDataCatalogInput.struct_class = Types::GetDataCatalogInput
 
@@ -341,6 +352,14 @@ module Aws::Athena
     ListDatabasesOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
     ListDatabasesOutput.struct_class = Types::ListDatabasesOutput
 
+    ListEngineVersionsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
+    ListEngineVersionsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxEngineVersionsCount, location_name: "MaxResults"))
+    ListEngineVersionsInput.struct_class = Types::ListEngineVersionsInput
+
+    ListEngineVersionsOutput.add_member(:engine_versions, Shapes::ShapeRef.new(shape: EngineVersionsList, location_name: "EngineVersions"))
+    ListEngineVersionsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
+    ListEngineVersionsOutput.struct_class = Types::ListEngineVersionsOutput
+
     ListNamedQueriesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
     ListNamedQueriesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxNamedQueriesCount, location_name: "MaxResults"))
     ListNamedQueriesInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
@@ -413,6 +432,7 @@ module Aws::Athena
     QueryExecution.add_member(:status, Shapes::ShapeRef.new(shape: QueryExecutionStatus, location_name: "Status"))
     QueryExecution.add_member(:statistics, Shapes::ShapeRef.new(shape: QueryExecutionStatistics, location_name: "Statistics"))
     QueryExecution.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
+    QueryExecution.add_member(:engine_version, Shapes::ShapeRef.new(shape: EngineVersion, location_name: "EngineVersion"))
     QueryExecution.struct_class = Types::QueryExecution
 
     QueryExecutionContext.add_member(:database, Shapes::ShapeRef.new(shape: DatabaseString, location_name: "Database"))
@@ -556,6 +576,7 @@ module Aws::Athena
     WorkGroupConfiguration.add_member(:publish_cloud_watch_metrics_enabled, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "PublishCloudWatchMetricsEnabled"))
     WorkGroupConfiguration.add_member(:bytes_scanned_cutoff_per_query, Shapes::ShapeRef.new(shape: BytesScannedCutoffValue, location_name: "BytesScannedCutoffPerQuery"))
     WorkGroupConfiguration.add_member(:requester_pays_enabled, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RequesterPaysEnabled"))
+    WorkGroupConfiguration.add_member(:engine_version, Shapes::ShapeRef.new(shape: EngineVersion, location_name: "EngineVersion"))
     WorkGroupConfiguration.struct_class = Types::WorkGroupConfiguration
 
     WorkGroupConfigurationUpdates.add_member(:enforce_work_group_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnforceWorkGroupConfiguration"))
@@ -564,12 +585,14 @@ module Aws::Athena
     WorkGroupConfigurationUpdates.add_member(:bytes_scanned_cutoff_per_query, Shapes::ShapeRef.new(shape: BytesScannedCutoffValue, location_name: "BytesScannedCutoffPerQuery"))
     WorkGroupConfigurationUpdates.add_member(:remove_bytes_scanned_cutoff_per_query, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveBytesScannedCutoffPerQuery"))
     WorkGroupConfigurationUpdates.add_member(:requester_pays_enabled, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RequesterPaysEnabled"))
+    WorkGroupConfigurationUpdates.add_member(:engine_version, Shapes::ShapeRef.new(shape: EngineVersion, location_name: "EngineVersion"))
     WorkGroupConfigurationUpdates.struct_class = Types::WorkGroupConfigurationUpdates
 
     WorkGroupSummary.add_member(:name, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "Name"))
     WorkGroupSummary.add_member(:state, Shapes::ShapeRef.new(shape: WorkGroupState, location_name: "State"))
     WorkGroupSummary.add_member(:description, Shapes::ShapeRef.new(shape: WorkGroupDescriptionString, location_name: "Description"))
     WorkGroupSummary.add_member(:creation_time, Shapes::ShapeRef.new(shape: Date, location_name: "CreationTime"))
+    WorkGroupSummary.add_member(:engine_version, Shapes::ShapeRef.new(shape: EngineVersion, location_name: "EngineVersion"))
     WorkGroupSummary.struct_class = Types::WorkGroupSummary
 
     WorkGroupsList.member = Shapes::ShapeRef.new(shape: WorkGroupSummary)
@@ -785,6 +808,16 @@ module Aws::Athena
         )
       end)
 
+      api.add_operation(:list_engine_versions, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "ListEngineVersions"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: ListEngineVersionsInput)
+        o.output = Shapes::ShapeRef.new(shape: ListEngineVersionsOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+      end)
+
       api.add_operation(:list_named_queries, Seahorse::Model::Operation.new.tap do |o|
         o.name = "ListNamedQueries"
         o.http_method = "POST"

data/lib/aws-sdk-athena/types.rb

@@ -192,9 +192,14 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] type
-    #   The type of data catalog to create: `LAMBDA` for a federated
-    #   catalog, `GLUE` for AWS Glue Catalog, or `HIVE` for an external hive
-    #   metastore.
+    #   The type of data catalog to create: `LAMBDA` for a federated catalog
+    #   or `HIVE` for an external hive metastore.
+    #
+    #   <note markdown="1"> Do not use the `GLUE` type. This refers to the `AwsDataCatalog` that
+    #   already exists in your account, of which you can have only one.
+    #   Specifying the `GLUE` type will result in an `INVALID_INPUT` error.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -227,8 +232,6 @@ module Aws::Athena
     #       Lambda function.
     #
     #       `function=lambda_arn `
-    #
-    #   * The `GLUE` type has no parameters.
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] tags
@@ -342,6 +345,10 @@ module Aws::Athena
     #           publish_cloud_watch_metrics_enabled: false,
     #           bytes_scanned_cutoff_per_query: 1,
     #           requester_pays_enabled: false,
+    #           engine_version: {
+    #             selected_engine_version: "NameString",
+    #             effective_engine_version: "NameString",
+    #           },
     #         },
     #         description: "WorkGroupDescriptionString",
     #         tags: [
@@ -405,8 +412,10 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] type
-    #   The type of data catalog: `LAMBDA` for a federated catalog, `GLUE`
-    #   for AWS Glue Catalog, or `HIVE` for an external hive metastore.
+    #   The type of data catalog: `LAMBDA` for a federated catalog or `HIVE`
+    #   for an external hive metastore. `GLUE` refers to the
+    #   `AwsDataCatalog` that already exists in your account, of which you
+    #   can have only one.
     #   @return [String]
     #
     # @!attribute [rw] parameters
@@ -434,8 +443,6 @@ module Aws::Athena
     #       Lambda function.
     #
     #       `function=lambda_arn `
-    #
-    #   * The `GLUE` type has no parameters.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DataCatalog AWS API Documentation
@@ -570,7 +577,7 @@ module Aws::Athena
     #
     # @!attribute [rw] recursive_delete_option
     #   The option to delete the workgroup and its contents even if the
-    #   workgroup contains any named queries.
+    #   workgroup contains any named queries or query executions.
     #   @return [Boolean]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteWorkGroupInput AWS API Documentation
@@ -622,6 +629,41 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # The Athena engine version for running queries.
+    #
+    # @note When making an API call, you may pass EngineVersion
+    #   data as a hash:
+    #
+    #       {
+    #         selected_engine_version: "NameString",
+    #         effective_engine_version: "NameString",
+    #       }
+    #
+    # @!attribute [rw] selected_engine_version
+    #   The engine version requested by the user. Possible values are
+    #   determined by the output of `ListEngineVersions`, including Auto.
+    #   The default is Auto.
+    #   @return [String]
+    #
+    # @!attribute [rw] effective_engine_version
+    #   Read only. The engine version on which the query runs. If the user
+    #   requests a valid engine version other than Auto, the effective
+    #   engine version is the same as the engine version that the user
+    #   requested. If the user requests Auto, the effective engine version
+    #   is chosen by Athena. When a request to update the engine version is
+    #   made by a `CreateWorkGroup` or `UpdateWorkGroup` operation, the
+    #   `EffectiveEngineVersion` field is ignored.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/EngineVersion AWS API Documentation
+    #
+    class EngineVersion < Struct.new(
+      :selected_engine_version,
+      :effective_engine_version)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass GetDataCatalogInput
     #   data as a hash:
     #
@@ -1022,6 +1064,54 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass ListEngineVersionsInput
+    #   data as a hash:
+    #
+    #       {
+    #         next_token: "Token",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] next_token
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain
+    #   the next set of pages, pass in the `NextToken` from the response
+    #   object of the previous page call.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   The maximum number of engine versions to return in this request.
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListEngineVersionsInput AWS API Documentation
+    #
+    class ListEngineVersionsInput < Struct.new(
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] engine_versions
+    #   A list of engine versions that are available to choose from.
+    #   @return [Array<Types::EngineVersion>]
+    #
+    # @!attribute [rw] next_token
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain
+    #   the next set of pages, pass in the `NextToken` from the response
+    #   object of the previous page call.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListEngineVersionsOutput AWS API Documentation
+    #
+    class ListEngineVersionsOutput < Struct.new(
+      :engine_versions,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass ListNamedQueriesInput
     #   data as a hash:
     #
@@ -1280,8 +1370,8 @@ module Aws::Athena
     end
 
     # @!attribute [rw] work_groups
-    #   The list of workgroups, including their names, descriptions,
-    #   creation times, and states.
+    #   A list of WorkGroupSummary objects that include the names,
+    #   descriptions, creation times, and states for each workgroup.
     #   @return [Array<Types::WorkGroupSummary>]
     #
     # @!attribute [rw] next_token
@@ -1404,6 +1494,10 @@ module Aws::Athena
     #   The name of the workgroup in which the query ran.
     #   @return [String]
     #
+    # @!attribute [rw] engine_version
+    #   The engine version that executed the query.
+    #   @return [Types::EngineVersion]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecution AWS API Documentation
     #
     class QueryExecution < Struct.new(
@@ -1414,7 +1508,8 @@ module Aws::Athena
       :query_execution_context,
       :status,
       :statistics,
-      :work_group)
+      :work_group,
+      :engine_version)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2114,8 +2209,13 @@ module Aws::Athena
     #
     # @!attribute [rw] type
     #   Specifies the type of data catalog to update. Specify `LAMBDA` for a
-    #   federated catalog, `GLUE` for AWS Glue Catalog, or `HIVE` for an
-    #   external hive metastore.
+    #   federated catalog or `HIVE` for an external hive metastore.
+    #
+    #   <note markdown="1"> Do not use the `GLUE` type. This refers to the `AwsDataCatalog` that
+    #   already exists in your account, of which you can have only one.
+    #   Specifying the `GLUE` type will result in an `INVALID_INPUT` error.
+    #
+    #    </note>
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -2148,8 +2248,6 @@ module Aws::Athena
     #       Lambda function.
     #
     #       `function=lambda_arn `
-    #
-    #   * The `GLUE` type has no parameters.
     #   @return [Hash<String,String>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateDataCatalogInput AWS API Documentation
@@ -2188,6 +2286,10 @@ module Aws::Athena
     #           bytes_scanned_cutoff_per_query: 1,
     #           remove_bytes_scanned_cutoff_per_query: false,
     #           requester_pays_enabled: false,
+    #           engine_version: {
+    #             selected_engine_version: "NameString",
+    #             effective_engine_version: "NameString",
+    #           },
     #         },
     #         state: "ENABLED", # accepts ENABLED, DISABLED
     #       }
@@ -2302,6 +2404,10 @@ module Aws::Athena
     #         publish_cloud_watch_metrics_enabled: false,
     #         bytes_scanned_cutoff_per_query: 1,
     #         requester_pays_enabled: false,
+    #         engine_version: {
+    #           selected_engine_version: "NameString",
+    #           effective_engine_version: "NameString",
+    #         },
     #       }
     #
     # @!attribute [rw] result_configuration
@@ -2354,6 +2460,12 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] engine_version
+    #   The engine version that all queries running on the workgroup use.
+    #   Queries on the `AmazonAthenaPreviewFunctionality` workgroup run on
+    #   the preview engine regardless of this setting.
+    #   @return [Types::EngineVersion]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupConfiguration AWS API Documentation
     #
     class WorkGroupConfiguration < Struct.new(
@@ -2361,7 +2473,8 @@ module Aws::Athena
       :enforce_work_group_configuration,
       :publish_cloud_watch_metrics_enabled,
       :bytes_scanned_cutoff_per_query,
-      :requester_pays_enabled)
+      :requester_pays_enabled,
+      :engine_version)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2392,6 +2505,10 @@ module Aws::Athena
     #         bytes_scanned_cutoff_per_query: 1,
     #         remove_bytes_scanned_cutoff_per_query: false,
     #         requester_pays_enabled: false,
+    #         engine_version: {
+    #           selected_engine_version: "NameString",
+    #           effective_engine_version: "NameString",
+    #         },
     #       }
     #
     # @!attribute [rw] enforce_work_group_configuration
@@ -2440,6 +2557,14 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] engine_version
+    #   The engine version requested when a workgroup is updated. After the
+    #   update, all queries on the workgroup run on the requested engine
+    #   version. If no value was previously set, the default is Auto.
+    #   Queries on the `AmazonAthenaPreviewFunctionality` workgroup run on
+    #   the preview engine regardless of this setting.
+    #   @return [Types::EngineVersion]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupConfigurationUpdates AWS API Documentation
     #
     class WorkGroupConfigurationUpdates < Struct.new(
@@ -2448,7 +2573,8 @@ module Aws::Athena
       :publish_cloud_watch_metrics_enabled,
       :bytes_scanned_cutoff_per_query,
       :remove_bytes_scanned_cutoff_per_query,
-      :requester_pays_enabled)
+      :requester_pays_enabled,
+      :engine_version)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2472,13 +2598,20 @@ module Aws::Athena
     #   The workgroup creation date and time.
     #   @return [Time]
     #
+    # @!attribute [rw] engine_version
+    #   The engine version setting for all queries on the workgroup. Queries
+    #   on the `AmazonAthenaPreviewFunctionality` workgroup run on the
+    #   preview engine regardless of this setting.
+    #   @return [Types::EngineVersion]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupSummary AWS API Documentation
     #
     class WorkGroupSummary < Struct.new(
       :name,
       :state,
       :description,
-      :creation_time)
+      :creation_time,
+      :engine_version)
       SENSITIVE = []
       include Aws::Structure
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.34.0
+  version: 1.35.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-02-02 00:00:00.000000000 Z
+date: 2021-02-04 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core