This topic lists the operations available in the Transaction Web Service.
A request to the Transaction Web Service consists of a Request element.
Operation | Description |
---|---|
startOuterTransaction | An operation to begin an outer transaction.
You can optionally provide a transaction ID in the
OuterTransactionId element.
If this operation succeeds, it starts the outer transaction, returns a transaction ID, and the Dgraph process enters transaction mode. If this operation does not succeed, the Dgraph process does not start an outer transaction, and does not return a transaction ID. While an outer transaction is in progress, the following
actions take place:
Updates applied within the outer transaction do not become a published version of the data files until another operation, commitOuterTransaction, returns successfully. |
listOuterTransaction | An operation to request an ID of a running outer transaction. If an outer transaction is in progress, this operation returns its ID. |
rollBackOuterTransaction | An operation to roll back an outer transaction with the ID specified in the OuterTransactionIdToRollBack element. |
commitOuterTransaction | An operation to end an outer transaction.
If an outer transaction with the specified ID is in progress, then if the operation succeeds, the Dgraph process commits the transaction and exits transaction mode. The Dgraph process resumes accepting unqualified queries. The version of the data files that is propagated to all nodes becomes the last published version. If the operation does not succeed, the outer transaction is not committed. The Dgraph process does not apply any updates that referenced the transaction ID. If the operation does not succeed and the transaction is not committed, all queries sent to the Dgraph process continue to use the pre-transaction version of the data files. Note: If the outer transaction fails to commit, it remains
open, and you cannot start another outer transaction before committing or
rolling back the one that failed. Without stopping the Dgraph process, you can
manually commit the transaction and roll back any changes using the
rollBackOuterTransaction operation
specifying the ID of the transaction.
|