aws-sdk-athena 1.24.0 → 1.29.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 1824ce28dbe966d72d6fd47002ade72f49c92968
-  data.tar.gz: f4c217c7cf9aae82cd2482b8ded194302db600cf
+SHA256:
+  metadata.gz: 6ac822ee708f06b45d36f0efee5c66b7ff73b40693a83c41c2775086a59a65d4
+  data.tar.gz: 4a0e72384059410cf3a3d06c852854a675611d8f74aa6b84981c382d8f27a7a5
 SHA512:
-  metadata.gz: 48ba5521f94c615d81eba7d4fbc45eb8e20825c85e3ca42c697af66df83d991c10bfea3bfc9e7be21afbd6dbd9cd05b0c6028f760e81761450453ff6a3185bf6
-  data.tar.gz: 7dd8a08ece7d8d8f48af00e1695a095cd0ded2050febc3c4f792681f3e5f21da6705a56d3dec5430a5383ab19f436af533bef1276e35d9821e10e8738806f6f3
+  metadata.gz: 9e616b95e2c4a45d09f640be16cc2ea398724c79744d8f2a1c4ff8498106520c30f0411359f48b33cc996fa2cddfb9cf7fa99d9cd466ee5f0e7913e0df8fa071
+  data.tar.gz: 00262e1d5cc40cdb4a146f9aa9d1b1e3c740cd4d2e879c1236e8c57b49c259ad5c79a501946cfdd341769be0c907ddcd61f99f50af08f7fa8595952ef7233839

data/lib/aws-sdk-athena.rb

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -45,6 +47,6 @@ require_relative 'aws-sdk-athena/customizations'
 # @service
 module Aws::Athena
 
-  GEM_VERSION = '1.24.0'
+  GEM_VERSION = '1.29.0'
 
 end

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

@@ -1,3 +1,5 @@
+# frozen_string_literal: true
+
 # WARNING ABOUT GENERATED CODE
 #
 # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,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'
 
@@ -69,6 +72,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 +109,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 +165,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 +180,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.
@@ -279,8 +283,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
@@ -292,7 +295,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`.
@@ -399,6 +402,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
@@ -425,6 +429,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.
     #
@@ -513,8 +594,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}.
     #
@@ -553,6 +634,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.
     #
@@ -614,6 +717,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.
     #
@@ -675,6 +845,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
@@ -721,8 +892,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.
@@ -771,6 +944,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
@@ -809,10 +1032,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.
-    # If a workgroup is not specified, lists the saved queries for the
-    # primary 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*.
@@ -822,16 +1133,18 @@ 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 returned.
-    #   If a workgroup is not specified, the saved queries for the primary
-    #   workgroup are returned.
+    #   The name of the workgroup from which the named queries are being
+    #   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:
     #
@@ -876,14 +1189,16 @@ 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 returned. If a
+    #   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.
     #
@@ -917,25 +1232,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({
@@ -963,7 +1349,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.
@@ -1001,10 +1390,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*.
     #
     #
     #
@@ -1054,6 +1443,7 @@ module Aws::Athena
     #     client_request_token: "IdempotencyToken",
     #     query_execution_context: {
     #       database: "DatabaseString",
+    #       catalog: "CatalogNameString",
     #     },
     #     result_configuration: {
     #       output_location: "String",
@@ -1111,31 +1501,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}.
     #
@@ -1160,17 +1550,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}.
     #
@@ -1190,6 +1577,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.
     #
@@ -1254,7 +1707,7 @@ module Aws::Athena
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.24.0'
+      context[:gem_version] = '1.29.0'
       Seahorse::Client::Request.new(handlers, context)
     end