aws-sdk-athena 1.23.0 → 1.28.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: f14adc105f561e59b3ecd9fab081dff694332cfb
-  data.tar.gz: 121efae7d4c6081a9aea5e49eb118444d288e36e
+SHA256:
+  metadata.gz: b30fcef89aee5713975e53d3fd6b2be9588eb482d546427af543c5c1b4c67f28
+  data.tar.gz: 65ce28c2facf35d618807868a99e4b50e0607f42146bd66b2fb3b0270787dd1e
 SHA512:
-  metadata.gz: 1e3833516072c2a4823c4d5634ca58916b577c39995a49f30603e75ce1306074506756203ff21a30acb66a46eb1c394880ad957cf8c2c994c78f89cef6cab6ba
-  data.tar.gz: cfeb9f6a3b2e1155da49dd37d54e3202e6975cde7f64c2a6886f157297d51c534462b93c794187b481d59285a7ff68a07b2b802aabfb69a8fb7c2c0bdd44ce74
+  metadata.gz: aee7be84fdc4f9de832714640b16aa0b8b30d49c9f8b5fec88aa08d5e7dc62b0518a1424ca5e8d20d0b37361fc9ae09c95ffbc3ff2d89915298d48be4113530a
+  data.tar.gz: 3b238f06ab8ef9373e43829d079162dd49203dce8b7cd4fd4609f2e097ccc8442b93d29cee01432fc6fd3c464aa9453f1161ff4b478611747171458b0966f1d6

data/lib/aws-sdk-athena.rb

@@ -45,6 +45,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @service
 module Aws::Athena
 
-  GEM_VERSION = '1.23.0'
+  GEM_VERSION = '1.28.1'
 
 end

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

@@ -24,6 +24,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
 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/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
 
@@ -32,11 +33,11 @@ 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,
-  #     # ...
-  #   )
+  #     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).
@@ -69,6 +70,7 @@ module Aws::Athena
     add_plugin(Aws::Plugins::ClientMetricsPlugin)
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
+    add_plugin(Aws::Plugins::HttpChecksum)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::JsonRpc)
 
@@ -105,7 +107,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']`
@@ -161,7 +163,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 or custom 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
@@ -176,7 +178,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.
@@ -229,15 +231,19 @@ module Aws::Athena
     #
     #   @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.
+    #
+    #     * `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
     #
@@ -275,8 +281,7 @@ module Aws::Athena
     #
     #   @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 yielded 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 idle before it is
@@ -288,7 +293,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 yielded 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`.
@@ -395,6 +400,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
@@ -421,6 +427,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.
     #
@@ -509,8 +592,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}.
     #
@@ -549,6 +632,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.
     #
@@ -610,6 +715,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.
     #
@@ -671,6 +843,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
@@ -717,8 +890,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.
@@ -729,6 +904,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({
@@ -765,6 +942,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
@@ -803,8 +1030,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*.
@@ -814,21 +1131,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({
@@ -853,8 +1175,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*.
@@ -864,20 +1187,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({
@@ -901,25 +1230,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({
@@ -947,7 +1347,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.
@@ -957,6 +1360,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({
@@ -983,10 +1388,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*.
     #
     #
     #
@@ -1036,6 +1441,7 @@ module Aws::Athena
     #     client_request_token: "IdempotencyToken",
     #     query_execution_context: {
     #       database: "DatabaseString",
+    #       catalog: "CatalogNameString",
     #     },
     #     result_configuration: {
     #       output_location: "String",
@@ -1093,31 +1499,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}.
     #
@@ -1142,17 +1548,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}.
     #
@@ -1172,6 +1575,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.
     #
@@ -1236,7 +1705,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.23.0'
+      context[:gem_version] = '1.28.1'
       Seahorse::Client::Request.new(handlers, context)
     end