aws-sdk-athena 1.96.0 → 1.98.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7afd64f856a052af9caa3a5cb384faaa89bfae40c5a0d8a697b3c2ee640ed82c
-  data.tar.gz: 8475b8f4f0b64b028d3f75827f57e7881ca3662be09d7f89f025c187a4f1f7c8
+  metadata.gz: 28317f113247b9f9eca9a4c9695953ef1b58dfc2a4179e92150beb2bd947f7ae
+  data.tar.gz: 32013c19dd31d37dd8ab90133b963d7a291b4c812d8ce107dbf3c283f4d7da00
 SHA512:
-  metadata.gz: 04a642069675e199e6ecd1d4e3b488be69ef2ddf51a9624ca2e5a9b8cfff8c07d8e357de38cc5388861eaa1af40c9e2bf70616f5c8c53806b56ebbaf90b8aff0
-  data.tar.gz: 3dd23aef5501a04efa28ca8831135a8a7b08645f9412145f5aca96b8e41c243eb753bb71fe8b3668d50c0700a339cabf362b49c710d082f915ec18ce631b6056
+  metadata.gz: 35d56dbad7b2fdfcf3fc1ae8f6f08590bc8c6b6a8144e09fa32b05c0f69a4954f6eb54ac3b54bad8e135125bfa3544b120629ea8f05d64653dcb6b1afecda2e5
+  data.tar.gz: 52a32276c83d71a47fb6b537be5de56bd416b579f8c937605e4c26ce6cbeaba842c60d40c5b813e2467242c92df5379a18353f25930da3627c4f2bf94050dfad

data/CHANGELOG.md

@@ -1,10 +1,20 @@
 Unreleased Changes
 ------------------
 
+1.98.0 (2024-12-03)
+------------------
+
+* Feature - Add FEDERATED type to CreateDataCatalog. This creates Athena Data Catalog, AWS Lambda connector, and AWS Glue connection. Create/DeleteDataCatalog returns DataCatalog. Add Status, ConnectionType, and Error to DataCatalog and DataCatalogSummary. Add DeleteCatalogOnly to delete Athena Catalog only.
+
+1.97.0 (2024-11-18)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.96.0 (2024-10-18)
 ------------------
 
-* Feature - Removing FEDERATED from Create/List/Delete/GetDataCatalog API
+* Feature - Remove DataCatalog from Create/DeleteDataCatalog. Remove Status, ConnectionType, and Error from DataCatalog and DataCatalogSummary. These were released inadvertently with no functionality. They were not populated or populated with a default value. Code related to these changes can be safely removed.
 
 1.95.0 (2024-09-24)
 ------------------

data/VERSION

@@ -1 +1 @@
-1.96.0
+1.98.0

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

@@ -692,6 +692,20 @@ module Aws::Athena
     # properties. Catalogs created are visible to all users of the same
     # Amazon Web Services account.
     #
+    # This API operation creates the following resources.
+    #
+    # * CFN Stack Name with a maximum length of 128 characters and prefix
+    #   `athenafederatedcatalog-CATALOG_NAME_SANITIZED` with length 23
+    #   characters.
+    #
+    # * Lambda Function Name with a maximum length of 64 characters and
+    #   prefix `athenafederatedcatalog_CATALOG_NAME_SANITIZED` with length
+    #   23 characters.
+    #
+    # * Glue Connection Name with a maximum length of 255 characters and a
+    #   prefix `athenafederatedcatalog_CATALOG_NAME_SANITIZED` with length
+    #   23 characters.
+    #
     # @option params [required, String] :name
     #   The name of the data catalog to create. The catalog name must be
     #   unique for the Amazon Web Services account and can use a maximum of
@@ -699,10 +713,25 @@ module Aws::Athena
     #   remainder of the length constraint of 256 is reserved for use by
     #   Athena.
     #
+    #   For `FEDERATED` type the catalog name has following considerations and
+    #   limits:
+    #
+    #   * The catalog name allows special characters such as `_ , @ , \ , - `.
+    #     These characters are replaced with a hyphen (-) when creating the
+    #     CFN Stack Name and with an underscore (\_) when creating the Lambda
+    #     Function and Glue Connection Name.
+    #
+    #   * The catalog name has a theoretical limit of 128 characters. However,
+    #     since we use it to create other resources that allow less characters
+    #     and we prepend a prefix to it, the actual catalog name limit for
+    #     `FEDERATED` catalog is 64 - 23 = 41 characters.
+    #
     # @option params [required, String] :type
     #   The type of data catalog to create: `LAMBDA` for a federated catalog,
