aws-sdk-athena 1.48.0 → 1.51.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: da7467e550bf620597ceef165f353fc3808321b98e63d7d7d676aeab464bea29
-  data.tar.gz: 4cf673e0808b660cf7362bbc01353a4b3dbc9a86b4e82c55d8edafce913e5dda
+  metadata.gz: '0687af810b3e4362e24590cbad3f7d1268fd4cb23024a6edcc8b5dad6b117049'
+  data.tar.gz: 86b8e28554230e7d03c88d73d5a431677e024a5780cdcb700b594487eec11549
 SHA512:
-  metadata.gz: e4018d1f3ab5c934357ced0d31157c3433675f762d5bc4b0d24afb28b4dd9198b0a03ec6d16a01bf7774ab9ff2aac714e8d84641408a943603c3ace013043fef
-  data.tar.gz: 8c38f7b1b66adc538ae7c0aafa55d841b547c505a4d10d4cec3feb2e4c82af23aeb3e53d973246bf53ac72d8001fbd2d46e6ff49d0531e7c3190733fa9a19077
+  metadata.gz: f6fa542f8be717ba15b5d06759909313ea0c1073df477496ccb8f22f6deb1f16b60ac5b14e7ddfcbbb6ee6f2637ebe97a8580de5eeae8cb261cf4c0e64399ec3
+  data.tar.gz: bb09d6c920f592b74692a85ed0c8918f967c145d2a8a59ade110454d2c920ef517432a43a62377ac2a8ebded912980c79443982831404b3f9028de4fd1ab260d

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.51.0 (2022-02-28)
+------------------
+
+* Feature - This release adds support for updating an existing named query.
+
+1.50.0 (2022-02-24)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.49.0 (2022-02-14)
+------------------
+
+* Feature - This release adds a subfield, ErrorType, to the AthenaError response object in the GetQueryExecution API when a query fails.
+
 1.48.0 (2022-02-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.48.0
+1.51.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/checksum_algorithm.rb'
 require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/recursion_detection.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
@@ -75,6 +76,7 @@ module Aws::Athena
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::ChecksumAlgorithm)
     add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::RecursionDetection)
     add_plugin(Aws::Plugins::SignatureV4)
@@ -446,6 +448,7 @@ module Aws::Athena
     #   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].status.athena_error.error_type #=> 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
@@ -1015,6 +1018,7 @@ module Aws::Athena
     #   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.status.athena_error.error_type #=> 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
@@ -1041,14 +1045,6 @@ module Aws::Athena
     # User Guide*. This request does not execute the query but returns
     # results. Use StartQueryExecution to run a query.
     #
-    # If the original query execution ran using an
-    # ResultConfiguration$ExpectedBucketOwner setting, the setting also
-    # applies to Amazon S3 read operations when `GetQueryResults` is called.
-    # If an expected bucket owner has been specified and the query results
-    # are in an Amazon S3 bucket whose owner account ID is different from
-    # the expected bucket owner, the `GetQueryResults` call fails with an
-    # Amazon S3 permissions error.
-    #
     # To stream query results successfully, the IAM principal with
     # permission to call `GetQueryResults` also must have permissions to the
     # Amazon S3 `GetObject` action for the Athena query results location.
@@ -1911,6 +1907,41 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Updates a NamedQuery object. The database or workgroup cannot be
+    # updated.
+    #
+    # @option params [required, String] :named_query_id
+    #   The unique identifier (UUID) of the query.
+    #
+    # @option params [required, String] :name
+    #   The name of the query.
+    #
+    # @option params [String] :description
+    #   The query description.
+    #
+    # @option params [required, String] :query_string
+    #   The contents of the query with all query statements.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_named_query({
+    #     named_query_id: "NamedQueryId", # required
+    #     name: "NameString", # required
+    #     description: "NamedQueryDescriptionString",
+    #     query_string: "QueryString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateNamedQuery AWS API Documentation
+    #
+    # @overload update_named_query(params = {})
+    # @param [Hash] params ({})
+    def update_named_query(params = {}, options = {})
+      req = build_request(:update_named_query, params)
+      req.send_request(options)
+    end
+
     # Updates a prepared statement.
     #
     # @option params [required, String] :statement_name
@@ -2015,7 +2046,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.48.0'
+      context[:gem_version] = '1.51.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -62,6 +62,7 @@ module Aws::Athena
     ErrorCategory = Shapes::IntegerShape.new(name: 'ErrorCategory')
     ErrorCode = Shapes::StringShape.new(name: 'ErrorCode')
     ErrorMessage = Shapes::StringShape.new(name: 'ErrorMessage')
