aws-sdk-athena 1.52.0 → 1.55.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a8b8b6530d32dc05758dff613a83c110600fb7830f0ffaf07d516686f8f43b9e
-  data.tar.gz: e49d2175aa7b1a4d078fb2d751df78db378b779b64bfd7d4b9951598d2fd879a
+  metadata.gz: d93a10bf117ae8c6ab4bb6e57c3fbe33d4b116abe69e9f38786486ebba621cfb
+  data.tar.gz: c08af9b491cbacbd85e97ed2a1e9b93fc56a716704e33ed780fe738d14da62d3
 SHA512:
-  metadata.gz: bbf9867493f0ab6a68ca13fb32914dad2b888f0250022969053020aaf5766c7c45bbcbe42158b24ef557b6678f3419476813baa52c91290d8d06f2657259e2d2
-  data.tar.gz: 6b9a5ba85d3db12347c340493db813ad4b2d27270509b4e00689eaa8a26d2467f7be8d0e9a6f65762d8ed504d9fce4e75e9a20b01be67eb23228b73250342e97
+  metadata.gz: 88a9ab5998ed7f54646b12ca95e92ede86b620ef0cbd6686d081862cc145b0b906772de30601fb0e9701911919e3c67c5fe9f7e11dbb0bf487d503e05e1e9e04
+  data.tar.gz: e4113fed8f2052810d2db2883fed1715e46790e43595357b0c29cbfb71fe3a18a7ebb3a7313b63178bd067b84af0521281f7b2a901f94782aec384528b14d1e0

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.55.0 (2022-07-14)
+------------------
+
+* Feature - This release updates data types that contain either QueryExecutionId, NamedQueryId or ExpectedBucketOwner. Ids must be between 1 and 128 characters and contain only non-whitespace characters. ExpectedBucketOwner must be 12-digit string.
+
+1.54.0 (2022-06-30)
+------------------
+
+* Feature - This feature introduces the API support for Athena's parameterized query and BatchGetPreparedStatement API.
+
+1.53.0 (2022-04-15)
+------------------
+
+* Feature - This release adds subfields, ErrorMessage, Retryable, to the AthenaError response object in the GetQueryExecution API when a query fails.
+
 1.52.0 (2022-03-02)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.52.0
+1.55.0

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

