aws-sdk-athena 1.93.0 → 1.94.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5084dd6805936dae6e17bf6a525c91405a504b205e437fe77fe8d7e44057fad1
-  data.tar.gz: 5347c3ee3e664272ee61c853101441b252dbb34872ea4576dae0c05878482772
+  metadata.gz: 257884728a6133895d44dcd51f36bea569bb2cd941337c24ecfdaa5a060a92ab
+  data.tar.gz: ad5fcbc6ea32f29bbed5f89e10b857a6d80740a33bf0c4956cb813e8648af297
 SHA512:
-  metadata.gz: 2faea97635e0ba3d80b378dcef6a64845e4cd741b29bafea81e11591ac98a3d9669258dd1d67be7b1a699407b3a369cc38cf33403de37d87f0bd59fc93c44a6d
-  data.tar.gz: 1f33c44a854fc6573bc8577921d1c74dda37296e58864b34f48c437d4a8f6f0edf7fe6f54a5a8e661b959e968a92f2b7fafc01c320e52138a832019c44beae76
+  metadata.gz: 1bb1a24d84de46f6d5344049859ad8cd7371c234851d5d99eb35309f49c6b0b09af0a9045d72c53b1e47c99e681272d6675feb36ca4b4a01cf76dd8a73f0e3c1
+  data.tar.gz: 3824ac8b68c2893354c246c3a5ecfc7918fda50403d69b4efda22f7d0bff67a3055fb872d0ff0de64b45898ddfb848ce5ae680af9b697ae6c31beaf227a62320

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.94.0 (2024-09-23)
+------------------
+
+* Feature - List/Get/Update/Delete/CreateDataCatalog now integrate with AWS Glue connections. Users can create a Glue connection through Athena or use a Glue connection to define their Athena federated parameters.
+
 1.93.0 (2024-09-20)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.93.0
+1.94.0

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

@@ -703,8 +703,10 @@ module Aws::Athena
     #
     # @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.
@@ -748,17 +750,37 @@ module Aws::Athena
     #
     #     ^
     #
+    #   * 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.
     #
-    # @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",
@@ -771,6 +793,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", "MSK", "NEPTUNE", "CMDB", "TPCDS", "REDIS", "CLOUDWATCH", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "TERADATA", "VERTICA", "CLOUDERAIMPALA", "CLOUDERAHIVE", "HORTONWORKSHIVE", "DATALAKEGEN2", "DB2AS400", "CLOUDWATCHMETRICS"
+    #   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 = {})
@@ -1080,7 +1113,9 @@ 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}.
+    # @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
     #
@@ -1088,6 +1123,17 @@ module Aws::Athena
     #     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", "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", "MSK", "NEPTUNE", "CMDB", "TPCDS", "REDIS", "CLOUDWATCH", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "TERADATA", "VERTICA", "CLOUDERAIMPALA", "CLOUDERAHIVE", "HORTONWORKSHIVE", "DATALAKEGEN2", "DB2AS400", "CLOUDWATCHMETRICS"
+    #   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 = {})
@@ -1439,9 +1485,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", "MSK", "NEPTUNE", "CMDB", "TPCDS", "REDIS", "CLOUDWATCH", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "TERADATA", "VERTICA", "CLOUDERAIMPALA", "CLOUDERAHIVE", "HORTONWORKSHIVE", "DATALAKEGEN2", "DB2AS400", "CLOUDWATCHMETRICS"
+    #   resp.data_catalog.error #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetDataCatalog AWS API Documentation
     #
@@ -2268,7 +2317,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", "MSK", "NEPTUNE", "CMDB", "TPCDS", "REDIS", "CLOUDWATCH", "TIMESTREAM", "SAPHANA", "SNOWFLAKE", "TERADATA", "VERTICA", "CLOUDERAIMPALA", "CLOUDERAHIVE", "HORTONWORKSHIVE", "DATALAKEGEN2", "DB2AS400", "CLOUDWATCHMETRICS"
+    #   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
@@ -3465,7 +3517,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",
@@ -3723,7 +3775,7 @@ module Aws::Athena
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-athena'
-      context[:gem_version] = '1.93.0'
+      context[:gem_version] = '1.94.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 module Aws::Athena
   # @api private
   module ClientApi
