aws-sdk-athena 1.93.0 → 1.95.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 5084dd6805936dae6e17bf6a525c91405a504b205e437fe77fe8d7e44057fad1
4
- data.tar.gz: 5347c3ee3e664272ee61c853101441b252dbb34872ea4576dae0c05878482772
3
+ metadata.gz: 192c19ec72dfe9b4ce635cfa22a99fd8ef88b90bd71455945eac6418d72a5b25
4
+ data.tar.gz: 7c0660e757a6f8f4be9507a668616788d2e9690bb8cbb682b6beaeab218863d5
5
5
  SHA512:
6
- metadata.gz: 2faea97635e0ba3d80b378dcef6a64845e4cd741b29bafea81e11591ac98a3d9669258dd1d67be7b1a699407b3a369cc38cf33403de37d87f0bd59fc93c44a6d
7
- data.tar.gz: 1f33c44a854fc6573bc8577921d1c74dda37296e58864b34f48c437d4a8f6f0edf7fe6f54a5a8e661b959e968a92f2b7fafc01c320e52138a832019c44beae76
6
+ metadata.gz: b6e34e105bce18b1f3c0ca492af96b053ea11e1eefbdee0dab5cdd295fbb77b28baa9398dec4564531f46570e6089d5c67a6c69b1e2d53322d9d372e9a1f159b
7
+ data.tar.gz: c7aac846663becdb4e5eca0dad52e82d13723fb82164d1d4a9fdd6a7c580db95f6bda44325db1cbc3fd28b9b45efda2826cdfdf0c040dfe71df84599968e205d
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.95.0 (2024-09-24)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.94.0 (2024-09-23)
10
+ ------------------
11
+
12
+ * 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.
13
+
4
14
  1.93.0 (2024-09-20)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.93.0
1
+ 1.95.0
@@ -36,8 +36,6 @@ require 'aws-sdk-core/plugins/telemetry.rb'
36
36
  require 'aws-sdk-core/plugins/sign.rb'
37
37
  require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
38
38
 
39
- Aws::Plugins::GlobalConfiguration.add_identifier(:athena)
40
-
41
39
  module Aws::Athena
42
40
  # An API client for Athena. To construct a client, you need to configure a `:region` and `:credentials`.
43
41
  #
@@ -703,8 +701,10 @@ module Aws::Athena
703
701
  #
704
702
  # @option params [required, String] :type
705
703
  # The type of data catalog to create: `LAMBDA` for a federated catalog,
706
- # `HIVE` for an external hive metastore, or `GLUE` for an Glue Data
707
- # Catalog.
704
+ # `GLUE` for an Glue Data Catalog, and `HIVE` for an external Apache
705
+ # Hive metastore. `FEDERATED` is a federated catalog for which Athena
706
+ # creates the connection and the Lambda function for you based on the
707
+ # parameters that you pass.
708
708
  #
709
709
  # @option params [String] :description
710
710
  # A description of the data catalog to be created.
@@ -748,17 +748,37 @@ module Aws::Athena
748
748
  #
749
749
  # ^
750
750
  #
751
+ # * The `FEDERATED` data catalog type uses one of the following
752
+ # parameters, but not both. Use `connection-arn` for an existing Glue
753
+ # connection. Use `connection-type` and `connection-properties` to
754
+ # specify the configuration setting for a new connection.
755
+ #
756
+ # * `connection-arn:<glue_connection_arn_to_reuse> `
757
+ #
758
+ # * `lambda-role-arn` (optional): The execution role to use for the
759
+ # Lambda function. If not provided, one is created.
760
+ #
761
+ # * `connection-type:MYSQL|REDSHIFT|....,
762
+ # connection-properties:"<json_string>"`
763
+ #
764
+ # For <i> <code>&lt;json_string&gt;</code> </i>, use escaped JSON
765
+ # text, as in the following example.
766
+ #
767
+ # `"\{"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"\}"`
768
+ #
751
769
  # @option params [Array<Types::Tag>] :tags
752
770
  # A list of comma separated tags to add to the data catalog that is
