System.Data.SQLite
Hex Artifact Content
Not logged in

Artifact f07a1366cad2e21538cb996f4adfe42fded66ba7:


0000: 3c 21 44 4f 43 54 59 50 45 20 48 54 4d 4c 20 50  <!DOCTYPE HTML P
0010: 55 42 4c 49 43 20 22 2d 2f 2f 57 33 43 2f 2f 44  UBLIC "-//W3C//D
0020: 54 44 20 48 54 4d 4c 20 34 2e 30 31 2f 2f 45 4e  TD HTML 4.01//EN
0030: 22 20 22 68 74 74 70 3a 2f 2f 77 77 77 2e 77 33  " "http://www.w3
0040: 2e 6f 72 67 2f 54 52 2f 68 74 6d 6c 34 2f 73 74  .org/TR/html4/st
0050: 72 69 63 74 2e 64 74 64 22 3e 0a 3c 68 74 6d 6c  rict.dtd">.<html
0060: 3e 3c 68 65 61 64 3e 0a 3c 6d 65 74 61 20 6e 61  ><head>.<meta na
0070: 6d 65 3d 22 76 69 65 77 70 6f 72 74 22 20 63 6f  me="viewport" co
0080: 6e 74 65 6e 74 3d 22 77 69 64 74 68 3d 64 65 76  ntent="width=dev
0090: 69 63 65 2d 77 69 64 74 68 2c 20 69 6e 69 74 69  ice-width, initi
00a0: 61 6c 2d 73 63 61 6c 65 3d 31 2e 30 22 3e 0a 3c  al-scale=1.0">.<
00b0: 6d 65 74 61 20 68 74 74 70 2d 65 71 75 69 76 3d  meta http-equiv=
00c0: 22 63 6f 6e 74 65 6e 74 2d 74 79 70 65 22 20 63  "content-type" c
00d0: 6f 6e 74 65 6e 74 3d 22 74 65 78 74 2f 68 74 6d  ontent="text/htm
00e0: 6c 3b 20 63 68 61 72 73 65 74 3d 55 54 46 2d 38  l; charset=UTF-8
00f0: 22 3e 0a 3c 6c 69 6e 6b 20 68 72 65 66 3d 22 73  ">.<link href="s
0100: 71 6c 69 74 65 2e 63 73 73 22 20 72 65 6c 3d 22  qlite.css" rel="
0110: 73 74 79 6c 65 73 68 65 65 74 22 3e 0a 3c 74 69  stylesheet">.<ti
0120: 74 6c 65 3e 53 51 4c 69 74 65 20 51 75 65 72 79  tle>SQLite Query
0130: 20 4c 61 6e 67 75 61 67 65 3a 20 42 45 47 49 4e   Language: BEGIN
0140: 20 54 52 41 4e 53 41 43 54 49 4f 4e 3c 2f 74 69   TRANSACTION</ti
0150: 74 6c 65 3e 0a 3c 21 2d 2d 20 70 61 74 68 3d 20  tle>.<!-- path= 
0160: 2d 2d 3e 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f 64  -->.</head>.<bod
0170: 79 3e 0a 3c 64 69 76 20 63 6c 61 73 73 3d 6e 6f  y>.<div class=no
0180: 73 65 61 72 63 68 3e 0a 3c 61 20 68 72 65 66 3d  search>.<a href=
0190: 22 69 6e 64 65 78 2e 68 74 6d 6c 22 3e 0a 3c 69  "index.html">.<i
01a0: 6d 67 20 63 6c 61 73 73 3d 22 6c 6f 67 6f 22 20  mg class="logo" 
01b0: 73 72 63 3d 22 69 6d 61 67 65 73 2f 73 71 6c 69  src="images/sqli
01c0: 74 65 33 37 30 5f 62 61 6e 6e 65 72 2e 67 69 66  te370_banner.gif
01d0: 22 20 61 6c 74 3d 22 53 51 4c 69 74 65 22 20 62  " alt="SQLite" b
01e0: 6f 72 64 65 72 3d 22 30 22 3e 0a 3c 2f 61 3e 0a  order="0">.</a>.
01f0: 3c 64 69 76 3e 3c 21 2d 2d 20 49 45 20 68 61 63  <div><!-- IE hac
0200: 6b 20 74 6f 20 70 72 65 76 65 6e 74 20 64 69 73  k to prevent dis
0210: 61 70 70 65 61 72 69 6e 67 20 6c 6f 67 6f 20 2d  appearing logo -
0220: 2d 3e 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c  -></div>.<div cl
0230: 61 73 73 3d 22 74 61 67 6c 69 6e 65 20 64 65 73  ass="tagline des
0240: 6b 74 6f 70 6f 6e 6c 79 22 3e 0a 53 6d 61 6c 6c  ktoponly">.Small
0250: 2e 20 46 61 73 74 2e 20 52 65 6c 69 61 62 6c 65  . Fast. Reliable
0260: 2e 3c 62 72 3e 43 68 6f 6f 73 65 20 61 6e 79 20  .<br>Choose any 
0270: 74 68 72 65 65 2e 0a 3c 2f 64 69 76 3e 0a 3c 64  three..</div>.<d
0280: 69 76 20 63 6c 61 73 73 3d 22 6d 65 6e 75 20 6d  iv class="menu m
0290: 61 69 6e 6d 65 6e 75 22 3e 0a 3c 75 6c 3e 0a 3c  ainmenu">.<ul>.<
02a0: 6c 69 3e 3c 61 20 68 72 65 66 3d 22 69 6e 64 65  li><a href="inde
02b0: 78 2e 68 74 6d 6c 22 3e 48 6f 6d 65 3c 2f 61 3e  x.html">Home</a>
02c0: 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 6d 6f 62 69  .<li class='mobi
02d0: 6c 65 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d  leonly'><a href=
02e0: 22 6a 61 76 61 73 63 72 69 70 74 3a 76 6f 69 64  "javascript:void
02f0: 28 30 29 22 20 6f 6e 63 6c 69 63 6b 3d 27 74 6f  (0)" onclick='to
0300: 67 67 6c 65 5f 64 69 76 28 22 73 75 62 6d 65 6e  ggle_div("submen
0310: 75 22 29 27 3e 4d 65 6e 75 3c 2f 61 3e 0a 3c 6c  u")'>Menu</a>.<l
0320: 69 20 63 6c 61 73 73 3d 27 77 69 64 65 6f 6e 6c  i class='wideonl
0330: 79 27 3e 3c 61 20 68 72 65 66 3d 27 61 62 6f 75  y'><a href='abou
0340: 74 2e 68 74 6d 6c 27 3e 41 62 6f 75 74 3c 2f 61  t.html'>About</a
0350: 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 64 65 73  >.<li class='des
0360: 6b 74 6f 70 6f 6e 6c 79 27 3e 3c 61 20 68 72 65  ktoponly'><a hre
0370: 66 3d 22 64 6f 63 73 2e 68 74 6d 6c 22 3e 44 6f  f="docs.html">Do
0380: 63 75 6d 65 6e 74 61 74 69 6f 6e 3c 2f 61 3e 0a  cumentation</a>.
0390: 3c 6c 69 20 63 6c 61 73 73 3d 27 64 65 73 6b 74  <li class='deskt
03a0: 6f 70 6f 6e 6c 79 27 3e 3c 61 20 68 72 65 66 3d  oponly'><a href=
03b0: 22 64 6f 77 6e 6c 6f 61 64 2e 68 74 6d 6c 22 3e  "download.html">
03c0: 44 6f 77 6e 6c 6f 61 64 3c 2f 61 3e 0a 3c 6c 69  Download</a>.<li
03d0: 20 63 6c 61 73 73 3d 27 77 69 64 65 6f 6e 6c 79   class='wideonly
03e0: 27 3e 3c 61 20 68 72 65 66 3d 27 63 6f 70 79 72  '><a href='copyr
03f0: 69 67 68 74 2e 68 74 6d 6c 27 3e 4c 69 63 65 6e  ight.html'>Licen
0400: 73 65 3c 2f 61 3e 0a 3c 6c 69 20 63 6c 61 73 73  se</a>.<li class
0410: 3d 27 64 65 73 6b 74 6f 70 6f 6e 6c 79 27 3e 3c  ='desktoponly'><
0420: 61 20 68 72 65 66 3d 22 73 75 70 70 6f 72 74 2e  a href="support.
0430: 68 74 6d 6c 22 3e 53 75 70 70 6f 72 74 3c 2f 61  html">Support</a
0440: 3e 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 64 65 73  >.<li class='des
0450: 6b 74 6f 70 6f 6e 6c 79 27 3e 3c 61 20 68 72 65  ktoponly'><a hre
0460: 66 3d 22 70 72 6f 73 75 70 70 6f 72 74 2e 68 74  f="prosupport.ht
0470: 6d 6c 22 3e 50 75 72 63 68 61 73 65 3c 2f 61 3e  ml">Purchase</a>
0480: 0a 3c 6c 69 20 63 6c 61 73 73 3d 27 73 65 61 72  .<li class='sear
0490: 63 68 27 20 69 64 3d 27 73 65 61 72 63 68 5f 6d  ch' id='search_m
04a0: 65 6e 75 62 75 74 74 6f 6e 27 3e 0a 3c 61 20 68  enubutton'>.<a h
04b0: 72 65 66 3d 22 6a 61 76 61 73 63 72 69 70 74 3a  ref="javascript:
04c0: 76 6f 69 64 28 30 29 22 20 6f 6e 63 6c 69 63 6b  void(0)" onclick
04d0: 3d 27 74 6f 67 67 6c 65 5f 73 65 61 72 63 68 28  ='toggle_search(
04e0: 29 27 3e 53 65 61 72 63 68 3c 2f 61 3e 0a 3c 2f  )'>Search</a>.</
04f0: 75 6c 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20  ul>.</div>.<div 
0500: 63 6c 61 73 73 3d 22 6d 65 6e 75 20 73 75 62 6d  class="menu subm
0510: 65 6e 75 22 20 69 64 3d 22 73 75 62 6d 65 6e 75  enu" id="submenu
0520: 22 3e 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 61 20 68  ">.<ul>.<li><a h
0530: 72 65 66 3d 27 61 62 6f 75 74 2e 68 74 6d 6c 27  ref='about.html'
0540: 3e 41 62 6f 75 74 3c 2f 61 3e 0a 3c 6c 69 3e 3c  >About</a>.<li><
0550: 61 20 68 72 65 66 3d 27 64 6f 63 73 2e 68 74 6d  a href='docs.htm
0560: 6c 27 3e 44 6f 63 75 6d 65 6e 74 61 74 69 6f 6e  l'>Documentation
0570: 3c 2f 61 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66  </a>.<li><a href
0580: 3d 27 64 6f 77 6e 6c 6f 61 64 2e 68 74 6d 6c 27  ='download.html'
0590: 3e 44 6f 77 6e 6c 6f 61 64 3c 2f 61 3e 0a 3c 6c  >Download</a>.<l
05a0: 69 3e 3c 61 20 68 72 65 66 3d 27 73 75 70 70 6f  i><a href='suppo
05b0: 72 74 2e 68 74 6d 6c 27 3e 53 75 70 70 6f 72 74  rt.html'>Support
05c0: 3c 2f 61 3e 0a 3c 6c 69 3e 3c 61 20 68 72 65 66  </a>.<li><a href
05d0: 3d 27 70 72 6f 73 75 70 70 6f 72 74 2e 68 74 6d  ='prosupport.htm
05e0: 6c 27 3e 50 75 72 63 68 61 73 65 3c 2f 61 3e 0a  l'>Purchase</a>.
05f0: 3c 2f 75 6c 3e 0a 3c 2f 64 69 76 3e 0a 3c 64 69  </ul>.</div>.<di
0600: 76 20 63 6c 61 73 73 3d 22 73 65 61 72 63 68 6d  v class="searchm
0610: 65 6e 75 22 20 69 64 3d 22 73 65 61 72 63 68 6d  enu" id="searchm
0620: 65 6e 75 22 3e 0a 3c 66 6f 72 6d 20 6d 65 74 68  enu">.<form meth
0630: 6f 64 3d 22 47 45 54 22 20 61 63 74 69 6f 6e 3d  od="GET" action=
0640: 22 73 65 61 72 63 68 22 3e 0a 3c 73 65 6c 65 63  "search">.<selec
0650: 74 20 6e 61 6d 65 3d 22 73 22 20 69 64 3d 22 73  t name="s" id="s
0660: 65 61 72 63 68 74 79 70 65 22 3e 0a 3c 6f 70 74  earchtype">.<opt
0670: 69 6f 6e 20 76 61 6c 75 65 3d 22 64 22 3e 53 65  ion value="d">Se
0680: 61 72 63 68 20 44 6f 63 75 6d 65 6e 74 61 74 69  arch Documentati
0690: 6f 6e 3c 2f 6f 70 74 69 6f 6e 3e 0a 3c 6f 70 74  on</option>.<opt
06a0: 69 6f 6e 20 76 61 6c 75 65 3d 22 63 22 3e 53 65  ion value="c">Se
06b0: 61 72 63 68 20 43 68 61 6e 67 65 6c 6f 67 3c 2f  arch Changelog</
06c0: 6f 70 74 69 6f 6e 3e 0a 3c 2f 73 65 6c 65 63 74  option>.</select
06d0: 3e 0a 3c 69 6e 70 75 74 20 74 79 70 65 3d 22 74  >.<input type="t
06e0: 65 78 74 22 20 6e 61 6d 65 3d 22 71 22 20 69 64  ext" name="q" id
06f0: 3d 22 73 65 61 72 63 68 62 6f 78 22 20 76 61 6c  ="searchbox" val
0700: 75 65 3d 22 22 3e 0a 3c 69 6e 70 75 74 20 74 79  ue="">.<input ty
0710: 70 65 3d 22 73 75 62 6d 69 74 22 20 76 61 6c 75  pe="submit" valu
0720: 65 3d 22 47 6f 22 3e 0a 3c 2f 66 6f 72 6d 3e 0a  e="Go">.</form>.
0730: 3c 2f 64 69 76 3e 0a 3c 2f 64 69 76 3e 0a 3c 73  </div>.</div>.<s
0740: 63 72 69 70 74 3e 0a 66 75 6e 63 74 69 6f 6e 20  cript>.function 
0750: 74 6f 67 67 6c 65 5f 64 69 76 28 6e 6d 29 20 7b  toggle_div(nm) {
0760: 0a 76 61 72 20 77 20 3d 20 64 6f 63 75 6d 65 6e  .var w = documen
0770: 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64  t.getElementById
0780: 28 6e 6d 29 3b 0a 69 66 28 20 77 2e 73 74 79 6c  (nm);.if( w.styl
0790: 65 2e 64 69 73 70 6c 61 79 3d 3d 22 62 6c 6f 63  e.display=="bloc
07a0: 6b 22 20 29 7b 0a 77 2e 73 74 79 6c 65 2e 64 69  k" ){.w.style.di
07b0: 73 70 6c 61 79 20 3d 20 22 6e 6f 6e 65 22 3b 0a  splay = "none";.
07c0: 7d 65 6c 73 65 7b 0a 77 2e 73 74 79 6c 65 2e 64  }else{.w.style.d
07d0: 69 73 70 6c 61 79 20 3d 20 22 62 6c 6f 63 6b 22  isplay = "block"
07e0: 3b 0a 7d 0a 7d 0a 66 75 6e 63 74 69 6f 6e 20 74  ;.}.}.function t
07f0: 6f 67 67 6c 65 5f 73 65 61 72 63 68 28 29 20 7b  oggle_search() {
0800: 0a 76 61 72 20 77 20 3d 20 64 6f 63 75 6d 65 6e  .var w = documen
0810: 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64  t.getElementById
0820: 28 22 73 65 61 72 63 68 6d 65 6e 75 22 29 3b 0a  ("searchmenu");.
0830: 69 66 28 20 77 2e 73 74 79 6c 65 2e 64 69 73 70  if( w.style.disp
0840: 6c 61 79 3d 3d 22 62 6c 6f 63 6b 22 20 29 7b 0a  lay=="block" ){.
0850: 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c 61 79 20  w.style.display 
0860: 3d 20 22 6e 6f 6e 65 22 3b 0a 7d 20 65 6c 73 65  = "none";.} else
0870: 20 7b 0a 77 2e 73 74 79 6c 65 2e 64 69 73 70 6c   {.w.style.displ
0880: 61 79 20 3d 20 22 62 6c 6f 63 6b 22 3b 0a 73 65  ay = "block";.se
0890: 74 54 69 6d 65 6f 75 74 28 66 75 6e 63 74 69 6f  tTimeout(functio
08a0: 6e 28 29 7b 0a 64 6f 63 75 6d 65 6e 74 2e 67 65  n(){.document.ge
08b0: 74 45 6c 65 6d 65 6e 74 42 79 49 64 28 22 73 65  tElementById("se
08c0: 61 72 63 68 62 6f 78 22 29 2e 66 6f 63 75 73 28  archbox").focus(
08d0: 29 0a 7d 2c 20 33 30 29 3b 0a 7d 0a 7d 0a 66 75  ).}, 30);.}.}.fu
08e0: 6e 63 74 69 6f 6e 20 64 69 76 5f 6f 66 66 28 6e  nction div_off(n
08f0: 6d 29 7b 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45  m){document.getE
0900: 6c 65 6d 65 6e 74 42 79 49 64 28 6e 6d 29 2e 73  lementById(nm).s
0910: 74 79 6c 65 2e 64 69 73 70 6c 61 79 3d 22 6e 6f  tyle.display="no
0920: 6e 65 22 3b 7d 0a 77 69 6e 64 6f 77 2e 6f 6e 62  ne";}.window.onb
0930: 65 66 6f 72 65 75 6e 6c 6f 61 64 20 3d 20 66 75  eforeunload = fu
0940: 6e 63 74 69 6f 6e 28 65 29 7b 64 69 76 5f 6f 66  nction(e){div_of
0950: 66 28 22 73 75 62 6d 65 6e 75 22 29 3b 7d 0a 2f  f("submenu");}./
0960: 2a 20 44 69 73 61 62 6c 65 20 74 68 65 20 53 65  * Disable the Se
0970: 61 72 63 68 20 66 65 61 74 75 72 65 20 69 66 20  arch feature if 
0980: 77 65 20 61 72 65 20 6e 6f 74 20 6f 70 65 72 61  we are not opera
0990: 74 69 6e 67 20 66 72 6f 6d 20 43 47 49 2c 20 73  ting from CGI, s
09a0: 69 6e 63 65 20 2a 2f 0a 2f 2a 20 53 65 61 72 63  ince */./* Searc
09b0: 68 20 69 73 20 61 63 63 6f 6d 70 6c 69 73 68 65  h is accomplishe
09c0: 64 20 75 73 69 6e 67 20 43 47 49 20 61 6e 64 20  d using CGI and 
09d0: 77 69 6c 6c 20 6e 6f 74 20 77 6f 72 6b 20 77 69  will not work wi
09e0: 74 68 6f 75 74 20 69 74 2e 20 2a 2f 0a 69 66 28  thout it. */.if(
09f0: 20 21 6c 6f 63 61 74 69 6f 6e 2e 6f 72 69 67 69   !location.origi
0a00: 6e 2e 6d 61 74 63 68 20 7c 7c 20 21 6c 6f 63 61  n.match || !loca
0a10: 74 69 6f 6e 2e 6f 72 69 67 69 6e 2e 6d 61 74 63  tion.origin.matc
0a20: 68 28 2f 68 74 74 70 2f 29 20 29 7b 0a 64 6f 63  h(/http/) ){.doc
0a30: 75 6d 65 6e 74 2e 67 65 74 45 6c 65 6d 65 6e 74  ument.getElement
0a40: 42 79 49 64 28 22 73 65 61 72 63 68 5f 6d 65 6e  ById("search_men
0a50: 75 62 75 74 74 6f 6e 22 29 2e 73 74 79 6c 65 2e  ubutton").style.
0a60: 64 69 73 70 6c 61 79 20 3d 20 22 6e 6f 6e 65 22  display = "none"
0a70: 3b 0a 7d 0a 2f 2a 20 55 73 65 64 20 62 79 20 74  ;.}./* Used by t
0a80: 68 65 20 48 69 64 65 2f 53 68 6f 77 20 62 75 74  he Hide/Show but
0a90: 74 6f 6e 20 62 65 73 69 64 65 20 73 79 6e 74 61  ton beside synta
0aa0: 78 20 64 69 61 67 72 61 6d 73 2c 20 74 6f 20 74  x diagrams, to t
0ab0: 6f 67 67 6c 65 20 74 68 65 20 2a 2f 0a 66 75 6e  oggle the */.fun
0ac0: 63 74 69 6f 6e 20 68 69 64 65 6f 72 73 68 6f 77  ction hideorshow
0ad0: 28 62 74 6e 2c 6f 62 6a 29 7b 0a 76 61 72 20 78  (btn,obj){.var x
0ae0: 20 3d 20 64 6f 63 75 6d 65 6e 74 2e 67 65 74 45   = document.getE
0af0: 6c 65 6d 65 6e 74 42 79 49 64 28 6f 62 6a 29 3b  lementById(obj);
0b00: 0a 76 61 72 20 62 20 3d 20 64 6f 63 75 6d 65 6e  .var b = documen
0b10: 74 2e 67 65 74 45 6c 65 6d 65 6e 74 42 79 49 64  t.getElementById
0b20: 28 62 74 6e 29 3b 0a 69 66 28 20 78 2e 73 74 79  (btn);.if( x.sty
0b30: 6c 65 2e 64 69 73 70 6c 61 79 21 3d 27 6e 6f 6e  le.display!='non
0b40: 65 27 20 29 7b 0a 78 2e 73 74 79 6c 65 2e 64 69  e' ){.x.style.di
0b50: 73 70 6c 61 79 20 3d 20 27 6e 6f 6e 65 27 3b 0a  splay = 'none';.
0b60: 62 2e 69 6e 6e 65 72 48 54 4d 4c 3d 27 73 68 6f  b.innerHTML='sho
0b70: 77 27 3b 0a 7d 65 6c 73 65 7b 0a 78 2e 73 74 79  w';.}else{.x.sty
0b80: 6c 65 2e 64 69 73 70 6c 61 79 20 3d 20 27 27 3b  le.display = '';
0b90: 0a 62 2e 69 6e 6e 65 72 48 54 4d 4c 3d 27 68 69  .b.innerHTML='hi
0ba0: 64 65 27 3b 0a 7d 0a 72 65 74 75 72 6e 20 66 61  de';.}.return fa
0bb0: 6c 73 65 3b 0a 7d 0a 3c 2f 73 63 72 69 70 74 3e  lse;.}.</script>
0bc0: 0a 3c 2f 64 69 76 3e 0a 3c 64 69 76 20 63 6c 61  .</div>.<div cla
0bd0: 73 73 3d 6e 6f 73 65 61 72 63 68 3e 3c 68 31 20  ss=nosearch><h1 
0be0: 61 6c 69 67 6e 3d 22 63 65 6e 74 65 72 22 3e 53  align="center">S
0bf0: 51 4c 20 41 73 20 55 6e 64 65 72 73 74 6f 6f 64  QL As Understood
0c00: 20 42 79 20 53 51 4c 69 74 65 3c 2f 68 31 3e 3c   By SQLite</h1><
0c10: 70 3e 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 2e  p><a href="lang.
0c20: 68 74 6d 6c 22 3e 5b 54 6f 70 5d 3c 2f 61 3e 3c  html">[Top]</a><
0c30: 2f 70 3e 3c 68 32 3e 42 45 47 49 4e 20 54 52 41  /p><h2>BEGIN TRA
0c40: 4e 53 41 43 54 49 4f 4e 3c 2f 68 32 3e 3c 2f 64  NSACTION</h2></d
0c50: 69 76 3e 3c 70 3e 3c 62 3e 3c 61 20 68 72 65 66  iv><p><b><a href
0c60: 3d 22 73 79 6e 74 61 78 2f 62 65 67 69 6e 2d 73  ="syntax/begin-s
0c70: 74 6d 74 2e 68 74 6d 6c 22 3e 62 65 67 69 6e 2d  tmt.html">begin-
0c80: 73 74 6d 74 3a 3c 2f 61 3e 3c 2f 62 3e 0a 3c 62  stmt:</a></b>.<b
0c90: 75 74 74 6f 6e 20 69 64 3d 27 78 31 31 36 35 27  utton id='x1165'
0ca0: 20 6f 6e 63 6c 69 63 6b 3d 27 68 69 64 65 6f 72   onclick='hideor
0cb0: 73 68 6f 77 28 22 78 31 31 36 35 22 2c 22 78 31  show("x1165","x1
0cc0: 31 36 36 22 29 27 3e 68 69 64 65 3c 2f 62 75 74  166")'>hide</but
0cd0: 74 6f 6e 3e 3c 2f 70 3e 0a 20 3c 64 69 76 20 69  ton></p>. <div i
0ce0: 64 3d 27 78 31 31 36 36 27 20 63 6c 61 73 73 3d  d='x1166' class=
0cf0: 27 69 6d 67 63 6f 6e 74 61 69 6e 65 72 27 3e 0a  'imgcontainer'>.
0d00: 20 3c 69 6d 67 20 61 6c 74 3d 22 73 79 6e 74 61   <img alt="synta
0d10: 78 20 64 69 61 67 72 61 6d 20 62 65 67 69 6e 2d  x diagram begin-
0d20: 73 74 6d 74 22 20 73 72 63 3d 22 69 6d 61 67 65  stmt" src="image
0d30: 73 2f 73 79 6e 74 61 78 2f 62 65 67 69 6e 2d 73  s/syntax/begin-s
0d40: 74 6d 74 2e 67 69 66 22 20 2f 3e 0a 3c 2f 64 69  tmt.gif" />.</di
0d50: 76 3e 0a 3c 70 3e 3c 62 3e 3c 61 20 68 72 65 66  v>.<p><b><a href
0d60: 3d 22 73 79 6e 74 61 78 2f 63 6f 6d 6d 69 74 2d  ="syntax/commit-
0d70: 73 74 6d 74 2e 68 74 6d 6c 22 3e 63 6f 6d 6d 69  stmt.html">commi
0d80: 74 2d 73 74 6d 74 3a 3c 2f 61 3e 3c 2f 62 3e 0a  t-stmt:</a></b>.
0d90: 3c 62 75 74 74 6f 6e 20 69 64 3d 27 78 31 31 36  <button id='x116
0da0: 37 27 20 6f 6e 63 6c 69 63 6b 3d 27 68 69 64 65  7' onclick='hide
0db0: 6f 72 73 68 6f 77 28 22 78 31 31 36 37 22 2c 22  orshow("x1167","
0dc0: 78 31 31 36 38 22 29 27 3e 68 69 64 65 3c 2f 62  x1168")'>hide</b
0dd0: 75 74 74 6f 6e 3e 3c 2f 70 3e 0a 20 3c 64 69 76  utton></p>. <div
0de0: 20 69 64 3d 27 78 31 31 36 38 27 20 63 6c 61 73   id='x1168' clas
0df0: 73 3d 27 69 6d 67 63 6f 6e 74 61 69 6e 65 72 27  s='imgcontainer'
0e00: 3e 0a 20 3c 69 6d 67 20 61 6c 74 3d 22 73 79 6e  >. <img alt="syn
0e10: 74 61 78 20 64 69 61 67 72 61 6d 20 63 6f 6d 6d  tax diagram comm
0e20: 69 74 2d 73 74 6d 74 22 20 73 72 63 3d 22 69 6d  it-stmt" src="im
0e30: 61 67 65 73 2f 73 79 6e 74 61 78 2f 63 6f 6d 6d  ages/syntax/comm
0e40: 69 74 2d 73 74 6d 74 2e 67 69 66 22 20 2f 3e 0a  it-stmt.gif" />.
0e50: 3c 2f 64 69 76 3e 0a 3c 70 3e 3c 62 3e 3c 61 20  </div>.<p><b><a 
0e60: 68 72 65 66 3d 22 73 79 6e 74 61 78 2f 72 6f 6c  href="syntax/rol
0e70: 6c 62 61 63 6b 2d 73 74 6d 74 2e 68 74 6d 6c 22  lback-stmt.html"
0e80: 3e 72 6f 6c 6c 62 61 63 6b 2d 73 74 6d 74 3a 3c  >rollback-stmt:<
0e90: 2f 61 3e 3c 2f 62 3e 0a 3c 62 75 74 74 6f 6e 20  /a></b>.<button 
0ea0: 69 64 3d 27 78 31 31 36 39 27 20 6f 6e 63 6c 69  id='x1169' oncli
0eb0: 63 6b 3d 27 68 69 64 65 6f 72 73 68 6f 77 28 22  ck='hideorshow("
0ec0: 78 31 31 36 39 22 2c 22 78 31 31 37 30 22 29 27  x1169","x1170")'
0ed0: 3e 68 69 64 65 3c 2f 62 75 74 74 6f 6e 3e 3c 2f  >hide</button></
0ee0: 70 3e 0a 20 3c 64 69 76 20 69 64 3d 27 78 31 31  p>. <div id='x11
0ef0: 37 30 27 20 63 6c 61 73 73 3d 27 69 6d 67 63 6f  70' class='imgco
0f00: 6e 74 61 69 6e 65 72 27 3e 0a 20 3c 69 6d 67 20  ntainer'>. <img 
0f10: 61 6c 74 3d 22 73 79 6e 74 61 78 20 64 69 61 67  alt="syntax diag
0f20: 72 61 6d 20 72 6f 6c 6c 62 61 63 6b 2d 73 74 6d  ram rollback-stm
0f30: 74 22 20 73 72 63 3d 22 69 6d 61 67 65 73 2f 73  t" src="images/s
0f40: 79 6e 74 61 78 2f 72 6f 6c 6c 62 61 63 6b 2d 73  yntax/rollback-s
0f50: 74 6d 74 2e 67 69 66 22 20 2f 3e 0a 3c 2f 64 69  tmt.gif" />.</di
0f60: 76 3e 0a 0a 0a 3c 70 3e 0a 4e 6f 20 63 68 61 6e  v>...<p>.No chan
0f70: 67 65 73 20 63 61 6e 20 62 65 20 6d 61 64 65 20  ges can be made 
0f80: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20  to the database 
0f90: 65 78 63 65 70 74 20 77 69 74 68 69 6e 20 61 20  except within a 
0fa0: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 41 6e 79  transaction..Any
0fb0: 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 63 68   command that ch
0fc0: 61 6e 67 65 73 20 74 68 65 20 64 61 74 61 62 61  anges the databa
0fd0: 73 65 20 28 62 61 73 69 63 61 6c 6c 79 2c 20 61  se (basically, a
0fe0: 6e 79 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a 6f  ny SQL command.o
0ff0: 74 68 65 72 20 74 68 61 6e 20 3c 61 20 68 72 65  ther than <a hre
1000: 66 3d 22 6c 61 6e 67 5f 73 65 6c 65 63 74 2e 68  f="lang_select.h
1010: 74 6d 6c 22 3e 53 45 4c 45 43 54 3c 2f 61 3e 29  tml">SELECT</a>)
1020: 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61   will automatica
1030: 6c 6c 79 20 73 74 61 72 74 20 61 20 74 72 61 6e  lly start a tran
1040: 73 61 63 74 69 6f 6e 20 69 66 0a 6f 6e 65 20 69  saction if.one i
1050: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e  s not already in
1060: 20 65 66 66 65 63 74 2e 20 20 41 75 74 6f 6d 61   effect.  Automa
1070: 74 69 63 61 6c 6c 79 20 73 74 61 72 74 65 64 20  tically started 
1080: 74 72 61 6e 73 61 63 74 69 6f 6e 73 0a 61 72 65  transactions.are
1090: 20 63 6f 6d 6d 69 74 74 65 64 20 77 68 65 6e 20   committed when 
10a0: 74 68 65 20 6c 61 73 74 20 71 75 65 72 79 20 66  the last query f
10b0: 69 6e 69 73 68 65 73 2e 0a 3c 2f 70 3e 0a 0a 3c  inishes..</p>..<
10c0: 70 3e 0a 54 72 61 6e 73 61 63 74 69 6f 6e 73 20  p>.Transactions 
10d0: 63 61 6e 20 62 65 20 73 74 61 72 74 65 64 20 6d  can be started m
10e0: 61 6e 75 61 6c 6c 79 20 75 73 69 6e 67 20 74 68  anually using th
10f0: 65 20 42 45 47 49 4e 0a 63 6f 6d 6d 61 6e 64 2e  e BEGIN.command.
1100: 20 20 53 75 63 68 20 74 72 61 6e 73 61 63 74 69    Such transacti
1110: 6f 6e 73 20 75 73 75 61 6c 6c 79 20 70 65 72 73  ons usually pers
1120: 69 73 74 20 75 6e 74 69 6c 20 74 68 65 20 6e 65  ist until the ne
1130: 78 74 0a 43 4f 4d 4d 49 54 20 6f 72 20 52 4f 4c  xt.COMMIT or ROL
1140: 4c 42 41 43 4b 20 63 6f 6d 6d 61 6e 64 2e 20 20  LBACK command.  
1150: 42 75 74 20 61 20 74 72 61 6e 73 61 63 74 69 6f  But a transactio
1160: 6e 20 77 69 6c 6c 20 61 6c 73 6f 20 0a 52 4f 4c  n will also .ROL
1170: 4c 42 41 43 4b 20 69 66 20 74 68 65 20 64 61 74  LBACK if the dat
1180: 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65 64 20  abase is closed 
1190: 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72 20 6f  or if an error o
11a0: 63 63 75 72 73 0a 61 6e 64 20 74 68 65 20 52 4f  ccurs.and the RO
11b0: 4c 4c 42 41 43 4b 20 63 6f 6e 66 6c 69 63 74 20  LLBACK conflict 
11c0: 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72  resolution algor
11d0: 69 74 68 6d 20 69 73 20 73 70 65 63 69 66 69 65  ithm is specifie
11e0: 64 2e 0a 53 65 65 20 74 68 65 20 64 6f 63 75 6d  d..See the docum
11f0: 65 6e 74 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20  entation on the 
1200: 3c 61 20 68 72 65 66 3d 22 6c 61 6e 67 5f 63 6f  <a href="lang_co
1210: 6e 66 6c 69 63 74 2e 68 74 6d 6c 22 3e 4f 4e 20  nflict.html">ON 
1220: 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 0a 63 6c 61  CONFLICT</a>.cla
1230: 75 73 65 20 66 6f 72 20 61 64 64 69 74 69 6f 6e  use for addition
1240: 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61  al information a
1250: 62 6f 75 74 20 74 68 65 20 52 4f 4c 4c 42 41 43  bout the ROLLBAC
1260: 4b 0a 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c  K.conflict resol
1270: 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2e  ution algorithm.
1280: 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 45 4e 44 20 54  .</p>..<p>.END T
1290: 52 41 4e 53 41 43 54 49 4f 4e 20 69 73 20 61 6e  RANSACTION is an
12a0: 20 61 6c 69 61 73 20 66 6f 72 20 43 4f 4d 4d 49   alias for COMMI
12b0: 54 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 20 54 72 61  T..</p>..<p> Tra
12c0: 6e 73 61 63 74 69 6f 6e 73 20 63 72 65 61 74 65  nsactions create
12d0: 64 20 75 73 69 6e 67 20 42 45 47 49 4e 2e 2e 2e  d using BEGIN...
12e0: 43 4f 4d 4d 49 54 20 64 6f 20 6e 6f 74 20 6e 65  COMMIT do not ne
12f0: 73 74 2e 0a 46 6f 72 20 6e 65 73 74 65 64 20 74  st..For nested t
1300: 72 61 6e 73 61 63 74 69 6f 6e 73 2c 20 75 73 65  ransactions, use
1310: 20 74 68 65 20 3c 61 20 68 72 65 66 3d 22 6c 61   the <a href="la
1320: 6e 67 5f 73 61 76 65 70 6f 69 6e 74 2e 68 74 6d  ng_savepoint.htm
1330: 6c 22 3e 53 41 56 45 50 4f 49 4e 54 3c 2f 61 3e  l">SAVEPOINT</a>
1340: 20 61 6e 64 20 3c 61 20 68 72 65 66 3d 22 6c 61   and <a href="la
1350: 6e 67 5f 73 61 76 65 70 6f 69 6e 74 2e 68 74 6d  ng_savepoint.htm
1360: 6c 22 3e 52 45 4c 45 41 53 45 3c 2f 61 3e 20 63  l">RELEASE</a> c
1370: 6f 6d 6d 61 6e 64 73 2e 0a 54 68 65 20 22 54 4f  ommands..The "TO
1380: 20 53 41 56 45 50 4f 49 4e 54 20 3c 73 70 61 6e   SAVEPOINT <span
1390: 20 63 6c 61 73 73 3d 27 79 79 74 65 72 6d 27 3e   class='yyterm'>
13a0: 6e 61 6d 65 3c 2f 73 70 61 6e 3e 22 20 63 6c 61  name</span>" cla
13b0: 75 73 65 20 6f 66 20 74 68 65 20 52 4f 4c 4c 42  use of the ROLLB
13c0: 41 43 4b 20 63 6f 6d 6d 61 6e 64 20 73 68 6f 77  ACK command show
13d0: 6e 0a 69 6e 20 74 68 65 20 73 79 6e 74 61 78 20  n.in the syntax 
13e0: 64 69 61 67 72 61 6d 20 61 62 6f 76 65 20 69 73  diagram above is
13f0: 20 6f 6e 6c 79 20 61 70 70 6c 69 63 61 62 6c 65   only applicable
1400: 20 74 6f 20 3c 61 20 68 72 65 66 3d 22 6c 61 6e   to <a href="lan
1410: 67 5f 73 61 76 65 70 6f 69 6e 74 2e 68 74 6d 6c  g_savepoint.html
1420: 22 3e 53 41 56 45 50 4f 49 4e 54 3c 2f 61 3e 0a  ">SAVEPOINT</a>.
1430: 74 72 61 6e 73 61 63 74 69 6f 6e 73 2e 20 20 41  transactions.  A
1440: 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 69 6e 76  n attempt to inv
1450: 6f 6b 65 20 74 68 65 20 42 45 47 49 4e 20 63 6f  oke the BEGIN co
1460: 6d 6d 61 6e 64 20 77 69 74 68 69 6e 0a 61 20 74  mmand within.a t
1470: 72 61 6e 73 61 63 74 69 6f 6e 20 77 69 6c 6c 20  ransaction will 
1480: 66 61 69 6c 20 77 69 74 68 20 61 6e 20 65 72 72  fail with an err
1490: 6f 72 2c 20 72 65 67 61 72 64 6c 65 73 73 20 6f  or, regardless o
14a0: 66 20 77 68 65 74 68 65 72 0a 74 68 65 20 74 72  f whether.the tr
14b0: 61 6e 73 61 63 74 69 6f 6e 20 77 61 73 20 73 74  ansaction was st
14c0: 61 72 74 65 64 20 62 79 20 3c 61 20 68 72 65 66  arted by <a href
14d0: 3d 22 6c 61 6e 67 5f 73 61 76 65 70 6f 69 6e 74  ="lang_savepoint
14e0: 2e 68 74 6d 6c 22 3e 53 41 56 45 50 4f 49 4e 54  .html">SAVEPOINT
14f0: 3c 2f 61 3e 20 6f 72 20 61 20 70 72 69 6f 72 20  </a> or a prior 
1500: 42 45 47 49 4e 2e 0a 54 68 65 20 43 4f 4d 4d 49  BEGIN..The COMMI
1510: 54 20 63 6f 6d 6d 61 6e 64 20 61 6e 64 20 74 68  T command and th
1520: 65 20 52 4f 4c 4c 42 41 43 4b 20 63 6f 6d 6d 61  e ROLLBACK comma
1530: 6e 64 20 77 69 74 68 6f 75 74 20 74 68 65 20 54  nd without the T
1540: 4f 20 63 6c 61 75 73 65 0a 77 6f 72 6b 20 74 68  O clause.work th
1550: 65 20 73 61 6d 65 20 6f 6e 20 3c 61 20 68 72 65  e same on <a hre
1560: 66 3d 22 6c 61 6e 67 5f 73 61 76 65 70 6f 69 6e  f="lang_savepoin
1570: 74 2e 68 74 6d 6c 22 3e 53 41 56 45 50 4f 49 4e  t.html">SAVEPOIN
1580: 54 3c 2f 61 3e 20 74 72 61 6e 73 61 63 74 69 6f  T</a> transactio
1590: 6e 73 20 61 73 20 74 68 65 79 20 64 6f 20 77 69  ns as they do wi
15a0: 74 68 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 0a  th transactions.
15b0: 73 74 61 72 74 65 64 20 62 79 20 42 45 47 49 4e  started by BEGIN
15c0: 2e 3c 2f 70 3e 0a 0a 3c 61 20 6e 61 6d 65 3d 22  .</p>..<a name="
15d0: 69 6d 6d 65 64 69 61 74 65 22 3e 3c 2f 61 3e 0a  immediate"></a>.
15e0: 0a 3c 70 3e 0a 54 72 61 6e 73 61 63 74 69 6f 6e  .<p>.Transaction
15f0: 73 20 63 61 6e 20 62 65 20 64 65 66 65 72 72 65  s can be deferre
1600: 64 2c 20 69 6d 6d 65 64 69 61 74 65 2c 20 6f 72  d, immediate, or
1610: 20 65 78 63 6c 75 73 69 76 65 2e 20 20 0a 54 68   exclusive.  .Th
1620: 65 20 64 65 66 61 75 6c 74 20 74 72 61 6e 73 61  e default transa
1630: 63 74 69 6f 6e 20 62 65 68 61 76 69 6f 72 20 69  ction behavior i
1640: 73 20 64 65 66 65 72 72 65 64 2e 0a 44 65 66 65  s deferred..Defe
1650: 72 72 65 64 20 6d 65 61 6e 73 20 74 68 61 74 20  rred means that 
1660: 6e 6f 20 6c 6f 63 6b 73 20 61 72 65 20 61 63 71  no locks are acq
1670: 75 69 72 65 64 0a 6f 6e 20 74 68 65 20 64 61 74  uired.on the dat
1680: 61 62 61 73 65 20 75 6e 74 69 6c 20 74 68 65 20  abase until the 
1690: 64 61 74 61 62 61 73 65 20 69 73 20 66 69 72 73  database is firs
16a0: 74 20 61 63 63 65 73 73 65 64 2e 20 20 54 68 75  t accessed.  Thu
16b0: 73 20 77 69 74 68 20 61 0a 64 65 66 65 72 72 65  s with a.deferre
16c0: 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 74  d transaction, t
16d0: 68 65 20 42 45 47 49 4e 20 73 74 61 74 65 6d 65  he BEGIN stateme
16e0: 6e 74 20 69 74 73 65 6c 66 20 64 6f 65 73 20 6e  nt itself does n
16f0: 6f 74 68 69 6e 67 20 74 6f 20 74 68 65 0a 66 69  othing to the.fi
1700: 6c 65 73 79 73 74 65 6d 2e 20 20 4c 6f 63 6b 73  lesystem.  Locks
1710: 0a 61 72 65 20 6e 6f 74 20 61 63 71 75 69 72 65  .are not acquire
1720: 64 20 75 6e 74 69 6c 20 74 68 65 20 66 69 72 73  d until the firs
1730: 74 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20  t read or write 
1740: 6f 70 65 72 61 74 69 6f 6e 2e 20 20 54 68 65 20  operation.  The 
1750: 66 69 72 73 74 20 72 65 61 64 0a 6f 70 65 72 61  first read.opera
1760: 74 69 6f 6e 20 61 67 61 69 6e 73 74 20 61 20 64  tion against a d
1770: 61 74 61 62 61 73 65 20 63 72 65 61 74 65 73 20  atabase creates 
1780: 61 20 3c 61 20 68 72 65 66 3d 22 6c 6f 63 6b 69  a <a href="locki
1790: 6e 67 76 33 2e 68 74 6d 6c 23 73 68 61 72 65 64  ngv3.html#shared
17a0: 5f 6c 6f 63 6b 22 3e 53 48 41 52 45 44 3c 2f 61  _lock">SHARED</a
17b0: 3e 20 6c 6f 63 6b 20 61 6e 64 20 74 68 65 20 66  > lock and the f
17c0: 69 72 73 74 0a 77 72 69 74 65 20 6f 70 65 72 61  irst.write opera
17d0: 74 69 6f 6e 20 63 72 65 61 74 65 73 20 61 20 3c  tion creates a <
17e0: 61 20 68 72 65 66 3d 22 6c 6f 63 6b 69 6e 67 76  a href="lockingv
17f0: 33 2e 68 74 6d 6c 23 72 65 73 65 72 76 65 64 5f  3.html#reserved_
1800: 6c 6f 63 6b 22 3e 52 45 53 45 52 56 45 44 3c 2f  lock">RESERVED</
1810: 61 3e 20 6c 6f 63 6b 2e 20 20 20 42 65 63 61 75  a> lock.   Becau
1820: 73 65 20 74 68 65 20 61 63 71 75 69 73 69 74 69  se the acquisiti
1830: 6f 6e 20 6f 66 0a 6c 6f 63 6b 73 20 69 73 20 64  on of.locks is d
1840: 65 66 65 72 72 65 64 20 75 6e 74 69 6c 20 74 68  eferred until th
1850: 65 79 20 61 72 65 20 6e 65 65 64 65 64 2c 20 69  ey are needed, i
1860: 74 20 69 73 20 70 6f 73 73 69 62 6c 65 20 74 68  t is possible th
1870: 61 74 20 61 6e 6f 74 68 65 72 0a 74 68 72 65 61  at another.threa
1880: 64 20 6f 72 20 70 72 6f 63 65 73 73 20 63 6f 75  d or process cou
1890: 6c 64 20 63 72 65 61 74 65 20 61 20 73 65 70 61  ld create a sepa
18a0: 72 61 74 65 20 74 72 61 6e 73 61 63 74 69 6f 6e  rate transaction
18b0: 20 61 6e 64 20 77 72 69 74 65 20 74 6f 0a 74 68   and write to.th
18c0: 65 20 64 61 74 61 62 61 73 65 20 61 66 74 65 72  e database after
18d0: 20 74 68 65 20 42 45 47 49 4e 20 6f 6e 20 74 68   the BEGIN on th
18e0: 65 20 63 75 72 72 65 6e 74 20 74 68 72 65 61 64  e current thread
18f0: 20 68 61 73 20 65 78 65 63 75 74 65 64 2e 0a 49   has executed..I
1900: 66 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f  f the transactio
1910: 6e 20 69 73 20 69 6d 6d 65 64 69 61 74 65 2c 20  n is immediate, 
1920: 74 68 65 6e 20 3c 61 20 68 72 65 66 3d 22 6c 6f  then <a href="lo
1930: 63 6b 69 6e 67 76 33 2e 68 74 6d 6c 23 72 65 73  ckingv3.html#res
1940: 65 72 76 65 64 5f 6c 6f 63 6b 22 3e 52 45 53 45  erved_lock">RESE
1950: 52 56 45 44 3c 2f 61 3e 20 6c 6f 63 6b 73 0a 61  RVED</a> locks.a
1960: 72 65 20 61 63 71 75 69 72 65 64 20 6f 6e 20 61  re acquired on a
1970: 6c 6c 20 64 61 74 61 62 61 73 65 73 20 61 73 20  ll databases as 
1980: 73 6f 6f 6e 20 61 73 20 74 68 65 20 42 45 47 49  soon as the BEGI
1990: 4e 20 63 6f 6d 6d 61 6e 64 20 69 73 0a 65 78 65  N command is.exe
19a0: 63 75 74 65 64 2c 20 77 69 74 68 6f 75 74 20 77  cuted, without w
19b0: 61 69 74 69 6e 67 20 66 6f 72 20 74 68 65 0a 64  aiting for the.d
19c0: 61 74 61 62 61 73 65 20 74 6f 20 62 65 20 75 73  atabase to be us
19d0: 65 64 2e 20 20 41 66 74 65 72 20 61 20 42 45 47  ed.  After a BEG
19e0: 49 4e 20 49 4d 4d 45 44 49 41 54 45 2c 20 0a 6e  IN IMMEDIATE, .n
19f0: 6f 20 6f 74 68 65 72 20 3c 61 20 68 72 65 66 3d  o other <a href=
1a00: 22 63 33 72 65 66 2f 73 71 6c 69 74 65 33 2e 68  "c3ref/sqlite3.h
1a10: 74 6d 6c 22 3e 64 61 74 61 62 61 73 65 20 63 6f  tml">database co
1a20: 6e 6e 65 63 74 69 6f 6e 3c 2f 61 3e 20 77 69 6c  nnection</a> wil
1a30: 6c 20 62 65 20 61 62 6c 65 20 74 6f 20 77 72 69  l be able to wri
1a40: 74 65 20 74 6f 20 74 68 65 20 64 61 74 61 62 61  te to the databa
1a50: 73 65 20 6f 72 0a 64 6f 20 61 20 42 45 47 49 4e  se or.do a BEGIN
1a60: 20 49 4d 4d 45 44 49 41 54 45 20 6f 72 20 42 45   IMMEDIATE or BE
1a70: 47 49 4e 20 45 58 43 4c 55 53 49 56 45 2e 20 20  GIN EXCLUSIVE.  
1a80: 4f 74 68 65 72 20 70 72 6f 63 65 73 73 65 73 20  Other processes 
1a90: 63 61 6e 20 63 6f 6e 74 69 6e 75 65 0a 74 6f 20  can continue.to 
1aa0: 72 65 61 64 20 66 72 6f 6d 20 74 68 65 20 64 61  read from the da
1ab0: 74 61 62 61 73 65 2c 20 68 6f 77 65 76 65 72 2e  tabase, however.
1ac0: 20 20 41 6e 20 65 78 63 6c 75 73 69 76 65 20 74    An exclusive t
1ad0: 72 61 6e 73 61 63 74 69 6f 6e 20 63 61 75 73 65  ransaction cause
1ae0: 73 0a 3c 61 20 68 72 65 66 3d 22 6c 6f 63 6b 69  s.<a href="locki
1af0: 6e 67 76 33 2e 68 74 6d 6c 23 65 78 63 6c 5f 6c  ngv3.html#excl_l
1b00: 6f 63 6b 22 3e 45 58 43 4c 55 53 49 56 45 3c 2f  ock">EXCLUSIVE</
1b10: 61 3e 20 6c 6f 63 6b 73 20 74 6f 20 62 65 20 61  a> locks to be a
1b20: 63 71 75 69 72 65 64 20 6f 6e 20 61 6c 6c 20 64  cquired on all d
1b30: 61 74 61 62 61 73 65 73 2e 20 20 41 66 74 65 72  atabases.  After
1b40: 20 61 20 42 45 47 49 4e 0a 45 58 43 4c 55 53 49   a BEGIN.EXCLUSI
1b50: 56 45 2c 20 6e 6f 20 6f 74 68 65 72 20 3c 61 20  VE, no other <a 
1b60: 68 72 65 66 3d 22 63 33 72 65 66 2f 73 71 6c 69  href="c3ref/sqli
1b70: 74 65 33 2e 68 74 6d 6c 22 3e 64 61 74 61 62 61  te3.html">databa
1b80: 73 65 20 63 6f 6e 6e 65 63 74 69 6f 6e 3c 2f 61  se connection</a
1b90: 3e 20 65 78 63 65 70 74 20 66 6f 72 20 3c 61 20  > except for <a 
1ba0: 68 72 65 66 3d 22 70 72 61 67 6d 61 2e 68 74 6d  href="pragma.htm
1bb0: 6c 23 70 72 61 67 6d 61 5f 72 65 61 64 5f 75 6e  l#pragma_read_un
1bc0: 63 6f 6d 6d 69 74 74 65 64 22 3e 72 65 61 64 5f  committed">read_
1bd0: 75 6e 63 6f 6d 6d 69 74 74 65 64 3c 2f 61 3e 0a  uncommitted</a>.
1be0: 63 6f 6e 6e 65 63 74 69 6f 6e 73 20 77 69 6c 6c  connections will
1bf0: 20 62 65 20 61 62 6c 65 20 74 6f 20 72 65 61 64   be able to read
1c00: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61 6e   the database an
1c10: 64 20 6e 6f 20 6f 74 68 65 72 20 63 6f 6e 6e 65  d no other conne
1c20: 63 74 69 6f 6e 20 77 69 74 68 6f 75 74 0a 65 78  ction without.ex
1c30: 63 65 70 74 69 6f 6e 20 77 69 6c 6c 20 62 65 20  ception will be 
1c40: 61 62 6c 65 20 74 6f 20 77 72 69 74 65 20 74 68  able to write th
1c50: 65 20 64 61 74 61 62 61 73 65 20 75 6e 74 69 6c  e database until
1c60: 20 74 68 65 20 74 72 61 6e 73 61 63 74 69 6f 6e   the transaction
1c70: 20 69 73 0a 63 6f 6d 70 6c 65 74 65 2e 0a 3c 2f   is.complete..</
1c80: 70 3e 0a 0a 3c 70 3e 0a 41 6e 20 69 6d 70 6c 69  p>..<p>.An impli
1c90: 63 69 74 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  cit transaction 
1ca0: 28 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74  (a transaction t
1cb0: 68 61 74 20 69 73 20 73 74 61 72 74 65 64 20 61  hat is started a
1cc0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 2c 0a 6e 6f  utomatically,.no
1cd0: 74 20 61 20 74 72 61 6e 73 61 63 74 69 6f 6e 20  t a transaction 
1ce0: 73 74 61 72 74 65 64 20 62 79 20 42 45 47 49 4e  started by BEGIN
1cf0: 29 20 69 73 20 63 6f 6d 6d 69 74 74 65 64 20 61  ) is committed a
1d00: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 77 68 65  utomatically whe
1d10: 6e 0a 74 68 65 20 6c 61 73 74 20 61 63 74 69 76  n.the last activ
1d20: 65 20 73 74 61 74 65 6d 65 6e 74 20 66 69 6e 69  e statement fini
1d30: 73 68 65 73 2e 20 20 41 20 73 74 61 74 65 6d 65  shes.  A stateme
1d40: 6e 74 20 66 69 6e 69 73 68 65 73 20 77 68 65 6e  nt finishes when
1d50: 20 69 74 73 0a 70 72 65 70 61 72 65 64 20 73 74   its.prepared st
1d60: 61 74 65 6d 65 6e 74 20 69 73 20 3c 61 20 68 72  atement is <a hr
1d70: 65 66 3d 22 63 33 72 65 66 2f 72 65 73 65 74 2e  ef="c3ref/reset.
1d80: 68 74 6d 6c 22 3e 72 65 73 65 74 3c 2f 61 3e 20  html">reset</a> 
1d90: 6f 72 0a 3c 61 20 68 72 65 66 3d 22 63 33 72 65  or.<a href="c3re
1da0: 66 2f 66 69 6e 61 6c 69 7a 65 2e 68 74 6d 6c 22  f/finalize.html"
1db0: 3e 66 69 6e 61 6c 69 7a 65 64 3c 2f 61 3e 2e 20  >finalized</a>. 
1dc0: 20 41 6e 20 6f 70 65 6e 20 3c 61 20 68 72 65 66   An open <a href
1dd0: 3d 22 63 33 72 65 66 2f 62 6c 6f 62 2e 68 74 6d  ="c3ref/blob.htm
1de0: 6c 22 3e 73 71 6c 69 74 65 33 5f 62 6c 6f 62 3c  l">sqlite3_blob<
1df0: 2f 61 3e 20 75 73 65 64 20 66 6f 72 0a 69 6e 63  /a> used for.inc
1e00: 72 65 6d 65 6e 74 61 6c 20 42 4c 4f 42 20 49 2f  remental BLOB I/
1e10: 4f 20 63 6f 75 6e 74 73 20 61 73 20 61 6e 20 75  O counts as an u
1e20: 6e 66 69 6e 69 73 68 65 64 20 73 74 61 74 65 6d  nfinished statem
1e30: 65 6e 74 2e 20 20 54 68 65 20 3c 61 20 68 72 65  ent.  The <a hre
1e40: 66 3d 22 63 33 72 65 66 2f 62 6c 6f 62 2e 68 74  f="c3ref/blob.ht
1e50: 6d 6c 22 3e 73 71 6c 69 74 65 33 5f 62 6c 6f 62  ml">sqlite3_blob
1e60: 3c 2f 61 3e 0a 66 69 6e 69 73 68 65 73 20 77 68  </a>.finishes wh
1e70: 65 6e 20 69 74 20 69 73 20 3c 61 20 68 72 65 66  en it is <a href
1e80: 3d 22 63 33 72 65 66 2f 62 6c 6f 62 5f 63 6c 6f  ="c3ref/blob_clo
1e90: 73 65 2e 68 74 6d 6c 22 3e 63 6c 6f 73 65 64 3c  se.html">closed<
1ea0: 2f 61 3e 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54  /a>..</p>..<p>.T
1eb0: 68 65 20 65 78 70 6c 69 63 69 74 20 43 4f 4d 4d  he explicit COMM
1ec0: 49 54 20 63 6f 6d 6d 61 6e 64 20 72 75 6e 73 20  IT command runs 
1ed0: 69 6d 6d 65 64 69 61 74 65 6c 79 2c 20 65 76 65  immediately, eve
1ee0: 6e 20 69 66 20 74 68 65 72 65 20 61 72 65 0a 70  n if there are.p
1ef0: 65 6e 64 69 6e 67 20 3c 61 20 68 72 65 66 3d 22  ending <a href="
1f00: 6c 61 6e 67 5f 73 65 6c 65 63 74 2e 68 74 6d 6c  lang_select.html
1f10: 22 3e 53 45 4c 45 43 54 3c 2f 61 3e 20 73 74 61  ">SELECT</a> sta
1f20: 74 65 6d 65 6e 74 73 2e 20 20 48 6f 77 65 76 65  tements.  Howeve
1f30: 72 2c 20 69 66 20 74 68 65 72 65 20 61 72 65 20  r, if there are 
1f40: 70 65 6e 64 69 6e 67 0a 77 72 69 74 65 20 6f 70  pending.write op
1f50: 65 72 61 74 69 6f 6e 73 2c 20 74 68 65 20 43 4f  erations, the CO
1f60: 4d 4d 49 54 20 63 6f 6d 6d 61 6e 64 0a 77 69 6c  MMIT command.wil
1f70: 6c 20 66 61 69 6c 20 77 69 74 68 20 61 6e 20 65  l fail with an e
1f80: 72 72 6f 72 20 63 6f 64 65 20 3c 61 20 68 72 65  rror code <a hre
1f90: 66 3d 22 72 65 73 63 6f 64 65 2e 68 74 6d 6c 23  f="rescode.html#
1fa0: 62 75 73 79 22 3e 53 51 4c 49 54 45 5f 42 55 53  busy">SQLITE_BUS
1fb0: 59 3c 2f 61 3e 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e  Y</a>..</p>..<p>
1fc0: 0a 41 6e 20 61 74 74 65 6d 70 74 20 74 6f 20 65  .An attempt to e
1fd0: 78 65 63 75 74 65 20 43 4f 4d 4d 49 54 20 6d 69  xecute COMMIT mi
1fe0: 67 68 74 20 61 6c 73 6f 20 72 65 73 75 6c 74 20  ght also result 
1ff0: 69 6e 20 61 6e 20 3c 61 20 68 72 65 66 3d 22 72  in an <a href="r
2000: 65 73 63 6f 64 65 2e 68 74 6d 6c 23 62 75 73 79  escode.html#busy
2010: 22 3e 53 51 4c 49 54 45 5f 42 55 53 59 3c 2f 61  ">SQLITE_BUSY</a
2020: 3e 20 72 65 74 75 72 6e 20 63 6f 64 65 0a 69 66  > return code.if
2030: 20 61 6e 20 61 6e 6f 74 68 65 72 20 74 68 72 65   an another thre
2040: 61 64 20 6f 72 20 70 72 6f 63 65 73 73 20 68 61  ad or process ha
2050: 73 20 61 20 3c 61 20 68 72 65 66 3d 22 6c 6f 63  s a <a href="loc
2060: 6b 69 6e 67 76 33 2e 68 74 6d 6c 23 73 68 61 72  kingv3.html#shar
2070: 65 64 5f 6c 6f 63 6b 22 3e 73 68 61 72 65 64 20  ed_lock">shared 
2080: 6c 6f 63 6b 3c 2f 61 3e 20 6f 6e 20 74 68 65 20  lock</a> on the 
2090: 64 61 74 61 62 61 73 65 0a 74 68 61 74 20 70 72  database.that pr
20a0: 65 76 65 6e 74 65 64 20 74 68 65 20 64 61 74 61  evented the data
20b0: 62 61 73 65 20 66 72 6f 6d 20 62 65 69 6e 67 20  base from being 
20c0: 75 70 64 61 74 65 64 2e 20 20 57 68 65 6e 20 43  updated.  When C
20d0: 4f 4d 4d 49 54 20 66 61 69 6c 73 20 69 6e 20 74  OMMIT fails in t
20e0: 68 69 73 0a 77 61 79 2c 20 74 68 65 20 74 72 61  his.way, the tra
20f0: 6e 73 61 63 74 69 6f 6e 20 72 65 6d 61 69 6e 73  nsaction remains
2100: 20 61 63 74 69 76 65 20 61 6e 64 20 74 68 65 20   active and the 
2110: 43 4f 4d 4d 49 54 20 63 61 6e 20 62 65 20 72 65  COMMIT can be re
2120: 74 72 69 65 64 20 6c 61 74 65 72 0a 61 66 74 65  tried later.afte
2130: 72 20 74 68 65 20 72 65 61 64 65 72 20 68 61 73  r the reader has
2140: 20 68 61 64 20 61 20 63 68 61 6e 63 65 20 74 6f   had a chance to
2150: 20 63 6c 65 61 72 2e 0a 3c 2f 70 3e 0a 0a 3c 70   clear..</p>..<p
2160: 3e 0a 49 6e 20 76 65 72 79 20 6f 6c 64 20 76 65  >.In very old ve
2170: 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65  rsions of SQLite
2180: 20 28 62 65 66 6f 72 65 20 76 65 72 73 69 6f 6e   (before version
2190: 20 33 2e 37 2e 31 31 20 2d 20 32 30 31 32 2d 30   3.7.11 - 2012-0
21a0: 33 2d 32 30 29 0a 74 68 65 20 52 4f 4c 4c 42 41  3-20).the ROLLBA
21b0: 43 4b 20 77 69 6c 6c 20 66 61 69 6c 20 77 69 74  CK will fail wit
21c0: 68 20 61 6e 20 65 72 72 6f 72 20 63 6f 64 65 20  h an error code 
21d0: 0a 3c 61 20 68 72 65 66 3d 22 72 65 73 63 6f 64  .<a href="rescod
21e0: 65 2e 68 74 6d 6c 23 62 75 73 79 22 3e 53 51 4c  e.html#busy">SQL
21f0: 49 54 45 5f 42 55 53 59 3c 2f 61 3e 20 69 66 20  ITE_BUSY</a> if 
2200: 74 68 65 72 65 20 61 72 65 20 61 6e 79 20 70 65  there are any pe
2210: 6e 64 69 6e 67 20 71 75 65 72 69 65 73 2e 20 20  nding queries.  
2220: 49 6e 20 6d 6f 72 65 20 72 65 63 65 6e 74 0a 76  In more recent.v
2230: 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74  ersions of SQLit
2240: 65 2c 20 74 68 65 20 52 4f 4c 4c 42 41 43 4b 20  e, the ROLLBACK 
2250: 77 69 6c 6c 20 70 72 6f 63 65 65 64 20 61 6e 64  will proceed and
2260: 20 70 65 6e 64 69 6e 67 20 73 74 61 74 65 6d 65   pending stateme
2270: 6e 74 73 0a 77 69 6c 6c 20 6f 66 74 65 6e 20 62  nts.will often b
2280: 65 20 61 62 6f 72 74 65 64 2c 20 63 61 75 73 69  e aborted, causi
2290: 6e 67 20 74 68 65 6d 20 74 6f 20 72 65 74 75 72  ng them to retur
22a0: 6e 20 61 6e 20 3c 61 20 68 72 65 66 3d 22 72 65  n an <a href="re
22b0: 73 63 6f 64 65 2e 68 74 6d 6c 23 61 62 6f 72 74  scode.html#abort
22c0: 22 3e 53 51 4c 49 54 45 5f 41 42 4f 52 54 3c 2f  ">SQLITE_ABORT</
22d0: 61 3e 20 6f 72 0a 3c 61 20 68 72 65 66 3d 22 72  a> or.<a href="r
22e0: 65 73 63 6f 64 65 2e 68 74 6d 6c 23 61 62 6f 72  escode.html#abor
22f0: 74 5f 72 6f 6c 6c 62 61 63 6b 22 3e 53 51 4c 49  t_rollback">SQLI
2300: 54 45 5f 41 42 4f 52 54 5f 52 4f 4c 4c 42 41 43  TE_ABORT_ROLLBAC
2310: 4b 3c 2f 61 3e 20 65 72 72 6f 72 2e 0a 49 6e 20  K</a> error..In 
2320: 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e 20 33  SQLite version 3
2330: 2e 38 2e 38 20 28 32 30 31 35 2d 30 31 2d 31 36  .8.8 (2015-01-16
2340: 29 20 61 6e 64 20 6c 61 74 65 72 2c 0a 61 20 70  ) and later,.a p
2350: 65 6e 64 69 6e 67 20 72 65 61 64 20 77 69 6c 6c  ending read will
2360: 20 63 6f 6e 74 69 6e 75 65 20 66 75 6e 63 74 69   continue functi
2370: 6f 6e 69 6e 67 0a 61 66 74 65 72 20 74 68 65 20  oning.after the 
2380: 52 4f 4c 4c 42 41 43 4b 20 61 73 20 6c 6f 6e 67  ROLLBACK as long
2390: 20 61 73 20 74 68 65 20 52 4f 4c 4c 42 41 43 4b   as the ROLLBACK
23a0: 20 64 6f 65 73 20 6e 6f 74 20 6d 6f 64 69 66 79   does not modify
23b0: 20 74 68 65 20 64 61 74 61 62 61 73 65 0a 73 63   the database.sc
23c0: 68 65 6d 61 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  hema..</p>..<p>.
23d0: 49 66 20 3c 61 20 68 72 65 66 3d 22 70 72 61 67  If <a href="prag
23e0: 6d 61 2e 68 74 6d 6c 23 70 72 61 67 6d 61 5f 6a  ma.html#pragma_j
23f0: 6f 75 72 6e 61 6c 5f 6d 6f 64 65 22 3e 50 52 41  ournal_mode">PRA
2400: 47 4d 41 20 6a 6f 75 72 6e 61 6c 5f 6d 6f 64 65  GMA journal_mode
2410: 3c 2f 61 3e 20 69 73 20 73 65 74 20 74 6f 20 4f  </a> is set to O
2420: 46 46 20 28 74 68 75 73 20 64 69 73 61 62 6c 69  FF (thus disabli
2430: 6e 67 20 74 68 65 20 72 6f 6c 6c 62 61 63 6b 20  ng the rollback 
2440: 6a 6f 75 72 6e 61 6c 0a 66 69 6c 65 29 20 74 68  journal.file) th
2450: 65 6e 20 74 68 65 20 62 65 68 61 76 69 6f 72 20  en the behavior 
2460: 6f 66 20 74 68 65 20 52 4f 4c 4c 42 41 43 4b 20  of the ROLLBACK 
2470: 63 6f 6d 6d 61 6e 64 20 69 73 20 75 6e 64 65 66  command is undef
2480: 69 6e 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 68 33 3e  ined..</p>..<h3>
2490: 52 65 73 70 6f 6e 73 65 20 54 6f 20 45 72 72 6f  Response To Erro
24a0: 72 73 20 57 69 74 68 69 6e 20 41 20 54 72 61 6e  rs Within A Tran
24b0: 73 61 63 74 69 6f 6e 3c 2f 68 33 3e 0a 0a 3c 70  saction</h3>..<p
24c0: 3e 20 49 66 20 63 65 72 74 61 69 6e 20 6b 69 6e  > If certain kin
24d0: 64 73 20 6f 66 20 65 72 72 6f 72 73 20 6f 63 63  ds of errors occ
24e0: 75 72 20 77 69 74 68 69 6e 20 61 20 74 72 61 6e  ur within a tran
24f0: 73 61 63 74 69 6f 6e 2c 20 74 68 65 0a 74 72 61  saction, the.tra
2500: 6e 73 61 63 74 69 6f 6e 20 6d 61 79 20 6f 72 20  nsaction may or 
2510: 6d 61 79 20 6e 6f 74 20 62 65 20 72 6f 6c 6c 65  may not be rolle
2520: 64 20 62 61 63 6b 20 61 75 74 6f 6d 61 74 69 63  d back automatic
2530: 61 6c 6c 79 2e 20 20 54 68 65 0a 65 72 72 6f 72  ally.  The.error
2540: 73 20 74 68 61 74 20 63 61 6e 20 63 61 75 73 65  s that can cause
2550: 20 61 6e 20 61 75 74 6f 6d 61 74 69 63 20 72 6f   an automatic ro
2560: 6c 6c 62 61 63 6b 20 69 6e 63 6c 75 64 65 3a 3c  llback include:<
2570: 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 20 3c  /p>..<ul>.<li> <
2580: 61 20 68 72 65 66 3d 22 72 65 73 63 6f 64 65 2e  a href="rescode.
2590: 68 74 6d 6c 23 66 75 6c 6c 22 3e 53 51 4c 49 54  html#full">SQLIT
25a0: 45 5f 46 55 4c 4c 3c 2f 61 3e 3a 20 64 61 74 61  E_FULL</a>: data
25b0: 62 61 73 65 20 6f 72 20 64 69 73 6b 20 66 75 6c  base or disk ful
25c0: 6c 0a 3c 6c 69 3e 20 3c 61 20 68 72 65 66 3d 22  l.<li> <a href="
25d0: 72 65 73 63 6f 64 65 2e 68 74 6d 6c 23 69 6f 65  rescode.html#ioe
25e0: 72 72 22 3e 53 51 4c 49 54 45 5f 49 4f 45 52 52  rr">SQLITE_IOERR
25f0: 3c 2f 61 3e 3a 20 64 69 73 6b 20 49 2f 4f 20 65  </a>: disk I/O e
2600: 72 72 6f 72 0a 3c 6c 69 3e 20 3c 61 20 68 72 65  rror.<li> <a hre
2610: 66 3d 22 72 65 73 63 6f 64 65 2e 68 74 6d 6c 23  f="rescode.html#
2620: 62 75 73 79 22 3e 53 51 4c 49 54 45 5f 42 55 53  busy">SQLITE_BUS
2630: 59 3c 2f 61 3e 3a 20 64 61 74 61 62 61 73 65 20  Y</a>: database 
2640: 69 6e 20 75 73 65 20 62 79 20 61 6e 6f 74 68 65  in use by anothe
2650: 72 20 70 72 6f 63 65 73 73 0a 3c 6c 69 3e 20 3c  r process.<li> <
2660: 61 20 68 72 65 66 3d 22 72 65 73 63 6f 64 65 2e  a href="rescode.
2670: 68 74 6d 6c 23 6e 6f 6d 65 6d 22 3e 53 51 4c 49  html#nomem">SQLI
2680: 54 45 5f 4e 4f 4d 45 4d 3c 2f 61 3e 3a 20 6f 75  TE_NOMEM</a>: ou
2690: 74 20 6f 72 20 6d 65 6d 6f 72 79 0a 3c 2f 75 6c  t or memory.</ul
26a0: 3e 0a 0a 3c 70 3e 0a 46 6f 72 20 61 6c 6c 20 6f  >..<p>.For all o
26b0: 66 20 74 68 65 73 65 20 65 72 72 6f 72 73 2c 20  f these errors, 
26c0: 53 51 4c 69 74 65 20 61 74 74 65 6d 70 74 73 20  SQLite attempts 
26d0: 74 6f 20 75 6e 64 6f 20 6a 75 73 74 20 74 68 65  to undo just the
26e0: 20 6f 6e 65 20 73 74 61 74 65 6d 65 6e 74 0a 69   one statement.i
26f0: 74 20 77 61 73 20 77 6f 72 6b 69 6e 67 20 6f 6e  t was working on
2700: 20 61 6e 64 20 6c 65 61 76 65 20 63 68 61 6e 67   and leave chang
2710: 65 73 20 66 72 6f 6d 20 70 72 69 6f 72 20 73 74  es from prior st
2720: 61 74 65 6d 65 6e 74 73 20 77 69 74 68 69 6e 20  atements within 
2730: 74 68 65 0a 73 61 6d 65 20 74 72 61 6e 73 61 63  the.same transac
2740: 74 69 6f 6e 20 69 6e 74 61 63 74 20 61 6e 64 20  tion intact and 
2750: 63 6f 6e 74 69 6e 75 65 20 77 69 74 68 20 74 68  continue with th
2760: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20  e transaction.  
2770: 48 6f 77 65 76 65 72 2c 20 0a 64 65 70 65 6e 64  However, .depend
2780: 69 6e 67 20 6f 6e 20 74 68 65 20 73 74 61 74 65  ing on the state
2790: 6d 65 6e 74 20 62 65 69 6e 67 20 65 76 61 6c 75  ment being evalu
27a0: 61 74 65 64 20 61 6e 64 20 74 68 65 20 70 6f 69  ated and the poi
27b0: 6e 74 20 61 74 20 77 68 69 63 68 20 74 68 65 0a  nt at which the.
27c0: 65 72 72 6f 72 20 6f 63 63 75 72 73 2c 20 69 74  error occurs, it
27d0: 20 6d 69 67 68 74 20 62 65 20 6e 65 63 65 73 73   might be necess
27e0: 61 72 79 20 66 6f 72 20 53 51 4c 69 74 65 20 74  ary for SQLite t
27f0: 6f 20 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 0a 63  o rollback and.c
2800: 61 6e 63 65 6c 20 74 68 65 20 65 6e 74 69 72 65  ancel the entire
2810: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20 41   transaction.  A
2820: 6e 20 61 70 70 6c 69 63 61 74 69 6f 6e 20 63 61  n application ca
2830: 6e 20 74 65 6c 6c 20 77 68 69 63 68 0a 63 6f 75  n tell which.cou
2840: 72 73 65 20 6f 66 20 61 63 74 69 6f 6e 20 53 51  rse of action SQ
2850: 4c 69 74 65 20 74 6f 6f 6b 20 62 79 20 75 73 69  Lite took by usi
2860: 6e 67 20 74 68 65 0a 3c 61 20 68 72 65 66 3d 22  ng the.<a href="
2870: 63 33 72 65 66 2f 67 65 74 5f 61 75 74 6f 63 6f  c3ref/get_autoco
2880: 6d 6d 69 74 2e 68 74 6d 6c 22 3e 73 71 6c 69 74  mmit.html">sqlit
2890: 65 33 5f 67 65 74 5f 61 75 74 6f 63 6f 6d 6d 69  e3_get_autocommi
28a0: 74 28 29 3c 2f 61 3e 20 43 2d 6c 61 6e 67 75 61  t()</a> C-langua
28b0: 67 65 20 69 6e 74 65 72 66 61 63 65 2e 3c 2f 70  ge interface.</p
28c0: 3e 0a 0a 3c 70 3e 49 74 20 69 73 20 72 65 63 6f  >..<p>It is reco
28d0: 6d 6d 65 6e 64 65 64 20 74 68 61 74 20 61 70 70  mmended that app
28e0: 6c 69 63 61 74 69 6f 6e 73 20 72 65 73 70 6f 6e  lications respon
28f0: 64 20 74 6f 20 74 68 65 20 65 72 72 6f 72 73 0a  d to the errors.
2900: 6c 69 73 74 65 64 20 61 62 6f 76 65 20 62 79 20  listed above by 
2910: 65 78 70 6c 69 63 69 74 6c 79 20 69 73 73 75 69  explicitly issui
2920: 6e 67 20 61 20 52 4f 4c 4c 42 41 43 4b 20 63 6f  ng a ROLLBACK co
2930: 6d 6d 61 6e 64 2e 20 20 49 66 20 74 68 65 20 0a  mmand.  If the .
2940: 74 72 61 6e 73 61 63 74 69 6f 6e 20 68 61 73 20  transaction has 
2950: 61 6c 72 65 61 64 79 20 62 65 65 6e 20 72 6f 6c  already been rol
2960: 6c 65 64 20 62 61 63 6b 20 61 75 74 6f 6d 61 74  led back automat
2970: 69 63 61 6c 6c 79 0a 62 79 20 74 68 65 20 65 72  ically.by the er
2980: 72 6f 72 20 72 65 73 70 6f 6e 73 65 2c 20 74 68  ror response, th
2990: 65 6e 20 74 68 65 20 52 4f 4c 4c 42 41 43 4b 20  en the ROLLBACK 
29a0: 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 66 61 69  command will fai
29b0: 6c 20 77 69 74 68 20 61 6e 0a 65 72 72 6f 72 2c  l with an.error,
29c0: 20 62 75 74 20 6e 6f 20 68 61 72 6d 20 69 73 20   but no harm is 
29d0: 63 61 75 73 65 64 20 62 79 20 74 68 69 73 2e 3c  caused by this.<
29e0: 2f 70 3e 0a 0a 3c 70 3e 46 75 74 75 72 65 20 76  /p>..<p>Future v
29f0: 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74  ersions of SQLit
2a00: 65 20 6d 61 79 20 65 78 74 65 6e 64 20 74 68 65  e may extend the
2a10: 20 6c 69 73 74 20 6f 66 20 65 72 72 6f 72 73 20   list of errors 
2a20: 77 68 69 63 68 0a 6d 69 67 68 74 20 63 61 75 73  which.might caus
2a30: 65 20 61 75 74 6f 6d 61 74 69 63 20 74 72 61 6e  e automatic tran
2a40: 73 61 63 74 69 6f 6e 20 72 6f 6c 6c 62 61 63 6b  saction rollback
2a50: 2e 20 20 46 75 74 75 72 65 20 76 65 72 73 69 6f  .  Future versio
2a60: 6e 73 20 6f 66 0a 53 51 4c 69 74 65 20 6d 69 67  ns of.SQLite mig
2a70: 68 74 20 63 68 61 6e 67 65 20 74 68 65 20 65 72  ht change the er
2a80: 72 6f 72 20 72 65 73 70 6f 6e 73 65 2e 20 20 49  ror response.  I
2a90: 6e 20 70 61 72 74 69 63 75 6c 61 72 2c 20 77 65  n particular, we
2aa0: 20 6d 61 79 0a 63 68 6f 6f 73 65 20 74 6f 20 73   may.choose to s
2ab0: 69 6d 70 6c 69 66 79 20 74 68 65 20 69 6e 74 65  implify the inte
2ac0: 72 66 61 63 65 20 69 6e 20 66 75 74 75 72 65 20  rface in future 
2ad0: 76 65 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69  versions of SQLi
2ae0: 74 65 20 62 79 0a 63 61 75 73 69 6e 67 20 74 68  te by.causing th
2af0: 65 20 65 72 72 6f 72 73 20 61 62 6f 76 65 20 74  e errors above t
2b00: 6f 20 66 6f 72 63 65 20 61 6e 20 75 6e 63 6f 6e  o force an uncon
2b10: 64 69 74 69 6f 6e 61 6c 20 72 6f 6c 6c 62 61 63  ditional rollbac
2b20: 6b 2e 3c 2f 70 3e 0a 0a 0a                       k.</p>...