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 +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-athena/client.rb +61 -11
- data/lib/aws-sdk-athena/client_api.rb +11 -0
- data/lib/aws-sdk-athena/types.rb +180 -8
- data/lib/aws-sdk-athena.rb +15 -11
- data/sig/client.rbs +4 -2
- data/sig/types.rbs +16 -6
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 192c19ec72dfe9b4ce635cfa22a99fd8ef88b90bd71455945eac6418d72a5b25
|
4
|
+
data.tar.gz: 7c0660e757a6f8f4be9507a668616788d2e9690bb8cbb682b6beaeab218863d5
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
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.
|
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
|
-
# `
|
707
|
-
#
|
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><json_string></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 [
|
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 [
|
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.
|
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}))
|
data/lib/aws-sdk-athena/types.rb
CHANGED
@@ -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, `
|
605
|
-
#
|
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><json_string></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 <
|
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, `
|
927
|
-
#
|
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><json_string></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 <
|
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
|
+
|
data/lib/aws-sdk-athena.rb
CHANGED
@@ -11,16 +11,7 @@
|
|
11
11
|
require 'aws-sdk-core'
|
12
12
|
require 'aws-sigv4'
|
13
13
|
|
14
|
-
|
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.
|
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
|
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
|
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.
|
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-
|
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
|