aws-sdk-athena 1.53.0 → 1.56.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d45eafd0db4a2dd576613f0620092497ee6adcf1ed681f4ba4a1500b04ae14e3
4
- data.tar.gz: a53b56f8fbf2a72fb9ca8dcb7c7563ac2bee565c5895f3a149e77b3f25c3d637
3
+ metadata.gz: 74be53714673ca3fa2a12aabe2c8cee44bc474d05cc982af921a6b462a4ba0cc
4
+ data.tar.gz: 2a6badd12bb32ddc909385ea984a845ca7d59a2608a0e6baa68a2832e5ede8b1
5
5
  SHA512:
6
- metadata.gz: 05ea3defd3b925e981cbcde008389fb2223161f14a30a29f1a164cf8ec6655bb50445f31cea00889d6d8446fc53a4cd1142ef5447ca3b23da62096642f6c3156
7
- data.tar.gz: f9c403030dbec36516adc375bfd1a50a1d84259e739e68deb130687d13021165f3f70eb54d8af2bf3190a13175e64efab9944dc222c1b4abe7bcb5c0899d871d
6
+ metadata.gz: a25ffa4171d27047a55191426c5646117b88bdb4cde400c658877a1e338c79183528826eed7691021c062378a95a4e6dbf3546813a9aacbb6b73d8b62382dfa8
7
+ data.tar.gz: a83cf1a9bdb900b53919eb5983fffbe9cc6395028f5822e3b5b6dc04948559a9cc12fb027cfeef58812c17c14222a57e551b2b3384535d12b6b22e6ee5d569b7
data/CHANGELOG.md CHANGED
@@ -1,6 +1,21 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.56.0 (2022-07-21)
5
+ ------------------
6
+
7
+ * Feature - This feature allows customers to retrieve runtime statistics for completed queries
8
+
9
+ 1.55.0 (2022-07-14)
10
+ ------------------
11
+
12
+ * 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.
13
+
14
+ 1.54.0 (2022-06-30)
15
+ ------------------
16
+
17
+ * Feature - This feature introduces the API support for Athena's parameterized query and BatchGetPreparedStatement API.
18
+
4
19
  1.53.0 (2022-04-15)
5
20
  ------------------
6
21
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.53.0
1
+ 1.56.0
@@ -409,6 +409,53 @@ module Aws::Athena
409
409
  req.send_request(options)
410
410
  end
411
411
 
412
+ # Returns the details of a single prepared statement or a list of up to
413
+ # 256 prepared statements for the array of prepared statement names that
414
+ # you provide. Requires you to have access to the workgroup to which the
415
+ # prepared statements belong. If a prepared statement cannot be
416
+ # retrieved for the name specified, the statement is listed in
417
+ # `UnprocessedPreparedStatementNames`.
418
+ #
419
+ # @option params [required, Array<String>] :prepared_statement_names
420
+ # A list of prepared statement names to return.
421
+ #
422
+ # @option params [required, String] :work_group
423
+ # The name of the workgroup to which the prepared statements belong.
424
+ #
425
+ # @return [Types::BatchGetPreparedStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
426
+ #
427
+ # * {Types::BatchGetPreparedStatementOutput#prepared_statements #prepared_statements} => Array&lt;Types::PreparedStatement&gt;
428
+ # * {Types::BatchGetPreparedStatementOutput#unprocessed_prepared_statement_names #unprocessed_prepared_statement_names} => Array&lt;Types::UnprocessedPreparedStatementName&gt;
429
+ #
430
+ # @example Request syntax with placeholder values
431
+ #
432
+ # resp = client.batch_get_prepared_statement({
433
+ # prepared_statement_names: ["StatementName"], # required
434
+ # work_group: "WorkGroupName", # required
435
+ # })
436
+ #
437
+ # @example Response structure
438
+ #
439
+ # resp.prepared_statements #=> Array
440
+ # resp.prepared_statements[0].statement_name #=> String
441
+ # resp.prepared_statements[0].query_statement #=> String
442
+ # resp.prepared_statements[0].work_group_name #=> String
443
+ # resp.prepared_statements[0].description #=> String
444
+ # resp.prepared_statements[0].last_modified_time #=> Time
445
+ # resp.unprocessed_prepared_statement_names #=> Array
446
+ # resp.unprocessed_prepared_statement_names[0].statement_name #=> String
447
+ # resp.unprocessed_prepared_statement_names[0].error_code #=> String
448
+ # resp.unprocessed_prepared_statement_names[0].error_message #=> String
449
+ #
450
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetPreparedStatement AWS API Documentation
451
+ #
452
+ # @overload batch_get_prepared_statement(params = {})
453
+ # @param [Hash] params ({})
454
+ def batch_get_prepared_statement(params = {}, options = {})
455
+ req = build_request(:batch_get_prepared_statement, params)
456
+ req.send_request(options)
457
+ end
458
+
412
459
  # Returns the details of a single query execution or a list of up to 50
413
460
  # query executions, which you provide as an array of query execution ID
414
461
  # strings. Requires you to have access to the workgroup in which the
@@ -462,6 +509,8 @@ module Aws::Athena
462
509
  # resp.query_executions[0].work_group #=> String
463
510
  # resp.query_executions[0].engine_version.selected_engine_version #=> String
464
511
  # resp.query_executions[0].engine_version.effective_engine_version #=> String
512
+ # resp.query_executions[0].execution_parameters #=> Array
513
+ # resp.query_executions[0].execution_parameters[0] #=> String
465
514
  # resp.unprocessed_query_execution_ids #=> Array
466
515
  # resp.unprocessed_query_execution_ids[0].query_execution_id #=> String
467
516
  # resp.unprocessed_query_execution_ids[0].error_code #=> String
@@ -705,12 +754,12 @@ module Aws::Athena
705
754
  # name: "WorkGroupName", # required
706
755
  # configuration: {
707
756
  # result_configuration: {
708
- # output_location: "String",
757
+ # output_location: "ResultOutputLocation",
709
758
  # encryption_configuration: {
710
759
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
711
760
  # kms_key: "String",
712
761
  # },
713
- # expected_bucket_owner: "String",
762
+ # expected_bucket_owner: "AwsAccountId",
714
763
  # acl_configuration: {
715
764
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
716
765
  # },
@@ -1038,6 +1087,8 @@ module Aws::Athena
1038
1087
  # resp.query_execution.work_group #=> String
1039
1088
  # resp.query_execution.engine_version.selected_engine_version #=> String
1040
1089
  # resp.query_execution.engine_version.effective_engine_version #=> String
1090
+ # resp.query_execution.execution_parameters #=> Array
1091
+ # resp.query_execution.execution_parameters[0] #=> String
1041
1092
  #
1042
1093
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution AWS API Documentation
1043
1094
  #
@@ -1124,6 +1175,60 @@ module Aws::Athena
1124
1175
  req.send_request(options)
1125
1176
  end
1126
1177
 
