Příkaz SAVEPOINT (SQL)

příkaz_SAVEPOINT ::= SAVEPOINT bod_návratu
bod_návratu ::= identifikátor | celočíselná_proměnná

Příkaz SAVEPOINT vytváří bod návratu, k němuž se lze později ve stejné transakci vrátit a odvolat tak všechny změny, které v databázi proběhly mezi vytvořením bodu návratu a návratem k němu.

Bod návratu je označuje jedním ze dvou způsobu:

identifikátorem (který se nijak nedeklaruje) nebo
hodnotou v (dříve deklarované) celočíselné_proměnné. Při vytváření nového bodu návratu je nutno před provedením příkazu SAVEPOINT zapsat do celočíselné_proměnné hodnotu nula. Příkaz SAVEPOINT do proměnné zapíše nenulovou hodnotou jednoznačně identifikující bod návratu.

Pokud bod návratu označený identifikátorem nebo hodnotou celočíselné_proměnné již existuje, pak jej příkaz SAVEPOINT nejprve zruší a pak znovu vytvoří.

Pokud v příkazu SAVEPOINT má celočíselná_proměnná hodnotu, která neoznačuje žádný existující bod návratu a je různá od nuly, nastane chybový sqlstate 3B001.

Počet současně existujících bodů návratu vytvořených jedním klientem je úmyslně omezen na 1000. Při pokusu vytvořit další bod návratu nastane chybový sqlstate 3B002.

Příkaz SET TRANSACTION

Transakce a body návratu

Příkaz RELEASE SAVEPOINT