RdsDataAsyncClient (AWS Java SDK :: Services

All Superinterfaces:

AutoCloseable, SdkAutoCloseable, SdkClient
```
@Generated(value="software.amazon.awssdk:codegen")
public interface RdsDataAsyncClient
extends SdkClient
```
Service client for accessing AWS RDS DataService asynchronously. This can be created using the static builder() method.
Amazon RDS Data Service
Amazon RDS provides an HTTP endpoint to run SQL statements on an Amazon Aurora Serverless DB cluster. To run these statements, you work with the Data Service API.

For more information about the Data Service API, see Using the Data API for Aurora Serverless in the Amazon Aurora User Guide.

If you have questions or comments related to the Data API, send email to Rds-data-api-feedback@amazon.com.

Field Summary

Fields
Modifier and Type Field and Description

static String SERVICE_NAME

Fields
Modifier and Type	Field and Description
`static String`	`SERVICE_NAME`

Method Summary

All Methods Static Methods Instance Methods Default Methods
Modifier and Type	Method and Description
`default CompletableFuture<BatchExecuteStatementResponse>`	`batchExecuteStatement(BatchExecuteStatementRequest batchExecuteStatementRequest)` Runs a batch SQL statement over an array of data.
`default CompletableFuture<BatchExecuteStatementResponse>`	`batchExecuteStatement(Consumer<BatchExecuteStatementRequest.Builder> batchExecuteStatementRequest)` Runs a batch SQL statement over an array of data.
`default CompletableFuture<BeginTransactionResponse>`	`beginTransaction(BeginTransactionRequest beginTransactionRequest)` Starts a SQL transaction.
`default CompletableFuture<BeginTransactionResponse>`	`beginTransaction(Consumer<BeginTransactionRequest.Builder> beginTransactionRequest)` Starts a SQL transaction.
`static RdsDataAsyncClientBuilder`	`builder()` Create a builder that can be used to configure and create a `RdsDataAsyncClient`.
`default CompletableFuture<CommitTransactionResponse>`	`commitTransaction(CommitTransactionRequest commitTransactionRequest)` Ends a SQL transaction started with the `BeginTransaction` operation and commits the changes.
`default CompletableFuture<CommitTransactionResponse>`	`commitTransaction(Consumer<CommitTransactionRequest.Builder> commitTransactionRequest)` Ends a SQL transaction started with the `BeginTransaction` operation and commits the changes.
`static RdsDataAsyncClient`	`create()` Create a `RdsDataAsyncClient` with the region loaded from the `DefaultAwsRegionProviderChain` and credentials loaded from the `DefaultCredentialsProvider`.
`default CompletableFuture<ExecuteSqlResponse>`	`executeSql(Consumer<ExecuteSqlRequest.Builder> executeSqlRequest)` Runs one or more SQL statements.
`default CompletableFuture<ExecuteSqlResponse>`	`executeSql(ExecuteSqlRequest executeSqlRequest)` Runs one or more SQL statements.
`default CompletableFuture<ExecuteStatementResponse>`	`executeStatement(Consumer<ExecuteStatementRequest.Builder> executeStatementRequest)` Runs a SQL statement against a database.
`default CompletableFuture<ExecuteStatementResponse>`	`executeStatement(ExecuteStatementRequest executeStatementRequest)` Runs a SQL statement against a database.
`default CompletableFuture<RollbackTransactionResponse>`	`rollbackTransaction(Consumer<RollbackTransactionRequest.Builder> rollbackTransactionRequest)` Performs a rollback of a transaction.
`default CompletableFuture<RollbackTransactionResponse>`	`rollbackTransaction(RollbackTransactionRequest rollbackTransactionRequest)` Performs a rollback of a transaction.

Methods inherited from interface software.amazon.awssdk.core.SdkClient
serviceName

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable
close

- Field Detail
 - SERVICE_NAME
```
static final String SERVICE_NAME
```
 See Also:
 
 Constant Field Values
- Method Detail
 - create
```
static RdsDataAsyncClient create()
```
 Create a RdsDataAsyncClient with the region loaded from the DefaultAwsRegionProviderChain and credentials loaded from the DefaultCredentialsProvider.
 - builder
```
static RdsDataAsyncClientBuilder builder()
```
 Create a builder that can be used to configure and create a RdsDataAsyncClient.
 - 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.
 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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - 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.
 
 This is a convenience which creates an instance of the BatchExecuteStatementRequest.Builder avoiding the need to create one manually via BatchExecuteStatementRequest.builder()
 Parameters:
 
 batchExecuteStatementRequest - A Consumer that will call methods on BatchExecuteStatementRequest.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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - beginTransaction
```
default CompletableFuture<BeginTransactionResponse> beginTransaction(BeginTransactionRequest beginTransactionRequest)
```
 Starts a SQL transaction.
```
 <important> 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 <code>ExecuteStatement</code> call with <code>continueAfterTimeout</code> enabled. </important> 
 
```
 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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - beginTransaction
```
default CompletableFuture<BeginTransactionResponse> beginTransaction(Consumer<BeginTransactionRequest.Builder> beginTransactionRequest)
```
 Starts a SQL transaction.
```
 <important> 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 <code>ExecuteStatement</code> call with <code>continueAfterTimeout</code> enabled. </important> 
 
```
 This is a convenience which creates an instance of the BeginTransactionRequest.Builder avoiding the need to create one manually via BeginTransactionRequest.builder()
 Parameters:
 
 beginTransactionRequest - A Consumer that will call methods on BeginTransactionRequest.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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - 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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not available.
 
 NotFoundException The resourceArn, secretArn, or transactionId 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.
 See Also:
 
 AWS API Documentation
 - 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 via CommitTransactionRequest.builder()
 Parameters:
 
 commitTransactionRequest - A Consumer that will call methods on CommitTransactionRequest.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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not available.
 
 NotFoundException The resourceArn, secretArn, or transactionId 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.
 See Also:
 
 AWS API Documentation
 - executeSql
```
default CompletableFuture<ExecuteSqlResponse> executeSql(ExecuteSqlRequest executeSqlRequest)
```
 Runs one or more SQL statements.
 
 This operation is deprecated. Use the BatchExecuteStatement or ExecuteStatement 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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - executeSql
```
default CompletableFuture<ExecuteSqlResponse> executeSql(Consumer<ExecuteSqlRequest.Builder> executeSqlRequest)
```
 Runs one or more SQL statements.
 
 This operation is deprecated. Use the BatchExecuteStatement or ExecuteStatement operation.
 
 This is a convenience which creates an instance of the ExecuteSqlRequest.Builder avoiding the need to create one manually via ExecuteSqlRequest.builder()
 Parameters:
 
 executeSqlRequest - A Consumer that will call methods on ExecuteSqlRequest.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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - 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.
 
 The response size limit is 1 MB. If the call returns more than 1 MB of response data, 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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - 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.
 
 The response size limit is 1 MB. If the call returns more than 1 MB of response data, the call is terminated.
 
 This is a convenience which creates an instance of the ExecuteStatementRequest.Builder avoiding the need to create one manually via ExecuteStatementRequest.builder()
 Parameters:
 
 executeStatementRequest - A Consumer that will call methods on ExecuteStatementRequest.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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not 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:
 
 AWS API Documentation
 - 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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not available.
 
 NotFoundException The resourceArn, secretArn, or transactionId 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.
 See Also:
 
 AWS API Documentation
 - 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 via RollbackTransactionRequest.builder()
 Parameters:
 
 rollbackTransactionRequest - A Consumer that will call methods on RollbackTransactionRequest.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.
 
 BadRequestException There is an error in the call or in a SQL statement.
 
 StatementTimeoutException The execution of the SQL statement timed out.
 
 InternalServerErrorException An internal error occurred.
 
 ForbiddenException There are insufficient privileges to make the call.
 
 ServiceUnavailableErrorException The service specified by the resourceArn parameter is not available.
 
 NotFoundException The resourceArn, secretArn, or transactionId 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.
 See Also:
 
 AWS API Documentation

Interface RdsDataAsyncClient

Field Summary

Method Summary

Methods inherited from interface software.amazon.awssdk.core.SdkClient

Methods inherited from interface software.amazon.awssdk.utils.SdkAutoCloseable

Field Detail

SERVICE_NAME

Method Detail

create

builder

batchExecuteStatement

batchExecuteStatement

beginTransaction

beginTransaction

commitTransaction

commitTransaction

executeSql

executeSql

executeStatement

executeStatement

rollbackTransaction

rollbackTransaction