1178
+ # Returns query execution runtime statistics related to a single
1179
+ # execution of a query if you have access to the workgroup in which the
1180
+ # query ran. The query execution runtime statistics is returned only
1181
+ # when QueryExecutionStatus$State is in a SUCCEEDED or FAILED state.
1182
+ #
1183
+ # @option params [required, String] :query_execution_id
1184
+ # The unique ID of the query execution.
1185
+ #
1186
+ # @return [Types::GetQueryRuntimeStatisticsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1187
+ #
1188
+ # * {Types::GetQueryRuntimeStatisticsOutput#query_runtime_statistics #query_runtime_statistics} => Types::QueryRuntimeStatistics
1189
+ #
1190
+ # @example Request syntax with placeholder values
1191
+ #
1192
+ # resp = client.get_query_runtime_statistics({
1193
+ # query_execution_id: "QueryExecutionId", # required
1194
+ # })
1195
+ #
1196
+ # @example Response structure
1197
+ #
1198
+ # resp.query_runtime_statistics.timeline.query_queue_time_in_millis #=> Integer
1199
+ # resp.query_runtime_statistics.timeline.query_planning_time_in_millis #=> Integer
1200
+ # resp.query_runtime_statistics.timeline.engine_execution_time_in_millis #=> Integer
1201
+ # resp.query_runtime_statistics.timeline.service_processing_time_in_millis #=> Integer
1202
+ # resp.query_runtime_statistics.timeline.total_execution_time_in_millis #=> Integer
1203
+ # resp.query_runtime_statistics.rows.input_rows #=> Integer
1204
+ # resp.query_runtime_statistics.rows.input_bytes #=> Integer
1205
+ # resp.query_runtime_statistics.rows.output_bytes #=> Integer
1206
+ # resp.query_runtime_statistics.rows.output_rows #=> Integer
1207
+ # resp.query_runtime_statistics.output_stage.stage_id #=> Integer
1208
+ # resp.query_runtime_statistics.output_stage.state #=> String
1209
+ # resp.query_runtime_statistics.output_stage.output_bytes #=> Integer
1210
+ # resp.query_runtime_statistics.output_stage.output_rows #=> Integer
1211
+ # resp.query_runtime_statistics.output_stage.input_bytes #=> Integer
1212
+ # resp.query_runtime_statistics.output_stage.input_rows #=> Integer
1213
+ # resp.query_runtime_statistics.output_stage.execution_time #=> Integer
1214
+ # resp.query_runtime_statistics.output_stage.query_stage_plan.name #=> String
1215
+ # resp.query_runtime_statistics.output_stage.query_stage_plan.identifier #=> String
1216
+ # resp.query_runtime_statistics.output_stage.query_stage_plan.children #=> Array
1217
+ # resp.query_runtime_statistics.output_stage.query_stage_plan.children[0] #=> Types::QueryStagePlanNode
1218
+ # resp.query_runtime_statistics.output_stage.query_stage_plan.remote_sources #=> Array
1219
+ # resp.query_runtime_statistics.output_stage.query_stage_plan.remote_sources[0] #=> String
1220
+ # resp.query_runtime_statistics.output_stage.sub_stages #=> Array
1221
+ # resp.query_runtime_statistics.output_stage.sub_stages[0] #=> Types::QueryStage
1222
+ #
1223
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryRuntimeStatistics AWS API Documentation
1224
+ #
1225
+ # @overload get_query_runtime_statistics(params = {})
1226
+ # @param [Hash] params ({})
1227
+ def get_query_runtime_statistics(params = {}, options = {})
1228
+ req = build_request(:get_query_runtime_statistics, params)
1229
+ req.send_request(options)
1230
+ end
1231
+
1127
1232
  # Returns table metadata for the specified catalog, database, and table.
1128
1233
  #
1129
1234
  # @option params [required, String] :catalog_name
@@ -1321,6 +1426,8 @@ module Aws::Athena
1321
1426
  # * {Types::ListEngineVersionsOutput#engine_versions #engine_versions} => Array&lt;Types::EngineVersion&gt;
1322
1427
  # * {Types::ListEngineVersionsOutput#next_token #next_token} => String
1323
1428
  #
1429
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
1430
+ #
1324
1431
  # @example Request syntax with placeholder values
1325
1432
  #
1326
1433
  # resp = client.list_engine_versions({
@@ -1400,7 +1507,7 @@ module Aws::Athena
1400
1507
  req.send_request(options)
1401
1508
  end
1402
1509
 
1403
- # Lists the prepared statements in the specfied workgroup.
1510
+ # Lists the prepared statements in the specified workgroup.
1404
1511
  #
1405
1512
  # @option params [required, String] :work_group
1406
1513
  # The workgroup to list the prepared statements for.
@@ -1705,6 +1812,11 @@ module Aws::Athena
1705
1812
  # @option params [String] :work_group
1706
1813
  # The name of the workgroup in which the query is being started.
1707
1814
  #
1815
+ # @option params [Array<String>] :execution_parameters
1816
+ # A list of values for the parameters in a query. The values are applied
1817
+ # sequentially to the parameters in the query in the order in which the
1818
+ # parameters occur.
1819
+ #
1708
1820
  # @return [Types::StartQueryExecutionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1709
1821
  #
1710
1822
  # * {Types::StartQueryExecutionOutput#query_execution_id #query_execution_id} => String
@@ -1719,17 +1831,18 @@ module Aws::Athena
1719
1831
  # catalog: "CatalogNameString",
1720
1832
  # },
1721
1833
  # result_configuration: {
1722
- # output_location: "String",
1834
+ # output_location: "ResultOutputLocation",
1723
1835
  # encryption_configuration: {
1724
1836
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
1725
1837
  # kms_key: "String",
1726
1838
  # },
1727
- # expected_bucket_owner: "String",
1839
+ # expected_bucket_owner: "AwsAccountId",
1728
1840
  # acl_configuration: {
1729
1841
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
1730
1842
  # },
1731
1843
  # },
1732
1844
  # work_group: "WorkGroupName",
1845
+ # execution_parameters: ["ExecutionParameter"],
1733
1846
  # })
1734
1847
  #
1735
1848
  # @example Response structure
@@ -2015,14 +2128,14 @@ module Aws::Athena
2015
2128
  # configuration_updates: {
2016
2129
  # enforce_work_group_configuration: false,
2017
2130
  # result_configuration_updates: {
2018
- # output_location: "String",
2131
+ # output_location: "ResultOutputLocation",
2019
2132
  # remove_output_location: false,
2020
2133
  # encryption_configuration: {
2021
2134
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2022
2135
  # kms_key: "String",
2023
2136
  # },
2024
2137
  # remove_encryption_configuration: false,
2025
- # expected_bucket_owner: "String",
2138
+ # expected_bucket_owner: "AwsAccountId",
2026
2139
  # remove_expected_bucket_owner: false,
2027
2140
  # acl_configuration: {
2028
2141
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
@@ -2063,7 +2176,7 @@ module Aws::Athena
2063
2176
  params: params,
2064
2177
  config: config)
2065
2178
  context[:gem_name] = 'aws-sdk-athena'
2066
- context[:gem_version] = '1.53.0'
2179
+ context[:gem_version] = '1.56.0'
2067
2180
  Seahorse::Client::Request.new(handlers, context)
2068
2181
  end
2069
2182
 
@@ -16,8 +16,11 @@ module Aws::Athena
16
16
  AclConfiguration = Shapes::StructureShape.new(name: 'AclConfiguration')
17
17
  AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
18
18
  AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
19
+ AwsAccountId = Shapes::StringShape.new(name: 'AwsAccountId')
19
20
  BatchGetNamedQueryInput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryInput')
20
21
  BatchGetNamedQueryOutput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryOutput')
