Interface ExecuteStatementRequest.Builder
- All Superinterfaces:
AwsRequest.Builder
,Buildable
,CopyableBuilder<ExecuteStatementRequest.Builder,
,ExecuteStatementRequest> RdsDataRequest.Builder
,SdkBuilder<ExecuteStatementRequest.Builder,
,ExecuteStatementRequest> SdkPojo
,SdkRequest.Builder
- Enclosing class:
ExecuteStatementRequest
-
Method Summary
Modifier and TypeMethodDescriptioncontinueAfterTimeout
(Boolean continueAfterTimeout) A value that indicates whether to continue running the statement after the call times out.The name of the database.formatRecordsAs
(String formatRecordsAs) A value that indicates whether to format the result set as a single JSON string.formatRecordsAs
(RecordsFormatType formatRecordsAs) A value that indicates whether to format the result set as a single JSON string.includeResultMetadata
(Boolean includeResultMetadata) A value that indicates whether to include metadata in the results.overrideConfiguration
(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Add an optional request override configuration.overrideConfiguration
(AwsRequestOverrideConfiguration overrideConfiguration) Add an optional request override configuration.parameters
(Collection<SqlParameter> parameters) The parameters for the SQL statement.parameters
(Consumer<SqlParameter.Builder>... parameters) The parameters for the SQL statement.parameters
(SqlParameter... parameters) The parameters for the SQL statement.resourceArn
(String resourceArn) The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.default ExecuteStatementRequest.Builder
resultSetOptions
(Consumer<ResultSetOptions.Builder> resultSetOptions) Options that control how the result set is returned.resultSetOptions
(ResultSetOptions resultSetOptions) Options that control how the result set is returned.The name of the database schema.The ARN of the secret that enables access to the DB cluster.The SQL statement to run.transactionId
(String transactionId) The identifier of a transaction that was started by using theBeginTransaction
operation.Methods inherited from interface software.amazon.awssdk.awscore.AwsRequest.Builder
overrideConfiguration
Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder
copy
Methods inherited from interface software.amazon.awssdk.services.rdsdata.model.RdsDataRequest.Builder
build
Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder
applyMutation, build
Methods inherited from interface software.amazon.awssdk.core.SdkPojo
equalsBySdkFields, sdkFieldNameToField, sdkFields
-
Method Details
-
resourceArn
The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.
- Parameters:
resourceArn
- The Amazon Resource Name (ARN) of the Aurora Serverless DB cluster.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
secretArn
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.
- Parameters:
secretArn
- 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.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
sql
The SQL statement to run.
- Parameters:
sql
- The SQL statement to run.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
database
The name of the database.
- Parameters:
database
- The name of the database.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
schema
The name of the database schema.
Currently, the
schema
parameter isn't supported.- Parameters:
schema
- The name of the database schema.Currently, the
schema
parameter isn't supported.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
The parameters for the SQL statement.
Array parameters are not supported.
- Parameters:
parameters
- The parameters for the SQL statement.Array parameters are not supported.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
The parameters for the SQL statement.
Array parameters are not supported.
- Parameters:
parameters
- The parameters for the SQL statement.Array parameters are not supported.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
parameters
The parameters for the SQL statement.
Array parameters are not supported.
SqlParameter.Builder
avoiding the need to create one manually viaSqlParameter.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toparameters(List<SqlParameter>)
.- Parameters:
parameters
- a consumer that will call methods onSqlParameter.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
transactionId
The identifier of a transaction that was started by using the
BeginTransaction
operation. Specify the transaction ID of the transaction that you want to include the SQL statement in.If the SQL statement is not part of a transaction, don't set this parameter.
- Parameters:
transactionId
- The identifier of a transaction that was started by using theBeginTransaction
operation. Specify the transaction ID of the transaction that you want to include the SQL statement in.If the SQL statement is not part of a transaction, don't set this parameter.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
includeResultMetadata
A value that indicates whether to include metadata in the results.
- Parameters:
includeResultMetadata
- A value that indicates whether to include metadata in the results.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
continueAfterTimeout
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.
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.
- Parameters:
continueAfterTimeout
- 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.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.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
resultSetOptions
Options that control how the result set is returned.
- Parameters:
resultSetOptions
- Options that control how the result set is returned.- Returns:
- Returns a reference to this object so that method calls can be chained together.
-
resultSetOptions
default ExecuteStatementRequest.Builder resultSetOptions(Consumer<ResultSetOptions.Builder> resultSetOptions) Options that control how the result set is returned.
This is a convenience method that creates an instance of theResultSetOptions.Builder
avoiding the need to create one manually viaResultSetOptions.builder()
.When the
Consumer
completes,SdkBuilder.build()
is called immediately and its result is passed toresultSetOptions(ResultSetOptions)
.- Parameters:
resultSetOptions
- a consumer that will call methods onResultSetOptions.Builder
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
formatRecordsAs
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 areNONE
andJSON
. The default value isNONE
. The result is returned in theformattedRecords
field.For usage information about the JSON format for result sets, see Using the Data API in the Amazon Aurora User Guide.
- Parameters:
formatRecordsAs
- A value that indicates whether to format the result set as a single JSON string. This parameter only applies toSELECT
statements and is ignored for other types of statements. Allowed values areNONE
andJSON
. The default value isNONE
. The result is returned in theformattedRecords
field.For usage information about the JSON format for result sets, see Using the Data API in the Amazon Aurora User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
formatRecordsAs
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 areNONE
andJSON
. The default value isNONE
. The result is returned in theformattedRecords
field.For usage information about the JSON format for result sets, see Using the Data API in the Amazon Aurora User Guide.
- Parameters:
formatRecordsAs
- A value that indicates whether to format the result set as a single JSON string. This parameter only applies toSELECT
statements and is ignored for other types of statements. Allowed values areNONE
andJSON
. The default value isNONE
. The result is returned in theformattedRecords
field.For usage information about the JSON format for result sets, see Using the Data API in the Amazon Aurora User Guide.
- Returns:
- Returns a reference to this object so that method calls can be chained together.
- See Also:
-
overrideConfiguration
ExecuteStatementRequest.Builder overrideConfiguration(AwsRequestOverrideConfiguration overrideConfiguration) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
overrideConfiguration
- The override configuration.- Returns:
- This object for method chaining.
-
overrideConfiguration
ExecuteStatementRequest.Builder overrideConfiguration(Consumer<AwsRequestOverrideConfiguration.Builder> builderConsumer) Description copied from interface:AwsRequest.Builder
Add an optional request override configuration.- Specified by:
overrideConfiguration
in interfaceAwsRequest.Builder
- Parameters:
builderConsumer
- AConsumer
to which an emptyAwsRequestOverrideConfiguration.Builder
will be given.- Returns:
- This object for method chaining.
-