ok
Direktori : /opt/alt/postgresql11/usr/share/doc/alt-postgresql11-9.2.24/html/ |
Current File : //opt/alt/postgresql11/usr/share/doc/alt-postgresql11-9.2.24/html/sql-rollback-to.html |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <HTML ><HEAD ><TITLE >ROLLBACK TO SAVEPOINT</TITLE ><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REV="MADE" HREF="mailto:pgsql-docs@postgresql.org"><LINK REL="HOME" TITLE="PostgreSQL 9.2.24 Documentation" HREF="index.html"><LINK REL="UP" TITLE="SQL Commands" HREF="sql-commands.html"><LINK REL="PREVIOUS" TITLE="ROLLBACK PREPARED" HREF="sql-rollback-prepared.html"><LINK REL="NEXT" TITLE="SAVEPOINT" HREF="sql-savepoint.html"><LINK REL="STYLESHEET" TYPE="text/css" HREF="stylesheet.css"><META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=ISO-8859-1"><META NAME="creation" CONTENT="2017-11-06T22:43:11"></HEAD ><BODY CLASS="REFENTRY" ><DIV CLASS="NAVHEADER" ><TABLE SUMMARY="Header navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TH COLSPAN="5" ALIGN="center" VALIGN="bottom" ><A HREF="index.html" >PostgreSQL 9.2.24 Documentation</A ></TH ></TR ><TR ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A TITLE="ROLLBACK PREPARED" HREF="sql-rollback-prepared.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="10%" ALIGN="left" VALIGN="top" ><A HREF="sql-commands.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="60%" ALIGN="center" VALIGN="bottom" ></TD ><TD WIDTH="20%" ALIGN="right" VALIGN="top" ><A TITLE="SAVEPOINT" HREF="sql-savepoint.html" ACCESSKEY="N" >Next</A ></TD ></TR ></TABLE ><HR ALIGN="LEFT" WIDTH="100%"></DIV ><H1 ><A NAME="SQL-ROLLBACK-TO" ></A >ROLLBACK TO SAVEPOINT</H1 ><DIV CLASS="REFNAMEDIV" ><A NAME="AEN77321" ></A ><H2 >Name</H2 >ROLLBACK TO SAVEPOINT -- roll back to a savepoint</DIV ><DIV CLASS="REFSYNOPSISDIV" ><A NAME="AEN77329" ></A ><H2 >Synopsis</H2 ><PRE CLASS="SYNOPSIS" >ROLLBACK [ WORK | TRANSACTION ] TO [ SAVEPOINT ] <TT CLASS="REPLACEABLE" ><I >savepoint_name</I ></TT ></PRE ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN77332" ></A ><H2 >Description</H2 ><P > Roll back all commands that were executed after the savepoint was established. The savepoint remains valid and can be rolled back to again later, if needed. </P ><P > <TT CLASS="COMMAND" >ROLLBACK TO SAVEPOINT</TT > implicitly destroys all savepoints that were established after the named savepoint. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN77337" ></A ><H2 >Parameters</H2 ><P ></P ><DIV CLASS="VARIABLELIST" ><DL ><DT ><TT CLASS="REPLACEABLE" ><I >savepoint_name</I ></TT ></DT ><DD ><P > The savepoint to roll back to. </P ></DD ></DL ></DIV ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN77345" ></A ><H2 >Notes</H2 ><P > Use <A HREF="sql-release-savepoint.html" >RELEASE SAVEPOINT</A > to destroy a savepoint without discarding the effects of commands executed after it was established. </P ><P > Specifying a savepoint name that has not been established is an error. </P ><P > Cursors have somewhat non-transactional behavior with respect to savepoints. Any cursor that is opened inside a savepoint will be closed when the savepoint is rolled back. If a previously opened cursor is affected by a <TT CLASS="COMMAND" >FETCH</TT > or <TT CLASS="COMMAND" >MOVE</TT > command inside a savepoint that is later rolled back, the cursor remains at the position that <TT CLASS="COMMAND" >FETCH</TT > left it pointing to (that is, the cursor motion caused by <TT CLASS="COMMAND" >FETCH</TT > is not rolled back). Closing a cursor is not undone by rolling back, either. However, other side-effects caused by the cursor's query (such as side-effects of volatile functions called by the query) <SPAN CLASS="emphasis" ><I CLASS="EMPHASIS" >are</I ></SPAN > rolled back if they occur during a savepoint that is later rolled back. A cursor whose execution causes a transaction to abort is put in a cannot-execute state, so while the transaction can be restored using <TT CLASS="COMMAND" >ROLLBACK TO SAVEPOINT</TT >, the cursor can no longer be used. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN77357" ></A ><H2 >Examples</H2 ><P > To undo the effects of the commands executed after <TT CLASS="LITERAL" >my_savepoint</TT > was established: </P><PRE CLASS="PROGRAMLISTING" >ROLLBACK TO SAVEPOINT my_savepoint;</PRE ><P> </P ><P > Cursor positions are not affected by savepoint rollback: </P><PRE CLASS="PROGRAMLISTING" >BEGIN; DECLARE foo CURSOR FOR SELECT 1 UNION SELECT 2; SAVEPOINT foo; FETCH 1 FROM foo; ?column? ---------- 1 ROLLBACK TO SAVEPOINT foo; FETCH 1 FROM foo; ?column? ---------- 2 COMMIT;</PRE ><P></P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN77364" ></A ><H2 >Compatibility</H2 ><P > The <ACRONYM CLASS="ACRONYM" >SQL</ACRONYM > standard specifies that the key word <TT CLASS="LITERAL" >SAVEPOINT</TT > is mandatory, but <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN > and <SPAN CLASS="PRODUCTNAME" >Oracle</SPAN > allow it to be omitted. SQL allows only <TT CLASS="LITERAL" >WORK</TT >, not <TT CLASS="LITERAL" >TRANSACTION</TT >, as a noise word after <TT CLASS="LITERAL" >ROLLBACK</TT >. Also, SQL has an optional clause <TT CLASS="LITERAL" >AND [ NO ] CHAIN</TT > which is not currently supported by <SPAN CLASS="PRODUCTNAME" >PostgreSQL</SPAN >. Otherwise, this command conforms to the SQL standard. </P ></DIV ><DIV CLASS="REFSECT1" ><A NAME="AEN77376" ></A ><H2 >See Also</H2 ><A HREF="sql-begin.html" >BEGIN</A >, <A HREF="sql-commit.html" >COMMIT</A >, <A HREF="sql-release-savepoint.html" >RELEASE SAVEPOINT</A >, <A HREF="sql-rollback.html" >ROLLBACK</A >, <A HREF="sql-savepoint.html" >SAVEPOINT</A ></DIV ><DIV CLASS="NAVFOOTER" ><HR ALIGN="LEFT" WIDTH="100%"><TABLE SUMMARY="Footer navigation table" WIDTH="100%" BORDER="0" CELLPADDING="0" CELLSPACING="0" ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" ><A HREF="sql-rollback-prepared.html" ACCESSKEY="P" >Prev</A ></TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="index.html" ACCESSKEY="H" >Home</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" ><A HREF="sql-savepoint.html" ACCESSKEY="N" >Next</A ></TD ></TR ><TR ><TD WIDTH="33%" ALIGN="left" VALIGN="top" >ROLLBACK PREPARED</TD ><TD WIDTH="34%" ALIGN="center" VALIGN="top" ><A HREF="sql-commands.html" ACCESSKEY="U" >Up</A ></TD ><TD WIDTH="33%" ALIGN="right" VALIGN="top" >SAVEPOINT</TD ></TR ></TABLE ></DIV ></BODY ></HTML >