aws-sdk-athena 1.42.0 → 1.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 8c732d1d48208faa9900253d87dbb4d751d2a63defe0486b2d9d4ff915c5b36c
-  data.tar.gz: ce4b64c50ba8244c0b2e680b9175a1a9848618ebd11b699641a59f432e61520b
+  metadata.gz: 8e4adc124ea67b6ebb0ed0fd885a083ef1f8f4fcadd40375a5fbb6363dc76974
+  data.tar.gz: bd8ae71072285c2de1a139cbd9197cc786ff442f2dbe146ac73a664dbd38cd42
 SHA512:
-  metadata.gz: 9e69613dfc1ae161456a79c85dc710285223f0b548fbacfaca8b0e1df4b7d829878b707fb2fab8fe3ee26bff665d68d0f2239be7aac797c6484f13ef729090ec
-  data.tar.gz: 077ad36a69088e2b830918690a8cb959bebcd9a90af5fceeefdf76aa9b9889b8a39357900748ebac616dc77b288b53ab56cc6e9285d11534daffe589ec4ff173
+  metadata.gz: 19d1695339895486b1b4448d1b52986c64dfbbc2a7e88f0189896987894ebc52873ac572bf16c64bbcdbd04dc491cb3d16a9d2553f72c96ccd67bdfe890f910b
+  data.tar.gz: cab239aad3e817d60d4f6f51527e0cb5c05c46ef62297a494824c229dd9864c9d584f5cfa0bac0f0812dd7890c2aaad9779545fbaa198d67a6250bb282749c26

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.46.0 (2022-01-28)
+------------------
+
+* Feature - This release adds a field, AthenaError, to the GetQueryExecution response object when a query fails.
+
+1.45.0 (2021-12-21)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.44.0 (2021-11-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.43.0 (2021-11-04)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.42.0 (2021-10-18)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.42.0
+1.46.0

data/lib/aws-sdk-athena/client.rb

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -73,6 +74,7 @@ module Aws::Athena
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -119,7 +121,9 @@ module Aws::Athena
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::Athena
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -285,6 +293,15 @@ module Aws::Athena
     #     ** Please note ** When response stubbing is enabled, no HTTP
     #     requests are made, and retries are disabled.
     #
+    #   @option options [Boolean] :use_dualstack_endpoint
+    #     When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
+    #     will be used if available.
+    #
+    #   @option options [Boolean] :use_fips_endpoint
+    #     When set to `true`, fips compatible endpoints will be used if available.
+    #     When a `fips` region is used, the region is normalized and this config
+    #     is set to `true`.
+    #
     #   @option options [Boolean] :validate_params (true)
     #     When `true`, request parameters are validated before
     #     sending the request.
@@ -296,7 +313,7 @@ module Aws::Athena
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -312,6 +329,9 @@ module Aws::Athena
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -422,6 +442,7 @@ module Aws::Athena
     #   resp.query_executions[0].status.state_change_reason #=> String
     #   resp.query_executions[0].status.submission_date_time #=> Time
     #   resp.query_executions[0].status.completion_date_time #=> Time
+    #   resp.query_executions[0].status.athena_error.error_category #=> Integer
     #   resp.query_executions[0].statistics.engine_execution_time_in_millis #=> Integer
     #   resp.query_executions[0].statistics.data_scanned_in_bytes #=> Integer
     #   resp.query_executions[0].statistics.data_manifest_location #=> String
@@ -453,7 +474,9 @@ module Aws::Athena
     # @option params [required, String] :name
     #   The name of the data catalog to create. The catalog name must be
     #   unique for the Amazon Web Services account and can use a maximum of
-    #   128 alphanumeric, underscore, at sign, or hyphen characters.
+    #   127 alphanumeric, underscore, at sign, or hyphen characters. The
+    #   remainder of the length constraint of 256 is reserved for use by
+    #   Athena.
     #
     # @option params [required, String] :type
     #   The type of data catalog to create: `LAMBDA` for a federated catalog,
@@ -986,6 +1009,7 @@ module Aws::Athena
     #   resp.query_execution.status.state_change_reason #=> String
     #   resp.query_execution.status.submission_date_time #=> Time
     #   resp.query_execution.status.completion_date_time #=> Time
+    #   resp.query_execution.status.athena_error.error_category #=> Integer
     #   resp.query_execution.statistics.engine_execution_time_in_millis #=> Integer
     #   resp.query_execution.statistics.data_scanned_in_bytes #=> Integer
     #   resp.query_execution.statistics.data_manifest_location #=> String
@@ -1811,7 +1835,9 @@ module Aws::Athena
     # @option params [required, String] :name
     #   The name of the data catalog to update. The catalog name must be
     #   unique for the Amazon Web Services account and can use a maximum of
-    #   128 alphanumeric, underscore, at sign, or hyphen characters.
+    #   127 alphanumeric, underscore, at sign, or hyphen characters. The
+    #   remainder of the length constraint of 256 is reserved for use by
+    #   Athena.
     #
     # @option params [required, String] :type
     #   Specifies the type of data catalog to update. Specify `LAMBDA` for a
@@ -1972,7 +1998,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.42.0'
+      context[:gem_version] = '1.46.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-athena/client_api.rb

@@ -14,6 +14,7 @@ module Aws::Athena
     include Seahorse::Model
 
     AmazonResourceName = Shapes::StringShape.new(name: 'AmazonResourceName')
+    AthenaError = Shapes::StructureShape.new(name: 'AthenaError')
     BatchGetNamedQueryInput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryInput')
     BatchGetNamedQueryOutput = Shapes::StructureShape.new(name: 'BatchGetNamedQueryOutput')
     BatchGetQueryExecutionInput = Shapes::StructureShape.new(name: 'BatchGetQueryExecutionInput')
@@ -58,6 +59,7 @@ module Aws::Athena
     EncryptionOption = Shapes::StringShape.new(name: 'EncryptionOption')
     EngineVersion = Shapes::StructureShape.new(name: 'EngineVersion')
     EngineVersionsList = Shapes::ListShape.new(name: 'EngineVersionsList')
+    ErrorCategory = Shapes::IntegerShape.new(name: 'ErrorCategory')
     ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
     ExpressionString = Shapes::StringShape.new(name: 'ExpressionString')
@@ -183,6 +185,9 @@ module Aws::Athena
     datumList = Shapes::ListShape.new(name: 'datumList')
     datumString = Shapes::StringShape.new(name: 'datumString')
 
+    AthenaError.add_member(:error_category, Shapes::ShapeRef.new(shape: ErrorCategory, location_name: "ErrorCategory"))
+    AthenaError.struct_class = Types::AthenaError
+
     BatchGetNamedQueryInput.add_member(:named_query_ids, Shapes::ShapeRef.new(shape: NamedQueryIdList, required: true, location_name: "NamedQueryIds"))
     BatchGetNamedQueryInput.struct_class = Types::BatchGetNamedQueryInput
 
@@ -514,6 +519,7 @@ module Aws::Athena
     QueryExecutionStatus.add_member(:state_change_reason, Shapes::ShapeRef.new(shape: String, location_name: "StateChangeReason"))
     QueryExecutionStatus.add_member(:submission_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "SubmissionDateTime"))
     QueryExecutionStatus.add_member(:completion_date_time, Shapes::ShapeRef.new(shape: Date, location_name: "CompletionDateTime"))
