aws-sdk-rdsdataservice 1.34.0 → 1.37.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: a1375e9c259d0ef50feb469e26f9f60248e31fc1e880c92a597d1032f87e134b
-  data.tar.gz: ca1be1bc69af456655b8da0ff9f9ecaca974abffac5e2cf503088baa0c95d9d8
+  metadata.gz: b30fef0b07054f5ff92d546ebbf9dfef1c85821e9bb1c027729aec874574b81b
+  data.tar.gz: 6abb77d02b89a0f280198108f2b12360db19886d3100518373d613ff9bcdb85a
 SHA512:
-  metadata.gz: 8c24c2c3ad8302a40e88fb8a13c16584f341103566d3dea88e3b713457b1691152644760057f91cc6d80e9c35e312c53c4c13ad4ae9451d6b7f6ee0f00e64236
-  data.tar.gz: 51ee8608ccdf553fcefe88f12d4f34b4117d59a0ce8abe500978cfa7df17e0da204b9b8ccbc0f61cdd54eedbadc791aec9be64d0a148a65f8777a215dca0c0af
+  metadata.gz: e58c9a4a52db9b1c7b0e663e47365561319ebb55e12cf7d4cfed86108bf7c94cf76ebb97aa3490fc8bed180ad7361622596053319be2dddf30dea3ce5d1fed60
+  data.tar.gz: 9811aa09a4dfca137fa047c125a640ab69f1be04f15f99071a51eac7de3ea8b341d2651d3f09ebb2c954c4c111fcb3b1b5ea14210f69c65ccfca029e041dcaca

data/CHANGELOG.md

@@ -1,6 +1,21 @@
 Unreleased Changes
 ------------------
 
+1.37.0 (2022-08-31)
+------------------
+
+* Feature - Documentation updates for RDS Data API
+
+1.36.0 (2022-06-24)
+------------------
+
+* Feature - Documentation updates for RDS Data API
+
+1.35.0 (2022-04-25)
+------------------
+
+* Feature - Support to receive SQL query results in the form of a simplified JSON string. This enables developers using the new JSON string format to more easily convert it to an object using popular JSON string parsing libraries.
+
 1.34.0 (2022-02-24)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.34.0
+1.37.0

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

@@ -358,13 +358,48 @@ module Aws::RDSDataService
     # can provide a significant performance improvement over individual
     # insert and update operations.
     #
-    # If a call isn't part of a transaction because it doesn't include the
+    # <note markdown="1"> If a call isn't part of a transaction because it doesn't include the
     # `transactionID` parameter, changes that result from the call are
     # committed automatically.
     #
+    #  There isn't a fixed upper limit on the number of parameter sets.
+    # However, the maximum size of the HTTP request submitted through the
+    # Data API is 4 MiB. If the request exceeds this limit, the Data API
+    # returns an error and doesn't process the request. This 4-MiB limit
+    # includes the size of the HTTP headers and the JSON notation in the
+    # request. Thus, the number of parameter sets that you can include
+    # depends on a combination of factors, such as the size of the SQL
+    # statement and the size of each parameter set.
+    #
+    #  The response size limit is 1 MiB. If the call returns more than 1 MiB
+    # of response data, the call is terminated.
+    #
+    #  </note>
+    #
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
+    #
+    # @option params [required, String] :secret_arn
+    #   The ARN of the secret that enables access to the DB cluster. Enter the
+    #   database user name and password for the credentials in the secret.
+    #
+    #   For information about creating the secret, see [Create a database
+    #   secret][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html
+    #
+    # @option params [required, String] :sql
+    #   The SQL statement to run. Don't include a semicolon (;) at the end of
+    #   the SQL statement.
+    #
     # @option params [String] :database
     #   The name of the database.
     #
+    # @option params [String] :schema
+    #   The name of the database schema.
+    #
     # @option params [Array<Array>] :parameter_sets
     #   The parameter set for the batch operation.
     #
@@ -381,18 +416,6 @@ module Aws::RDSDataService
     #
     #    </note>
     #
