aws-sdk-athena 1.74.0 → 1.80.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: fb2a44186d822aba993dc12fdab4bbab74c48df03b712f15e4145463c0281f9f
4
- data.tar.gz: 98ac065d60c10b90a2f27162b279a30f4bbdc838ea3cc16f5c6e7f5636770e84
3
+ metadata.gz: 1f5d691cbe84be625ed0fdd128696b2fab544e785933545755e0a3b578e0a1d7
4
+ data.tar.gz: 514d2d90b3708547c8f4c2125804c0f648178f66d0702c162a7e6cadd6f69dcc
5
5
  SHA512:
6
- metadata.gz: 86cc71c817a0f14145e00dc7d51726aeebec1a0a749a3161ad4ce64c4fa4a3940da88e659ee962d0ba553ec2d9732dc9cdb30fe30f48fe0ba79884ebcbf9bd47
7
- data.tar.gz: f77f2e1b871a09057d484a987cc4d0432ec3f422c3749ad37b110aa6781b9f2a4aa044c1e7769ca8b26dd6101db4cd98c8c61599578639013b2346a84277f981
6
+ metadata.gz: 7719d9c6c7db4573513002ec14ccfa00fe4b864035f2746e0447e2bdebb9e4ad85008c8b47896eb58f9ee3d8793960968eb27f7c4db7ab3cad1c73d841fe1518
7
+ data.tar.gz: 62dc62497d64469a2dd043351c7b8612985366139444c4f45e77cf680171651217e859d9e7628028e2b061d2f7814d690f5a48fe0c64a36950cc4b2a30870130
data/CHANGELOG.md CHANGED
@@ -1,6 +1,36 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.80.0 (2024-01-19)
5
+ ------------------
6
+
7
+ * Feature - Introducing new NotebookS3LocationUri parameter to Athena ImportNotebook API. Payload is no longer required and either Payload or NotebookS3LocationUri needs to be provided (not both) for a successful ImportNotebook API call. If both are provided, an InvalidRequestException will be thrown.
8
+
9
+ 1.79.0 (2023-12-05)
10
+ ------------------
11
+
12
+ * Feature - Adding IdentityCenter enabled request for interactive query
13
+
14
+ 1.78.0 (2023-11-28)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.77.0 (2023-11-22)
20
+ ------------------
21
+
22
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
23
+
24
+ 1.76.0 (2023-11-17)
25
+ ------------------
26
+
27
+ * Feature - Adding SerivicePreProcessing time metric
28
+
29
+ 1.75.0 (2023-09-27)
30
+ ------------------
31
+
32
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
33
+
4
34
  1.74.0 (2023-07-11)
5
35
  ------------------
6
36
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.74.0
1
+ 1.80.0
@@ -543,6 +543,7 @@ module Aws::Athena
543
543
  # resp.query_executions[0].statistics.data_manifest_location #=> String
544
544
  # resp.query_executions[0].statistics.total_execution_time_in_millis #=> Integer
545
545
  # resp.query_executions[0].statistics.query_queue_time_in_millis #=> Integer
546
+ # resp.query_executions[0].statistics.service_pre_processing_time_in_millis #=> Integer
546
547
  # resp.query_executions[0].statistics.query_planning_time_in_millis #=> Integer
547
548
  # resp.query_executions[0].statistics.service_processing_time_in_millis #=> Integer
548
549
  # resp.query_executions[0].statistics.result_reuse_information.reused_previous_result #=> Boolean
@@ -552,6 +553,9 @@ module Aws::Athena
552
553
  # resp.query_executions[0].execution_parameters #=> Array
553
554
  # resp.query_executions[0].execution_parameters[0] #=> String
554
555
  # resp.query_executions[0].substatement_type #=> String
556
+ # resp.query_executions[0].query_results_s3_access_grants_configuration.enable_s3_access_grants #=> Boolean
557
+ # resp.query_executions[0].query_results_s3_access_grants_configuration.create_user_level_prefix #=> Boolean
558
+ # resp.query_executions[0].query_results_s3_access_grants_configuration.authentication_type #=> String, one of "DIRECTORY_IDENTITY"
555
559
  # resp.unprocessed_query_execution_ids #=> Array
556
560
  # resp.unprocessed_query_execution_ids[0].query_execution_id #=> String
557
561
  # resp.unprocessed_query_execution_ids[0].error_code #=> String
@@ -684,12 +688,7 @@ module Aws::Athena
684
688
  # `AwsDataCatalog` that already exists in your account, of which you
685
689
  # can have only one and cannot modify.
686
690
  #
687
- # * Queries that specify a Glue Data Catalog other than the default
688
- # `AwsDataCatalog` must be run on Athena engine version 2.
689
- #
690
- # * In Regions where Athena engine version 2 is not available,
691
- # creating new Glue data catalogs results in an `INVALID_INPUT`
692
- # error.
691
+ # ^
693
692
  #
694
693
  # @option params [Array<Types::Tag>] :tags
695
694
  # A list of comma separated tags to add to the data catalog that is
@@ -726,13 +725,6 @@ module Aws::Athena
726
725
  # Creates a named query in the specified workgroup. Requires that you
727
726
  # have access to the workgroup.
728
727
  #
729
- # For code samples using the Amazon Web Services SDK for Java, see
730
- # [Examples and Code Samples][1] in the *Amazon Athena User Guide*.
731
- #
732
- #
733
- #
734
- # [1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
735
- #
736
728
  # @option params [required, String] :name
737
729
  # The query name.
738
730
  #
@@ -970,6 +962,15 @@ module Aws::Athena
970
962
  # kms_key: "KmsKey", # required
971
963
  # },
972
964
  # enable_minimum_encryption_configuration: false,
965
+ # identity_center_configuration: {
966
+ # enable_identity_center: false,
967
+ # identity_center_instance_arn: "IdentityCenterInstanceArn",
968
+ # },
969
+ # query_results_s3_access_grants_configuration: {
970
+ # enable_s3_access_grants: false, # required
971
+ # create_user_level_prefix: false,
972
+ # authentication_type: "DIRECTORY_IDENTITY", # required, accepts DIRECTORY_IDENTITY
973
+ # },
973
974
  # },
974
975
  # description: "WorkGroupDescriptionString",
975
976
  # tags: [
@@ -1041,13 +1042,6 @@ module Aws::Athena
1041
1042
  # Deletes the named query if you have access to the workgroup in which
1042
1043
  # the query was saved.
1043
1044
  #
1044
- # For code samples using the Amazon Web Services SDK for Java, see
1045
- # [Examples and Code Samples][1] in the *Amazon Athena User Guide*.
1046
- #
1047
- #
1048
- #
1049
- # [1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
1050
- #
1051
1045
  # @option params [required, String] :named_query_id
1052
1046
  # The unique ID of the query to delete.
1053
1047
  #
@@ -1368,6 +1362,10 @@ module Aws::Athena
1368
1362
  # @option params [required, String] :name
1369
1363
  # The name of the data catalog to return.
1370
1364
  #
1365
+ # @option params [String] :work_group
1366
+ # The name of the workgroup. Required if making an IAM Identity Center
1367
+ # request.
1368
+ #
1371
1369
  # @return [Types::GetDataCatalogOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1372
1370
  #
1373
1371
  # * {Types::GetDataCatalogOutput#data_catalog #data_catalog} => Types::DataCatalog
@@ -1376,6 +1374,7 @@ module Aws::Athena
1376
1374
  #
1377
1375
  # resp = client.get_data_catalog({
1378
1376
  # name: "CatalogNameString", # required
1377
+ # work_group: "WorkGroupName",
1379
1378
  # })
1380
1379
  #
1381
1380
  # @example Response structure
@@ -1403,6 +1402,11 @@ module Aws::Athena
1403
1402
  # @option params [required, String] :database_name
1404
1403
  # The name of the database to return.
1405
1404
  #
1405
+ # @option params [String] :work_group
1406
+ # The name of the workgroup for which the metadata is being fetched.
1407
+ # Required if requesting an IAM Identity Center enabled Glue Data
1408
+ # Catalog.
1409
+ #
1406
1410
  # @return [Types::GetDatabaseOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1407
1411
  #
1408
1412
  # * {Types::GetDatabaseOutput#database #database} => Types::Database
@@ -1412,6 +1416,7 @@ module Aws::Athena
1412
1416
  # resp = client.get_database({
