aws-sdk-athena 1.22.0 → 1.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: ae65dc6c33253e49092b4bbf458f49e2cc1bb883
-  data.tar.gz: f7c41ce3576e0d80f2bf9136f3631bed19a81d30
+SHA256:
+  metadata.gz: 913687b1976344c8567730859d90adfeed4ac208e326b517a2bf3b4eeeeeb77b
+  data.tar.gz: 2800a8f40026f383eedc9db0194afbbffe2198e222bc5623e13542126ad778b1
 SHA512:
-  metadata.gz: 9982c8ebac6eaf5714692b27320e54bb7690f953ff1b3ed112dcca04d66da24287ed04a0d11a72a0959b376efe547057655bc0eb4a32148f4d6345cdad0873be
-  data.tar.gz: a92eb4cdf72aa9bbfb4fa53f84c917bcc54f03a0783d14040b5a330a324d732c4219aef86889341f5371a306bb60e48b191df3bf6db78096a4205cbe29667f8f
+  metadata.gz: e395d09fd149a425e2c18b866e160e84d777a8834171886e5291dfb710c0da053b2b66754d3f7688825c299737e20422ae8615893b8723abbbb5268c03c00569
+  data.tar.gz: 5188e0b95bd203e1eef30002889a43cac1ea8a2a66d85dcf5fab29adfc29121cc364d0fc436398db22e08b91bda52ded84fd7a11d471dfb6276b172b22695f20

data/lib/aws-sdk-athena.rb

@@ -24,17 +24,20 @@ require_relative 'aws-sdk-athena/customizations'
 # methods each accept a hash of request parameters and return a response
 # structure.
 #
+#     athena = Aws::Athena::Client.new
+#     resp = athena.batch_get_named_query(params)
+#
 # See {Client} for more information.
 #
 # # Errors
 #
-# Errors returned from Amazon Athena all
-# extend {Errors::ServiceError}.
+# Errors returned from Amazon Athena are defined in the
+# {Errors} module and all extend {Errors::ServiceError}.
 #
 #     begin
 #       # do stuff
 #     rescue Aws::Athena::Errors::ServiceError
-#       # rescues all service API errors
+#       # rescues all Amazon Athena API errors
 #     end
 #
 # See {Errors} for more information.
@@ -42,6 +45,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @service
 module Aws::Athena
 
-  GEM_VERSION = '1.22.0'
+  GEM_VERSION = '1.27.0'
 
 end

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

@@ -30,6 +30,18 @@ require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 Aws::Plugins::GlobalConfiguration.add_identifier(:athena)
 
 module Aws::Athena
+  # An API client for Athena.  To construct a client, you need to configure a `:region` and `:credentials`.
+  #
+  #     client = Aws::Athena::Client.new(
+  #       region: region_name,
+  #       credentials: credentials,
+  #       # ...
+  #     )
+  #
+  # For details on configuring region and credentials see
+  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
+  #
+  # See {#initialize} for a full list of supported configuration options.
   class Client < Seahorse::Client::Base
 
     include Aws::ClientStubs
@@ -93,7 +105,7 @@ module Aws::Athena
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
     #     used to determine the service `:endpoint`. When not passed,
-    #     a default `:region` is search for in the following locations:
+    #     a default `:region` is searched for in the following locations:
     #
     #     * `Aws.config[:region]`
     #     * `ENV['AWS_REGION']`
@@ -108,6 +120,12 @@ module Aws::Athena
     #     When set to `true`, a thread polling for endpoints will be running in
     #     the background every 60 secs (default). Defaults to `false`.
     #
+    #   @option options [Boolean] :adaptive_retry_wait_to_fill (true)
+    #     Used only in `adaptive` retry mode.  When true, the request will sleep
+    #     until there is sufficent client side capacity to retry the request.
+    #     When false, the request will raise a `RetryCapacityNotAvailableError` and will
+    #     not retry instead of sleeping.
+    #
     #   @option options [Boolean] :client_side_monitoring (false)
     #     When `true`, client-side metrics will be collected for all API requests from
     #     this client.
@@ -132,6 +150,10 @@ module Aws::Athena
     #     When `true`, an attempt is made to coerce request parameters into
     #     the required types.
     #
