aws-sdk-athena 1.51.0 → 1.54.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '0687af810b3e4362e24590cbad3f7d1268fd4cb23024a6edcc8b5dad6b117049'
-  data.tar.gz: 86b8e28554230e7d03c88d73d5a431677e024a5780cdcb700b594487eec11549
+  metadata.gz: cee70bdcc6ab700eeb11158edbc2bb745af148eea586294ba4142df7bb47204d
+  data.tar.gz: 280a727beec9639123a521f021f374b7ad6ab410ab3a6fefd70d3596a66dcf61
 SHA512:
-  metadata.gz: f6fa542f8be717ba15b5d06759909313ea0c1073df477496ccb8f22f6deb1f16b60ac5b14e7ddfcbbb6ee6f2637ebe97a8580de5eeae8cb261cf4c0e64399ec3
-  data.tar.gz: bb09d6c920f592b74692a85ed0c8918f967c145d2a8a59ade110454d2c920ef517432a43a62377ac2a8ebded912980c79443982831404b3f9028de4fd1ab260d
+  metadata.gz: db41ec6386f593a687cca832efbf2e66ecf9bd5a0f159a8dc5e516a4d6162d6094b1036afefd3b6ff4956ee9e45d25667ed22f21427bf0863c9290f86a550ff6
+  data.tar.gz: 28bcdfbc159efb09fbbe90559d887295e490d869775c259f9e1d4537f61454f23708a94274fb107876644e1c3cee417f7a31309b569d48ab13cfd2adba65f617

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+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)
+------------------
+
+* Feature - This release adds support for S3 Object Ownership by allowing the S3 bucket owner full control canned ACL to be set when Athena writes query results to S3 buckets.
+
 1.51.0 (2022-02-28)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.51.0
+1.54.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
@@ -441,6 +488,7 @@ module Aws::Athena
     #   resp.query_executions[0].result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.query_executions[0].result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_executions[0].result_configuration.expected_bucket_owner #=> String
+    #   resp.query_executions[0].result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
     #   resp.query_executions[0].query_execution_context.database #=> String
     #   resp.query_executions[0].query_execution_context.catalog #=> String
     #   resp.query_executions[0].status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
@@ -449,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
@@ -459,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
@@ -708,6 +760,9 @@ module Aws::Athena
     #           kms_key: "String",
     #         },
     #         expected_bucket_owner: "String",
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
     #       },
     #       enforce_work_group_configuration: false,
     #       publish_cloud_watch_metrics_enabled: false,
@@ -1011,6 +1066,7 @@ module Aws::Athena
     #   resp.query_execution.result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.query_execution.result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_execution.result_configuration.expected_bucket_owner #=> String
+    #   resp.query_execution.result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
     #   resp.query_execution.query_execution_context.database #=> String
     #   resp.query_execution.query_execution_context.catalog #=> String
     #   resp.query_execution.status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
@@ -1019,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
@@ -1029,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
     #
@@ -1188,6 +1248,7 @@ module Aws::Athena
     #   resp.work_group.configuration.result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.work_group.configuration.result_configuration.encryption_configuration.kms_key #=> String
     #   resp.work_group.configuration.result_configuration.expected_bucket_owner #=> String
+    #   resp.work_group.configuration.result_configuration.acl_configuration.s3_acl_option #=> String, one of "BUCKET_OWNER_FULL_CONTROL"
     #   resp.work_group.configuration.enforce_work_group_configuration #=> Boolean
     #   resp.work_group.configuration.publish_cloud_watch_metrics_enabled #=> Boolean
     #   resp.work_group.configuration.bytes_scanned_cutoff_per_query #=> Integer
@@ -1390,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.
@@ -1695,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,8 +1781,12 @@ module Aws::Athena
     #         kms_key: "String",
     #       },
     #       expected_bucket_owner: "String",
+    #       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,6 +2081,10 @@ module Aws::Athena
     #         remove_encryption_configuration: false,
     #         expected_bucket_owner: "String",
     #         remove_expected_bucket_owner: false,
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
+    #         remove_acl_configuration: false,
     #       },
     #       publish_cloud_watch_metrics_enabled: false,
     #       bytes_scanned_cutoff_per_query: 1,
@@ -2046,7 +2120,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.51.0'
+      context[:gem_version] = '1.54.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -13,10 +13,13 @@ module Aws::Athena
 
     include Seahorse::Model
 
+    AclConfiguration = Shapes::StructureShape.new(name: 'AclConfiguration')
     AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
     AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
     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')
@@ -63,6 +66,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')
@@ -124,6 +129,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')
@@ -142,6 +149,7 @@ module Aws::Athena
     ResultSetMetadata = Shapes::StructureShape.new(name: 'ResultSetMetadata')
     Row = Shapes::StructureShape.new(name: 'Row')
     RowList = Shapes::ListShape.new(name: 'RowList')
+    S3AclOption = Shapes::StringShape.new(name: 'S3AclOption')
     StartQueryExecutionInput = Shapes::StructureShape.new(name: 'StartQueryExecutionInput')
     StartQueryExecutionOutput = Shapes::StructureShape.new(name: 'StartQueryExecutionOutput')
     StatementName = Shapes::StringShape.new(name: 'StatementName')
@@ -166,6 +174,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')
@@ -189,8 +199,13 @@ module Aws::Athena
     datumList = Shapes::ListShape.new(name: 'datumList')
     datumString = Shapes::StringShape.new(name: 'datumString')
 
+    AclConfiguration.add_member(:s3_acl_option, Shapes::ShapeRef.new(shape: S3AclOption, required: true, location_name: "S3AclOption"))
+    AclConfiguration.struct_class = Types::AclConfiguration
+
     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"))
@@ -200,6 +215,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
 
@@ -318,6 +341,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
 