1413
1417
  # catalog_name: "CatalogNameString", # required
1414
1418
  # database_name: "NameString", # required
1419
+ # work_group: "WorkGroupName",
1415
1420
  # })
1416
1421
  #
1417
1422
  # @example Response structure
@@ -1579,6 +1584,7 @@ module Aws::Athena
1579
1584
  # resp.query_execution.statistics.data_manifest_location #=> String
1580
1585
  # resp.query_execution.statistics.total_execution_time_in_millis #=> Integer
1581
1586
  # resp.query_execution.statistics.query_queue_time_in_millis #=> Integer
1587
+ # resp.query_execution.statistics.service_pre_processing_time_in_millis #=> Integer
1582
1588
  # resp.query_execution.statistics.query_planning_time_in_millis #=> Integer
1583
1589
  # resp.query_execution.statistics.service_processing_time_in_millis #=> Integer
1584
1590
  # resp.query_execution.statistics.result_reuse_information.reused_previous_result #=> Boolean
@@ -1588,6 +1594,9 @@ module Aws::Athena
1588
1594
  # resp.query_execution.execution_parameters #=> Array
1589
1595
  # resp.query_execution.execution_parameters[0] #=> String
1590
1596
  # resp.query_execution.substatement_type #=> String
1597
+ # resp.query_execution.query_results_s3_access_grants_configuration.enable_s3_access_grants #=> Boolean
1598
+ # resp.query_execution.query_results_s3_access_grants_configuration.create_user_level_prefix #=> Boolean
1599
+ # resp.query_execution.query_results_s3_access_grants_configuration.authentication_type #=> String, one of "DIRECTORY_IDENTITY"
1591
1600
  #
1592
1601
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution AWS API Documentation
1593
1602
  #
@@ -1699,6 +1708,7 @@ module Aws::Athena
1699
1708
  # @example Response structure
1700
1709
  #
1701
1710
  # resp.query_runtime_statistics.timeline.query_queue_time_in_millis #=> Integer
1711
+ # resp.query_runtime_statistics.timeline.service_pre_processing_time_in_millis #=> Integer
1702
1712
  # resp.query_runtime_statistics.timeline.query_planning_time_in_millis #=> Integer
1703
1713
  # resp.query_runtime_statistics.timeline.engine_execution_time_in_millis #=> Integer
1704
1714
  # resp.query_runtime_statistics.timeline.service_processing_time_in_millis #=> Integer
@@ -1839,6 +1849,11 @@ module Aws::Athena
1839
1849
  # @option params [required, String] :table_name
1840
1850
  # The name of the table for which metadata is returned.
1841
1851
  #
1852
+ # @option params [String] :work_group
1853
+ # The name of the workgroup for which the metadata is being fetched.
1854
+ # Required if requesting an IAM Identity Center enabled Glue Data
1855
+ # Catalog.
1856
+ #
1842
1857
  # @return [Types::GetTableMetadataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1843
1858
  #
1844
1859
  # * {Types::GetTableMetadataOutput#table_metadata #table_metadata} => Types::TableMetadata
@@ -1849,6 +1864,7 @@ module Aws::Athena
1849
1864
  # catalog_name: "CatalogNameString", # required
1850
1865
  # database_name: "NameString", # required
1851
1866
  # table_name: "NameString", # required
1867
+ # work_group: "WorkGroupName",
1852
1868
  # })
1853
1869
  #
1854
1870
  # @example Response structure
@@ -1911,8 +1927,14 @@ module Aws::Athena
1911
1927
  # resp.work_group.configuration.execution_role #=> String
1912
1928
  # resp.work_group.configuration.customer_content_encryption_configuration.kms_key #=> String
1913
1929
  # resp.work_group.configuration.enable_minimum_encryption_configuration #=> Boolean
1930
+ # resp.work_group.configuration.identity_center_configuration.enable_identity_center #=> Boolean
1931
+ # resp.work_group.configuration.identity_center_configuration.identity_center_instance_arn #=> String
1932
+ # resp.work_group.configuration.query_results_s3_access_grants_configuration.enable_s3_access_grants #=> Boolean
1933
+ # resp.work_group.configuration.query_results_s3_access_grants_configuration.create_user_level_prefix #=> Boolean
1934
+ # resp.work_group.configuration.query_results_s3_access_grants_configuration.authentication_type #=> String, one of "DIRECTORY_IDENTITY"
1914
1935
  # resp.work_group.description #=> String
1915
1936
  # resp.work_group.creation_time #=> Time
1937
+ # resp.work_group.identity_center_application_arn #=> String
1916
1938
  #
1917
1939
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetWorkGroup AWS API Documentation
1918
1940
  #
@@ -1923,10 +1945,12 @@ module Aws::Athena
1923
1945
  req.send_request(options)
1924
1946
  end
1925
1947
 
1926
- # Imports a single `ipynb` file to a Spark enabled workgroup. The
1927
- # maximum file size that can be imported is 10 megabytes. If an `ipynb`
1928
- # file with the same name already exists in the workgroup, throws an
1929
- # error.
1948
+ # Imports a single `ipynb` file to a Spark enabled workgroup. To import
1949
+ # the notebook, the request must specify a value for either `Payload` or
1950
+ # `NoteBookS3LocationUri`. If neither is specified or both are
1951
+ # specified, an `InvalidRequestException` occurs. The maximum file size
1952
+ # that can be imported is 10 megabytes. If an `ipynb` file with the same
1953
+ # name already exists in the workgroup, throws an error.
1930
1954
  #
1931
1955
  # @option params [required, String] :work_group
1932
1956
  # The name of the Spark enabled workgroup to import the notebook to.
@@ -1934,12 +1958,17 @@ module Aws::Athena
1934
1958
  # @option params [required, String] :name
1935
1959
  # The name of the notebook to import.
1936
1960
  #
1937
- # @option params [required, String] :payload
1938
- # The notebook content to be imported.
1961
+ # @option params [String] :payload
1962
+ # The notebook content to be imported. The payload must be in `ipynb`
1963
+ # format.
1939
1964
  #
1940
1965
  # @option params [required, String] :type
1941
1966
  # The notebook content type. Currently, the only valid type is `IPYNB`.
1942
1967
  #
1968
+ # @option params [String] :notebook_s3_location_uri
1969
+ # A URI that specifies the Amazon S3 location of a notebook file in
1970
+ # `ipynb` format.
1971
+ #
1943
1972
  # @option params [String] :client_request_token
1944
1973
  # A unique case-sensitive string used to ensure the request to import
1945
1974
  # the notebook is idempotent (executes only once).
@@ -1959,8 +1988,9 @@ module Aws::Athena
1959
1988
  # resp = client.import_notebook({
1960
1989
  # work_group: "WorkGroupName", # required
1961
1990
  # name: "NotebookName", # required
1962
- # payload: "Payload", # required
1991
+ # payload: "Payload",
1963
1992
  # type: "IPYNB", # required, accepts IPYNB
1993
+ # notebook_s3_location_uri: "S3Uri",
1964
1994
  # client_request_token: "ClientRequestToken",
1965
1995
  # })
1966
1996
  #
@@ -2155,6 +2185,10 @@ module Aws::Athena
2155
2185
  # @option params [Integer] :max_results
2156
2186
  # Specifies the maximum number of data catalogs to return.
2157
2187
  #
2188
+ # @option params [String] :work_group
2189
+ # The name of the workgroup. Required if making an IAM Identity Center
2190
+ # request.
2191
+ #
2158
2192
  # @return [Types::ListDataCatalogsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2159
2193
  #
2160
2194
  # * {Types::ListDataCatalogsOutput#data_catalogs_summary #data_catalogs_summary} => Array&lt;Types::DataCatalogSummary&gt;
@@ -2167,6 +2201,7 @@ module Aws::Athena
2167
2201
  # resp = client.list_data_catalogs({
2168
2202
  # next_token: "Token",
2169
2203
  # max_results: 1,
2204
+ # work_group: "WorkGroupName",
2170
2205
  # })
2171
2206
  #
2172
2207
  # @example Response structure
@@ -2199,6 +2234,11 @@ module Aws::Athena
2199
2234
  # @option params [Integer] :max_results
2200
2235
  # Specifies the maximum number of results to return.
2201
2236
  #
