aws-sdk-athena 1.75.0 → 1.76.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: 3c5ae3094e399b48d61a066182a18ef66f43ece43b56b168921bc2163fafc104
4
- data.tar.gz: 9a4a3a658902ce15e966c4c65992ea93b4ed18b316f813be2590869711af0cd3
3
+ metadata.gz: 67c7eb76b320311b399dfcb7949a035e27c15580538bcd630bc2cebd7439639e
4
+ data.tar.gz: d8db1a0a74a79539f447ce8c4df695ccbce83ae0b1fa1fa93d026857a6f87377
5
5
  SHA512:
6
- metadata.gz: c05da99ab3f10a96a216321c0ded6027689e1f9076b4f24e55f9667f3aa1f6ad6433a8bd67c995cd0878792ca89a05d7dcda8aa5fb23e6070967c9446efce38f
7
- data.tar.gz: c17caab0d7124ffbd9e8595c6a733e8418c28b921f6f1ac197056ef6dcbf019e057c2eb28cc54d3b8003d9da00641f66f31ebc1a2ce1576ac0bd92c97c06fb86
6
+ metadata.gz: 534f5565622f211649dfd025faf83739120bf478acb377612c484c062e635506491621d6ef699fc6ec2e2e2d07289dab3c2601d3161aaa9608a207002021b7d6
7
+ data.tar.gz: 2b03e413daec62322e60f5caf846562087f3b49a602233352ce0c4e7df04f564b93272614269140c35abad01aa8e3087b38edf70b2f28461ee16d3d683495e75
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.76.0 (2023-11-17)
5
+ ------------------
6
+
7
+ * Feature - Adding SerivicePreProcessing time metric
8
+
4
9
  1.75.0 (2023-09-27)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.75.0
1
+ 1.76.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
@@ -684,12 +685,7 @@ module Aws::Athena
684
685
  # `AwsDataCatalog` that already exists in your account, of which you
685
686
  # can have only one and cannot modify.
686
687
  #
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.
688
+ # ^
693
689
  #
694
690
  # @option params [Array<Types::Tag>] :tags
695
691
  # A list of comma separated tags to add to the data catalog that is
@@ -726,13 +722,6 @@ module Aws::Athena
726
722
  # Creates a named query in the specified workgroup. Requires that you
727
723
  # have access to the workgroup.
728
724
  #
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
725
  # @option params [required, String] :name
737
726
  # The query name.
738
727
  #
@@ -1041,13 +1030,6 @@ module Aws::Athena
1041
1030
  # Deletes the named query if you have access to the workgroup in which
1042
1031
  # the query was saved.
1043
1032
  #
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
1033
  # @option params [required, String] :named_query_id
1052
1034
  # The unique ID of the query to delete.
1053
1035
  #
@@ -1579,6 +1561,7 @@ module Aws::Athena
1579
1561
  # resp.query_execution.statistics.data_manifest_location #=> String
1580
1562
  # resp.query_execution.statistics.total_execution_time_in_millis #=> Integer
1581
1563
  # resp.query_execution.statistics.query_queue_time_in_millis #=> Integer
1564
+ # resp.query_execution.statistics.service_pre_processing_time_in_millis #=> Integer
1582
1565
  # resp.query_execution.statistics.query_planning_time_in_millis #=> Integer
1583
1566
  # resp.query_execution.statistics.service_processing_time_in_millis #=> Integer
1584
1567
  # resp.query_execution.statistics.result_reuse_information.reused_previous_result #=> Boolean
@@ -1699,6 +1682,7 @@ module Aws::Athena
1699
1682
  # @example Response structure
1700
1683
  #
1701
1684
  # resp.query_runtime_statistics.timeline.query_queue_time_in_millis #=> Integer
1685
+ # resp.query_runtime_statistics.timeline.service_pre_processing_time_in_millis #=> Integer
1702
1686
  # resp.query_runtime_statistics.timeline.query_planning_time_in_millis #=> Integer
1703
1687
  # resp.query_runtime_statistics.timeline.engine_execution_time_in_millis #=> Integer
1704
1688
  # resp.query_runtime_statistics.timeline.service_processing_time_in_millis #=> Integer
@@ -2350,13 +2334,6 @@ module Aws::Athena
2350
2334
  # workgroup. If a workgroup is not specified, lists the saved queries
2351
2335
  # for the primary workgroup.
2352
2336
  #
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
2337
  # @option params [String] :next_token
2361
2338
  # A token generated by the Athena service that specifies where to
2362
2339
  # continue pagination if a previous request was truncated. To obtain the
