@ThreadSafe @Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AWSRDSDataAsyncClient extends AWSRDSDataClient implements AWSRDSDataAsync
AsyncHandler can be used to receive
notification when an asynchronous operation completes.
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.
LOGGING_AWS_REQUEST_METRICENDPOINT_PREFIXbatchExecuteStatement, beginTransaction, builder, commitTransaction, executeSql, executeStatement, getCachedResponseMetadata, rollbackTransactionaddRequestHandler, addRequestHandler, configureRegion, getClientConfiguration, getEndpointPrefix, getMonitoringListeners, getRequestMetricsCollector, getServiceName, getSignerByURI, getSignerOverride, getSignerRegionOverride, getTimeOffset, makeImmutable, removeRequestHandler, removeRequestHandler, setEndpoint, setEndpoint, setRegion, setServiceNameIntern, setSignerRegionOverride, setTimeOffset, withEndpoint, withRegion, withRegion, withTimeOffsetequals, getClass, hashCode, notify, notifyAll, toString, wait, wait, waitbatchExecuteStatement, beginTransaction, commitTransaction, executeSql, executeStatement, getCachedResponseMetadata, rollbackTransactionpublic static AWSRDSDataAsyncClientBuilder asyncBuilder()
public ExecutorService getExecutorService()
public Future<BatchExecuteStatementResult> batchExecuteStatementAsync(BatchExecuteStatementRequest request)
AWSRDSDataAsyncRuns 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.
batchExecuteStatementAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a SQL statement over an array of data.public Future<BatchExecuteStatementResult> batchExecuteStatementAsync(BatchExecuteStatementRequest request, AsyncHandler<BatchExecuteStatementRequest,BatchExecuteStatementResult> asyncHandler)
AWSRDSDataAsyncRuns 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.
batchExecuteStatementAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a SQL statement over an array of data.asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<BeginTransactionResult> beginTransactionAsync(BeginTransactionRequest request)
AWSRDSDataAsyncStarts 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>
beginTransactionAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to start a SQL transaction.public Future<BeginTransactionResult> beginTransactionAsync(BeginTransactionRequest request, AsyncHandler<BeginTransactionRequest,BeginTransactionResult> asyncHandler)
AWSRDSDataAsyncStarts 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>
beginTransactionAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to start a SQL transaction.asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<CommitTransactionResult> commitTransactionAsync(CommitTransactionRequest request)
AWSRDSDataAsync
Ends a SQL transaction started with the BeginTransaction operation and commits the changes.
commitTransactionAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a commit transaction request.public Future<CommitTransactionResult> commitTransactionAsync(CommitTransactionRequest request, AsyncHandler<CommitTransactionRequest,CommitTransactionResult> asyncHandler)
AWSRDSDataAsync
Ends a SQL transaction started with the BeginTransaction operation and commits the changes.
commitTransactionAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a commit transaction request.asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.@Deprecated public Future<ExecuteSqlResult> executeSqlAsync(ExecuteSqlRequest request)
AWSRDSDataAsyncRuns one or more SQL statements.
This operation is deprecated. Use the BatchExecuteStatement or ExecuteStatement
operation.
executeSqlAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to run one or more SQL statements.@Deprecated public Future<ExecuteSqlResult> executeSqlAsync(ExecuteSqlRequest request, AsyncHandler<ExecuteSqlRequest,ExecuteSqlResult> asyncHandler)
AWSRDSDataAsyncRuns one or more SQL statements.
This operation is deprecated. Use the BatchExecuteStatement or ExecuteStatement
operation.
executeSqlAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to run one or more SQL statements.asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<ExecuteStatementResult> executeStatementAsync(ExecuteStatementRequest request)
AWSRDSDataAsyncRuns 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.
executeStatementAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to run a SQL statement against a database.public Future<ExecuteStatementResult> executeStatementAsync(ExecuteStatementRequest request, AsyncHandler<ExecuteStatementRequest,ExecuteStatementResult> asyncHandler)
AWSRDSDataAsyncRuns 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.
executeStatementAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to run a SQL statement against a database.asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public Future<RollbackTransactionResult> rollbackTransactionAsync(RollbackTransactionRequest request)
AWSRDSDataAsyncPerforms a rollback of a transaction. Rolling back a transaction cancels its changes.
rollbackTransactionAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to perform a rollback of a transaction.public Future<RollbackTransactionResult> rollbackTransactionAsync(RollbackTransactionRequest request, AsyncHandler<RollbackTransactionRequest,RollbackTransactionResult> asyncHandler)
AWSRDSDataAsyncPerforms a rollback of a transaction. Rolling back a transaction cancels its changes.
rollbackTransactionAsync in interface AWSRDSDataAsyncrequest - The request parameters represent the input of a request to perform a rollback of a transaction.asyncHandler - Asynchronous callback handler for events in the lifecycle of the request. Users can provide an
implementation of the callback methods in this interface to receive notification of successful or
unsuccessful completion of the operation.public void shutdown()
getExecutorService().shutdown() followed by getExecutorService().awaitTermination() prior to
calling this method.shutdown in interface AWSRDSDatashutdown in class AWSRDSDataClient