Interface RdsDataAsyncClient
- All Superinterfaces:
AutoCloseable
,AwsClient
,SdkAutoCloseable
,SdkClient
builder()
method.The asynchronous client performs non-blocking I/O when configured with any
SdkAsyncHttpClient
supported in the SDK. However, full non-blocking is not guaranteed as the async client may
perform blocking calls in some cases such as credentials retrieval and endpoint discovery as part of the async API
call.
Amazon RDS provides an HTTP endpoint to run SQL statements on an Amazon Aurora DB cluster. To run these statements, you use the RDS Data API (Data API).
Data API is available with the following types of Aurora databases:
-
Aurora PostgreSQL - Serverless v2, Serverless v1, and provisioned
-
Aurora MySQL - Serverless v1 only
For more information about the Data API, see Using RDS Data API in the Amazon Aurora User Guide.
-
Field Summary
Modifier and TypeFieldDescriptionstatic final String
Value for looking up the service's metadata from theServiceMetadataProvider
.static final String
-
Method Summary
Modifier and TypeMethodDescriptionbatchExecuteStatement
(Consumer<BatchExecuteStatementRequest.Builder> batchExecuteStatementRequest) Runs a batch SQL statement over an array of data.batchExecuteStatement
(BatchExecuteStatementRequest batchExecuteStatementRequest) Runs a batch SQL statement over an array of data.beginTransaction
(Consumer<BeginTransactionRequest.Builder> beginTransactionRequest) Starts a SQL transaction.beginTransaction
(BeginTransactionRequest beginTransactionRequest) Starts a SQL transaction.static RdsDataAsyncClientBuilder
builder()
Create a builder that can be used to configure and create aRdsDataAsyncClient
.commitTransaction
(Consumer<CommitTransactionRequest.Builder> commitTransactionRequest) Ends a SQL transaction started with theBeginTransaction
operation and commits the changes.commitTransaction
(CommitTransactionRequest commitTransactionRequest) Ends a SQL transaction started with theBeginTransaction
operation and commits the changes.static RdsDataAsyncClient
create()
Create aRdsDataAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
.default CompletableFuture
<ExecuteSqlResponse> executeSql
(Consumer<ExecuteSqlRequest.Builder> executeSqlRequest) Deprecated.The ExecuteSql API is deprecated, please use the ExecuteStatement API.default CompletableFuture
<ExecuteSqlResponse> executeSql
(ExecuteSqlRequest executeSqlRequest) Deprecated.The ExecuteSql API is deprecated, please use the ExecuteStatement API.executeStatement
(Consumer<ExecuteStatementRequest.Builder> executeStatementRequest) Runs a SQL statement against a database.executeStatement
(ExecuteStatementRequest executeStatementRequest) Runs a SQL statement against a database.rollbackTransaction
(Consumer<RollbackTransactionRequest.Builder> rollbackTransactionRequest) Performs a rollback of a transaction.rollbackTransaction
(RollbackTransactionRequest rollbackTransactionRequest) Performs a rollback of a transaction.The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfigurationMethods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close
Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName
-
Field Details
-
SERVICE_NAME
- See Also:
-
SERVICE_METADATA_ID
Value for looking up the service's metadata from theServiceMetadataProvider
.- See Also:
-
-
Method Details
-
batchExecuteStatement
default CompletableFuture<BatchExecuteStatementResponse> batchExecuteStatement(BatchExecuteStatementRequest batchExecuteStatementRequest) Runs a batch SQL statement over an array of data.
You can run bulk update and insert operations for multiple records using a DML statement with different parameter sets. Bulk operations 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
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.
- Parameters:
batchExecuteStatementRequest
- The request parameters represent the input of a SQL statement over an array of data.- Returns:
- A Java Future containing the result of the BatchExecuteStatement operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
batchExecuteStatement
default CompletableFuture<BatchExecuteStatementResponse> batchExecuteStatement(Consumer<BatchExecuteStatementRequest.Builder> batchExecuteStatementRequest) Runs a batch SQL statement over an array of data.
You can run bulk update and insert operations for multiple records using a DML statement with different parameter sets. Bulk operations 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
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.
This is a convenience which creates an instance of the
BatchExecuteStatementRequest.Builder
avoiding the need to create one manually viaBatchExecuteStatementRequest.builder()
- Parameters:
batchExecuteStatementRequest
- AConsumer
that will call methods onBatchExecuteStatementRequest.Builder
to create a request. The request parameters represent the input of a SQL statement over an array of data.- Returns:
- A Java Future containing the result of the BatchExecuteStatement operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
beginTransaction
default CompletableFuture<BeginTransactionResponse> beginTransaction(BeginTransactionRequest beginTransactionRequest) Starts a SQL transaction.
A transaction can run for a maximum of 24 hours. A transaction is terminated and rolled back automatically after 24 hours.
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 withcontinueAfterTimeout
enabled.- Parameters:
beginTransactionRequest
- The request parameters represent the input of a request to start a SQL transaction.- Returns:
- A Java Future containing the result of the BeginTransaction operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
beginTransaction
default CompletableFuture<BeginTransactionResponse> beginTransaction(Consumer<BeginTransactionRequest.Builder> beginTransactionRequest) Starts a SQL transaction.
A transaction can run for a maximum of 24 hours. A transaction is terminated and rolled back automatically after 24 hours.
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 withcontinueAfterTimeout
enabled.
This is a convenience which creates an instance of the
BeginTransactionRequest.Builder
avoiding the need to create one manually viaBeginTransactionRequest.builder()
- Parameters:
beginTransactionRequest
- AConsumer
that will call methods onBeginTransactionRequest.Builder
to create a request. The request parameters represent the input of a request to start a SQL transaction.- Returns:
- A Java Future containing the result of the BeginTransaction operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
commitTransaction
default CompletableFuture<CommitTransactionResponse> commitTransaction(CommitTransactionRequest commitTransactionRequest) Ends a SQL transaction started with the
BeginTransaction
operation and commits the changes.- Parameters:
commitTransactionRequest
- The request parameters represent the input of a commit transaction request.- Returns:
- A Java Future containing the result of the CommitTransaction operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- NotFoundException The
resourceArn
,secretArn
, ortransactionId
value can't be found. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
commitTransaction
default CompletableFuture<CommitTransactionResponse> commitTransaction(Consumer<CommitTransactionRequest.Builder> commitTransactionRequest) Ends a SQL transaction started with the
BeginTransaction
operation and commits the changes.
This is a convenience which creates an instance of the
CommitTransactionRequest.Builder
avoiding the need to create one manually viaCommitTransactionRequest.builder()
- Parameters:
commitTransactionRequest
- AConsumer
that will call methods onCommitTransactionRequest.Builder
to create a request. The request parameters represent the input of a commit transaction request.- Returns:
- A Java Future containing the result of the CommitTransaction operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- NotFoundException The
resourceArn
,secretArn
, ortransactionId
value can't be found. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
executeSql
@Deprecated default CompletableFuture<ExecuteSqlResponse> executeSql(ExecuteSqlRequest executeSqlRequest) Deprecated.The ExecuteSql API is deprecated, please use the ExecuteStatement API.Runs one or more SQL statements.
This operation isn't supported for Aurora PostgreSQL Serverless v2 and provisioned DB clusters, and for Aurora Serverless v1 DB clusters, the operation is deprecated. Use the
BatchExecuteStatement
orExecuteStatement
operation.- Parameters:
executeSqlRequest
- The request parameters represent the input of a request to run one or more SQL statements.- Returns:
- A Java Future containing the result of the ExecuteSql operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- InternalServerErrorException An internal error occurred.
- ForbiddenException There are insufficient privileges to make the call.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
executeSql
@Deprecated default CompletableFuture<ExecuteSqlResponse> executeSql(Consumer<ExecuteSqlRequest.Builder> executeSqlRequest) Deprecated.The ExecuteSql API is deprecated, please use the ExecuteStatement API.Runs one or more SQL statements.
This operation isn't supported for Aurora PostgreSQL Serverless v2 and provisioned DB clusters, and for Aurora Serverless v1 DB clusters, the operation is deprecated. Use the
BatchExecuteStatement
orExecuteStatement
operation.
This is a convenience which creates an instance of the
ExecuteSqlRequest.Builder
avoiding the need to create one manually viaExecuteSqlRequest.builder()
- Parameters:
executeSqlRequest
- AConsumer
that will call methods onExecuteSqlRequest.Builder
to create a request. The request parameters represent the input of a request to run one or more SQL statements.- Returns:
- A Java Future containing the result of the ExecuteSql operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- InternalServerErrorException An internal error occurred.
- ForbiddenException There are insufficient privileges to make the call.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- See Also:
-
executeStatement
default CompletableFuture<ExecuteStatementResponse> executeStatement(ExecuteStatementRequest executeStatementRequest) Runs a SQL statement against a database.
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.If the binary response data from the database is more than 1 MB, the call is terminated.
- Parameters:
executeStatementRequest
- The request parameters represent the input of a request to run a SQL statement against a database.- Returns:
- A Java Future containing the result of the ExecuteStatement operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- UnsupportedResultException There was a problem with the result because of one of the following
conditions:
-
It contained an unsupported data type.
-
It contained a multidimensional array.
-
The size was too large.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
executeStatement
default CompletableFuture<ExecuteStatementResponse> executeStatement(Consumer<ExecuteStatementRequest.Builder> executeStatementRequest) Runs a SQL statement against a database.
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.If the binary response data from the database is more than 1 MB, the call is terminated.
This is a convenience which creates an instance of the
ExecuteStatementRequest.Builder
avoiding the need to create one manually viaExecuteStatementRequest.builder()
- Parameters:
executeStatementRequest
- AConsumer
that will call methods onExecuteStatementRequest.Builder
to create a request. The request parameters represent the input of a request to run a SQL statement against a database.- Returns:
- A Java Future containing the result of the ExecuteStatement operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- UnsupportedResultException There was a problem with the result because of one of the following
conditions:
-
It contained an unsupported data type.
-
It contained a multidimensional array.
-
The size was too large.
-
- SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
rollbackTransaction
default CompletableFuture<RollbackTransactionResponse> rollbackTransaction(RollbackTransactionRequest rollbackTransactionRequest) Performs a rollback of a transaction. Rolling back a transaction cancels its changes.
- Parameters:
rollbackTransactionRequest
- The request parameters represent the input of a request to perform a rollback of a transaction.- Returns:
- A Java Future containing the result of the RollbackTransaction operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- NotFoundException The
resourceArn
,secretArn
, ortransactionId
value can't be found. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
rollbackTransaction
default CompletableFuture<RollbackTransactionResponse> rollbackTransaction(Consumer<RollbackTransactionRequest.Builder> rollbackTransactionRequest) Performs a rollback of a transaction. Rolling back a transaction cancels its changes.
This is a convenience which creates an instance of the
RollbackTransactionRequest.Builder
avoiding the need to create one manually viaRollbackTransactionRequest.builder()
- Parameters:
rollbackTransactionRequest
- AConsumer
that will call methods onRollbackTransactionRequest.Builder
to create a request. The request parameters represent the input of a request to perform a rollback of a transaction.- Returns:
- A Java Future containing the result of the RollbackTransaction operation returned by the service.
The CompletableFuture returned by this method can be completed exceptionally with the following exceptions. The exception returned is wrapped with CompletionException, so you need to invokeThrowable.getCause()
to retrieve the underlying exception.- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
-
RDS Data API timed out retrieving the secret.
-
The secret provided wasn't found.
-
The secret couldn't be decrypted.
-
- HttpEndpointNotEnabledException The HTTP endpoint for using RDS Data API isn't enabled for the DB cluster.
- DatabaseErrorException There was an error in processing the SQL statement.
- DatabaseUnavailableException The writer instance in the DB cluster isn't available.
- TransactionNotFoundException The transaction ID wasn't found.
- InvalidSecretException The Secrets Manager secret used with the request isn't valid.
- ServiceUnavailableErrorException The service specified by the
resourceArn
parameter isn't available. - ForbiddenException There are insufficient privileges to make the call.
- DatabaseNotFoundException The DB cluster doesn't have a DB instance.
- AccessDeniedException You don't have sufficient access to perform this action.
- BadRequestException There is an error in the call or in a SQL statement. (This error only appears in calls from Aurora Serverless v1 databases.)
- StatementTimeoutException The execution of the SQL statement timed out.
- InternalServerErrorException An internal error occurred.
- NotFoundException The
resourceArn
,secretArn
, ortransactionId
value can't be found. - SdkException Base class for all exceptions that can be thrown by the SDK (both service and client). Can be used for catch all scenarios.
- SdkClientException If any client side error occurs such as an IO related failure, failure to get credentials, etc.
- RdsDataException Base class for all service exceptions. Unknown exceptions will be thrown as an instance of this type.
- SecretsErrorException There was a problem with the Secrets Manager secret used with the request,
caused by one of the following conditions:
- See Also:
-
serviceClientConfiguration
Description copied from interface:SdkClient
The SDK service client configuration exposes client settings to the user, e.g., ClientOverrideConfiguration- Specified by:
serviceClientConfiguration
in interfaceAwsClient
- Specified by:
serviceClientConfiguration
in interfaceSdkClient
- Returns:
- SdkServiceClientConfiguration
-
create
Create aRdsDataAsyncClient
with the region loaded from theDefaultAwsRegionProviderChain
and credentials loaded from theDefaultCredentialsProvider
. -
builder
Create a builder that can be used to configure and create aRdsDataAsyncClient
.
-