753
771
  # created.
754
772
  #
755
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
773
+ # @return [Types::CreateDataCatalogOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
774
+ #
775
+ # * {Types::CreateDataCatalogOutput#data_catalog #data_catalog} => Types::DataCatalog
756
776
  #
757
777
  # @example Request syntax with placeholder values
758
778
  #
759
779
  # resp = client.create_data_catalog({
760
780
  # name: "CatalogNameString", # required
761
- # type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE
781
+ # type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE, FEDERATED
762
782
  # description: "DescriptionString",
763
783
  # parameters: {
764
784
  # "KeyString" => "ParametersMapValue",
@@ -771,6 +791,17 @@ module Aws::Athena
771
791
  # ],
772
792
  # })
773
793
  #
794
+ # @example Response structure
795
+ #
796
+ # resp.data_catalog.name #=> String
797
+ # resp.data_catalog.description #=> String
798
+ # resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
799
+ # resp.data_catalog.parameters #=> Hash
800
+ # resp.data_catalog.parameters["KeyString"] #=> String
801
+ # 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"
802
+ # 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"
803
+ # resp.data_catalog.error #=> String
804
+ #
774
805
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateDataCatalog AWS API Documentation
775
806
  #
776
807
  # @overload create_data_catalog(params = {})
@@ -1080,7 +1111,9 @@ module Aws::Athena
1080
1111
  # @option params [required, String] :name
1081
1112
  # The name of the data catalog to delete.
1082
1113
  #
1083
- # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1114
+ # @return [Types::DeleteDataCatalogOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1115
+ #
1116
+ # * {Types::DeleteDataCatalogOutput#data_catalog #data_catalog} => Types::DataCatalog
1084
1117
  #
1085
1118
  # @example Request syntax with placeholder values
1086
1119
  #
@@ -1088,6 +1121,17 @@ module Aws::Athena
1088
1121
  # name: "CatalogNameString", # required
1089
1122
  # })
1090
1123
  #
1124
+ # @example Response structure
1125
+ #
1126
+ # resp.data_catalog.name #=> String
1127
+ # resp.data_catalog.description #=> String
1128
+ # resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
1129
+ # resp.data_catalog.parameters #=> Hash
1130
+ # resp.data_catalog.parameters["KeyString"] #=> String
1131
+ # 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"
1132
+ # 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"
1133
+ # resp.data_catalog.error #=> String
1134
+ #
1091
1135
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteDataCatalog AWS API Documentation
1092
1136
  #
1093
1137
  # @overload delete_data_catalog(params = {})
@@ -1439,9 +1483,12 @@ module Aws::Athena
1439
1483
  #
1440
1484
  # resp.data_catalog.name #=> String
1441
1485
  # resp.data_catalog.description #=> String
1442
- # resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE"
1486
+ # resp.data_catalog.type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
1443
1487
  # resp.data_catalog.parameters #=> Hash
1444
1488
  # resp.data_catalog.parameters["KeyString"] #=> String
1489
+ # 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"
1490
+ # 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"
1491
+ # resp.data_catalog.error #=> String
1445
1492
  #
1446
1493
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/GetDataCatalog AWS API Documentation
1447
1494
  #
@@ -2268,7 +2315,10 @@ module Aws::Athena
2268
2315
  #
2269
2316
  # resp.data_catalogs_summary #=> Array
2270
2317
  # resp.data_catalogs_summary[0].catalog_name #=> String
2271
- # resp.data_catalogs_summary[0].type #=> String, one of "LAMBDA", "GLUE", "HIVE"
2318
+ # resp.data_catalogs_summary[0].type #=> String, one of "LAMBDA", "GLUE", "HIVE", "FEDERATED"
2319
+ # 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"
2320
+ # 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"
2321
+ # resp.data_catalogs_summary[0].error #=> String
2272
2322
  # resp.next_token #=> String
2273
2323
  #
2274
2324
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/ListDataCatalogs AWS API Documentation
@@ -3465,7 +3515,7 @@ module Aws::Athena
3465
3515
  #
