System.Data.SQLite
Hex Artifact Content
Not logged in

Artifact fdd0b6532c37f7c2dc50acf1a72fb2c7b3cd3f70:


0000: 3c 21 44 4f 43 54 59 50 45 20 68 74 6d 6c 3e 0a  <!DOCTYPE html>.
0010: 3c 68 74 6d 6c 3e 3c 68 65 61 64 3e 0a 3c 6d 65  <html><head>.<me
0020: 74 61 20 6e 61 6d 65 3d 22 76 69 65 77 70 6f 72  ta name="viewpor
0030: 74 22 20 63 6f 6e 74 65 6e 74 3d 22 77 69 64 74  t" content="widt
0040: 68 3d 64 65 76 69 63 65 2d 77 69 64 74 68 2c 20  h=device-width, 
0050: 69 6e 69 74 69 61 6c 2d 73 63 61 6c 65 3d 31 2e  initial-scale=1.
0060: 30 22 3e 0a 3c 6d 65 74 61 20 68 74 74 70 2d 65  0">.<meta http-e
0070: 71 75 69 76 3d 22 63 6f 6e 74 65 6e 74 2d 74 79  quiv="content-ty
0080: 70 65 22 20 63 6f 6e 74 65 6e 74 3d 22 74 65 78  pe" content="tex
0090: 74 2f 68 74 6d 6c 3b 20 63 68 61 72 73 65 74 3d  t/html; charset=
00a0: 55 54 46 2d 38 22 3e 0a 3c 6c 69 6e 6b 20 68 72  UTF-8">.<link hr
00b0: 65 66 3d 22 73 71 6c 69 74 65 2e 63 73 73 22 20  ef="sqlite.css" 
00c0: 72 65 6c 3d 22 73 74 79 6c 65 73 68 65 65 74 22  rel="stylesheet"
00d0: 3e 0a 3c 74 69 74 6c 65 3e 53 51 4c 69 74 65 20  >.<title>SQLite 
00e0: 51 75 65 72 79 20 4c 61 6e 67 75 61 67 65 3a 20  Query Language: 
00f0: 53 41 56 45 50 4f 49 4e 54 3c 2f 74 69 74 6c 65  SAVEPOINT</title
0100: 3e 0a 3c 21 2d 2d 20 70 61 74 68 3d 20 2d 2d 3e  >.<!-- path= -->
0110: 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f 64 79 3e 0a  .</head>.<body>.
0120: 3c 64 69 76 20 63 6c 61 73 73 3d 6e 6f 73 65 61  <div class=nosea
0130: 72 63 68 3e 0a 3c 61 20 68 72 65 66 3d 22 69 6e  rch>.<a href="in
0140: 64 65 78 2e 68 74 6d 6c 22 3e 0a 3c 69 6d 67 20  dex.html">.<img 
0150: 63 6c 61 73 73 3d 22 6c 6f 67 6f 22 20 73 72 63  class="logo" src
0160: 3d 22 69 6d 61 67 65 73 2f 73 71 6c 69 74 65 33  ="images/sqlite3
0170: 37 30 5f 62 61 6e 6e 65 72 2e 67 69 66 22 20 61  70_banner.gif" a
0180: 6c 74 3d 22 53 51 4c 69 74 65 22 20 62 6f 72 64  lt="SQLite" bord
0190: 65 72 3d 22 30 22 3e 0a 3c 2f 61 3e 0a 3c 64 69  er="0">.</a>.<di
01a0: 76 3e 3c 21 2d 2d 20 49 45 20 68 61 63 6b 20 74  v><!-- IE hack t
01b0: 6f 20 70 72 65 76 65 6e 74 20 64 69 73 61 70 70  o prevent disapp
01c0: 65 61 72 69 6e 67 20 6c 6f 67 6f 20 2d 2d 3e 3c  earing logo --><
01d0: 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73  /div>.<div class
01e0: 3d 22 74 61 67 6c 69 6e 65 20 64 65 73 6b 74 6f  ="tagline deskto
01f0: 70 6f 6e 6c 79 22 3e 0a 53 6d 61 6c 6c 2e 20 46  ponly">.Small. F
0200: 61 73 74 2e 20 52 65 6c 69 61 62 6c 65 2e 3c 62  ast. Reliable.<b
0210: 72 3e 43 68 6f 6f 73 65 20 61 6e 79 20 74 68 72  r>Choose any thr
0220: 65 65 2e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20  ee..</div>.<div 
0230: 63 6c 61 73 73 3d 22 6d 65 6e 75 20 6d 61 69 6e  class="menu main
0240: 6d 65 6e 75 22 3e 0a 3c 75 6c 3e 0a 3c 6c 69 3e  menu">.<ul>.<li>
0250: 3c 61 20 68 72 65 66 3d 22 69 6e 64 65 78 2e 68  <a href="index.h
0260: 74 6d 6c 22 3e 48 6f 6d 65 3c 2f 61 3e 0a 3c 6c  tml">Home</a>.<l
0270: 69 20 63 6c 61 73 73 3d 27 6d 6f 62 69 6c 65 6f  i class='mobileo
0280: 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d 22 6a 61  nly'><a href="ja
0290: 76 61 73 63 72 69 70 74 3a 76 6f 69 64 28 30 29  vascript:void(0)
02a0: 22 20 6f 6e 63 6c 69 63 6b 3d 27 74 6f 67 67 6c  " onclick='toggl
02b0: 65 5f 64 69 76 28 22 73 75 62 6d 65 6e 75 22 29  e_div("submenu")
02c0: 27 3e 4d 65 6e 75 3c 2f 61 3e 0a 3c 6c 69 20 63  '>Menu</a>.<li c
02d0: 6c 61 73 73 3d 27 77 69 64 65 6f 6e 6c 79 27 3e  lass='wideonly'>
02e0: 3c 61 20 68 72 65 66 3d 27 61 62 6f 75 74 2e 68  <a href='about.h
02f0: 74 6d 6c 27 3e 41 62 6f 75 74 3c 2f 61 3e 0a 3c  tml'>About</a>.<
0300: 6c 69 20 63 6c 61 73 73 3d 27 64 65 73 6b 74 6f  li class='deskto
0310: 70 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d 22  ponly'><a href="
0320: 64 6f 63 73 2e 68 74 6d 6c 22 3e 44 6f 63 75 6d  docs.html">Docum
0330: 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0a 3c 6c 69  entation</a>.<li
0340: 20 63 6c 61 73 73 3d 27 64 65 73 6b 74 6f 70 6f   class='desktopo
0350: 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d 22 64 6f  nly'><a href="do
0360: 77 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e 44 6f 77  wnload.html">Dow
0370: 6e 6c 6f 61 64 3c 2f 61 3e 0a 3c 6c 69 20 63 6c  nload</a>.<li cl
0380: 61 73 73 3d 27 77 69 64 65 6f 6e 6c 79 27 3e 3c  ass='wideonly'><
0390: 61 20 68 72 65 66 3d 27 63 6f 70 79 72 69 67 68  a href='copyrigh
03a0: 74 2e 68 74 6d 6c 27 3e 4c 69 63 65 6e 73 65 3c  t.html'>License<
03b0: 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 64  /a>.<li class='d
03c0: 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e 3c 61 20 68  esktoponly'><a h
03d0: 72 65 66 3d 22 73 75 70 70 6f 72 74 2e 68 74 6d  ref="support.htm
03e0: 6c 22 3e 53 75 70 70 6f 72 74 3c 2f 61 3e 0a 3c  l">Support</a>.<
03f0: 6c 69 20 63 6c 61 73 73 3d 27 64 65 73 6b 74 6f  li class='deskto
0400: 70 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d 22  ponly'><a href="
0410: 70 72 6f 73 75 70 70 6f 72 74 2e 68 74 6d 6c 22  prosupport.html"
0420: 3e 50 75 72 63 68 61 73 65 3c 2f 61 3e 0a 3c 6c  >Purchase</a>.<l
0430: 69 20 63 6c 61 73 73 3d 27 73 65 61 72 63 68 27  i class='search'
0440: 20 69 64 3d 27 73 65 61 72 63 68 5f 6d 65 6e 75   id='search_menu
0450: 62 75 74 74 6f 6e 27 3e 0a 3c 61 20 68 72 65 66  button'>.<a href
0460: 3d 22 6a 61 76 61 73 63 72 69 70 74 3a 76 6f 69  ="javascript:voi
0470: 64 28 30 29 22 20 6f 6e 63 6c 69 63 6b 3d 27 74  d(0)" onclick='t
0480: 6f 67 67 6c 65 5f 73 65 61 72 63 68 28 29 27 3e  oggle_search()'>
0490: 53 65 61 72 63 68 3c 2f 61 3e 0a 3c 2f 75 6c 3e  Search</a>.</ul>
04a0: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61  .</div>.<div cla
04b0: 73 73 3d 22 6d 65 6e 75 20 73 75 62 6d 65 6e 75  ss="menu submenu
04c0: 22 20 69 64 3d 22 73 75 62 6d 65 6e 75 22 3e 0a  " id="submenu">.
04d0: 3c 75 6c 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66  <ul>.<li><a href
04e0: 3d 27 61 62 6f 75 74 2e 68 74 6d 6c 27 3e 41 62  ='about.html'>Ab
04f0: 6f 75 74 3c 2f 61 3e 0a 3c 6c 69 3e 3c 61 20 68  out</a>.<li><a h
0500: 72 65 66 3d 27 64 6f 63 73 2e 68 74 6d 6c 27 3e  ref='docs.html'>
0510: 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61  Documentation</a
0520: 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 27 64  >.<li><a href='d
0530: 6f 77 6e 6c 6f 61 64 2e 68 74 6d 6c 27 3e 44 6f  ownload.html'>Do
0540: 77 6e 6c 6f 61 64 3c 2f 61 3e 0a 3c 6c 69 3e 3c  wnload</a>.<li><
0550: 61 20 68 72 65 66 3d 27 73 75 70 70 6f 72 74 2e  a href='support.
0560: 68 74 6d 6c 27 3e 53 75 70 70 6f 72 74 3c 2f 61  html'>Support</a
0570: 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 27 70  >.<li><a href='p
0580: 72 6f 73 75 70 70 6f 72 74 2e 68 74 6d 6c 27 3e  rosupport.html'>
0590: 50 75 72 63 68 61 73 65 3c 2f 61 3e 0a 3c 2f 75  Purchase</a>.</u
05a0: 6c 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63  l>.</div>.<div c
05b0: 6c 61 73 73 3d 22 73 65 61 72 63 68 6d 65 6e 75  lass="searchmenu
05c0: 22 20 69 64 3d 22 73 65 61 72 63 68 6d 65 6e 75  " id="searchmenu
05d0: 22 3e 0a 3c 66 6f 72 6d 20 6d 65 74 68 6f 64 3d  ">.<form method=
05e0: 22 47 45 54 22 20 61 63 74 69 6f 6e 3d 22 73 65  "GET" action="se
05f0: 61 72 63 68 22 3e 0a 3c 73 65 6c 65 63 74 20 6e  arch">.<select n
0600: 61 6d 65 3d 22 73 22 20 69 64 3d 22 73 65 61 72  ame="s" id="sear
0610: 63 68 74 79 70 65 22 3e 0a 3c 6f 70 74 69 6f 6e  chtype">.<option
0620: 20 76 61 6c 75 65 3d 22 64 22 3e 53 65 61 72 63   value="d">Searc
0630: 68 20 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 3c  h Documentation<
0640: 2f 6f 70 74 69 6f 6e 3e 0a 3c 6f 70 74 69 6f 6e  /option>.<option
0650: 20 76 61 6c 75 65 3d 22 63 22 3e 53 65 61 72 63   value="c">Searc
0660: 68 20 43 68 61 6e 67 65 6c 6f 67 3c 2f 6f 70 74  h Changelog</opt
0670: 69 6f 6e 3e 0a 3c 2f 73 65 6c 65 63 74 3e 0a 3c  ion>.</select>.<
0680: 69 6e 70 75 74 20 74 79 70 65 3d 22 74 65 78 74  input type="text
0690: 22 20 6e 61 6d 65 3d 22 71 22 20 69 64 3d 22 73  " name="q" id="s
06a0: 65 61 72 63 68 62 6f 78 22 20 76 61 6c 75 65 3d  earchbox" value=
06b0: 22 22 3e 0a 3c 69 6e 70 75 74 20 74 79 70 65 3d  "">.<input type=
06c0: 22 73 75 62 6d 69 74 22 20 76 61 6c 75 65 3d 22  "submit" value="
06d0: 47 6f 22 3e 0a 3c 2f 66 6f 72 6d 3e 0a 3c 2f 64  Go">.</form>.</d
06e0: 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 73 63 72 69  iv>.</div>.<scri
06f0: 70 74 3e 0a 66 75 6e 63 74 69 6f 6e 20 74 6f 67  pt>.function tog
0700: 67 6c 65 5f 64 69 76 28 6e 6d 29 20 7b 0a 76 61  gle_div(nm) {.va
0710: 72 20 77 20 3d 20 64 6f 63 75 6d 65 6e 74 2e 67  r w = document.g
0720: 65 74 45 6c 65 6d 65 6e 74 42 79 49 64 28 6e 6d  etElementById(nm
0730: 29 3b 0a 69 66 28 20 77 2e 73 74 79 6c 65 2e 64  );.if( w.style.d
0740: 69 73 70 6c 61 79 3d 3d 22 62 6c 6f 63 6b 22 20  isplay=="block" 
0750: 29 7b 0a 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c  ){.w.style.displ
0760: 61 79 20 3d 20 22 6e 6f 6e 65 22 3b 0a 7d 65 6c  ay = "none";.}el
0770: 73 65 7b 0a 77 2e 73 74 79 6c 65 2e 64 69 73 70  se{.w.style.disp
0780: 6c 61 79 20 3d 20 22 62 6c 6f 63 6b 22 3b 0a 7d  lay = "block";.}
0790: 0a 7d 0a 66 75 6e 63 74 69 6f 6e 20 74 6f 67 67  .}.function togg
07a0: 6c 65 5f 73 65 61 72 63 68 28 29 20 7b 0a 76 61  le_search() {.va
07b0: 72 20 77 20 3d 20 64 6f 63 75 6d 65 6e 74 2e 67  r w = document.g
07c0: 65 74 45 6c 65 6d 65 6e 74 42 79 49 64 28 22 73  etElementById("s
07d0: 65 61 72 63 68 6d 65 6e 75 22 29 3b 0a 69 66 28  earchmenu");.if(
07e0: 20 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79   w.style.display
07f0: 3d 3d 22 62 6c 6f 63 6b 22 20 29 7b 0a 77 2e 73  =="block" ){.w.s
0800: 74 79 6c 65 2e 64 69 73 70 6c 61 79 20 3d 20 22  tyle.display = "
0810: 6e 6f 6e 65 22 3b 0a 7d 20 65 6c 73 65 20 7b 0a  none";.} else {.
0820: 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79 20  w.style.display 
0830: 3d 20 22 62 6c 6f 63 6b 22 3b 0a 73 65 74 54 69  = "block";.setTi
0840: 6d 65 6f 75 74 28 66 75 6e 63 74 69 6f 6e 28 29  meout(function()
0850: 7b 0a 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c  {.document.getEl
0860: 65 6d 65 6e 74 42 79 49 64 28 22 73 65 61 72 63  ementById("searc
0870: 68 62 6f 78 22 29 2e 66 6f 63 75 73 28 29 0a 7d  hbox").focus().}
0880: 2c 20 33 30 29 3b 0a 7d 0a 7d 0a 66 75 6e 63 74  , 30);.}.}.funct
0890: 69 6f 6e 20 64 69 76 5f 6f 66 66 28 6e 6d 29 7b  ion div_off(nm){
08a0: 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d  document.getElem
08b0: 65 6e 74 42 79 49 64 28 6e 6d 29 2e 73 74 79 6c  entById(nm).styl
08c0: 65 2e 64 69 73 70 6c 61 79 3d 22 6e 6f 6e 65 22  e.display="none"
08d0: 3b 7d 0a 77 69 6e 64 6f 77 2e 6f 6e 62 65 66 6f  ;}.window.onbefo
08e0: 72 65 75 6e 6c 6f 61 64 20 3d 20 66 75 6e 63 74  reunload = funct
08f0: 69 6f 6e 28 65 29 7b 64 69 76 5f 6f 66 66 28 22  ion(e){div_off("
0900: 73 75 62 6d 65 6e 75 22 29 3b 7d 0a 2f 2a 20 44  submenu");}./* D
0910: 69 73 61 62 6c 65 20 74 68 65 20 53 65 61 72 63  isable the Searc
0920: 68 20 66 65 61 74 75 72 65 20 69 66 20 77 65 20  h feature if we 
0930: 61 72 65 20 6e 6f 74 20 6f 70 65 72 61 74 69 6e  are not operatin
0940: 67 20 66 72 6f 6d 20 43 47 49 2c 20 73 69 6e 63  g from CGI, sinc
0950: 65 20 2a 2f 0a 2f 2a 20 53 65 61 72 63 68 20 69  e */./* Search i
0960: 73 20 61 63 63 6f 6d 70 6c 69 73 68 65 64 20 75  s accomplished u
0970: 73 69 6e 67 20 43 47 49 20 61 6e 64 20 77 69 6c  sing CGI and wil
0980: 6c 20 6e 6f 74 20 77 6f 72 6b 20 77 69 74 68 6f  l not work witho
0990: 75 74 20 69 74 2e 20 2a 2f 0a 69 66 28 20 21 6c  ut it. */.if( !l
09a0: 6f 63 61 74 69 6f 6e 2e 6f 72 69 67 69 6e 2e 6d  ocation.origin.m
09b0: 61 74 63 68 20 7c 7c 20 21 6c 6f 63 61 74 69 6f  atch || !locatio
09c0: 6e 2e 6f 72 69 67 69 6e 2e 6d 61 74 63 68 28 2f  n.origin.match(/
09d0: 68 74 74 70 2f 29 20 29 7b 0a 64 6f 63 75 6d 65  http/) ){.docume
09e0: 6e 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49  nt.getElementByI
09f0: 64 28 22 73 65 61 72 63 68 5f 6d 65 6e 75 62 75  d("search_menubu
0a00: 74 74 6f 6e 22 29 2e 73 74 79 6c 65 2e 64 69 73  tton").style.dis
0a10: 70 6c 61 79 20 3d 20 22 6e 6f 6e 65 22 3b 0a 7d  play = "none";.}
0a20: 0a 2f 2a 20 55 73 65 64 20 62 79 20 74 68 65 20  ./* Used by the 
0a30: 48 69 64 65 2f 53 68 6f 77 20 62 75 74 74 6f 6e  Hide/Show button
0a40: 20 62 65 73 69 64 65 20 73 79 6e 74 61 78 20 64   beside syntax d
0a50: 69 61 67 72 61 6d 73 2c 20 74 6f 20 74 6f 67 67  iagrams, to togg
0a60: 6c 65 20 74 68 65 20 2a 2f 0a 66 75 6e 63 74 69  le the */.functi
0a70: 6f 6e 20 68 69 64 65 6f 72 73 68 6f 77 28 62 74  on hideorshow(bt
0a80: 6e 2c 6f 62 6a 29 7b 0a 76 61 72 20 78 20 3d 20  n,obj){.var x = 
0a90: 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d  document.getElem
0aa0: 65 6e 74 42 79 49 64 28 6f 62 6a 29 3b 0a 76 61  entById(obj);.va
0ab0: 72 20 62 20 3d 20 64 6f 63 75 6d 65 6e 74 2e 67  r b = document.g
0ac0: 65 74 45 6c 65 6d 65 6e 74 42 79 49 64 28 62 74  etElementById(bt
0ad0: 6e 29 3b 0a 69 66 28 20 78 2e 73 74 79 6c 65 2e  n);.if( x.style.
0ae0: 64 69 73 70 6c 61 79 21 3d 27 6e 6f 6e 65 27 20  display!='none' 
0af0: 29 7b 0a 78 2e 73 74 79 6c 65 2e 64 69 73 70 6c  ){.x.style.displ
0b00: 61 79 20 3d 20 27 6e 6f 6e 65 27 3b 0a 62 2e 69  ay = 'none';.b.i
0b10: 6e 6e 65 72 48 54 4d 4c 3d 27 73 68 6f 77 27 3b  nnerHTML='show';
0b20: 0a 7d 65 6c 73 65 7b 0a 78 2e 73 74 79 6c 65 2e  .}else{.x.style.
0b30: 64 69 73 70 6c 61 79 20 3d 20 27 27 3b 0a 62 2e  display = '';.b.
0b40: 69 6e 6e 65 72 48 54 4d 4c 3d 27 68 69 64 65 27  innerHTML='hide'
0b50: 3b 0a 7d 0a 72 65 74 75 72 6e 20 66 61 6c 73 65  ;.}.return false
0b60: 3b 0a 7d 0a 3c 2f 73 63 72 69 70 74 3e 0a 3c 2f  ;.}.</script>.</
0b70: 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d  div>.<div class=
0b80: 6e 6f 73 65 61 72 63 68 3e 3c 68 31 20 61 6c 69  nosearch><h1 ali
0b90: 67 6e 3d 22 63 65 6e 74 65 72 22 3e 53 51 4c 20  gn="center">SQL 
0ba0: 41 73 20 55 6e 64 65 72 73 74 6f 6f 64 20 42 79  As Understood By
0bb0: 20 53 51 4c 69 74 65 3c 2f 68 31 3e 3c 70 3e 3c   SQLite</h1><p><
0bc0: 61 20 68 72 65 66 3d 22 6c 61 6e 67 2e 68 74 6d  a href="lang.htm
0bd0: 6c 22 3e 5b 54 6f 70 5d 3c 2f 61 3e 3c 2f 70 3e  l">[Top]</a></p>
0be0: 3c 68 32 3e 53 41 56 45 50 4f 49 4e 54 3c 2f 68  <h2>SAVEPOINT</h
0bf0: 32 3e 3c 2f 64 69 76 3e 3c 70 3e 3c 62 3e 3c 61  2></div><p><b><a
0c00: 20 68 72 65 66 3d 22 73 79 6e 74 61 78 2f 73 61   href="syntax/sa
0c10: 76 65 70 6f 69 6e 74 2d 73 74 6d 74 2e 68 74 6d  vepoint-stmt.htm
0c20: 6c 22 3e 73 61 76 65 70 6f 69 6e 74 2d 73 74 6d  l">savepoint-stm
0c30: 74 3a 3c 2f 61 3e 3c 2f 62 3e 0a 3c 62 75 74 74  t:</a></b>.<butt
0c40: 6f 6e 20 69 64 3d 27 78 31 31 37 31 27 20 6f 6e  on id='x1171' on
0c50: 63 6c 69 63 6b 3d 27 68 69 64 65 6f 72 73 68 6f  click='hideorsho
0c60: 77 28 22 78 31 31 37 31 22 2c 22 78 31 31 37 32  w("x1171","x1172
0c70: 22 29 27 3e 68 69 64 65 3c 2f 62 75 74 74 6f 6e  ")'>hide</button
0c80: 3e 3c 2f 70 3e 0a 20 3c 64 69 76 20 69 64 3d 27  ></p>. <div id='
0c90: 78 31 31 37 32 27 20 63 6c 61 73 73 3d 27 69 6d  x1172' class='im
0ca0: 67 63 6f 6e 74 61 69 6e 65 72 27 3e 0a 20 3c 69  gcontainer'>. <i
0cb0: 6d 67 20 61 6c 74 3d 22 73 79 6e 74 61 78 20 64  mg alt="syntax d
0cc0: 69 61 67 72 61 6d 20 73 61 76 65 70 6f 69 6e 74  iagram savepoint
0cd0: 2d 73 74 6d 74 22 20 73 72 63 3d 22 69 6d 61 67  -stmt" src="imag
0ce0: 65 73 2f 73 79 6e 74 61 78 2f 73 61 76 65 70 6f  es/syntax/savepo
0cf0: 69 6e 74 2d 73 74 6d 74 2e 67 69 66 22 20 2f 3e  int-stmt.gif" />
0d00: 0a 3c 2f 64 69 76 3e 0a 3c 70 3e 3c 62 3e 3c 61  .</div>.<p><b><a
0d10: 20 68 72 65 66 3d 22 73 79 6e 74 61 78 2f 72 65   href="syntax/re
0d20: 6c 65 61 73 65 2d 73 74 6d 74 2e 68 74 6d 6c 22  lease-stmt.html"
0d30: 3e 72 65 6c 65 61 73 65 2d 73 74 6d 74 3a 3c 2f  >release-stmt:</
0d40: 61 3e 3c 2f 62 3e 0a 3c 62 75 74 74 6f 6e 20 69  a></b>.<button i
0d50: 64 3d 27 78 31 31 37 33 27 20 6f 6e 63 6c 69 63  d='x1173' onclic
0d60: 6b 3d 27 68 69 64 65 6f 72 73 68 6f 77 28 22 78  k='hideorshow("x
0d70: 31 31 37 33 22 2c 22 78 31 31 37 34 22 29 27 3e  1173","x1174")'>
0d80: 68 69 64 65 3c 2f 62 75 74 74 6f 6e 3e 3c 2f 70  hide</button></p
0d90: 3e 0a 20 3c 64 69 76 20 69 64 3d 27 78 31 31 37  >. <div id='x117
0da0: 34 27 20 63 6c 61 73 73 3d 27 69 6d 67 63 6f 6e  4' class='imgcon
0db0: 74 61 69 6e 65 72 27 3e 0a 20 3c 69 6d 67 20 61  tainer'>. <img a
0dc0: 6c 74 3d 22 73 79 6e 74 61 78 20 64 69 61 67 72  lt="syntax diagr
0dd0: 61 6d 20 72 65 6c 65 61 73 65 2d 73 74 6d 74 22  am release-stmt"
0de0: 20 73 72 63 3d 22 69 6d 61 67 65 73 2f 73 79 6e   src="images/syn
0df0: 74 61 78 2f 72 65 6c 65 61 73 65 2d 73 74 6d 74  tax/release-stmt
0e00: 2e 67 69 66 22 20 2f 3e 0a 3c 2f 64 69 76 3e 0a  .gif" />.</div>.
0e10: 3c 70 3e 3c 62 3e 3c 61 20 68 72 65 66 3d 22 73  <p><b><a href="s
0e20: 79 6e 74 61 78 2f 72 6f 6c 6c 62 61 63 6b 2d 73  yntax/rollback-s
0e30: 74 6d 74 2e 68 74 6d 6c 22 3e 72 6f 6c 6c 62 61  tmt.html">rollba
0e40: 63 6b 2d 73 74 6d 74 3a 3c 2f 61 3e 3c 2f 62 3e  ck-stmt:</a></b>
0e50: 0a 3c 62 75 74 74 6f 6e 20 69 64 3d 27 78 31 31  .<button id='x11
0e60: 37 35 27 20 6f 6e 63 6c 69 63 6b 3d 27 68 69 64  75' onclick='hid
0e70: 65 6f 72 73 68 6f 77 28 22 78 31 31 37 35 22 2c  eorshow("x1175",
0e80: 22 78 31 31 37 36 22 29 27 3e 68 69 64 65 3c 2f  "x1176")'>hide</
0e90: 62 75 74 74 6f 6e 3e 3c 2f 70 3e 0a 20 3c 64 69  button></p>. <di
0ea0: 76 20 69 64 3d 27 78 31 31 37 36 27 20 63 6c 61  v id='x1176' cla
0eb0: 73 73 3d 27 69 6d 67 63 6f 6e 74 61 69 6e 65 72  ss='imgcontainer
0ec0: 27 3e 0a 20 3c 69 6d 67 20 61 6c 74 3d 22 73 79  '>. <img alt="sy
0ed0: 6e 74 61 78 20 64 69 61 67 72 61 6d 20 72 6f 6c  ntax diagram rol
0ee0: 6c 62 61 63 6b 2d 73 74 6d 74 22 20 73 72 63 3d  lback-stmt" src=
0ef0: 22 69 6d 61 67 65 73 2f 73 79 6e 74 61 78 2f 72  "images/syntax/r
0f00: 6f 6c 6c 62 61 63 6b 2d 73 74 6d 74 2e 67 69 66  ollback-stmt.gif
0f10: 22 20 2f 3e 0a 3c 2f 64 69 76 3e 0a 0a 0a 3c 70  " />.</div>...<p
0f20: 3e 20 53 41 56 45 50 4f 49 4e 54 73 20 61 72 65  > SAVEPOINTs are
0f30: 20 61 20 6d 65 74 68 6f 64 20 6f 66 20 63 72 65   a method of cre
0f40: 61 74 69 6e 67 20 74 72 61 6e 73 61 63 74 69 6f  ating transactio
0f50: 6e 73 2c 20 73 69 6d 69 6c 61 72 20 74 6f 0a 3c  ns, similar to.<
0f60: 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f 74 72 61  a href="lang_tra
0f70: 6e 73 61 63 74 69 6f 6e 2e 68 74 6d 6c 22 3e 42  nsaction.html">B
0f80: 45 47 49 4e 3c 2f 61 3e 20 61 6e 64 20 3c 61 20  EGIN</a> and <a 
0f90: 68 72 65 66 3d 22 6c 61 6e 67 5f 74 72 61 6e 73  href="lang_trans
0fa0: 61 63 74 69 6f 6e 2e 68 74 6d 6c 22 3e 43 4f 4d  action.html">COM
0fb0: 4d 49 54 3c 2f 61 3e 2c 20 65 78 63 65 70 74 20  MIT</a>, except 
0fc0: 74 68 61 74 20 74 68 65 20 53 41 56 45 50 4f 49  that the SAVEPOI
0fd0: 4e 54 20 61 6e 64 20 52 45 4c 45 41 53 45 20 63  NT and RELEASE c
0fe0: 6f 6d 6d 61 6e 64 73 0a 61 72 65 20 6e 61 6d 65  ommands.are name
0ff0: 64 20 61 6e 64 20 6d 61 79 20 62 65 20 6e 65 73  d and may be nes
1000: 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 20 54 68  ted.</p>..<p> Th
1010: 65 20 53 41 56 45 50 4f 49 4e 54 20 63 6f 6d 6d  e SAVEPOINT comm
1020: 61 6e 64 20 73 74 61 72 74 73 20 61 20 6e 65 77  and starts a new
1030: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 74   transaction wit
1040: 68 20 61 20 6e 61 6d 65 2e 0a 54 68 65 20 74 72  h a name..The tr
1050: 61 6e 73 61 63 74 69 6f 6e 20 6e 61 6d 65 73 20  ansaction names 
1060: 6e 65 65 64 20 6e 6f 74 20 62 65 20 75 6e 69 71  need not be uniq
1070: 75 65 2e 0a 41 20 53 41 56 45 50 4f 49 4e 54 20  ue..A SAVEPOINT 
1080: 63 61 6e 20 62 65 20 73 74 61 72 74 65 64 20 65  can be started e
1090: 69 74 68 65 72 20 77 69 74 68 69 6e 20 6f 72 20  ither within or 
10a0: 6f 75 74 73 69 64 65 20 6f 66 0a 61 20 3c 61 20  outside of.a <a 
10b0: 68 72 65 66 3d 22 6c 61 6e 67 5f 74 72 61 6e 73  href="lang_trans
10c0: 61 63 74 69 6f 6e 2e 68 74 6d 6c 22 3e 42 45 47  action.html">BEG
10d0: 49 4e 3c 2f 61 3e 2e 2e 2e 3c 61 20 68 72 65 66  IN</a>...<a href
10e0: 3d 22 6c 61 6e 67 5f 74 72 61 6e 73 61 63 74 69  ="lang_transacti
10f0: 6f 6e 2e 68 74 6d 6c 22 3e 43 4f 4d 4d 49 54 3c  on.html">COMMIT<
1100: 2f 61 3e 2e 20 20 57 68 65 6e 20 61 20 53 41 56  /a>.  When a SAV
1110: 45 50 4f 49 4e 54 20 69 73 20 74 68 65 20 6f 75  EPOINT is the ou
1120: 74 65 72 2d 6d 6f 73 74 20 73 61 76 65 70 6f 69  ter-most savepoi
1130: 6e 74 0a 61 6e 64 20 69 74 20 69 73 20 6e 6f 74  nt.and it is not
1140: 20 77 69 74 68 69 6e 20 61 20 3c 61 20 68 72 65   within a <a hre
1150: 66 3d 22 6c 61 6e 67 5f 74 72 61 6e 73 61 63 74  f="lang_transact
1160: 69 6f 6e 2e 68 74 6d 6c 22 3e 42 45 47 49 4e 3c  ion.html">BEGIN<
1170: 2f 61 3e 2e 2e 2e 3c 61 20 68 72 65 66 3d 22 6c  /a>...<a href="l
1180: 61 6e 67 5f 74 72 61 6e 73 61 63 74 69 6f 6e 2e  ang_transaction.
1190: 68 74 6d 6c 22 3e 43 4f 4d 4d 49 54 3c 2f 61 3e  html">COMMIT</a>
11a0: 20 74 68 65 6e 20 74 68 65 20 62 65 68 61 76 69   then the behavi
11b0: 6f 72 20 69 73 20 74 68 65 0a 73 61 6d 65 20 61  or is the.same a
11c0: 73 20 42 45 47 49 4e 20 44 45 46 45 52 52 45 44  s BEGIN DEFERRED
11d0: 20 54 52 41 4e 53 41 43 54 49 4f 4e 2e 3c 2f 70   TRANSACTION.</p
11e0: 3e 0a 0a 3c 70 3e 54 68 65 20 52 4f 4c 4c 42 41  >..<p>The ROLLBA
11f0: 43 4b 20 54 4f 20 63 6f 6d 6d 61 6e 64 20 72 65  CK TO command re
1200: 76 65 72 74 73 20 74 68 65 20 73 74 61 74 65 20  verts the state 
1210: 6f 66 20 74 68 65 20 64 61 74 61 62 61 73 65 20  of the database 
1220: 62 61 63 6b 20 74 6f 20 77 68 61 74 0a 69 74 20  back to what.it 
1230: 77 61 73 20 6a 75 73 74 20 61 66 74 65 72 20 74  was just after t
1240: 68 65 20 63 6f 72 72 65 73 70 6f 6e 64 69 6e 67  he corresponding
1250: 20 53 41 56 45 50 4f 49 4e 54 2e 20 20 4e 6f 74   SAVEPOINT.  Not
1260: 65 20 74 68 61 74 20 75 6e 6c 69 6b 65 20 74 68  e that unlike th
1270: 61 74 0a 70 6c 61 69 6e 20 3c 61 20 68 72 65 66  at.plain <a href
1280: 3d 22 6c 61 6e 67 5f 74 72 61 6e 73 61 63 74 69  ="lang_transacti
1290: 6f 6e 2e 68 74 6d 6c 22 3e 52 4f 4c 4c 42 41 43  on.html">ROLLBAC
12a0: 4b 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 28 77  K</a> command (w
12b0: 69 74 68 6f 75 74 20 74 68 65 20 54 4f 20 6b 65  ithout the TO ke
12c0: 79 77 6f 72 64 29 20 74 68 65 20 52 4f 4c 4c 42  yword) the ROLLB
12d0: 41 43 4b 20 54 4f 20 63 6f 6d 6d 61 6e 64 0a 64  ACK TO command.d
12e0: 6f 65 73 20 6e 6f 74 20 63 61 6e 63 65 6c 20 74  oes not cancel t
12f0: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20  he transaction. 
1300: 20 49 6e 73 74 65 61 64 20 6f 66 20 63 61 6e 63   Instead of canc
1310: 65 6c 6c 69 6e 67 20 74 68 65 20 74 72 61 6e 73  elling the trans
1320: 61 63 74 69 6f 6e 2c 0a 74 68 65 20 52 4f 4c 4c  action,.the ROLL
1330: 42 41 43 4b 20 54 4f 20 63 6f 6d 6d 61 6e 64 20  BACK TO command 
1340: 72 65 73 74 61 72 74 73 20 74 68 65 20 74 72 61  restarts the tra
1350: 6e 73 61 63 74 69 6f 6e 20 61 67 61 69 6e 20 61  nsaction again a
1360: 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 2e  t the beginning.
1370: 0a 41 6c 6c 20 69 6e 74 65 72 76 65 6e 69 6e 67  .All intervening
1380: 20 53 41 56 45 50 4f 49 4e 54 73 20 61 72 65 20   SAVEPOINTs are 
1390: 63 61 6e 63 65 6c 65 64 2c 20 68 6f 77 65 76 65  canceled, howeve
13a0: 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 52  r.</p>..<p>The R
13b0: 45 4c 45 41 53 45 20 63 6f 6d 6d 61 6e 64 20 69  ELEASE command i
13c0: 73 20 6c 69 6b 65 20 61 20 3c 61 20 68 72 65 66  s like a <a href
13d0: 3d 22 6c 61 6e 67 5f 74 72 61 6e 73 61 63 74 69  ="lang_transacti
13e0: 6f 6e 2e 68 74 6d 6c 22 3e 43 4f 4d 4d 49 54 3c  on.html">COMMIT<
13f0: 2f 61 3e 20 66 6f 72 20 61 20 53 41 56 45 50 4f  /a> for a SAVEPO
1400: 49 4e 54 2e 0a 54 68 65 20 52 45 4c 45 41 53 45  INT..The RELEASE
1410: 20 63 6f 6d 6d 61 6e 64 20 63 61 75 73 65 73 20   command causes 
1420: 61 6c 6c 20 73 61 76 65 70 6f 69 6e 74 73 20 62  all savepoints b
1430: 61 63 6b 20 74 6f 20 61 6e 64 20 69 6e 63 6c 75  ack to and inclu
1440: 64 69 6e 67 20 74 68 65 20 0a 6d 6f 73 74 20 72  ding the .most r
1450: 65 63 65 6e 74 20 73 61 76 65 70 6f 69 6e 74 20  ecent savepoint 
1460: 77 69 74 68 20 61 20 6d 61 74 63 68 69 6e 67 20  with a matching 
1470: 6e 61 6d 65 20 74 6f 20 62 65 20 72 65 6d 6f 76  name to be remov
1480: 65 64 20 66 72 6f 6d 20 74 68 65 20 0a 74 72 61  ed from the .tra
1490: 6e 73 61 63 74 69 6f 6e 20 73 74 61 63 6b 2e 20  nsaction stack. 
14a0: 20 54 68 65 20 52 45 4c 45 41 53 45 20 6f 66 20   The RELEASE of 
14b0: 61 6e 20 69 6e 6e 65 72 20 74 72 61 6e 73 61 63  an inner transac
14c0: 74 69 6f 6e 0a 64 6f 65 73 20 6e 6f 74 20 63 61  tion.does not ca
14d0: 75 73 65 20 61 6e 79 20 63 68 61 6e 67 65 73 20  use any changes 
14e0: 74 6f 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f  to be written to
14f0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 66 69   the database fi
1500: 6c 65 3b 20 69 74 20 6d 65 72 65 6c 79 0a 72 65  le; it merely.re
1510: 6d 6f 76 65 73 20 73 61 76 65 70 6f 69 6e 74 73  moves savepoints
1520: 20 66 72 6f 6d 20 74 68 65 20 74 72 61 6e 73 61   from the transa
1530: 63 74 69 6f 6e 20 73 74 61 63 6b 20 73 75 63 68  ction stack such
1540: 20 74 68 61 74 20 69 74 20 69 73 0a 6e 6f 20 6c   that it is.no l
1550: 6f 6e 67 65 72 20 70 6f 73 73 69 62 6c 65 20 74  onger possible t
1560: 6f 20 52 4f 4c 4c 42 41 43 4b 20 54 4f 20 74 68  o ROLLBACK TO th
1570: 6f 73 65 20 73 61 76 65 70 6f 69 6e 74 73 2e 0a  ose savepoints..
1580: 49 66 20 61 20 52 45 4c 45 41 53 45 20 63 6f 6d  If a RELEASE com
1590: 6d 61 6e 64 20 72 65 6c 65 61 73 65 73 20 74 68  mand releases th
15a0: 65 20 6f 75 74 65 72 6d 6f 73 74 20 73 61 76 65  e outermost save
15b0: 70 6f 69 6e 74 2c 20 73 6f 0a 74 68 61 74 20 74  point, so.that t
15c0: 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 73  he transaction s
15d0: 74 61 63 6b 20 62 65 63 6f 6d 65 73 20 65 6d 70  tack becomes emp
15e0: 74 79 2c 20 74 68 65 6e 20 52 45 4c 45 41 53 45  ty, then RELEASE
15f0: 20 69 73 20 74 68 65 20 73 61 6d 65 0a 61 73 20   is the same.as 
1600: 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f 74 72  <a href="lang_tr
1610: 61 6e 73 61 63 74 69 6f 6e 2e 68 74 6d 6c 22 3e  ansaction.html">
1620: 43 4f 4d 4d 49 54 3c 2f 61 3e 2e 0a 54 68 65 20  COMMIT</a>..The 
1630: 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f 74 72  <a href="lang_tr
1640: 61 6e 73 61 63 74 69 6f 6e 2e 68 74 6d 6c 22 3e  ansaction.html">
1650: 43 4f 4d 4d 49 54 3c 2f 61 3e 20 63 6f 6d 6d 61  COMMIT</a> comma
1660: 6e 64 20 6d 61 79 20 62 65 20 75 73 65 64 20 74  nd may be used t
1670: 6f 20 72 65 6c 65 61 73 65 20 61 6c 6c 20 73 61  o release all sa
1680: 76 65 70 6f 69 6e 74 73 20 61 6e 64 0a 63 6f 6d  vepoints and.com
1690: 6d 69 74 20 74 68 65 20 74 72 61 6e 73 61 63 74  mit the transact
16a0: 69 6f 6e 20 65 76 65 6e 20 69 66 20 74 68 65 20  ion even if the 
16b0: 74 72 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20  transaction was 
16c0: 6f 72 69 67 69 6e 61 6c 6c 79 20 73 74 61 72 74  originally start
16d0: 65 64 0a 62 79 20 61 20 53 41 56 45 50 4f 49 4e  ed.by a SAVEPOIN
16e0: 54 20 63 6f 6d 6d 61 6e 64 20 69 6e 73 74 65 61  T command instea
16f0: 64 20 6f 66 20 61 20 3c 61 20 68 72 65 66 3d 22  d of a <a href="
1700: 6c 61 6e 67 5f 74 72 61 6e 73 61 63 74 69 6f 6e  lang_transaction
1710: 2e 68 74 6d 6c 22 3e 42 45 47 49 4e 3c 2f 61 3e  .html">BEGIN</a>
1720: 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a 0a 3c   command.</p>..<
1730: 70 3e 49 66 20 74 68 65 20 73 61 76 65 70 6f 69  p>If the savepoi
1740: 6e 74 2d 6e 61 6d 65 20 69 6e 20 61 20 52 45 4c  nt-name in a REL
1750: 45 41 53 45 20 63 6f 6d 6d 61 6e 64 20 64 6f 65  EASE command doe
1760: 73 20 6e 6f 74 20 6d 61 74 63 68 20 61 6e 79 0a  s not match any.
1770: 73 61 76 65 70 6f 69 6e 74 20 63 75 72 72 65 6e  savepoint curren
1780: 74 6c 79 20 69 6e 20 74 68 65 20 74 72 61 6e 73  tly in the trans
1790: 61 63 74 69 6f 6e 20 73 74 61 63 6b 2c 20 74 68  action stack, th
17a0: 65 6e 20 6e 6f 20 73 61 76 65 70 6f 69 6e 74 73  en no savepoints
17b0: 20 61 72 65 0a 72 65 6c 65 61 73 65 64 2c 20 74   are.released, t
17c0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 75  he database is u
17d0: 6e 63 68 61 6e 67 65 64 2c 20 61 6e 64 20 74 68  nchanged, and th
17e0: 65 20 52 45 4c 45 41 53 45 20 63 6f 6d 6d 61 6e  e RELEASE comman
17f0: 64 20 72 65 74 75 72 6e 73 0a 61 6e 20 65 72 72  d returns.an err
1800: 6f 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 4e 6f 74 65  or.</p>..<p>Note
1810: 20 74 68 61 74 20 61 6e 20 69 6e 6e 65 72 20 74   that an inner t
1820: 72 61 6e 73 61 63 74 69 6f 6e 20 6d 69 67 68 74  ransaction might
1830: 20 63 6f 6d 6d 69 74 20 28 75 73 69 6e 67 20 74   commit (using t
1840: 68 65 20 52 45 4c 45 41 53 45 20 63 6f 6d 6d 61  he RELEASE comma
1850: 6e 64 29 0a 62 75 74 20 74 68 65 6e 20 6c 61 74  nd).but then lat
1860: 65 72 20 68 61 76 65 20 69 74 73 20 77 6f 72 6b  er have its work
1870: 20 75 6e 64 6f 6e 65 20 62 79 20 61 20 52 4f 4c   undone by a ROL
1880: 4c 42 41 43 4b 20 69 6e 20 61 6e 20 6f 75 74 65  LBACK in an oute
1890: 72 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 41  r transaction..A
18a0: 20 70 6f 77 65 72 20 66 61 69 6c 75 72 65 20 6f   power failure o
18b0: 72 20 70 72 6f 67 72 61 6d 20 63 72 61 73 68 20  r program crash 
18c0: 6f 72 20 4f 53 20 63 72 61 73 68 20 77 69 6c 6c  or OS crash will
18d0: 20 63 61 75 73 65 20 74 68 65 20 6f 75 74 65 72   cause the outer
18e0: 2d 6d 6f 73 74 0a 74 72 61 6e 73 61 63 74 69 6f  -most.transactio
18f0: 6e 20 74 6f 20 72 6f 6c 6c 62 61 63 6b 2c 20 75  n to rollback, u
1900: 6e 64 6f 69 6e 67 20 61 6c 6c 20 63 68 61 6e 67  ndoing all chang
1910: 65 73 20 74 68 61 74 20 68 61 76 65 20 6f 63 63  es that have occ
1920: 75 72 72 65 64 20 77 69 74 68 69 6e 0a 74 68 61  urred within.tha
1930: 74 20 6f 75 74 65 72 20 74 72 61 6e 73 61 63 74  t outer transact
1940: 69 6f 6e 2c 20 65 76 65 6e 20 63 68 61 6e 67 65  ion, even change
1950: 73 20 74 68 61 74 20 68 61 76 65 20 73 75 70 70  s that have supp
1960: 6f 73 65 64 6c 79 20 62 65 65 6e 20 22 63 6f 6d  osedly been "com
1970: 6d 69 74 74 65 64 22 0a 62 79 20 74 68 65 20 52  mitted".by the R
1980: 45 4c 45 41 53 45 20 63 6f 6d 6d 61 6e 64 2e 20  ELEASE command. 
1990: 20 43 6f 6e 74 65 6e 74 20 69 73 20 6e 6f 74 20   Content is not 
19a0: 61 63 74 75 61 6c 6c 79 20 63 6f 6d 6d 69 74 74  actually committ
19b0: 65 64 20 6f 6e 20 74 68 65 20 64 69 73 6b 20 0a  ed on the disk .
19c0: 75 6e 74 69 6c 20 74 68 65 20 6f 75 74 65 72 6d  until the outerm
19d0: 6f 73 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  ost transaction 
19e0: 63 6f 6d 6d 69 74 73 2e 3c 2f 70 3e 0a 0a 3c 70  commits.</p>..<p
19f0: 3e 54 68 65 72 65 20 61 72 65 20 73 65 76 65 72  >There are sever
1a00: 61 6c 20 77 61 79 73 20 6f 66 20 74 68 69 6e 6b  al ways of think
1a10: 69 6e 67 20 61 62 6f 75 74 20 74 68 65 20 52 45  ing about the RE
1a20: 4c 45 41 53 45 20 63 6f 6d 6d 61 6e 64 3a 3c 2f  LEASE command:</
1a30: 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e  p>..<ul>.<li><p>
1a40: 0a 53 6f 6d 65 20 70 65 6f 70 6c 65 20 76 69 65  .Some people vie
1a50: 77 20 52 45 4c 45 41 53 45 20 61 73 20 74 68 65  w RELEASE as the
1a60: 20 65 71 75 69 76 61 6c 65 6e 74 20 6f 66 20 43   equivalent of C
1a70: 4f 4d 4d 49 54 20 66 6f 72 20 61 20 53 41 56 45  OMMIT for a SAVE
1a80: 50 4f 49 4e 54 2e 0a 54 68 69 73 20 69 73 20 61  POINT..This is a
1a90: 6e 20 61 63 63 65 70 74 61 62 6c 65 20 70 6f 69  n acceptable poi
1aa0: 6e 74 20 6f 66 20 76 69 65 77 20 61 73 20 6c 6f  nt of view as lo
1ab0: 6e 67 20 61 73 20 6f 6e 65 20 72 65 6d 65 6d 62  ng as one rememb
1ac0: 65 72 73 20 74 68 61 74 20 74 68 65 0a 63 68 61  ers that the.cha
1ad0: 6e 67 65 73 20 63 6f 6d 6d 69 74 74 65 64 20 62  nges committed b
1ae0: 79 20 61 6e 20 69 6e 6e 65 72 20 74 72 61 6e 73  y an inner trans
1af0: 61 63 74 69 6f 6e 20 6d 69 67 68 74 20 6c 61 74  action might lat
1b00: 65 72 20 62 65 20 75 6e 64 6f 6e 65 20 62 79 20  er be undone by 
1b10: 61 0a 72 6f 6c 6c 62 61 63 6b 20 69 6e 20 61 6e  a.rollback in an
1b20: 20 6f 75 74 65 72 20 74 72 61 6e 73 61 63 74 69   outer transacti
1b30: 6f 6e 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c  on.</p></li>..<l
1b40: 69 3e 3c 70 3e 0a 41 6e 6f 74 68 65 72 20 76 69  i><p>.Another vi
1b50: 65 77 20 6f 66 20 52 45 4c 45 41 53 45 20 69 73  ew of RELEASE is
1b60: 20 74 68 61 74 20 69 74 20 6d 65 72 67 65 73 20   that it merges 
1b70: 61 20 6e 61 6d 65 64 20 74 72 61 6e 73 61 63 74  a named transact
1b80: 69 6f 6e 20 69 6e 74 6f 20 69 74 73 0a 70 61 72  ion into its.par
1b90: 65 6e 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c  ent transaction,
1ba0: 20 73 6f 20 74 68 61 74 20 74 68 65 20 6e 61 6d   so that the nam
1bb0: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 61  ed transaction a
1bc0: 6e 64 20 69 74 73 20 70 61 72 65 6e 74 20 62 65  nd its parent be
1bd0: 63 6f 6d 65 0a 74 68 65 20 73 61 6d 65 20 74 72  come.the same tr
1be0: 61 6e 73 61 63 74 69 6f 6e 2e 20 20 41 66 74 65  ansaction.  Afte
1bf0: 72 20 52 45 4c 45 41 53 45 2c 20 74 68 65 20 6e  r RELEASE, the n
1c00: 61 6d 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e  amed transaction
1c10: 20 61 6e 64 20 69 74 73 20 70 61 72 65 6e 74 0a   and its parent.
1c20: 77 69 6c 6c 20 63 6f 6d 6d 69 74 20 6f 72 20 72  will commit or r
1c30: 6f 6c 6c 62 61 63 6b 20 74 6f 67 65 74 68 65 72  ollback together
1c40: 2c 20 77 68 61 74 65 76 65 72 20 74 68 65 69 72  , whatever their
1c50: 20 66 61 74 65 20 6d 61 79 20 62 65 2e 0a 3c 2f   fate may be..</
1c60: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
1c70: 0a 4f 6e 65 20 63 61 6e 20 61 6c 73 6f 20 74 68  .One can also th
1c80: 69 6e 6b 20 6f 66 20 73 61 76 65 70 6f 69 6e 74  ink of savepoint
1c90: 73 20 61 73 0a 22 6d 61 72 6b 73 22 20 69 6e 20  s as."marks" in 
1ca0: 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  the transaction 
1cb0: 74 69 6d 65 6c 69 6e 65 2e 20 20 49 6e 20 74 68  timeline.  In th
1cc0: 69 73 20 76 69 65 77 2c 20 74 68 65 20 53 41 56  is view, the SAV
1cd0: 45 50 4f 49 4e 54 20 63 6f 6d 6d 61 6e 64 0a 63  EPOINT command.c
1ce0: 72 65 61 74 65 73 20 61 20 6e 65 77 20 6d 61 72  reates a new mar
1cf0: 6b 2c 20 74 68 65 20 52 4f 4c 4c 42 41 43 4b 20  k, the ROLLBACK 
1d00: 54 4f 20 63 6f 6d 6d 61 6e 64 20 72 65 77 69 6e  TO command rewin
1d10: 64 73 20 74 68 65 20 74 69 6d 65 6c 69 6e 65 20  ds the timeline 
1d20: 62 61 63 6b 0a 74 6f 20 61 20 70 6f 69 6e 74 20  back.to a point 
1d30: 6a 75 73 74 20 61 66 74 65 72 20 74 68 65 20 6e  just after the n
1d40: 61 6d 65 64 20 6d 61 72 6b 2c 20 61 6e 64 20 74  amed mark, and t
1d50: 68 65 20 52 45 4c 45 41 53 45 20 63 6f 6d 6d 61  he RELEASE comma
1d60: 6e 64 0a 65 72 61 73 65 73 20 6d 61 72 6b 73 20  nd.erases marks 
1d70: 66 72 6f 6d 20 74 68 65 20 74 69 6d 65 6c 69 6e  from the timelin
1d80: 65 20 77 69 74 68 6f 75 74 20 61 63 74 75 61 6c  e without actual
1d90: 6c 79 20 6d 61 6b 69 6e 67 20 61 6e 79 0a 63 68  ly making any.ch
1da0: 61 6e 67 65 73 20 74 6f 20 74 68 65 20 64 61 74  anges to the dat
1db0: 61 62 61 73 65 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e  abase..</p></li>
1dc0: 0a 3c 2f 75 6c 3e 0a 0a 0a 0a 3c 68 33 3e 54 72  .</ul>....<h3>Tr
1dd0: 61 6e 73 61 63 74 69 6f 6e 20 4e 65 73 74 69 6e  ansaction Nestin
1de0: 67 20 52 75 6c 65 73 3c 2f 68 33 3e 0a 0a 3c 70  g Rules</h3>..<p
1df0: 3e 54 68 65 20 6c 61 73 74 20 74 72 61 6e 73 61  >The last transa
1e00: 63 74 69 6f 6e 20 73 74 61 72 74 65 64 20 77 69  ction started wi
1e10: 6c 6c 20 62 65 20 74 68 65 20 66 69 72 73 74 0a  ll be the first.
1e20: 74 72 61 6e 73 61 63 74 69 6f 6e 20 63 6f 6d 6d  transaction comm
1e30: 69 74 74 65 64 20 6f 72 20 72 6f 6c 6c 65 64 20  itted or rolled 
1e40: 62 61 63 6b 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  back.</p>..<p>Th
1e50: 65 20 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f  e <a href="lang_
1e60: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 68 74 6d 6c  transaction.html
1e70: 22 3e 42 45 47 49 4e 3c 2f 61 3e 20 63 6f 6d 6d  ">BEGIN</a> comm
1e80: 61 6e 64 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 69  and only works i
1e90: 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  f the transactio
1ea0: 6e 20 73 74 61 63 6b 20 69 73 20 65 6d 70 74 79  n stack is empty
1eb0: 2c 20 6f 72 0a 69 6e 20 6f 74 68 65 72 20 77 6f  , or.in other wo
1ec0: 72 64 73 20 69 66 20 74 68 65 72 65 20 61 72 65  rds if there are
1ed0: 20 6e 6f 20 70 65 6e 64 69 6e 67 20 74 72 61 6e   no pending tran
1ee0: 73 61 63 74 69 6f 6e 73 2e 20 20 49 66 20 74 68  sactions.  If th
1ef0: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 73 74  e transaction.st
1f00: 61 63 6b 20 69 73 20 6e 6f 74 20 65 6d 70 74 79  ack is not empty
1f10: 20 77 68 65 6e 20 74 68 65 20 3c 61 20 68 72 65   when the <a hre
1f20: 66 3d 22 6c 61 6e 67 5f 74 72 61 6e 73 61 63 74  f="lang_transact
1f30: 69 6f 6e 2e 68 74 6d 6c 22 3e 42 45 47 49 4e 3c  ion.html">BEGIN<
1f40: 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 69 73 20 69  /a> command is i
1f50: 6e 76 6f 6b 65 64 2c 20 74 68 65 6e 20 74 68 65  nvoked, then the
1f60: 20 63 6f 6d 6d 61 6e 64 0a 66 61 69 6c 73 20 77   command.fails w
1f70: 69 74 68 20 61 6e 20 65 72 72 6f 72 2e 3c 2f 70  ith an error.</p
1f80: 3e 0a 0a 3c 70 3e 54 68 65 20 3c 61 20 68 72 65  >..<p>The <a hre
1f90: 66 3d 22 6c 61 6e 67 5f 74 72 61 6e 73 61 63 74  f="lang_transact
1fa0: 69 6f 6e 2e 68 74 6d 6c 22 3e 43 4f 4d 4d 49 54  ion.html">COMMIT
1fb0: 3c 2f 61 3e 20 63 6f 6d 6d 61 6e 64 20 63 6f 6d  </a> command com
1fc0: 6d 69 74 73 20 61 6c 6c 20 6f 75 74 73 74 61 6e  mits all outstan
1fd0: 64 69 6e 67 20 74 72 61 6e 73 61 63 74 69 6f 6e  ding transaction
1fe0: 73 20 61 6e 64 20 6c 65 61 76 65 73 0a 74 68 65  s and leaves.the
1ff0: 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 74 61   transaction sta
2000: 63 6b 20 65 6d 70 74 79 2e 3c 2f 70 3e 0a 0a 3c  ck empty.</p>..<
2010: 70 3e 54 68 65 20 52 45 4c 45 41 53 45 20 63 6f  p>The RELEASE co
2020: 6d 6d 61 6e 64 20 73 74 61 72 74 73 20 77 69 74  mmand starts wit
2030: 68 20 74 68 65 20 6d 6f 73 74 20 72 65 63 65 6e  h the most recen
2040: 74 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 74 68  t addition to th
2050: 65 0a 74 72 61 6e 73 61 63 74 69 6f 6e 20 73 74  e.transaction st
2060: 61 63 6b 20 61 6e 64 20 72 65 6c 65 61 73 65 73  ack and releases
2070: 20 73 61 76 65 70 6f 69 6e 74 73 20 62 61 63 6b   savepoints back
2080: 77 61 72 64 73 20 0a 69 6e 20 74 69 6d 65 20 75  wards .in time u
2090: 6e 74 69 6c 20 69 74 20 72 65 6c 65 61 73 65 73  ntil it releases
20a0: 20 61 20 73 61 76 65 70 6f 69 6e 74 20 77 69 74   a savepoint wit
20b0: 68 20 61 20 6d 61 74 63 68 69 6e 67 20 73 61 76  h a matching sav
20c0: 65 70 6f 69 6e 74 2d 6e 61 6d 65 2e 0a 50 72 69  epoint-name..Pri
20d0: 6f 72 20 73 61 76 65 70 6f 69 6e 74 73 2c 20 65  or savepoints, e
20e0: 76 65 6e 20 73 61 76 65 70 6f 69 6e 74 73 20 77  ven savepoints w
20f0: 69 74 68 20 6d 61 74 63 68 69 6e 67 20 73 61 76  ith matching sav
2100: 65 70 6f 69 6e 74 2d 6e 61 6d 65 73 2c 20 61 72  epoint-names, ar
2110: 65 0a 75 6e 63 68 61 6e 67 65 64 2e 0a 49 66 20  e.unchanged..If 
2120: 74 68 65 20 52 45 4c 45 41 53 45 20 63 6f 6d 6d  the RELEASE comm
2130: 61 6e 64 20 63 61 75 73 65 73 20 74 68 65 0a 74  and causes the.t
2140: 72 61 6e 73 61 63 74 69 6f 6e 20 73 74 61 63 6b  ransaction stack
2150: 20 74 6f 20 62 65 63 6f 6d 65 20 65 6d 70 74 79   to become empty
2160: 20 28 69 66 20 74 68 65 20 52 45 4c 45 41 53 45   (if the RELEASE
2170: 20 63 6f 6d 6d 61 6e 64 20 72 65 6c 65 61 73 65   command release
2180: 73 20 74 68 65 0a 6f 75 74 65 72 6d 6f 73 74 20  s the.outermost 
2190: 74 72 61 6e 73 61 63 74 69 6f 6e 20 66 72 6f 6d  transaction from
21a0: 20 74 68 65 20 73 74 61 63 6b 29 20 74 68 65 6e   the stack) then
21b0: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
21c0: 20 63 6f 6d 6d 69 74 73 2e 3c 2f 70 3e 0a 0a 3c   commits.</p>..<
21d0: 70 3e 54 68 65 20 3c 61 20 68 72 65 66 3d 22 6c  p>The <a href="l
21e0: 61 6e 67 5f 74 72 61 6e 73 61 63 74 69 6f 6e 2e  ang_transaction.
21f0: 68 74 6d 6c 22 3e 52 4f 4c 4c 42 41 43 4b 3c 2f  html">ROLLBACK</
2200: 61 3e 20 63 6f 6d 6d 61 6e 64 20 77 69 74 68 6f  a> command witho
2210: 75 74 20 61 20 54 4f 20 63 6c 61 75 73 65 20 72  ut a TO clause r
2220: 6f 6c 6c 73 20 62 61 63 6b 73 20 61 6c 6c 20 74  olls backs all t
2230: 72 61 6e 73 61 63 74 69 6f 6e 73 0a 61 6e 64 20  ransactions.and 
2240: 6c 65 61 76 65 73 20 74 68 65 20 74 72 61 6e 73  leaves the trans
2250: 61 63 74 69 6f 6e 20 73 74 61 63 6b 20 65 6d 70  action stack emp
2260: 74 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  ty.</p>..<p>The 
2270: 52 4f 4c 4c 42 41 43 4b 20 63 6f 6d 6d 61 6e 64  ROLLBACK command
2280: 20 77 69 74 68 20 61 20 54 4f 20 63 6c 61 75 73   with a TO claus
2290: 65 20 72 6f 6c 6c 73 20 62 61 63 6b 20 74 72 61  e rolls back tra
22a0: 6e 73 61 63 74 69 6f 6e 73 20 67 6f 69 6e 67 0a  nsactions going.
22b0: 62 61 63 6b 77 61 72 64 73 20 69 6e 20 74 69 6d  backwards in tim
22c0: 65 20 62 61 63 6b 20 74 6f 20 74 68 65 20 6d 6f  e back to the mo
22d0: 73 74 20 72 65 63 65 6e 74 20 53 41 56 45 50 4f  st recent SAVEPO
22e0: 49 4e 54 20 77 69 74 68 20 61 20 6d 61 74 63 68  INT with a match
22f0: 69 6e 67 20 6e 61 6d 65 2e 0a 54 68 65 20 53 41  ing name..The SA
2300: 56 45 50 4f 49 4e 54 20 77 69 74 68 20 74 68 65  VEPOINT with the
2310: 20 6d 61 74 63 68 69 6e 67 20 6e 61 6d 65 20 72   matching name r
2320: 65 6d 61 69 6e 73 20 6f 6e 20 74 68 65 20 74 72  emains on the tr
2330: 61 6e 73 61 63 74 69 6f 6e 20 73 74 61 63 6b 2c  ansaction stack,
2340: 0a 62 75 74 20 61 6c 6c 20 64 61 74 61 62 61 73  .but all databas
2350: 65 20 63 68 61 6e 67 65 73 20 74 68 61 74 20 6f  e changes that o
2360: 63 63 75 72 72 65 64 20 61 66 74 65 72 20 74 68  ccurred after th
2370: 61 74 20 53 41 56 45 50 4f 49 4e 54 20 77 61 73  at SAVEPOINT was
2380: 20 63 72 65 61 74 65 64 0a 61 72 65 20 72 6f 6c   created.are rol
2390: 6c 65 64 20 62 61 63 6b 2e 20 20 49 66 20 74 68  led back.  If th
23a0: 65 20 73 61 76 65 70 6f 69 6e 74 2d 6e 61 6d 65  e savepoint-name
23b0: 20 69 6e 20 61 20 52 4f 4c 4c 42 41 43 4b 20 54   in a ROLLBACK T
23c0: 4f 20 63 6f 6d 6d 61 6e 64 20 64 6f 65 73 20 6e  O command does n
23d0: 6f 74 0a 6d 61 74 63 68 20 61 6e 79 20 53 41 56  ot.match any SAV
23e0: 45 50 4f 49 4e 54 20 6f 6e 20 74 68 65 20 73 74  EPOINT on the st
23f0: 61 63 6b 2c 20 74 68 65 6e 20 74 68 65 20 52 4f  ack, then the RO
2400: 4c 4c 42 41 43 4b 20 63 6f 6d 6d 61 6e 64 20 66  LLBACK command f
2410: 61 69 6c 73 20 77 69 74 68 20 61 6e 0a 65 72 72  ails with an.err
2420: 6f 72 20 61 6e 64 20 6c 65 61 76 65 73 20 74 68  or and leaves th
2430: 65 20 73 74 61 74 65 20 6f 66 20 74 68 65 20 64  e state of the d
2440: 61 74 61 62 61 73 65 20 75 6e 63 68 61 6e 67 65  atabase unchange
2450: 64 2e 3c 2f 70 3e 0a 0a 0a                       d.</p>...