2237
+ # @option params [String] :work_group
2238
+ # The name of the workgroup for which the metadata is being fetched.
2239
+ # Required if requesting an IAM Identity Center enabled Glue Data
2240
+ # Catalog.
2241
+ #
2202
2242
  # @return [Types::ListDatabasesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2203
2243
  #
2204
2244
  # * {Types::ListDatabasesOutput#database_list #database_list} => Array&lt;Types::Database&gt;
@@ -2212,6 +2252,7 @@ module Aws::Athena
2212
2252
  # catalog_name: "CatalogNameString", # required
2213
2253
  # next_token: "Token",
2214
2254
  # max_results: 1,
2255
+ # work_group: "WorkGroupName",
2215
2256
  # })
2216
2257
  #
2217
2258
  # @example Response structure
@@ -2350,13 +2391,6 @@ module Aws::Athena
2350
2391
  # workgroup. If a workgroup is not specified, lists the saved queries
2351
2392
  # for the primary workgroup.
2352
2393
  #
2353
- # For code samples using the Amazon Web Services SDK for Java, see
2354
- # [Examples and Code Samples][1] in the *Amazon Athena User Guide*.
2355
- #
2356
- #
2357
- #
2358
- # [1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
2359
- #
2360
2394
  # @option params [String] :next_token
2361
2395
  # A token generated by the Athena service that specifies where to
2362
2396
  # continue pagination if a previous request was truncated. To obtain the
@@ -2546,16 +2580,10 @@ module Aws::Athena
2546
2580
  end
2547
2581
 
2548
2582
  # Provides a list of available query execution IDs for the queries in
2549
- # the specified workgroup. If a workgroup is not specified, returns a
2550
- # list of query execution IDs for the primary workgroup. Requires you to
2551
- # have access to the workgroup in which the queries ran.
2552
- #
2553
- # For code samples using the Amazon Web Services SDK for Java, see
2554
- # [Examples and Code Samples][1] in the *Amazon Athena User Guide*.
2555
- #
2556
- #
2557
- #
2558
- # [1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
2583
+ # the specified workgroup. Athena keeps a query history for 45 days. If
2584
+ # a workgroup is not specified, returns a list of query execution IDs
2585
+ # for the primary workgroup. Requires you to have access to the
2586
+ # workgroup in which the queries ran.
2559
2587
  #
2560
2588
  # @option params [String] :next_token
2561
2589
  # A token generated by the Athena service that specifies where to
@@ -2704,6 +2732,11 @@ module Aws::Athena
2704
2732
  # @option params [Integer] :max_results
2705
2733
  # Specifies the maximum number of results to return.
2706
2734
  #
2735
+ # @option params [String] :work_group
2736
+ # The name of the workgroup for which the metadata is being fetched.
2737
+ # Required if requesting an IAM Identity Center enabled Glue Data
2738
+ # Catalog.
2739
+ #
2707
2740
  # @return [Types::ListTableMetadataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2708
2741
  #
2709
2742
  # * {Types::ListTableMetadataOutput#table_metadata_list #table_metadata_list} => Array&lt;Types::TableMetadata&gt;
@@ -2719,6 +2752,7 @@ module Aws::Athena
2719
2752
  # expression: "ExpressionString",
2720
2753
  # next_token: "Token",
2721
2754
  # max_results: 1,
2755
+ # work_group: "WorkGroupName",
2722
2756
  # })
2723
2757
  #
2724
2758
  # @example Response structure
@@ -2828,6 +2862,7 @@ module Aws::Athena
2828
2862
  # resp.work_groups[0].creation_time #=> Time
2829
2863
  # resp.work_groups[0].engine_version.selected_engine_version #=> String
2830
2864
  # resp.work_groups[0].engine_version.effective_engine_version #=> String
2865
+ # resp.work_groups[0].identity_center_application_arn #=> String
2831
2866
  # resp.next_token #=> String
2832
2867
  #
2833
2868
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListWorkGroups AWS API Documentation
@@ -2876,6 +2911,14 @@ module Aws::Athena
2876
2911
  # Submits calculations for execution within a session. You can supply
2877
2912
  # the code to run as an inline code block within the request.
2878
2913
  #
2914
+ # <note markdown="1"> The request syntax requires the
2915
+ # StartCalculationExecutionRequest$CodeBlock parameter or the
2916
+ # CalculationConfiguration$CodeBlock parameter, but not both. Because
2917
+ # CalculationConfiguration$CodeBlock is deprecated, use the
2918
+ # StartCalculationExecutionRequest$CodeBlock parameter instead.
2919
+ #
2920
+ # </note>
2921
+ #
2879
2922
  # @option params [required, String] :session_id
2880
2923
  # The session ID.
2881
2924
  #
@@ -2886,7 +2929,8 @@ module Aws::Athena
2886
2929
  # Contains configuration information for the calculation.
2887
2930
  #
2888
2931
  # @option params [String] :code_block
2889
- # A string that contains the code of the calculation.
2932
+ # A string that contains the code of the calculation. Use this parameter
2933
+ # instead of CalculationConfiguration$CodeBlock, which is deprecated.
2890
2934
  #
2891
2935
  # @option params [String] :client_request_token
2892
2936
  # A unique case-sensitive string used to ensure the request to create
@@ -2950,8 +2994,11 @@ module Aws::Athena
2950
2994
  # A unique case-sensitive string used to ensure the request to create
2951
2995
  # the query is idempotent (executes only once). If another
2952
2996
  # `StartQueryExecution` request is received, the same response is
2953
- # returned and another query is not created. If a parameter has changed,
2954
- # for example, the `QueryString`, an error is returned.
2997
+ # returned and another query is not created. An error is returned if a
2998
+ # parameter, such as `QueryString`, has changed. A call to
2999
+ # `StartQueryExecution` that uses a previous client request token
3000
+ # returns the same `QueryExecutionId` even if the requester doesn't
3001
+ # have permission on the tables specified in `QueryString`.
2955
3002
  #
2956
3003
  # This token is listed as not required because Amazon Web Services SDKs
2957
3004
  # (for example the Amazon Web Services SDK for Java) auto-generate the
@@ -3151,13 +3198,6 @@ module Aws::Athena
3151
3198
  # Stops a query execution. Requires you to have access to the workgroup
3152
3199
  # in which the query ran.
3153
3200
  #
3154
- # For code samples using the Amazon Web Services SDK for Java, see
3155
- # [Examples and Code Samples][1] in the *Amazon Athena User Guide*.
3156
- #
3157
- #
3158
- #
3159
- # [1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
3160
- #
3161
3201
  # @option params [required, String] :query_execution_id
3162
3202
  # The unique ID of the query execution to stop.
3163
3203
  #
@@ -3587,6 +3627,11 @@ module Aws::Athena
3587
3627
  # kms_key: "KmsKey", # required
3588
3628
  # },
3589
3629
  # enable_minimum_encryption_configuration: false,
3630
+ # query_results_s3_access_grants_configuration: {
3631
+ # enable_s3_access_grants: false, # required
3632
+ # create_user_level_prefix: false,
3633
+ # authentication_type: "DIRECTORY_IDENTITY", # required, accepts DIRECTORY_IDENTITY
3634
+ # },
3590
3635
  # },
3591
3636
  # state: "ENABLED", # accepts ENABLED, DISABLED
3592
3637
  # })
@@ -3613,7 +3658,7 @@ module Aws::Athena
3613
3658
  params: params,
3614
3659
  config: config)
3615
3660
  context[:gem_name] = 'aws-sdk-athena'
3616
- context[:gem_version] = '1.74.0'
3661
+ context[:gem_version] = '1.80.0'
3617
3662
  Seahorse::Client::Request.new(handlers, context)
3618
3663
  end
3619
3664
 
@@ -21,6 +21,7 @@ module Aws::Athena
21
21
  ApplicationDPUSizesList = Shapes::ListShape.new(name: 'ApplicationDPUSizesList')
22
22
  AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
23
23
  AuthToken = Shapes::StringShape.new(name: 'AuthToken')
24
+ AuthenticationType = Shapes::StringShape.new(name: 'AuthenticationType')
24
25
  AwsAccountId = Shapes::StringShape.new(name: 'AwsAccountId')
25
26
  BatchGetNamedQueryInput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryInput')
26
27
  BatchGetNamedQueryOutput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryOutput')
@@ -154,6 +155,9 @@ module Aws::Athena
154
155
  GetWorkGroupInput = Shapes::StructureShape.new(name: 'GetWorkGroupInput')