+    #   @option options [Boolean] :correct_clock_skew (true)
+    #     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 [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -139,7 +161,7 @@ module Aws::Athena
     #   @option options [String] :endpoint
     #     The client endpoint is normally constructed from the `:region`
     #     option. You should only configure an `:endpoint` when connecting
-    #     to test endpoints. This should be avalid HTTP(S) URI.
+    #     to test endpoints. This should be a valid HTTP(S) URI.
     #
     #   @option options [Integer] :endpoint_cache_max_entries (1000)
     #     Used for the maximum size limit of the LRU cache storing endpoints data
@@ -154,7 +176,7 @@ module Aws::Athena
     #     requests fetching endpoints information. Defaults to 60 sec.
     #
     #   @option options [Boolean] :endpoint_discovery (false)
-    #     When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
+    #     When set to `true`, endpoint discovery will be enabled for operations when available.
     #
     #   @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
     #     The log formatter.
@@ -166,15 +188,29 @@ module Aws::Athena
     #     The Logger instance to send log messages to.  If this option
     #     is not set, logging will be disabled.
     #
+    #   @option options [Integer] :max_attempts (3)
+    #     An integer representing the maximum number attempts that will be made for
+    #     a single request, including the initial attempt.  For example,
+    #     setting this value to 5 will result in a request being retried up to
+    #     4 times. Used in `standard` and `adaptive` retry modes.
+    #
     #   @option options [String] :profile ("default")
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [Proc] :retry_backoff
+    #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
+    #     This option is only used in the `legacy` retry mode.
+    #
     #   @option options [Float] :retry_base_delay (0.3)
-    #     The base delay in seconds used by the default backoff function.
+    #     The base delay in seconds used by the default backoff function. This option
+    #     is only used in the `legacy` retry mode.
     #
     #   @option options [Symbol] :retry_jitter (:none)
-    #     A delay randomiser function used by the default backoff function. Some predefined functions can be referenced by name - :none, :equal, :full, otherwise a Proc that takes and returns a number.
+    #     A delay randomiser function used by the default backoff function.
+    #     Some predefined functions can be referenced by name - :none, :equal, :full,
+    #     otherwise a Proc that takes and returns a number. This option is only used
+    #     in the `legacy` retry mode.
     #
     #     @see https://www.awsarchitectureblog.com/2015/03/backoff.html
     #
@@ -182,11 +218,30 @@ module Aws::Athena
     #     The maximum number of times to retry failed requests.  Only
     #     ~ 500 level server errors and certain ~ 400 level client errors
     #     are retried.  Generally, these are throttling errors, data
-    #     checksum errors, networking errors, timeout errors and auth
-    #     errors from expired credentials.
+    #     checksum errors, networking errors, timeout errors, auth errors,
+    #     endpoint discovery, and errors from expired credentials.
+    #     This option is only used in the `legacy` retry mode.
     #
     #   @option options [Integer] :retry_max_delay (0)
-    #     The maximum number of seconds to delay between retries (0 for no limit) used by the default backoff function.
+    #     The maximum number of seconds to delay between retries (0 for no limit)
+    #     used by the default backoff function. This option is only used in the
+    #     `legacy` retry mode.
+    #
+    #   @option options [String] :retry_mode ("legacy")
+    #     Specifies which retry algorithm to use. Values are:
+    #
+    #     * `legacy` - The pre-existing retry behavior.  This is default value if
+    #       no retry mode is provided.
+    #
+    #     * `standard` - A standardized set of retry rules across the AWS SDKs.
+    #       This includes support for retry quotas, which limit the number of
+    #       unsuccessful retries a client can make.
+    #
+    #     * `adaptive` - An experimental retry mode that includes all the
+    #       functionality of `standard` mode along with automatic client side
+    #       throttling.  This is a provisional mode that may change behavior
+    #       in the future.
+    #
     #
     #   @option options [String] :secret_access_key
     #
@@ -219,16 +274,15 @@ module Aws::Athena
     #     requests through.  Formatted like 'http://proxy.com:123'.
     #
     #   @option options [Float] :http_open_timeout (15) The number of
-    #     seconds to wait when opening a HTTP session before rasing a
+    #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
     #   @option options [Integer] :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 yeidled by {#session_for}.
+    #     safely be set per-request on the session.
     #
     #   @option options [Float] :http_idle_timeout (5) The number of