-    #   `HIVE` for an external hive metastore, or `GLUE` for an Glue Data
-    #   Catalog.
+    #   `GLUE` for an Glue Data Catalog, and `HIVE` for an external Apache
+    #   Hive metastore. `FEDERATED` is a federated catalog for which Athena
+    #   creates the connection and the Lambda function for you based on the
+    #   parameters that you pass.
     #
     # @option params [String] :description
     #   A description of the data catalog to be created.
@@ -733,7 +762,6 @@ module Aws::Athena
     #       function.
     #
     #       `function=lambda_arn `
-    #
     #   * The `GLUE` type takes a catalog ID parameter and is required. The `
     #     catalog_id ` is the account ID of the Amazon Web Services account to
     #     which the Glue Data Catalog belongs.
@@ -745,18 +773,41 @@ module Aws::Athena
     #       can have only one and cannot modify.
     #
     #     ^
+    #   * The `FEDERATED` data catalog type uses one of the following
+    #     parameters, but not both. Use `connection-arn` for an existing Glue
+    #     connection. Use `connection-type` and `connection-properties` to
+    #     specify the configuration setting for a new connection.
+    #
+    #     * `connection-arn:<glue_connection_arn_to_reuse> `
+    #
+    #     * `lambda-role-arn` (optional): The execution role to use for the
+    #       Lambda function. If not provided, one is created.
+    #
+    #     * `connection-type:MYSQL|REDSHIFT|....,
+    #       connection-properties:"<json_string>"`
+    #
+    #       For <i> <code>&lt;json_string&gt;</code> </i>, use escaped JSON
+    #       text, as in the following example.
+    #
+    #       `"{"spill_bucket":"my_spill","spill_prefix":"athena-spill","host":"abc12345.snowflakecomputing.com","port":"1234","warehouse":"DEV_WH","database":"TEST","schema":"PUBLIC","SecretArn":"arn:aws:secretsmanager:ap-south-1:111122223333:secret:snowflake-XHb67j"}"`
     #
     # @option params [Array<Types::Tag>] :tags
     #   A list of comma separated tags to add to the data catalog that is
-    #   created.
+    #   created. All the resources that are created by the `CreateDataCatalog`
+    #   API operation with `FEDERATED` type will have the tag
+    #   `federated_athena_datacatalog="true"`. This includes the CFN Stack,
+    #   Glue Connection, Athena DataCatalog, and all the resources created as
+    #   part of the CFN Stack (Lambda Function, IAM policies/roles).
     #