3466
3516
  # resp = client.update_data_catalog({
3467
3517
  # name: "CatalogNameString", # required
3468
- # type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE
3518
+ # type: "LAMBDA", # required, accepts LAMBDA, GLUE, HIVE, FEDERATED
3469
3519
  # description: "DescriptionString",
3470
3520
  # parameters: {
3471
3521
  # "KeyString" => "ParametersMapValue",
@@ -3723,7 +3773,7 @@ module Aws::Athena
3723
3773
  tracer: tracer
3724
3774
  )
3725
3775
  context[:gem_name] = 'aws-sdk-athena'
3726
- context[:gem_version] = '1.93.0'
3776
+ context[:gem_version] = '1.95.0'
3727
3777
  Seahorse::Client::Request.new(handlers, context)
3728
3778
  end
3729
3779
 
@@ -7,6 +7,7 @@
7
7
  #
8
8
  # WARNING ABOUT GENERATED CODE
9
9
 
10
+
10
11
  module Aws::Athena
11
12
  # @api private
12
13
  module ClientApi
@@ -61,6 +62,7 @@ module Aws::Athena
61
62
  ColumnList = Shapes::ListShape.new(name: 'ColumnList')
62
63
  ColumnNullable = Shapes::StringShape.new(name: 'ColumnNullable')
63
64
  CommentString = Shapes::StringShape.new(name: 'CommentString')
65
+ ConnectionType = Shapes::StringShape.new(name: 'ConnectionType')
64
66
  CoordinatorDpuSize = Shapes::IntegerShape.new(name: 'CoordinatorDpuSize')
65
67
  CreateCapacityReservationInput = Shapes::StructureShape.new(name: 'CreateCapacityReservationInput')
66
68
  CreateCapacityReservationOutput = Shapes::StructureShape.new(name: 'CreateCapacityReservationOutput')
@@ -78,6 +80,7 @@ module Aws::Athena
78
80
  CreateWorkGroupOutput = Shapes::StructureShape.new(name: 'CreateWorkGroupOutput')
79
81
  CustomerContentEncryptionConfiguration = Shapes::StructureShape.new(name: 'CustomerContentEncryptionConfiguration')
80
82
  DataCatalog = Shapes::StructureShape.new(name: 'DataCatalog')
83
+ DataCatalogStatus = Shapes::StringShape.new(name: 'DataCatalogStatus')
81
84
  DataCatalogSummary = Shapes::StructureShape.new(name: 'DataCatalogSummary')
82
85
  DataCatalogSummaryList = Shapes::ListShape.new(name: 'DataCatalogSummaryList')
83
86
  DataCatalogType = Shapes::StringShape.new(name: 'DataCatalogType')
@@ -476,6 +479,7 @@ module Aws::Athena
476
479
  CreateDataCatalogInput.add_member(:tags, Shapes::ShapeRef.new(shape: TagList, location_name: "Tags"))
477
480
  CreateDataCatalogInput.struct_class = Types::CreateDataCatalogInput
478
481
 
482
+ CreateDataCatalogOutput.add_member(:data_catalog, Shapes::ShapeRef.new(shape: DataCatalog, location_name: "DataCatalog"))
479
483
  CreateDataCatalogOutput.struct_class = Types::CreateDataCatalogOutput
480
484
 
481
485
  CreateNamedQueryInput.add_member(:name, Shapes::ShapeRef.new(shape: NameString, required: true, location_name: "Name"))
@@ -528,10 +532,16 @@ module Aws::Athena
528
532
  DataCatalog.add_member(:description, Shapes::ShapeRef.new(shape: DescriptionString, location_name: "Description"))
529
533
  DataCatalog.add_member(:type, Shapes::ShapeRef.new(shape: DataCatalogType, required: true, location_name: "Type"))
530
534
  DataCatalog.add_member(:parameters, Shapes::ShapeRef.new(shape: ParametersMap, location_name: "Parameters"))
