aws-sdk-athena 1.45.0 → 1.46.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5df6530fc7a3a48a198f38e81e642d3024a34aaf0f77e8a17c3c4d863eda5bc
-  data.tar.gz: d26bb1398322bc5e2f31d95a7e0b2a2d4689c1afa903a55564c469ba37ff3ab1
+  metadata.gz: 8e4adc124ea67b6ebb0ed0fd885a083ef1f8f4fcadd40375a5fbb6363dc76974
+  data.tar.gz: bd8ae71072285c2de1a139cbd9197cc786ff442f2dbe146ac73a664dbd38cd42
 SHA512:
-  metadata.gz: 65efe7608a73cf29e2ac85a542be8c91bc0315ebf3ded45cc1a1a80ddd7be1f6dcad76e47efe5c4af3b1540f2a2d48aec254ff39b16e633fadae75fdd7c79dff
-  data.tar.gz: f0a8885b1349885396ed0938534783c968ae270f1cb5f4b35d6281746c36c8ddd6d4be5e931f296c9aac95716a51fc37b4216af49a26b7dd62166b95f8c550ea
+  metadata.gz: 19d1695339895486b1b4448d1b52986c64dfbbc2a7e88f0189896987894ebc52873ac572bf16c64bbcdbd04dc491cb3d16a9d2553f72c96ccd67bdfe890f910b
+  data.tar.gz: cab239aad3e817d60d4f6f51527e0cb5c05c46ef62297a494824c229dd9864c9d584f5cfa0bac0f0812dd7890c2aaad9779545fbaa198d67a6250bb282749c26

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 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)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.45.0
+1.46.0

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

@@ -442,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
@@ -473,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,
@@ -1006,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
@@ -1831,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
@@ -1992,7 +1998,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.45.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.45.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.45.0
+  version: 1.46.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-12-21 00:00:00.000000000 Z
+date: 2022-01-28 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core