22
+ BatchGetPreparedStatementInput = Shapes::StructureShape.new(name: 'BatchGetPreparedStatementInput')
23
+ BatchGetPreparedStatementOutput = Shapes::StructureShape.new(name: 'BatchGetPreparedStatementOutput')
21
24
  BatchGetQueryExecutionInput = Shapes::StructureShape.new(name: 'BatchGetQueryExecutionInput')
22
25
  BatchGetQueryExecutionOutput = Shapes::StructureShape.new(name: 'BatchGetQueryExecutionOutput')
23
26
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
@@ -64,6 +67,8 @@ module Aws::Athena
64
67
  ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
65
68
  ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
66
69
  ErrorType = Shapes::IntegerShape.new(name: 'ErrorType')
70
+ ExecutionParameter = Shapes::StringShape.new(name: 'ExecutionParameter')
71
+ ExecutionParameters = Shapes::ListShape.new(name: 'ExecutionParameters')
67
72
  ExpressionString = Shapes::StringShape.new(name: 'ExpressionString')
68
73
  GetDataCatalogInput = Shapes::StructureShape.new(name: 'GetDataCatalogInput')
69
74
  GetDataCatalogOutput = Shapes::StructureShape.new(name: 'GetDataCatalogOutput')
@@ -77,6 +82,8 @@ module Aws::Athena
77
82
  GetQueryExecutionOutput = Shapes::StructureShape.new(name: 'GetQueryExecutionOutput')
78
83
  GetQueryResultsInput = Shapes::StructureShape.new(name: 'GetQueryResultsInput')
79
84
  GetQueryResultsOutput = Shapes::StructureShape.new(name: 'GetQueryResultsOutput')
85
+ GetQueryRuntimeStatisticsInput = Shapes::StructureShape.new(name: 'GetQueryRuntimeStatisticsInput')
86
+ GetQueryRuntimeStatisticsOutput = Shapes::StructureShape.new(name: 'GetQueryRuntimeStatisticsOutput')
80
87
  GetTableMetadataInput = Shapes::StructureShape.new(name: 'GetTableMetadataInput')
81
88
  GetTableMetadataOutput = Shapes::StructureShape.new(name: 'GetTableMetadataOutput')
82
89
  GetWorkGroupInput = Shapes::StructureShape.new(name: 'GetWorkGroupInput')
@@ -125,6 +132,8 @@ module Aws::Athena
125
132
  ParametersMap = Shapes::MapShape.new(name: 'ParametersMap')
126
133
  ParametersMapValue = Shapes::StringShape.new(name: 'ParametersMapValue')
127
134
  PreparedStatement = Shapes::StructureShape.new(name: 'PreparedStatement')
135
+ PreparedStatementDetailsList = Shapes::ListShape.new(name: 'PreparedStatementDetailsList')
136
+ PreparedStatementNameList = Shapes::ListShape.new(name: 'PreparedStatementNameList')
128
137
  PreparedStatementSummary = Shapes::StructureShape.new(name: 'PreparedStatementSummary')
129
138
  PreparedStatementsList = Shapes::ListShape.new(name: 'PreparedStatementsList')
130
139
  QueryExecution = Shapes::StructureShape.new(name: 'QueryExecution')
@@ -135,10 +144,18 @@ module Aws::Athena
135
144
  QueryExecutionState = Shapes::StringShape.new(name: 'QueryExecutionState')
136
145
  QueryExecutionStatistics = Shapes::StructureShape.new(name: 'QueryExecutionStatistics')
137
146
  QueryExecutionStatus = Shapes::StructureShape.new(name: 'QueryExecutionStatus')
147
+ QueryRuntimeStatistics = Shapes::StructureShape.new(name: 'QueryRuntimeStatistics')
148
+ QueryRuntimeStatisticsRows = Shapes::StructureShape.new(name: 'QueryRuntimeStatisticsRows')
149
+ QueryRuntimeStatisticsTimeline = Shapes::StructureShape.new(name: 'QueryRuntimeStatisticsTimeline')
150
+ QueryStage = Shapes::StructureShape.new(name: 'QueryStage')
151
+ QueryStagePlanNode = Shapes::StructureShape.new(name: 'QueryStagePlanNode')
152
+ QueryStagePlanNodes = Shapes::ListShape.new(name: 'QueryStagePlanNodes')
153
+ QueryStages = Shapes::ListShape.new(name: 'QueryStages')
138
154
  QueryString = Shapes::StringShape.new(name: 'QueryString')
139
155
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
140
156
  ResultConfiguration = Shapes::StructureShape.new(name: 'ResultConfiguration')
141
157
  ResultConfigurationUpdates = Shapes::StructureShape.new(name: 'ResultConfigurationUpdates')
158
+ ResultOutputLocation = Shapes::StringShape.new(name: 'ResultOutputLocation')
142
159
  ResultSet = Shapes::StructureShape.new(name: 'ResultSet')
143
160
  ResultSetMetadata = Shapes::StructureShape.new(name: 'ResultSetMetadata')
144
161
  Row = Shapes::StructureShape.new(name: 'Row')
@@ -151,6 +168,7 @@ module Aws::Athena
151
168
  StopQueryExecutionInput = Shapes::StructureShape.new(name: 'StopQueryExecutionInput')
152
169
  StopQueryExecutionOutput = Shapes::StructureShape.new(name: 'StopQueryExecutionOutput')
153
170
  String = Shapes::StringShape.new(name: 'String')
171
+ StringList = Shapes::ListShape.new(name: 'StringList')
154
172
  TableMetadata = Shapes::StructureShape.new(name: 'TableMetadata')
155
173
  TableMetadataList = Shapes::ListShape.new(name: 'TableMetadataList')
156
174
  TableTypeString = Shapes::StringShape.new(name: 'TableTypeString')
@@ -168,6 +186,8 @@ module Aws::Athena
168
186
  TypeString = Shapes::StringShape.new(name: 'TypeString')
169
187
  UnprocessedNamedQueryId = Shapes::StructureShape.new(name: 'UnprocessedNamedQueryId')
170
188
  UnprocessedNamedQueryIdList = Shapes::ListShape.new(name: 'UnprocessedNamedQueryIdList')
189
+ UnprocessedPreparedStatementName = Shapes::StructureShape.new(name: 'UnprocessedPreparedStatementName')
190
+ UnprocessedPreparedStatementNameList = Shapes::ListShape.new(name: 'UnprocessedPreparedStatementNameList')
171
191
  UnprocessedQueryExecutionId = Shapes::StructureShape.new(name: 'UnprocessedQueryExecutionId')
172
192
  UnprocessedQueryExecutionIdList = Shapes::ListShape.new(name: 'UnprocessedQueryExecutionIdList')
173
193
  UntagResourceInput = Shapes::StructureShape.new(name: 'UntagResourceInput')
@@ -207,6 +227,14 @@ module Aws::Athena
207
227
  BatchGetNamedQueryOutput.add_member(:unprocessed_named_query_ids, Shapes::ShapeRef.new(shape: UnprocessedNamedQueryIdList, location_name: "UnprocessedNamedQueryIds"))
208
228
  BatchGetNamedQueryOutput.struct_class = Types::BatchGetNamedQueryOutput
209
229
 