535
+ DataCatalog.add_member(:status, Shapes::ShapeRef.new(shape: DataCatalogStatus, location_name: "Status"))
536
+ DataCatalog.add_member(:connection_type, Shapes::ShapeRef.new(shape: ConnectionType, location_name: "ConnectionType"))
537
+ DataCatalog.add_member(:error, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Error"))
531
538
  DataCatalog.struct_class = Types::DataCatalog
532
539
 
533
540
  DataCatalogSummary.add_member(:catalog_name, Shapes::ShapeRef.new(shape: CatalogNameString, location_name: "CatalogName"))
534
541
  DataCatalogSummary.add_member(:type, Shapes::ShapeRef.new(shape: DataCatalogType, location_name: "Type"))
542
+ DataCatalogSummary.add_member(:status, Shapes::ShapeRef.new(shape: DataCatalogStatus, location_name: "Status"))
543
+ DataCatalogSummary.add_member(:connection_type, Shapes::ShapeRef.new(shape: ConnectionType, location_name: "ConnectionType"))
544
+ DataCatalogSummary.add_member(:error, Shapes::ShapeRef.new(shape: ErrorMessage, location_name: "Error"))
535
545
  DataCatalogSummary.struct_class = Types::DataCatalogSummary
536
546
 
537
547
  DataCatalogSummaryList.member = Shapes::ShapeRef.new(shape: DataCatalogSummary)
@@ -554,6 +564,7 @@ module Aws::Athena
554
564
  DeleteDataCatalogInput.add_member(:name, Shapes::ShapeRef.new(shape: CatalogNameString, required: true, location_name: "Name"))
555
565
  DeleteDataCatalogInput.struct_class = Types::DeleteDataCatalogInput
556
566
 
567
+ DeleteDataCatalogOutput.add_member(:data_catalog, Shapes::ShapeRef.new(shape: DataCatalog, location_name: "DataCatalog"))
557
568
  DeleteDataCatalogOutput.struct_class = Types::DeleteDataCatalogOutput
558
569
 
559
570
  DeleteNamedQueryInput.add_member(:named_query_id, Shapes::ShapeRef.new(shape: NamedQueryId, required: true, location_name: "NamedQueryId", metadata: {"idempotencyToken"=>true}))
@@ -601,8 +601,10 @@ module Aws::Athena
601
601
  #
602
602
  # @!attribute [rw] type
603
603
  # The type of data catalog to create: `LAMBDA` for a federated
604
- # catalog, `HIVE` for an external hive metastore, or `GLUE` for an
605
- # Glue Data Catalog.
604
+ # catalog, `GLUE` for an Glue Data Catalog, and `HIVE` for an external
605
+ # Apache Hive metastore. `FEDERATED` is a federated catalog for which
606
+ # Athena creates the connection and the Lambda function for you based
607
+ # on the parameters that you pass.
606
608
  # @return [String]
607
609
  #
608
610
  # @!attribute [rw] description
@@ -647,6 +649,24 @@ module Aws::Athena
647
649
  # you can have only one and cannot modify.
648
650
  #
649
651
  # ^
652
+ #
653
+ # * The `FEDERATED` data catalog type uses one of the following
654
+ # parameters, but not both. Use `connection-arn` for an existing
655
+ # Glue connection. Use `connection-type` and `connection-properties`
656
+ # to specify the configuration setting for a new connection.
657
+ #
658
+ # * `connection-arn:<glue_connection_arn_to_reuse> `
659
+ #
660
+ # * `lambda-role-arn` (optional): The execution role to use for the
661
+ # Lambda function. If not provided, one is created.
662
+ #
663
+ # * `connection-type:MYSQL|REDSHIFT|....,
664
+ # connection-properties:"<json_string>"`
665
+ #
666
+ # For <i> <code>&lt;json_string&gt;</code> </i>, use escaped JSON
667
+ # text, as in the following example.
668
+ #
669
+ # `"\{"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"\}"`
650
670
  # @return [Hash<String,String>]
651
671
  #
652
672
  # @!attribute [rw] tags
@@ -666,9 +686,23 @@ module Aws::Athena
666
686
  include Aws::Structure
667
687
  end
668
688
 
689
+ # @!attribute [rw] data_catalog
690
+ # Contains information about a data catalog in an Amazon Web Services
691
+ # account.
692
+ #
693
+ # <note markdown="1"> In the Athena console, data catalogs are listed as "data sources"
694
+ # on the **Data sources** page under the **Data source name** column.
695
+ #
696
+ # </note>
697
+ # @return [Types::DataCatalog]
698
+ #
669
699
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/CreateDataCatalogOutput AWS API Documentation
670
700
  #
671
- class CreateDataCatalogOutput < Aws::EmptyStructure; end
701
+ class CreateDataCatalogOutput < Struct.new(
702
+ :data_catalog)
703
+ SENSITIVE = []
704
+ include Aws::Structure
705
+ end
672
706
 
673
707
  # @!attribute [rw] name
674
708
  # The query name.
@@ -923,8 +957,10 @@ module Aws::Athena
923
957
  #
924
958
  # @!attribute [rw] type
925
959
  # The type of data catalog to create: `LAMBDA` for a federated
926
- # catalog, `HIVE` for an external hive metastore, or `GLUE` for an
927
- # Glue Data Catalog.
960
+ # catalog, `GLUE` for an Glue Data Catalog, and `HIVE` for an external
961
+ # Apache Hive metastore. `FEDERATED` is a federated catalog for which
962
+ # Athena creates the connection and the Lambda function for you based
963
+ # on the parameters that you pass.
928
964
  # @return [String]
929
965
  #
930
966
  # @!attribute [rw] parameters
@@ -964,15 +1000,83 @@ module Aws::Athena
964
1000
  # you can have only one and cannot modify.
965
1001
  #
966
1002
  # ^
1003
+ #
1004
+ # * The `FEDERATED` data catalog type uses one of the following
1005
+ # parameters, but not both. Use `connection-arn` for an existing
1006
+ # Glue connection. Use `connection-type` and `connection-properties`
1007
+ # to specify the configuration setting for a new connection.
1008
+ #
1009
+ # * `connection-arn:<glue_connection_arn_to_reuse> `
1010
+ #
1011
+ # * `connection-type:MYSQL|REDSHIFT|....,
1012
+ # connection-properties:"<json_string>"`
1013
+ #
1014
+ # For <i> <code>&lt;json_string&gt;</code> </i>, use escaped JSON
1015
+ # text, as in the following example.
1016
+ #
1017
+ # `"\{"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"\}"`
967
1018
  # @return [Hash<String,String>]
968
1019
  #
1020
+ # @!attribute [rw] status
1021
+ # The status of the creation or deletion of the data catalog.
1022
+ #
1023
+ # * The `LAMBDA`, `GLUE`, and `HIVE` data catalog types are created
1024
+ # synchronously. Their status is either `CREATE_COMPLETE` or
1025
+ # `CREATE_FAILED`.
1026
+ #
1027
+ # * The `FEDERATED` data catalog type is created asynchronously.
1028
+ #
1029
+ # Data catalog creation status:
1030
+ #
1031
+ # * `CREATE_IN_PROGRESS`: Federated data catalog creation in progress.
1032
+ #
1033
+ # * `CREATE_COMPLETE`: Data catalog creation complete.
1034
+ #
1035
+ # * `CREATE_FAILED`: Data catalog could not be created.
1036
+ #
1037
+ # * `CREATE_FAILED_CLEANUP_IN_PROGRESS`: Federated data catalog
1038
+ # creation failed and is being removed.
1039
+ #
1040
+ # * `CREATE_FAILED_CLEANUP_COMPLETE`: Federated data catalog creation
1041
+ # failed and was removed.
1042
+ #
1043
+ # * `CREATE_FAILED_CLEANUP_FAILED`: Federated data catalog creation
1044
+ # failed but could not be removed.
1045
+ #
1046
+ # Data catalog deletion status:
1047
+ #
1048
+ # * `DELETE_IN_PROGRESS`: Federated data catalog deletion in progress.
1049
+ #
1050
+ # * `DELETE_COMPLETE`: Federated data catalog deleted.
1051
+ #
1052
+ # * `DELETE_FAILED`: Federated data catalog could not be deleted.
1053
+ # @return [String]
1054
+ #
1055
+ # @!attribute [rw] connection_type
1056
+ # The type of connection for a `FEDERATED` data catalog (for example,
1057
+ # `REDSHIFT`, `MYSQL`, or `SQLSERVER`). For information about
1058
+ # individual connectors, see [Available data source connectors][1].
1059
+ #
1060
+ #
1061
+ #
1062
+ # [1]: https://docs.aws.amazon.com/athena/latest/ug/connectors-available.html
1063
+ # @return [String]
1064
+ #
1065
+ # @!attribute [rw] error
1066
+ # Text of the error that occurred during data catalog creation or
1067
+ # deletion.
1068
+ # @return [String]
1069
+ #
969
1070
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DataCatalog AWS API Documentation
970
1071
  #
971
1072
  class DataCatalog < Struct.new(
972
1073
  :name,
973
1074
  :description,
974
1075
  :type,
975
- :parameters)
1076
+ :parameters,
1077
+ :status,
1078
+ :connection_type,
1079
+ :error)
976
1080
  SENSITIVE = []