-    #     seconds a connection is allowed to sit idble before it is
+    #     seconds a connection is allowed to sit idle before it is
     #     considered stale.  Stale connections are closed and removed
     #     from the pool before making a request.
     #
@@ -237,7 +291,7 @@ module Aws::Athena
     #     request body.  This option has no effect unless the request has
     #     "Expect" header set to "100-continue".  Defaults to `nil` which
     #     disables this behaviour.  This value can safely be set per
-    #     request on the session yeidled by {#session_for}.
+    #     request on the session.
     #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
@@ -344,6 +398,7 @@ module Aws::Athena
     #   resp.query_executions[0].result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.query_executions[0].result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_executions[0].query_execution_context.database #=> String
+    #   resp.query_executions[0].query_execution_context.catalog #=> String
     #   resp.query_executions[0].status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
     #   resp.query_executions[0].status.state_change_reason #=> String
     #   resp.query_executions[0].status.submission_date_time #=> Time
@@ -370,6 +425,83 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Creates (registers) a data catalog with the specified name and
+    # properties. Catalogs created are visible to all users of the same AWS
+    # account.
+    #
+    # @option params [required, String] :name
+    #   The name of the data catalog to create. The catalog name must be
+    #   unique for the AWS account and can use a maximum of 128 alphanumeric,
+    #   underscore, at sign, or hyphen characters.
+    #
+    # @option params [required, String] :type
+    #   The type of data catalog to create: `LAMBDA` for a federated catalog,
+    #   `GLUE` for AWS Glue Catalog, or `HIVE` for an external hive metastore.
+    #
+    # @option params [String] :description
+    #   A description of the data catalog to be created.
+    #
+    # @option params [Hash<String,String>] :parameters
+    #   Specifies the Lambda function or functions to use for creating the
+    #   data catalog. This is a mapping whose values depend on the catalog
+    #   type.
+    #
+    #   * For the `HIVE` data catalog type, use the following syntax. The
+    #     `metadata-function` parameter is required. `The sdk-version`
+    #     parameter is optional and defaults to the currently supported
+    #     version.
+    #
+    #     `metadata-function=lambda_arn, sdk-version=version_number `
+    #
+    #   * For the `LAMBDA` data catalog type, use one of the following sets of
+    #     required parameters, but not both.
+    #
+    #     * If you have one Lambda function that processes metadata and
+    #       another for reading the actual data, use the following syntax.
+    #       Both parameters are required.
+    #
+    #       `metadata-function=lambda_arn, record-function=lambda_arn `
+    #
+    #     * If you have a composite Lambda function that processes both
+    #       metadata and data, use the following syntax to specify your Lambda
+    #       function.
+    #
+    #       `function=lambda_arn `
+    #
+    #   * The `GLUE` type has no parameters.
+    #
+    # @option params [Array<Types::Tag>] :tags
+    #   A list of comma separated tags to add to the data catalog that is
+    #   created.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_data_catalog({
+    #     name: "CatalogNameString", # required
+    #     type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE
+    #     description: "DescriptionString",
+    #     parameters: {
+    #       "KeyString" => "ParametersMapValue",
+    #     },
+    #     tags: [
+    #       {
+    #         key: "TagKey",
+    #         value: "TagValue",
+    #       },
+    #     ],
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateDataCatalog AWS API Documentation
+    #
+    # @overload create_data_catalog(params = {})
+    # @param [Hash] params ({})
+    def create_data_catalog(params = {}, options = {})
+      req = build_request(:create_data_catalog, params)
+      req.send_request(options)
+    end
+
     # Creates a named query in the specified workgroup. Requires that you
     # have access to the workgroup.
     #
@@ -458,8 +590,8 @@ module Aws::Athena
     #   The workgroup description.
     #
     # @option params [Array<Types::Tag>] :tags
-    #   One or more tags, separated by commas, that you want to attach to the
-    #   workgroup as you create it.
+    #   A list of comma separated tags to add to the workgroup that is
+    #   created.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -498,6 +630,28 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Deletes a data catalog.
+    #
+    # @option params [required, String] :name
+    #   The name of the data catalog to delete.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_data_catalog({
+    #     name: "CatalogNameString", # required
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteDataCatalog AWS API Documentation
+    #
+    # @overload delete_data_catalog(params = {})
+    # @param [Hash] params ({})
+    def delete_data_catalog(params = {}, options = {})
+      req = build_request(:delete_data_catalog, params)
+      req.send_request(options)
+    end
+
     # Deletes the named query if you have access to the workgroup in which
     # the query was saved.
     #