@@ -409,6 +409,53 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Returns the details of a single prepared statement or a list of up to
+    # 256 prepared statements for the array of prepared statement names that
+    # you provide. Requires you to have access to the workgroup to which the
+    # prepared statements belong. If a prepared statement cannot be
+    # retrieved for the name specified, the statement is listed in
+    # `UnprocessedPreparedStatementNames`.
+    #
+    # @option params [required, Array<String>] :prepared_statement_names
+    #   A list of prepared statement names to return.
+    #
+    # @option params [required, String] :work_group
+    #   The name of the workgroup to which the prepared statements belong.
+    #
+    # @return [Types::BatchGetPreparedStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::BatchGetPreparedStatementOutput#prepared_statements #prepared_statements} => Array&lt;Types::PreparedStatement&gt;
+    #   * {Types::BatchGetPreparedStatementOutput#unprocessed_prepared_statement_names #unprocessed_prepared_statement_names} => Array&lt;Types::UnprocessedPreparedStatementName&gt;
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.batch_get_prepared_statement({
+    #     prepared_statement_names: ["StatementName"], # required
+    #     work_group: "WorkGroupName", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.prepared_statements #=> Array
+    #   resp.prepared_statements[0].statement_name #=> String
+    #   resp.prepared_statements[0].query_statement #=> String
+    #   resp.prepared_statements[0].work_group_name #=> String
+    #   resp.prepared_statements[0].description #=> String
+    #   resp.prepared_statements[0].last_modified_time #=> Time
+    #   resp.unprocessed_prepared_statement_names #=> Array
+    #   resp.unprocessed_prepared_statement_names[0].statement_name #=> String
+    #   resp.unprocessed_prepared_statement_names[0].error_code #=> String
+    #   resp.unprocessed_prepared_statement_names[0].error_message #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetPreparedStatement AWS API Documentation
+    #
+    # @overload batch_get_prepared_statement(params = {})
+    # @param [Hash] params ({})
+    def batch_get_prepared_statement(params = {}, options = {})
+      req = build_request(:batch_get_prepared_statement, params)
+      req.send_request(options)
+    end
+
     # Returns the details of a single query execution or a list of up to 50
     # query executions, which you provide as an array of query execution ID
     # strings. Requires you to have access to the workgroup in which the
@@ -450,6 +497,8 @@ module Aws::Athena
     #   resp.query_executions[0].status.completion_date_time #=> Time
     #   resp.query_executions[0].status.athena_error.error_category #=> Integer
     #   resp.query_executions[0].status.athena_error.error_type #=> Integer
+    #   resp.query_executions[0].status.athena_error.retryable #=> Boolean
+    #   resp.query_executions[0].status.athena_error.error_message #=> String
     #   resp.query_executions[0].statistics.engine_execution_time_in_millis #=> Integer
     #   resp.query_executions[0].statistics.data_scanned_in_bytes #=> Integer
     #   resp.query_executions[0].statistics.data_manifest_location #=> String
@@ -460,6 +509,8 @@ module Aws::Athena
     #   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.query_executions[0].execution_parameters #=> Array
+    #   resp.query_executions[0].execution_parameters[0] #=> 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
@@ -703,12 +754,12 @@ module Aws::Athena
     #     name: "WorkGroupName", # required
     #     configuration: {
     #       result_configuration: {
-    #         output_location: "String",
+    #         output_location: "ResultOutputLocation",
     #         encryption_configuration: {
     #           encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #           kms_key: "String",
     #         },
-    #         expected_bucket_owner: "String",
+    #         expected_bucket_owner: "AwsAccountId",
     #         acl_configuration: {
     #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
     #         },
@@ -1024,6 +1075,8 @@ module Aws::Athena
     #   resp.query_execution.status.completion_date_time #=> Time
     #   resp.query_execution.status.athena_error.error_category #=> Integer
     #   resp.query_execution.status.athena_error.error_type #=> Integer
+    #   resp.query_execution.status.athena_error.retryable #=> Boolean
+    #   resp.query_execution.status.athena_error.error_message #=> String
     #   resp.query_execution.statistics.engine_execution_time_in_millis #=> Integer
     #   resp.query_execution.statistics.data_scanned_in_bytes #=> Integer
     #   resp.query_execution.statistics.data_manifest_location #=> String
@@ -1034,6 +1087,8 @@ module Aws::Athena
     #   resp.query_execution.work_group #=> String
     #   resp.query_execution.engine_version.selected_engine_version #=> String
     #   resp.query_execution.engine_version.effective_engine_version #=> String
+    #   resp.query_execution.execution_parameters #=> Array
+    #   resp.query_execution.execution_parameters[0] #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution AWS API Documentation
     #
@@ -1396,7 +1451,7 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Lists the prepared statements in the specfied workgroup.
+    # Lists the prepared statements in the specified workgroup.
     #
     # @option params [required, String] :work_group
     #   The workgroup to list the prepared statements for.
@@ -1701,6 +1756,11 @@ module Aws::Athena
     # @option params [String] :work_group
     #   The name of the workgroup in which the query is being started.
     #
+    # @option params [Array<String>] :execution_parameters
+    #   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.
+    #
     # @return [Types::StartQueryExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::StartQueryExecutionOutput#query_execution_id #query_execution_id} => String
@@ -1715,17 +1775,18 @@ module Aws::Athena
     #       catalog: "CatalogNameString",
     #     },
     #     result_configuration: {
-    #       output_location: "String",
+    #       output_location: "ResultOutputLocation",
     #       encryption_configuration: {
     #         encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #         kms_key: "String",
     #       },
-    #       expected_bucket_owner: "String",
+    #       expected_bucket_owner: "AwsAccountId",
     #       acl_configuration: {
     #         s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
     #       },
     #     },
     #     work_group: "WorkGroupName",
+    #     execution_parameters: ["ExecutionParameter"],
     #   })
     #
     # @example Response structure
@@ -2011,14 +2072,14 @@ module Aws::Athena
     #     configuration_updates: {
     #       enforce_work_group_configuration: false,
     #       result_configuration_updates: {
-    #         output_location: "String",
+    #         output_location: "ResultOutputLocation",
     #         remove_output_location: false,
     #         encryption_configuration: {
     #           encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #           kms_key: "String",
     #         },
     #         remove_encryption_configuration: false,
-    #         expected_bucket_owner: "String",
+    #         expected_bucket_owner: "AwsAccountId",
     #         remove_expected_bucket_owner: false,
     #         acl_configuration: {
     #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
@@ -2059,7 +2120,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.52.0'
+      context[:gem_version] = '1.55.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -16,8 +16,11 @@ module Aws::Athena
     AclConfiguration = Shapes::StructureShape.new(name: 'AclConfiguration')
     AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
     AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
+    AwsAccountId = Shapes::StringShape.new(name: 'AwsAccountId')
     BatchGetNamedQueryInput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryInput')
     BatchGetNamedQueryOutput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryOutput')
+    BatchGetPreparedStatementInput = Shapes::StructureShape.new(name: 'BatchGetPreparedStatementInput')
+    BatchGetPreparedStatementOutput = Shapes::StructureShape.new(name: 'BatchGetPreparedStatementOutput')
     BatchGetQueryExecutionInput = Shapes::StructureShape.new(name: 'BatchGetQueryExecutionInput')
     BatchGetQueryExecutionOutput = Shapes::StructureShape.new(name: 'BatchGetQueryExecutionOutput')
     Boolean = Shapes::BooleanShape.new(name: 'Boolean')
@@ -64,6 +67,8 @@ module Aws::Athena
     ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     ErrorType = Shapes::IntegerShape.new(name: 'ErrorType')
+    ExecutionParameter = Shapes::StringShape.new(name: 'ExecutionParameter')
+    ExecutionParameters = Shapes::ListShape.new(name: 'ExecutionParameters')
     ExpressionString = Shapes::StringShape.new(name: 'ExpressionString')
     GetDataCatalogInput = Shapes::StructureShape.new(name: 'GetDataCatalogInput')
     GetDataCatalogOutput = Shapes::StructureShape.new(name: 'GetDataCatalogOutput')
@@ -125,6 +130,8 @@ module Aws::Athena
     ParametersMap = Shapes::MapShape.new(name: 'ParametersMap')
     ParametersMapValue = Shapes::StringShape.new(name: 'ParametersMapValue')
     PreparedStatement = Shapes::StructureShape.new(name: 'PreparedStatement')
+    PreparedStatementDetailsList = Shapes::ListShape.new(name: 'PreparedStatementDetailsList')
+    PreparedStatementNameList = Shapes::ListShape.new(name: 'PreparedStatementNameList')
     PreparedStatementSummary = Shapes::StructureShape.new(name: 'PreparedStatementSummary')
     PreparedStatementsList = Shapes::ListShape.new(name: 'PreparedStatementsList')
     QueryExecution = Shapes::StructureShape.new(name: 'QueryExecution')
@@ -139,6 +146,7 @@ module Aws::Athena
     ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
     ResultConfiguration = Shapes::StructureShape.new(name: 'ResultConfiguration')
     ResultConfigurationUpdates = Shapes::StructureShape.new(name: 'ResultConfigurationUpdates')
+    ResultOutputLocation = Shapes::StringShape.new(name: 'ResultOutputLocation')
     ResultSet = Shapes::StructureShape.new(name: 'ResultSet')
     ResultSetMetadata = Shapes::StructureShape.new(name: 'ResultSetMetadata')
     Row = Shapes::StructureShape.new(name: 'Row')
@@ -168,6 +176,8 @@ module Aws::Athena
     TypeString = Shapes::StringShape.new(name: 'TypeString')
     UnprocessedNamedQueryId = Shapes::StructureShape.new(name: 'UnprocessedNamedQueryId')
     UnprocessedNamedQueryIdList = Shapes::ListShape.new(name: 'UnprocessedNamedQueryIdList')
+    UnprocessedPreparedStatementName = Shapes::StructureShape.new(name: 'UnprocessedPreparedStatementName')
+    UnprocessedPreparedStatementNameList = Shapes::ListShape.new(name: 'UnprocessedPreparedStatementNameList')
     UnprocessedQueryExecutionId = Shapes::StructureShape.new(name: 'UnprocessedQueryExecutionId')
     UnprocessedQueryExecutionIdList = Shapes::ListShape.new(name: 'UnprocessedQueryExecutionIdList')
     UntagResourceInput = Shapes::StructureShape.new(name: 'UntagResourceInput')
@@ -196,6 +206,8 @@ module Aws::Athena
 
     AthenaError.add_member(:error_category, Shapes::ShapeRef.new(shape: ErrorCategory, location_name: "ErrorCategory"))
     AthenaError.add_member(:error_type, Shapes::ShapeRef.new(shape: ErrorType, location_name: "ErrorType"))
+    AthenaError.add_member(:retryable, Shapes::ShapeRef.new(shape: Boolean, location_name: "Retryable"))
+    AthenaError.add_member(:error_message, Shapes::ShapeRef.new(shape: String, location_name: "ErrorMessage"))
     AthenaError.struct_class = Types::AthenaError
 
     BatchGetNamedQueryInput.add_member(:named_query_ids, Shapes::ShapeRef.new(shape: NamedQueryIdList, required: true, location_name: "NamedQueryIds"))
@@ -205,6 +217,14 @@ module Aws::Athena
     BatchGetNamedQueryOutput.add_member(:unprocessed_named_query_ids, Shapes::ShapeRef.new(shape: UnprocessedNamedQueryIdList, location_name: "UnprocessedNamedQueryIds"))
     BatchGetNamedQueryOutput.struct_class = Types::BatchGetNamedQueryOutput
 
+    BatchGetPreparedStatementInput.add_member(:prepared_statement_names, Shapes::ShapeRef.new(shape: PreparedStatementNameList, required: true, location_name: "PreparedStatementNames"))
+    BatchGetPreparedStatementInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, required: true, location_name: "WorkGroup"))
+    BatchGetPreparedStatementInput.struct_class = Types::BatchGetPreparedStatementInput
+
+    BatchGetPreparedStatementOutput.add_member(:prepared_statements, Shapes::ShapeRef.new(shape: PreparedStatementDetailsList, location_name: "PreparedStatements"))
+    BatchGetPreparedStatementOutput.add_member(:unprocessed_prepared_statement_names, Shapes::ShapeRef.new(shape: UnprocessedPreparedStatementNameList, location_name: "UnprocessedPreparedStatementNames"))
+    BatchGetPreparedStatementOutput.struct_class = Types::BatchGetPreparedStatementOutput
+
     BatchGetQueryExecutionInput.add_member(:query_execution_ids, Shapes::ShapeRef.new(shape: QueryExecutionIdList, required: true, location_name: "QueryExecutionIds"))
     BatchGetQueryExecutionInput.struct_class = Types::BatchGetQueryExecutionInput
 