977
1081
  include Aws::Structure
978
1082
  end
@@ -992,11 +1096,64 @@ module Aws::Athena
992
1096
  # The data catalog type.
993
1097
  # @return [String]
994
1098
  #
1099
+ # @!attribute [rw] status
1100
+ # The status of the creation or deletion of the data catalog.
1101
+ #
1102
+ # * The `LAMBDA`, `GLUE`, and `HIVE` data catalog types are created
1103
+ # synchronously. Their status is either `CREATE_COMPLETE` or
1104
+ # `CREATE_FAILED`.
1105
+ #
1106
+ # * The `FEDERATED` data catalog type is created asynchronously.
1107
+ #
1108
+ # Data catalog creation status:
1109
+ #
1110
+ # * `CREATE_IN_PROGRESS`: Federated data catalog creation in progress.
1111
+ #
1112
+ # * `CREATE_COMPLETE`: Data catalog creation complete.
1113
+ #
1114
+ # * `CREATE_FAILED`: Data catalog could not be created.
1115
+ #
1116
+ # * `CREATE_FAILED_CLEANUP_IN_PROGRESS`: Federated data catalog
1117
+ # creation failed and is being removed.
1118
+ #
1119
+ # * `CREATE_FAILED_CLEANUP_COMPLETE`: Federated data catalog creation
1120
+ # failed and was removed.
1121
+ #
1122
+ # * `CREATE_FAILED_CLEANUP_FAILED`: Federated data catalog creation
1123
+ # failed but could not be removed.
1124
+ #
1125
+ # Data catalog deletion status:
1126
+ #
1127
+ # * `DELETE_IN_PROGRESS`: Federated data catalog deletion in progress.
1128
+ #
1129
+ # * `DELETE_COMPLETE`: Federated data catalog deleted.
1130
+ #
1131
+ # * `DELETE_FAILED`: Federated data catalog could not be deleted.
1132
+ # @return [String]
1133
+ #
1134
+ # @!attribute [rw] connection_type
1135
+ # The type of connection for a `FEDERATED` data catalog (for example,
1136
+ # `REDSHIFT`, `MYSQL`, or `SQLSERVER`). For information about
1137
+ # individual connectors, see [Available data source connectors][1].
1138
+ #
1139
+ #
1140
+ #
1141
+ # [1]: https://docs.aws.amazon.com/athena/latest/ug/connectors-available.html
1142
+ # @return [String]
1143
+ #
1144
+ # @!attribute [rw] error
1145
+ # Text of the error that occurred during data catalog creation or
1146
+ # deletion.
1147
+ # @return [String]
1148
+ #
995
1149
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DataCatalogSummary AWS API Documentation
996
1150
  #
997
1151
  class DataCatalogSummary < Struct.new(
998
1152
  :catalog_name,
999
- :type)
1153
+ :type,
1154
+ :status,
1155
+ :connection_type,
1156
+ :error)
1000
1157
  SENSITIVE = []
1001
1158
  include Aws::Structure
1002
1159
  end
@@ -1067,9 +1224,23 @@ module Aws::Athena
1067
1224
  include Aws::Structure
1068
1225
  end
1069
1226
 
1227
+ # @!attribute [rw] data_catalog
1228
+ # Contains information about a data catalog in an Amazon Web Services
1229
+ # account.
1230
+ #
1231
+ # <note markdown="1"> In the Athena console, data catalogs are listed as "data sources"
1232
+ # on the **Data sources** page under the **Data source name** column.
1233
+ #
1234
+ # </note>
1235
+ # @return [Types::DataCatalog]
1236
+ #
1070
1237
  # @see http://docs.aws.amazon.com/goto/WebAPI/athena-2017-05-18/DeleteDataCatalogOutput AWS API Documentation
1071
1238
  #
1072
- class DeleteDataCatalogOutput < Aws::EmptyStructure; end
1239
+ class DeleteDataCatalogOutput < Struct.new(
1240
+ :data_catalog)
1241
+ SENSITIVE = []
1242
+ include Aws::Structure
1243
+ end
1073
1244
 