@@ -559,6 +713,73 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Returns the specified data catalog.
+    #
+    # @option params [required, String] :name
+    #   The name of the data catalog to return.
+    #
+    # @return [Types::GetDataCatalogOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetDataCatalogOutput#data_catalog #data_catalog} => Types::DataCatalog
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_data_catalog({
+    #     name: "CatalogNameString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.data_catalog.name #=> String
+    #   resp.data_catalog.description #=> String
+    #   resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE"
+    #   resp.data_catalog.parameters #=> Hash
+    #   resp.data_catalog.parameters["KeyString"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetDataCatalog AWS API Documentation
+    #
+    # @overload get_data_catalog(params = {})
+    # @param [Hash] params ({})
+    def get_data_catalog(params = {}, options = {})
+      req = build_request(:get_data_catalog, params)
+      req.send_request(options)
+    end
+
+    # Returns a database object for the specfied database and data catalog.
+    #
+    # @option params [required, String] :catalog_name
+    #   The name of the data catalog that contains the database to return.
+    #
+    # @option params [required, String] :database_name
+    #   The name of the database to return.
+    #
+    # @return [Types::GetDatabaseOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetDatabaseOutput#database #database} => Types::Database
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_database({
+    #     catalog_name: "CatalogNameString", # required
+    #     database_name: "NameString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.database.name #=> String
+    #   resp.database.description #=> String
+    #   resp.database.parameters #=> Hash
+    #   resp.database.parameters["KeyString"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetDatabase AWS API Documentation
+    #
+    # @overload get_database(params = {})
+    # @param [Hash] params ({})
+    def get_database(params = {}, options = {})
+      req = build_request(:get_database, params)
+      req.send_request(options)
+    end
+
     # Returns information about a single query. Requires that you have
     # access to the workgroup in which the query was saved.
     #
@@ -620,6 +841,7 @@ module Aws::Athena
     #   resp.query_execution.result_configuration.encryption_configuration.encryption_option #=> String, one of "SSE_S3", "SSE_KMS", "CSE_KMS"
     #   resp.query_execution.result_configuration.encryption_configuration.kms_key #=> String
     #   resp.query_execution.query_execution_context.database #=> String
+    #   resp.query_execution.query_execution_context.catalog #=> String
     #   resp.query_execution.status.state #=> String, one of "QUEUED", "RUNNING", "SUCCEEDED", "FAILED", "CANCELLED"
     #   resp.query_execution.status.state_change_reason #=> String
     #   resp.query_execution.status.submission_date_time #=> Time
@@ -666,8 +888,10 @@ module Aws::Athena
     #   The unique ID of the query execution.
     #
     # @option params [String] :next_token
-    #   The token that specifies where to start pagination if a previous
-    #   request was truncated.
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the `NextToken` from the response object of
+    #   the previous page call.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results (rows) to return in this request.
@@ -678,6 +902,8 @@ module Aws::Athena
     #   * {Types::GetQueryResultsOutput#result_set #result_set} => Types::ResultSet
     #   * {Types::GetQueryResultsOutput#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.get_query_results({
@@ -714,6 +940,56 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Returns table metadata for the specified catalog, database, and table.
+    #
+    # @option params [required, String] :catalog_name
+    #   The name of the data catalog that contains the database and table
+    #   metadata to return.
+    #
+    # @option params [required, String] :database_name
+    #   The name of the database that contains the table metadata to return.
+    #
+    # @option params [required, String] :table_name
+    #   The name of the table for which metadata is returned.
+    #
+    # @return [Types::GetTableMetadataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::GetTableMetadataOutput#table_metadata #table_metadata} => Types::TableMetadata
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.get_table_metadata({
+    #     catalog_name: "CatalogNameString", # required
+    #     database_name: "NameString", # required
+    #     table_name: "NameString", # required
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.table_metadata.name #=> String
+    #   resp.table_metadata.create_time #=> Time
+    #   resp.table_metadata.last_access_time #=> Time
+    #   resp.table_metadata.table_type #=> String
+    #   resp.table_metadata.columns #=> Array
+    #   resp.table_metadata.columns[0].name #=> String
+    #   resp.table_metadata.columns[0].type #=> String
+    #   resp.table_metadata.columns[0].comment #=> String
+    #   resp.table_metadata.partition_keys #=> Array
+    #   resp.table_metadata.partition_keys[0].name #=> String
+    #   resp.table_metadata.partition_keys[0].type #=> String
+    #   resp.table_metadata.partition_keys[0].comment #=> String
+    #   resp.table_metadata.parameters #=> Hash
+    #   resp.table_metadata.parameters["KeyString"] #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetTableMetadata AWS API Documentation
+    #
+    # @overload get_table_metadata(params = {})
+    # @param [Hash] params ({})
+    def get_table_metadata(params = {}, options = {})
+      req = build_request(:get_table_metadata, params)
+      req.send_request(options)
+    end
+
     # Returns information about the workgroup with the specified name.
     #
     # @option params [required, String] :work_group
@@ -752,8 +1028,98 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Lists the data catalogs in the current AWS account.
+    #
+    # @option params [String] :next_token
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the NextToken from the response object of
+    #   the previous page call.
+    #
+    # @option params [Integer] :max_results
+    #   Specifies the maximum number of data catalogs to return.
+    #
+    # @return [Types::ListDataCatalogsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListDataCatalogsOutput#data_catalogs_summary #data_catalogs_summary} => Array&lt;Types::DataCatalogSummary&gt;
+    #   * {Types::ListDataCatalogsOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_data_catalogs({
+    #     next_token: "Token",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.data_catalogs_summary #=> Array
+    #   resp.data_catalogs_summary[0].catalog_name #=> String
+    #   resp.data_catalogs_summary[0].type #=> String, one of "LAMBDA", "GLUE", "HIVE"
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListDataCatalogs AWS API Documentation
+    #
+    # @overload list_data_catalogs(params = {})
+    # @param [Hash] params ({})
+    def list_data_catalogs(params = {}, options = {})
+      req = build_request(:list_data_catalogs, params)
+      req.send_request(options)
+    end
+
+    # Lists the databases in the specified data catalog.
+    #
+    # @option params [required, String] :catalog_name
+    #   The name of the data catalog that contains the databases to return.
+    #
+    # @option params [String] :next_token
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the `NextToken` from the response object of
+    #   the previous page call.
+    #
+    # @option params [Integer] :max_results
+    #   Specifies the maximum number of results to return.
+    #
+    # @return [Types::ListDatabasesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListDatabasesOutput#database_list #database_list} => Array&lt;Types::Database&gt;
+    #   * {Types::ListDatabasesOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_databases({
+    #     catalog_name: "CatalogNameString", # required
+    #     next_token: "Token",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.database_list #=> Array
+    #   resp.database_list[0].name #=> String
+    #   resp.database_list[0].description #=> String
+    #   resp.database_list[0].parameters #=> Hash
+    #   resp.database_list[0].parameters["KeyString"] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListDatabases AWS API Documentation
+    #
+    # @overload list_databases(params = {})
+    # @param [Hash] params ({})
+    def list_databases(params = {}, options = {})
+      req = build_request(:list_databases, params)
+      req.send_request(options)
+    end
+
     # Provides a list of available query IDs only for queries saved in the
-    # specified workgroup. Requires that you have access to the workgroup.
+    # specified workgroup. Requires that you have access to the specified
+    # workgroup. If a workgroup is not specified, lists the saved queries
+    # for the primary workgroup.
     #
     # For code samples using the AWS SDK for Java, see [Examples and Code
     # Samples][1] in the *Amazon Athena User Guide*.
@@ -763,21 +1129,26 @@ module Aws::Athena
     # [1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
     #
     # @option params [String] :next_token
-    #   The token that specifies where to start pagination if a previous
-    #   request was truncated.
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the `NextToken` from the response object of
+    #   the previous page call.
     #
     # @option params [Integer] :max_results
     #   The maximum number of queries to return in this request.
     #
     # @option params [String] :work_group
     #   The name of the workgroup from which the named queries are being
-    #   returned.
+    #   returned. If a workgroup is not specified, the saved queries for the
+    #   primary workgroup are returned.
     #
     # @return [Types::ListNamedQueriesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListNamedQueriesOutput#named_query_ids #named_query_ids} => Array&lt;String&gt;
     #   * {Types::ListNamedQueriesOutput#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_named_queries({
@@ -802,8 +1173,9 @@ module Aws::Athena
     end
 
     # Provides a list of available query execution IDs for the queries in
-    # the specified workgroup. Requires you to have access to the workgroup
-    # in which the queries ran.
+    # the specified workgroup. If a workgroup is not specified, returns a
+    # list of query execution IDs for the primary workgroup. Requires you to
+    # have access to the workgroup in which the queries ran.
     #
     # For code samples using the AWS SDK for Java, see [Examples and Code
     # Samples][1] in the *Amazon Athena User Guide*.
@@ -813,20 +1185,26 @@ module Aws::Athena
     # [1]: http://docs.aws.amazon.com/athena/latest/ug/code-samples.html
     #
     # @option params [String] :next_token
-    #   The token that specifies where to start pagination if a previous
-    #   request was truncated.
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the `NextToken` from the response object of
+    #   the previous page call.
     #
     # @option params [Integer] :max_results
     #   The maximum number of query executions to return in this request.
     #
     # @option params [String] :work_group
-    #   The name of the workgroup from which queries are being returned.
+    #   The name of the workgroup from which queries are being returned. If a
+    #   workgroup is not specified, a list of available query execution IDs
+    #   for the queries in the primary workgroup is returned.
     #
     # @return [Types::ListQueryExecutionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListQueryExecutionsOutput#query_execution_ids #query_execution_ids} => Array&lt;String&gt;
     #   * {Types::ListQueryExecutionsOutput#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_query_executions({
@@ -850,25 +1228,96 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Lists the tags associated with this workgroup.
+    # Lists the metadata for the tables in the specified data catalog
+    # database.
+    #
+    # @option params [required, String] :catalog_name
+    #   The name of the data catalog for which table metadata should be
+    #   returned.
+    #
+    # @option params [required, String] :database_name
+    #   The name of the database for which table metadata should be returned.
+    #
+    # @option params [String] :expression
+    #   A regex filter that pattern-matches table names. If no expression is
+    #   supplied, metadata for all tables are listed.
+    #
+    # @option params [String] :next_token
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the NextToken from the response object of
+    #   the previous page call.
+    #
+    # @option params [Integer] :max_results
+    #   Specifies the maximum number of results to return.
+    #
+    # @return [Types::ListTableMetadataOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTableMetadataOutput#table_metadata_list #table_metadata_list} => Array&lt;Types::TableMetadata&gt;
+    #   * {Types::ListTableMetadataOutput#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_table_metadata({
+    #     catalog_name: "CatalogNameString", # required
+    #     database_name: "NameString", # required
+    #     expression: "ExpressionString",
+    #     next_token: "Token",
+    #     max_results: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.table_metadata_list #=> Array
+    #   resp.table_metadata_list[0].name #=> String
+    #   resp.table_metadata_list[0].create_time #=> Time
+    #   resp.table_metadata_list[0].last_access_time #=> Time
+    #   resp.table_metadata_list[0].table_type #=> String
+    #   resp.table_metadata_list[0].columns #=> Array
+    #   resp.table_metadata_list[0].columns[0].name #=> String
+    #   resp.table_metadata_list[0].columns[0].type #=> String
+    #   resp.table_metadata_list[0].columns[0].comment #=> String
+    #   resp.table_metadata_list[0].partition_keys #=> Array
+    #   resp.table_metadata_list[0].partition_keys[0].name #=> String
+    #   resp.table_metadata_list[0].partition_keys[0].type #=> String
+    #   resp.table_metadata_list[0].partition_keys[0].comment #=> String
+    #   resp.table_metadata_list[0].parameters #=> Hash
+    #   resp.table_metadata_list[0].parameters["KeyString"] #=> String
+    #   resp.next_token #=> String
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListTableMetadata AWS API Documentation
+    #
+    # @overload list_table_metadata(params = {})
+    # @param [Hash] params ({})
+    def list_table_metadata(params = {}, options = {})
+      req = build_request(:list_table_metadata, params)
+      req.send_request(options)
+    end
+
+    # Lists the tags associated with an Athena workgroup or data catalog
+    # resource.
     #
     # @option params [required, String] :resource_arn
-    #   Lists the tags for the workgroup resource with the specified ARN.
+    #   Lists the tags for the resource with the specified ARN.
     #
     # @option params [String] :next_token
     #   The token for the next set of results, or null if there are no
     #   additional results for this request, where the request lists the tags
-    #   for the workgroup resource with the specified ARN.
+    #   for the resource with the specified ARN.
     #
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per request that lists
-    #   the tags for the workgroup resource.
+    #   the tags for the resource.
     #
     # @return [Types::ListTagsForResourceOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListTagsForResourceOutput#tags #tags} => Array&lt;Types::Tag&gt;
     #   * {Types::ListTagsForResourceOutput#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_tags_for_resource({
@@ -896,7 +1345,10 @@ module Aws::Athena
     # Lists available workgroups for the account.
     #
     # @option params [String] :next_token
-    #   A token to be used by the next request if this request is truncated.
+    #   A token generated by the Athena service that specifies where to
+    #   continue pagination if a previous request was truncated. To obtain the
+    #   next set of pages, pass in the `NextToken` from the response object of
+    #   the previous page call.
     #
     # @option params [Integer] :max_results
     #   The maximum number of workgroups to return in this request.
@@ -906,6 +1358,8 @@ module Aws::Athena
     #   * {Types::ListWorkGroupsOutput#work_groups #work_groups} => Array&lt;Types::WorkGroupSummary&gt;
     #   * {Types::ListWorkGroupsOutput#next_token #next_token} => String
     #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_work_groups({
@@ -932,10 +1386,10 @@ module Aws::Athena
     end
 
     # Runs the SQL query statements contained in the `Query`. Requires you
-    # to have access to the workgroup in which the query ran.
-    #
-    # For code samples using the AWS SDK for Java, see [Examples and Code
-    # Samples][1] in the *Amazon Athena User Guide*.
+    # to have access to the workgroup in which the query ran. Running
+    # queries against an external catalog requires GetDataCatalog permission
+    # to the catalog. For code samples using the AWS SDK for Java, see
+    # [Examples and Code Samples][1] in the *Amazon Athena User Guide*.
     #
     #
     #
@@ -985,6 +1439,7 @@ module Aws::Athena
     #     client_request_token: "IdempotencyToken",
     #     query_execution_context: {
     #       database: "DatabaseString",
+    #       catalog: "CatalogNameString",
     #     },
     #     result_configuration: {
     #       output_location: "String",
@@ -1042,31 +1497,31 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Adds one or more tags to the resource, such as a workgroup. A tag is a
-    # label that you assign to an AWS Athena resource (a workgroup). Each
-    # tag consists of a key and an optional value, both of which you define.
-    # Tags enable you to categorize resources (workgroups) in Athena, for
-    # example, by purpose, owner, or environment. Use a consistent set of
-    # tag keys to make it easier to search and filter workgroups in your
-    # account. For best practices, see [AWS Tagging Strategies][1]. The key
-    # length is from 1 (minimum) to 128 (maximum) Unicode characters in
-    # UTF-8. The tag value length is from 0 (minimum) to 256 (maximum)
-    # Unicode characters in UTF-8. You can use letters and numbers
-    # representable in UTF-8, and the following characters: + - = . \_ : /
-    # @. Tag keys and values are case-sensitive. Tag keys must be unique per
-    # resource. If you specify more than one, separate them by commas.
+    # Adds one or more tags to an Athena resource. A tag is a label that you
+    # assign to a resource. In Athena, a resource can be a workgroup or data
+    # catalog. Each tag consists of a key and an optional value, both of
+    # which you define. For example, you can use tags to categorize Athena
+    # workgroups or data catalogs by purpose, owner, or environment. Use a
+    # consistent set of tag keys to make it easier to search and filter
+    # workgroups or data catalogs in your account. For best practices, see
+    # [Tagging Best Practices][1]. Tag keys can be from 1 to 128 UTF-8
+    # Unicode characters, and tag values can be from 0 to 256 UTF-8 Unicode
+    # characters. Tags can use letters and numbers representable in UTF-8,
+    # and the following characters: + - = . \_ : / @. Tag keys and values
+    # are case-sensitive. Tag keys must be unique per resource. If you
+    # specify more than one tag, separate them by commas.
     #
     #
     #
     # [1]: https://aws.amazon.com/answers/account-management/aws-tagging-strategies/
     #
     # @option params [required, String] :resource_arn
-    #   Requests that one or more tags are added to the resource (such as a
-    #   workgroup) for the specified ARN.
+    #   Specifies the ARN of the Athena resource (workgroup or data catalog)
+    #   to which tags are to be added.
     #
     # @option params [required, Array<Types::Tag>] :tags
-    #   One or more tags, separated by commas, to be added to the resource,
-    #   such as a workgroup.
+    #   A collection of one or more tags, separated by commas, to be added to
+    #   an Athena workgroup or data catalog resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1091,17 +1546,14 @@ module Aws::Athena
       req.send_request(options)
     end
 
-    # Removes one or more tags from the workgroup resource. Takes as an
-    # input a list of TagKey Strings separated by commas, and removes their
-    # tags at the same time.
+    # Removes one or more tags from a data catalog or workgroup resource.
     #
     # @option params [required, String] :resource_arn
-    #   Removes one or more tags from the workgroup resource for the specified
-    #   ARN.
+    #   Specifies the ARN of the resource from which tags are to be removed.
     #
     # @option params [required, Array<String>] :tag_keys
-    #   Removes the tags associated with one or more tag keys from the
-    #   workgroup resource.
+    #   A comma-separated list of one or more tag keys whose tags are to be
+    #   removed from the specified resource.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1121,6 +1573,72 @@ module Aws::Athena
       req.send_request(options)
     end
 
+    # Updates the data catalog that has the specified name.
+    #
+    # @option params [required, String] :name
+    #   The name of the data catalog to update. The catalog name must be
+    #   unique for the AWS account and can use a maximum of 128 alphanumeric,
+    #   underscore, at sign, or hyphen characters.
+    #
+    # @option params [required, String] :type
+    #   Specifies the type of data catalog to update. Specify `LAMBDA` for a
+    #   federated catalog, `GLUE` for AWS Glue Catalog, or `HIVE` for an
+    #   external hive metastore.
+    #
+    # @option params [String] :description
+    #   New or modified text that describes the data catalog.
+    #
+    # @option params [Hash<String,String>] :parameters
+    #   Specifies the Lambda function or functions to use for updating the
+    #   data catalog. This is a mapping whose values depend on the catalog
+    #   type.
+    #
+    #   * For the `HIVE` data catalog type, use the following syntax. The
+    #     `metadata-function` parameter is required. `The sdk-version`
+    #     parameter is optional and defaults to the currently supported
+    #     version.
+    #
+    #     `metadata-function=lambda_arn, sdk-version=version_number `
+    #
+    #   * For the `LAMBDA` data catalog type, use one of the following sets of
+    #     required parameters, but not both.
+    #
+    #     * If you have one Lambda function that processes metadata and
+    #       another for reading the actual data, use the following syntax.
+    #       Both parameters are required.
+    #
+    #       `metadata-function=lambda_arn, record-function=lambda_arn `
+    #
+    #     * If you have a composite Lambda function that processes both
+    #       metadata and data, use the following syntax to specify your Lambda
+    #       function.
+    #
+    #       `function=lambda_arn `
+    #
+    #   * The `GLUE` type has no parameters.
+    #
+    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.update_data_catalog({
+    #     name: "CatalogNameString", # required
+    #     type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE
+    #     description: "DescriptionString",
+    #     parameters: {
+    #       "KeyString" => "ParametersMapValue",
+    #     },
+    #   })
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/UpdateDataCatalog AWS API Documentation
+    #
+    # @overload update_data_catalog(params = {})
+    # @param [Hash] params ({})
+    def update_data_catalog(params = {}, options = {})
+      req = build_request(:update_data_catalog, params)
+      req.send_request(options)
+    end
+
     # Updates the workgroup with the specified name. The workgroup's name
     # cannot be changed.
     #
@@ -1185,7 +1703,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.22.0'
+      context[:gem_version] = '1.27.0'
       Seahorse::Client::Request.new(handlers, context)
     end