@@ -323,6 +343,8 @@ module Aws::Athena
 
     EngineVersionsList.member = Shapes::ShapeRef.new(shape: EngineVersion)
 
+    ExecutionParameters.member = Shapes::ShapeRef.new(shape: ExecutionParameter)
+
     GetDataCatalogInput.add_member(:name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "Name"))
     GetDataCatalogInput.struct_class = Types::GetDataCatalogInput
 
@@ -491,6 +513,10 @@ module Aws::Athena
     PreparedStatement.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Date, location_name: "LastModifiedTime"))
     PreparedStatement.struct_class = Types::PreparedStatement
 
+    PreparedStatementDetailsList.member = Shapes::ShapeRef.new(shape: PreparedStatement)
+
+    PreparedStatementNameList.member = Shapes::ShapeRef.new(shape: StatementName)
+
     PreparedStatementSummary.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementName, location_name: "StatementName"))
     PreparedStatementSummary.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Date, location_name: "LastModifiedTime"))
     PreparedStatementSummary.struct_class = Types::PreparedStatementSummary
@@ -506,6 +532,7 @@ module Aws::Athena
     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.add_member(:execution_parameters, Shapes::ShapeRef.new(shape: ExecutionParameters, location_name: "ExecutionParameters"))
     QueryExecution.struct_class = Types::QueryExecution
 
     QueryExecutionContext.add_member(:database, Shapes::ShapeRef.new(shape: DatabaseString, location_name: "Database"))