-    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    # @return [Types::CreateDataCatalogOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreateDataCatalogOutput#data_catalog #data_catalog} => Types::DataCatalog
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.create_data_catalog({
     #     name: "CatalogNameString", # required
-    #     type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE
+    #     type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE, FEDERATED
     #     description: "DescriptionString",
     #     parameters: {
     #       "KeyString" => "ParametersMapValue",
@@ -769,6 +820,17 @@ module Aws::Athena
     #     ],
     #   })
     #
+    # @example Response structure
+    #
+    #   resp.data_catalog.name #=> String
+    #   resp.data_catalog.description #=> String
+    #   resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
+    #   resp.data_catalog.parameters #=> Hash
+    #   resp.data_catalog.parameters["KeyString"] #=> String
+    #   resp.data_catalog.status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "CREATE_FAILED", "CREATE_FAILED_CLEANUP_IN_PROGRESS", "CREATE_FAILED_CLEANUP_COMPLETE", "CREATE_FAILED_CLEANUP_FAILED", "DELETE_IN_PROGRESS", "DELETE_COMPLETE", "DELETE_FAILED"
+    #   resp.data_catalog.connection_type #=> String, one of "DYNAMODB", "MYSQL", "POSTGRESQL", "REDSHIFT", "ORACLE", "SYNAPSE", "SQLSERVER", "DB2", "OPENSEARCH", "BIGQUERY", "GOOGLECLOUDSTORAGE", "HBASE", "DOCUMENTDB", "CMDB", "TPCDS", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "DATALAKEGEN2", "DB2AS400"
+    #   resp.data_catalog.error #=> String
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateDataCatalog AWS API Documentation
     #
     # @overload create_data_catalog(params = {})
@@ -1078,14 +1140,34 @@ module Aws::Athena
     # @option params [required, String] :name
     #   The name of the data catalog to delete.
     #
-    # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
+    # @option params [Boolean] :delete_catalog_only
+    #   Deletes the Athena Data Catalog. You can only use this with the
+    #   `FEDERATED` catalogs. You usually perform this before registering the
+    #   connector with Glue Data Catalog. After deletion, you will have to
+    #   manage the Glue Connection and Lambda function.
+    #
+    # @return [Types::DeleteDataCatalogOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DeleteDataCatalogOutput#data_catalog #data_catalog} => Types::DataCatalog
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.delete_data_catalog({
     #     name: "CatalogNameString", # required
+    #     delete_catalog_only: false,
     #   })
     #
+    # @example Response structure
+    #
+    #   resp.data_catalog.name #=> String
+    #   resp.data_catalog.description #=> String
+    #   resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
+    #   resp.data_catalog.parameters #=> Hash
+    #   resp.data_catalog.parameters["KeyString"] #=> String
+    #   resp.data_catalog.status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "CREATE_FAILED", "CREATE_FAILED_CLEANUP_IN_PROGRESS", "CREATE_FAILED_CLEANUP_COMPLETE", "CREATE_FAILED_CLEANUP_FAILED", "DELETE_IN_PROGRESS", "DELETE_COMPLETE", "DELETE_FAILED"
+    #   resp.data_catalog.connection_type #=> String, one of "DYNAMODB", "MYSQL", "POSTGRESQL", "REDSHIFT", "ORACLE", "SYNAPSE", "SQLSERVER", "DB2", "OPENSEARCH", "BIGQUERY", "GOOGLECLOUDSTORAGE", "HBASE", "DOCUMENTDB", "CMDB", "TPCDS", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "DATALAKEGEN2", "DB2AS400"
+    #   resp.data_catalog.error #=> String
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteDataCatalog AWS API Documentation
     #
     # @overload delete_data_catalog(params = {})
@@ -1437,9 +1519,12 @@ module Aws::Athena
     #
     #   resp.data_catalog.name #=> String
     #   resp.data_catalog.description #=> String
-    #   resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE"
+    #   resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
     #   resp.data_catalog.parameters #=> Hash
     #   resp.data_catalog.parameters["KeyString"] #=> String
+    #   resp.data_catalog.status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "CREATE_FAILED", "CREATE_FAILED_CLEANUP_IN_PROGRESS", "CREATE_FAILED_CLEANUP_COMPLETE", "CREATE_FAILED_CLEANUP_FAILED", "DELETE_IN_PROGRESS", "DELETE_COMPLETE", "DELETE_FAILED"
+    #   resp.data_catalog.connection_type #=> String, one of "DYNAMODB", "MYSQL", "POSTGRESQL", "REDSHIFT", "ORACLE", "SYNAPSE", "SQLSERVER", "DB2", "OPENSEARCH", "BIGQUERY", "GOOGLECLOUDSTORAGE", "HBASE", "DOCUMENTDB", "CMDB", "TPCDS", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "DATALAKEGEN2", "DB2AS400"
+    #   resp.data_catalog.error #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetDataCatalog AWS API Documentation
     #
@@ -2266,7 +2351,10 @@ module Aws::Athena
     #
     #   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.data_catalogs_summary[0].type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
+    #   resp.data_catalogs_summary[0].status #=> String, one of "CREATE_IN_PROGRESS", "CREATE_COMPLETE", "CREATE_FAILED", "CREATE_FAILED_CLEANUP_IN_PROGRESS", "CREATE_FAILED_CLEANUP_COMPLETE", "CREATE_FAILED_CLEANUP_FAILED", "DELETE_IN_PROGRESS", "DELETE_COMPLETE", "DELETE_FAILED"
+    #   resp.data_catalogs_summary[0].connection_type #=> String, one of "DYNAMODB", "MYSQL", "POSTGRESQL", "REDSHIFT", "ORACLE", "SYNAPSE", "SQLSERVER", "DB2", "OPENSEARCH", "BIGQUERY", "GOOGLECLOUDSTORAGE", "HBASE", "DOCUMENTDB", "CMDB", "TPCDS", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "DATALAKEGEN2", "DB2AS400"
+    #   resp.data_catalogs_summary[0].error #=> String
     #   resp.next_token #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListDataCatalogs AWS API Documentation
@@ -3463,7 +3551,7 @@ module Aws::Athena
     #
     #   resp = client.update_data_catalog({
     #     name: "CatalogNameString", # required
-    #     type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE
+    #     type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE, FEDERATED
     #     description: "DescriptionString",
     #     parameters: {
     #       "KeyString" => "ParametersMapValue",
@@ -3721,7 +3809,7 @@ module Aws::Athena
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.96.0'
+      context[:gem_version] = '1.98.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -62,6 +62,7 @@ module Aws::Athena
     ColumnList = Shapes::ListShape.new(name: 'ColumnList')
     ColumnNullable = Shapes::StringShape.new(name: 'ColumnNullable')
     CommentString = Shapes::StringShape.new(name: 'CommentString')
+    ConnectionType = Shapes::StringShape.new(name: 'ConnectionType')
     CoordinatorDpuSize = Shapes::IntegerShape.new(name: 'CoordinatorDpuSize')
     CreateCapacityReservationInput = Shapes::StructureShape.new(name: 'CreateCapacityReservationInput')
     CreateCapacityReservationOutput = Shapes::StructureShape.new(name: 'CreateCapacityReservationOutput')
@@ -79,6 +80,7 @@ module Aws::Athena
     CreateWorkGroupOutput = Shapes::StructureShape.new(name: 'CreateWorkGroupOutput')
     CustomerContentEncryptionConfiguration = Shapes::StructureShape.new(name: 'CustomerContentEncryptionConfiguration')
     DataCatalog = Shapes::StructureShape.new(name: 'DataCatalog')
+    DataCatalogStatus = Shapes::StringShape.new(name: 'DataCatalogStatus')
     DataCatalogSummary = Shapes::StructureShape.new(name: 'DataCatalogSummary')
     DataCatalogSummaryList = Shapes::ListShape.new(name: 'DataCatalogSummaryList')
     DataCatalogType = Shapes::StringShape.new(name: 'DataCatalogType')
@@ -477,6 +479,7 @@ module Aws::Athena
     CreateDataCatalogInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
     CreateDataCatalogInput.struct_class = Types::CreateDataCatalogInput
 
+    CreateDataCatalogOutput.add_member(:data_catalog, Shapes::ShapeRef.new(shape: DataCatalog, location_name: "DataCatalog"))
     CreateDataCatalogOutput.struct_class = Types::CreateDataCatalogOutput
 
     CreateNamedQueryInput.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
@@ -529,10 +532,16 @@ module Aws::Athena
     DataCatalog.add_member(:description, Shapes::ShapeRef.new(shape: DescriptionString, location_name: "Description"))
     DataCatalog.add_member(:type, Shapes::ShapeRef.new(shape: DataCatalogType, required: true, location_name: "Type"))
     DataCatalog.add_member(:parameters, Shapes::ShapeRef.new(shape: ParametersMap, location_name: "Parameters"))
+    DataCatalog.add_member(:status, Shapes::ShapeRef.new(shape: DataCatalogStatus, location_name: "Status"))
+    DataCatalog.add_member(:connection_type, Shapes::ShapeRef.new(shape: ConnectionType, location_name: "ConnectionType"))
+    DataCatalog.add_member(:error, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Error"))
     DataCatalog.struct_class = Types::DataCatalog
 
     DataCatalogSummary.add_member(:catalog_name, Shapes::ShapeRef.new(shape: CatalogNameString, location_name: "CatalogName"))
     DataCatalogSummary.add_member(:type, Shapes::ShapeRef.new(shape: DataCatalogType, location_name: "Type"))
+    DataCatalogSummary.add_member(:status, Shapes::ShapeRef.new(shape: DataCatalogStatus, location_name: "Status"))
+    DataCatalogSummary.add_member(:connection_type, Shapes::ShapeRef.new(shape: ConnectionType, location_name: "ConnectionType"))
+    DataCatalogSummary.add_member(:error, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Error"))
     DataCatalogSummary.struct_class = Types::DataCatalogSummary
 
     DataCatalogSummaryList.member = Shapes::ShapeRef.new(shape: DataCatalogSummary)
@@ -553,8 +562,10 @@ module Aws::Athena
     DeleteCapacityReservationOutput.struct_class = Types::DeleteCapacityReservationOutput
 
     DeleteDataCatalogInput.add_member(:name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "Name"))
+    DeleteDataCatalogInput.add_member(:delete_catalog_only, Shapes::ShapeRef.new(shape: Boolean, location_name: "DeleteCatalogOnly"))
     DeleteDataCatalogInput.struct_class = Types::DeleteDataCatalogInput
 
+    DeleteDataCatalogOutput.add_member(:data_catalog, Shapes::ShapeRef.new(shape: DataCatalog, location_name: "DataCatalog"))
     DeleteDataCatalogOutput.struct_class = Types::DeleteDataCatalogOutput
 
     DeleteNamedQueryInput.add_member(:named_query_id, Shapes::ShapeRef.new(shape: NamedQueryId, required: true, location_name: "NamedQueryId", metadata: {"idempotencyToken"=>true}))

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

@@ -601,12 +601,27 @@ module Aws::Athena
     #   127 alphanumeric, underscore, at sign, or hyphen characters. The
     #   remainder of the length constraint of 256 is reserved for use by
     #   Athena.
+    #
+    #   For `FEDERATED` type the catalog name has following considerations
+    #   and limits:
+    #
+    #   * The catalog name allows special characters such as `_ , @ , \ , -
+    #     `. These characters are replaced with a hyphen (-) when creating
+    #     the CFN Stack Name and with an underscore (\_) when creating the
+    #     Lambda Function and Glue Connection Name.
+    #
+    #   * The catalog name has a theoretical limit of 128 characters.
+    #     However, since we use it to create other resources that allow less
+    #     characters and we prepend a prefix to it, the actual catalog name
+    #     limit for `FEDERATED` catalog is 64 - 23 = 41 characters.
     #   @return [String]
     #
     # @!attribute [rw] type
     #   The type of data catalog to create: `LAMBDA` for a federated
-    #   catalog, `HIVE` for an external hive metastore, or `GLUE` for an
-    #   Glue Data Catalog.
+    #   catalog, `GLUE` for an Glue Data Catalog, and `HIVE` for an external
+    #   Apache Hive metastore. `FEDERATED` is a federated catalog for which
+    #   Athena creates the connection and the Lambda function for you based
+    #   on the parameters that you pass.
     #   @return [String]
     #
     # @!attribute [rw] description
@@ -639,7 +654,6 @@ module Aws::Athena
     #       Lambda function.
     #
     #       `function=lambda_arn `
-    #
     #   * The `GLUE` type takes a catalog ID parameter and is required. The
     #     ` catalog_id ` is the account ID of the Amazon Web Services
     #     account to which the Glue Data Catalog belongs.
@@ -651,11 +665,33 @@ module Aws::Athena
     #       you can have only one and cannot modify.
     #
     #     ^
+    #   * The `FEDERATED` data catalog type uses one of the following
+    #     parameters, but not both. Use `connection-arn` for an existing
+    #     Glue connection. Use `connection-type` and `connection-properties`
+    #     to specify the configuration setting for a new connection.
+    #
+    #     * `connection-arn:<glue_connection_arn_to_reuse> `
+    #
+    #     * `lambda-role-arn` (optional): The execution role to use for the
+    #       Lambda function. If not provided, one is created.
+    #
+    #     * `connection-type:MYSQL|REDSHIFT|....,
+    #       connection-properties:"<json_string>"`
+    #
+    #       For <i> <code>&lt;json_string&gt;</code> </i>, use escaped JSON
+    #       text, as in the following example.
+    #
+    #       `"{"spill_bucket":"my_spill","spill_prefix":"athena-spill","host":"abc12345.snowflakecomputing.com","port":"1234","warehouse":"DEV_WH","database":"TEST","schema":"PUBLIC","SecretArn":"arn:aws:secretsmanager:ap-south-1:111122223333:secret:snowflake-XHb67j"}"`
     #   @return [Hash<String,String>]
     #
     # @!attribute [rw] tags
     #   A list of comma separated tags to add to the data catalog that is
-    #   created.
+    #   created. All the resources that are created by the
+    #   `CreateDataCatalog` API operation with `FEDERATED` type will have
+    #   the tag `federated_athena_datacatalog="true"`. This includes the CFN
+    #   Stack, Glue Connection, Athena DataCatalog, and all the resources
+    #   created as part of the CFN Stack (Lambda Function, IAM
+    #   policies/roles).
     #   @return [Array<Types::Tag>]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateDataCatalogInput AWS API Documentation
@@ -670,9 +706,23 @@ module Aws::Athena
       include Aws::Structure
     end
 
+    # @!attribute [rw] data_catalog
+    #   Contains information about a data catalog in an Amazon Web Services
+    #   account.
+    #
+    #   <note markdown="1"> In the Athena console, data catalogs are listed as "data sources"
+    #   on the **Data sources** page under the **Data source name** column.
+    #
+    #    </note>
+    #   @return [Types::DataCatalog]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateDataCatalogOutput AWS API Documentation
     #
-    class CreateDataCatalogOutput < Aws::EmptyStructure; end
+    class CreateDataCatalogOutput < Struct.new(
+      :data_catalog)
+      SENSITIVE = []
+      include Aws::Structure
+    end
 
     # @!attribute [rw] name
     #   The query name.
@@ -927,8 +977,10 @@ module Aws::Athena
     #
     # @!attribute [rw] type
     #   The type of data catalog to create: `LAMBDA` for a federated
-    #   catalog, `HIVE` for an external hive metastore, or `GLUE` for an
-    #   Glue Data Catalog.
+    #   catalog, `GLUE` for an Glue Data Catalog, and `HIVE` for an external
+    #   Apache Hive metastore. `FEDERATED` is a federated catalog for which
+    #   Athena creates the connection and the Lambda function for you based
+    #   on the parameters that you pass.
     #   @return [String]
     #
     # @!attribute [rw] parameters
@@ -956,7 +1008,6 @@ module Aws::Athena
     #       Lambda function.
     #
     #       `function=lambda_arn `
-    #
     #   * The `GLUE` type takes a catalog ID parameter and is required. The
     #     ` catalog_id ` is the account ID of the Amazon Web Services
     #     account to which the Glue catalog belongs.
@@ -968,15 +1019,82 @@ module Aws::Athena
     #       you can have only one and cannot modify.
     #
     #     ^
+    #   * The `FEDERATED` data catalog type uses one of the following
+    #     parameters, but not both. Use `connection-arn` for an existing
+    #     Glue connection. Use `connection-type` and `connection-properties`
+    #     to specify the configuration setting for a new connection.
+    #
+    #     * `connection-arn:<glue_connection_arn_to_reuse> `
+    #
+    #     * `connection-type:MYSQL|REDSHIFT|....,
+    #       connection-properties:"<json_string>"`
+    #
+    #       For <i> <code>&lt;json_string&gt;</code> </i>, use escaped JSON
+    #       text, as in the following example.
+    #
+    #       `"{"spill_bucket":"my_spill","spill_prefix":"athena-spill","host":"abc12345.snowflakecomputing.com","port":"1234","warehouse":"DEV_WH","database":"TEST","schema":"PUBLIC","SecretArn":"arn:aws:secretsmanager:ap-south-1:111122223333:secret:snowflake-XHb67j"}"`
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] status
+    #   The status of the creation or deletion of the data catalog.
+    #
+    #   * The `LAMBDA`, `GLUE`, and `HIVE` data catalog types are created
+    #     synchronously. Their status is either `CREATE_COMPLETE` or
+    #     `CREATE_FAILED`.
+    #
+    #   * The `FEDERATED` data catalog type is created asynchronously.
+    #
+    #   Data catalog creation status:
+    #
+    #   * `CREATE_IN_PROGRESS`: Federated data catalog creation in progress.
+    #
+    #   * `CREATE_COMPLETE`: Data catalog creation complete.
+    #
+    #   * `CREATE_FAILED`: Data catalog could not be created.
+    #
+    #   * `CREATE_FAILED_CLEANUP_IN_PROGRESS`: Federated data catalog
+    #     creation failed and is being removed.
+    #
+    #   * `CREATE_FAILED_CLEANUP_COMPLETE`: Federated data catalog creation
+    #     failed and was removed.
+    #
+    #   * `CREATE_FAILED_CLEANUP_FAILED`: Federated data catalog creation
+    #     failed but could not be removed.
+    #
+    #   Data catalog deletion status:
+    #
+    #   * `DELETE_IN_PROGRESS`: Federated data catalog deletion in progress.
+    #
+    #   * `DELETE_COMPLETE`: Federated data catalog deleted.
+    #
+    #   * `DELETE_FAILED`: Federated data catalog could not be deleted.
+    #   @return [String]
+    #
+    # @!attribute [rw] connection_type
+    #   The type of connection for a `FEDERATED` data catalog (for example,
+    #   `REDSHIFT`, `MYSQL`, or `SQLSERVER`). For information about
+    #   individual connectors, see [Available data source connectors][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/connectors-available.html
+    #   @return [String]
+    #
+    # @!attribute [rw] error
+    #   Text of the error that occurred during data catalog creation or
+    #   deletion.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DataCatalog AWS API Documentation
     #
     class DataCatalog < Struct.new(
       :name,
       :description,
       :type,
-      :parameters)
+      :parameters,
+      :status,
+      :connection_type,
+      :error)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -996,11 +1114,64 @@ module Aws::Athena
     #   The data catalog type.
     #   @return [String]
     #
+    # @!attribute [rw] status
+    #   The status of the creation or deletion of the data catalog.
+    #
+    #   * The `LAMBDA`, `GLUE`, and `HIVE` data catalog types are created
+    #     synchronously. Their status is either `CREATE_COMPLETE` or
+    #     `CREATE_FAILED`.
+    #
+    #   * The `FEDERATED` data catalog type is created asynchronously.
+    #
+    #   Data catalog creation status:
+    #
+    #   * `CREATE_IN_PROGRESS`: Federated data catalog creation in progress.
+    #
+    #   * `CREATE_COMPLETE`: Data catalog creation complete.
+    #
+    #   * `CREATE_FAILED`: Data catalog could not be created.
+    #
+    #   * `CREATE_FAILED_CLEANUP_IN_PROGRESS`: Federated data catalog
+    #     creation failed and is being removed.
+    #
+    #   * `CREATE_FAILED_CLEANUP_COMPLETE`: Federated data catalog creation
+    #     failed and was removed.
+    #
+    #   * `CREATE_FAILED_CLEANUP_FAILED`: Federated data catalog creation
+    #     failed but could not be removed.
+    #
+    #   Data catalog deletion status:
+    #
+    #   * `DELETE_IN_PROGRESS`: Federated data catalog deletion in progress.
+    #
+    #   * `DELETE_COMPLETE`: Federated data catalog deleted.
+    #
+    #   * `DELETE_FAILED`: Federated data catalog could not be deleted.
+    #   @return [String]
+    #
+    # @!attribute [rw] connection_type
+    #   The type of connection for a `FEDERATED` data catalog (for example,
+    #   `REDSHIFT`, `MYSQL`, or `SQLSERVER`). For information about
+    #   individual connectors, see [Available data source connectors][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/athena/latest/ug/connectors-available.html
+    #   @return [String]
+    #
+    # @!attribute [rw] error
+    #   Text of the error that occurred during data catalog creation or
+    #   deletion.
+    #   @return [String]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DataCatalogSummary AWS API Documentation
     #
     class DataCatalogSummary < Struct.new(
       :catalog_name,
-      :type)
+      :type,
+      :status,
+      :connection_type,
+      :error)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1063,17 +1234,39 @@ module Aws::Athena
     #   The name of the data catalog to delete.
     #   @return [String]
     #
+    # @!attribute [rw] delete_catalog_only
+    #   Deletes the Athena Data Catalog. You can only use this with the
+    #   `FEDERATED` catalogs. You usually perform this before registering
+    #   the connector with Glue Data Catalog. After deletion, you will have
+    #   to manage the Glue Connection and Lambda function.
+    #   @return [Boolean]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteDataCatalogInput AWS API Documentation
     #
     class DeleteDataCatalogInput < Struct.new(
-      :name)
+      :name,
+      :delete_catalog_only)
       SENSITIVE = []
       include Aws::Structure
     end
 
+    # @!attribute [rw] data_catalog
+    #   Contains information about a data catalog in an Amazon Web Services
+    #   account.
+    #
+    #   <note markdown="1"> In the Athena console, data catalogs are listed as "data sources"
+    #   on the **Data sources** page under the **Data source name** column.
+    #
+    #    </note>
+    #   @return [Types::DataCatalog]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteDataCatalogOutput AWS API Documentation
     #
-    class DeleteDataCatalogOutput < Aws::EmptyStructure; end
+    class DeleteDataCatalogOutput < Struct.new(
+      :data_catalog)
+      SENSITIVE = []
+      include Aws::Structure
+    end
 
     # @!attribute [rw] named_query_id
     #   The unique ID of the query to delete.

data/lib/aws-sdk-athena.rb

@@ -54,7 +54,7 @@ module Aws::Athena
   autoload :EndpointProvider, 'aws-sdk-athena/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-athena/endpoints'
 
-  GEM_VERSION = '1.96.0'
+  GEM_VERSION = '1.98.0'
 
 end
 

data/sig/client.rbs

@@ -137,11 +137,12 @@ module Aws
 
       interface _CreateDataCatalogResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::CreateDataCatalogOutput]