@@ -61,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')
@@ -78,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')
@@ -476,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"))
@@ -528,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)
@@ -554,6 +564,7 @@ module Aws::Athena
     DeleteDataCatalogInput.add_member(:name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "Name"))
     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,8 +601,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] description
@@ -647,6 +649,24 @@ 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
@@ -666,9 +686,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.
@@ -923,8 +957,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
@@ -964,15 +1000,83 @@ 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
@@ -992,11 +1096,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
@@ -1067,9 +1224,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/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.
@@ -5153,3 +5324,4 @@ module Aws::Athena
 
   end
 end
+

data/lib/aws-sdk-athena.rb

@@ -11,17 +11,6 @@
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
-require_relative 'aws-sdk-athena/types'
-require_relative 'aws-sdk-athena/client_api'
-require_relative 'aws-sdk-athena/plugins/endpoints.rb'
-require_relative 'aws-sdk-athena/client'
-require_relative 'aws-sdk-athena/errors'
-require_relative 'aws-sdk-athena/resource'
-require_relative 'aws-sdk-athena/endpoint_parameters'
-require_relative 'aws-sdk-athena/endpoint_provider'
-require_relative 'aws-sdk-athena/endpoints'
-require_relative 'aws-sdk-athena/customizations'
-
 # This module provides support for Amazon Athena. This module is available in the
 # `aws-sdk-athena` gem.
 #
@@ -51,7 +40,20 @@ require_relative 'aws-sdk-athena/customizations'
 #
 # @!group service
 module Aws::Athena
+  autoload :Types, 'aws-sdk-athena/types'
+  autoload :ClientApi, 'aws-sdk-athena/client_api'
+  module Plugins
+    autoload :Endpoints, 'aws-sdk-athena/plugins/endpoints.rb'
+  end
+  autoload :Client, 'aws-sdk-athena/client'
+  autoload :Errors, 'aws-sdk-athena/errors'
+  autoload :Resource, 'aws-sdk-athena/resource'
+  autoload :EndpointParameters, 'aws-sdk-athena/endpoint_parameters'
+  autoload :EndpointProvider, 'aws-sdk-athena/endpoint_provider'
+  autoload :Endpoints, 'aws-sdk-athena/endpoints'
 
-  GEM_VERSION = '1.93.0'
+  GEM_VERSION = '1.94.0'
 
 end
+
+require_relative 'aws-sdk-athena/customizations'

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,6 +268,7 @@ 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: (
@@ -907,7 +909,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" | "MSK" | "NEPTUNE" | "CMDB" | "TPCDS" | "REDIS" | "CLOUDWATCH" | "TIMESTREAM" | "SAPHANA" | "SNOWFLAKE" | "TERADATA" | "VERTICA" | "CLOUDERAIMPALA" | "CLOUDERAHIVE" | "HORTONWORKSHIVE" | "DATALAKEGEN2" | "DB2AS400" | "CLOUDWATCHMETRICS")
+      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" | "MSK" | "NEPTUNE" | "CMDB" | "TPCDS" | "REDIS" | "CLOUDWATCH" | "TIMESTREAM" | "SAPHANA" | "SNOWFLAKE" | "TERADATA" | "VERTICA" | "CLOUDERAIMPALA" | "CLOUDERAHIVE" | "HORTONWORKSHIVE" | "DATALAKEGEN2" | "DB2AS400" | "CLOUDWATCHMETRICS")
+      attr_accessor error: ::String
       SENSITIVE: []
     end
 
@@ -281,7 +289,9 @@ module Aws::Athena
       SENSITIVE: []
     end
 
-    class DeleteDataCatalogOutput < Aws::EmptyStructure
+    class DeleteDataCatalogOutput
+      attr_accessor data_catalog: Types::DataCatalog
+      SENSITIVE: []
     end
 
     class DeleteNamedQueryInput
@@ -1203,7 +1213,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.93.0
+  version: 1.94.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-09-20 00:00:00.000000000 Z
+date: 2024-09-23 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core