+    ErrorType = Shapes::IntegerShape.new(name: 'ErrorType')
     ExpressionString = Shapes::StringShape.new(name: 'ExpressionString')
     GetDataCatalogInput = Shapes::StructureShape.new(name: 'GetDataCatalogInput')
     GetDataCatalogOutput = Shapes::StructureShape.new(name: 'GetDataCatalogOutput')
@@ -116,6 +117,7 @@ module Aws::Athena
     MetadataException = Shapes::StructureShape.new(name: 'MetadataException')
     NameString = Shapes::StringShape.new(name: 'NameString')
     NamedQuery = Shapes::StructureShape.new(name: 'NamedQuery')
+    NamedQueryDescriptionString = Shapes::StringShape.new(name: 'NamedQueryDescriptionString')
     NamedQueryId = Shapes::StringShape.new(name: 'NamedQueryId')
     NamedQueryIdList = Shapes::ListShape.new(name: 'NamedQueryIdList')
     NamedQueryList = Shapes::ListShape.new(name: 'NamedQueryList')
@@ -170,6 +172,8 @@ module Aws::Athena
     UntagResourceOutput = Shapes::StructureShape.new(name: 'UntagResourceOutput')
     UpdateDataCatalogInput = Shapes::StructureShape.new(name: 'UpdateDataCatalogInput')
     UpdateDataCatalogOutput = Shapes::StructureShape.new(name: 'UpdateDataCatalogOutput')
+    UpdateNamedQueryInput = Shapes::StructureShape.new(name: 'UpdateNamedQueryInput')
+    UpdateNamedQueryOutput = Shapes::StructureShape.new(name: 'UpdateNamedQueryOutput')
     UpdatePreparedStatementInput = Shapes::StructureShape.new(name: 'UpdatePreparedStatementInput')
     UpdatePreparedStatementOutput = Shapes::StructureShape.new(name: 'UpdatePreparedStatementOutput')
     UpdateWorkGroupInput = Shapes::StructureShape.new(name: 'UpdateWorkGroupInput')
@@ -186,6 +190,7 @@ module Aws::Athena
     datumString = Shapes::StringShape.new(name: 'datumString')
 
     AthenaError.add_member(:error_category, Shapes::ShapeRef.new(shape: ErrorCategory, location_name: "ErrorCategory"))
+    AthenaError.add_member(:error_type, Shapes::ShapeRef.new(shape: ErrorType, location_name: "ErrorType"))
     AthenaError.struct_class = Types::AthenaError
 
     BatchGetNamedQueryInput.add_member(:named_query_ids, Shapes::ShapeRef.new(shape: NamedQueryIdList, required: true, location_name: "NamedQueryIds"))
@@ -623,6 +628,14 @@ module Aws::Athena
 
     UpdateDataCatalogOutput.struct_class = Types::UpdateDataCatalogOutput
 
+    UpdateNamedQueryInput.add_member(:named_query_id, Shapes::ShapeRef.new(shape: NamedQueryId, required: true, location_name: "NamedQueryId"))
+    UpdateNamedQueryInput.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
+    UpdateNamedQueryInput.add_member(:description, Shapes::ShapeRef.new(shape: NamedQueryDescriptionString, location_name: "Description"))
+    UpdateNamedQueryInput.add_member(:query_string, Shapes::ShapeRef.new(shape: QueryString, required: true, location_name: "QueryString"))
+    UpdateNamedQueryInput.struct_class = Types::UpdateNamedQueryInput
+
+    UpdateNamedQueryOutput.struct_class = Types::UpdateNamedQueryOutput
+
     UpdatePreparedStatementInput.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementName, required: true, location_name: "StatementName"))
     UpdatePreparedStatementInput.add_member(:work_group, Shapes::ShapeRef.new(shape: WorkGroupName, required: true, location_name: "WorkGroup"))
     UpdatePreparedStatementInput.add_member(:query_statement, Shapes::ShapeRef.new(shape: QueryString, required: true, location_name: "QueryStatement"))
@@ -1076,6 +1089,16 @@ module Aws::Athena
         o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
       end)
 