+        def data_catalog: () -> Types::DataCatalog
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Athena/Client.html#create_data_catalog-instance_method
       def create_data_catalog: (
                                  name: ::String,
-                                 type: ("LAMBDA" | "GLUE" | "HIVE"),
+                                 type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED"),
                                  ?description: ::String,
                                  ?parameters: Hash[::String, ::String],
                                  ?tags: Array[
@@ -267,10 +268,12 @@ module Aws
 
       interface _DeleteDataCatalogResponseSuccess
         include ::Seahorse::Client::_ResponseSuccess[Types::DeleteDataCatalogOutput]
+        def data_catalog: () -> Types::DataCatalog
       end
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Athena/Client.html#delete_data_catalog-instance_method
       def delete_data_catalog: (
-                                 name: ::String
+                                 name: ::String,
+                                 ?delete_catalog_only: bool
                                ) -> _DeleteDataCatalogResponseSuccess
                              | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _DeleteDataCatalogResponseSuccess
 
@@ -907,7 +910,7 @@ module Aws
       # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Athena/Client.html#update_data_catalog-instance_method
       def update_data_catalog: (
                                  name: ::String,
-                                 type: ("LAMBDA" | "GLUE" | "HIVE"),
+                                 type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED"),
                                  ?description: ::String,
                                  ?parameters: Hash[::String, ::String]
                                ) -> _UpdateDataCatalogResponseSuccess

data/sig/types.rbs

@@ -166,14 +166,16 @@ module Aws::Athena
 
     class CreateDataCatalogInput
       attr_accessor name: ::String
-      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
+      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
       attr_accessor description: ::String
       attr_accessor parameters: ::Hash[::String, ::String]
       attr_accessor tags: ::Array[Types::Tag]
       SENSITIVE: []
     end
 
-    class CreateDataCatalogOutput < Aws::EmptyStructure
+    class CreateDataCatalogOutput
+      attr_accessor data_catalog: Types::DataCatalog
+      SENSITIVE: []
     end
 
     class CreateNamedQueryInput
@@ -245,14 +247,20 @@ module Aws::Athena
     class DataCatalog
       attr_accessor name: ::String
       attr_accessor description: ::String
-      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
+      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
       attr_accessor parameters: ::Hash[::String, ::String]
+      attr_accessor status: ("CREATE_IN_PROGRESS" | "CREATE_COMPLETE" | "CREATE_FAILED" | "CREATE_FAILED_CLEANUP_IN_PROGRESS" | "CREATE_FAILED_CLEANUP_COMPLETE" | "CREATE_FAILED_CLEANUP_FAILED" | "DELETE_IN_PROGRESS" | "DELETE_COMPLETE" | "DELETE_FAILED")
+      attr_accessor connection_type: ("DYNAMODB" | "MYSQL" | "POSTGRESQL" | "REDSHIFT" | "ORACLE" | "SYNAPSE" | "SQLSERVER" | "DB2" | "OPENSEARCH" | "BIGQUERY" | "GOOGLECLOUDSTORAGE" | "HBASE" | "DOCUMENTDB" | "CMDB" | "TPCDS" | "TIMESTREAM" | "SAPHANA" | "SNOWFLAKE" | "DATALAKEGEN2" | "DB2AS400")
+      attr_accessor error: ::String
       SENSITIVE: []
     end
 
     class DataCatalogSummary
       attr_accessor catalog_name: ::String
-      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
+      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
+      attr_accessor status: ("CREATE_IN_PROGRESS" | "CREATE_COMPLETE" | "CREATE_FAILED" | "CREATE_FAILED_CLEANUP_IN_PROGRESS" | "CREATE_FAILED_CLEANUP_COMPLETE" | "CREATE_FAILED_CLEANUP_FAILED" | "DELETE_IN_PROGRESS" | "DELETE_COMPLETE" | "DELETE_FAILED")
+      attr_accessor connection_type: ("DYNAMODB" | "MYSQL" | "POSTGRESQL" | "REDSHIFT" | "ORACLE" | "SYNAPSE" | "SQLSERVER" | "DB2" | "OPENSEARCH" | "BIGQUERY" | "GOOGLECLOUDSTORAGE" | "HBASE" | "DOCUMENTDB" | "CMDB" | "TPCDS" | "TIMESTREAM" | "SAPHANA" | "SNOWFLAKE" | "DATALAKEGEN2" | "DB2AS400")
+      attr_accessor error: ::String
       SENSITIVE: []
     end
 
@@ -278,10 +286,13 @@ module Aws::Athena
 
     class DeleteDataCatalogInput
       attr_accessor name: ::String
+      attr_accessor delete_catalog_only: bool
       SENSITIVE: []
     end
 
-    class DeleteDataCatalogOutput < Aws::EmptyStructure
+    class DeleteDataCatalogOutput
+      attr_accessor data_catalog: Types::DataCatalog
+      SENSITIVE: []
     end
 
     class DeleteNamedQueryInput
@@ -1203,7 +1214,7 @@ module Aws::Athena
 
     class UpdateDataCatalogInput
       attr_accessor name: ::String
-      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
+      attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
       attr_accessor description: ::String
       attr_accessor parameters: ::Hash[::String, ::String]
       SENSITIVE: []

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-athena
 version: !ruby/object:Gem::Version
-  version: 1.96.0
+  version: 1.98.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-10-18 00:00:00.000000000 Z
+date: 2024-12-03 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core