tech.ydb.table.transaction

Interface TableTransaction

All Superinterfaces:

YdbTransaction

public interface TableTransaction
extends YdbTransaction

Interface of transaction from table service Short-living object allows transactional execution of several queries in one interactive transaction. TableTransaction can be used in implicit mode - without calling commit()/rollback(). When TableTransaction is not active, any execution of a query with commitAtEnd=false starts a new transaction. And execution of a query with commitAtEnd=true commits this transaction.

Author:

Nikolay Perfilov

Method Summary

Modifier and Type	Method and Description
default CompletableFuture<Status>	commit()
CompletableFuture<Status>	commit(CommitTxSettings settings)
default CompletableFuture<Result<DataQueryResult>>	executeDataQuery(String query) Execute DataQuery.
CompletableFuture<Result<DataQueryResult>>	executeDataQuery(String query, boolean commitAtEnd, Params params, ExecuteDataQuerySettings settings) Execute DataQuery
default CompletableFuture<Result<DataQueryResult>>	executeDataQuery(String query, Params params) Execute DataQuery.
default CompletableFuture<Result<DataQueryResult>>	executeDataQueryAndCommit(String query) Execute DataQuery.
default CompletableFuture<Result<DataQueryResult>>	executeDataQueryAndCommit(String query, Params params) Execute DataQuery.
Session	getSession() Returns Session that was used to create this transaction
default CompletableFuture<Status>	rollback()
CompletableFuture<Status>	rollback(RollbackTxSettings settings)

Methods inherited from interface tech.ydb.common.transaction.YdbTransaction

getId, getSessionId, getStatusFuture, getTxMode, isActive

Method Detail

getSession

Session getSession()

Returns Session that was used to create this transaction

Returns:

session that was used to create this transaction

executeDataQuery

CompletableFuture<Result<DataQueryResult>> executeDataQuery(String query,
                                                            boolean commitAtEnd,
                                                            Params params,
                                                            ExecuteDataQuerySettings settings)

Execute DataQuery

Parameters:

query - text of query. Can only contain DML statements

commitAtEnd - true if transaction must be committed after query execution

params - query parameters

settings - additional settings of query execution

Returns:

a future to query result

executeDataQuery

default CompletableFuture<Result<DataQueryResult>> executeDataQuery(String query)

Execute DataQuery. Transaction will not be committed after the execution of query.

Parameters:

query - text of query. Can only contain DML statements

Returns:

a future to query result

executeDataQuery

default CompletableFuture<Result<DataQueryResult>> executeDataQuery(String query,
                                                                    Params params)

Execute DataQuery. Transaction will not be committed after the execution of query.

Parameters:

query - text of query. Can only contain DML statements

params - query parameters

Returns:

a future to query result

executeDataQueryAndCommit

default CompletableFuture<Result<DataQueryResult>> executeDataQueryAndCommit(String query)

Execute DataQuery. Transaction will be committed after the execution of query.

Parameters:

query - text of query. Can only contain DML statements

Returns:

a future to query result

executeDataQueryAndCommit

default CompletableFuture<Result<DataQueryResult>> executeDataQueryAndCommit(String query,
                                                                             Params params)

Execute DataQuery. Transaction will be committed after the execution of query.

Parameters:

query - text of query. Can only contain DML statements

params - query parameters

Returns:

a future to query result

commit

CompletableFuture<Status> commit(CommitTxSettings settings)

rollback

CompletableFuture<Status> rollback(RollbackTxSettings settings)

commit

default CompletableFuture<Status> commit()

rollback

default CompletableFuture<Status> rollback()