@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAWSRDSData extends Object implements AWSRDSData
AWSRDSData
. Convenient method forms pass through to the corresponding overload
that takes a request object, which throws an UnsupportedOperationException
.ENDPOINT_PREFIX
Modifier and Type | Method and Description |
---|---|
BatchExecuteStatementResult |
batchExecuteStatement(BatchExecuteStatementRequest request)
Runs a batch SQL statement over an array of data.
|
BeginTransactionResult |
beginTransaction(BeginTransactionRequest request)
Starts a SQL transaction.
|
CommitTransactionResult |
commitTransaction(CommitTransactionRequest request)
Ends a SQL transaction started with the
BeginTransaction operation and commits the changes. |
ExecuteSqlResult |
executeSql(ExecuteSqlRequest request)
Deprecated.
|
ExecuteStatementResult |
executeStatement(ExecuteStatementRequest request)
Runs a SQL statement against a database.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
RollbackTransactionResult |
rollbackTransaction(RollbackTransactionRequest request)
Performs a rollback of a transaction.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
public BatchExecuteStatementResult batchExecuteStatement(BatchExecuteStatementRequest request)
AWSRDSData
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.
batchExecuteStatement
in interface AWSRDSData
request
- The request parameters represent the input of a SQL statement over an array of data.public BeginTransactionResult beginTransaction(BeginTransactionRequest request)
AWSRDSData
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 with continueAfterTimeout
enabled.
beginTransaction
in interface AWSRDSData
request
- The request parameters represent the input of a request to start a SQL transaction.public CommitTransactionResult commitTransaction(CommitTransactionRequest request)
AWSRDSData
Ends a SQL transaction started with the BeginTransaction
operation and commits the changes.
commitTransaction
in interface AWSRDSData
request
- The request parameters represent the input of a commit transaction request.@Deprecated public ExecuteSqlResult executeSql(ExecuteSqlRequest request)
AWSRDSData
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
or
ExecuteStatement
operation.
executeSql
in interface AWSRDSData
request
- The request parameters represent the input of a request to run one or more SQL statements.public ExecuteStatementResult executeStatement(ExecuteStatementRequest request)
AWSRDSData
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.
executeStatement
in interface AWSRDSData
request
- The request parameters represent the input of a request to run a SQL statement against a database.public RollbackTransactionResult rollbackTransaction(RollbackTransactionRequest request)
AWSRDSData
Performs a rollback of a transaction. Rolling back a transaction cancels its changes.
rollbackTransaction
in interface AWSRDSData
request
- The request parameters represent the input of a request to perform a rollback of a transaction.public void shutdown()
AWSRDSData
shutdown
in interface AWSRDSData
public ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AWSRDSData
Response metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata
in interface AWSRDSData
request
- The originally executed request.