230
+ BatchGetPreparedStatementInput.add_member(:prepared_statement_names, Shapes::ShapeRef.new(shape: PreparedStatementNameList, required: true, location_name: "PreparedStatementNames"))
231
+ BatchGetPreparedStatementInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, required: true, location_name: "WorkGroup"))
232
+ BatchGetPreparedStatementInput.struct_class = Types::BatchGetPreparedStatementInput
233
+
234
+ BatchGetPreparedStatementOutput.add_member(:prepared_statements, Shapes::ShapeRef.new(shape: PreparedStatementDetailsList, location_name: "PreparedStatements"))
235
+ BatchGetPreparedStatementOutput.add_member(:unprocessed_prepared_statement_names, Shapes::ShapeRef.new(shape: UnprocessedPreparedStatementNameList, location_name: "UnprocessedPreparedStatementNames"))
236
+ BatchGetPreparedStatementOutput.struct_class = Types::BatchGetPreparedStatementOutput
237
+
210
238
  BatchGetQueryExecutionInput.add_member(:query_execution_ids, Shapes::ShapeRef.new(shape: QueryExecutionIdList, required: true, location_name: "QueryExecutionIds"))
211
239
  BatchGetQueryExecutionInput.struct_class = Types::BatchGetQueryExecutionInput
212
240
 
@@ -325,6 +353,8 @@ module Aws::Athena
325
353
 
326
354
  EngineVersionsList.member = Shapes::ShapeRef.new(shape: EngineVersion)
327
355
 
356
+ ExecutionParameters.member = Shapes::ShapeRef.new(shape: ExecutionParameter)
357
+
328
358
  GetDataCatalogInput.add_member(:name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "Name"))
329
359
  GetDataCatalogInput.struct_class = Types::GetDataCatalogInput
330
360
 
@@ -367,6 +397,12 @@ module Aws::Athena
367
397
  GetQueryResultsOutput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
368
398
  GetQueryResultsOutput.struct_class = Types::GetQueryResultsOutput
369
399
 
400
+ GetQueryRuntimeStatisticsInput.add_member(:query_execution_id, Shapes::ShapeRef.new(shape: QueryExecutionId, required: true, location_name: "QueryExecutionId"))
401
+ GetQueryRuntimeStatisticsInput.struct_class = Types::GetQueryRuntimeStatisticsInput
402
+
403
+ GetQueryRuntimeStatisticsOutput.add_member(:query_runtime_statistics, Shapes::ShapeRef.new(shape: QueryRuntimeStatistics, location_name: "QueryRuntimeStatistics"))
404
+ GetQueryRuntimeStatisticsOutput.struct_class = Types::GetQueryRuntimeStatisticsOutput
405
+
370
406
  GetTableMetadataInput.add_member(:catalog_name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "CatalogName"))
371
407
  GetTableMetadataInput.add_member(:database_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "DatabaseName"))
372
408
  GetTableMetadataInput.add_member(:table_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "TableName"))
@@ -493,6 +529,10 @@ module Aws::Athena
493
529
  PreparedStatement.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Date, location_name: "LastModifiedTime"))
494
530
  PreparedStatement.struct_class = Types::PreparedStatement
495
531
 
532
+ PreparedStatementDetailsList.member = Shapes::ShapeRef.new(shape: PreparedStatement)
533
+
534
+ PreparedStatementNameList.member = Shapes::ShapeRef.new(shape: StatementName)
535
+
496
536
  PreparedStatementSummary.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementName, location_name: "StatementName"))
497
537
  PreparedStatementSummary.add_member(:last_modified_time, Shapes::ShapeRef.new(shape: Date, location_name: "LastModifiedTime"))
498
538
  PreparedStatementSummary.struct_class = Types::PreparedStatementSummary
@@ -508,6 +548,7 @@ module Aws::Athena
508
548
  QueryExecution.add_member(:statistics, Shapes::ShapeRef.new(shape: QueryExecutionStatistics, location_name: "Statistics"))
509
549
  QueryExecution.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
510
550
  QueryExecution.add_member(:engine_version, Shapes::ShapeRef.new(shape: EngineVersion, location_name: "EngineVersion"))
551
+ QueryExecution.add_member(:execution_parameters, Shapes::ShapeRef.new(shape: ExecutionParameters, location_name: "ExecutionParameters"))
511
552
  QueryExecution.struct_class = Types::QueryExecution
512
553
 
513
554
  QueryExecutionContext.add_member(:database, Shapes::ShapeRef.new(shape: DatabaseString, location_name: "Database"))
@@ -534,21 +575,60 @@ module Aws::Athena
534
575
  QueryExecutionStatus.add_member(:athena_error, Shapes::ShapeRef.new(shape: AthenaError, location_name: "AthenaError"))
535
576
  QueryExecutionStatus.struct_class = Types::QueryExecutionStatus
536
577
 
578
+ QueryRuntimeStatistics.add_member(:timeline, Shapes::ShapeRef.new(shape: QueryRuntimeStatisticsTimeline, location_name: "Timeline"))
579
+ QueryRuntimeStatistics.add_member(:rows, Shapes::ShapeRef.new(shape: QueryRuntimeStatisticsRows, location_name: "Rows"))
580
+ QueryRuntimeStatistics.add_member(:output_stage, Shapes::ShapeRef.new(shape: QueryStage, location_name: "OutputStage"))
581
+ QueryRuntimeStatistics.struct_class = Types::QueryRuntimeStatistics
582
+
583
+ QueryRuntimeStatisticsRows.add_member(:input_rows, Shapes::ShapeRef.new(shape: Long, location_name: "InputRows"))
584
+ QueryRuntimeStatisticsRows.add_member(:input_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "InputBytes"))
585
+ QueryRuntimeStatisticsRows.add_member(:output_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "OutputBytes"))
586
+ QueryRuntimeStatisticsRows.add_member(:output_rows, Shapes::ShapeRef.new(shape: Long, location_name: "OutputRows"))
587
+ QueryRuntimeStatisticsRows.struct_class = Types::QueryRuntimeStatisticsRows
588
+
589
+ QueryRuntimeStatisticsTimeline.add_member(:query_queue_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryQueueTimeInMillis"))
590
+ QueryRuntimeStatisticsTimeline.add_member(:query_planning_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryPlanningTimeInMillis"))
591
+ QueryRuntimeStatisticsTimeline.add_member(:engine_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "EngineExecutionTimeInMillis"))
592
+ QueryRuntimeStatisticsTimeline.add_member(:service_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServiceProcessingTimeInMillis"))
593
+ QueryRuntimeStatisticsTimeline.add_member(:total_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "TotalExecutionTimeInMillis"))
594
+ QueryRuntimeStatisticsTimeline.struct_class = Types::QueryRuntimeStatisticsTimeline
595
+
596
+ QueryStage.add_member(:stage_id, Shapes::ShapeRef.new(shape: Long, location_name: "StageId"))
597
+ QueryStage.add_member(:state, Shapes::ShapeRef.new(shape: String, location_name: "State"))
598
+ QueryStage.add_member(:output_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "OutputBytes"))
599
+ QueryStage.add_member(:output_rows, Shapes::ShapeRef.new(shape: Long, location_name: "OutputRows"))
600
+ QueryStage.add_member(:input_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "InputBytes"))
601
+ QueryStage.add_member(:input_rows, Shapes::ShapeRef.new(shape: Long, location_name: "InputRows"))
602
+ QueryStage.add_member(:execution_time, Shapes::ShapeRef.new(shape: Long, location_name: "ExecutionTime"))
603
+ QueryStage.add_member(:query_stage_plan, Shapes::ShapeRef.new(shape: QueryStagePlanNode, location_name: "QueryStagePlan"))
604
+ QueryStage.add_member(:sub_stages, Shapes::ShapeRef.new(shape: QueryStages, location_name: "SubStages"))
605
+ QueryStage.struct_class = Types::QueryStage
606
+
607
+ QueryStagePlanNode.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "Name"))
608
+ QueryStagePlanNode.add_member(:identifier, Shapes::ShapeRef.new(shape: String, location_name: "Identifier"))
609
+ QueryStagePlanNode.add_member(:children, Shapes::ShapeRef.new(shape: QueryStagePlanNodes, location_name: "Children"))
610
+ QueryStagePlanNode.add_member(:remote_sources, Shapes::ShapeRef.new(shape: StringList, location_name: "RemoteSources"))
611
+ QueryStagePlanNode.struct_class = Types::QueryStagePlanNode
612
+
613
+ QueryStagePlanNodes.member = Shapes::ShapeRef.new(shape: QueryStagePlanNode)
614
+
615
+ QueryStages.member = Shapes::ShapeRef.new(shape: QueryStage)
616
+
537
617
  ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))
538
618
  ResourceNotFoundException.add_member(:resource_name, Shapes::ShapeRef.new(shape: AmazonResourceName, location_name: "ResourceName"))
539
619
  ResourceNotFoundException.struct_class = Types::ResourceNotFoundException
540
620
 
541
- ResultConfiguration.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
621
+ ResultConfiguration.add_member(:output_location, Shapes::ShapeRef.new(shape: ResultOutputLocation, location_name: "OutputLocation"))
542
622
  ResultConfiguration.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
543
- ResultConfiguration.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
623
+ ResultConfiguration.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: AwsAccountId, location_name: "ExpectedBucketOwner"))
544
624
  ResultConfiguration.add_member(:acl_configuration, Shapes::ShapeRef.new(shape: AclConfiguration, location_name: "AclConfiguration"))
545
625
  ResultConfiguration.struct_class = Types::ResultConfiguration
546
626
 
547
- ResultConfigurationUpdates.add_member(:output_location, Shapes::ShapeRef.new(shape: String, location_name: "OutputLocation"))
627
+ ResultConfigurationUpdates.add_member(:output_location, Shapes::ShapeRef.new(shape: ResultOutputLocation, location_name: "OutputLocation"))
548
628
  ResultConfigurationUpdates.add_member(:remove_output_location, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveOutputLocation"))
549
629
  ResultConfigurationUpdates.add_member(:encryption_configuration, Shapes::ShapeRef.new(shape: EncryptionConfiguration, location_name: "EncryptionConfiguration"))
550
630
  ResultConfigurationUpdates.add_member(:remove_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveEncryptionConfiguration"))
551
- ResultConfigurationUpdates.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: String, location_name: "ExpectedBucketOwner"))
631
+ ResultConfigurationUpdates.add_member(:expected_bucket_owner, Shapes::ShapeRef.new(shape: AwsAccountId, location_name: "ExpectedBucketOwner"))
552
632
  ResultConfigurationUpdates.add_member(:remove_expected_bucket_owner, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveExpectedBucketOwner"))
553
633
  ResultConfigurationUpdates.add_member(:acl_configuration, Shapes::ShapeRef.new(shape: AclConfiguration, location_name: "AclConfiguration"))
554
634
  ResultConfigurationUpdates.add_member(:remove_acl_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "RemoveAclConfiguration"))
@@ -571,6 +651,7 @@ module Aws::Athena
571
651
  StartQueryExecutionInput.add_member(:query_execution_context, Shapes::ShapeRef.new(shape: QueryExecutionContext, location_name: "QueryExecutionContext"))
572
652
  StartQueryExecutionInput.add_member(:result_configuration, Shapes::ShapeRef.new(shape: ResultConfiguration, location_name: "ResultConfiguration"))
573
653
  StartQueryExecutionInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
654
+ StartQueryExecutionInput.add_member(:execution_parameters, Shapes::ShapeRef.new(shape: ExecutionParameters, location_name: "ExecutionParameters"))
574
655
  StartQueryExecutionInput.struct_class = Types::StartQueryExecutionInput
575
656
 
576
657
  StartQueryExecutionOutput.add_member(:query_execution_id, Shapes::ShapeRef.new(shape: QueryExecutionId, location_name: "QueryExecutionId"))
@@ -581,6 +662,8 @@ module Aws::Athena
581
662
 
582
663
  StopQueryExecutionOutput.struct_class = Types::StopQueryExecutionOutput
583
664
 
665
+ StringList.member = Shapes::ShapeRef.new(shape: String)
666
+
584
667
  TableMetadata.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
585
668
  TableMetadata.add_member(:create_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreateTime"))
586
669
  TableMetadata.add_member(:last_access_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "LastAccessTime"))
@@ -617,6 +700,13 @@ module Aws::Athena
617
700
 
618
701
  UnprocessedNamedQueryIdList.member = Shapes::ShapeRef.new(shape: UnprocessedNamedQueryId)
619
702
 
703
+ UnprocessedPreparedStatementName.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementName, location_name: "StatementName"))
704
+ UnprocessedPreparedStatementName.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, location_name: "ErrorCode"))
705
+ UnprocessedPreparedStatementName.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
706
+ UnprocessedPreparedStatementName.struct_class = Types::UnprocessedPreparedStatementName
707
+
708
+ UnprocessedPreparedStatementNameList.member = Shapes::ShapeRef.new(shape: UnprocessedPreparedStatementName)
709
+
620
710
  UnprocessedQueryExecutionId.add_member(:query_execution_id, Shapes::ShapeRef.new(shape: QueryExecutionId, location_name: "QueryExecutionId"))
621
711
  UnprocessedQueryExecutionId.add_member(:error_code, Shapes::ShapeRef.new(shape: ErrorCode, location_name: "ErrorCode"))
622
712
  UnprocessedQueryExecutionId.add_member(:error_message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "ErrorMessage"))
@@ -725,6 +815,16 @@ module Aws::Athena
725
815
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
726
816
  end)
727
817
 
818
+ api.add_operation(:batch_get_prepared_statement, Seahorse::Model::Operation.new.tap do |o|
819
+ o.name = "BatchGetPreparedStatement"
820
+ o.http_method = "POST"
821
+ o.http_request_uri = "/"
822
+ o.input = Shapes::ShapeRef.new(shape: BatchGetPreparedStatementInput)
823
+ o.output = Shapes::ShapeRef.new(shape: BatchGetPreparedStatementOutput)
824
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
825
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
826
+ end)
827
+
728
828
  api.add_operation(:batch_get_query_execution, Seahorse::Model::Operation.new.tap do |o|
729
829
  o.name = "BatchGetQueryExecution"
730
830
  o.http_method = "POST"
@@ -884,6 +984,16 @@ module Aws::Athena
884
984
  )
885
985
  end)
886
986
 