155
156
  GetWorkGroupOutput = Shapes::StructureShape.new(name: 'GetWorkGroupOutput')
156
157
  IdempotencyToken = Shapes::StringShape.new(name: 'IdempotencyToken')
158
+ IdentityCenterApplicationArn = Shapes::StringShape.new(name: 'IdentityCenterApplicationArn')
159
+ IdentityCenterConfiguration = Shapes::StructureShape.new(name: 'IdentityCenterConfiguration')
160
+ IdentityCenterInstanceArn = Shapes::StringShape.new(name: 'IdentityCenterInstanceArn')
157
161
  ImportNotebookInput = Shapes::StructureShape.new(name: 'ImportNotebookInput')
158
162
  ImportNotebookOutput = Shapes::StructureShape.new(name: 'ImportNotebookOutput')
159
163
  Integer = Shapes::IntegerShape.new(name: 'Integer')
@@ -243,6 +247,7 @@ module Aws::Athena
243
247
  QueryExecutionState = Shapes::StringShape.new(name: 'QueryExecutionState')
244
248
  QueryExecutionStatistics = Shapes::StructureShape.new(name: 'QueryExecutionStatistics')
245
249
  QueryExecutionStatus = Shapes::StructureShape.new(name: 'QueryExecutionStatus')
250
+ QueryResultsS3AccessGrantsConfiguration = Shapes::StructureShape.new(name: 'QueryResultsS3AccessGrantsConfiguration')
246
251
  QueryRuntimeStatistics = Shapes::StructureShape.new(name: 'QueryRuntimeStatistics')
247
252
  QueryRuntimeStatisticsRows = Shapes::StructureShape.new(name: 'QueryRuntimeStatisticsRows')
248
253
  QueryRuntimeStatisticsTimeline = Shapes::StructureShape.new(name: 'QueryRuntimeStatisticsTimeline')
@@ -650,6 +655,7 @@ module Aws::Athena
650
655
  GetCapacityReservationOutput.struct_class = Types::GetCapacityReservationOutput
651
656
 
652
657
  GetDataCatalogInput.add_member(:name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "Name"))
658
+ GetDataCatalogInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
653
659
  GetDataCatalogInput.struct_class = Types::GetDataCatalogInput
654
660
 
655
661
  GetDataCatalogOutput.add_member(:data_catalog, Shapes::ShapeRef.new(shape: DataCatalog, location_name: "DataCatalog"))
@@ -657,6 +663,7 @@ module Aws::Athena
657
663
 
658
664
  GetDatabaseInput.add_member(:catalog_name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "CatalogName"))
659
665
  GetDatabaseInput.add_member(:database_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "DatabaseName"))
666
+ GetDatabaseInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
660
667
  GetDatabaseInput.struct_class = Types::GetDatabaseInput
661
668
 
662
669
  GetDatabaseOutput.add_member(:database, Shapes::ShapeRef.new(shape: Database, location_name: "Database"))
@@ -727,6 +734,7 @@ module Aws::Athena
727
734
  GetTableMetadataInput.add_member(:catalog_name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "CatalogName"))
728
735
  GetTableMetadataInput.add_member(:database_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "DatabaseName"))
729
736
  GetTableMetadataInput.add_member(:table_name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "TableName"))
737
+ GetTableMetadataInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
730
738
  GetTableMetadataInput.struct_class = Types::GetTableMetadataInput
731
739
 
732
740
  GetTableMetadataOutput.add_member(:table_metadata, Shapes::ShapeRef.new(shape: TableMetadata, location_name: "TableMetadata"))
@@ -738,10 +746,15 @@ module Aws::Athena
738
746
  GetWorkGroupOutput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroup, location_name: "WorkGroup"))
739
747
  GetWorkGroupOutput.struct_class = Types::GetWorkGroupOutput
740
748
 
749
+ IdentityCenterConfiguration.add_member(:enable_identity_center, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnableIdentityCenter"))
750
+ IdentityCenterConfiguration.add_member(:identity_center_instance_arn, Shapes::ShapeRef.new(shape: IdentityCenterInstanceArn, location_name: "IdentityCenterInstanceArn"))
751
+ IdentityCenterConfiguration.struct_class = Types::IdentityCenterConfiguration
752
+
741
753
  ImportNotebookInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, required: true, location_name: "WorkGroup"))
742
754
  ImportNotebookInput.add_member(:name, Shapes::ShapeRef.new(shape: NotebookName, required: true, location_name: "Name"))
743
- ImportNotebookInput.add_member(:payload, Shapes::ShapeRef.new(shape: Payload, required: true, location_name: "Payload"))
755
+ ImportNotebookInput.add_member(:payload, Shapes::ShapeRef.new(shape: Payload, location_name: "Payload"))
744
756
  ImportNotebookInput.add_member(:type, Shapes::ShapeRef.new(shape: NotebookType, required: true, location_name: "Type"))
757
+ ImportNotebookInput.add_member(:notebook_s3_location_uri, Shapes::ShapeRef.new(shape: S3Uri, location_name: "NotebookS3LocationUri"))
745
758
  ImportNotebookInput.add_member(:client_request_token, Shapes::ShapeRef.new(shape: ClientRequestToken, location_name: "ClientRequestToken"))
746
759
  ImportNotebookInput.struct_class = Types::ImportNotebookInput
747
760
 
@@ -783,6 +796,7 @@ module Aws::Athena
783
796
 
784
797
  ListDataCatalogsInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
785
798
  ListDataCatalogsInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxDataCatalogsCount, location_name: "MaxResults"))
799
+ ListDataCatalogsInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
786
800
  ListDataCatalogsInput.struct_class = Types::ListDataCatalogsInput
787
801
 
788
802
  ListDataCatalogsOutput.add_member(:data_catalogs_summary, Shapes::ShapeRef.new(shape: DataCatalogSummaryList, location_name: "DataCatalogsSummary"))
@@ -792,6 +806,7 @@ module Aws::Athena
792
806
  ListDatabasesInput.add_member(:catalog_name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "CatalogName"))
793
807
  ListDatabasesInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
794
808
  ListDatabasesInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxDatabasesCount, location_name: "MaxResults"))
809
+ ListDatabasesInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
795
810
  ListDatabasesInput.struct_class = Types::ListDatabasesInput
796
811
 
797
812
  ListDatabasesOutput.add_member(:database_list, Shapes::ShapeRef.new(shape: DatabaseList, location_name: "DatabaseList"))
@@ -878,6 +893,7 @@ module Aws::Athena
878
893
  ListTableMetadataInput.add_member(:expression, Shapes::ShapeRef.new(shape: ExpressionString, location_name: "Expression"))
879
894
  ListTableMetadataInput.add_member(:next_token, Shapes::ShapeRef.new(shape: Token, location_name: "NextToken"))
880
895
  ListTableMetadataInput.add_member(:max_results, Shapes::ShapeRef.new(shape: MaxTableMetadataCount, location_name: "MaxResults"))
896
+ ListTableMetadataInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, location_name: "WorkGroup"))
881
897
  ListTableMetadataInput.struct_class = Types::ListTableMetadataInput
882
898
 
883
899
  ListTableMetadataOutput.add_member(:table_metadata_list, Shapes::ShapeRef.new(shape: TableMetadataList, location_name: "TableMetadataList"))
@@ -970,6 +986,7 @@ module Aws::Athena
970
986
  QueryExecution.add_member(:engine_version, Shapes::ShapeRef.new(shape: EngineVersion, location_name: "EngineVersion"))
971
987
  QueryExecution.add_member(:execution_parameters, Shapes::ShapeRef.new(shape: ExecutionParameters, location_name: "ExecutionParameters"))
972
988
  QueryExecution.add_member(:substatement_type, Shapes::ShapeRef.new(shape: String, location_name: "SubstatementType"))
989
+ QueryExecution.add_member(:query_results_s3_access_grants_configuration, Shapes::ShapeRef.new(shape: QueryResultsS3AccessGrantsConfiguration, location_name: "QueryResultsS3AccessGrantsConfiguration"))
973
990
  QueryExecution.struct_class = Types::QueryExecution
974
991
 
975
992
  QueryExecutionContext.add_member(:database, Shapes::ShapeRef.new(shape: DatabaseString, location_name: "Database"))
@@ -985,6 +1002,7 @@ module Aws::Athena
985
1002
  QueryExecutionStatistics.add_member(:data_manifest_location, Shapes::ShapeRef.new(shape: String, location_name: "DataManifestLocation"))
986
1003
  QueryExecutionStatistics.add_member(:total_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "TotalExecutionTimeInMillis"))
987
1004
  QueryExecutionStatistics.add_member(:query_queue_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryQueueTimeInMillis"))
1005
+ QueryExecutionStatistics.add_member(:service_pre_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServicePreProcessingTimeInMillis"))
988
1006
  QueryExecutionStatistics.add_member(:query_planning_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryPlanningTimeInMillis"))
989
1007
  QueryExecutionStatistics.add_member(:service_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServiceProcessingTimeInMillis"))
990
1008
  QueryExecutionStatistics.add_member(:result_reuse_information, Shapes::ShapeRef.new(shape: ResultReuseInformation, location_name: "ResultReuseInformation"))
@@ -997,6 +1015,11 @@ module Aws::Athena
997
1015
  QueryExecutionStatus.add_member(:athena_error, Shapes::ShapeRef.new(shape: AthenaError, location_name: "AthenaError"))
998
1016
  QueryExecutionStatus.struct_class = Types::QueryExecutionStatus
999
1017
 
1018
+ QueryResultsS3AccessGrantsConfiguration.add_member(:enable_s3_access_grants, Shapes::ShapeRef.new(shape: BoxedBoolean, required: true, location_name: "EnableS3AccessGrants"))
1019
+ QueryResultsS3AccessGrantsConfiguration.add_member(:create_user_level_prefix, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "CreateUserLevelPrefix"))
1020
+ QueryResultsS3AccessGrantsConfiguration.add_member(:authentication_type, Shapes::ShapeRef.new(shape: AuthenticationType, required: true, location_name: "AuthenticationType"))
1021
+ QueryResultsS3AccessGrantsConfiguration.struct_class = Types::QueryResultsS3AccessGrantsConfiguration
1022
+
1000
1023
  QueryRuntimeStatistics.add_member(:timeline, Shapes::ShapeRef.new(shape: QueryRuntimeStatisticsTimeline, location_name: "Timeline"))
1001
1024
  QueryRuntimeStatistics.add_member(:rows, Shapes::ShapeRef.new(shape: QueryRuntimeStatisticsRows, location_name: "Rows"))
1002
1025
  QueryRuntimeStatistics.add_member(:output_stage, Shapes::ShapeRef.new(shape: QueryStage, location_name: "OutputStage"))
@@ -1009,6 +1032,7 @@ module Aws::Athena
1009
1032
  QueryRuntimeStatisticsRows.struct_class = Types::QueryRuntimeStatisticsRows
1010
1033
 
1011
1034
  QueryRuntimeStatisticsTimeline.add_member(:query_queue_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryQueueTimeInMillis"))
1035
+ QueryRuntimeStatisticsTimeline.add_member(:service_pre_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServicePreProcessingTimeInMillis"))
1012
1036
  QueryRuntimeStatisticsTimeline.add_member(:query_planning_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryPlanningTimeInMillis"))
1013
1037
  QueryRuntimeStatisticsTimeline.add_member(:engine_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "EngineExecutionTimeInMillis"))
1014
1038
  QueryRuntimeStatisticsTimeline.add_member(:service_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServiceProcessingTimeInMillis"))
@@ -1278,6 +1302,7 @@ module Aws::Athena
1278
1302
  WorkGroup.add_member(:configuration, Shapes::ShapeRef.new(shape: WorkGroupConfiguration, location_name: "Configuration"))
1279
1303
  WorkGroup.add_member(:description, Shapes::ShapeRef.new(shape: WorkGroupDescriptionString, location_name: "Description"))
1280
1304
  WorkGroup.add_member(:creation_time, Shapes::ShapeRef.new(shape: Date, location_name: "CreationTime"))
1305
+ WorkGroup.add_member(:identity_center_application_arn, Shapes::ShapeRef.new(shape: IdentityCenterApplicationArn, location_name: "IdentityCenterApplicationArn"))
1281
1306
  WorkGroup.struct_class = Types::WorkGroup
1282
1307
 
1283
1308
  WorkGroupConfiguration.add_member(:result_configuration, Shapes::ShapeRef.new(shape: ResultConfiguration, location_name: "ResultConfiguration"))
@@ -1290,6 +1315,8 @@ module Aws::Athena
1290
1315
  WorkGroupConfiguration.add_member(:execution_role, Shapes::ShapeRef.new(shape: RoleArn, location_name: "ExecutionRole"))
1291
1316
  WorkGroupConfiguration.add_member(:customer_content_encryption_configuration, Shapes::ShapeRef.new(shape: CustomerContentEncryptionConfiguration, location_name: "CustomerContentEncryptionConfiguration"))
1292
1317
  WorkGroupConfiguration.add_member(:enable_minimum_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnableMinimumEncryptionConfiguration"))
1318
+ WorkGroupConfiguration.add_member(:identity_center_configuration, Shapes::ShapeRef.new(shape: IdentityCenterConfiguration, location_name: "IdentityCenterConfiguration"))
1319
+ WorkGroupConfiguration.add_member(:query_results_s3_access_grants_configuration, Shapes::ShapeRef.new(shape: QueryResultsS3AccessGrantsConfiguration, location_name: "QueryResultsS3AccessGrantsConfiguration"))
1293
1320
  WorkGroupConfiguration.struct_class = Types::WorkGroupConfiguration
1294
1321
 
1295
1322
  WorkGroupConfigurationUpdates.add_member(:enforce_work_group_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnforceWorkGroupConfiguration"))
@@ -1304,6 +1331,7 @@ module Aws::Athena
1304
1331
  WorkGroupConfigurationUpdates.add_member(:execution_role, Shapes::ShapeRef.new(shape: RoleArn, location_name: "ExecutionRole"))
1305
1332
  WorkGroupConfigurationUpdates.add_member(:customer_content_encryption_configuration, Shapes::ShapeRef.new(shape: CustomerContentEncryptionConfiguration, location_name: "CustomerContentEncryptionConfiguration"))
1306
1333
  WorkGroupConfigurationUpdates.add_member(:enable_minimum_encryption_configuration, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "EnableMinimumEncryptionConfiguration"))
1334
+ WorkGroupConfigurationUpdates.add_member(:query_results_s3_access_grants_configuration, Shapes::ShapeRef.new(shape: QueryResultsS3AccessGrantsConfiguration, location_name: "QueryResultsS3AccessGrantsConfiguration"))
1307
1335
  WorkGroupConfigurationUpdates.struct_class = Types::WorkGroupConfigurationUpdates
1308
1336
 
1309
1337
  WorkGroupNamesList.member = Shapes::ShapeRef.new(shape: WorkGroupName)
@@ -1313,6 +1341,7 @@ module Aws::Athena
1313
1341
  WorkGroupSummary.add_member(:description, Shapes::ShapeRef.new(shape: WorkGroupDescriptionString, location_name: "Description"))
1314
1342
  WorkGroupSummary.add_member(:creation_time, Shapes::ShapeRef.new(shape: Date, location_name: "CreationTime"))
1315
1343
  WorkGroupSummary.add_member(:engine_version, Shapes::ShapeRef.new(shape: EngineVersion, location_name: "EngineVersion"))
1344
+ WorkGroupSummary.add_member(:identity_center_application_arn, Shapes::ShapeRef.new(shape: IdentityCenterApplicationArn, location_name: "IdentityCenterApplicationArn"))
1316
1345
  WorkGroupSummary.struct_class = Types::WorkGroupSummary
1317
1346
 
1318
1347
  WorkGroupsList.member = Shapes::ShapeRef.new(shape: WorkGroupSummary)
@@ -32,7 +32,7 @@ module Aws::Athena
32
32
  raise ArgumentError, "FIPS and DualStack are enabled, but this partition does not support one or both"
33
33
  end
34
34
  if Aws::Endpoints::Matchers.boolean_equals?(use_fips, true)
35
- if Aws::Endpoints::Matchers.boolean_equals?(true, Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"))
35
+ if Aws::Endpoints::Matchers.boolean_equals?(Aws::Endpoints::Matchers.attr(partition_result, "supportsFIPS"), true)
36
36
  return Aws::Endpoints::Endpoint.new(url: "https://athena-fips.#{region}.#{partition_result['dnsSuffix']}", headers: {}, properties: {})
37
37
  end
38
38
  raise ArgumentError, "FIPS is enabled but this partition does not support FIPS"
@@ -25,16 +25,17 @@ module Aws::Athena
25
25
  # @api private
26
26
  class Handler < Seahorse::Client::Handler
27
27
  def call(context)
28
- # If endpoint was discovered, do not resolve or apply the endpoint.
29
28
  unless context[:discovered_endpoint]
30
29
  params = parameters_for_operation(context)
31
30
  endpoint = context.config.endpoint_provider.resolve_endpoint(params)
32
31
 
33
32
  context.http_request.endpoint = endpoint.url
34
33
  apply_endpoint_headers(context, endpoint.headers)
34
+
35
+ context[:endpoint_params] = params
36
+ context[:endpoint_properties] = endpoint.properties
35
37
  end
36
38
 
37
- context[:endpoint_params] = params
38
39
  context[:auth_scheme] =
39
40
  Aws::Endpoints.resolve_auth_scheme(context, endpoint)
40
41
 
@@ -541,7 +541,7 @@ module Aws::Athena
541
541
  # @return [Integer]
542
542
  #
543
543
  # @!attribute [rw] nullable
544
- # Indicates the column's nullable status.
544
+ # Unsupported constraint. This value always shows as `UNKNOWN`.
545
545
  # @return [String]
546
546
  #
547
547
  # @!attribute [rw] case_sensitive
@@ -646,12 +646,7 @@ module Aws::Athena
646
646
  # `AwsDataCatalog` that already exists in your account, of which
647
647
  # you can have only one and cannot modify.
648
648
  #
649
- # * Queries that specify a Glue Data Catalog other than the default
650
- # `AwsDataCatalog` must be run on Athena engine version 2.
651
- #
652
- # * In Regions where Athena engine version 2 is not available,
653
- # creating new Glue data catalogs results in an `INVALID_INPUT`
654
- # error.
649
+ # ^
655
650
  # @return [Hash<String,String>]
656
651
  #
657
652
  # @!attribute [rw] tags
@@ -888,12 +883,14 @@ module Aws::Athena
888
883
  #
889
884
  class CreateWorkGroupOutput < Aws::EmptyStructure; end
890
885
 
891
- # Specifies the KMS key that is used to encrypt the user's data stores
892
- # in Athena. This setting does not apply to Athena SQL workgroups.
886
+ # Specifies the customer managed KMS key that is used to encrypt the
887
+ # user's data stores in Athena. When an Amazon Web Services managed key
888
+ # is used, this value is null. This setting does not apply to Athena SQL
889
+ # workgroups.
893
890
  #
894
891
  # @!attribute [rw] kms_key
895
- # The KMS key that is used to encrypt the user's data stores in
896
- # Athena.
892
+ # The customer managed KMS key that is used to encrypt the user's
893
+ # data stores in Athena.
897
894
  # @return [String]
898
895
  #
899
896
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CustomerContentEncryptionConfiguration AWS API Documentation
@@ -966,8 +963,7 @@ module Aws::Athena
966
963
  # `AwsDataCatalog` that already exists in your account, of which
967
964
  # you can have only one and cannot modify.
968
965
  #
969
- # * Queries that specify a Glue Data Catalog other than the default
970
- # `AwsDataCatalog` must be run on Athena engine version 2.
966
+ # ^
971
967
  # @return [Hash<String,String>]
972
968
  #
973
969
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DataCatalog AWS API Documentation
@@ -1520,10 +1516,16 @@ module Aws::Athena
1520
1516
  # The name of the data catalog to return.
1521
1517
  # @return [String]
1522
1518
  #
1519
+ # @!attribute [rw] work_group
1520
+ # The name of the workgroup. Required if making an IAM Identity Center
1521
+ # request.
1522
+ # @return [String]
1523
+ #
1523
1524
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetDataCatalogInput AWS API Documentation
1524
1525
  #
1525
1526
  class GetDataCatalogInput < Struct.new(
1526
- :name)
1527
+ :name,
1528
+ :work_group)
1527
1529
  SENSITIVE = []
1528
1530
  include Aws::Structure
1529
1531
  end
@@ -1548,11 +1550,18 @@ module Aws::Athena
1548
1550
  # The name of the database to return.
1549
1551
  # @return [String]
1550
1552
  #
1553
+ # @!attribute [rw] work_group
1554
+ # The name of the workgroup for which the metadata is being fetched.
1555
+ # Required if requesting an IAM Identity Center enabled Glue Data
1556
+ # Catalog.
1557
+ # @return [String]
1558
+ #
1551
1559
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetDatabaseInput AWS API Documentation
1552
1560
  #
1553
1561
  class GetDatabaseInput < Struct.new(
1554
1562
  :catalog_name,
1555
- :database_name)
1563
+ :database_name,
1564
+ :work_group)
1556
1565
  SENSITIVE = []
1557
1566
  include Aws::Structure
1558
1567
  end
@@ -1854,12 +1863,19 @@ module Aws::Athena
1854
1863
  # The name of the table for which metadata is returned.
1855
1864
  # @return [String]
1856
1865
  #
1866
+ # @!attribute [rw] work_group
1867
+ # The name of the workgroup for which the metadata is being fetched.
1868
+ # Required if requesting an IAM Identity Center enabled Glue Data
1869
+ # Catalog.
1870
+ # @return [String]
1871
+ #
1857
1872
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetTableMetadataInput AWS API Documentation
1858
1873
  #
1859
1874
  class GetTableMetadataInput < Struct.new(
1860
1875
  :catalog_name,
1861
1876
  :database_name,
1862
- :table_name)
1877
+ :table_name,
1878
+ :work_group)
1863
1879
  SENSITIVE = []
1864
1880
  include Aws::Structure
1865
1881
  end
@@ -1900,6 +1916,26 @@ module Aws::Athena
1900
1916
  include Aws::Structure
1901
1917
  end
1902
1918
 
1919
+ # Specifies whether the workgroup is IAM Identity Center supported.
1920
+ #
1921
+ # @!attribute [rw] enable_identity_center
1922
+ # Specifies whether the workgroup is IAM Identity Center supported.
1923
+ # @return [Boolean]
1924
+ #
1925
+ # @!attribute [rw] identity_center_instance_arn
1926
+ # The IAM Identity Center instance ARN that the workgroup associates
1927
+ # to.
1928
+ # @return [String]
1929
+ #
1930
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/IdentityCenterConfiguration AWS API Documentation
1931
+ #
1932
+ class IdentityCenterConfiguration < Struct.new(
1933
+ :enable_identity_center,
1934
+ :identity_center_instance_arn)
1935
+ SENSITIVE = []
1936
+ include Aws::Structure
1937
+ end
1938
+
1903
1939
  # @!attribute [rw] work_group
1904
1940
  # The name of the Spark enabled workgroup to import the notebook to.
1905
1941
  # @return [String]
@@ -1909,7 +1945,8 @@ module Aws::Athena
1909
1945
  # @return [String]
1910
1946
  #
1911
1947
  # @!attribute [rw] payload
1912
- # The notebook content to be imported.
1948
+ # The notebook content to be imported. The payload must be in `ipynb`
1949
+ # format.
1913
1950
  # @return [String]
1914
1951
  #
1915
1952
  # @!attribute [rw] type
@@ -1917,6 +1954,11 @@ module Aws::Athena
1917
1954
  # `IPYNB`.
1918
1955
  # @return [String]
1919
1956
  #
1957
+ # @!attribute [rw] notebook_s3_location_uri
1958
+ # A URI that specifies the Amazon S3 location of a notebook file in
1959
+ # `ipynb` format.
1960
+ # @return [String]
1961
+ #
1920
1962
  # @!attribute [rw] client_request_token
1921
1963
  # A unique case-sensitive string used to ensure the request to import
1922
1964
  # the notebook is idempotent (executes only once).
@@ -1935,6 +1977,7 @@ module Aws::Athena
1935
1977
  :name,
1936
1978
  :payload,
1937
1979
  :type,
1980
+ :notebook_s3_location_uri,
1938
1981
  :client_request_token)
1939
1982
  SENSITIVE = []
1940
1983
  include Aws::Structure
@@ -2143,11 +2186,17 @@ module Aws::Athena
2143
2186
  # Specifies the maximum number of data catalogs to return.
2144
2187
  # @return [Integer]
2145
2188
  #
2189
+ # @!attribute [rw] work_group
2190
+ # The name of the workgroup. Required if making an IAM Identity Center
2191
+ # request.
2192
+ # @return [String]
2193
+ #
2146
2194
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListDataCatalogsInput AWS API Documentation
2147
2195
  #
2148
2196
  class ListDataCatalogsInput < Struct.new(
2149
2197
  :next_token,
2150
- :max_results)
2198
+ :max_results,
2199
+ :work_group)
2151
2200
  SENSITIVE = []
2152
2201
  include Aws::Structure
2153
2202
  end
@@ -2187,12 +2236,19 @@ module Aws::Athena
2187
2236
  # Specifies the maximum number of results to return.
2188
2237
  # @return [Integer]
2189
2238
  #
2239
+ # @!attribute [rw] work_group
2240
+ # The name of the workgroup for which the metadata is being fetched.
2241
+ # Required if requesting an IAM Identity Center enabled Glue Data
2242
+ # Catalog.
2243
+ # @return [String]
2244
+ #
2190
2245
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListDatabasesInput AWS API Documentation
2191
2246
  #
2192
2247
  class ListDatabasesInput < Struct.new(
2193
2248
  :catalog_name,
2194
2249
  :next_token,
2195
- :max_results)
2250
+ :max_results,
2251
+ :work_group)
2196
2252
  SENSITIVE = []
2197
2253
  include Aws::Structure
2198
2254
  end
@@ -2652,6 +2708,12 @@ module Aws::Athena
2652
2708
  # Specifies the maximum number of results to return.
2653
2709
  # @return [Integer]
2654
2710
  #
2711
+ # @!attribute [rw] work_group
2712
+ # The name of the workgroup for which the metadata is being fetched.
2713
+ # Required if requesting an IAM Identity Center enabled Glue Data
2714
+ # Catalog.
2715
+ # @return [String]
2716
+ #
2655
2717
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListTableMetadataInput AWS API Documentation
2656
2718
  #
2657
2719
  class ListTableMetadataInput < Struct.new(
@@ -2659,7 +2721,8 @@ module Aws::Athena
2659
2721
  :database_name,
2660
2722
  :expression,
2661
2723
  :next_token,
2662
- :max_results)
2724
+ :max_results,
2725
+ :work_group)
2663
2726
  SENSITIVE = []
2664
2727
  include Aws::Structure
2665
2728
  end
@@ -3026,6 +3089,11 @@ module Aws::Athena
3026
3089
  # The kind of query statement that was run.
3027
3090
  # @return [String]
3028
3091
  #
3092
+ # @!attribute [rw] query_results_s3_access_grants_configuration
3093
+ # Specifies whether Amazon S3 access grants are enabled for query
3094
+ # results.
3095
+ # @return [Types::QueryResultsS3AccessGrantsConfiguration]
3096
+ #
3029
3097
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecution AWS API Documentation
3030
3098
  #
3031
3099
  class QueryExecution < Struct.new(
@@ -3040,7 +3108,8 @@ module Aws::Athena
3040
3108
  :work_group,
3041
3109
  :engine_version,
3042
3110
  :execution_parameters,
3043
- :substatement_type)
3111
+ :substatement_type,
3112
+ :query_results_s3_access_grants_configuration)
3044
3113
  SENSITIVE = []
3045
3114
  include Aws::Structure
3046
3115
  end
@@ -3103,6 +3172,11 @@ module Aws::Athena
3103
3172
  # might automatically add the query back to the queue.
3104
3173
  # @return [Integer]
3105
3174
  #
3175
+ # @!attribute [rw] service_pre_processing_time_in_millis
3176
+ # The number of milliseconds that Athena took to preprocess the query
3177
+ # before submitting the query to the query engine.
3178
+ # @return [Integer]
3179
+ #
3106
3180
  # @!attribute [rw] query_planning_time_in_millis
3107
3181
  # The number of milliseconds that Athena took to plan the query
3108
3182
  # processing flow. This includes the time spent retrieving table
@@ -3129,6 +3203,7 @@ module Aws::Athena
3129
3203
  :data_manifest_location,
3130
3204
  :total_execution_time_in_millis,
3131
3205
  :query_queue_time_in_millis,
3206
+ :service_pre_processing_time_in_millis,
3132
3207
  :query_planning_time_in_millis,
3133
3208
  :service_processing_time_in_millis,
3134
3209
  :result_reuse_information)
@@ -3183,6 +3258,34 @@ module Aws::Athena
3183
3258
  include Aws::Structure
3184
3259
  end
3185
3260
 
3261
+ # Specifies whether Amazon S3 access grants are enabled for query
3262
+ # results.
3263
+ #
3264
+ # @!attribute [rw] enable_s3_access_grants
3265
+ # Specifies whether Amazon S3 access grants are enabled for query
3266
+ # results.
3267
+ # @return [Boolean]
3268
+ #
3269
+ # @!attribute [rw] create_user_level_prefix
3270
+ # When enabled, appends the user ID as an Amazon S3 path prefix to the
3271
+ # query result output location.
3272
+ # @return [Boolean]
3273
+ #
3274
+ # @!attribute [rw] authentication_type
3275
+ # The authentication type used for Amazon S3 access grants. Currently,
3276
+ # only `DIRECTORY_IDENTITY` is supported.
3277
+ # @return [String]
3278
+ #
3279
+ # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryResultsS3AccessGrantsConfiguration AWS API Documentation
3280
+ #
3281
+ class QueryResultsS3AccessGrantsConfiguration < Struct.new(
3282
+ :enable_s3_access_grants,
3283
+ :create_user_level_prefix,
3284
+ :authentication_type)
3285
+ SENSITIVE = []
3286
+ include Aws::Structure
3287
+ end
3288
+
3186
3289
  # The query execution timeline, statistics on input and output rows and
