aws-sdk-redshiftdataapiservice 1.7.0 → 1.11.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 50680d0f6a8493a460814387779900f4653e90fe4b67933bf10a87a7407651ee
4
- data.tar.gz: 138c67b4bb6a7007de2e4b48a5b4dc65be3395de60ebae768e96eddee86bf119
3
+ metadata.gz: 3355f7fea562d450737dfebe9ac2cc1a17f1966db928c4503900ae98c5258449
4
+ data.tar.gz: a2a0124182cfa06db1bd3f7c09e5c460759c3f854c109d29d7322a33203b3c3f
5
5
  SHA512:
6
- metadata.gz: 1a2b4a13ac7803f56e16cbb8289156814e4b033f84841868b2a34e45a2d7ac1c5ea89aa31e96a438ae052d66e7ca25ddc2cbf99a65d488748d9fa64094f2adde
7
- data.tar.gz: 0be5e35c8cfc3756f2c6b4ba676615c1b8101ecf50d060f495d4a0f500c4522f0a813d33481cf0b5d64d66d343e897343ce37552506a6e6a0d9a870bbe10ed60
6
+ metadata.gz: 3b53397e36cf6d7cedc59ba8365c4e09ee03c56829b7377fd8a098ca5171c6ddce54caf39191d859b3a771efa2ae0c2be54f7a48b65e0c2b9252cbd41da22303
7
+ data.tar.gz: 3d2dc4c99a06a7e6d630ef6e4d00f65c4874f962934f68bff7c47836dd3e7c6d670771810784447cba87886912f4a0eb246da6681cd7898b0579be99cc981595
data/CHANGELOG.md CHANGED
@@ -1,6 +1,26 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.11.0 (2021-09-01)
5
+ ------------------
6
+
7
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
8
+
9
+ 1.10.0 (2021-07-30)
10
+ ------------------
11
+
12
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
13
+
14
+ 1.9.0 (2021-07-28)
15
+ ------------------
16
+
17
+ * Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
18
+
19
+ 1.8.0 (2021-07-27)
20
+ ------------------
21
+
22
+ * Feature - Added structures to support new Data API operation BatchExecuteStatement, used to execute multiple SQL statements within a single transaction.
23
+
4
24
  1.7.0 (2021-06-15)
5
25
  ------------------
6
26
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.7.0
1
+ 1.11.0
@@ -337,13 +337,93 @@ module Aws::RedshiftDataAPIService
337
337
 
338
338
  # @!group API Operations
339
339
 
340
+ # Runs one or more SQL statements, which can be data manipulation
341
+ # language (DML) or data definition language (DDL). Depending on the
342
+ # authorization method, use one of the following combinations of request
343
+ # parameters:
344
+ #
345
+ # * Secrets Manager - specify the Amazon Resource Name (ARN) of the
346
+ # secret, the database name, and the cluster identifier that matches
347
+ # the cluster in the secret.
348
+ #
349
+ # * Temporary credentials - specify the cluster identifier, the database
350
+ # name, and the database user name. Permission to call the
351
+ # `redshift:GetClusterCredentials` operation is required to use this
352
+ # method.
353
+ #
354
+ # @option params [required, String] :cluster_identifier
355
+ # The cluster identifier. This parameter is required when authenticating
356
+ # using either Secrets Manager or temporary credentials.
357
+ #
358
+ # @option params [required, String] :database
359
+ # The name of the database. This parameter is required when
360
+ # authenticating using either Secrets Manager or temporary credentials.
361
+ #
362
+ # @option params [String] :db_user
363
+ # The database user name. This parameter is required when authenticating
364
+ # using temporary credentials.
365
+ #
366
+ # @option params [String] :secret_arn
367
+ # The name or ARN of the secret that enables access to the database.
368
+ # This parameter is required when authenticating using Secrets Manager.
369
+ #
370
+ # @option params [required, Array<String>] :sqls
371
+ # One or more SQL statements to run.
372
+ #
373
+ # @option params [String] :statement_name
374
+ # The name of the SQL statements. You can name the SQL statements when
375
+ # you create them to identify the query.
376
+ #
377
+ # @option params [Boolean] :with_event
378
+ # A value that indicates whether to send an event to the Amazon
379
+ # EventBridge event bus after the SQL statements run.
380
+ #
381
+ # @return [Types::BatchExecuteStatementOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
382
+ #
383
+ # * {Types::BatchExecuteStatementOutput#cluster_identifier #cluster_identifier} => String
384
+ # * {Types::BatchExecuteStatementOutput#created_at #created_at} => Time
385
+ # * {Types::BatchExecuteStatementOutput#database #database} => String
386
+ # * {Types::BatchExecuteStatementOutput#db_user #db_user} => String
387
+ # * {Types::BatchExecuteStatementOutput#id #id} => String
388
+ # * {Types::BatchExecuteStatementOutput#secret_arn #secret_arn} => String
389
+ #
390
+ # @example Request syntax with placeholder values
391
+ #
392
+ # resp = client.batch_execute_statement({
393
+ # cluster_identifier: "Location", # required
394
+ # database: "String", # required
395
+ # db_user: "String",
396
+ # secret_arn: "SecretArn",
397
+ # sqls: ["StatementString"], # required
398
+ # statement_name: "StatementNameString",
399
+ # with_event: false,
400
+ # })
401
+ #
402
+ # @example Response structure
403
+ #
404
+ # resp.cluster_identifier #=> String
405
+ # resp.created_at #=> Time
406
+ # resp.database #=> String
407
+ # resp.db_user #=> String
408
+ # resp.id #=> String
409
+ # resp.secret_arn #=> String
410
+ #
411
+ # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/BatchExecuteStatement AWS API Documentation
412
+ #
413
+ # @overload batch_execute_statement(params = {})
414
+ # @param [Hash] params ({})
415
+ def batch_execute_statement(params = {}, options = {})
416
+ req = build_request(:batch_execute_statement, params)
417
+ req.send_request(options)
418
+ end
419
+
340
420
  # Cancels a running query. To be canceled, a query must be running.
341
421
  #
342
422
  # @option params [required, String] :id
343
423
  # The identifier of the SQL statement to cancel. This value is a
344
424
  # universally unique identifier (UUID) generated by Amazon Redshift Data
345
- # API. This identifier is returned by `ExecuteStatment` and
346
- # `ListStatements`.
425
+ # API. This identifier is returned by `BatchExecuteStatment`,
426
+ # `ExecuteStatment`, and `ListStatements`.
347
427
  #
348
428
  # @return [Types::CancelStatementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
349
429
  #
@@ -352,7 +432,7 @@ module Aws::RedshiftDataAPIService
352
432
  # @example Request syntax with placeholder values
353
433
  #
354
434
  # resp = client.cancel_statement({
355
- # id: "UUID", # required
435
+ # id: "StatementId", # required
356
436
  # })
357
437
  #
358
438
  # @example Response structure
@@ -376,7 +456,10 @@ module Aws::RedshiftDataAPIService
376
456
  # @option params [required, String] :id
377
457
  # The identifier of the SQL statement to describe. This value is a
378
458
  # universally unique identifier (UUID) generated by Amazon Redshift Data
379
- # API. This identifier is returned by `ExecuteStatment` and
459
+ # API. A suffix indicates the number of the SQL statement. For example,
460
+ # `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has a suffix of `:2` that
461
+ # indicates the second SQL statement of a batch query. This identifier
462
+ # is returned by `BatchExecuteStatment`, `ExecuteStatement`, and
380
463
  # `ListStatements`.
381
464
  #
382
465
  # @return [Types::DescribeStatementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -397,12 +480,13 @@ module Aws::RedshiftDataAPIService
397
480
  # * {Types::DescribeStatementResponse#result_size #result_size} => Integer
398
481
  # * {Types::DescribeStatementResponse#secret_arn #secret_arn} => String
399
482
  # * {Types::DescribeStatementResponse#status #status} => String
483
+ # * {Types::DescribeStatementResponse#sub_statements #sub_statements} => Array&lt;Types::SubStatementData&gt;
400
484
  # * {Types::DescribeStatementResponse#updated_at #updated_at} => Time
401
485
  #
402
486
  # @example Request syntax with placeholder values
403
487
  #