987
+ api.add_operation(:get_query_runtime_statistics, Seahorse::Model::Operation.new.tap do |o|
988
+ o.name = "GetQueryRuntimeStatistics"
989
+ o.http_method = "POST"
990
+ o.http_request_uri = "/"
991
+ o.input = Shapes::ShapeRef.new(shape: GetQueryRuntimeStatisticsInput)
992
+ o.output = Shapes::ShapeRef.new(shape: GetQueryRuntimeStatisticsOutput)
993
+ o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
994
+ o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
995
+ end)
996
+
887
997
  api.add_operation(:get_table_metadata, Seahorse::Model::Operation.new.tap do |o|
888
998
  o.name = "GetTableMetadata"
889
999
  o.http_method = "POST"
@@ -946,6 +1056,12 @@ module Aws::Athena
946
1056
  o.output = Shapes::ShapeRef.new(shape: ListEngineVersionsOutput)
947
1057
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
948
1058
  o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
1059
+ o[:pager] = Aws::Pager.new(
1060
+ limit_key: "max_results",
1061
+ tokens: {
1062
+ "next_token" => "next_token"
1063
+ }
1064
+ )
949
1065
  end)
950
1066
 
951
1067
  api.add_operation(:list_named_queries, Seahorse::Model::Operation.new.tap do |o|
@@ -96,6 +96,8 @@ module Aws::Athena
96
96
  include Aws::Structure
97
97
  end
98
98
 
99
+ # Contains an array of named query IDs.
100
+ #
99
101
  # @note When making an API call, you may pass BatchGetNamedQueryInput
100
102
  # data as a hash:
101
103
  #
@@ -132,6 +134,51 @@ module Aws::Athena
132
134
  include Aws::Structure
133
135
  end
134
136
 
137
+ # @note When making an API call, you may pass BatchGetPreparedStatementInput
138
+ # data as a hash:
139
+ #
140
+ # {
141
+ # prepared_statement_names: ["StatementName"], # required
142
+ # work_group: "WorkGroupName", # required
143
+ # }
144
+ #
145
+ # @!attribute [rw] prepared_statement_names
146
+ # A list of prepared statement names to return.
147
+ # @return [Array<String>]
148
+ #
149
+ # @!attribute [rw] work_group
150
+ # The name of the workgroup to which the prepared statements belong.
151
+ # @return [String]
152
+ #
153
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetPreparedStatementInput AWS API Documentation
154
+ #
155
+ class BatchGetPreparedStatementInput < Struct.new(
156
+ :prepared_statement_names,
157
+ :work_group)
158
+ SENSITIVE = []
159
+ include Aws::Structure
160
+ end
161
+
162
+ # @!attribute [rw] prepared_statements
163
+ # The list of prepared statements returned.
164
+ # @return [Array<Types::PreparedStatement>]
165
+ #
166
+ # @!attribute [rw] unprocessed_prepared_statement_names
167
+ # A list of one or more prepared statements that were requested but
168
+ # could not be returned.
169
+ # @return [Array<Types::UnprocessedPreparedStatementName>]
170
+ #
171
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/BatchGetPreparedStatementOutput AWS API Documentation
172
+ #
173
+ class BatchGetPreparedStatementOutput < Struct.new(
174
+ :prepared_statements,
175
+ :unprocessed_prepared_statement_names)
176
+ SENSITIVE = []
177
+ include Aws::Structure
178
+ end
179
+
180
+ # Contains an array of query execution IDs.
181
+ #
135
182
  # @note When making an API call, you may pass BatchGetQueryExecutionInput
136
183
  # data as a hash:
137
184
  #
@@ -477,12 +524,12 @@ module Aws::Athena
477
524
  # name: "WorkGroupName", # required
478
525
  # configuration: {
479
526
  # result_configuration: {
480
- # output_location: "String",
527
+ # output_location: "ResultOutputLocation",
481
528
  # encryption_configuration: {
482
529
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
483
530
  # kms_key: "String",
484
531
  # },
485
- # expected_bucket_owner: "String",
532
+ # expected_bucket_owner: "AwsAccountId",
486
533
  # acl_configuration: {
487
534
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
488
535
  # },
@@ -1085,6 +1132,37 @@ module Aws::Athena
1085
1132
  include Aws::Structure
1086
1133
  end
1087
1134
 
1135
+ # @note When making an API call, you may pass GetQueryRuntimeStatisticsInput
1136
+ # data as a hash:
1137
+ #
1138
+ # {
1139
+ # query_execution_id: "QueryExecutionId", # required
1140
+ # }
1141
+ #
1142
+ # @!attribute [rw] query_execution_id
1143
+ # The unique ID of the query execution.
1144
+ # @return [String]
1145
+ #
1146
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryRuntimeStatisticsInput AWS API Documentation
1147
+ #
1148
+ class GetQueryRuntimeStatisticsInput < Struct.new(
1149
+ :query_execution_id)
1150
+ SENSITIVE = []
1151
+ include Aws::Structure
1152
+ end
1153
+
1154
+ # @!attribute [rw] query_runtime_statistics
1155
+ # Runtime statistics about the query execution.
1156
+ # @return [Types::QueryRuntimeStatistics]
1157
+ #
1158
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryRuntimeStatisticsOutput AWS API Documentation
1159
+ #
1160
+ class GetQueryRuntimeStatisticsOutput < Struct.new(
1161
+ :query_runtime_statistics)
1162
+ SENSITIVE = []
1163
+ include Aws::Structure
1164
+ end
1165
+
1088
1166
  # @note When making an API call, you may pass GetTableMetadataInput
1089
1167
  # data as a hash:
1090
1168
  #
@@ -1837,6 +1915,12 @@ module Aws::Athena
1837
1915
  # The engine version that executed the query.
1838
1916
  # @return [Types::EngineVersion]
1839
1917
  #
1918
+ # @!attribute [rw] execution_parameters
1919
+ # A list of values for the parameters in a query. The values are
1920
+ # applied sequentially to the parameters in the query in the order in
1921
+ # which the parameters occur.
1922
+ # @return [Array<String>]
1923
+ #
1840
1924
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecution AWS API Documentation
1841
1925
  #
1842
1926
  class QueryExecution < Struct.new(
@@ -1848,7 +1932,8 @@ module Aws::Athena
1848
1932
  :status,
1849
1933
  :statistics,
1850
1934
  :work_group,
1851
- :engine_version)
1935
+ :engine_version,
1936
+ :execution_parameters)
1852
1937
  SENSITIVE = []
1853
1938
  include Aws::Structure
1854
1939
  end
@@ -1993,12 +2078,207 @@ module Aws::Athena
1993
2078
  include Aws::Structure
1994
2079
  end
1995
2080
 