3187
3290
  # bytes, and the different query stages that form the query execution
3188
3291
  # plan.
@@ -3254,6 +3357,11 @@ module Aws::Athena
3254
3357
  # might automatically add the query back to the queue.
3255
3358
  # @return [Integer]
3256
3359
  #
3360
+ # @!attribute [rw] service_pre_processing_time_in_millis
3361
+ # The number of milliseconds that Athena spends on preprocessing
3362
+ # before it submits the query to the engine.
3363
+ # @return [Integer]
3364
+ #
3257
3365
  # @!attribute [rw] query_planning_time_in_millis
3258
3366
  # The number of milliseconds that Athena took to plan the query
3259
3367
  # processing flow. This includes the time spent retrieving table
@@ -3279,6 +3387,7 @@ module Aws::Athena
3279
3387
  #
3280
3388
  class QueryRuntimeStatisticsTimeline < Struct.new(
3281
3389
  :query_queue_time_in_millis,
3390
+ :service_pre_processing_time_in_millis,
3282
3391
  :query_planning_time_in_millis,
3283
3392
  :engine_execution_time_in_millis,
3284
3393
  :service_processing_time_in_millis,
@@ -3728,7 +3837,10 @@ module Aws::Athena
3728
3837
  # Contains session configuration information.
3729
3838
  #
3730
3839
  # @!attribute [rw] execution_role
3731
- # The ARN of the execution role used for the session.
3840
+ # The ARN of the execution role used to access user resources for
3841
+ # Spark sessions and Identity Center enabled workgroups. This property
3842
+ # applies only to Spark enabled workgroups and Identity Center enabled
3843
+ # workgroups.
3732
3844
  # @return [String]
3733
3845
  #
3734
3846
  # @!attribute [rw] working_directory
@@ -3879,7 +3991,9 @@ module Aws::Athena
3879
3991
  # @return [Types::CalculationConfiguration]
3880
3992
  #
3881
3993
  # @!attribute [rw] code_block
3882
- # A string that contains the code of the calculation.
3994
+ # A string that contains the code of the calculation. Use this
3995
+ # parameter instead of CalculationConfiguration$CodeBlock, which is
3996
+ # deprecated.
3883
3997
  # @return [String]
3884
3998
  #
3885
3999
  # @!attribute [rw] client_request_token
@@ -3949,8 +4063,11 @@ module Aws::Athena
3949
4063
  # A unique case-sensitive string used to ensure the request to create
3950
4064
  # the query is idempotent (executes only once). If another
3951
4065
  # `StartQueryExecution` request is received, the same response is
3952
- # returned and another query is not created. If a parameter has
3953
- # changed, for example, the `QueryString`, an error is returned.
4066
+ # returned and another query is not created. An error is returned if a
4067
+ # parameter, such as `QueryString`, has changed. A call to
4068
+ # `StartQueryExecution` that uses a previous client request token
4069
+ # returns the same `QueryExecutionId` even if the requester doesn't
4070
+ # have permission on the tables specified in `QueryString`.
3954
4071
  #
3955
4072
  # This token is listed as not required because Amazon Web Services
3956
4073
  # SDKs (for example the Amazon Web Services SDK for Java)
@@ -4737,6 +4854,11 @@ module Aws::Athena
4737
4854
  # The date and time the workgroup was created.
4738
4855
  # @return [Time]
4739
4856
  #
4857
+ # @!attribute [rw] identity_center_application_arn
4858
+ # The ARN of the IAM Identity Center enabled application associated
4859
+ # with the workgroup.
4860
+ # @return [String]
4861
+ #
4740
4862
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroup AWS API Documentation
4741
4863
  #
4742
4864
  class WorkGroup < Struct.new(
@@ -4744,7 +4866,8 @@ module Aws::Athena
4744
4866
  :state,
4745
4867
  :configuration,
4746
4868
  :description,
4747
- :creation_time)
4869
+ :creation_time,
4870
+ :identity_center_application_arn)
4748
4871
  SENSITIVE = []