@@ -536,17 +563,17 @@ module Aws::Athena
     ResourceNotFoundException.add_member(:resource_name, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "ResourceName"))
     ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
 
-    ResultConfiguration.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
+    ResultConfiguration.add_member(:output_location, Shapes::ShapeRef.new(shape: ResultOutputLocation, location_name: "OutputLocation"))
     ResultConfiguration.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
-    ResultConfiguration.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
+    ResultConfiguration.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: AwsAccountId, location_name: "ExpectedBucketOwner"))
     ResultConfiguration.add_member(:acl_configuration, Shapes::ShapeRef.new(shape: AclConfiguration, location_name: "AclConfiguration"))
     ResultConfiguration.struct_class = Types::ResultConfiguration
 
-    ResultConfigurationUpdates.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
+    ResultConfigurationUpdates.add_member(:output_location, Shapes::ShapeRef.new(shape: ResultOutputLocation, location_name: "OutputLocation"))
     ResultConfigurationUpdates.add_member(:remove_output_location, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveOutputLocation"))
     ResultConfigurationUpdates.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
     ResultConfigurationUpdates.add_member(:remove_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveEncryptionConfiguration"))
-    ResultConfigurationUpdates.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
+    ResultConfigurationUpdates.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: AwsAccountId, location_name: "ExpectedBucketOwner"))
     ResultConfigurationUpdates.add_member(:remove_expected_bucket_owner, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveExpectedBucketOwner"))
     ResultConfigurationUpdates.add_member(:acl_configuration, Shapes::ShapeRef.new(shape: AclConfiguration, location_name: "AclConfiguration"))
     ResultConfigurationUpdates.add_member(:remove_acl_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveAclConfiguration"))
@@ -569,6 +596,7 @@ module Aws::Athena
     StartQueryExecutionInput.add_member(:query_execution_context, Shapes::ShapeRef.new(shape: QueryExecutionContext, location_name: "QueryExecutionContext"))
     StartQueryExecutionInput.add_member(:result_configuration, Shapes::ShapeRef.new(shape: ResultConfiguration, location_name: "ResultConfiguration"))
     StartQueryExecutionInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
+    StartQueryExecutionInput.add_member(:execution_parameters, Shapes::ShapeRef.new(shape: ExecutionParameters, location_name: "ExecutionParameters"))
     StartQueryExecutionInput.struct_class = Types::StartQueryExecutionInput
 
     StartQueryExecutionOutput.add_member(:query_execution_id, Shapes::ShapeRef.new(shape: QueryExecutionId, location_name: "QueryExecutionId"))
@@ -615,6 +643,13 @@ module Aws::Athena
 
     UnprocessedNamedQueryIdList.member = Shapes::ShapeRef.new(shape: UnprocessedNamedQueryId)
 
+    UnprocessedPreparedStatementName.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementName, location_name: "StatementName"))
+    UnprocessedPreparedStatementName.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, location_name: "ErrorCode"))
+    UnprocessedPreparedStatementName.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
+    UnprocessedPreparedStatementName.struct_class = Types::UnprocessedPreparedStatementName
+
+    UnprocessedPreparedStatementNameList.member = Shapes::ShapeRef.new(shape: UnprocessedPreparedStatementName)
+
     UnprocessedQueryExecutionId.add_member(:query_execution_id, Shapes::ShapeRef.new(shape: QueryExecutionId, location_name: "QueryExecutionId"))
     UnprocessedQueryExecutionId.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, location_name: "ErrorCode"))
     UnprocessedQueryExecutionId.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