2081
+ # The query execution timeline, statistics on input and output rows and
2082
+ # bytes, and the different query stages that form the query execution
2083
+ # plan.
2084
+ #
2085
+ # @!attribute [rw] timeline
2086
+ # Timeline statistics such as query queue time, planning time,
2087
+ # execution time, service processing time, and total execution time.
2088
+ # @return [Types::QueryRuntimeStatisticsTimeline]
2089
+ #
2090
+ # @!attribute [rw] rows
2091
+ # Statistics such as input rows and bytes read by the query, rows and
2092
+ # bytes output by the query, and the number of rows written by the
2093
+ # query.
2094
+ # @return [Types::QueryRuntimeStatisticsRows]
2095
+ #
2096
+ # @!attribute [rw] output_stage
2097
+ # Stage statistics such as input and output rows and bytes, execution
2098
+ # time, and stage state. This information also includes substages and
2099
+ # the query stage plan.
2100
+ # @return [Types::QueryStage]
2101
+ #
2102
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryRuntimeStatistics AWS API Documentation
2103
+ #
2104
+ class QueryRuntimeStatistics < Struct.new(
2105
+ :timeline,
2106
+ :rows,
2107
+ :output_stage)
2108
+ SENSITIVE = []
2109
+ include Aws::Structure
2110
+ end
2111
+
2112
+ # Statistics such as input rows and bytes read by the query, rows and
2113
+ # bytes output by the query, and the number of rows written by the
2114
+ # query.
2115
+ #
2116
+ # @!attribute [rw] input_rows
2117
+ # The number of rows read to execute the query.
2118
+ # @return [Integer]
2119
+ #
2120
+ # @!attribute [rw] input_bytes
2121
+ # The number of bytes read to execute the query.
2122
+ # @return [Integer]
2123
+ #
2124
+ # @!attribute [rw] output_bytes
2125
+ # The number of bytes returned by the query.
2126
+ # @return [Integer]
2127
+ #
2128
+ # @!attribute [rw] output_rows
2129
+ # The number of rows returned by the query.
2130
+ # @return [Integer]
2131
+ #
2132
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryRuntimeStatisticsRows AWS API Documentation
2133
+ #
2134
+ class QueryRuntimeStatisticsRows < Struct.new(
2135
+ :input_rows,
2136
+ :input_bytes,
2137
+ :output_bytes,
2138
+ :output_rows)
2139
+ SENSITIVE = []
2140
+ include Aws::Structure
2141
+ end
2142
+
2143
+ # Timeline statistics such as query queue time, planning time, execution
2144
+ # time, service processing time, and total execution time.
2145
+ #
2146
+ # @!attribute [rw] query_queue_time_in_millis
2147
+ # The number of milliseconds that the query was in your query queue
2148
+ # waiting for resources. Note that if transient errors occur, Athena
2149
+ # might automatically add the query back to the queue.
2150
+ # @return [Integer]
2151
+ #
2152
+ # @!attribute [rw] query_planning_time_in_millis
2153
+ # The number of milliseconds that Athena took to plan the query
2154
+ # processing flow. This includes the time spent retrieving table
2155
+ # partitions from the data source. Note that because the query engine
2156
+ # performs the query planning, query planning time is a subset of
2157
+ # engine processing time.
2158
+ # @return [Integer]
2159
+ #
2160
+ # @!attribute [rw] engine_execution_time_in_millis
2161
+ # The number of milliseconds that the query took to execute.
2162
+ # @return [Integer]
2163
+ #
2164
+ # @!attribute [rw] service_processing_time_in_millis
2165
+ # The number of milliseconds that Athena took to finalize and publish
2166
+ # the query results after the query engine finished running the query.
2167
+ # @return [Integer]
2168
+ #
2169
+ # @!attribute [rw] total_execution_time_in_millis
2170
+ # The number of milliseconds that Athena took to run the query.
2171
+ # @return [Integer]
2172
+ #
2173
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryRuntimeStatisticsTimeline AWS API Documentation
2174
+ #
2175
+ class QueryRuntimeStatisticsTimeline < Struct.new(
2176
+ :query_queue_time_in_millis,
2177
+ :query_planning_time_in_millis,
2178
+ :engine_execution_time_in_millis,
2179
+ :service_processing_time_in_millis,
2180
+ :total_execution_time_in_millis)
2181
+ SENSITIVE = []
2182
+ include Aws::Structure
2183
+ end
2184
+
2185
+ # Stage statistics such as input and output rows and bytes, execution
2186
+ # time and stage state. This information also includes substages and the
2187
+ # query stage plan.
2188
+ #
2189
+ # @!attribute [rw] stage_id
2190
+ # The identifier for a stage.
2191
+ # @return [Integer]
2192
+ #
2193
+ # @!attribute [rw] state
2194
+ # State of the stage after query execution.
2195
+ # @return [String]
2196
+ #
2197
+ # @!attribute [rw] output_bytes
2198
+ # The number of bytes output from the stage after execution.
2199
+ # @return [Integer]
2200
+ #
2201
+ # @!attribute [rw] output_rows
2202
+ # The number of rows output from the stage after execution.
2203
+ # @return [Integer]
2204
+ #
2205
+ # @!attribute [rw] input_bytes
2206
+ # The number of bytes input into the stage for execution.
2207
+ # @return [Integer]
2208
+ #
2209
+ # @!attribute [rw] input_rows
2210
+ # The number of rows input into the stage for execution.
2211
+ # @return [Integer]
2212
+ #
2213
+ # @!attribute [rw] execution_time
2214
+ # Time taken to execute this stage.
2215
+ # @return [Integer]
2216
+ #
2217
+ # @!attribute [rw] query_stage_plan
2218
+ # Stage plan information such as name, identifier, sub plans, and
2219
+ # source stages.
2220
+ # @return [Types::QueryStagePlanNode]
2221
+ #
2222
+ # @!attribute [rw] sub_stages
2223
+ # List of sub query stages that form this stage execution plan.
2224
+ # @return [Array<Types::QueryStage>]
2225
+ #
2226
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryStage AWS API Documentation
2227
+ #
2228
+ class QueryStage < Struct.new(
2229
+ :stage_id,
2230
+ :state,
2231
+ :output_bytes,
2232
+ :output_rows,
2233
+ :input_bytes,
2234
+ :input_rows,
2235
+ :execution_time,
2236
+ :query_stage_plan,
2237
+ :sub_stages)
2238
+ SENSITIVE = []
2239
+ include Aws::Structure
2240
+ end
2241
+
2242
+ # Stage plan information such as name, identifier, sub plans, and remote
2243
+ # sources.
2244
+ #
2245
+ # @!attribute [rw] name
2246
+ # Name of the query stage plan that describes the operation this stage
2247
+ # is performing as part of query execution.
2248
+ # @return [String]
2249
+ #
2250
+ # @!attribute [rw] identifier
2251
+ # Information about the operation this query stage plan node is
2252
+ # performing.
2253
+ # @return [String]
2254
+ #
2255
+ # @!attribute [rw] children
2256
+ # Stage plan information such as name, identifier, sub plans, and
2257
+ # remote sources of child plan nodes/
2258
+ # @return [Array<Types::QueryStagePlanNode>]
2259
+ #
2260
+ # @!attribute [rw] remote_sources
2261
+ # Source plan node IDs.
2262
+ # @return [Array<String>]
2263
+ #
2264
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryStagePlanNode AWS API Documentation
2265
+ #
2266
+ class QueryStagePlanNode < Struct.new(
2267
+ :name,
2268
+ :identifier,
2269
+ :children,
2270
+ :remote_sources)
2271
+ SENSITIVE = []
2272
+ include Aws::Structure
2273
+ end
2274
+
1996
2275
  # A resource, such as a workgroup, was not found.
1997
2276
  #
1998
2277
  # @!attribute [rw] message
1999
2278
  # @return [String]
2000
2279
  #
2001
2280
  # @!attribute [rw] resource_name
2281
+ # The name of the Amazon resource.
2002
2282
  # @return [String]
2003
2283
  #
2004
2284
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ResourceNotFoundException AWS API Documentation
@@ -2019,12 +2299,12 @@ module Aws::Athena
2019
2299
  # data as a hash:
2020
2300
  #
2021
2301
  # {