1074
1245
  # @!attribute [rw] named_query_id
1075
1246
  # The unique ID of the query to delete.
@@ -5153,3 +5324,4 @@ module Aws::Athena
5153
5324
 
5154
5325
  end
5155
5326
  end
5327
+
@@ -11,16 +11,7 @@
11
11
  require 'aws-sdk-core'
12
12
  require 'aws-sigv4'
13
13
 
14
- require_relative 'aws-sdk-athena/types'
15
- require_relative 'aws-sdk-athena/client_api'
16
- require_relative 'aws-sdk-athena/plugins/endpoints.rb'
17
- require_relative 'aws-sdk-athena/client'
18
- require_relative 'aws-sdk-athena/errors'
19
- require_relative 'aws-sdk-athena/resource'
20
- require_relative 'aws-sdk-athena/endpoint_parameters'
21
- require_relative 'aws-sdk-athena/endpoint_provider'
22
- require_relative 'aws-sdk-athena/endpoints'
23
- require_relative 'aws-sdk-athena/customizations'
14
+ Aws::Plugins::GlobalConfiguration.add_identifier(:athena)
24
15
 
25
16
  # This module provides support for Amazon Athena. This module is available in the
26
17
  # `aws-sdk-athena` gem.
@@ -51,7 +42,20 @@ require_relative 'aws-sdk-athena/customizations'
51
42
  #
52
43
  # @!group service
53
44
  module Aws::Athena
45
+ autoload :Types, 'aws-sdk-athena/types'
46
+ autoload :ClientApi, 'aws-sdk-athena/client_api'
47
+ module Plugins
48
+ autoload :Endpoints, 'aws-sdk-athena/plugins/endpoints.rb'
49
+ end
50
+ autoload :Client, 'aws-sdk-athena/client'
51
+ autoload :Errors, 'aws-sdk-athena/errors'
52
+ autoload :Resource, 'aws-sdk-athena/resource'
53
+ autoload :EndpointParameters, 'aws-sdk-athena/endpoint_parameters'
54
+ autoload :EndpointProvider, 'aws-sdk-athena/endpoint_provider'
55
+ autoload :Endpoints, 'aws-sdk-athena/endpoints'
54
56
 
55
- GEM_VERSION = '1.93.0'
57
+ GEM_VERSION = '1.95.0'
56
58
 
57
59
  end
60
+
61
+ require_relative 'aws-sdk-athena/customizations'
data/sig/client.rbs CHANGED
@@ -137,11 +137,12 @@ module Aws
137
137
 
138
138
  interface _CreateDataCatalogResponseSuccess
139
139
  include ::Seahorse::Client::_ResponseSuccess[Types::CreateDataCatalogOutput]
140
+ def data_catalog: () -> Types::DataCatalog
140
141
  end
141
142
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Athena/Client.html#create_data_catalog-instance_method
142
143
  def create_data_catalog: (
143
144
  name: ::String,
144
- type: ("LAMBDA" | "GLUE" | "HIVE"),
145
+ type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED"),
145
146
  ?description: ::String,
146
147
  ?parameters: Hash[::String, ::String],
147
148
  ?tags: Array[
@@ -267,6 +268,7 @@ module Aws
267
268
 
268
269
  interface _DeleteDataCatalogResponseSuccess
269
270
  include ::Seahorse::Client::_ResponseSuccess[Types::DeleteDataCatalogOutput]
271
+ def data_catalog: () -> Types::DataCatalog
270
272
  end
271
273
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Athena/Client.html#delete_data_catalog-instance_method
272
274
  def delete_data_catalog: (
@@ -907,7 +909,7 @@ module Aws
907
909
  # https://docs.aws.amazon.com/sdk-for-ruby/v3/api/Aws/Athena/Client.html#update_data_catalog-instance_method
908
910
  def update_data_catalog: (
909
911
  name: ::String,
910
- type: ("LAMBDA" | "GLUE" | "HIVE"),
912
+ type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED"),
911
913
  ?description: ::String,
912
914
  ?parameters: Hash[::String, ::String]
913
915
  ) -> _UpdateDataCatalogResponseSuccess
data/sig/types.rbs CHANGED
@@ -166,14 +166,16 @@ module Aws::Athena
166
166
 
167
167
  class CreateDataCatalogInput
168
168
  attr_accessor name: ::String
169
- attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
169
+ attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
170
170
  attr_accessor description: ::String
171
171
  attr_accessor parameters: ::Hash[::String, ::String]
172
172
  attr_accessor tags: ::Array[Types::Tag]
173
173
  SENSITIVE: []
174
174
  end
175
175
 
176
- class CreateDataCatalogOutput < Aws::EmptyStructure
176
+ class CreateDataCatalogOutput
177
+ attr_accessor data_catalog: Types::DataCatalog
178
+ SENSITIVE: []
177
179
  end
178
180
 
179
181
  class CreateNamedQueryInput
@@ -245,14 +247,20 @@ module Aws::Athena
245
247
  class DataCatalog
246
248
  attr_accessor name: ::String
247
249
  attr_accessor description: ::String
248
- attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
250
+ attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
249
251
  attr_accessor parameters: ::Hash[::String, ::String]
252
+ 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")
253
+ 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")
254
+ attr_accessor error: ::String
250
255
  SENSITIVE: []
251
256
  end
252
257
 
253
258
  class DataCatalogSummary
254
259
  attr_accessor catalog_name: ::String
255
- attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
260
+ attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
261
+ 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")
262
+ 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")
263
+ attr_accessor error: ::String
256
264
  SENSITIVE: []
257
265
  end
258
266
 
@@ -281,7 +289,9 @@ module Aws::Athena
281
289
  SENSITIVE: []
282
290
  end
283
291
 
284
- class DeleteDataCatalogOutput < Aws::EmptyStructure
292
+ class DeleteDataCatalogOutput
293
+ attr_accessor data_catalog: Types::DataCatalog
294
+ SENSITIVE: []
285
295
  end
286
296
 
287
297
  class DeleteNamedQueryInput
@@ -1203,7 +1213,7 @@ module Aws::Athena
1203
1213
 
1204
1214
  class UpdateDataCatalogInput
1205
1215
  attr_accessor name: ::String
1206
- attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE")
1216
+ attr_accessor type: ("LAMBDA" | "GLUE" | "HIVE" | "FEDERATED")
1207
1217
  attr_accessor description: ::String
1208
1218
  attr_accessor parameters: ::Hash[::String, ::String]
1209
1219
  SENSITIVE: []
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-athena
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.93.0
4
+ version: 1.95.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2024-09-20 00:00:00.000000000 Z
11
+ date: 2024-09-24 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core