@@ -486,6 +511,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
@@ -501,6 +530,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"))
@@ -534,6 +564,7 @@ module Aws::Athena
     ResultConfiguration.add_member(:output_location, Shapes::ShapeRef.new(shape: String, 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(: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"))
@@ -542,6 +573,8 @@ module Aws::Athena
     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(: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"))
     ResultConfigurationUpdates.struct_class = Types::ResultConfigurationUpdates
 
     ResultSet.add_member(:rows, Shapes::ShapeRef.new(shape: RowList, location_name: "Rows"))
@@ -561,6 +594,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"))
@@ -607,6 +641,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"))
@@ -715,6 +756,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

@@ -10,6 +10,45 @@
 module Aws::Athena
   module Types
 
+    # Indicates that an Amazon S3 canned ACL should be set to control
+    # ownership of stored query results. When Athena stores query results in
+    # Amazon S3, the canned ACL is set with the `x-amz-acl` request header.
+    # For more information about S3 Object Ownership, see [Object Ownership
+    # settings][1] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html#object-ownership-overview
+    #
+    # @note When making an API call, you may pass AclConfiguration
+    #   data as a hash:
+    #
+    #       {
+    #         s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #       }
+    #
+    # @!attribute [rw] s3_acl_option
+    #   The Amazon S3 canned ACL that Athena should specify when storing
+    #   query results. Currently the only supported canned ACL is
+    #   `BUCKET_OWNER_FULL_CONTROL`. If a query runs in a workgroup and the
+    #   workgroup overrides client-side settings, then the Amazon S3 canned
+    #   ACL specified in the workgroup's settings is used for all queries
+    #   that run in the workgroup. For more information about Amazon S3
+    #   canned ACLs, see [Canned ACL][1] in the *Amazon S3 User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html#canned-acl
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AclConfiguration AWS API Documentation
+    #
+    class AclConfiguration < Struct.new(
+      :s3_acl_option)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Provides information about an Athena query error. The `AthenaError`
     # feature provides standardized error information to help you understand
     # failed queries and take steps after a query failure occurs.
@@ -38,11 +77,21 @@ 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
@@ -83,6 +132,49 @@ 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
+
     # @note When making an API call, you may pass BatchGetQueryExecutionInput
     #   data as a hash:
     #
@@ -434,6 +526,9 @@ module Aws::Athena
     #               kms_key: "String",
     #             },
     #             expected_bucket_owner: "String",
+    #             acl_configuration: {
+    #               s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #             },
     #           },
     #           enforce_work_group_configuration: false,
     #           publish_cloud_watch_metrics_enabled: false,
@@ -736,7 +831,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:
@@ -748,9 +843,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
@@ -759,7 +854,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
@@ -1785,6 +1880,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(
@@ -1796,7 +1897,8 @@ module Aws::Athena
       :status,
       :statistics,
       :work_group,
-      :engine_version)
+      :engine_version,
+      :execution_parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1947,6 +2049,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
@@ -1973,6 +2076,9 @@ module Aws::Athena
     #           kms_key: "String",
     #         },
     #         expected_bucket_owner: "String",
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
     #       }
     #
     # @!attribute [rw] output_location
@@ -1994,7 +2100,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
@@ -2028,12 +2134,29 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
     #   @return [String]
     #
+    # @!attribute [rw] acl_configuration
+    #   Indicates that an Amazon S3 canned ACL should be set to control
+    #   ownership of stored query results. Currently the only supported
+    #   canned ACL is `BUCKET_OWNER_FULL_CONTROL`. This is a client-side
+    #   setting. If workgroup settings override client-side settings, then
+    #   the query uses the ACL configuration that is specified for the
+    #   workgroup, and also uses the location for storing query results
+    #   specified in the workgroup. For more information, see
+    #   WorkGroupConfiguration$EnforceWorkGroupConfiguration and [Workgroup
+    #   Settings Override Client-Side Settings][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
+    #   @return [Types::AclConfiguration]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultConfiguration AWS API Documentation
     #
     class ResultConfiguration < Struct.new(
       :output_location,
       :encryption_configuration,
-      :expected_bucket_owner)
+      :expected_bucket_owner,
+      :acl_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2054,6 +2177,10 @@ module Aws::Athena
     #         remove_encryption_configuration: false,
     #         expected_bucket_owner: "String",
     #         remove_expected_bucket_owner: false,
+    #         acl_configuration: {
+    #           s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #         },
+    #         remove_acl_configuration: false,
     #       }
     #
     # @!attribute [rw] output_location
@@ -2143,6 +2270,24 @@ module Aws::Athena
     #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
     #   @return [Boolean]
     #
+    # @!attribute [rw] acl_configuration
+    #   The ACL configuration for the query results.
+    #   @return [Types::AclConfiguration]
+    #
+    # @!attribute [rw] remove_acl_configuration
+    #   If set to `true`, indicates that the previously-specified ACL
+    #   configuration for queries in this workgroup should be ignored and
+    #   set to null. If set to `false` or not set, and a value is present in
+    #   the `AclConfiguration` of `ResultConfigurationUpdates`, the
+    #   `AclConfiguration` in the workgroup's `ResultConfiguration` is
+    #   updated with the new value. For more information, see [Workgroup
+    #   Settings Override Client-Side Settings][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/workgroups-settings-override.html
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResultConfigurationUpdates AWS API Documentation
     #
     class ResultConfigurationUpdates < Struct.new(
@@ -2151,7 +2296,9 @@ module Aws::Athena
       :encryption_configuration,
       :remove_encryption_configuration,
       :expected_bucket_owner,
-      :remove_expected_bucket_owner)
+      :remove_expected_bucket_owner,
+      :acl_configuration,
+      :remove_acl_configuration)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2225,8 +2372,12 @@ module Aws::Athena
     #             kms_key: "String",
     #           },
     #           expected_bucket_owner: "String",
+    #           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
@@ -2268,6 +2419,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(
@@ -2275,7 +2432,8 @@ module Aws::Athena
       :client_request_token,
       :query_execution_context,
       :result_configuration,
-      :work_group)
+      :work_group,
+      :execution_parameters)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2491,6 +2649,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
@@ -2720,6 +2914,10 @@ module Aws::Athena
     #             remove_encryption_configuration: false,
     #             expected_bucket_owner: "String",
     #             remove_expected_bucket_owner: false,
+    #             acl_configuration: {
+    #               s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #             },
+    #             remove_acl_configuration: false,
     #           },
     #           publish_cloud_watch_metrics_enabled: false,
     #           bytes_scanned_cutoff_per_query: 1,
@@ -2839,6 +3037,9 @@ module Aws::Athena
     #             kms_key: "String",
     #           },
     #           expected_bucket_owner: "String",
+    #           acl_configuration: {
+    #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #           },
     #         },
     #         enforce_work_group_configuration: false,
     #         publish_cloud_watch_metrics_enabled: false,
@@ -2942,6 +3143,10 @@ module Aws::Athena
     #           remove_encryption_configuration: false,
     #           expected_bucket_owner: "String",
     #           remove_expected_bucket_owner: false,
+    #           acl_configuration: {
+    #             s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
+    #           },
+    #           remove_acl_configuration: false,
     #         },
     #         publish_cloud_watch_metrics_enabled: false,
     #         bytes_scanned_cutoff_per_query: 1,

data/lib/aws-sdk-athena.rb

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

metadata

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