2022
- # output_location: "String",
2302
+ # output_location: "ResultOutputLocation",
2023
2303
  # encryption_configuration: {
2024
2304
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2025
2305
  # kms_key: "String",
2026
2306
  # },
2027
- # expected_bucket_owner: "String",
2307
+ # expected_bucket_owner: "AwsAccountId",
2028
2308
  # acl_configuration: {
2029
2309
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
2030
2310
  # },
@@ -2117,14 +2397,14 @@ module Aws::Athena
2117
2397
  # data as a hash:
2118
2398
  #
2119
2399
  # {
2120
- # output_location: "String",
2400
+ # output_location: "ResultOutputLocation",
2121
2401
  # remove_output_location: false,
2122
2402
  # encryption_configuration: {
2123
2403
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2124
2404
  # kms_key: "String",
2125
2405
  # },
2126
2406
  # remove_encryption_configuration: false,
2127
- # expected_bucket_owner: "String",
2407
+ # expected_bucket_owner: "AwsAccountId",
2128
2408
  # remove_expected_bucket_owner: false,
2129
2409
  # acl_configuration: {
2130
2410
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
@@ -2315,17 +2595,18 @@ module Aws::Athena
2315
2595
  # catalog: "CatalogNameString",
2316
2596
  # },
2317
2597
  # result_configuration: {
2318
- # output_location: "String",
2598
+ # output_location: "ResultOutputLocation",
2319
2599
  # encryption_configuration: {
2320
2600
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2321
2601
  # kms_key: "String",
2322
2602
  # },
2323
- # expected_bucket_owner: "String",
2603
+ # expected_bucket_owner: "AwsAccountId",
2324
2604
  # acl_configuration: {
2325
2605
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
2326
2606
  # },
2327
2607
  # },
2328
2608
  # work_group: "WorkGroupName",
2609
+ # execution_parameters: ["ExecutionParameter"],
2329
2610
  # }
2330
2611
  #
2331
2612
  # @!attribute [rw] query_string
@@ -2367,6 +2648,12 @@ module Aws::Athena
2367
2648
  # The name of the workgroup in which the query is being started.
2368
2649
  # @return [String]
2369
2650
  #
2651
+ # @!attribute [rw] execution_parameters
2652
+ # A list of values for the parameters in a query. The values are
2653
+ # applied sequentially to the parameters in the query in the order in
2654
+ # which the parameters occur.
2655
+ # @return [Array<String>]
2656
+ #
2370
2657
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/StartQueryExecutionInput AWS API Documentation
2371
2658
  #
2372
2659
  class StartQueryExecutionInput < Struct.new(
@@ -2374,7 +2661,8 @@ module Aws::Athena
2374
2661
  :client_request_token,
2375
2662
  :query_execution_context,
2376
2663
  :result_configuration,
2377
- :work_group)
2664
+ :work_group,
2665
+ :execution_parameters)
2378
2666
  SENSITIVE = []
2379
2667
  include Aws::Structure
2380
2668
  end
@@ -2590,6 +2878,42 @@ module Aws::Athena
2590
2878
  include Aws::Structure
2591
2879
  end
2592
2880
 
2881
+ # The name of a prepared statement that could not be returned.
2882
+ #
2883
+ # @!attribute [rw] statement_name
2884
+ # The name of a prepared statement that could not be returned due to
2885
+ # an error.
2886
+ # @return [String]
2887
+ #
2888
+ # @!attribute [rw] error_code
2889
+ # The error code returned when the request for the prepared statement
2890
+ # failed.
2891
+ # @return [String]
2892
+ #
2893
+ # @!attribute [rw] error_message
2894
+ # The error message containing the reason why the prepared statement
2895
+ # could not be returned. The following error messages are possible:
2896
+ #
2897
+ # * `INVALID_INPUT` - The name of the prepared statement that was
2898
+ # provided is not valid (for example, the name is too long).
2899
+ #
2900
+ # * `STATEMENT_NOT_FOUND` - A prepared statement with the name
2901
+ # provided could not be found.
2902
+ #
2903
+ # * `UNAUTHORIZED` - The requester does not have permission to access
2904
+ # the workgroup that contains the prepared statement.
2905
+ # @return [String]
2906
+ #
2907
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UnprocessedPreparedStatementName AWS API Documentation
2908
+ #
2909
+ class UnprocessedPreparedStatementName < Struct.new(
2910
+ :statement_name,
2911
+ :error_code,
2912
+ :error_message)
2913
+ SENSITIVE = []
2914
+ include Aws::Structure
2915
+ end
2916
+
2593
2917
  # Describes a query execution that failed to process.
2594
2918
  #
2595
2919
  # @!attribute [rw] query_execution_id
@@ -2810,14 +3134,14 @@ module Aws::Athena
2810
3134
  # configuration_updates: {
2811
3135
  # enforce_work_group_configuration: false,
2812
3136
  # result_configuration_updates: {
2813
- # output_location: "String",
3137
+ # output_location: "ResultOutputLocation",
2814
3138
  # remove_output_location: false,
2815
3139
  # encryption_configuration: {
2816
3140
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2817
3141
  # kms_key: "String",
2818
3142
  # },
2819
3143
  # remove_encryption_configuration: false,
2820
- # expected_bucket_owner: "String",
3144
+ # expected_bucket_owner: "AwsAccountId",
2821
3145
  # remove_expected_bucket_owner: false,
2822
3146
  # acl_configuration: {
2823
3147
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
@@ -2936,12 +3260,12 @@ module Aws::Athena
2936
3260
  #
2937
3261
  # {
2938
3262
  # result_configuration: {
2939
- # output_location: "String",
3263
+ # output_location: "ResultOutputLocation",
2940
3264
  # encryption_configuration: {
2941
3265
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
2942
3266
  # kms_key: "String",
2943
3267
  # },
2944
- # expected_bucket_owner: "String",
3268
+ # expected_bucket_owner: "AwsAccountId",
2945
3269
  # acl_configuration: {
2946
3270
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
2947
3271
  # },
@@ -3039,14 +3363,14 @@ module Aws::Athena
3039
3363
  # {
3040
3364
  # enforce_work_group_configuration: false,
3041
3365
  # result_configuration_updates: {
3042
- # output_location: "String",
3366
+ # output_location: "ResultOutputLocation",
3043
3367
  # remove_output_location: false,
3044
3368
  # encryption_configuration: {
3045
3369
  # encryption_option: "SSE_S3", # required, accepts SSE_S3, SSE_KMS, CSE_KMS
3046
3370
  # kms_key: "String",
3047
3371
  # },
3048
3372
  # remove_encryption_configuration: false,
3049
- # expected_bucket_owner: "String",
3373
+ # expected_bucket_owner: "AwsAccountId",
3050
3374
  # remove_expected_bucket_owner: false,
3051
3375
  # acl_configuration: {
3052
3376
  # s3_acl_option: "BUCKET_OWNER_FULL_CONTROL", # required, accepts BUCKET_OWNER_FULL_CONTROL
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-athena/customizations'
48
48
  # @!group service
49
49
  module Aws::Athena
50
50
 
51
- GEM_VERSION = '1.53.0'
51
+ GEM_VERSION = '1.56.0'
52
52
 
53
53
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-athena
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.53.0
4
+ version: 1.56.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2022-04-15 00:00:00.000000000 Z
11
+ date: 2022-07-21 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core