aws-sdk-athena 1.19.0 → 1.20.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 4ac48ea53a1a555aee6df6cddb7d534baa9ff196
-  data.tar.gz: 04e0ddf48b0d26361acf7aa3ea53f6e69256daf5
+  metadata.gz: d2fec8b087ec4b9997a9e5a2eb0353bfa175d858
+  data.tar.gz: 28d9e18f9d9049c4bb06fb969aab923098d6615b
 SHA512:
-  metadata.gz: 0bf498bc9ad0f96ce658d68ea75d0b82cf8327ad8f8cc61db3ef070f72de35dec957630570d2ee9623a9711e26bb494865e2e7ba82bea9f061cc63fc79e1a8c3
-  data.tar.gz: a13d23fb0807683d2fecdd4d066a84c130966bc7b367a9b475b204bc88e73c431c9ce3511874fd91ffea82cbf44803e04371a134c45b512e00318e000b7d4ca4
+  metadata.gz: 0e2f2982def8b4b7c83d92bb1ba67efe339ed300de39e7255264485c3485daf61fef820a58a9ad138ff0dd7524932cb6ff27b249c914c2325c6bb16e85145c10
+  data.tar.gz: 2c4d20d15ba58ffa48fa6822c583195d9743e3214c6351cc16ed8984845448c1543e8b54c5fa3c046b3a15d5ea04026b12eb6545957aa4ef37b8ee1ba6768d29

data/lib/aws-sdk-athena.rb

@@ -42,6 +42,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @service
 module Aws::Athena
 
-  GEM_VERSION = '1.19.0'
+  GEM_VERSION = '1.20.0'
 
 end

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

@@ -350,6 +350,7 @@ module Aws::Athena
     #   resp.query_executions[0].status.completion_date_time #=> Time
     #   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
     #   resp.query_executions[0].work_group #=> String
     #   resp.unprocessed_query_execution_ids #=> Array
     #   resp.unprocessed_query_execution_ids[0].query_execution_id #=> String
@@ -621,6 +622,7 @@ module Aws::Athena
     #   resp.query_execution.status.completion_date_time #=> Time
     #   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
     #   resp.query_execution.work_group #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetQueryExecution AWS API Documentation
@@ -632,11 +634,26 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Returns the results of a single query execution specified by
-    # `QueryExecutionId` if you have access to the workgroup in which the
-    # query ran. This request does not execute the query but returns
+    # Streams the results of a single query execution specified by
+    # `QueryExecutionId` from the Athena query results location in Amazon
+    # S3. For more information, see [Query Results][1] in the *Amazon Athena
+    # User Guide*. This request does not execute the query but returns
     # results. Use StartQueryExecution to run a query.
     #
+    # 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.
+    #
+    # IAM principals with permission to the Amazon S3 `GetObject` action for
+    # the query results location are able to retrieve query results from
+    # Amazon S3 even if permission to the `GetQueryResults` action is
+    # denied. To restrict user or role access, ensure that Amazon S3
+    # permissions to the Athena query location are denied.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/athena/latest/ug/querying.html
+    #
     # @option params [required, String] :query_execution_id
     #   The unique ID of the query execution.
     #
@@ -1160,7 +1177,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.19.0'
+      context[:gem_version] = '1.20.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -286,6 +286,7 @@ module Aws::Athena
 
     QueryExecutionStatistics.add_member(:engine_execution_time_in_millis, Shapes::ShapeRef.new(shape: Long, location_name: "EngineExecutionTimeInMillis"))
     QueryExecutionStatistics.add_member(:data_scanned_in_bytes, Shapes::ShapeRef.new(shape: Long, location_name: "DataScannedInBytes"))
+    QueryExecutionStatistics.add_member(:data_manifest_location, Shapes::ShapeRef.new(shape: String, location_name: "DataManifestLocation"))
     QueryExecutionStatistics.struct_class = Types::QueryExecutionStatistics
 
     QueryExecutionStatus.add_member(:state, Shapes::ShapeRef.new(shape: QueryExecutionState, location_name: "State"))

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

@@ -807,9 +807,9 @@ module Aws::Athena
     #   @return [Types::QueryExecutionStatus]
     #
     # @!attribute [rw] statistics
-    #   The amount of data scanned during the query execution and the amount
-    #   of time that it took to execute, and the type of statement that was
-    #   run.
+    #   The location of a manifest file that tracks file locations generated
+    #   by the query, the amount of data scanned by the query, and the
+    #   amount of time that it took the query to run.
     #   @return [Types::QueryExecutionStatistics]
     #
     # @!attribute [rw] work_group
@@ -850,9 +850,9 @@ module Aws::Athena
       include Aws::Structure
     end
 
-    # The amount of data scanned during the query execution and the amount
-    # of time that it took to execute, and the type of statement that was
-    # run.
+    # The location of a manifest file that tracks file locations generated
+    # by the query, the amount of data scanned by the query, and the amount
+    # of time that it took the query to run.
     #
     # @!attribute [rw] engine_execution_time_in_millis
     #   The number of milliseconds that the query took to execute.
@@ -862,11 +862,26 @@ module Aws::Athena
     #   The number of bytes in the data that was queried.
     #   @return [Integer]
     #
+    # @!attribute [rw] data_manifest_location
+    #   The location and file name of a data manifest file. The manifest
+    #   file is saved to the Athena query results location in Amazon S3. It
+    #   tracks files that the query wrote to Amazon S3. If the query fails,
+    #   the manifest file also tracks files that the query intended to
+    #   write. The manifest is useful for identifying orphaned files
+    #   resulting from a failed query. For more information, see [Working
+    #   with Query Output Files][1] in the *Amazon Athena User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/querying.html
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/QueryExecutionStatistics AWS API Documentation
     #
     class QueryExecutionStatistics < Struct.new(
       :engine_execution_time_in_millis,
-      :data_scanned_in_bytes)
+      :data_scanned_in_bytes,
+      :data_manifest_location)
       include Aws::Structure
     end
 

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.19.0
+  version: 1.20.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-08-15 00:00:00.000000000 Z
+date: 2019-09-17 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core