@@ -2546,16 +2523,10 @@ module Aws::Athena
2546
2523
  end
2547
2524
 
2548
2525
  # 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
2526
+ # the specified workgroup. Athena keeps a query history for 45 days. If
2527
+ # a workgroup is not specified, returns a list of query execution IDs
2528
+ # for the primary workgroup. Requires you to have access to the
2529
+ # workgroup in which the queries ran.
2559
2530
  #
2560
2531
  # @option params [String] :next_token
2561
2532
  # A token generated by the Athena service that specifies where to
@@ -2876,6 +2847,14 @@ module Aws::Athena
2876
2847
  # Submits calculations for execution within a session. You can supply
2877
2848
  # the code to run as an inline code block within the request.
2878
2849
  #
2850
+ # <note markdown="1"> The request syntax requires the
2851
+ # StartCalculationExecutionRequest$CodeBlock parameter or the
2852
+ # CalculationConfiguration$CodeBlock parameter, but not both. Because
2853
+ # CalculationConfiguration$CodeBlock is deprecated, use the
2854
+ # StartCalculationExecutionRequest$CodeBlock parameter instead.
2855
+ #
2856
+ # </note>
2857
+ #
2879
2858
  # @option params [required, String] :session_id
2880
2859
  # The session ID.
2881
2860
  #
@@ -2886,7 +2865,8 @@ module Aws::Athena
2886
2865
  # Contains configuration information for the calculation.
2887
2866
  #
2888
2867
  # @option params [String] :code_block
2889
- # A string that contains the code of the calculation.
2868
+ # A string that contains the code of the calculation. Use this parameter
2869
+ # instead of CalculationConfiguration$CodeBlock, which is deprecated.
2890
2870
  #
2891
2871
  # @option params [String] :client_request_token
2892
2872
  # A unique case-sensitive string used to ensure the request to create
@@ -3151,13 +3131,6 @@ module Aws::Athena
3151
3131
  # Stops a query execution. Requires you to have access to the workgroup
3152
3132
  # in which the query ran.
3153
3133
  #
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
3134
  # @option params [required, String] :query_execution_id
3162
3135
  # The unique ID of the query execution to stop.
3163
3136
  #
@@ -3613,7 +3586,7 @@ module Aws::Athena
3613
3586
  params: params,
3614
3587
  config: config)
3615
3588
  context[:gem_name] = 'aws-sdk-athena'
3616
- context[:gem_version] = '1.75.0'
3589
+ context[:gem_version] = '1.76.0'
3617
3590
  Seahorse::Client::Request.new(handlers, context)
3618
3591
  end
3619
3592
 
@@ -985,6 +985,7 @@ module Aws::Athena
985
985
  QueryExecutionStatistics.add_member(:data_manifest_location, Shapes::ShapeRef.new(shape: String, location_name: "DataManifestLocation"))
986
986
  QueryExecutionStatistics.add_member(:total_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "TotalExecutionTimeInMillis"))
