aws-sdk-athena 1.74.0 → 1.80.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 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: []