@@ -723,6 +758,16 @@ module Aws::Athena
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
       end)
 
+      api.add_operation(:batch_get_prepared_statement, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "BatchGetPreparedStatement"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: BatchGetPreparedStatementInput)
+        o.output = Shapes::ShapeRef.new(shape: BatchGetPreparedStatementOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+      end)
+
       api.add_operation(:batch_get_query_execution, Seahorse::Model::Operation.new.tap do |o|
         o.name = "BatchGetQueryExecution"
         o.http_method = "POST"

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

@@ -77,15 +77,27 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/error-reference.html#error-reference-error-type-reference
     #   @return [Integer]
     #
+    # @!attribute [rw] retryable
+    #   True if the query might succeed if resubmitted.
+    #   @return [Boolean]
+    #
+    # @!attribute [rw] error_message
+    #   Contains a short description of the error that occurred.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AthenaError AWS API Documentation
     #
     class AthenaError < Struct.new(
       :error_category,
-      :error_type)
+      :error_type,
+      :retryable,
+      :error_message)
       SENSITIVE = []
       include Aws::Structure
     end
 
+    # Contains an array of named query IDs.
+    #
     # @note When making an API call, you may pass BatchGetNamedQueryInput
     #   data as a hash:
     #
@@ -122,6 +134,51 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # @note When making an API call, you may pass BatchGetPreparedStatementInput
+    #   data as a hash:
+    #
+    #       {
+    #         prepared_statement_names: ["StatementName"], # required
+    #         work_group: "WorkGroupName", # required
+    #       }
+    #
+    # @!attribute [rw] prepared_statement_names
+    #   A list of prepared statement names to return.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] work_group
+    #   The name of the workgroup to which the prepared statements belong.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetPreparedStatementInput AWS API Documentation
+    #
+    class BatchGetPreparedStatementInput < Struct.new(
+      :prepared_statement_names,
+      :work_group)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] prepared_statements
+    #   The list of prepared statements returned.
+    #   @return [Array<Types::PreparedStatement>]
+    #
+    # @!attribute [rw] unprocessed_prepared_statement_names
+    #   A list of one or more prepared statements that were requested but
+    #   could not be returned.
+    #   @return [Array<Types::UnprocessedPreparedStatementName>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetPreparedStatementOutput AWS API Documentation
+    #
+    class BatchGetPreparedStatementOutput < Struct.new(
+      :prepared_statements,
+      :unprocessed_prepared_statement_names)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains an array of query execution IDs.
+    #
     # @note When making an API call, you may pass BatchGetQueryExecutionInput
     #   data as a hash:
     #