+    QueryExecutionStatus.add_member(:athena_error, Shapes::ShapeRef.new(shape: AthenaError, location_name: "AthenaError"))
     QueryExecutionStatus.struct_class = Types::QueryExecutionStatus
 
     ResourceNotFoundException.add_member(:message, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Message"))

data/lib/aws-sdk-athena/types.rb

@@ -10,6 +10,32 @@
 module Aws::Athena
   module Types
 
+    # Provides information about an Athena query error. The `AthenaError`
+    # feature provides standardized error information to help you understand
+    # failed queries and take steps after a query failure occurs.
+    # `AthenaError` includes an `ErrorCategory` field that specifies whether
+    # the cause of the failed query is due to system error, user error, or
+    # unknown error.
+    #
+    # @!attribute [rw] error_category
+    #   An integer value that specifies the category of a query failure
+    #   error. The following list shows the category for each integer value.
+    #
+    #   **1** - System
+    #
+    #   **2** - User
+    #
+    #   **3** - Unknown
+    #   @return [Integer]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AthenaError AWS API Documentation
+    #
+    class AthenaError < Struct.new(
+      :error_category)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # @note When making an API call, you may pass BatchGetNamedQueryInput
     #   data as a hash:
     #
@@ -188,7 +214,9 @@ module Aws::Athena
     # @!attribute [rw] name
     #   The name of the data catalog to create. The catalog name must be
     #   unique for the Amazon Web Services account and can use a maximum of
-    #   128 alphanumeric, underscore, at sign, or hyphen characters.
+    #   127 alphanumeric, underscore, at sign, or hyphen characters. The
+    #   remainder of the length constraint of 256 is reserved for use by
+    #   Athena.
     #   @return [String]
     #
     # @!attribute [rw] type
@@ -458,8 +486,10 @@ module Aws::Athena
     #
     # @!attribute [rw] name
     #   The name of the data catalog. The catalog name must be unique for
-    #   the Amazon Web Services account and can use a maximum of 128
-    #   alphanumeric, underscore, at sign, or hyphen characters.
+    #   the Amazon Web Services account and can use a maximum of 127
+    #   alphanumeric, underscore, at sign, or hyphen characters. The
+    #   remainder of the length constraint of 256 is reserved for use by
+    #   Athena.
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -527,7 +557,11 @@ module Aws::Athena
     # and type.
     #
     # @!attribute [rw] catalog_name
-    #   The name of the data catalog.
+    #   The name of the data catalog. The catalog name is unique for the
+    #   Amazon Web Services account and can use a maximum of 127
+    #   alphanumeric, underscore, at sign, or hyphen characters. The
+    #   remainder of the length constraint of 256 is reserved for use by
+    #   Athena.
     #   @return [String]
     #
     # @!attribute [rw] type
@@ -1879,13 +1913,18 @@ module Aws::Athena
     #   The date and time that the query completed.
     #   @return [Time]
     #
+    # @!attribute [rw] athena_error
+    #   Provides information about an Athena query error.
+    #   @return [Types::AthenaError]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecutionStatus AWS API Documentation
     #
     class QueryExecutionStatus < Struct.new(
       :state,
       :state_change_reason,
       :submission_date_time,
-      :completion_date_time)
+      :completion_date_time,
+      :athena_error)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2447,7 +2486,9 @@ module Aws::Athena
     # @!attribute [rw] name
     #   The name of the data catalog to update. The catalog name must be
     #   unique for the Amazon Web Services account and can use a maximum of
-    #   128 alphanumeric, underscore, at sign, or hyphen characters.
+    #   127 alphanumeric, underscore, at sign, or hyphen characters. The
+    #   remainder of the length constraint of 256 is reserved for use by
+    #   Athena.
     #   @return [String]
     #
     # @!attribute [rw] type

data/lib/aws-sdk-athena.rb

@@ -48,6 +48,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @!group service
 module Aws::Athena
 
-  GEM_VERSION = '1.42.0'
+  GEM_VERSION = '1.46.0'
 
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.42.0
+  version: 1.46.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-10-18 00:00:00.000000000 Z
+date: 2022-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.121.2
+        version: 3.125.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.121.2
+        version: 3.125.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement