begin

begin is a DDL operator that creates a new transaction associated with the user’s connection (legacy client API) or the user’s session (HTTP API).

Synopsis

begin();

Summary

This operator starts a new transaction wherein the user can execute one or more queries. Array modifications will persist after invoking the commit() operator. Array modifications (with the exception of remove_versions) will be reverted if the rollback() operator is given, or on connection interruption (legacy client API) or session expiration (HTTP API).

Invoking begin() within a transaction is an error: nested transactions are not allowed.

[TBD: John James to provide a writeup about the behavior of the system in reponse to an error in a query and how the user acknowleges this to terminate the transaction.]