@@ -467,12 +524,12 @@ module Aws::Athena
     #         name: "WorkGroupName", # required
     #         configuration: {
     #           result_configuration: {
-    #             output_location: "String",
+    #             output_location: "ResultOutputLocation",
     #             encryption_configuration: {
     #               encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #               kms_key: "String",
     #             },
-    #             expected_bucket_owner: "String",
+    #             expected_bucket_owner: "AwsAccountId",
     #             acl_configuration: {
     #               s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
     #             },
@@ -778,7 +835,7 @@ module Aws::Athena
     class DeleteWorkGroupOutput < Aws::EmptyStructure; end
 
     # If query results are encrypted in Amazon S3, indicates the encryption
-    # option used (for example, `SSE-KMS` or `CSE-KMS`) and key information.
+    # option used (for example, `SSE_KMS` or `CSE_KMS`) and key information.
     #
     # @note When making an API call, you may pass EncryptionConfiguration
     #   data as a hash:
@@ -790,9 +847,9 @@ module Aws::Athena
     #
     # @!attribute [rw] encryption_option
     #   Indicates whether Amazon S3 server-side encryption with Amazon
-    #   S3-managed keys (`SSE-S3`), server-side encryption with KMS-managed
-    #   keys (`SSE-KMS`), or client-side encryption with KMS-managed keys
-    #   (CSE-KMS) is used.
+    #   S3-managed keys (`SSE_S3`), server-side encryption with KMS-managed
+    #   keys (`SSE_KMS`), or client-side encryption with KMS-managed keys
+    #   (`CSE_KMS`) is used.
     #
     #   If a query runs in a workgroup and the workgroup overrides
     #   client-side settings, then the workgroup's setting for encryption
@@ -801,7 +858,7 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] kms_key
-    #   For `SSE-KMS` and `CSE-KMS`, this is the KMS key ARN or ID.
+    #   For `SSE_KMS` and `CSE_KMS`, this is the KMS key ARN or ID.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/EncryptionConfiguration AWS API Documentation
@@ -1827,6 +1884,12 @@ module Aws::Athena
     #   The engine version that executed the query.
     #   @return [Types::EngineVersion]
     #
+    # @!attribute [rw] execution_parameters
+    #   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.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecution AWS API Documentation
     #
     class QueryExecution < Struct.new(
@@ -1838,7 +1901,8 @@ module Aws::Athena
       :status,
       :statistics,
       :work_group,
-      :engine_version)
+      :engine_version,
+      :execution_parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1989,6 +2053,7 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] resource_name
+    #   The name of the Amazon resource.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResourceNotFoundException AWS API Documentation
@@ -2009,12 +2074,12 @@ module Aws::Athena
     #   data as a hash:
     #
     #       {
-    #         output_location: "String",
+    #         output_location: "ResultOutputLocation",
     #         encryption_configuration: {
     #           encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #           kms_key: "String",
     #         },
-    #         expected_bucket_owner: "String",
+    #         expected_bucket_owner: "AwsAccountId",
     #         acl_configuration: {
     #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
     #         },
@@ -2039,7 +2104,7 @@ module Aws::Athena
     #
     # @!attribute [rw] encryption_configuration
     #   If query results are encrypted in Amazon S3, indicates the
-    #   encryption option used (for example, `SSE-KMS` or `CSE-KMS`) and key
+    #   encryption option used (for example, `SSE_KMS` or `CSE_KMS`) 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
@@ -2107,14 +2172,14 @@ module Aws::Athena
     #   data as a hash:
     #
     #       {