404
488
  # resp = client.describe_statement({
405
- # id: "UUID", # required
489
+ # id: "StatementId", # required
406
490
  # })
407
491
  #
408
492
  # @example Response structure
@@ -425,6 +509,18 @@ module Aws::RedshiftDataAPIService
425
509
  # resp.result_size #=> Integer
426
510
  # resp.secret_arn #=> String
427
511
  # resp.status #=> String, one of "SUBMITTED", "PICKED", "STARTED", "FINISHED", "ABORTED", "FAILED", "ALL"
512
+ # resp.sub_statements #=> Array
513
+ # resp.sub_statements[0].created_at #=> Time
514
+ # resp.sub_statements[0].duration #=> Integer
515
+ # resp.sub_statements[0].error #=> String
516
+ # resp.sub_statements[0].has_result_set #=> Boolean
517
+ # resp.sub_statements[0].id #=> String
518
+ # resp.sub_statements[0].query_string #=> String
519
+ # resp.sub_statements[0].redshift_query_id #=> Integer
520
+ # resp.sub_statements[0].result_rows #=> Integer
521
+ # resp.sub_statements[0].result_size #=> Integer
522
+ # resp.sub_statements[0].status #=> String, one of "SUBMITTED", "PICKED", "STARTED", "FINISHED", "ABORTED", "FAILED"
523
+ # resp.sub_statements[0].updated_at #=> Time
428
524
  # resp.updated_at #=> Time
429
525
  #
430
526
  # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/DescribeStatement AWS API Documentation
@@ -441,9 +537,9 @@ module Aws::RedshiftDataAPIService
441
537
  # page through the column list. Depending on the authorization method,
442
538
  # use one of the following combinations of request parameters:
443
539
  #
444
- # * AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the
445
- # secret and the cluster identifier that matches the cluster in the
446
- # secret.
540
+ # * Secrets Manager - specify the Amazon Resource Name (ARN) of the
541
+ # secret, the database name, and the cluster identifier that matches
542
+ # the cluster in the secret.
447
543
  #
448
544
  # * Temporary credentials - specify the cluster identifier, the database
449
545
  # name, and the database user name. Permission to call the
@@ -452,7 +548,7 @@ module Aws::RedshiftDataAPIService
452
548
  #
453
549
  # @option params [required, String] :cluster_identifier
454
550
  # The cluster identifier. This parameter is required when authenticating
455
- # using either AWS Secrets Manager or temporary credentials.
551
+ # using either Secrets Manager or temporary credentials.
456
552
  #
457
553
  # @option params [String] :connected_database
458
554
  # A database name. The connected database is specified when you connect
@@ -486,8 +582,7 @@ module Aws::RedshiftDataAPIService
486
582
  #
487
583
  # @option params [String] :secret_arn
488
584
  # The name or ARN of the secret that enables access to the database.
489
- # This parameter is required when authenticating using AWS Secrets
490
- # Manager.
585
+ # This parameter is required when authenticating using Secrets Manager.
491
586
  #
492
587
  # @option params [String] :table
493
588
  # The table name. If no table is specified, then all tables for all
@@ -549,9 +644,9 @@ module Aws::RedshiftDataAPIService
549
644
  # statement. Depending on the authorization method, use one of the
550
645
  # following combinations of request parameters:
551
646
  #
552
- # * AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the
553
- # secret and the cluster identifier that matches the cluster in the
554
- # secret.
647
+ # * Secrets Manager - specify the Amazon Resource Name (ARN) of the
648
+ # secret, the database name, and the cluster identifier that matches
649
+ # the cluster in the secret.
555
650
  #
556
651
  # * Temporary credentials - specify the cluster identifier, the database
557
652
  # name, and the database user name. Permission to call the
@@ -560,11 +655,11 @@ module Aws::RedshiftDataAPIService
560
655
  #
561
656
  # @option params [required, String] :cluster_identifier
562
657
  # The cluster identifier. This parameter is required when authenticating
563
- # using either AWS Secrets Manager or temporary credentials.
658
+ # using either Secrets Manager or temporary credentials.
564
659
  #
565
- # @option params [String] :database
660
+ # @option params [required, String] :database
566
661
  # The name of the database. This parameter is required when
567
- # authenticating using temporary credentials.
662
+ # authenticating using either Secrets Manager or temporary credentials.
568
663
  #
569
664
  # @option params [String] :db_user
570
665
  # The database user name. This parameter is required when authenticating
@@ -575,8 +670,7 @@ module Aws::RedshiftDataAPIService
575
670
  #
576
671
  # @option params [String] :secret_arn
577
672
  # The name or ARN of the secret that enables access to the database.
578
- # This parameter is required when authenticating using AWS Secrets
579
- # Manager.
673
+ # This parameter is required when authenticating using Secrets Manager.
580
674
  #
581
675
  # @option params [required, String] :sql
582
676
  # The SQL statement text to run.
@@ -602,7 +696,7 @@ module Aws::RedshiftDataAPIService
602
696
  #
603
697
  # resp = client.execute_statement({
604
698
  # cluster_identifier: "Location", # required
605
- # database: "String",
699
+ # database: "String", # required
606
700
  # db_user: "String",
607
701
  # parameters: [
608
702
  # {
@@ -640,8 +734,11 @@ module Aws::RedshiftDataAPIService
640
734
  # @option params [required, String] :id
641
735
  # The identifier of the SQL statement whose results are to be fetched.
642
736
  # This value is a universally unique identifier (UUID) generated by
643
- # Amazon Redshift Data API. This identifier is returned by
644
- # `ExecuteStatment` and `ListStatements`.
737
+ # Amazon Redshift Data API. A suffix indicates then number of the SQL
738
+ # statement. For example, `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has a
739
+ # suffix of `:2` that indicates the second SQL statement of a batch
740
+ # query. This identifier is returned by `BatchExecuteStatment`,
741
+ # `ExecuteStatment`, and `ListStatements`.
645
742
  #
646
743
  # @option params [String] :next_token
647
744
  # A value that indicates the starting point for the next set of response
@@ -663,7 +760,7 @@ module Aws::RedshiftDataAPIService
663
760
  # @example Request syntax with placeholder values
664
761
  #
665
762
  # resp = client.get_statement_result({
666
- # id: "UUID", # required
763
+ # id: "StatementId", # required
667
764
  # next_token: "String",
668
765
  # })
669
766
  #
@@ -707,9 +804,9 @@ module Aws::RedshiftDataAPIService
707
804
  # the database list. Depending on the authorization method, use one of
708
805
  # the following combinations of request parameters:
709
806
  #
710
- # * AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the
711
- # secret and the cluster identifier that matches the cluster in the
712
- # secret.
807
+ # * Secrets Manager - specify the Amazon Resource Name (ARN) of the
808
+ # secret, the database name, and the cluster identifier that matches
809
+ # the cluster in the secret.
713
810
  #
714
811
  # * Temporary credentials - specify the cluster identifier, the database
715
812
  # name, and the database user name. Permission to call the
@@ -718,11 +815,11 @@ module Aws::RedshiftDataAPIService
718
815
  #
719
816
  # @option params [required, String] :cluster_identifier
720
817
  # The cluster identifier. This parameter is required when authenticating
721
- # using either AWS Secrets Manager or temporary credentials.
818
+ # using either Secrets Manager or temporary credentials.
722
819
  #
723
- # @option params [String] :database
820
+ # @option params [required, String] :database
724
821
  # The name of the database. This parameter is required when
725
- # authenticating using temporary credentials.
822
+ # authenticating using either Secrets Manager or temporary credentials.
726
823
  #
727
824
  # @option params [String] :db_user
728
825
  # The database user name. This parameter is required when authenticating
@@ -743,8 +840,7 @@ module Aws::RedshiftDataAPIService
743
840
  #
744
841
  # @option params [String] :secret_arn
745
842
  # The name or ARN of the secret that enables access to the database.
746
- # This parameter is required when authenticating using AWS Secrets
747
- # Manager.
843
+ # This parameter is required when authenticating using Secrets Manager.
748
844
  #
749
845
  # @return [Types::ListDatabasesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
750
846
  #
@@ -757,7 +853,7 @@ module Aws::RedshiftDataAPIService
757
853
  #
758
854
  # resp = client.list_databases({
759
855
  # cluster_identifier: "Location", # required
760
- # database: "String",
856
+ # database: "String", # required
761
857
  # db_user: "String",
762
858
  # max_results: 1,
763
859
  # next_token: "String",
@@ -783,9 +879,9 @@ module Aws::RedshiftDataAPIService
783
879
  # the schema list. Depending on the authorization method, use one of the
784
880
  # following combinations of request parameters:
785
881
  #
786
- # * AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the
787
- # secret and the cluster identifier that matches the cluster in the
788
- # secret.
882
+ # * Secrets Manager - specify the Amazon Resource Name (ARN) of the
883
+ # secret, the database name, and the cluster identifier that matches
884
+ # the cluster in the secret.
789
885
  #
790
886
  # * Temporary credentials - specify the cluster identifier, the database
791
887
  # name, and the database user name. Permission to call the
@@ -794,7 +890,7 @@ module Aws::RedshiftDataAPIService
794
890
  #
795
891
  # @option params [required, String] :cluster_identifier
796
892
  # The cluster identifier. This parameter is required when authenticating
797
- # using either AWS Secrets Manager or temporary credentials.
893
+ # using either Secrets Manager or temporary credentials.
798
894
  #
799
895
  # @option params [String] :connected_database
800
896
  # A database name. The connected database is specified when you connect
@@ -830,8 +926,7 @@ module Aws::RedshiftDataAPIService
830
926
  #
831
927
  # @option params [String] :secret_arn
832
928
  # The name or ARN of the secret that enables access to the database.
833
- # This parameter is required when authenticating using AWS Secrets
834
- # Manager.
929
+ # This parameter is required when authenticating using Secrets Manager.
835
930
  #
836
931
  # @return [Types::ListSchemasResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
837
932
  #
@@ -891,12 +986,13 @@ module Aws::RedshiftDataAPIService
891
986
  # IAM session are returned. The default is true.
892
987
  #
893
988
  # @option params [String] :statement_name
894
- # The name of the SQL statement specified as input to `ExecuteStatement`
895
- # to identify the query. You can list multiple statements by providing a
896
- # prefix that matches the beginning of the statement name. For example,
897
- # to list myStatement1, myStatement2, myStatement3, and so on, then
898
- # provide the a value of `myStatement`. Data API does a case-sensitive
899
- # match of SQL statement names to the prefix value you provide.
989
+ # The name of the SQL statement specified as input to
990
+ # `BatchExecuteStatement` or `ExecuteStatement` to identify the query.
991
+ # You can list multiple statements by providing a prefix that matches
992
+ # the beginning of the statement name. For example, to list
993
+ # myStatement1, myStatement2, myStatement3, and so on, then provide the
994
+ # a value of `myStatement`. Data API does a case-sensitive match of SQL
995
+ # statement names to the prefix value you provide.
900
996
  #
901
997
  # @option params [String] :status
902
998
  # The status of the SQL statement to list. Status values are defined as
@@ -940,10 +1036,13 @@ module Aws::RedshiftDataAPIService
940
1036
  # resp.statements #=> Array
941
1037
  # resp.statements[0].created_at #=> Time
942
1038
  # resp.statements[0].id #=> String
1039
+ # resp.statements[0].is_batch_statement #=> Boolean
943
1040
  # resp.statements[0].query_parameters #=> Array
944
1041
  # resp.statements[0].query_parameters[0].name #=> String
945
1042
  # resp.statements[0].query_parameters[0].value #=> String
946
1043
  # resp.statements[0].query_string #=> String
1044
+ # resp.statements[0].query_strings #=> Array
1045
+ # resp.statements[0].query_strings[0] #=> String
947
1046
  # resp.statements[0].secret_arn #=> String
948
1047
  # resp.statements[0].statement_name #=> String
949
1048
  # resp.statements[0].status #=> String, one of "SUBMITTED", "PICKED", "STARTED", "FINISHED", "ABORTED", "FAILED", "ALL"
@@ -964,9 +1063,9 @@ module Aws::RedshiftDataAPIService
964
1063
  # Depending on the authorization method, use one of the following
965
1064
  # combinations of request parameters:
966
1065
  #
967
- # * AWS Secrets Manager - specify the Amazon Resource Name (ARN) of the
968
- # secret and the cluster identifier that matches the cluster in the
969
- # secret.
1066
+ # * Secrets Manager - specify the Amazon Resource Name (ARN) of the
1067
+ # secret, the database name, and the cluster identifier that matches
1068
+ # the cluster in the secret.
970
1069
  #
971
1070
  # * Temporary credentials - specify the cluster identifier, the database
972
1071
  # name, and the database user name. Permission to call the
@@ -975,7 +1074,7 @@ module Aws::RedshiftDataAPIService
975
1074
  #
976
1075
  # @option params [required, String] :cluster_identifier
977
1076
  # The cluster identifier. This parameter is required when authenticating
978
- # using either AWS Secrets Manager or temporary credentials.
1077
+ # using either Secrets Manager or temporary credentials.
979
1078
  #
980
1079
  # @option params [String] :connected_database
981
1080
  # A database name. The connected database is specified when you connect
@@ -1014,8 +1113,7 @@ module Aws::RedshiftDataAPIService
1014
1113
  #
1015
1114
  # @option params [String] :secret_arn
1016
1115
  # The name or ARN of the secret that enables access to the database.
1017
- # This parameter is required when authenticating using AWS Secrets
1018
- # Manager.
1116
+ # This parameter is required when authenticating using Secrets Manager.
1019
1117
  #
1020
1118
  # @option params [String] :table_pattern
1021
1119
  # A pattern to filter results by table name. Within a table pattern,
@@ -1077,7 +1175,7 @@ module Aws::RedshiftDataAPIService
1077
1175
  params: params,
1078
1176
  config: config)
1079
1177
  context[:gem_name] = 'aws-sdk-redshiftdataapiservice'
1080
- context[:gem_version] = '1.7.0'
1178
+ context[:gem_version] = '1.11.0'
1081
1179
  Seahorse::Client::Request.new(handlers, context)
1082
1180
  end
1083
1181
 
@@ -14,6 +14,9 @@ module Aws::RedshiftDataAPIService
14
14
  include Seahorse::Model
15
15
 
16
16
  ActiveStatementsExceededException = Shapes::StructureShape.new(name: 'ActiveStatementsExceededException')
17
+ BatchExecuteStatementException = Shapes::StructureShape.new(name: 'BatchExecuteStatementException')
18
+ BatchExecuteStatementInput = Shapes::StructureShape.new(name: 'BatchExecuteStatementInput')
19
+ BatchExecuteStatementOutput = Shapes::StructureShape.new(name: 'BatchExecuteStatementOutput')
17
20
  Blob = Shapes::BlobShape.new(name: 'Blob')
18
21
  Boolean = Shapes::BooleanShape.new(name: 'Boolean')
19
22
  BoxedBoolean = Shapes::BooleanShape.new(name: 'BoxedBoolean')
@@ -32,7 +35,7 @@ module Aws::RedshiftDataAPIService
32
35
  ExecuteStatementException = Shapes::StructureShape.new(name: 'ExecuteStatementException')
33
36
  ExecuteStatementInput = Shapes::StructureShape.new(name: 'ExecuteStatementInput')
34
37
  ExecuteStatementOutput = Shapes::StructureShape.new(name: 'ExecuteStatementOutput')
35
- Field = Shapes::StructureShape.new(name: 'Field')
38
+ Field = Shapes::UnionShape.new(name: 'Field')
36
39
  FieldList = Shapes::ListShape.new(name: 'FieldList')
37
40
  GetStatementResultRequest = Shapes::StructureShape.new(name: 'GetStatementResultRequest')
38
41
  GetStatementResultResponse = Shapes::StructureShape.new(name: 'GetStatementResultResponse')
@@ -55,26 +58,52 @@ module Aws::RedshiftDataAPIService
55
58
  ResourceNotFoundException = Shapes::StructureShape.new(name: 'ResourceNotFoundException')
56
59
  SchemaList = Shapes::ListShape.new(name: 'SchemaList')
57
60
  SecretArn = Shapes::StringShape.new(name: 'SecretArn')
61
+ SqlList = Shapes::ListShape.new(name: 'SqlList')
58
62
  SqlParameter = Shapes::StructureShape.new(name: 'SqlParameter')
59
63
  SqlParametersList = Shapes::ListShape.new(name: 'SqlParametersList')
60
64
  SqlRecords = Shapes::ListShape.new(name: 'SqlRecords')
61
65
  StatementData = Shapes::StructureShape.new(name: 'StatementData')
66
+ StatementId = Shapes::StringShape.new(name: 'StatementId')
62
67
  StatementList = Shapes::ListShape.new(name: 'StatementList')
63
68
  StatementNameString = Shapes::StringShape.new(name: 'StatementNameString')
69
+ StatementStatusString = Shapes::StringShape.new(name: 'StatementStatusString')
64
70
  StatementString = Shapes::StringShape.new(name: 'StatementString')
71
+ StatementStringList = Shapes::ListShape.new(name: 'StatementStringList')
65
72
  StatusString = Shapes::StringShape.new(name: 'StatusString')
66
73
  String = Shapes::StringShape.new(name: 'String')
74
+ SubStatementData = Shapes::StructureShape.new(name: 'SubStatementData')
75
+ SubStatementList = Shapes::ListShape.new(name: 'SubStatementList')
67
76
  TableList = Shapes::ListShape.new(name: 'TableList')
68
77
  TableMember = Shapes::StructureShape.new(name: 'TableMember')
69
78
  Timestamp = Shapes::TimestampShape.new(name: 'Timestamp')
70
- UUID = Shapes::StringShape.new(name: 'UUID')
71
79
  ValidationException = Shapes::StructureShape.new(name: 'ValidationException')
72
80
  bool = Shapes::BooleanShape.new(name: 'bool')
73
81
 
74
82
  ActiveStatementsExceededException.add_member(:message, Shapes::ShapeRef.new(shape: String, location_name: "Message"))
75
83
  ActiveStatementsExceededException.struct_class = Types::ActiveStatementsExceededException
76
84
 
77
- CancelStatementRequest.add_member(:id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "Id"))
85
+ BatchExecuteStatementException.add_member(:message, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Message"))
86
+ BatchExecuteStatementException.add_member(:statement_id, Shapes::ShapeRef.new(shape: String, required: true, location_name: "StatementId"))
87
+ BatchExecuteStatementException.struct_class = Types::BatchExecuteStatementException
88
+
89
+ BatchExecuteStatementInput.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: Location, required: true, location_name: "ClusterIdentifier"))
90
+ BatchExecuteStatementInput.add_member(:database, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Database"))
91
+ BatchExecuteStatementInput.add_member(:db_user, Shapes::ShapeRef.new(shape: String, location_name: "DbUser"))
92
+ BatchExecuteStatementInput.add_member(:secret_arn, Shapes::ShapeRef.new(shape: SecretArn, location_name: "SecretArn"))
93
+ BatchExecuteStatementInput.add_member(:sqls, Shapes::ShapeRef.new(shape: SqlList, required: true, location_name: "Sqls"))
94
+ BatchExecuteStatementInput.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementNameString, location_name: "StatementName"))
95
+ BatchExecuteStatementInput.add_member(:with_event, Shapes::ShapeRef.new(shape: Boolean, location_name: "WithEvent"))
96
+ BatchExecuteStatementInput.struct_class = Types::BatchExecuteStatementInput
97
+
98
+ BatchExecuteStatementOutput.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: Location, location_name: "ClusterIdentifier"))
99
+ BatchExecuteStatementOutput.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreatedAt"))
100
+ BatchExecuteStatementOutput.add_member(:database, Shapes::ShapeRef.new(shape: String, location_name: "Database"))
101
+ BatchExecuteStatementOutput.add_member(:db_user, Shapes::ShapeRef.new(shape: String, location_name: "DbUser"))
102
+ BatchExecuteStatementOutput.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, location_name: "Id"))
103
+ BatchExecuteStatementOutput.add_member(:secret_arn, Shapes::ShapeRef.new(shape: SecretArn, location_name: "SecretArn"))
104
+ BatchExecuteStatementOutput.struct_class = Types::BatchExecuteStatementOutput
105
+
106
+ CancelStatementRequest.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "Id"))
78
107
  CancelStatementRequest.struct_class = Types::CancelStatementRequest
79
108
 
80
109
  CancelStatementResponse.add_member(:status, Shapes::ShapeRef.new(shape: Boolean, location_name: "Status"))
@@ -101,7 +130,7 @@ module Aws::RedshiftDataAPIService
101
130
 
102
131
  DatabaseList.member = Shapes::ShapeRef.new(shape: String)
103
132
 
104
- DescribeStatementRequest.add_member(:id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "Id"))
133
+ DescribeStatementRequest.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "Id"))
105
134
  DescribeStatementRequest.struct_class = Types::DescribeStatementRequest
106
135
 
107
136
  DescribeStatementResponse.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "ClusterIdentifier"))
@@ -111,7 +140,7 @@ module Aws::RedshiftDataAPIService
111
140
  DescribeStatementResponse.add_member(:duration, Shapes::ShapeRef.new(shape: Long, location_name: "Duration"))
112
141
  DescribeStatementResponse.add_member(:error, Shapes::ShapeRef.new(shape: String, location_name: "Error"))
113
142
  DescribeStatementResponse.add_member(:has_result_set, Shapes::ShapeRef.new(shape: Boolean, location_name: "HasResultSet"))
114
- DescribeStatementResponse.add_member(:id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "Id"))
143
+ DescribeStatementResponse.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "Id"))
115
144
  DescribeStatementResponse.add_member(:query_parameters, Shapes::ShapeRef.new(shape: SqlParametersList, location_name: "QueryParameters"))
116
145
  DescribeStatementResponse.add_member(:query_string, Shapes::ShapeRef.new(shape: StatementString, location_name: "QueryString"))
117
146
  DescribeStatementResponse.add_member(:redshift_pid, Shapes::ShapeRef.new(shape: Long, location_name: "RedshiftPid"))
@@ -120,6 +149,7 @@ module Aws::RedshiftDataAPIService
120
149
  DescribeStatementResponse.add_member(:result_size, Shapes::ShapeRef.new(shape: Long, location_name: "ResultSize"))
121
150
  DescribeStatementResponse.add_member(:secret_arn, Shapes::ShapeRef.new(shape: SecretArn, location_name: "SecretArn"))
122
151
  DescribeStatementResponse.add_member(:status, Shapes::ShapeRef.new(shape: StatusString, location_name: "Status"))
152
+ DescribeStatementResponse.add_member(:sub_statements, Shapes::ShapeRef.new(shape: SubStatementList, location_name: "SubStatements"))
123
153
  DescribeStatementResponse.add_member(:updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "UpdatedAt"))
124
154
  DescribeStatementResponse.struct_class = Types::DescribeStatementResponse
125
155
 
@@ -144,7 +174,7 @@ module Aws::RedshiftDataAPIService
144
174
  ExecuteStatementException.struct_class = Types::ExecuteStatementException
145
175
 
146
176
  ExecuteStatementInput.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: Location, required: true, location_name: "ClusterIdentifier"))
147
- ExecuteStatementInput.add_member(:database, Shapes::ShapeRef.new(shape: String, location_name: "Database"))
177
+ ExecuteStatementInput.add_member(:database, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Database"))
148
178
  ExecuteStatementInput.add_member(:db_user, Shapes::ShapeRef.new(shape: String, location_name: "DbUser"))
149
179
  ExecuteStatementInput.add_member(:parameters, Shapes::ShapeRef.new(shape: SqlParametersList, location_name: "Parameters"))
150
180
  ExecuteStatementInput.add_member(:secret_arn, Shapes::ShapeRef.new(shape: SecretArn, location_name: "SecretArn"))
@@ -157,7 +187,7 @@ module Aws::RedshiftDataAPIService
157
187
  ExecuteStatementOutput.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreatedAt"))
158
188
  ExecuteStatementOutput.add_member(:database, Shapes::ShapeRef.new(shape: String, location_name: "Database"))
159
189
  ExecuteStatementOutput.add_member(:db_user, Shapes::ShapeRef.new(shape: String, location_name: "DbUser"))
160
- ExecuteStatementOutput.add_member(:id, Shapes::ShapeRef.new(shape: UUID, location_name: "Id"))
190
+ ExecuteStatementOutput.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, location_name: "Id"))
161
191
  ExecuteStatementOutput.add_member(:secret_arn, Shapes::ShapeRef.new(shape: SecretArn, location_name: "SecretArn"))
162
192
  ExecuteStatementOutput.struct_class = Types::ExecuteStatementOutput
163
193
 
@@ -167,11 +197,19 @@ module Aws::RedshiftDataAPIService
167
197
  Field.add_member(:is_null, Shapes::ShapeRef.new(shape: BoxedBoolean, location_name: "isNull"))
168
198
  Field.add_member(:long_value, Shapes::ShapeRef.new(shape: BoxedLong, location_name: "longValue"))
169
199
  Field.add_member(:string_value, Shapes::ShapeRef.new(shape: String, location_name: "stringValue"))
200
+ Field.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
201
+ Field.add_member_subclass(:blob_value, Types::Field::BlobValue)
202
+ Field.add_member_subclass(:boolean_value, Types::Field::BooleanValue)
203
+ Field.add_member_subclass(:double_value, Types::Field::DoubleValue)
204
+ Field.add_member_subclass(:is_null, Types::Field::IsNull)
205
+ Field.add_member_subclass(:long_value, Types::Field::LongValue)
206
+ Field.add_member_subclass(:string_value, Types::Field::StringValue)
207
+ Field.add_member_subclass(:unknown, Types::Field::Unknown)
170
208
  Field.struct_class = Types::Field
171
209
 
172
210
  FieldList.member = Shapes::ShapeRef.new(shape: Field)
173
211
 
174
- GetStatementResultRequest.add_member(:id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "Id"))
212
+ GetStatementResultRequest.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "Id"))
175
213
  GetStatementResultRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
176
214
  GetStatementResultRequest.struct_class = Types::GetStatementResultRequest
177
215
 
@@ -185,7 +223,7 @@ module Aws::RedshiftDataAPIService
185
223
  InternalServerException.struct_class = Types::InternalServerException
186
224
 
187
225
  ListDatabasesRequest.add_member(:cluster_identifier, Shapes::ShapeRef.new(shape: Location, required: true, location_name: "ClusterIdentifier"))
188
- ListDatabasesRequest.add_member(:database, Shapes::ShapeRef.new(shape: String, location_name: "Database"))
226
+ ListDatabasesRequest.add_member(:database, Shapes::ShapeRef.new(shape: String, required: true, location_name: "Database"))
189
227
  ListDatabasesRequest.add_member(:db_user, Shapes::ShapeRef.new(shape: String, location_name: "DbUser"))
190
228
  ListDatabasesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: PageSize, location_name: "MaxResults"))
191
229
  ListDatabasesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: String, location_name: "NextToken"))
@@ -242,6 +280,8 @@ module Aws::RedshiftDataAPIService
242
280
 
243
281
  SchemaList.member = Shapes::ShapeRef.new(shape: String)
244
282
 
283
+ SqlList.member = Shapes::ShapeRef.new(shape: StatementString)
284
+
245
285
  SqlParameter.add_member(:name, Shapes::ShapeRef.new(shape: ParameterName, required: true, location_name: "name"))
246
286
  SqlParameter.add_member(:value, Shapes::ShapeRef.new(shape: ParameterValue, required: true, location_name: "value"))
247
287
  SqlParameter.struct_class = Types::SqlParameter
@@ -251,9 +291,11 @@ module Aws::RedshiftDataAPIService
251
291
  SqlRecords.member = Shapes::ShapeRef.new(shape: FieldList)
252
292
 
253
293
  StatementData.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreatedAt"))
254
- StatementData.add_member(:id, Shapes::ShapeRef.new(shape: UUID, required: true, location_name: "Id"))
294
+ StatementData.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "Id"))
295
+ StatementData.add_member(:is_batch_statement, Shapes::ShapeRef.new(shape: Boolean, location_name: "IsBatchStatement"))
255
296
  StatementData.add_member(:query_parameters, Shapes::ShapeRef.new(shape: SqlParametersList, location_name: "QueryParameters"))
256
297
  StatementData.add_member(:query_string, Shapes::ShapeRef.new(shape: StatementString, location_name: "QueryString"))
298
+ StatementData.add_member(:query_strings, Shapes::ShapeRef.new(shape: StatementStringList, location_name: "QueryStrings"))
257
299
  StatementData.add_member(:secret_arn, Shapes::ShapeRef.new(shape: SecretArn, location_name: "SecretArn"))
258
300
  StatementData.add_member(:statement_name, Shapes::ShapeRef.new(shape: StatementNameString, location_name: "StatementName"))
259
301
  StatementData.add_member(:status, Shapes::ShapeRef.new(shape: StatusString, location_name: "Status"))
@@ -262,6 +304,23 @@ module Aws::RedshiftDataAPIService
262
304
 
263
305
  StatementList.member = Shapes::ShapeRef.new(shape: StatementData)
264
306
 
307
+ StatementStringList.member = Shapes::ShapeRef.new(shape: StatementString)
308
+
309
+ SubStatementData.add_member(:created_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "CreatedAt"))
310
+ SubStatementData.add_member(:duration, Shapes::ShapeRef.new(shape: Long, location_name: "Duration"))
311
+ SubStatementData.add_member(:error, Shapes::ShapeRef.new(shape: String, location_name: "Error"))
312
+ SubStatementData.add_member(:has_result_set, Shapes::ShapeRef.new(shape: Boolean, location_name: "HasResultSet"))
313
+ SubStatementData.add_member(:id, Shapes::ShapeRef.new(shape: StatementId, required: true, location_name: "Id"))
314
+ SubStatementData.add_member(:query_string, Shapes::ShapeRef.new(shape: StatementString, location_name: "QueryString"))
315
+ SubStatementData.add_member(:redshift_query_id, Shapes::ShapeRef.new(shape: Long, location_name: "RedshiftQueryId"))
316
+ SubStatementData.add_member(:result_rows, Shapes::ShapeRef.new(shape: Long, location_name: "ResultRows"))
317
+ SubStatementData.add_member(:result_size, Shapes::ShapeRef.new(shape: Long, location_name: "ResultSize"))
318
+ SubStatementData.add_member(:status, Shapes::ShapeRef.new(shape: StatementStatusString, location_name: "Status"))
319
+ SubStatementData.add_member(:updated_at, Shapes::ShapeRef.new(shape: Timestamp, location_name: "UpdatedAt"))
320
+ SubStatementData.struct_class = Types::SubStatementData
321
+
322
+ SubStatementList.member = Shapes::ShapeRef.new(shape: SubStatementData)
323
+
265
324
  TableList.member = Shapes::ShapeRef.new(shape: TableMember)
266
325
 
267
326
  TableMember.add_member(:name, Shapes::ShapeRef.new(shape: String, location_name: "name"))
@@ -291,12 +350,24 @@ module Aws::RedshiftDataAPIService
291
350
  "uid" => "redshift-data-2019-12-20",
292
351
  }
293
352
 
353
+ api.add_operation(:batch_execute_statement, Seahorse::Model::Operation.new.tap do |o|
354
+ o.name = "BatchExecuteStatement"
355
+ o.http_method = "POST"
356
+ o.http_request_uri = "/"
357
+ o.input = Shapes::ShapeRef.new(shape: BatchExecuteStatementInput)
358
+ o.output = Shapes::ShapeRef.new(shape: BatchExecuteStatementOutput)
359
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
360
+ o.errors << Shapes::ShapeRef.new(shape: ActiveStatementsExceededException)
361
+ o.errors << Shapes::ShapeRef.new(shape: BatchExecuteStatementException)
362
+ end)
363
+
294
364
  api.add_operation(:cancel_statement, Seahorse::Model::Operation.new.tap do |o|
295
365
  o.name = "CancelStatement"
296
366
  o.http_method = "POST"
297
367
  o.http_request_uri = "/"
298
368
  o.input = Shapes::ShapeRef.new(shape: CancelStatementRequest)
299
369
  o.output = Shapes::ShapeRef.new(shape: CancelStatementResponse)
370
+ o.errors << Shapes::ShapeRef.new(shape: ValidationException)
300
371
  o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
301
372
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
302
373
  end)
@@ -28,6 +28,7 @@ module Aws::RedshiftDataAPIService
28
28
  #
29
29
  # ## Error Classes
30
30
  # * {ActiveStatementsExceededException}
31
+ # * {BatchExecuteStatementException}
31
32
  # * {ExecuteStatementException}
32
33
  # * {InternalServerException}
33
34
  # * {ResourceNotFoundException}
@@ -54,6 +55,26 @@ module Aws::RedshiftDataAPIService
54
55
  end
55
56
  end
56
57
 
58
+ class BatchExecuteStatementException < ServiceError
59
+
60
+ # @param [Seahorse::Client::RequestContext] context
61
+ # @param [String] message
62
+ # @param [Aws::RedshiftDataAPIService::Types::BatchExecuteStatementException] data
63
+ def initialize(context, message, data = Aws::EmptyStructure.new)
64
+ super(context, message, data)
65
+ end
66
+
67
+ # @return [String]
68
+ def message
69
+ @message || @data[:message]
70
+ end
71
+
72
+ # @return [String]
73
+ def statement_id
74
+ @data[:statement_id]
75
+ end
76
+ end
77
+
57
78
  class ExecuteStatementException < ServiceError
58
79
 
59
80
  # @param [Seahorse::Client::RequestContext] context
@@ -23,18 +23,140 @@ module Aws::RedshiftDataAPIService
23
23
  include Aws::Structure
24
24
  end
25
25
 
26
+ # An SQL statement encountered an environmental error while running.
27
+ #
28
+ # @!attribute [rw] message
29
+ # @return [String]
30
+ #
31
+ # @!attribute [rw] statement_id
32
+ # Statement identifier of the exception.
33
+ # @return [String]
34
+ #
35
+ # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/BatchExecuteStatementException AWS API Documentation
36
+ #
37
+ class BatchExecuteStatementException < Struct.new(
38
+ :message,
39
+ :statement_id)
40
+ SENSITIVE = []
41
+ include Aws::Structure
42
+ end
43
+
44
+ # @note When making an API call, you may pass BatchExecuteStatementInput
45
+ # data as a hash:
46
+ #
47
+ # {
48
+ # cluster_identifier: "Location", # required
49
+ # database: "String", # required
50
+ # db_user: "String",
51
+ # secret_arn: "SecretArn",
52
+ # sqls: ["StatementString"], # required
53
+ # statement_name: "StatementNameString",
54
+ # with_event: false,
55
+ # }
56
+ #
57
+ # @!attribute [rw] cluster_identifier
58
+ # The cluster identifier. This parameter is required when
59
+ # authenticating using either Secrets Manager or temporary
60
+ # credentials.
61
+ # @return [String]
62
+ #
63
+ # @!attribute [rw] database
64
+ # The name of the database. This parameter is required when
65
+ # authenticating using either Secrets Manager or temporary
66
+ # credentials.
67
+ # @return [String]
68
+ #
69
+ # @!attribute [rw] db_user
70
+ # The database user name. This parameter is required when
71
+ # authenticating using temporary credentials.
72
+ # @return [String]
73
+ #
74
+ # @!attribute [rw] secret_arn
75
+ # The name or ARN of the secret that enables access to the database.
76
+ # This parameter is required when authenticating using Secrets
77
+ # Manager.
78
+ # @return [String]
79
+ #
80
+ # @!attribute [rw] sqls
81
+ # One or more SQL statements to run.
82
+ # @return [Array<String>]
83
+ #
84
+ # @!attribute [rw] statement_name
85
+ # The name of the SQL statements. You can name the SQL statements when
86
+ # you create them to identify the query.
87
+ # @return [String]
88
+ #
89
+ # @!attribute [rw] with_event
90
+ # A value that indicates whether to send an event to the Amazon
91
+ # EventBridge event bus after the SQL statements run.
92
+ # @return [Boolean]
93
+ #
94
+ # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/BatchExecuteStatementInput AWS API Documentation
95
+ #
96
+ class BatchExecuteStatementInput < Struct.new(
97
+ :cluster_identifier,
98
+ :database,
99
+ :db_user,
100
+ :secret_arn,
101
+ :sqls,
102
+ :statement_name,
103
+ :with_event)
104
+ SENSITIVE = []
105
+ include Aws::Structure
106
+ end
107
+
108
+ # @!attribute [rw] cluster_identifier
109
+ # The cluster identifier.
110
+ # @return [String]
111
+ #
112
+ # @!attribute [rw] created_at
113
+ # The date and time (UTC) the statement was created.
114
+ # @return [Time]
115
+ #
116
+ # @!attribute [rw] database
117
+ # The name of the database.
118
+ # @return [String]
119
+ #
120
+ # @!attribute [rw] db_user
121
+ # The database user name.
122
+ # @return [String]
123
+ #
124
+ # @!attribute [rw] id
125
+ # The identifier of the SQL statement whose results are to be fetched.
126
+ # This value is a universally unique identifier (UUID) generated by
127
+ # Amazon Redshift Data API. This identifier is returned by
128
+ # `BatchExecuteStatment`.
129
+ # @return [String]
130
+ #
131
+ # @!attribute [rw] secret_arn
132
+ # The name or ARN of the secret that enables access to the database.
133
+ # @return [String]
134
+ #
135
+ # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/BatchExecuteStatementOutput AWS API Documentation
136
+ #
137
+ class BatchExecuteStatementOutput < Struct.new(
138
+ :cluster_identifier,
139
+ :created_at,
140
+ :database,
141
+ :db_user,
142
+ :id,
143
+ :secret_arn)
144
+ SENSITIVE = []
145
+ include Aws::Structure
146
+ end
147
+
26
148
  # @note When making an API call, you may pass CancelStatementRequest
27
149
  # data as a hash:
28
150
  #
29
151
  # {
30
- # id: "UUID", # required
152
+ # id: "StatementId", # required
31
153
  # }
32
154
  #
33
155
  # @!attribute [rw] id
34
156
  # The identifier of the SQL statement to cancel. This value is a
35
157
  # universally unique identifier (UUID) generated by Amazon Redshift
36
- # Data API. This identifier is returned by `ExecuteStatment` and
37
- # `ListStatements`.
158
+ # Data API. This identifier is returned by `BatchExecuteStatment`,
159
+ # `ExecuteStatment`, and `ListStatements`.
38
160
  # @return [String]
39
161
  #
40
162
  # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/CancelStatementRequest AWS API Documentation
@@ -137,14 +259,17 @@ module Aws::RedshiftDataAPIService
137
259
  # data as a hash:
138
260
  #
139
261
  # {
140
- # id: "UUID", # required
262
+ # id: "StatementId", # required
141
263
  # }
142
264
  #
143
265
  # @!attribute [rw] id
144
266
  # The identifier of the SQL statement to describe. This value is a
145
267
  # universally unique identifier (UUID) generated by Amazon Redshift
146
- # Data API. This identifier is returned by `ExecuteStatment` and
147
- # `ListStatements`.
268
+ # Data API. A suffix indicates the number of the SQL statement. For
269
+ # example, `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has a suffix of
270
+ # `:2` that indicates the second SQL statement of a batch query. This
271
+ # identifier is returned by `BatchExecuteStatment`,
272
+ # `ExecuteStatement`, and `ListStatements`.
148
273
  # @return [String]
149
274
  #
150
275
  # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/DescribeStatementRequest AWS API Documentation
@@ -213,11 +338,13 @@ module Aws::RedshiftDataAPIService
213
338
  # Either the number of rows returned from the SQL statement or the
214
339
  # number of rows affected. If result size is greater than zero, the
215
340
  # result rows can be the number of rows affected by SQL statements
216
- # such as INSERT, UPDATE, DELETE, COPY, and others.
341
+ # such as INSERT, UPDATE, DELETE, COPY, and others. A `-1` indicates
342
+ # the value is null.
217
343
  # @return [Integer]
218
344
  #
219
345
  # @!attribute [rw] result_size
220
- # The size in bytes of the returned results.
346
+ # The size in bytes of the returned results. A `-1` indicates the
347
+ # value is null.
221
348
  # @return [Integer]
222
349
  #
223
350
  # @!attribute [rw] secret_arn
@@ -245,6 +372,10 @@ module Aws::RedshiftDataAPIService
245
372
  # * SUBMITTED - The query was submitted, but not yet processed.
246
373
  # @return [String]
247
374
  #
375
+ # @!attribute [rw] sub_statements
376
+ # The SQL statements from a multiple statement run.
377
+ # @return [Array<Types::SubStatementData>]
378
+ #
248
379
  # @!attribute [rw] updated_at
249
380
  # The date and time (UTC) that the metadata for the SQL statement was
250
381
  # last updated. An example is the time the status last changed.
@@ -269,6 +400,7 @@ module Aws::RedshiftDataAPIService
269
400
  :result_size,
270
401
  :secret_arn,
271
402
  :status,
403
+ :sub_statements,
272
404
  :updated_at)
273
405
  SENSITIVE = []
274
406
  include Aws::Structure
@@ -291,7 +423,7 @@ module Aws::RedshiftDataAPIService
291
423
  #
292
424
  # @!attribute [rw] cluster_identifier
293
425
  # The cluster identifier. This parameter is required when
294
- # authenticating using either AWS Secrets Manager or temporary
426
+ # authenticating using either Secrets Manager or temporary
295
427
  # credentials.
296
428
  # @return [String]
297
429
  #
@@ -333,7 +465,7 @@ module Aws::RedshiftDataAPIService
333
465
  #
334
466
  # @!attribute [rw] secret_arn
335
467
  # The name or ARN of the secret that enables access to the database.
336
- # This parameter is required when authenticating using AWS Secrets
468
+ # This parameter is required when authenticating using Secrets
337
469
  # Manager.
338
470
  # @return [String]
339
471
  #
@@ -411,7 +543,7 @@ module Aws::RedshiftDataAPIService
411
543
  #
412
544
  # {
413
545
  # cluster_identifier: "Location", # required
414
- # database: "String",
546
+ # database: "String", # required
415
547
  # db_user: "String",
416
548
  # parameters: [
417
549
  # {
@@ -427,13 +559,14 @@ module Aws::RedshiftDataAPIService
427
559
  #
428
560
  # @!attribute [rw] cluster_identifier
429
561
  # The cluster identifier. This parameter is required when
430
- # authenticating using either AWS Secrets Manager or temporary
562
+ # authenticating using either Secrets Manager or temporary
431
563
  # credentials.
432
564
  # @return [String]
433
565
  #
434
566
  # @!attribute [rw] database
435
567
  # The name of the database. This parameter is required when
436
- # authenticating using temporary credentials.
568
+ # authenticating using either Secrets Manager or temporary
569
+ # credentials.
437
570
  # @return [String]
438
571
  #
439
572
  # @!attribute [rw] db_user
@@ -447,7 +580,7 @@ module Aws::RedshiftDataAPIService
447
580
  #
448
581
  # @!attribute [rw] secret_arn
449
582
  # The name or ARN of the secret that enables access to the database.
450
- # This parameter is required when authenticating using AWS Secrets
583
+ # This parameter is required when authenticating using Secrets
451
584
  # Manager.
452
585
  # @return [String]
453
586
  #
@@ -497,9 +630,9 @@ module Aws::RedshiftDataAPIService
497
630
  # @return [String]
498
631
  #
499
632
  # @!attribute [rw] id
500
- # The identifier of the statement to be run. This value is a
501
- # universally unique identifier (UUID) generated by Amazon Redshift
502
- # Data API.
633
+ # The identifier of the SQL statement whose results are to be fetched.
634
+ # This value is a universally unique identifier (UUID) generated by
635
+ # Amazon Redshift Data API.
503
636
  # @return [String]
504
637
  #
505
638
  # @!attribute [rw] secret_arn
@@ -521,6 +654,8 @@ module Aws::RedshiftDataAPIService
521
654
 
522
655
  # A data value in a column.
523
656
  #
657
+ # @note Field is a union - when returned from an API call exactly one value will be set and the returned type will be a subclass of Field corresponding to the set member.
658
+ #
524
659
  # @!attribute [rw] blob_value
525
660
  # A value of the BLOB data type.
526
661
  # @return [String]
@@ -553,24 +688,37 @@ module Aws::RedshiftDataAPIService
553
688
  :double_value,
554
689
  :is_null,
555
690
  :long_value,
556
- :string_value)
691
+ :string_value,
692
+ :unknown)
557
693
  SENSITIVE = []
558
694
  include Aws::Structure
695
+ include Aws::Structure::Union
696
+
697
+ class BlobValue < Field; end
698
+ class BooleanValue < Field; end
699
+ class DoubleValue < Field; end
700
+ class IsNull < Field; end
701
+ class LongValue < Field; end
702
+ class StringValue < Field; end
703
+ class Unknown < Field; end
559
704
  end
560
705
 
561
706
  # @note When making an API call, you may pass GetStatementResultRequest
562
707
  # data as a hash:
563
708
  #
564
709
  # {
565
- # id: "UUID", # required
710
+ # id: "StatementId", # required
566
711
  # next_token: "String",
567
712
  # }
568
713
  #
569
714
  # @!attribute [rw] id
570
715
  # The identifier of the SQL statement whose results are to be fetched.
571
716
  # This value is a universally unique identifier (UUID) generated by
572
- # Amazon Redshift Data API. This identifier is returned by
573
- # `ExecuteStatment` and `ListStatements`.
717
+ # Amazon Redshift Data API. A suffix indicates then number of the SQL
718
+ # statement. For example, `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has
719
+ # a suffix of `:2` that indicates the second SQL statement of a batch
720
+ # query. This identifier is returned by `BatchExecuteStatment`,
721
+ # `ExecuteStatment`, and `ListStatements`.
574
722
  # @return [String]
575
723
  #
576
724
  # @!attribute [rw] next_token
@@ -644,7 +792,7 @@ module Aws::RedshiftDataAPIService
644
792
  #
645
793
  # {
646
794
  # cluster_identifier: "Location", # required
647
- # database: "String",
795
+ # database: "String", # required
648
796
  # db_user: "String",
649
797
  # max_results: 1,
650
798
  # next_token: "String",
@@ -653,13 +801,14 @@ module Aws::RedshiftDataAPIService
653
801
  #
654
802
  # @!attribute [rw] cluster_identifier
655
803
  # The cluster identifier. This parameter is required when
656
- # authenticating using either AWS Secrets Manager or temporary
804
+ # authenticating using either Secrets Manager or temporary
657
805
  # credentials.
658
806
  # @return [String]
659
807
  #
660
808
  # @!attribute [rw] database
661
809
  # The name of the database. This parameter is required when
662
- # authenticating using temporary credentials.
810
+ # authenticating using either Secrets Manager or temporary
811
+ # credentials.
663
812
  # @return [String]
664
813
  #
665
814
  # @!attribute [rw] db_user
@@ -684,7 +833,7 @@ module Aws::RedshiftDataAPIService
684
833
  #
685
834
  # @!attribute [rw] secret_arn
686
835
  # The name or ARN of the secret that enables access to the database.
687
- # This parameter is required when authenticating using AWS Secrets
836
+ # This parameter is required when authenticating using Secrets
688
837
  # Manager.
689
838
  # @return [String]
690
839
  #
@@ -739,7 +888,7 @@ module Aws::RedshiftDataAPIService
739
888
  #
740
889
  # @!attribute [rw] cluster_identifier
741
890
  # The cluster identifier. This parameter is required when
742
- # authenticating using either AWS Secrets Manager or temporary
891
+ # authenticating using either Secrets Manager or temporary
743
892
  # credentials.
744
893
  # @return [String]
745
894
  #
@@ -783,7 +932,7 @@ module Aws::RedshiftDataAPIService
783
932
  #
784
933
  # @!attribute [rw] secret_arn
785
934
  # The name or ARN of the secret that enables access to the database.
786
- # This parameter is required when authenticating using AWS Secrets
935
+ # This parameter is required when authenticating using Secrets
787
936
  # Manager.
788
937
  # @return [String]
789
938
  #
@@ -859,12 +1008,12 @@ module Aws::RedshiftDataAPIService
859
1008
  #
860
1009
  # @!attribute [rw] statement_name