4749
4872
  include Aws::Structure
4750
4873
  end
@@ -4824,7 +4947,11 @@ module Aws::Athena
4824
4947
  # @return [String]
4825
4948
  #
4826
4949
  # @!attribute [rw] execution_role
4827
- # Role used in a session for accessing the user's resources.
4950
+ # The ARN of the execution role used to access user resources for
4951
+ # Spark sessions and IAM Identity Center enabled workgroups. This
4952
+ # property applies only to Spark enabled workgroups and IAM Identity
4953
+ # Center enabled workgroups. The property is required for IAM Identity
4954
+ # Center enabled workgroups.
4828
4955
  # @return [String]
4829
4956
  #
4830
4957
  # @!attribute [rw] customer_content_encryption_configuration
@@ -4846,6 +4973,15 @@ module Aws::Athena
4846
4973
  # workgroup configuration for encryption is used.
4847
4974
  # @return [Boolean]
4848
4975
  #
4976
+ # @!attribute [rw] identity_center_configuration
4977
+ # Specifies whether the workgroup is IAM Identity Center supported.
4978
+ # @return [Types::IdentityCenterConfiguration]
4979
+ #
4980
+ # @!attribute [rw] query_results_s3_access_grants_configuration
4981
+ # Specifies whether Amazon S3 access grants are enabled for query
4982
+ # results.
4983
+ # @return [Types::QueryResultsS3AccessGrantsConfiguration]
4984
+ #
4849
4985
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupConfiguration AWS API Documentation
4850
4986
  #
4851
4987
  class WorkGroupConfiguration < Struct.new(
@@ -4858,7 +4994,9 @@ module Aws::Athena
4858
4994
  :additional_configuration,
4859
4995
  :execution_role,
4860
4996
  :customer_content_encryption_configuration,
4861
- :enable_minimum_encryption_configuration)
4997
+ :enable_minimum_encryption_configuration,
4998
+ :identity_center_configuration,
4999
+ :query_results_s3_access_grants_configuration)
4862
5000
  SENSITIVE = []
4863
5001
  include Aws::Structure
4864
5002
  end
@@ -4936,13 +5074,17 @@ module Aws::Athena
4936
5074
  # @return [String]
4937
5075
  #
4938
5076
  # @!attribute [rw] execution_role
4939
- # Contains the ARN of the execution role for the workgroup
5077
+ # The ARN of the execution role used to access user resources for
5078
+ # Spark sessions and Identity Center enabled workgroups. This property
5079
+ # applies only to Spark enabled workgroups and Identity Center enabled
5080
+ # workgroups.
4940
5081
  # @return [String]
4941
5082
  #
4942
5083
  # @!attribute [rw] customer_content_encryption_configuration
4943
- # Specifies the KMS key that is used to encrypt the user's data
4944
- # stores in Athena. This setting does not apply to Athena SQL
4945
- # workgroups.
5084
+ # Specifies the customer managed KMS key that is used to encrypt the
5085
+ # user's data stores in Athena. When an Amazon Web Services managed
5086
+ # key is used, this value is null. This setting does not apply to
5087
+ # Athena SQL workgroups.
4946
5088
  # @return [Types::CustomerContentEncryptionConfiguration]
4947
5089
  #
4948
5090
  # @!attribute [rw] enable_minimum_encryption_configuration
@@ -4959,6 +5101,11 @@ module Aws::Athena
4959
5101
  # workgroup configuration for encryption is used.
4960
5102
  # @return [Boolean]
4961
5103
  #
5104
+ # @!attribute [rw] query_results_s3_access_grants_configuration
5105
+ # Specifies whether Amazon S3 access grants are enabled for query
5106
+ # results.
5107
+ # @return [Types::QueryResultsS3AccessGrantsConfiguration]
5108
+ #
4962
5109
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupConfigurationUpdates AWS API Documentation
4963
5110
  #
4964
5111
  class WorkGroupConfigurationUpdates < Struct.new(
@@ -4973,7 +5120,8 @@ module Aws::Athena
4973
5120
  :additional_configuration,
4974
5121
  :execution_role,
4975
5122
  :customer_content_encryption_configuration,
4976
- :enable_minimum_encryption_configuration)
5123
+ :enable_minimum_encryption_configuration,
5124
+ :query_results_s3_access_grants_configuration)
4977
5125
  SENSITIVE = []
4978
5126
  include Aws::Structure
4979
5127
  end
@@ -5003,6 +5151,11 @@ module Aws::Athena
5003
5151
  # preview engine regardless of this setting.
5004
5152
  # @return [Types::EngineVersion]
5005
5153
  #
5154
+ # @!attribute [rw] identity_center_application_arn
5155
+ # The ARN of the IAM Identity Center enabled application associated
5156
+ # with the workgroup.
5157
+ # @return [String]
5158
+ #
5006
5159
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/WorkGroupSummary AWS API Documentation
5007
5160
  #
5008
5161
  class WorkGroupSummary < Struct.new(
@@ -5010,7 +5163,8 @@ module Aws::Athena
5010
5163
  :state,
5011
5164
  :description,
5012
5165
  :creation_time,
5013
- :engine_version)
5166
+ :engine_version,
5167
+ :identity_center_application_arn)
5014
5168
  SENSITIVE = []
5015
5169
  include Aws::Structure
5016
5170
  end
@@ -52,6 +52,6 @@ require_relative 'aws-sdk-athena/customizations'
52
52
  # @!group service
53
53
  module Aws::Athena
54
54
 
55
- GEM_VERSION = '1.74.0'
55
+ GEM_VERSION = '1.80.0'
56
56
 
57
57
  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.74.0
4
+ version: 1.80.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
- autorequire:
8
+ autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-07-11 00:00:00.000000000 Z
11
+ date: 2024-01-19 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.177.0
22
+ version: 3.188.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.177.0
32
+ version: 3.188.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement
@@ -72,7 +72,7 @@ licenses:
72
72
  metadata:
73
73
  source_code_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-athena
74
74
  changelog_uri: https://github.com/aws/aws-sdk-ruby/tree/version-3/gems/aws-sdk-athena/CHANGELOG.md
75
- post_install_message:
75
+ post_install_message:
76
76
  rdoc_options: []
77
77
  require_paths:
78
78
  - lib
@@ -80,15 +80,15 @@ required_ruby_version: !ruby/object:Gem::Requirement
80
80
  requirements:
81
81
  - - ">="
82
82
  - !ruby/object:Gem::Version
83
- version: '2.3'
83
+ version: '2.5'
84
84
  required_rubygems_version: !ruby/object:Gem::Requirement
85
85
  requirements:
86
86
  - - ">="
87
87
  - !ruby/object:Gem::Version
88
88
  version: '0'
89
89
  requirements: []
90
- rubygems_version: 3.1.6
91
- signing_key:
90
+ rubygems_version: 3.4.10
91
+ signing_key:
92
92
  specification_version: 4
93
93
  summary: AWS SDK for Ruby - Amazon Athena
94
94
  test_files: []