-    #         output_location: "String",
+    #         output_location: "ResultOutputLocation",
     #         remove_output_location: false,
     #         encryption_configuration: {
     #           encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #           kms_key: "String",
     #         },
     #         remove_encryption_configuration: false,
-    #         expected_bucket_owner: "String",
+    #         expected_bucket_owner: "AwsAccountId",
     #         remove_expected_bucket_owner: false,
     #         acl_configuration: {
     #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
@@ -2305,17 +2370,18 @@ module Aws::Athena
     #           catalog: "CatalogNameString",
     #         },
     #         result_configuration: {
-    #           output_location: "String",
+    #           output_location: "ResultOutputLocation",
     #           encryption_configuration: {
     #             encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #             kms_key: "String",
     #           },
-    #           expected_bucket_owner: "String",
+    #           expected_bucket_owner: "AwsAccountId",
     #           acl_configuration: {
     #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
     #           },
     #         },
     #         work_group: "WorkGroupName",
+    #         execution_parameters: ["ExecutionParameter"],
     #       }
     #
     # @!attribute [rw] query_string
@@ -2357,6 +2423,12 @@ module Aws::Athena
     #   The name of the workgroup in which the query is being started.
     #   @return [String]
     #
+    # @!attribute [rw] execution_parameters
+    #   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.
+    #   @return [Array<String>]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecutionInput AWS API Documentation
     #
     class StartQueryExecutionInput < Struct.new(
@@ -2364,7 +2436,8 @@ module Aws::Athena
       :client_request_token,
       :query_execution_context,
       :result_configuration,
-      :work_group)
+      :work_group,
+      :execution_parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2580,6 +2653,42 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # The name of a prepared statement that could not be returned.
+    #
+    # @!attribute [rw] statement_name
+    #   The name of a prepared statement that could not be returned due to
+    #   an error.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_code
+    #   The error code returned when the request for the prepared statement
+    #   failed.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_message
+    #   The error message containing the reason why the prepared statement
+    #   could not be returned. The following error messages are possible:
+    #
+    #   * `INVALID_INPUT` - The name of the prepared statement that was
+    #     provided is not valid (for example, the name is too long).
+    #
+    #   * `STATEMENT_NOT_FOUND` - A prepared statement with the name
+    #     provided could not be found.
+    #
+    #   * `UNAUTHORIZED` - The requester does not have permission to access
+    #     the workgroup that contains the prepared statement.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UnprocessedPreparedStatementName AWS API Documentation
+    #
+    class UnprocessedPreparedStatementName < Struct.new(
+      :statement_name,
+      :error_code,
+      :error_message)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Describes a query execution that failed to process.
     #
     # @!attribute [rw] query_execution_id
@@ -2800,14 +2909,14 @@ module Aws::Athena
     #         configuration_updates: {
     #           enforce_work_group_configuration: false,
     #           result_configuration_updates: {
-    #             output_location: "String",
+    #             output_location: "ResultOutputLocation",
     #             remove_output_location: false,
     #             encryption_configuration: {
     #               encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #               kms_key: "String",
     #             },
     #             remove_encryption_configuration: false,
-    #             expected_bucket_owner: "String",
+    #             expected_bucket_owner: "AwsAccountId",
     #             remove_expected_bucket_owner: false,
     #             acl_configuration: {
     #               s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
@@ -2926,12 +3035,12 @@ module Aws::Athena
     #
     #       {
     #         result_configuration: {
-    #           output_location: "String",
+    #           output_location: "ResultOutputLocation",
     #           encryption_configuration: {
     #             encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #             kms_key: "String",
     #           },
-    #           expected_bucket_owner: "String",
+    #           expected_bucket_owner: "AwsAccountId",
     #           acl_configuration: {
     #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
     #           },
@@ -3029,14 +3138,14 @@ module Aws::Athena
     #       {
     #         enforce_work_group_configuration: false,
     #         result_configuration_updates: {
-    #           output_location: "String",
+    #           output_location: "ResultOutputLocation",
     #           remove_output_location: false,
     #           encryption_configuration: {
     #             encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
     #             kms_key: "String",
     #           },
     #           remove_encryption_configuration: false,
-    #           expected_bucket_owner: "String",
+    #           expected_bucket_owner: "AwsAccountId",
     #           remove_expected_bucket_owner: false,
     #           acl_configuration: {
     #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL

data/lib/aws-sdk-athena.rb

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

metadata

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