861
1010
  # The name of the SQL statement specified as input to
862
- # `ExecuteStatement` to identify the query. You can list multiple
863
- # statements by providing a prefix that matches the beginning of the
864
- # statement name. For example, to list myStatement1, myStatement2,
865
- # myStatement3, and so on, then provide the a value of `myStatement`.
866
- # Data API does a case-sensitive match of SQL statement names to the
867
- # prefix value you provide.
1011
+ # `BatchExecuteStatement` or `ExecuteStatement` to identify the query.
1012
+ # You can list multiple statements by providing a prefix that matches
1013
+ # the beginning of the statement name. For example, to list
1014
+ # myStatement1, myStatement2, myStatement3, and so on, then provide
1015
+ # the a value of `myStatement`. Data API does a case-sensitive match
1016
+ # of SQL statement names to the prefix value you provide.
868
1017
  # @return [String]
869
1018
  #
870
1019
  # @!attribute [rw] status
@@ -938,7 +1087,7 @@ module Aws::RedshiftDataAPIService
938
1087
  #
939
1088
  # @!attribute [rw] cluster_identifier
940
1089
  # The cluster identifier. This parameter is required when
941
- # authenticating using either AWS Secrets Manager or temporary
1090
+ # authenticating using either Secrets Manager or temporary
942
1091
  # credentials.
943
1092
  # @return [String]
944
1093
  #
@@ -985,7 +1134,7 @@ module Aws::RedshiftDataAPIService
985
1134
  #
986
1135
  # @!attribute [rw] secret_arn
987
1136
  # The name or ARN of the secret that enables access to the database.
988
- # This parameter is required when authenticating using AWS Secrets
1137
+ # This parameter is required when authenticating using Secrets
989
1138
  # Manager.
990
1139
  # @return [String]
991
1140
  #
@@ -1101,6 +1250,11 @@ module Aws::RedshiftDataAPIService
1101
1250
  # identifier (UUID) generated by Amazon Redshift Data API.
1102
1251
  # @return [String]
1103
1252
  #
1253
+ # @!attribute [rw] is_batch_statement
1254
+ # A value that indicates whether the statement is a batch query
1255
+ # request.
1256
+ # @return [Boolean]
1257
+ #
1104
1258
  # @!attribute [rw] query_parameters
1105
1259
  # The parameters used in a SQL statement.
1106
1260
  # @return [Array<Types::SqlParameter>]
@@ -1109,6 +1263,11 @@ module Aws::RedshiftDataAPIService
1109
1263
  # The SQL statement.
1110
1264
  # @return [String]
1111
1265
  #
1266
+ # @!attribute [rw] query_strings
1267
+ # One or more SQL statements. Each query string in the array
1268
+ # corresponds to one of the queries in a batch query request.
1269
+ # @return [Array<String>]
1270
+ #
1112
1271
  # @!attribute [rw] secret_arn
1113
1272
  # The name or Amazon Resource Name (ARN) of the secret that enables
1114
1273
  # access to the database.
@@ -1133,8 +1292,10 @@ module Aws::RedshiftDataAPIService
1133
1292
  class StatementData < Struct.new(
1134
1293
  :created_at,
1135
1294
  :id,
1295
+ :is_batch_statement,
1136
1296
  :query_parameters,
1137
1297
  :query_string,
1298
+ :query_strings,
1138
1299
  :secret_arn,
1139
1300
  :statement_name,
1140
1301
  :status,
@@ -1143,6 +1304,84 @@ module Aws::RedshiftDataAPIService
1143
1304
  include Aws::Structure
1144
1305
  end
1145
1306
 
1307
+ # Information about an SQL statement.
1308
+ #
1309
+ # @!attribute [rw] created_at
1310
+ # The date and time (UTC) the statement was created.
1311
+ # @return [Time]
1312
+ #
1313
+ # @!attribute [rw] duration
1314
+ # The amount of time in nanoseconds that the statement ran.
1315
+ # @return [Integer]
1316
+ #
1317
+ # @!attribute [rw] error
1318
+ # The error message from the cluster if the SQL statement encountered
1319
+ # an error while running.
1320
+ # @return [String]
1321
+ #
1322
+ # @!attribute [rw] has_result_set
1323
+ # A value that indicates whether the statement has a result set. The
1324
+ # result set can be empty.
1325
+ # @return [Boolean]
1326
+ #
1327
+ # @!attribute [rw] id
1328
+ # The identifier of the SQL statement. This value is a universally
1329
+ # unique identifier (UUID) generated by Amazon Redshift Data API. A
1330
+ # suffix indicates the number of the SQL statement. For example,
1331
+ # `d9b6c0c9-0747-4bf4-b142-e8883122f766:2` has a suffix of `:2` that
1332
+ # indicates the second SQL statement of a batch query.
1333
+ # @return [String]
1334
+ #
1335
+ # @!attribute [rw] query_string
1336
+ # The SQL statement text.
1337
+ # @return [String]
1338
+ #
1339
+ # @!attribute [rw] redshift_query_id
1340
+ # The SQL statement identifier. This value is a universally unique
1341
+ # identifier (UUID) generated by Amazon Redshift Data API.
1342
+ # @return [Integer]
1343
+ #
1344
+ # @!attribute [rw] result_rows
1345
+ # Either the number of rows returned from the SQL statement or the
1346
+ # number of rows affected. If result size is greater than zero, the
1347
+ # result rows can be the number of rows affected by SQL statements
1348
+ # such as INSERT, UPDATE, DELETE, COPY, and others. A `-1` indicates
1349
+ # the value is null.
1350
+ # @return [Integer]
1351
+ #
1352
+ # @!attribute [rw] result_size
1353
+ # The size in bytes of the returned results. A `-1` indicates the
1354
+ # value is null.
1355
+ # @return [Integer]
1356
+ #
1357
+ # @!attribute [rw] status
1358
+ # The status of the SQL statement. An example is the that the SQL
1359
+ # statement finished.
1360
+ # @return [String]
1361
+ #
1362
+ # @!attribute [rw] updated_at
1363
+ # The date and time (UTC) that the statement metadata was last
1364
+ # updated.
1365
+ # @return [Time]
1366
+ #
1367
+ # @see http://docs.aws.amazon.com/goto/WebAPI/redshift-data-2019-12-20/SubStatementData AWS API Documentation
1368
+ #
1369
+ class SubStatementData < Struct.new(
1370
+ :created_at,
1371
+ :duration,
1372
+ :error,
1373
+ :has_result_set,
1374
+ :id,
1375
+ :query_string,
1376
+ :redshift_query_id,
1377
+ :result_rows,
1378
+ :result_size,
1379
+ :status,
1380
+ :updated_at)
1381
+ SENSITIVE = []
1382
+ include Aws::Structure
1383
+ end
1384
+
1146
1385
  # The properties of a table.
1147
1386
  #
1148
1387
  # @!attribute [rw] name
@@ -28,7 +28,7 @@ require_relative 'aws-sdk-redshiftdataapiservice/customizations'
28
28
  # structure.
29
29
  #
30
30
  # redshift_data_api_service = Aws::RedshiftDataAPIService::Client.new
31
- # resp = redshift_data_api_service.cancel_statement(params)
31
+ # resp = redshift_data_api_service.batch_execute_statement(params)
32
32
  #
33
33
  # See {Client} for more information.
34
34
  #
@@ -48,6 +48,6 @@ require_relative 'aws-sdk-redshiftdataapiservice/customizations'
48
48
  # @!group service
49
49
  module Aws::RedshiftDataAPIService
50
50
 
51
- GEM_VERSION = '1.7.0'
51
+ GEM_VERSION = '1.11.0'
52
52
 
53
53
  end
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-redshiftdataapiservice
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.7.0
4
+ version: 1.11.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: 2021-06-15 00:00:00.000000000 Z
11
+ date: 2021-09-01 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.112.0
22
+ version: 3.120.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.112.0
32
+ version: 3.120.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement
@@ -76,7 +76,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
76
76
  requirements:
77
77
  - - ">="
78
78
  - !ruby/object:Gem::Version
79
- version: '0'
79
+ version: '2.3'
80
80
  required_rubygems_version: !ruby/object:Gem::Requirement
81
81
  requirements:
82
82
  - - ">="