987
987
  QueryExecutionStatistics.add_member(:query_queue_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryQueueTimeInMillis"))
988
+ QueryExecutionStatistics.add_member(:service_pre_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServicePreProcessingTimeInMillis"))
988
989
  QueryExecutionStatistics.add_member(:query_planning_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryPlanningTimeInMillis"))
989
990
  QueryExecutionStatistics.add_member(:service_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServiceProcessingTimeInMillis"))
990
991
  QueryExecutionStatistics.add_member(:result_reuse_information, Shapes::ShapeRef.new(shape: ResultReuseInformation, location_name: "ResultReuseInformation"))
@@ -1009,6 +1010,7 @@ module Aws::Athena
1009
1010
  QueryRuntimeStatisticsRows.struct_class = Types::QueryRuntimeStatisticsRows
1010
1011
 
1011
1012
  QueryRuntimeStatisticsTimeline.add_member(:query_queue_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryQueueTimeInMillis"))
1013
+ QueryRuntimeStatisticsTimeline.add_member(:service_pre_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServicePreProcessingTimeInMillis"))
1012
1014
  QueryRuntimeStatisticsTimeline.add_member(:query_planning_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "QueryPlanningTimeInMillis"))
1013
1015
  QueryRuntimeStatisticsTimeline.add_member(:engine_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "EngineExecutionTimeInMillis"))
1014
1016
  QueryRuntimeStatisticsTimeline.add_member(:service_processing_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "ServiceProcessingTimeInMillis"))
@@ -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"
@@ -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
@@ -3103,6 +3099,11 @@ module Aws::Athena
3103
3099
  # might automatically add the query back to the queue.
3104
3100
  # @return [Integer]
3105
3101
  #
3102
+ # @!attribute [rw] service_pre_processing_time_in_millis
3103
+ # The number of milliseconds that Athena took to preprocess the query
3104
+ # before submitting the query to the query engine.
3105
+ # @return [Integer]
3106
+ #
3106
3107
  # @!attribute [rw] query_planning_time_in_millis
3107
3108
  # The number of milliseconds that Athena took to plan the query
3108
3109
  # processing flow. This includes the time spent retrieving table
@@ -3129,6 +3130,7 @@ module Aws::Athena
3129
3130
  :data_manifest_location,
3130
3131
  :total_execution_time_in_millis,
3131
3132
  :query_queue_time_in_millis,
3133
+ :service_pre_processing_time_in_millis,
3132
3134
  :query_planning_time_in_millis,
3133
3135
  :service_processing_time_in_millis,
3134
3136
  :result_reuse_information)
@@ -3254,6 +3256,11 @@ module Aws::Athena
3254
3256
  # might automatically add the query back to the queue.
3255
3257
  # @return [Integer]
3256
3258
  #
3259
+ # @!attribute [rw] service_pre_processing_time_in_millis
3260
+ # The number of milliseconds that Athena spends on preprocessing
3261
+ # before it submits the query to the engine.
3262
+ # @return [Integer]
3263
+ #
3257
3264
  # @!attribute [rw] query_planning_time_in_millis
3258
3265
  # The number of milliseconds that Athena took to plan the query
3259
3266
  # processing flow. This includes the time spent retrieving table
@@ -3279,6 +3286,7 @@ module Aws::Athena
3279
3286
  #
3280
3287
  class QueryRuntimeStatisticsTimeline < Struct.new(
3281
3288
  :query_queue_time_in_millis,
3289
+ :service_pre_processing_time_in_millis,
3282
3290
  :query_planning_time_in_millis,
3283
3291
  :engine_execution_time_in_millis,
3284
3292
  :service_processing_time_in_millis,
@@ -3728,7 +3736,8 @@ module Aws::Athena
3728
3736
  # Contains session configuration information.
3729
3737
  #
3730
3738
  # @!attribute [rw] execution_role
3731
- # The ARN of the execution role used for the session.
3739
+ # The ARN of the execution role used in a Spark session to access user
3740
+ # resources. This property applies only to Spark-enabled workgroups.
3732
3741
  # @return [String]
3733
3742
  #
3734
3743
  # @!attribute [rw] working_directory
@@ -3879,7 +3888,9 @@ module Aws::Athena
3879
3888
  # @return [Types::CalculationConfiguration]
3880
3889
  #
3881
3890
  # @!attribute [rw] code_block
3882
- # A string that contains the code of the calculation.
3891
+ # A string that contains the code of the calculation. Use this
3892
+ # parameter instead of CalculationConfiguration$CodeBlock, which is
3893
+ # deprecated.
3883
3894
  # @return [String]
3884
3895
  #
3885
3896
  # @!attribute [rw] client_request_token
@@ -4824,7 +4835,8 @@ module Aws::Athena
4824
4835
  # @return [String]
4825
4836
  #
4826
4837
  # @!attribute [rw] execution_role
4827
- # Role used in a session for accessing the user's resources.
4838
+ # Role used in a Spark session for accessing the user's resources.
4839
+ # This property applies only to Spark-enabled workgroups.
4828
4840
  # @return [String]
4829
4841
  #
4830
4842
  # @!attribute [rw] customer_content_encryption_configuration
@@ -4936,13 +4948,15 @@ module Aws::Athena
4936
4948
  # @return [String]
4937
4949
  #
4938
4950
  # @!attribute [rw] execution_role
4939
- # Contains the ARN of the execution role for the workgroup
4951
+ # The ARN of the execution role used to access user resources. This
4952
+ # property applies only to Spark-enabled workgroups.
4940
4953
  # @return [String]
4941
4954
  #
4942
4955
  # @!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.
4956
+ # Specifies the customer managed KMS key that is used to encrypt the
4957
+ # user's data stores in Athena. When an Amazon Web Services managed
4958
+ # key is used, this value is null. This setting does not apply to
4959
+ # Athena SQL workgroups.
4946
4960
  # @return [Types::CustomerContentEncryptionConfiguration]
4947
4961
  #
4948
4962
  # @!attribute [rw] enable_minimum_encryption_configuration
@@ -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.75.0'
55
+ GEM_VERSION = '1.76.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.75.0
4
+ version: 1.76.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2023-09-27 00:00:00.000000000 Z
11
+ date: 2023-11-17 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core