+      api.add_operation(:update_named_query, Seahorse::Model::Operation.new.tap do |o|
+        o.name = "UpdateNamedQuery"
+        o.http_method = "POST"
+        o.http_request_uri = "/"
+        o.input = Shapes::ShapeRef.new(shape: UpdateNamedQueryInput)
+        o.output = Shapes::ShapeRef.new(shape: UpdateNamedQueryOutput)
+        o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
+        o.errors << Shapes::ShapeRef.new(shape: InvalidRequestException)
+      end)
+
       api.add_operation(:update_prepared_statement, Seahorse::Model::Operation.new.tap do |o|
         o.name = "UpdatePreparedStatement"
         o.http_method = "POST"

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

@@ -15,7 +15,7 @@ module Aws::Athena
     # 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.
+    # other error.
     #
     # @!attribute [rw] error_category
     #   An integer value that specifies the category of a query failure
@@ -25,13 +25,24 @@ module Aws::Athena
     #
     #   **2** - User
     #
-    #   **3** - Unknown
+    #   **3** - Other
+    #   @return [Integer]
+    #
+    # @!attribute [rw] error_type
+    #   An integer value that provides specific information about an Athena
+    #   query error. For the meaning of specific values, see the [Error Type
+    #   Reference][1] in the *Amazon Athena User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/error-reference.html#error-reference-error-type-reference
     #   @return [Integer]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/AthenaError AWS API Documentation
     #
     class AthenaError < Struct.new(
-      :error_category)
+      :error_category,
+      :error_type)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1631,8 +1642,8 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # A query, where `QueryString` is the list of SQL query statements that
-    # comprise the query.
+    # A query, where `QueryString` contains the SQL statements that make up
+    # the query.
     #
     # @!attribute [rw] name
     #   The query name.
@@ -1647,7 +1658,7 @@ module Aws::Athena
     #   @return [String]
     #
     # @!attribute [rw] query_string
-    #   The SQL query statements that comprise the query.
+    #   The SQL statements that make up the query.
     #   @return [String]
     #
     # @!attribute [rw] named_query_id
@@ -2067,7 +2078,7 @@ module Aws::Athena
     #   in this workgroup should be ignored and set to null. If set to
     #   "false" or not set, and a value is present in the `OutputLocation`
     #   in `ResultConfigurationUpdates` (the client-side setting), the
-    #   `OutputLocation` in the workgroup's `ResultConfiguration` is
+    #   `OutputLocation` in the workgroup's `ResultConfiguration` will be
     #   updated with the new value. For more information, see [Workgroup
     #   Settings Override Client-Side Settings][1].
     #
@@ -2087,9 +2098,9 @@ module Aws::Athena
     #   to "false" or not set, and a value is present in the
     #   `EncryptionConfiguration` in `ResultConfigurationUpdates` (the
     #   client-side setting), the `EncryptionConfiguration` in the
-    #   workgroup's `ResultConfiguration` is updated with the new value.
-    #   For more information, see [Workgroup Settings Override Client-Side
-    #   Settings][1].
+    #   workgroup's `ResultConfiguration` will be updated with the new
+    #   value. For more information, see [Workgroup Settings Override
+    #   Client-Side Settings][1].
     #
     #
     #
@@ -2145,7 +2156,7 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # The metadata and rows that comprise a query result set. The metadata
+    # The metadata and rows that make up a query result set. The metadata
     # describes the column structure and data types. To return a `ResultSet`
     # object, use GetQueryResults.
     #
@@ -2183,7 +2194,7 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # The rows that comprise a query result table.
+    # The rows that make up a query result table.
     #
     # @!attribute [rw] data
     #   The data that populates a row in a query result table.
@@ -2609,6 +2620,47 @@ module Aws::Athena
     #
     class UpdateDataCatalogOutput < Aws::EmptyStructure; end
 
+    # @note When making an API call, you may pass UpdateNamedQueryInput
+    #   data as a hash:
+    #
+    #       {
+    #         named_query_id: "NamedQueryId", # required
+    #         name: "NameString", # required
+    #         description: "NamedQueryDescriptionString",
+    #         query_string: "QueryString", # required
+    #       }
+    #
+    # @!attribute [rw] named_query_id
+    #   The unique identifier (UUID) of the query.
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the query.
+    #   @return [String]
+    #
+    # @!attribute [rw] description
+    #   The query description.
+    #   @return [String]
+    #
+    # @!attribute [rw] query_string
+    #   The contents of the query with all query statements.
+    #   @return [String]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateNamedQueryInput AWS API Documentation
+    #
+    class UpdateNamedQueryInput < Struct.new(
+      :named_query_id,
+      :name,
+      :description,
+      :query_string)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateNamedQueryOutput AWS API Documentation
+    #
+    class UpdateNamedQueryOutput < Aws::EmptyStructure; end
+
     # @note When making an API call, you may pass UpdatePreparedStatementInput
     #   data as a hash:
     #

data/lib/aws-sdk-athena.rb

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

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.48.0
+  version: 1.51.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2022-02-04 00:00:00.000000000 Z
+date: 2022-02-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.126.0
+        version: 3.127.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.126.0
+        version: 3.127.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement