aws-sdk-rdsdataservice 1.36.0 → 1.37.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 +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-rdsdataservice/client.rb +216 -197
- data/lib/aws-sdk-rdsdataservice/client_api.rb +52 -52
- data/lib/aws-sdk-rdsdataservice/errors.rb +4 -4
- data/lib/aws-sdk-rdsdataservice/types.rb +322 -312
- data/lib/aws-sdk-rdsdataservice.rb +1 -1
- 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: b30fef0b07054f5ff92d546ebbf9dfef1c85821e9bb1c027729aec874574b81b
|
4
|
+
data.tar.gz: 6abb77d02b89a0f280198108f2b12360db19886d3100518373d613ff9bcdb85a
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: e58c9a4a52db9b1c7b0e663e47365561319ebb55e12cf7d4cfed86108bf7c94cf76ebb97aa3490fc8bed180ad7361622596053319be2dddf30dea3ce5d1fed60
|
7
|
+
data.tar.gz: 9811aa09a4dfca137fa047c125a640ab69f1be04f15f99071a51eac7de3ea8b341d2651d3f09ebb2c954c4c111fcb3b1b5ea14210f69c65ccfca029e041dcaca
|
data/CHANGELOG.md
CHANGED
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.37.0
|
@@ -358,7 +358,7 @@ module Aws::RDSDataService
|
|
358
358
|
# can provide a significant performance improvement over individual
|
359
359
|
# insert and update operations.
|
360
360
|
#
|
361
|
-
# If a call isn't part of a transaction because it doesn't include the
|
361
|
+
# <note markdown="1"> If a call isn't part of a transaction because it doesn't include the
|
362
362
|
# `transactionID` parameter, changes that result from the call are
|
363
363
|
# committed automatically.
|
364
364
|
#
|
@@ -374,31 +374,11 @@ module Aws::RDSDataService
|
|
374
374
|
# The response size limit is 1 MiB. If the call returns more than 1 MiB
|
375
375
|
# of response data, the call is terminated.
|
376
376
|
#
|
377
|
-
#
|
378
|
-
# The name of the database.
|
379
|
-
#
|
380
|
-
# @option params [Array<Array>] :parameter_sets
|
381
|
-
# The parameter set for the batch operation.
|
382
|
-
#
|
383
|
-
# The SQL statement is executed as many times as the number of parameter
|
384
|
-
# sets provided. To execute a SQL statement with no parameters, use one
|
385
|
-
# of the following options:
|
386
|
-
#
|
387
|
-
# * Specify one or more empty parameter sets.
|
388
|
-
#
|
389
|
-
# * Use the `ExecuteStatement` operation instead of the
|
390
|
-
# `BatchExecuteStatement` operation.
|
391
|
-
#
|
392
|
-
# <note markdown="1"> Array parameters are not supported.
|
393
|
-
#
|
394
|
-
# </note>
|
377
|
+
# </note>
|
395
378
|
#
|
396
379
|
# @option params [required, String] :resource_arn
|
397
380
|
# The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
|
398
381
|
#
|
399
|
-
# @option params [String] :schema
|
400
|
-
# The name of the database schema.
|
401
|
-
#
|
402
382
|
# @option params [required, String] :secret_arn
|
403
383
|
# The ARN of the secret that enables access to the DB cluster. Enter the
|
404
384
|
# database user name and password for the credentials in the secret.
|
@@ -414,6 +394,28 @@ module Aws::RDSDataService
|
|
414
394
|
# The SQL statement to run. Don't include a semicolon (;) at the end of
|
415
395
|
# the SQL statement.
|
416
396
|
#
|
397
|
+
# @option params [String] :database
|
398
|
+
# The name of the database.
|
399
|
+
#
|
400
|
+
# @option params [String] :schema
|
401
|
+
# The name of the database schema.
|
402
|
+
#
|
403
|
+
# @option params [Array<Array>] :parameter_sets
|
404
|
+
# The parameter set for the batch operation.
|
405
|
+
#
|
406
|
+
# The SQL statement is executed as many times as the number of parameter
|
407
|
+
# sets provided. To execute a SQL statement with no parameters, use one
|
408
|
+
# of the following options:
|
409
|
+
#
|
410
|
+
# * Specify one or more empty parameter sets.
|
411
|
+
#
|
412
|
+
# * Use the `ExecuteStatement` operation instead of the
|
413
|
+
# `BatchExecuteStatement` operation.
|
414
|
+
#
|
415
|
+
# <note markdown="1"> Array parameters are not supported.
|
416
|
+
#
|
417
|
+
# </note>
|
418
|
+
#
|
417
419
|
# @option params [String] :transaction_id
|
418
420
|
# The identifier of a transaction that was started by using the
|
419
421
|
# `BeginTransaction` operation. Specify the transaction ID of the
|
@@ -429,38 +431,38 @@ module Aws::RDSDataService
|
|
429
431
|
# @example Request syntax with placeholder values
|
430
432
|
#
|
431
433
|
# resp = client.batch_execute_statement({
|
434
|
+
# resource_arn: "Arn", # required
|
435
|
+
# secret_arn: "Arn", # required
|
436
|
+
# sql: "SqlStatement", # required
|
432
437
|
# database: "DbName",
|
438
|
+
# schema: "DbName",
|
433
439
|
# parameter_sets: [
|
434
440
|
# [
|
435
441
|
# {
|
436
442
|
# name: "ParameterName",
|
437
|
-
# type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
|
438
443
|
# value: {
|
444
|
+
# is_null: false,
|
445
|
+
# boolean_value: false,
|
446
|
+
# long_value: 1,
|
447
|
+
# double_value: 1.0,
|
448
|
+
# string_value: "String",
|
449
|
+
# blob_value: "data",
|
439
450
|
# array_value: {
|
451
|
+
# boolean_values: [false],
|
452
|
+
# long_values: [1],
|
453
|
+
# double_values: [1.0],
|
454
|
+
# string_values: ["String"],
|
440
455
|
# array_values: [
|
441
456
|
# {
|
442
457
|
# # recursive ArrayValue
|
443
458
|
# },
|
444
459
|
# ],
|
445
|
-
# boolean_values: [false],
|
446
|
-
# double_values: [1.0],
|
447
|
-
# long_values: [1],
|
448
|
-
# string_values: ["String"],
|
449
460
|
# },
|
450
|
-
# blob_value: "data",
|
451
|
-
# boolean_value: false,
|
452
|
-
# double_value: 1.0,
|
453
|
-
# is_null: false,
|
454
|
-
# long_value: 1,
|
455
|
-
# string_value: "String",
|
456
461
|
# },
|
462
|
+
# type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
|
457
463
|
# },
|
458
464
|
# ],
|
459
465
|
# ],
|
460
|
-
# resource_arn: "Arn", # required
|
461
|
-
# schema: "DbName",
|
462
|
-
# secret_arn: "Arn", # required
|
463
|
-
# sql: "SqlStatement", # required
|
464
466
|
# transaction_id: "Id",
|
465
467
|
# })
|
466
468
|
#
|
@@ -468,22 +470,22 @@ module Aws::RDSDataService
|
|
468
470
|
#
|
469
471
|
# resp.update_results #=> Array
|
470
472
|
# resp.update_results[0].generated_fields #=> Array
|
471
|
-
# resp.update_results[0].generated_fields[0].
|
472
|
-
# resp.update_results[0].generated_fields[0].
|
473
|
+
# resp.update_results[0].generated_fields[0].is_null #=> Boolean
|
474
|
+
# resp.update_results[0].generated_fields[0].boolean_value #=> Boolean
|
475
|
+
# resp.update_results[0].generated_fields[0].long_value #=> Integer
|
476
|
+
# resp.update_results[0].generated_fields[0].double_value #=> Float
|
477
|
+
# resp.update_results[0].generated_fields[0].string_value #=> String
|
478
|
+
# resp.update_results[0].generated_fields[0].blob_value #=> String
|
473
479
|
# resp.update_results[0].generated_fields[0].array_value.boolean_values #=> Array
|
474
480
|
# resp.update_results[0].generated_fields[0].array_value.boolean_values[0] #=> Boolean
|
475
|
-
# resp.update_results[0].generated_fields[0].array_value.double_values #=> Array
|
476
|
-
# resp.update_results[0].generated_fields[0].array_value.double_values[0] #=> Float
|
477
481
|
# resp.update_results[0].generated_fields[0].array_value.long_values #=> Array
|
478
482
|
# resp.update_results[0].generated_fields[0].array_value.long_values[0] #=> Integer
|
483
|
+
# resp.update_results[0].generated_fields[0].array_value.double_values #=> Array
|
484
|
+
# resp.update_results[0].generated_fields[0].array_value.double_values[0] #=> Float
|
479
485
|
# resp.update_results[0].generated_fields[0].array_value.string_values #=> Array
|
480
486
|
# resp.update_results[0].generated_fields[0].array_value.string_values[0] #=> String
|
481
|
-
# resp.update_results[0].generated_fields[0].
|
482
|
-
# resp.update_results[0].generated_fields[0].
|
483
|
-
# resp.update_results[0].generated_fields[0].double_value #=> Float
|
484
|
-
# resp.update_results[0].generated_fields[0].is_null #=> Boolean
|
485
|
-
# resp.update_results[0].generated_fields[0].long_value #=> Integer
|
486
|
-
# resp.update_results[0].generated_fields[0].string_value #=> String
|
487
|
+
# resp.update_results[0].generated_fields[0].array_value.array_values #=> Array
|
488
|
+
# resp.update_results[0].generated_fields[0].array_value.array_values[0] #=> Types::ArrayValue
|
487
489
|
#
|
488
490
|
# @see http://docs.aws.amazon.com/goto/WebAPI/rds-data-2018-08-01/BatchExecuteStatement AWS API Documentation
|
489
491
|
#
|
@@ -496,20 +498,31 @@ module Aws::RDSDataService
|
|
496
498
|
|
497
499
|
# Starts a SQL transaction.
|
498
500
|
#
|
499
|
-
#
|
501
|
+
# <note markdown="1"> A transaction can run for a maximum of 24 hours. A transaction is
|
502
|
+
# terminated and rolled back automatically after 24 hours.
|
500
503
|
#
|
501
|
-
#
|
502
|
-
#
|
504
|
+
# A transaction times out if no calls use its transaction ID in three
|
505
|
+
# minutes. If a transaction times out before it's committed, it's
|
506
|
+
# rolled back automatically.
|
507
|
+
#
|
508
|
+
# DDL statements inside a transaction cause an implicit commit. We
|
509
|
+
# recommend that you run each DDL statement in a separate
|
510
|
+
# `ExecuteStatement` call with `continueAfterTimeout` enabled.
|
511
|
+
#
|
512
|
+
# </note>
|
503
513
|
#
|
504
514
|
# @option params [required, String] :resource_arn
|
505
515
|
# The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
|
506
516
|
#
|
507
|
-
# @option params [String] :schema
|
508
|
-
# The name of the database schema.
|
509
|
-
#
|
510
517
|
# @option params [required, String] :secret_arn
|
511
518
|
# The name or ARN of the secret that enables access to the DB cluster.
|
512
519
|
#
|
520
|
+
# @option params [String] :database
|
521
|
+
# The name of the database.
|
522
|
+
#
|
523
|
+
# @option params [String] :schema
|
524
|
+
# The name of the database schema.
|
525
|
+
#
|
513
526
|
# @return [Types::BeginTransactionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
514
527
|
#
|
515
528
|
# * {Types::BeginTransactionResponse#transaction_id #transaction_id} => String
|
@@ -517,10 +530,10 @@ module Aws::RDSDataService
|
|
517
530
|
# @example Request syntax with placeholder values
|
518
531
|
#
|
519
532
|
# resp = client.begin_transaction({
|
520
|
-
# database: "DbName",
|
521
533
|
# resource_arn: "Arn", # required
|
522
|
-
# schema: "DbName",
|
523
534
|
# secret_arn: "Arn", # required
|
535
|
+
# database: "DbName",
|
536
|
+
# schema: "DbName",
|
524
537
|
# })
|
525
538
|
#
|
526
539
|
# @example Response structure
|
@@ -575,9 +588,14 @@ module Aws::RDSDataService
|
|
575
588
|
|
576
589
|
# Runs one or more SQL statements.
|
577
590
|
#
|
578
|
-
# This operation is deprecated. Use the `BatchExecuteStatement` or
|
591
|
+
# <note markdown="1"> This operation is deprecated. Use the `BatchExecuteStatement` or
|
579
592
|
# `ExecuteStatement` operation.
|
580
593
|
#
|
594
|
+
# </note>
|
595
|
+
#
|
596
|
+
# @option params [required, String] :db_cluster_or_instance_arn
|
597
|
+
# The ARN of the Aurora Serverless DB cluster.
|
598
|
+
#
|
581
599
|
# @option params [required, String] :aws_secret_store_arn
|
582
600
|
# The Amazon Resource Name (ARN) of the secret that enables access to
|
583
601
|
# the DB cluster. Enter the database user name and password for the
|
@@ -590,15 +608,6 @@ module Aws::RDSDataService
|
|
590
608
|
#
|
591
609
|
# [1]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html
|
592
610
|
#
|
593
|
-
# @option params [String] :database
|
594
|
-
# The name of the database.
|
595
|
-
#
|
596
|
-
# @option params [required, String] :db_cluster_or_instance_arn
|
597
|
-
# The ARN of the Aurora Serverless DB cluster.
|
598
|
-
#
|
599
|
-
# @option params [String] :schema
|
600
|
-
# The name of the database schema.
|
601
|
-
#
|
602
611
|
# @option params [required, String] :sql_statements
|
603
612
|
# One or more SQL statements to run on the DB cluster.
|
604
613
|
#
|
@@ -606,6 +615,12 @@ module Aws::RDSDataService
|
|
606
615
|
# Any valid SQL statement is permitted, including data definition, data
|
607
616
|
# manipulation, and commit statements.
|
608
617
|
#
|
618
|
+
# @option params [String] :database
|
619
|
+
# The name of the database.
|
620
|
+
#
|
621
|
+
# @option params [String] :schema
|
622
|
+
# The name of the database schema.
|
623
|
+
#
|
609
624
|
# @return [Types::ExecuteSqlResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
610
625
|
#
|
611
626
|
# * {Types::ExecuteSqlResponse#sql_statement_results #sql_statement_results} => Array<Types::SqlStatementResult>
|
@@ -613,47 +628,47 @@ module Aws::RDSDataService
|
|
613
628
|
# @example Request syntax with placeholder values
|
614
629
|
#
|
615
630
|
# resp = client.execute_sql({
|
631
|
+
# db_cluster_or_instance_arn: "Arn", # required
|
616
632
|
# aws_secret_store_arn: "Arn", # required
|
633
|
+
# sql_statements: "SqlStatement", # required
|
617
634
|
# database: "DbName",
|
618
|
-
# db_cluster_or_instance_arn: "Arn", # required
|
619
635
|
# schema: "DbName",
|
620
|
-
# sql_statements: "SqlStatement", # required
|
621
636
|
# })
|
622
637
|
#
|
623
638
|
# @example Response structure
|
624
639
|
#
|
625
640
|
# resp.sql_statement_results #=> Array
|
626
|
-
# resp.sql_statement_results[0].
|
641
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_count #=> Integer
|
642
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata #=> Array
|
643
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].name #=> String
|
644
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type #=> Integer
|
645
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type_name #=> String
|
646
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].label #=> String
|
647
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].schema_name #=> String
|
648
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].table_name #=> String
|
649
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_auto_increment #=> Boolean
|
650
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_signed #=> Boolean
|
651
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_currency #=> Boolean
|
652
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_case_sensitive #=> Boolean
|
653
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].nullable #=> Integer
|
654
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].precision #=> Integer
|
655
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].scale #=> Integer
|
656
|
+
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].array_base_column_type #=> Integer
|
627
657
|
# resp.sql_statement_results[0].result_frame.records #=> Array
|
628
658
|
# resp.sql_statement_results[0].result_frame.records[0].values #=> Array
|
629
|
-
# resp.sql_statement_results[0].result_frame.records[0].values[0].
|
630
|
-
# resp.sql_statement_results[0].result_frame.records[0].values[0].array_values[0] #=> Types::Value
|
631
|
-
# resp.sql_statement_results[0].result_frame.records[0].values[0].big_int_value #=> Integer
|
659
|
+
# resp.sql_statement_results[0].result_frame.records[0].values[0].is_null #=> Boolean
|
632
660
|
# resp.sql_statement_results[0].result_frame.records[0].values[0].bit_value #=> Boolean
|
633
|
-
# resp.sql_statement_results[0].result_frame.records[0].values[0].
|
634
|
-
# resp.sql_statement_results[0].result_frame.records[0].values[0].double_value #=> Float
|
661
|
+
# resp.sql_statement_results[0].result_frame.records[0].values[0].big_int_value #=> Integer
|
635
662
|
# resp.sql_statement_results[0].result_frame.records[0].values[0].int_value #=> Integer
|
636
|
-
# resp.sql_statement_results[0].result_frame.records[0].values[0].
|
663
|
+
# resp.sql_statement_results[0].result_frame.records[0].values[0].double_value #=> Float
|
637
664
|
# resp.sql_statement_results[0].result_frame.records[0].values[0].real_value #=> Float
|
638
665
|
# resp.sql_statement_results[0].result_frame.records[0].values[0].string_value #=> String
|
666
|
+
# resp.sql_statement_results[0].result_frame.records[0].values[0].blob_value #=> String
|
667
|
+
# resp.sql_statement_results[0].result_frame.records[0].values[0].array_values #=> Array
|
668
|
+
# resp.sql_statement_results[0].result_frame.records[0].values[0].array_values[0] #=> Types::Value
|
639
669
|
# resp.sql_statement_results[0].result_frame.records[0].values[0].struct_value.attributes #=> Array
|
640
670
|
# resp.sql_statement_results[0].result_frame.records[0].values[0].struct_value.attributes[0] #=> Types::Value
|
641
|
-
# resp.sql_statement_results[0].
|
642
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata #=> Array
|
643
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].array_base_column_type #=> Integer
|
644
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_auto_increment #=> Boolean
|
645
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_case_sensitive #=> Boolean
|
646
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_currency #=> Boolean
|
647
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_signed #=> Boolean
|
648
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].label #=> String
|
649
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].name #=> String
|
650
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].nullable #=> Integer
|
651
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].precision #=> Integer
|
652
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].scale #=> Integer
|
653
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].schema_name #=> String
|
654
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].table_name #=> String
|
655
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type #=> Integer
|
656
|
-
# resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type_name #=> String
|
671
|
+
# resp.sql_statement_results[0].number_of_records_updated #=> Integer
|
657
672
|
#
|
658
673
|
# @see http://docs.aws.amazon.com/goto/WebAPI/rds-data-2018-08-01/ExecuteSql AWS API Documentation
|
659
674
|
#
|
@@ -666,42 +681,41 @@ module Aws::RDSDataService
|
|
666
681
|
|
667
682
|
# Runs a SQL statement against a database.
|
668
683
|
#
|
669
|
-
# If a call isn't part of a transaction because it doesn't include the
|
684
|
+
# <note markdown="1"> If a call isn't part of a transaction because it doesn't include the
|
670
685
|
# `transactionID` parameter, changes that result from the call are
|
671
686
|
# committed automatically.
|
672
687
|
#
|
673
688
|
# If the binary response data from the database is more than 1 MB, the
|
674
689
|
# call is terminated.
|
675
690
|
#
|
676
|
-
#
|
677
|
-
# A value that indicates whether to continue running the statement after
|
678
|
-
# the call times out. By default, the statement stops running when the
|
679
|
-
# call times out.
|
691
|
+
# </note>
|
680
692
|
#
|
681
|
-
#
|
682
|
-
#
|
683
|
-
# finished running, it can result in errors and possibly corrupted data
|
684
|
-
# structures.
|
693
|
+
# @option params [required, String] :resource_arn
|
694
|
+
# The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
|
685
695
|
#
|
686
|
-
# @option params [String] :
|
687
|
-
# The
|
696
|
+
# @option params [required, String] :secret_arn
|
697
|
+
# The ARN of the secret that enables access to the DB cluster. Enter the
|
698
|
+
# database user name and password for the credentials in the secret.
|
688
699
|
#
|
689
|
-
#
|
690
|
-
#
|
691
|
-
# JSON string. This parameter only applies to `SELECT` statements and is
|
692
|
-
# ignored for other types of statements. Allowed values are `NONE` and
|
693
|
-
# `JSON`. The default value is `NONE`. The result is returned in the
|
694
|
-
# `formattedRecords` field.
|
700
|
+
# For information about creating the secret, see [Create a database
|
701
|
+
# secret][1].
|
695
702
|
#
|
696
|
-
# For usage information about the JSON format for result sets, see
|
697
|
-
# [Using the Data API][1] in the *Amazon Aurora User Guide*.
|
698
703
|
#
|
699
704
|
#
|
705
|
+
# [1]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html
|
700
706
|
#
|
701
|
-
#
|
707
|
+
# @option params [required, String] :sql
|
708
|
+
# The SQL statement to run.
|
702
709
|
#
|
703
|
-
# @option params [
|
704
|
-
#
|
710
|
+
# @option params [String] :database
|
711
|
+
# The name of the database.
|
712
|
+
#
|
713
|
+
# @option params [String] :schema
|
714
|
+
# The name of the database schema.
|
715
|
+
#
|
716
|
+
# <note markdown="1"> Currently, the `schema` parameter isn't supported.
|
717
|
+
#
|
718
|
+
# </note>
|
705
719
|
#
|
706
720
|
# @option params [Array<Types::SqlParameter>] :parameters
|
707
721
|
# The parameters for the SQL statement.
|
@@ -710,146 +724,151 @@ module Aws::RDSDataService
|
|
710
724
|
#
|
711
725
|
# </note>
|
712
726
|
#
|
713
|
-
# @option params [
|
714
|
-
# The
|
715
|
-
#
|
716
|
-
#
|
717
|
-
# Options that control how the result set is returned.
|
727
|
+
# @option params [String] :transaction_id
|
728
|
+
# The identifier of a transaction that was started by using the
|
729
|
+
# `BeginTransaction` operation. Specify the transaction ID of the
|
730
|
+
# transaction that you want to include the SQL statement in.
|
718
731
|
#
|
719
|
-
#
|
720
|
-
#
|
732
|
+
# If the SQL statement is not part of a transaction, don't set this
|
733
|
+
# parameter.
|
721
734
|
#
|
722
|
-
#
|
735
|
+
# @option params [Boolean] :include_result_metadata
|
736
|
+
# A value that indicates whether to include metadata in the results.
|
723
737
|
#
|
724
|
-
#
|
738
|
+
# @option params [Boolean] :continue_after_timeout
|
739
|
+
# A value that indicates whether to continue running the statement after
|
740
|
+
# the call times out. By default, the statement stops running when the
|
741
|
+
# call times out.
|
725
742
|
#
|
726
|
-
#
|
727
|
-
#
|
728
|
-
#
|
743
|
+
# <note markdown="1"> For DDL statements, we recommend continuing to run the statement after
|
744
|
+
# the call times out. When a DDL statement terminates before it is
|
745
|
+
# finished running, it can result in errors and possibly corrupted data
|
746
|
+
# structures.
|
729
747
|
#
|
730
|
-
#
|
731
|
-
# secret][1].
|
748
|
+
# </note>
|
732
749
|
#
|
750
|
+
# @option params [Types::ResultSetOptions] :result_set_options
|
751
|
+
# Options that control how the result set is returned.
|
733
752
|
#
|
753
|
+
# @option params [String] :format_records_as
|
754
|
+
# A value that indicates whether to format the result set as a single
|
755
|
+
# JSON string. This parameter only applies to `SELECT` statements and is
|
756
|
+
# ignored for other types of statements. Allowed values are `NONE` and
|
757
|
+
# `JSON`. The default value is `NONE`. The result is returned in the
|
758
|
+
# `formattedRecords` field.
|
734
759
|
#
|
735
|
-
#
|
760
|
+
# For usage information about the JSON format for result sets, see
|
761
|
+
# [Using the Data API][1] in the *Amazon Aurora User Guide*.
|
736
762
|
#
|
737
|
-
# @option params [required, String] :sql
|
738
|
-
# The SQL statement to run.
|
739
763
|
#
|
740
|
-
# @option params [String] :transaction_id
|
741
|
-
# The identifier of a transaction that was started by using the
|
742
|
-
# `BeginTransaction` operation. Specify the transaction ID of the
|
743
|
-
# transaction that you want to include the SQL statement in.
|
744
764
|
#
|
745
|
-
#
|
746
|
-
# parameter.
|
765
|
+
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html
|
747
766
|
#
|
748
767
|
# @return [Types::ExecuteStatementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
749
768
|
#
|
769
|
+
# * {Types::ExecuteStatementResponse#records #records} => Array<Array<Types::Field>>
|
750
770
|
# * {Types::ExecuteStatementResponse#column_metadata #column_metadata} => Array<Types::ColumnMetadata>
|
751
|
-
# * {Types::ExecuteStatementResponse#formatted_records #formatted_records} => String
|
752
|
-
# * {Types::ExecuteStatementResponse#generated_fields #generated_fields} => Array<Types::Field>
|
753
771
|
# * {Types::ExecuteStatementResponse#number_of_records_updated #number_of_records_updated} => Integer
|
754
|
-
# * {Types::ExecuteStatementResponse#
|
772
|
+
# * {Types::ExecuteStatementResponse#generated_fields #generated_fields} => Array<Types::Field>
|
773
|
+
# * {Types::ExecuteStatementResponse#formatted_records #formatted_records} => String
|
755
774
|
#
|
756
775
|
# @example Request syntax with placeholder values
|
757
776
|
#
|
758
777
|
# resp = client.execute_statement({
|
759
|
-
#
|
778
|
+
# resource_arn: "Arn", # required
|
779
|
+
# secret_arn: "Arn", # required
|
780
|
+
# sql: "SqlStatement", # required
|
760
781
|
# database: "DbName",
|
761
|
-
#
|
762
|
-
# include_result_metadata: false,
|
782
|
+
# schema: "DbName",
|
763
783
|
# parameters: [
|
764
784
|
# {
|
765
785
|
# name: "ParameterName",
|
766
|
-
# type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
|
767
786
|
# value: {
|
787
|
+
# is_null: false,
|
788
|
+
# boolean_value: false,
|
789
|
+
# long_value: 1,
|
790
|
+
# double_value: 1.0,
|
791
|
+
# string_value: "String",
|
792
|
+
# blob_value: "data",
|
768
793
|
# array_value: {
|
794
|
+
# boolean_values: [false],
|
795
|
+
# long_values: [1],
|
796
|
+
# double_values: [1.0],
|
797
|
+
# string_values: ["String"],
|
769
798
|
# array_values: [
|
770
799
|
# {
|
771
800
|
# # recursive ArrayValue
|
772
801
|
# },
|
773
802
|
# ],
|
774
|
-
# boolean_values: [false],
|
775
|
-
# double_values: [1.0],
|
776
|
-
# long_values: [1],
|
777
|
-
# string_values: ["String"],
|
778
803
|
# },
|
779
|
-
# blob_value: "data",
|
780
|
-
# boolean_value: false,
|
781
|
-
# double_value: 1.0,
|
782
|
-
# is_null: false,
|
783
|
-
# long_value: 1,
|
784
|
-
# string_value: "String",
|
785
804
|
# },
|
805
|
+
# type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
|
786
806
|
# },
|
787
807
|
# ],
|
788
|
-
#
|
808
|
+
# transaction_id: "Id",
|
809
|
+
# include_result_metadata: false,
|
810
|
+
# continue_after_timeout: false,
|
789
811
|
# result_set_options: {
|
790
812
|
# decimal_return_type: "STRING", # accepts STRING, DOUBLE_OR_LONG
|
791
813
|
# long_return_type: "STRING", # accepts STRING, LONG
|
792
814
|
# },
|
793
|
-
#
|
794
|
-
# secret_arn: "Arn", # required
|
795
|
-
# sql: "SqlStatement", # required
|
796
|
-
# transaction_id: "Id",
|
815
|
+
# format_records_as: "NONE", # accepts NONE, JSON
|
797
816
|
# })
|
798
817
|
#
|
799
818
|
# @example Response structure
|
800
819
|
#
|
820
|
+
# resp.records #=> Array
|
821
|
+
# resp.records[0] #=> Array
|
822
|
+
# resp.records[0][0].is_null #=> Boolean
|
823
|
+
# resp.records[0][0].boolean_value #=> Boolean
|
824
|
+
# resp.records[0][0].long_value #=> Integer
|
825
|
+
# resp.records[0][0].double_value #=> Float
|
826
|
+
# resp.records[0][0].string_value #=> String
|
827
|
+
# resp.records[0][0].blob_value #=> String
|
828
|
+
# resp.records[0][0].array_value.boolean_values #=> Array
|
829
|
+
# resp.records[0][0].array_value.boolean_values[0] #=> Boolean
|
830
|
+
# resp.records[0][0].array_value.long_values #=> Array
|
831
|
+
# resp.records[0][0].array_value.long_values[0] #=> Integer
|
832
|
+
# resp.records[0][0].array_value.double_values #=> Array
|
833
|
+
# resp.records[0][0].array_value.double_values[0] #=> Float
|
834
|
+
# resp.records[0][0].array_value.string_values #=> Array
|
835
|
+
# resp.records[0][0].array_value.string_values[0] #=> String
|
836
|
+
# resp.records[0][0].array_value.array_values #=> Array
|
837
|
+
# resp.records[0][0].array_value.array_values[0] #=> Types::ArrayValue
|
801
838
|
# resp.column_metadata #=> Array
|
802
|
-
# resp.column_metadata[0].
|
839
|
+
# resp.column_metadata[0].name #=> String
|
840
|
+
# resp.column_metadata[0].type #=> Integer
|
841
|
+
# resp.column_metadata[0].type_name #=> String
|
842
|
+
# resp.column_metadata[0].label #=> String
|
843
|
+
# resp.column_metadata[0].schema_name #=> String
|
844
|
+
# resp.column_metadata[0].table_name #=> String
|
803
845
|
# resp.column_metadata[0].is_auto_increment #=> Boolean
|
804
|
-
# resp.column_metadata[0].is_case_sensitive #=> Boolean
|
805
|
-
# resp.column_metadata[0].is_currency #=> Boolean
|
806
846
|
# resp.column_metadata[0].is_signed #=> Boolean
|
807
|
-
# resp.column_metadata[0].
|
808
|
-
# resp.column_metadata[0].
|
847
|
+
# resp.column_metadata[0].is_currency #=> Boolean
|
848
|
+
# resp.column_metadata[0].is_case_sensitive #=> Boolean
|
809
849
|
# resp.column_metadata[0].nullable #=> Integer
|
810
850
|
# resp.column_metadata[0].precision #=> Integer
|
811
851
|
# resp.column_metadata[0].scale #=> Integer
|
812
|
-
# resp.column_metadata[0].
|
813
|
-
# resp.
|
814
|
-
# resp.column_metadata[0].type #=> Integer
|
815
|
-
# resp.column_metadata[0].type_name #=> String
|
816
|
-
# resp.formatted_records #=> String
|
852
|
+
# resp.column_metadata[0].array_base_column_type #=> Integer
|
853
|
+
# resp.number_of_records_updated #=> Integer
|
817
854
|
# resp.generated_fields #=> Array
|
818
|
-
# resp.generated_fields[0].
|
819
|
-
# resp.generated_fields[0].
|
855
|
+
# resp.generated_fields[0].is_null #=> Boolean
|
856
|
+
# resp.generated_fields[0].boolean_value #=> Boolean
|
857
|
+
# resp.generated_fields[0].long_value #=> Integer
|
858
|
+
# resp.generated_fields[0].double_value #=> Float
|
859
|
+
# resp.generated_fields[0].string_value #=> String
|
860
|
+
# resp.generated_fields[0].blob_value #=> String
|
820
861
|
# resp.generated_fields[0].array_value.boolean_values #=> Array
|
821
862
|
# resp.generated_fields[0].array_value.boolean_values[0] #=> Boolean
|
822
|
-
# resp.generated_fields[0].array_value.double_values #=> Array
|
823
|
-
# resp.generated_fields[0].array_value.double_values[0] #=> Float
|
824
863
|
# resp.generated_fields[0].array_value.long_values #=> Array
|
825
864
|
# resp.generated_fields[0].array_value.long_values[0] #=> Integer
|
865
|
+
# resp.generated_fields[0].array_value.double_values #=> Array
|
866
|
+
# resp.generated_fields[0].array_value.double_values[0] #=> Float
|
826
867
|
# resp.generated_fields[0].array_value.string_values #=> Array
|
827
868
|
# resp.generated_fields[0].array_value.string_values[0] #=> String
|
828
|
-
# resp.generated_fields[0].
|
829
|
-
# resp.generated_fields[0].
|
830
|
-
# resp.
|
831
|
-
# resp.generated_fields[0].is_null #=> Boolean
|
832
|
-
# resp.generated_fields[0].long_value #=> Integer
|
833
|
-
# resp.generated_fields[0].string_value #=> String
|
834
|
-
# resp.number_of_records_updated #=> Integer
|
835
|
-
# resp.records #=> Array
|
836
|
-
# resp.records[0] #=> Array
|
837
|
-
# resp.records[0][0].array_value.array_values #=> Array
|
838
|
-
# resp.records[0][0].array_value.array_values[0] #=> Types::ArrayValue
|
839
|
-
# resp.records[0][0].array_value.boolean_values #=> Array
|
840
|
-
# resp.records[0][0].array_value.boolean_values[0] #=> Boolean
|
841
|
-
# resp.records[0][0].array_value.double_values #=> Array
|
842
|
-
# resp.records[0][0].array_value.double_values[0] #=> Float
|
843
|
-
# resp.records[0][0].array_value.long_values #=> Array
|
844
|
-
# resp.records[0][0].array_value.long_values[0] #=> Integer
|
845
|
-
# resp.records[0][0].array_value.string_values #=> Array
|
846
|
-
# resp.records[0][0].array_value.string_values[0] #=> String
|
847
|
-
# resp.records[0][0].blob_value #=> String
|
848
|
-
# resp.records[0][0].boolean_value #=> Boolean
|
849
|
-
# resp.records[0][0].double_value #=> Float
|
850
|
-
# resp.records[0][0].is_null #=> Boolean
|
851
|
-
# resp.records[0][0].long_value #=> Integer
|
852
|
-
# resp.records[0][0].string_value #=> String
|
869
|
+
# resp.generated_fields[0].array_value.array_values #=> Array
|
870
|
+
# resp.generated_fields[0].array_value.array_values[0] #=> Types::ArrayValue
|
871
|
+
# resp.formatted_records #=> String
|
853
872
|
#
|
854
873
|
# @see http://docs.aws.amazon.com/goto/WebAPI/rds-data-2018-08-01/ExecuteStatement AWS API Documentation
|
855
874
|
#
|
@@ -910,7 +929,7 @@ module Aws::RDSDataService
|
|
910
929
|
params: params,
|
911
930
|
config: config)
|
912
931
|
context[:gem_name] = 'aws-sdk-rdsdataservice'
|
913
|
-
context[:gem_version] = '1.
|
932
|
+
context[:gem_version] = '1.37.0'
|
914
933
|
Seahorse::Client::Request.new(handlers, context)
|
915
934
|
end
|
916
935
|
|