-    # @option params [required, String] :resource_arn
-    #   The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
-    #
-    # @option params [String] :schema
-    #   The name of the database schema.
-    #
-    # @option params [required, String] :secret_arn
-    #   The name or ARN of the secret that enables access to the DB cluster.
-    #
-    # @option params [required, String] :sql
-    #   The SQL statement to run.
-    #
     # @option params [String] :transaction_id
     #   The identifier of a transaction that was started by using the
     #   `BeginTransaction` operation. Specify the transaction ID of the
@@ -408,38 +431,38 @@ module Aws::RDSDataService
     # @example Request syntax with placeholder values
     #
     #   resp = client.batch_execute_statement({
+    #     resource_arn: "Arn", # required
+    #     secret_arn: "Arn", # required
+    #     sql: "SqlStatement", # required
     #     database: "DbName",
+    #     schema: "DbName",
     #     parameter_sets: [
     #       [
     #         {
     #           name: "ParameterName",
-    #           type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
     #           value: {
+    #             is_null: false,
+    #             boolean_value: false,
+    #             long_value: 1,
+    #             double_value: 1.0,
+    #             string_value: "String",
+    #             blob_value: "data",
     #             array_value: {
+    #               boolean_values: [false],
+    #               long_values: [1],
+    #               double_values: [1.0],
+    #               string_values: ["String"],
     #               array_values: [
     #                 {
     #                   # recursive ArrayValue
     #                 },
     #               ],
-    #               boolean_values: [false],
-    #               double_values: [1.0],
-    #               long_values: [1],
-    #               string_values: ["String"],
     #             },
-    #             blob_value: "data",
-    #             boolean_value: false,
-    #             double_value: 1.0,
-    #             is_null: false,
-    #             long_value: 1,
-    #             string_value: "String",
     #           },
+    #           type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
     #         },
     #       ],
     #     ],
-    #     resource_arn: "Arn", # required
-    #     schema: "DbName",
-    #     secret_arn: "Arn", # required
-    #     sql: "SqlStatement", # required
     #     transaction_id: "Id",
     #   })
     #
@@ -447,22 +470,22 @@ module Aws::RDSDataService
     #
     #   resp.update_results #=> Array
     #   resp.update_results[0].generated_fields #=> Array
-    #   resp.update_results[0].generated_fields[0].array_value.array_values #=> Array
-    #   resp.update_results[0].generated_fields[0].array_value.array_values[0] #=> Types::ArrayValue
+    #   resp.update_results[0].generated_fields[0].is_null #=> Boolean
+    #   resp.update_results[0].generated_fields[0].boolean_value #=> Boolean
+    #   resp.update_results[0].generated_fields[0].long_value #=> Integer
+    #   resp.update_results[0].generated_fields[0].double_value #=> Float
+    #   resp.update_results[0].generated_fields[0].string_value #=> String
+    #   resp.update_results[0].generated_fields[0].blob_value #=> String
     #   resp.update_results[0].generated_fields[0].array_value.boolean_values #=> Array
     #   resp.update_results[0].generated_fields[0].array_value.boolean_values[0] #=> Boolean
-    #   resp.update_results[0].generated_fields[0].array_value.double_values #=> Array
-    #   resp.update_results[0].generated_fields[0].array_value.double_values[0] #=> Float
     #   resp.update_results[0].generated_fields[0].array_value.long_values #=> Array
     #   resp.update_results[0].generated_fields[0].array_value.long_values[0] #=> Integer
+    #   resp.update_results[0].generated_fields[0].array_value.double_values #=> Array
+    #   resp.update_results[0].generated_fields[0].array_value.double_values[0] #=> Float
     #   resp.update_results[0].generated_fields[0].array_value.string_values #=> Array
     #   resp.update_results[0].generated_fields[0].array_value.string_values[0] #=> String
-    #   resp.update_results[0].generated_fields[0].blob_value #=> String
-    #   resp.update_results[0].generated_fields[0].boolean_value #=> Boolean
-    #   resp.update_results[0].generated_fields[0].double_value #=> Float
-    #   resp.update_results[0].generated_fields[0].is_null #=> Boolean
-    #   resp.update_results[0].generated_fields[0].long_value #=> Integer
-    #   resp.update_results[0].generated_fields[0].string_value #=> String
+    #   resp.update_results[0].generated_fields[0].array_value.array_values #=> Array
+    #   resp.update_results[0].generated_fields[0].array_value.array_values[0] #=> Types::ArrayValue
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-data-2018-08-01/BatchExecuteStatement AWS API Documentation
     #
@@ -475,20 +498,31 @@ module Aws::RDSDataService
 
     # Starts a SQL transaction.
     #
-    #      <important> <p>A transaction can run for a maximum of 24 hours. A transaction is terminated and rolled back automatically after 24 hours.</p> <p>A transaction times out if no calls use its transaction ID in three minutes. If a transaction times out before it's committed, it's rolled back automatically.</p> <p>DDL statements inside a transaction cause an implicit commit. We recommend that you run each DDL statement in a separate <code>ExecuteStatement</code> call with <code>continueAfterTimeout</code> enabled.</p> </important>
+    # <note markdown="1"> A transaction can run for a maximum of 24 hours. A transaction is
+    # terminated and rolled back automatically after 24 hours.
     #
-    # @option params [String] :database
-    #   The name of the database.
+    #  A transaction times out if no calls use its transaction ID in three
+    # minutes. If a transaction times out before it's committed, it's
+    # rolled back automatically.
+    #
+    #  DDL statements inside a transaction cause an implicit commit. We
+    # recommend that you run each DDL statement in a separate
+    # `ExecuteStatement` call with `continueAfterTimeout` enabled.
+    #
+    #  </note>
     #
     # @option params [required, String] :resource_arn
     #   The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
     #
-    # @option params [String] :schema
-    #   The name of the database schema.
-    #
     # @option params [required, String] :secret_arn
     #   The name or ARN of the secret that enables access to the DB cluster.
     #
+    # @option params [String] :database
+    #   The name of the database.
+    #
+    # @option params [String] :schema
+    #   The name of the database schema.
+    #
     # @return [Types::BeginTransactionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::BeginTransactionResponse#transaction_id #transaction_id} => String
@@ -496,10 +530,10 @@ module Aws::RDSDataService
     # @example Request syntax with placeholder values
     #
     #   resp = client.begin_transaction({
-    #     database: "DbName",
     #     resource_arn: "Arn", # required
-    #     schema: "DbName",
     #     secret_arn: "Arn", # required
+    #     database: "DbName",
+    #     schema: "DbName",
     #   })
     #
     # @example Response structure
@@ -554,21 +588,25 @@ module Aws::RDSDataService
 
     # Runs one or more SQL statements.
     #
-    # This operation is deprecated. Use the `BatchExecuteStatement` or
+    # <note markdown="1"> This operation is deprecated. Use the `BatchExecuteStatement` or
     # `ExecuteStatement` operation.
     #
+    #  </note>
+    #
+    # @option params [required, String] :db_cluster_or_instance_arn
+    #   The ARN of the Aurora Serverless DB cluster.
+    #
     # @option params [required, String] :aws_secret_store_arn
     #   The Amazon Resource Name (ARN) of the secret that enables access to
-    #   the DB cluster.
+    #   the DB cluster. Enter the database user name and password for the
+    #   credentials in the secret.
     #
-    # @option params [String] :database
-    #   The name of the database.
+    #   For information about creating the secret, see [Create a database
+    #   secret][1].
     #
-    # @option params [required, String] :db_cluster_or_instance_arn
-    #   The ARN of the Aurora Serverless DB cluster.
     #
-    # @option params [String] :schema
-    #   The name of the database schema.
+    #
+    #   [1]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html
     #
     # @option params [required, String] :sql_statements
     #   One or more SQL statements to run on the DB cluster.
@@ -577,6 +615,12 @@ module Aws::RDSDataService
     #   Any valid SQL statement is permitted, including data definition, data
     #   manipulation, and commit statements.
     #
+    # @option params [String] :database
+    #   The name of the database.
+    #
+    # @option params [String] :schema
+    #   The name of the database schema.
+    #
     # @return [Types::ExecuteSqlResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ExecuteSqlResponse#sql_statement_results #sql_statement_results} => Array&lt;Types::SqlStatementResult&gt;
@@ -584,47 +628,47 @@ module Aws::RDSDataService
     # @example Request syntax with placeholder values
     #
     #   resp = client.execute_sql({
+    #     db_cluster_or_instance_arn: "Arn", # required
     #     aws_secret_store_arn: "Arn", # required
+    #     sql_statements: "SqlStatement", # required
     #     database: "DbName",
-    #     db_cluster_or_instance_arn: "Arn", # required
     #     schema: "DbName",
-    #     sql_statements: "SqlStatement", # required
     #   })
     #
     # @example Response structure
     #
     #   resp.sql_statement_results #=> Array
-    #   resp.sql_statement_results[0].number_of_records_updated #=> Integer
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_count #=> Integer
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata #=> Array
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].name #=> String
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type #=> Integer
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type_name #=> String
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].label #=> String
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].schema_name #=> String
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].table_name #=> String
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_auto_increment #=> Boolean
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_signed #=> Boolean
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_currency #=> Boolean
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_case_sensitive #=> Boolean
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].nullable #=> Integer
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].precision #=> Integer
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].scale #=> Integer
+    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].array_base_column_type #=> Integer
     #   resp.sql_statement_results[0].result_frame.records #=> Array
     #   resp.sql_statement_results[0].result_frame.records[0].values #=> Array
-    #   resp.sql_statement_results[0].result_frame.records[0].values[0].array_values #=> Array
-    #   resp.sql_statement_results[0].result_frame.records[0].values[0].array_values[0] #=> Types::Value
-    #   resp.sql_statement_results[0].result_frame.records[0].values[0].big_int_value #=> Integer
+    #   resp.sql_statement_results[0].result_frame.records[0].values[0].is_null #=> Boolean
     #   resp.sql_statement_results[0].result_frame.records[0].values[0].bit_value #=> Boolean
-    #   resp.sql_statement_results[0].result_frame.records[0].values[0].blob_value #=> String
-    #   resp.sql_statement_results[0].result_frame.records[0].values[0].double_value #=> Float
+    #   resp.sql_statement_results[0].result_frame.records[0].values[0].big_int_value #=> Integer
     #   resp.sql_statement_results[0].result_frame.records[0].values[0].int_value #=> Integer
-    #   resp.sql_statement_results[0].result_frame.records[0].values[0].is_null #=> Boolean
+    #   resp.sql_statement_results[0].result_frame.records[0].values[0].double_value #=> Float
     #   resp.sql_statement_results[0].result_frame.records[0].values[0].real_value #=> Float
     #   resp.sql_statement_results[0].result_frame.records[0].values[0].string_value #=> String
+    #   resp.sql_statement_results[0].result_frame.records[0].values[0].blob_value #=> String
+    #   resp.sql_statement_results[0].result_frame.records[0].values[0].array_values #=> Array
+    #   resp.sql_statement_results[0].result_frame.records[0].values[0].array_values[0] #=> Types::Value
     #   resp.sql_statement_results[0].result_frame.records[0].values[0].struct_value.attributes #=> Array
     #   resp.sql_statement_results[0].result_frame.records[0].values[0].struct_value.attributes[0] #=> Types::Value
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_count #=> Integer
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata #=> Array
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].array_base_column_type #=> Integer
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_auto_increment #=> Boolean
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_case_sensitive #=> Boolean
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_currency #=> Boolean
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].is_signed #=> Boolean
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].label #=> String
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].name #=> String
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].nullable #=> Integer
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].precision #=> Integer
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].scale #=> Integer
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].schema_name #=> String
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].table_name #=> String
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type #=> Integer
-    #   resp.sql_statement_results[0].result_frame.result_set_metadata.column_metadata[0].type_name #=> String
+    #   resp.sql_statement_results[0].number_of_records_updated #=> Integer
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-data-2018-08-01/ExecuteSql AWS API Documentation
     #
@@ -637,41 +681,34 @@ module Aws::RDSDataService
 
     # Runs a SQL statement against a database.
     #
-    # If a call isn't part of a transaction because it doesn't include the
+    # <note markdown="1"> If a call isn't part of a transaction because it doesn't include the
     # `transactionID` parameter, changes that result from the call are
     # committed automatically.
     #
-    # The response size limit is 1 MB. If the call returns more than 1 MB of
-    # response data, the call is terminated.
+    #  If the binary response data from the database is more than 1 MB, the
+    # call is terminated.
     #
-    # @option params [Boolean] :continue_after_timeout
-    #   A value that indicates whether to continue running the statement after
-    #   the call times out. By default, the statement stops running when the
-    #   call times out.
+    #  </note>
     #
-    #   For DDL statements, we recommend continuing to run the statement after
-    #   the call times out. When a DDL statement terminates before it is
-    #   finished running, it can result in errors and possibly corrupted data
-    #   structures.
+    # @option params [required, String] :resource_arn
+    #   The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
     #
-    # @option params [String] :database
-    #   The name of the database.
+    # @option params [required, String] :secret_arn
+    #   The ARN of the secret that enables access to the DB cluster. Enter the
+    #   database user name and password for the credentials in the secret.
     #
-    # @option params [Boolean] :include_result_metadata
-    #   A value that indicates whether to include metadata in the results.
+    #   For information about creating the secret, see [Create a database
+    #   secret][1].
     #
-    # @option params [Array<Types::SqlParameter>] :parameters
-    #   The parameters for the SQL statement.
     #
-    #   <note markdown="1"> Array parameters are not supported.
     #
-    #    </note>
+    #   [1]: https://docs.aws.amazon.com/secretsmanager/latest/userguide/create_database_secret.html
     #
-    # @option params [required, String] :resource_arn
-    #   The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
+    # @option params [required, String] :sql
+    #   The SQL statement to run.
     #
-    # @option params [Types::ResultSetOptions] :result_set_options
-    #   Options that control how the result set is returned.
+    # @option params [String] :database
+    #   The name of the database.
     #
     # @option params [String] :schema
     #   The name of the database schema.
@@ -680,11 +717,12 @@ module Aws::RDSDataService
     #
     #    </note>
     #
-    # @option params [required, String] :secret_arn
-    #   The name or ARN of the secret that enables access to the DB cluster.
+    # @option params [Array<Types::SqlParameter>] :parameters
+    #   The parameters for the SQL statement.
     #
-    # @option params [required, String] :sql
-    #   The SQL statement to run.
+    #   <note markdown="1"> Array parameters are not supported.
+    #
+    #    </note>
     #
     # @option params [String] :transaction_id
     #   The identifier of a transaction that was started by using the
@@ -694,107 +732,143 @@ module Aws::RDSDataService
     #   If the SQL statement is not part of a transaction, don't set this
     #   parameter.
     #
+    # @option params [Boolean] :include_result_metadata
+    #   A value that indicates whether to include metadata in the results.
+    #
+    # @option params [Boolean] :continue_after_timeout
+    #   A value that indicates whether to continue running the statement after
+    #   the call times out. By default, the statement stops running when the
+    #   call times out.
+    #
+    #   <note markdown="1"> For DDL statements, we recommend continuing to run the statement after
+    #   the call times out. When a DDL statement terminates before it is
+    #   finished running, it can result in errors and possibly corrupted data
+    #   structures.
+    #
+    #    </note>
+    #
+    # @option params [Types::ResultSetOptions] :result_set_options
+    #   Options that control how the result set is returned.
+    #
+    # @option params [String] :format_records_as
+    #   A value that indicates whether to format the result set as a single
+    #   JSON string. This parameter only applies to `SELECT` statements and is
+    #   ignored for other types of statements. Allowed values are `NONE` and
+    #   `JSON`. The default value is `NONE`. The result is returned in the
+    #   `formattedRecords` field.
+    #
+    #   For usage information about the JSON format for result sets, see
+    #   [Using the Data API][1] in the *Amazon Aurora User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/data-api.html
+    #
     # @return [Types::ExecuteStatementResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
+    #   * {Types::ExecuteStatementResponse#records #records} => Array&lt;Array&lt;Types::Field&gt;&gt;
     #   * {Types::ExecuteStatementResponse#column_metadata #column_metadata} => Array&lt;Types::ColumnMetadata&gt;
-    #   * {Types::ExecuteStatementResponse#generated_fields #generated_fields} => Array&lt;Types::Field&gt;
     #   * {Types::ExecuteStatementResponse#number_of_records_updated #number_of_records_updated} => Integer
-    #   * {Types::ExecuteStatementResponse#records #records} => Array&lt;Array&lt;Types::Field&gt;&gt;
+    #   * {Types::ExecuteStatementResponse#generated_fields #generated_fields} => Array&lt;Types::Field&gt;
+    #   * {Types::ExecuteStatementResponse#formatted_records #formatted_records} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.execute_statement({
-    #     continue_after_timeout: false,
+    #     resource_arn: "Arn", # required
+    #     secret_arn: "Arn", # required
+    #     sql: "SqlStatement", # required
     #     database: "DbName",
-    #     include_result_metadata: false,
+    #     schema: "DbName",
     #     parameters: [
     #       {
     #         name: "ParameterName",
-    #         type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
     #         value: {
+    #           is_null: false,
+    #           boolean_value: false,
+    #           long_value: 1,
+    #           double_value: 1.0,
+    #           string_value: "String",
+    #           blob_value: "data",
     #           array_value: {
+    #             boolean_values: [false],
+    #             long_values: [1],
+    #             double_values: [1.0],
+    #             string_values: ["String"],
     #             array_values: [
     #               {
     #                 # recursive ArrayValue
     #               },
     #             ],
-    #             boolean_values: [false],
-    #             double_values: [1.0],
-    #             long_values: [1],
-    #             string_values: ["String"],
     #           },
-    #           blob_value: "data",
-    #           boolean_value: false,
-    #           double_value: 1.0,
-    #           is_null: false,
-    #           long_value: 1,
-    #           string_value: "String",
     #         },
+    #         type_hint: "JSON", # accepts JSON, UUID, TIMESTAMP, DATE, TIME, DECIMAL
     #       },
     #     ],
-    #     resource_arn: "Arn", # required
+    #     transaction_id: "Id",
+    #     include_result_metadata: false,
+    #     continue_after_timeout: false,
     #     result_set_options: {
     #       decimal_return_type: "STRING", # accepts STRING, DOUBLE_OR_LONG
+    #       long_return_type: "STRING", # accepts STRING, LONG
     #     },
-    #     schema: "DbName",
-    #     secret_arn: "Arn", # required
-    #     sql: "SqlStatement", # required
-    #     transaction_id: "Id",
+    #     format_records_as: "NONE", # accepts NONE, JSON
     #   })
     #
     # @example Response structure
     #
+    #   resp.records #=> Array
+    #   resp.records[0] #=> Array
+    #   resp.records[0][0].is_null #=> Boolean
+    #   resp.records[0][0].boolean_value #=> Boolean
+    #   resp.records[0][0].long_value #=> Integer
+    #   resp.records[0][0].double_value #=> Float
+    #   resp.records[0][0].string_value #=> String
+    #   resp.records[0][0].blob_value #=> String
+    #   resp.records[0][0].array_value.boolean_values #=> Array
+    #   resp.records[0][0].array_value.boolean_values[0] #=> Boolean
+    #   resp.records[0][0].array_value.long_values #=> Array
+    #   resp.records[0][0].array_value.long_values[0] #=> Integer
+    #   resp.records[0][0].array_value.double_values #=> Array
+    #   resp.records[0][0].array_value.double_values[0] #=> Float
+    #   resp.records[0][0].array_value.string_values #=> Array
+    #   resp.records[0][0].array_value.string_values[0] #=> String
+    #   resp.records[0][0].array_value.array_values #=> Array
+    #   resp.records[0][0].array_value.array_values[0] #=> Types::ArrayValue
     #   resp.column_metadata #=> Array
-    #   resp.column_metadata[0].array_base_column_type #=> Integer
+    #   resp.column_metadata[0].name #=> String
+    #   resp.column_metadata[0].type #=> Integer
+    #   resp.column_metadata[0].type_name #=> String
+    #   resp.column_metadata[0].label #=> String
+    #   resp.column_metadata[0].schema_name #=> String
+    #   resp.column_metadata[0].table_name #=> String
     #   resp.column_metadata[0].is_auto_increment #=> Boolean
-    #   resp.column_metadata[0].is_case_sensitive #=> Boolean
-    #   resp.column_metadata[0].is_currency #=> Boolean
     #   resp.column_metadata[0].is_signed #=> Boolean
-    #   resp.column_metadata[0].label #=> String
-    #   resp.column_metadata[0].name #=> String
+    #   resp.column_metadata[0].is_currency #=> Boolean
+    #   resp.column_metadata[0].is_case_sensitive #=> Boolean
     #   resp.column_metadata[0].nullable #=> Integer
     #   resp.column_metadata[0].precision #=> Integer
     #   resp.column_metadata[0].scale #=> Integer
-    #   resp.column_metadata[0].schema_name #=> String
-    #   resp.column_metadata[0].table_name #=> String
-    #   resp.column_metadata[0].type #=> Integer
-    #   resp.column_metadata[0].type_name #=> String
+    #   resp.column_metadata[0].array_base_column_type #=> Integer
+    #   resp.number_of_records_updated #=> Integer
     #   resp.generated_fields #=> Array
-    #   resp.generated_fields[0].array_value.array_values #=> Array
-    #   resp.generated_fields[0].array_value.array_values[0] #=> Types::ArrayValue
+    #   resp.generated_fields[0].is_null #=> Boolean
+    #   resp.generated_fields[0].boolean_value #=> Boolean
+    #   resp.generated_fields[0].long_value #=> Integer
+    #   resp.generated_fields[0].double_value #=> Float
+    #   resp.generated_fields[0].string_value #=> String
+    #   resp.generated_fields[0].blob_value #=> String
     #   resp.generated_fields[0].array_value.boolean_values #=> Array
     #   resp.generated_fields[0].array_value.boolean_values[0] #=> Boolean
-    #   resp.generated_fields[0].array_value.double_values #=> Array
-    #   resp.generated_fields[0].array_value.double_values[0] #=> Float
     #   resp.generated_fields[0].array_value.long_values #=> Array
     #   resp.generated_fields[0].array_value.long_values[0] #=> Integer
+    #   resp.generated_fields[0].array_value.double_values #=> Array
+    #   resp.generated_fields[0].array_value.double_values[0] #=> Float
     #   resp.generated_fields[0].array_value.string_values #=> Array
     #   resp.generated_fields[0].array_value.string_values[0] #=> String
-    #   resp.generated_fields[0].blob_value #=> String
-    #   resp.generated_fields[0].boolean_value #=> Boolean
-    #   resp.generated_fields[0].double_value #=> Float
-    #   resp.generated_fields[0].is_null #=> Boolean
-    #   resp.generated_fields[0].long_value #=> Integer
-    #   resp.generated_fields[0].string_value #=> String
-    #   resp.number_of_records_updated #=> Integer
-    #   resp.records #=> Array
-    #   resp.records[0] #=> Array
-    #   resp.records[0][0].array_value.array_values #=> Array
-    #   resp.records[0][0].array_value.array_values[0] #=> Types::ArrayValue
-    #   resp.records[0][0].array_value.boolean_values #=> Array
-    #   resp.records[0][0].array_value.boolean_values[0] #=> Boolean
-    #   resp.records[0][0].array_value.double_values #=> Array
-    #   resp.records[0][0].array_value.double_values[0] #=> Float
-    #   resp.records[0][0].array_value.long_values #=> Array
-    #   resp.records[0][0].array_value.long_values[0] #=> Integer
-    #   resp.records[0][0].array_value.string_values #=> Array
-    #   resp.records[0][0].array_value.string_values[0] #=> String
-    #   resp.records[0][0].blob_value #=> String
-    #   resp.records[0][0].boolean_value #=> Boolean
-    #   resp.records[0][0].double_value #=> Float
-    #   resp.records[0][0].is_null #=> Boolean
-    #   resp.records[0][0].long_value #=> Integer
-    #   resp.records[0][0].string_value #=> String
+    #   resp.generated_fields[0].array_value.array_values #=> Array
+    #   resp.generated_fields[0].array_value.array_values[0] #=> Types::ArrayValue
+    #   resp.formatted_records #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-data-2018-08-01/ExecuteStatement AWS API Documentation
     #
@@ -855,7 +929,7 @@ module Aws::RDSDataService
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rdsdataservice'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.37.0'
       Seahorse::Client::Request.new(handlers, context)
     end