aws-sdk-athena 1.53.0 → 1.56.0

Sign up to get free protection for your applications and to get access to all the features.
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