/ Hex Artifact Content
Login

Artifact bf9d830aa0042718ae157e25fc7539f5378c46ff:


0000: 23 0a 23 20 52 75 6e 20 74 68 69 73 20 54 63 6c  #.# Run this Tcl
0010: 20 73 63 72 69 70 74 20 74 6f 20 67 65 6e 65 72   script to gener
0020: 61 74 65 20 74 68 65 20 73 71 6c 69 74 65 2e 68  ate the sqlite.h
0030: 74 6d 6c 20 66 69 6c 65 2e 0a 23 0a 73 65 74 20  tml file..#.set 
0040: 72 63 73 69 64 20 7b 24 49 64 3a 20 6c 61 6e 67  rcsid {$Id: lang
0050: 2e 74 63 6c 2c 76 20 31 2e 34 35 20 32 30 30 32  .tcl,v 1.45 2002
0060: 2f 30 38 2f 32 35 20 32 30 3a 31 31 3a 31 39 20  /08/25 20:11:19 
0070: 64 72 68 20 45 78 70 20 24 7d 0a 0a 70 75 74 73  drh Exp $}..puts
0080: 20 7b 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64 3e 0a   {<html>.<head>.
0090: 20 20 3c 74 69 74 6c 65 3e 51 75 65 72 79 20 4c    <title>Query L
00a0: 61 6e 67 75 61 67 65 20 55 6e 64 65 72 73 74 6f  anguage Understo
00b0: 6f 64 20 42 79 20 53 51 4c 69 74 65 3c 2f 74 69  od By SQLite</ti
00c0: 74 6c 65 3e 0a 3c 2f 68 65 61 64 3e 0a 3c 62 6f  tle>.</head>.<bo
00d0: 64 79 20 62 67 63 6f 6c 6f 72 3d 77 68 69 74 65  dy bgcolor=white
00e0: 3e 0a 3c 68 31 20 61 6c 69 67 6e 3d 63 65 6e 74  >.<h1 align=cent
00f0: 65 72 3e 0a 53 51 4c 20 41 73 20 55 6e 64 65 72  er>.SQL As Under
0100: 73 74 6f 6f 64 20 42 79 20 53 51 4c 69 74 65 0a  stood By SQLite.
0110: 3c 2f 68 31 3e 7d 0a 70 75 74 73 20 22 3c 70 20  </h1>}.puts "<p 
0120: 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e 0a 28 54  align=center>.(T
0130: 68 69 73 20 70 61 67 65 20 77 61 73 20 6c 61 73  his page was las
0140: 74 20 6d 6f 64 69 66 69 65 64 20 6f 6e 20 5b 6c  t modified on [l
0150: 72 61 6e 67 65 20 24 72 63 73 69 64 20 33 20 34  range $rcsid 3 4
0160: 5d 20 55 54 43 29 0a 3c 2f 70 3e 22 0a 0a 70 75  ] UTC).</p>"..pu
0170: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 53 51 4c 69  ts {.<p>The SQLi
0180: 74 65 20 6c 69 62 72 61 72 79 20 75 6e 64 65 72  te library under
0190: 73 74 61 6e 64 73 20 6d 6f 73 74 20 6f 66 20 74  stands most of t
01a0: 68 65 20 73 74 61 6e 64 61 72 64 20 53 51 4c 0a  he standard SQL.
01b0: 6c 61 6e 67 75 61 67 65 2e 20 20 42 75 74 20 69  language.  But i
01c0: 74 20 64 6f 65 73 20 3c 61 20 68 72 65 66 3d 22  t does <a href="
01d0: 6f 6d 69 74 74 65 64 2e 68 74 6d 6c 22 3e 6f 6d  omitted.html">om
01e0: 69 74 20 73 6f 6d 65 20 66 65 61 74 75 72 65 73  it some features
01f0: 3c 2f 61 3e 0a 77 68 69 6c 65 20 61 74 20 74 68  </a>.while at th
0200: 65 20 73 61 6d 65 20 74 69 6d 65 0a 61 64 64 69  e same time.addi
0210: 6e 67 20 61 20 66 65 77 20 66 65 61 74 75 72 65  ng a few feature
0220: 73 20 6f 66 20 69 74 73 20 6f 77 6e 2e 20 20 54  s of its own.  T
0230: 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 61 74 74  his document att
0240: 65 6d 70 74 73 20 74 6f 0a 64 65 73 63 72 69 62  empts to.describ
0250: 65 20 70 65 72 63 69 73 65 6c 79 20 77 68 61 74  e percisely what
0260: 20 70 61 72 74 73 20 6f 66 20 74 68 65 20 53 51   parts of the SQ
0270: 4c 20 6c 61 6e 67 75 61 67 65 20 53 51 4c 69 74  L language SQLit
0280: 65 20 64 6f 65 73 0a 61 6e 64 20 64 6f 65 73 20  e does.and does 
0290: 6e 6f 74 20 73 75 70 70 6f 72 74 2e 3c 2f 70 3e  not support.</p>
02a0: 0a 0a 3c 70 3e 49 6e 20 61 6c 6c 20 6f 66 20 74  ..<p>In all of t
02b0: 68 65 20 73 79 6e 74 61 78 20 64 69 61 67 72 61  he syntax diagra
02c0: 6d 73 20 74 68 61 74 20 66 6f 6c 6c 6f 77 2c 20  ms that follow, 
02d0: 6c 69 74 65 72 61 6c 20 74 65 78 74 20 69 73 20  literal text is 
02e0: 73 68 6f 77 6e 20 69 6e 0a 62 6f 6c 64 20 62 6c  shown in.bold bl
02f0: 75 65 2e 20 20 4e 6f 6e 2d 74 65 72 6d 69 6e 61  ue.  Non-termina
0300: 6c 20 73 79 6d 62 6f 6c 73 20 61 72 65 20 73 68  l symbols are sh
0310: 6f 77 6e 20 69 6e 20 69 74 61 6c 69 63 20 72 65  own in italic re
0320: 64 2e 20 20 4f 70 65 72 61 74 6f 72 73 0a 74 68  d.  Operators.th
0330: 61 74 20 61 72 65 20 70 61 72 74 20 6f 66 20 74  at are part of t
0340: 68 65 20 73 79 6e 74 61 63 74 69 63 20 6d 61 72  he syntactic mar
0350: 6b 75 70 20 69 74 73 65 6c 66 20 61 72 65 20 73  kup itself are s
0360: 68 6f 77 6e 20 69 6e 20 62 6c 61 63 6b 20 72 6f  hown in black ro
0370: 6d 61 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 69  man.</p>..<p>Thi
0380: 73 20 64 6f 63 75 6d 65 6e 74 20 69 73 20 6a 75  s document is ju
0390: 73 74 20 61 6e 20 6f 76 65 72 76 69 65 77 20 6f  st an overview o
03a0: 66 20 74 68 65 20 53 51 4c 20 73 79 6e 74 61 78  f the SQL syntax
03b0: 20 69 6d 70 6c 65 6d 65 6e 74 65 64 0a 62 79 20   implemented.by 
03c0: 53 51 4c 69 74 65 2e 20 20 4d 61 6e 79 20 6c 6f  SQLite.  Many lo
03d0: 77 2d 6c 65 76 65 6c 20 70 72 6f 64 75 63 74 69  w-level producti
03e0: 6f 6e 73 20 61 72 65 20 6f 6d 69 74 74 65 64 2e  ons are omitted.
03f0: 20 20 46 6f 72 20 64 65 74 61 69 6c 65 64 20 69    For detailed i
0400: 6e 66 6f 72 6d 61 74 69 6f 6e 0a 6f 6e 20 74 68  nformation.on th
0410: 65 20 6c 61 6e 67 75 61 67 65 20 74 68 61 74 20  e language that 
0420: 53 51 4c 69 74 65 20 75 6e 64 65 72 73 74 61 6e  SQLite understan
0430: 64 73 2c 20 72 65 66 65 72 20 74 6f 20 74 68 65  ds, refer to the
0440: 20 73 6f 75 72 63 65 20 63 6f 64 65 2e 3c 2f 70   source code.</p
0450: 3e 0a 0a 0a 3c 70 3e 53 51 4c 69 74 65 20 69 6d  >...<p>SQLite im
0460: 70 6c 65 6d 65 6e 74 73 20 74 68 65 20 66 6f 6c  plements the fol
0470: 6c 6f 77 20 73 79 6e 74 61 78 3a 3c 2f 70 3e 0a  low syntax:</p>.
0480: 3c 70 3e 3c 75 6c 3e 0a 7d 0a 0a 66 6f 72 65 61  <p><ul>.}..forea
0490: 63 68 20 7b 73 65 63 74 69 6f 6e 7d 20 5b 6c 73  ch {section} [ls
04a0: 6f 72 74 20 2d 69 6e 64 65 78 20 30 20 2d 64 69  ort -index 0 -di
04b0: 63 74 69 6f 6e 61 72 79 20 7b 0a 20 20 7b 7b 43  ctionary {.  {{C
04c0: 52 45 41 54 45 20 54 41 42 4c 45 7d 20 63 72 65  REATE TABLE} cre
04d0: 61 74 65 74 61 62 6c 65 7d 0a 20 20 7b 7b 43 52  atetable}.  {{CR
04e0: 45 41 54 45 20 49 4e 44 45 58 7d 20 63 72 65 61  EATE INDEX} crea
04f0: 74 65 69 6e 64 65 78 7d 0a 20 20 7b 56 41 43 55  teindex}.  {VACU
0500: 55 4d 20 76 61 63 75 75 6d 7d 0a 20 20 7b 7b 44  UM vacuum}.  {{D
0510: 52 4f 50 20 54 41 42 4c 45 7d 20 64 72 6f 70 74  ROP TABLE} dropt
0520: 61 62 6c 65 7d 0a 20 20 7b 7b 44 52 4f 50 20 49  able}.  {{DROP I
0530: 4e 44 45 58 7d 20 64 72 6f 70 69 6e 64 65 78 7d  NDEX} dropindex}
0540: 0a 20 20 7b 49 4e 53 45 52 54 20 69 6e 73 65 72  .  {INSERT inser
0550: 74 7d 0a 20 20 7b 52 45 50 4c 41 43 45 20 72 65  t}.  {REPLACE re
0560: 70 6c 61 63 65 7d 0a 20 20 7b 44 45 4c 45 54 45  place}.  {DELETE
0570: 20 64 65 6c 65 74 65 7d 0a 20 20 7b 55 50 44 41   delete}.  {UPDA
0580: 54 45 20 75 70 64 61 74 65 7d 0a 20 20 7b 53 45  TE update}.  {SE
0590: 4c 45 43 54 20 73 65 6c 65 63 74 7d 0a 20 20 7b  LECT select}.  {
05a0: 43 4f 50 59 20 63 6f 70 79 7d 0a 20 20 7b 45 58  COPY copy}.  {EX
05b0: 50 4c 41 49 4e 20 65 78 70 6c 61 69 6e 7d 0a 20  PLAIN explain}. 
05c0: 20 7b 65 78 70 72 65 73 73 69 6f 6e 20 65 78 70   {expression exp
05d0: 72 7d 0a 20 20 7b 7b 42 45 47 49 4e 20 54 52 41  r}.  {{BEGIN TRA
05e0: 4e 53 41 43 54 49 4f 4e 7d 20 74 72 61 6e 73 61  NSACTION} transa
05f0: 63 74 69 6f 6e 7d 0a 20 20 7b 50 52 41 47 4d 41  ction}.  {PRAGMA
0600: 20 70 72 61 67 6d 61 7d 0a 20 20 7b 7b 4f 4e 20   pragma}.  {{ON 
0610: 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 7d  CONFLICT clause}
0620: 20 63 6f 6e 66 6c 69 63 74 7d 0a 20 20 7b 7b 43   conflict}.  {{C
0630: 52 45 41 54 45 20 56 49 45 57 7d 20 63 72 65 61  REATE VIEW} crea
0640: 74 65 76 69 65 77 7d 0a 20 20 7b 7b 44 52 4f 50  teview}.  {{DROP
0650: 20 56 49 45 57 7d 20 64 72 6f 70 76 69 65 77 7d   VIEW} dropview}
0660: 0a 20 20 7b 7b 43 52 45 41 54 45 20 54 52 49 47  .  {{CREATE TRIG
0670: 47 45 52 7d 20 63 72 65 61 74 65 74 72 69 67 67  GER} createtrigg
0680: 65 72 7d 0a 20 20 7b 7b 44 52 4f 50 20 54 52 49  er}.  {{DROP TRI
0690: 47 47 45 52 7d 20 64 72 6f 70 74 72 69 67 67 65  GGER} droptrigge
06a0: 72 7d 0a 7d 5d 20 7b 0a 20 20 70 75 74 73 20 22  r}.}] {.  puts "
06b0: 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 5c 22 23 5b  <li><a href=\"#[
06c0: 6c 69 6e 64 65 78 20 24 73 65 63 74 69 6f 6e 20  lindex $section 
06d0: 31 5d 5c 22 3e 5b 6c 69 6e 64 65 78 20 24 73 65  1]\">[lindex $se
06e0: 63 74 69 6f 6e 20 30 5d 3c 2f 61 3e 3c 2f 6c 69  ction 0]</a></li
06f0: 3e 22 0a 7d 0a 70 75 74 73 20 7b 3c 2f 75 6c 3e  >".}.puts {</ul>
0700: 3c 2f 70 3e 0a 0a 3c 70 3e 44 65 74 61 69 6c 73  </p>..<p>Details
0710: 20 6f 6e 20 74 68 65 20 69 6d 70 6c 65 6d 65 6e   on the implemen
0720: 74 61 74 69 6f 6e 20 6f 66 20 65 61 63 68 20 63  tation of each c
0730: 6f 6d 6d 61 6e 64 20 61 72 65 20 70 72 6f 76 69  ommand are provi
0740: 64 65 64 20 69 6e 0a 74 68 65 20 73 65 71 75 65  ded in.the seque
0750: 6c 2e 3c 2f 70 3e 0a 7d 0a 0a 70 72 6f 63 20 53  l.</p>.}..proc S
0760: 79 6e 74 61 78 20 7b 61 72 67 73 7d 20 7b 0a 20  yntax {args} {. 
0770: 20 70 75 74 73 20 7b 3c 74 61 62 6c 65 20 63 65   puts {<table ce
0780: 6c 6c 70 61 64 64 69 6e 67 3d 22 31 30 22 3e 7d  llpadding="10">}
0790: 0a 20 20 66 6f 72 65 61 63 68 20 7b 72 75 6c 65  .  foreach {rule
07a0: 20 62 6f 64 79 7d 20 24 61 72 67 73 20 7b 0a 20   body} $args {. 
07b0: 20 20 20 70 75 74 73 20 22 3c 74 72 3e 3c 74 64     puts "<tr><td
07c0: 20 61 6c 69 67 6e 3d 5c 22 72 69 67 68 74 5c 22   align=\"right\"
07d0: 20 76 61 6c 69 67 6e 3d 5c 22 74 6f 70 5c 22 3e   valign=\"top\">
07e0: 22 0a 20 20 20 20 70 75 74 73 20 22 3c 69 3e 3c  ".    puts "<i><
07f0: 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 66 66  font color=\"#ff
0800: 33 34 33 34 5c 22 3e 24 72 75 6c 65 3c 2f 66 6f  3434\">$rule</fo
0810: 6e 74 3e 3c 2f 69 3e 26 6e 62 73 70 3b 3a 3a 3d  nt></i>&nbsp;::=
0820: 3c 2f 74 64 3e 22 0a 20 20 20 20 72 65 67 73 75  </td>".    regsu
0830: 62 20 2d 61 6c 6c 20 3c 20 24 62 6f 64 79 20 7b  b -all < $body {
0840: 25 4c 54 7d 20 62 6f 64 79 0a 20 20 20 20 72 65  %LT} body.    re
0850: 67 73 75 62 20 2d 61 6c 6c 20 3e 20 24 62 6f 64  gsub -all > $bod
0860: 79 20 7b 25 47 54 7d 20 62 6f 64 79 0a 20 20 20  y {%GT} body.   
0870: 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 25 4c 54   regsub -all %LT
0880: 20 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e 74 3e 3c   $body {</font><
0890: 2f 62 3e 3c 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f  /b><i><font colo
08a0: 72 3d 22 23 66 66 33 34 33 34 22 3e 7d 20 62 6f  r="#ff3434">} bo
08b0: 64 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d 61  dy.    regsub -a
08c0: 6c 6c 20 25 47 54 20 24 62 6f 64 79 20 7b 3c 2f  ll %GT $body {</
08d0: 66 6f 6e 74 3e 3c 2f 69 3e 3c 62 3e 3c 66 6f 6e  font></i><b><fon
08e0: 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30  t color="#2c2cf0
08f0: 22 3e 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67  ">} body.    reg
0900: 73 75 62 20 2d 61 6c 6c 20 7b 5b 5d 7c 5b 2a 3f  sub -all {[]|[*?
0910: 5d 7d 20 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e 74  ]} $body {</font
0920: 3e 3c 2f 62 3e 26 3c 62 3e 3c 66 6f 6e 74 20 63  ></b>&<b><font c
0930: 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e 7d  olor="#2c2cf0">}
0940: 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62   body.    regsub
0950: 20 2d 61 6c 6c 20 22 5c 6e 22 20 5b 73 74 72 69   -all "\n" [stri
0960: 6e 67 20 74 72 69 6d 20 24 62 6f 64 79 5d 20 22  ng trim $body] "
0970: 3c 62 72 3e 5c 6e 22 20 62 6f 64 79 0a 20 20 20  <br>\n" body.   
0980: 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c 6e   regsub -all "\n
0990: 20 20 2a 22 20 24 62 6f 64 79 20 22 5c 6e 5c 5c    *" $body "\n\\
09a0: 26 6e 62 73 70 3b 5c 5c 26 6e 62 73 70 3b 5c 5c  &nbsp;\\&nbsp;\\
09b0: 26 6e 62 73 70 3b 5c 5c 26 6e 62 73 70 3b 22 20  &nbsp;\\&nbsp;" 
09c0: 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62 20  body.    regsub 
09d0: 2d 61 6c 6c 20 7b 5b 7c 2c 2e 2a 28 29 5d 7d 20  -all {[|,.*()]} 
09e0: 24 62 6f 64 79 20 7b 3c 62 69 67 3e 26 3c 2f 62  $body {<big>&</b
09f0: 69 67 3e 7d 20 62 6f 64 79 0a 20 20 20 20 72 65  ig>} body.    re
0a00: 67 73 75 62 20 2d 61 6c 6c 20 7b 20 3d 20 7d 20  gsub -all { = } 
0a10: 24 62 6f 64 79 20 7b 20 3c 62 69 67 3e 3d 3c 2f  $body { <big>=</
0a20: 62 69 67 3e 20 7d 20 62 6f 64 79 0a 20 20 20 20  big> } body.    
0a30: 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 53 54 41  regsub -all {STA
0a40: 52 7d 20 24 62 6f 64 79 20 7b 3c 62 69 67 3e 2a  R} $body {<big>*
0a50: 3c 2f 62 69 67 3e 7d 20 62 6f 64 79 0a 20 20 20  </big>} body.   
0a60: 20 70 75 74 73 20 22 3c 74 64 3e 3c 62 3e 3c 66   puts "<td><b><f
0a70: 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32  ont color=\"#2c2
0a80: 63 66 30 5c 22 3e 24 62 6f 64 79 3c 2f 66 6f 6e  cf0\">$body</fon
0a90: 74 3e 3c 2f 62 3e 3c 2f 74 64 3e 3c 2f 74 72 3e  t></b></td></tr>
0aa0: 22 0a 20 20 7d 0a 20 20 70 75 74 73 20 7b 3c 2f  ".  }.  puts {</
0ab0: 74 61 62 6c 65 3e 7d 0a 7d 0a 70 72 6f 63 20 4f  table>}.}.proc O
0ac0: 70 65 72 61 74 6f 72 20 7b 6e 61 6d 65 7d 20 7b  perator {name} {
0ad0: 0a 20 20 72 65 74 75 72 6e 20 22 3c 66 6f 6e 74  .  return "<font
0ae0: 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32 63 66 30   color=\"#2c2cf0
0af0: 5c 22 3e 3c 62 69 67 3e 24 6e 61 6d 65 3c 2f 62  \"><big>$name</b
0b00: 69 67 3e 3c 2f 66 6f 6e 74 3e 22 0a 7d 0a 70 72  ig></font>".}.pr
0b10: 6f 63 20 4e 6f 6e 74 65 72 6d 69 6e 61 6c 20 7b  oc Nonterminal {
0b20: 6e 61 6d 65 7d 20 7b 0a 20 20 72 65 74 75 72 6e  name} {.  return
0b30: 20 22 3c 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f 72   "<i><font color
0b40: 3d 5c 22 23 66 66 33 34 33 34 5c 22 3e 24 6e 61  =\"#ff3434\">$na
0b50: 6d 65 3c 2f 66 6f 6e 74 3e 3c 2f 69 3e 22 0a 7d  me</font></i>".}
0b60: 0a 70 72 6f 63 20 4b 65 79 77 6f 72 64 20 7b 6e  .proc Keyword {n
0b70: 61 6d 65 7d 20 7b 0a 20 20 72 65 74 75 72 6e 20  ame} {.  return 
0b80: 22 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23  "<font color=\"#
0b90: 32 63 32 63 66 30 5c 22 3e 24 6e 61 6d 65 3c 2f  2c2cf0\">$name</
0ba0: 66 6f 6e 74 3e 22 0a 7d 0a 20 0a 0a 70 72 6f 63  font>".}. ..proc
0bb0: 20 53 65 63 74 69 6f 6e 20 7b 6e 61 6d 65 20 7b   Section {name {
0bc0: 6c 61 62 65 6c 20 7b 7d 7d 7d 20 7b 0a 20 20 70  label {}}} {.  p
0bd0: 75 74 73 20 22 5c 6e 3c 68 72 20 2f 3e 22 0a 20  uts "\n<hr />". 
0be0: 20 69 66 20 7b 24 6c 61 62 65 6c 21 3d 22 22 7d   if {$label!=""}
0bf0: 20 7b 0a 20 20 20 20 70 75 74 73 20 22 3c 61 20   {.    puts "<a 
0c00: 6e 61 6d 65 3d 5c 22 24 6c 61 62 65 6c 5c 22 3e  name=\"$label\">
0c10: 22 0a 20 20 7d 0a 20 20 70 75 74 73 20 22 3c 68  ".  }.  puts "<h
0c20: 31 3e 24 6e 61 6d 65 3c 2f 68 31 3e 5c 6e 22 0a  1>$name</h1>\n".
0c30: 7d 0a 0a 70 72 6f 63 20 45 78 61 6d 70 6c 65 20  }..proc Example 
0c40: 7b 74 65 78 74 7d 20 7b 0a 20 20 70 75 74 73 20  {text} {.  puts 
0c50: 22 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  "<blockquote><pr
0c60: 65 3e 24 74 65 78 74 3c 2f 70 72 65 3e 3c 2f 62  e>$text</pre></b
0c70: 6c 6f 63 6b 71 75 6f 74 65 3e 22 0a 7d 0a 0a 53  lockquote>".}..S
0c80: 65 63 74 69 6f 6e 20 7b 42 45 47 49 4e 20 54 52  ection {BEGIN TR
0c90: 41 4e 53 41 43 54 49 4f 4e 7d 20 63 72 65 61 74  ANSACTION} creat
0ca0: 65 69 6e 64 65 78 0a 0a 53 79 6e 74 61 78 20 7b  eindex..Syntax {
0cb0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
0cc0: 0a 42 45 47 49 4e 20 5b 54 52 41 4e 53 41 43 54  .BEGIN [TRANSACT
0cd0: 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 20 5b 4f  ION [<name>]] [O
0ce0: 4e 20 43 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e 66  N CONFLICT <conf
0cf0: 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 5d  lict-algorithm>]
0d00: 0a 7d 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  .}.Syntax {sql-s
0d10: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 45 4e 44 20  tatement} {.END 
0d20: 5b 54 52 41 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e  [TRANSACTION [<n
0d30: 61 6d 65 3e 5d 5d 0a 7d 0a 53 79 6e 74 61 78 20  ame>]].}.Syntax 
0d40: 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20  {sql-statement} 
0d50: 7b 0a 43 4f 4d 4d 49 54 20 5b 54 52 41 4e 53 41  {.COMMIT [TRANSA
0d60: 43 54 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a  CTION [<name>]].
0d70: 7d 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  }.Syntax {sql-st
0d80: 61 74 65 6d 65 6e 74 7d 20 7b 0a 52 4f 4c 4c 42  atement} {.ROLLB
0d90: 41 43 4b 20 5b 54 52 41 4e 53 41 43 54 49 4f 4e  ACK [TRANSACTION
0da0: 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 0a 70 75   [<name>]].}..pu
0db0: 74 73 20 7b 0a 3c 70 3e 42 65 67 69 6e 6e 69 6e  ts {.<p>Beginnin
0dc0: 67 20 69 6e 20 76 65 72 73 69 6f 6e 20 32 2e 30  g in version 2.0
0dd0: 2c 20 53 51 4c 69 74 65 20 73 75 70 70 6f 72 74  , SQLite support
0de0: 73 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 77  s transactions w
0df0: 69 74 68 0a 72 6f 6c 6c 62 61 63 6b 20 61 6e 64  ith.rollback and
0e00: 20 61 74 6f 6d 69 63 20 63 6f 6d 6d 69 74 2e 3c   atomic commit.<
0e10: 2f 70 3e 0a 0a 3c 70 3e 0a 4e 6f 20 63 68 61 6e  /p>..<p>.No chan
0e20: 67 65 73 20 63 61 6e 20 62 65 20 6d 61 64 65 20  ges can be made 
0e30: 74 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20  to the database 
0e40: 65 78 63 65 70 74 20 77 69 74 68 69 6e 20 61 20  except within a 
0e50: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 0a 41 6e 79  transaction..Any
0e60: 20 63 6f 6d 6d 61 6e 64 20 74 68 61 74 20 63 68   command that ch
0e70: 61 6e 67 65 73 20 74 68 65 20 64 61 74 61 62 61  anges the databa
0e80: 73 65 20 28 62 61 73 69 63 61 6c 6c 79 2c 20 61  se (basically, a
0e90: 6e 79 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a 6f  ny SQL command.o
0ea0: 74 68 65 72 20 74 68 61 6e 20 53 45 4c 45 43 54  ther than SELECT
0eb0: 29 20 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63  ) will automatic
0ec0: 61 6c 6c 79 20 73 74 61 72 74 73 20 61 20 74 72  ally starts a tr
0ed0: 61 6e 73 61 63 74 69 6f 6e 20 69 66 0a 6f 6e 65  ansaction if.one
0ee0: 20 69 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20   is not already 
0ef0: 69 6e 20 65 66 66 65 63 74 2e 20 20 41 75 74 6f  in effect.  Auto
0f00: 6d 61 74 69 63 61 6c 6c 79 20 73 74 61 72 74 65  matically starte
0f10: 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 73 0a 61  d transactions.a
0f20: 72 65 20 63 6f 6d 6d 69 74 74 65 64 20 61 74 20  re committed at 
0f30: 74 68 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f  the conclusion o
0f40: 66 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 0a 3c  f the command..<
0f50: 2f 70 3e 0a 0a 3c 70 3e 0a 54 72 61 6e 73 61 63  /p>..<p>.Transac
0f60: 74 69 6f 6e 73 20 63 61 6e 20 62 65 20 73 74 61  tions can be sta
0f70: 72 74 65 64 20 6d 61 6e 75 61 6c 6c 79 20 75 73  rted manually us
0f80: 69 6e 67 20 74 68 65 20 42 45 47 49 4e 0a 63 6f  ing the BEGIN.co
0f90: 6d 6d 61 6e 64 2e 20 53 75 63 68 20 74 72 61 6e  mmand. Such tran
0fa0: 73 61 63 74 69 6f 6e 73 20 75 73 75 61 6c 6c 79  sactions usually
0fb0: 20 70 65 72 73 69 73 74 20 75 6e 74 69 6c 20 74   persist until t
0fc0: 68 65 20 6e 65 78 74 0a 43 4f 4d 4d 49 54 20 6f  he next.COMMIT o
0fd0: 72 20 52 4f 4c 4c 42 41 43 4b 20 63 6f 6d 6d 61  r ROLLBACK comma
0fe0: 6e 64 2e 20 42 75 74 20 61 20 74 72 61 6e 73 61  nd. But a transa
0ff0: 63 74 69 6f 6e 20 77 69 6c 6c 20 61 6c 73 6f 20  ction will also 
1000: 0a 52 4f 4c 4c 42 41 43 4b 20 69 66 20 74 68 65  .ROLLBACK if the
1010: 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f   database is clo
1020: 73 65 64 20 6f 72 20 69 66 20 61 6e 20 65 72 72  sed or if an err
1030: 6f 72 20 6f 63 63 75 72 73 0a 61 6e 64 20 74 68  or occurs.and th
1040: 65 20 52 4f 4c 4c 42 41 43 4b 20 63 6f 6e 66 6c  e ROLLBACK confl
1050: 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict resolution a
1060: 6c 67 6f 72 69 74 68 6d 20 69 73 20 73 70 65 63  lgorithm is spec
1070: 69 66 69 65 64 2e 0a 53 65 65 20 74 68 65 20 64  ified..See the d
1080: 6f 63 75 6d 65 6e 74 69 6f 6e 20 6f 6e 20 74 68  ocumention on th
1090: 65 20 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e 66  e <a href="#conf
10a0: 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43  lict">ON CONFLIC
10b0: 54 3c 2f 61 3e 0a 63 6c 61 75 73 65 20 66 6f 72  T</a>.clause for
10c0: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f   additional info
10d0: 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68  rmation about th
10e0: 65 20 52 4f 4c 4c 42 41 43 4b 0a 63 6f 6e 66 6c  e ROLLBACK.confl
10f0: 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict resolution a
1100: 6c 67 6f 72 69 74 68 6d 2e 0a 3c 2f 70 3e 0a 0a  lgorithm..</p>..
1110: 3c 70 3e 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c  <p>.The optional
1120: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61   ON CONFLICT cla
1130: 75 73 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f  use at the end o
1140: 66 20 61 20 42 45 47 49 4e 20 73 74 61 74 65 6d  f a BEGIN statem
1150: 65 6e 74 0a 63 61 6e 20 62 65 20 75 73 65 64 20  ent.can be used 
1160: 74 6f 20 63 68 61 6e 67 65 64 20 74 68 65 20 64  to changed the d
1170: 65 66 61 75 6c 74 20 63 6f 6e 66 6c 69 63 74 20  efault conflict 
1180: 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72  resolution algor
1190: 69 74 68 6d 2e 0a 54 68 65 20 6e 6f 72 6d 61 6c  ithm..The normal
11a0: 20 64 65 66 61 75 6c 74 20 69 73 20 41 42 4f 52   default is ABOR
11b0: 54 2e 20 20 49 66 20 61 6e 20 61 6c 74 65 72 6e  T.  If an altern
11c0: 61 74 69 76 65 20 69 73 20 73 70 65 63 69 66 69  ative is specifi
11d0: 65 64 20 62 79 0a 74 68 65 20 4f 4e 20 43 4f 4e  ed by.the ON CON
11e0: 46 4c 49 43 54 20 63 6c 61 75 73 65 20 6f 66 20  FLICT clause of 
11f0: 61 20 42 45 47 49 4e 2c 20 74 68 65 6e 20 74 68  a BEGIN, then th
1200: 61 74 20 61 6c 74 65 72 6e 61 74 69 76 65 20 69  at alternative i
1210: 73 20 75 73 65 64 0a 61 73 20 74 68 65 20 64 65  s used.as the de
1220: 66 61 75 6c 74 20 66 6f 72 20 61 6c 6c 20 63 6f  fault for all co
1230: 6d 6d 61 6e 64 73 20 77 69 74 68 69 6e 20 74 68  mmands within th
1240: 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20  e transaction.  
1250: 54 68 65 20 64 65 66 61 75 6c 74 0a 61 6c 67 6f  The default.algo
1260: 72 69 74 68 6d 20 69 73 20 6f 76 65 72 72 69 64  rithm is overrid
1270: 64 65 6e 20 62 79 20 4f 4e 20 43 4f 4e 46 4c 49  den by ON CONFLI
1280: 43 54 20 63 6c 61 75 73 65 73 20 6f 6e 20 69 6e  CT clauses on in
1290: 64 69 76 69 64 75 61 6c 0a 63 6f 6e 73 74 72 61  dividual.constra
12a0: 69 6e 74 73 20 77 69 74 68 69 6e 20 74 68 65 20  ints within the 
12b0: 43 52 45 41 54 45 20 54 41 42 4c 45 20 6f 72 20  CREATE TABLE or 
12c0: 43 52 45 41 54 45 20 49 4e 44 45 58 20 73 74 61  CREATE INDEX sta
12d0: 74 65 6d 65 6e 74 73 0a 61 6e 64 20 62 79 20 74  tements.and by t
12e0: 68 65 20 4f 52 20 63 6c 61 75 73 65 73 20 6f 6e  he OR clauses on
12f0: 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20 61   COPY, INSERT, a
1300: 6e 64 20 55 50 44 41 54 45 20 63 6f 6d 6d 61 6e  nd UPDATE comman
1310: 64 73 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74  ds..</p>.}..Sect
1320: 69 6f 6e 20 43 4f 50 59 20 63 6f 70 79 0a 0a 53  ion COPY copy..S
1330: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
1340: 6d 65 6e 74 7d 20 7b 0a 43 4f 50 59 20 5b 20 4f  ment} {.COPY [ O
1350: 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f  R <conflict-algo
1360: 72 69 74 68 6d 3e 20 5d 20 3c 74 61 62 6c 65 2d  rithm> ] <table-
1370: 6e 61 6d 65 3e 20 46 52 4f 4d 20 3c 66 69 6c 65  name> FROM <file
1380: 6e 61 6d 65 3e 0a 5b 20 55 53 49 4e 47 20 44 45  name>.[ USING DE
1390: 4c 49 4d 49 54 45 52 53 20 3c 64 65 6c 69 6d 3e  LIMITERS <delim>
13a0: 20 5d 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70   ].}...puts {.<p
13b0: 3e 54 68 65 20 43 4f 50 59 20 63 6f 6d 6d 61 6e  >The COPY comman
13c0: 64 20 69 73 20 61 6e 20 65 78 74 65 6e 73 69 6f  d is an extensio
13d0: 6e 20 75 73 65 64 20 74 6f 20 6c 6f 61 64 20 6c  n used to load l
13e0: 61 72 67 65 20 61 6d 6f 75 6e 74 73 20 6f 66 0a  arge amounts of.
13f0: 64 61 74 61 20 69 6e 74 6f 20 61 20 74 61 62 6c  data into a tabl
1400: 65 2e 20 20 49 74 20 69 73 20 6d 6f 64 65 6c 65  e.  It is modele
1410: 64 20 61 66 74 65 72 20 61 20 73 69 6d 69 6c 61  d after a simila
1420: 72 20 63 6f 6d 6d 61 6e 64 20 66 6f 75 6e 64 0a  r command found.
1430: 69 6e 20 50 6f 73 74 67 72 65 53 51 4c 2e 20 20  in PostgreSQL.  
1440: 49 6e 20 66 61 63 74 2c 20 74 68 65 20 53 51 4c  In fact, the SQL
1450: 69 74 65 20 43 4f 50 59 20 63 6f 6d 6d 61 6e 64  ite COPY command
1460: 20 69 73 20 73 70 65 63 69 66 69 63 61 6c 6c 79   is specifically
1470: 0a 64 65 73 69 67 6e 65 64 20 74 6f 20 62 65 20  .designed to be 
1480: 61 62 6c 65 20 74 6f 20 72 65 61 64 20 74 68 65  able to read the
1490: 20 6f 75 74 70 75 74 20 6f 66 20 74 68 65 20 50   output of the P
14a0: 6f 73 74 67 72 65 53 51 4c 20 64 75 6d 70 0a 75  ostgreSQL dump.u
14b0: 74 69 6c 69 74 79 20 3c 62 3e 70 67 5f 64 75 6d  tility <b>pg_dum
14c0: 70 3c 2f 62 3e 20 73 6f 20 74 68 61 74 20 64 61  p</b> so that da
14d0: 74 61 20 63 61 6e 20 62 65 20 65 61 73 69 6c 79  ta can be easily
14e0: 20 74 72 61 6e 73 66 65 72 72 65 64 20 66 72 6f   transferred fro
14f0: 6d 0a 50 6f 73 74 67 72 65 53 51 4c 20 69 6e 74  m.PostgreSQL int
1500: 6f 20 53 51 4c 69 74 65 2e 3c 70 3e 0a 0a 3c 70  o SQLite.<p>..<p
1510: 3e 54 68 65 20 74 61 62 6c 65 2d 6e 61 6d 65 20  >The table-name 
1520: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 61  is the name of a
1530: 6e 20 65 78 69 73 74 69 6e 67 20 74 61 62 6c 65  n existing table
1540: 20 77 68 69 63 68 20 69 73 20 74 6f 0a 62 65 20   which is to.be 
1550: 66 69 6c 6c 65 64 20 77 69 74 68 20 64 61 74 61  filled with data
1560: 2e 20 20 54 68 65 20 66 69 6c 65 6e 61 6d 65 20  .  The filename 
1570: 69 73 20 61 20 73 74 72 69 6e 67 20 6f 72 20 69  is a string or i
1580: 64 65 6e 74 69 66 69 65 72 20 74 68 61 74 0a 6e  dentifier that.n
1590: 61 6d 65 73 20 61 20 66 69 6c 65 20 66 72 6f 6d  ames a file from
15a0: 20 77 68 69 63 68 20 64 61 74 61 20 77 69 6c 6c   which data will
15b0: 20 62 65 20 72 65 61 64 2e 20 20 54 68 65 20 66   be read.  The f
15c0: 69 6c 65 6e 61 6d 65 20 63 61 6e 20 62 65 0a 74  ilename can be.t
15d0: 68 65 20 3c 62 3e 53 54 44 49 4e 3c 2f 62 3e 20  he <b>STDIN</b> 
15e0: 74 6f 20 72 65 61 64 20 64 61 74 61 20 66 72 6f  to read data fro
15f0: 6d 20 73 74 61 6e 64 61 72 64 20 69 6e 70 75 74  m standard input
1600: 2e 3c 70 3e 0a 0a 3c 70 3e 45 61 63 68 20 6c 69  .<p>..<p>Each li
1610: 6e 65 20 6f 66 20 74 68 65 20 69 6e 70 75 74 20  ne of the input 
1620: 66 69 6c 65 20 69 73 20 63 6f 6e 76 65 72 74 65  file is converte
1630: 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20  d into a single 
1640: 72 65 63 6f 72 64 0a 69 6e 20 74 68 65 20 74 61  record.in the ta
1650: 62 6c 65 2e 20 20 43 6f 6c 75 6d 6e 73 20 61 72  ble.  Columns ar
1660: 65 20 73 65 70 61 72 61 74 65 64 20 62 79 20 74  e separated by t
1670: 61 62 73 2e 20 20 49 66 20 61 20 74 61 62 20 6f  abs.  If a tab o
1680: 63 63 75 72 73 20 61 73 0a 64 61 74 61 20 77 69  ccurs as.data wi
1690: 74 68 69 6e 20 61 20 63 6f 6c 75 6d 6e 2c 20 74  thin a column, t
16a0: 68 65 6e 20 74 68 61 74 20 74 61 62 20 69 73 20  hen that tab is 
16b0: 70 72 65 63 65 64 65 64 20 62 79 20 61 20 62 61  preceded by a ba
16c0: 73 6b 73 6c 61 73 68 20 22 5c 22 0a 63 68 61 72  skslash "\".char
16d0: 61 63 74 65 72 2e 20 20 41 20 62 61 73 6b 73 6c  acter.  A basksl
16e0: 61 73 68 20 69 6e 20 74 68 65 20 64 61 74 61 20  ash in the data 
16f0: 61 70 70 65 61 72 73 20 61 73 20 74 77 6f 20 62  appears as two b
1700: 61 63 6b 73 6c 61 73 68 65 73 20 69 6e 0a 61 20  ackslashes in.a 
1710: 72 6f 77 2e 20 20 54 68 65 20 6f 70 74 69 6f 6e  row.  The option
1720: 61 6c 20 55 53 49 4e 47 20 44 45 4c 49 4d 49 54  al USING DELIMIT
1730: 45 52 53 20 63 6c 61 75 73 65 20 63 61 6e 20 73  ERS clause can s
1740: 70 65 63 69 66 79 20 61 20 64 65 6c 69 6d 69 74  pecify a delimit
1750: 65 72 0a 6f 74 68 65 72 20 74 68 61 6e 20 74 61  er.other than ta
1760: 62 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 20  b.</p>..<p>If a 
1770: 63 6f 6c 75 6d 6e 20 63 6f 6e 73 69 73 74 73 20  column consists 
1780: 6f 66 20 74 68 65 20 63 68 61 72 61 63 74 65 72  of the character
1790: 20 22 5c 4e 22 2c 20 74 68 61 74 20 63 6f 6c 75   "\N", that colu
17a0: 6d 6e 20 69 73 20 66 69 6c 6c 65 64 0a 77 69 74  mn is filled.wit
17b0: 68 20 74 68 65 20 76 61 6c 75 65 20 4e 55 4c 4c  h the value NULL
17c0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70  .</p>..<p>The op
17d0: 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d  tional conflict-
17e0: 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20 74 68  clause allows th
17f0: 65 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20  e specification 
1800: 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76  of an alternativ
1810: 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e  e.constraint con
1820: 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e  flict resolution
1830: 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 75 73   algorithm to us
1840: 65 20 66 6f 72 20 74 68 69 73 20 6f 6e 65 20 63  e for this one c
1850: 6f 6d 6d 61 6e 64 2e 0a 53 65 65 20 74 68 65 20  ommand..See the 
1860: 73 65 63 74 69 6f 6e 20 74 69 74 6c 65 64 0a 3c  section titled.<
1870: 61 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63  a href="#conflic
1880: 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f  t">ON CONFLICT</
1890: 61 3e 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61  a> for additiona
18a0: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f  l information.</
18b0: 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 74 68 65 20  p>..<p>When the 
18c0: 69 6e 70 75 74 20 64 61 74 61 20 73 6f 75 72 63  input data sourc
18d0: 65 20 69 73 20 53 54 44 49 4e 2c 20 74 68 65 20  e is STDIN, the 
18e0: 69 6e 70 75 74 20 63 61 6e 20 62 65 20 74 65 72  input can be ter
18f0: 6d 69 6e 61 74 65 64 0a 62 79 20 61 20 6c 69 6e  minated.by a lin
1900: 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73 20  e that contains 
1910: 6f 6e 6c 79 20 61 20 62 61 73 6b 73 6c 61 73 68  only a baskslash
1920: 20 61 6e 64 20 61 20 64 6f 74 3a 7d 0a 70 75 74   and a dot:}.put
1930: 73 20 22 5c 22 5b 4f 70 65 72 61 74 6f 72 20 5c  s "\"[Operator \
1940: 5c 2e 5d 5c 22 2e 3c 2f 70 3e 22 0a 0a 53 65 63  \.]\".</p>"..Sec
1950: 74 69 6f 6e 20 7b 43 52 45 41 54 45 20 49 4e 44  tion {CREATE IND
1960: 45 58 7d 20 63 72 65 61 74 65 69 6e 64 65 78 0a  EX} createindex.
1970: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61  .Syntax {sql-sta
1980: 74 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41 54 45  tement} {.CREATE
1990: 20 5b 55 4e 49 51 55 45 5d 20 49 4e 44 45 58 20   [UNIQUE] INDEX 
19a0: 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 20 0a 4f 4e  <index-name> .ON
19b0: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 28 20   <table-name> ( 
19c0: 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 5b 2c  <column-name> [,
19d0: 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 5d 2a   <column-name>]*
19e0: 20 29 0a 5b 20 4f 4e 20 43 4f 4e 46 4c 49 43 54   ).[ ON CONFLICT
19f0: 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72   <conflict-algor
1a00: 69 74 68 6d 3e 20 5d 0a 7d 20 7b 63 6f 6c 75 6d  ithm> ].} {colum
1a10: 6e 2d 6e 61 6d 65 7d 20 7b 0a 3c 6e 61 6d 65 3e  n-name} {.<name>
1a20: 20 5b 20 41 53 43 20 7c 20 44 45 53 43 20 5d 0a   [ ASC | DESC ].
1a30: 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  }...puts {.<p>Th
1a40: 65 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 63  e CREATE INDEX c
1a50: 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74 73 20  ommand consists 
1a60: 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20  of the keywords 
1a70: 22 43 52 45 41 54 45 20 49 4e 44 45 58 22 20 66  "CREATE INDEX" f
1a80: 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65 20 6e  ollowed.by the n
1a90: 61 6d 65 20 6f 66 20 74 68 65 20 6e 65 77 20 69  ame of the new i
1aa0: 6e 64 65 78 2c 20 74 68 65 20 6b 65 79 77 6f 72  ndex, the keywor
1ab0: 64 20 22 4f 4e 22 2c 20 74 68 65 20 6e 61 6d 65  d "ON", the name
1ac0: 20 6f 66 20 61 20 70 72 65 76 69 6f 75 73 6c 79   of a previously
1ad0: 0a 63 72 65 61 74 65 64 20 74 61 62 6c 65 20 74  .created table t
1ae0: 68 61 74 20 69 73 20 74 6f 20 62 65 20 69 6e 64  hat is to be ind
1af0: 65 78 65 64 2c 20 61 6e 64 20 61 20 70 61 72 65  exed, and a pare
1b00: 6e 74 68 65 73 69 7a 65 64 20 6c 69 73 74 20 6f  nthesized list o
1b10: 66 20 6e 61 6d 65 73 20 6f 66 0a 63 6f 6c 75 6d  f names of.colum
1b20: 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20  ns in the table 
1b30: 74 68 61 74 20 61 72 65 20 75 73 65 64 20 66 6f  that are used fo
1b40: 72 20 74 68 65 20 69 6e 64 65 78 20 6b 65 79 2e  r the index key.
1b50: 0a 45 61 63 68 20 63 6f 6c 75 6d 6e 20 6e 61 6d  .Each column nam
1b60: 65 20 63 61 6e 20 62 65 20 66 6f 6c 6c 6f 77 65  e can be followe
1b70: 64 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 20  d by one of the 
1b80: 22 41 53 43 22 20 6f 72 20 22 44 45 53 43 22 20  "ASC" or "DESC" 
1b90: 6b 65 79 77 6f 72 64 73 0a 74 6f 20 69 6e 64 69  keywords.to indi
1ba0: 63 61 74 65 20 73 6f 72 74 20 6f 72 64 65 72 2c  cate sort order,
1bb0: 20 62 75 74 20 74 68 65 20 73 6f 72 74 20 6f 72   but the sort or
1bc0: 64 65 72 20 69 73 20 69 67 6e 6f 72 65 64 20 69  der is ignored i
1bd0: 6e 20 74 68 65 20 63 75 72 72 65 6e 74 0a 69 6d  n the current.im
1be0: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 3c 2f 70  plementation.</p
1bf0: 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72 65 20  >..<p>There are 
1c00: 6e 6f 20 61 72 62 69 74 72 61 72 79 20 6c 69 6d  no arbitrary lim
1c10: 69 74 73 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65  its on the numbe
1c20: 72 20 6f 66 20 69 6e 64 69 63 65 73 20 74 68 61  r of indices tha
1c30: 74 20 63 61 6e 20 62 65 0a 61 74 74 61 63 68 65  t can be.attache
1c40: 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 74 61  d to a single ta
1c50: 62 6c 65 2c 20 6e 6f 72 20 6f 6e 20 74 68 65 20  ble, nor on the 
1c60: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e  number of column
1c70: 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 2e 3c 2f  s in an index.</
1c80: 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20 55 4e  p>..<p>If the UN
1c90: 49 51 55 45 20 6b 65 79 77 6f 72 64 20 61 70 70  IQUE keyword app
1ca0: 65 61 72 73 20 62 65 74 77 65 65 6e 20 43 52 45  ears between CRE
1cb0: 41 54 45 20 61 6e 64 20 49 4e 44 45 58 20 74 68  ATE and INDEX th
1cc0: 65 6e 20 64 75 70 6c 69 63 61 74 65 0a 69 6e 64  en duplicate.ind
1cd0: 65 78 20 65 6e 74 72 69 65 73 20 61 72 65 20 6e  ex entries are n
1ce0: 6f 74 20 61 6c 6c 6f 77 65 64 2e 20 20 41 6e 79  ot allowed.  Any
1cf0: 20 61 74 74 65 6d 70 74 20 74 6f 20 69 6e 73 65   attempt to inse
1d00: 72 74 20 61 20 64 75 70 6c 69 63 61 74 65 20 65  rt a duplicate e
1d10: 6e 74 72 79 0a 77 69 6c 6c 20 72 65 73 75 6c 74  ntry.will result
1d20: 20 69 6e 20 61 6e 20 65 72 72 6f 72 2e 3c 2f 70   in an error.</p
1d30: 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74 69 6f 6e  >..<p>The option
1d40: 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  al conflict-clau
1d50: 73 65 20 61 6c 6c 6f 77 73 20 74 68 65 20 73 70  se allows the sp
1d60: 65 63 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 61  ecification of a
1d70: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 64 65  n alternative.de
1d80: 66 61 75 6c 74 20 63 6f 6e 73 74 72 61 69 6e 74  fault constraint
1d90: 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75   conflict resolu
1da0: 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 66  tion algorithm f
1db0: 6f 72 20 74 68 69 73 20 69 6e 64 65 78 2e 0a 54  or this index..T
1dc0: 68 69 73 20 6f 6e 6c 79 20 6d 61 6b 65 73 20 73  his only makes s
1dd0: 65 6e 73 65 20 69 66 20 74 68 65 20 55 4e 49 51  ense if the UNIQ
1de0: 55 45 20 6b 65 79 77 6f 72 64 20 69 73 20 75 73  UE keyword is us
1df0: 65 64 20 73 69 6e 63 65 20 6f 74 68 65 72 77 69  ed since otherwi
1e00: 73 65 0a 74 68 65 72 65 20 61 72 65 20 6e 6f 74  se.there are not
1e10: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 6f 6e 20   constraints on 
1e20: 74 68 65 20 69 6e 64 65 78 2e 20 20 54 68 65 20  the index.  The 
1e30: 64 65 66 61 75 6c 74 20 61 6c 67 6f 72 69 74 68  default algorith
1e40: 6d 20 69 73 0a 41 42 4f 52 54 2e 20 20 49 66 20  m is.ABORT.  If 
1e50: 61 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20  a COPY, INSERT, 
1e60: 6f 72 20 55 50 44 41 54 45 20 73 74 61 74 65 6d  or UPDATE statem
1e70: 65 6e 74 20 73 70 65 63 69 66 69 65 73 20 61 20  ent specifies a 
1e80: 70 61 72 74 69 63 75 6c 61 72 0a 63 6f 6e 66 6c  particular.confl
1e90: 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict resolution a
1ea0: 6c 67 6f 72 69 74 68 6d 2c 20 74 68 61 74 20 61  lgorithm, that a
1eb0: 6c 67 6f 72 69 74 68 6d 20 69 73 20 75 73 65 64  lgorithm is used
1ec0: 20 69 6e 20 70 6c 61 63 65 20 6f 66 0a 74 68 65   in place of.the
1ed0: 20 64 65 66 61 75 6c 74 20 61 6c 67 6f 72 69 74   default algorit
1ee0: 68 6d 20 73 70 65 63 69 66 69 65 64 20 68 65 72  hm specified her
1ef0: 65 2e 0a 53 65 65 20 74 68 65 20 73 65 63 74 69  e..See the secti
1f00: 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68 72 65  on titled.<a hre
1f10: 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f 4e  f="#conflict">ON
1f20: 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66 6f   CONFLICT</a> fo
1f30: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
1f40: 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c  ormation.</p>..<
1f50: 70 3e 54 68 65 20 65 78 61 63 74 20 74 65 78 74  p>The exact text
1f60: 0a 6f 66 20 65 61 63 68 20 43 52 45 41 54 45 20  .of each CREATE 
1f70: 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74 20  INDEX statement 
1f80: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65  is stored in the
1f90: 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65   <b>sqlite_maste
1fa0: 72 3c 2f 62 3e 0a 6f 72 20 3c 62 3e 73 71 6c 69  r</b>.or <b>sqli
1fb0: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 3c 2f  te_temp_master</
1fc0: 62 3e 20 74 61 62 6c 65 2c 20 64 65 70 65 6e 64  b> table, depend
1fd0: 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 72 20 74  ing on whether t
1fe0: 68 65 20 74 61 62 6c 65 0a 62 65 69 6e 67 20 69  he table.being i
1ff0: 6e 64 65 78 65 64 20 69 73 20 74 65 6d 70 6f 72  ndexed is tempor
2000: 61 72 79 2e 20 20 45 76 65 72 79 74 69 6d 65 20  ary.  Everytime 
2010: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
2020: 6f 70 65 6e 65 64 2c 0a 61 6c 6c 20 43 52 45 41  opened,.all CREA
2030: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65  TE INDEX stateme
2040: 6e 74 73 0a 61 72 65 20 72 65 61 64 20 66 72 6f  nts.are read fro
2050: 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f  m the <b>sqlite_
2060: 6d 61 73 74 65 72 3c 2f 62 3e 20 74 61 62 6c 65  master</b> table
2070: 20 61 6e 64 20 75 73 65 64 20 74 6f 20 72 65 67   and used to reg
2080: 65 6e 65 72 61 74 65 0a 53 51 4c 69 74 65 27 73  enerate.SQLite's
2090: 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73   internal repres
20a0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
20b0: 69 6e 64 65 78 20 6c 61 79 6f 75 74 2e 3c 2f 70  index layout.</p
20c0: 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 43  >.}...Section {C
20d0: 52 45 41 54 45 20 54 41 42 4c 45 7d 20 7b 63 72  REATE TABLE} {cr
20e0: 65 61 74 65 74 61 62 6c 65 7d 0a 0a 53 79 6e 74  eatetable}..Synt
20f0: 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d  ax {sql-command}
2100: 20 7b 0a 43 52 45 41 54 45 20 5b 54 45 4d 50 20   {.CREATE [TEMP 
2110: 7c 20 54 45 4d 50 4f 52 41 52 59 5d 20 54 41 42  | TEMPORARY] TAB
2120: 4c 45 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20  LE <table-name> 
2130: 28 0a 20 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e  (.  <column-def>
2140: 20 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e   [, <column-def>
2150: 5d 2a 0a 20 20 5b 2c 20 3c 63 6f 6e 73 74 72 61  ]*.  [, <constra
2160: 69 6e 74 3e 5d 2a 0a 29 0a 7d 20 7b 73 71 6c 2d  int>]*.).} {sql-
2170: 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 43 52 45 41 54  command} {.CREAT
2180: 45 20 5b 54 45 4d 50 20 7c 20 54 45 4d 50 4f 52  E [TEMP | TEMPOR
2190: 41 52 59 5d 20 54 41 42 4c 45 20 3c 74 61 62 6c  ARY] TABLE <tabl
21a0: 65 2d 6e 61 6d 65 3e 20 41 53 20 3c 73 65 6c 65  e-name> AS <sele
21b0: 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 0a 7d 20  ct-statement>.} 
21c0: 7b 63 6f 6c 75 6d 6e 2d 64 65 66 7d 20 7b 0a 3c  {column-def} {.<
21d0: 6e 61 6d 65 3e 20 5b 3c 74 79 70 65 3e 5d 20 5b  name> [<type>] [
21e0: 3c 63 6f 6c 75 6d 6e 2d 63 6f 6e 73 74 72 61 69  <column-constrai
21f0: 6e 74 3e 5d 2a 0a 7d 20 7b 74 79 70 65 7d 20 7b  nt>]*.} {type} {
2200: 0a 3c 74 79 70 65 6e 61 6d 65 3e 20 7c 0a 3c 74  .<typename> |.<t
2210: 79 70 65 6e 61 6d 65 3e 20 28 20 3c 6e 75 6d 62  ypename> ( <numb
2220: 65 72 3e 20 29 20 7c 0a 3c 74 79 70 65 6e 61 6d  er> ) |.<typenam
2230: 65 3e 20 28 20 3c 6e 75 6d 62 65 72 3e 20 2c 20  e> ( <number> , 
2240: 3c 6e 75 6d 62 65 72 3e 20 29 0a 7d 20 7b 63 6f  <number> ).} {co
2250: 6c 75 6d 6e 2d 63 6f 6e 73 74 72 61 69 6e 74 7d  lumn-constraint}
2260: 20 7b 0a 4e 4f 54 20 4e 55 4c 4c 20 5b 20 3c 63   {.NOT NULL [ <c
2270: 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20  onflict-clause> 
2280: 5d 20 7c 0a 50 52 49 4d 41 52 59 20 4b 45 59 20  ] |.PRIMARY KEY 
2290: 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d 20 5b  [<sort-order>] [
22a0: 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73   <conflict-claus
22b0: 65 3e 20 5d 20 7c 0a 55 4e 49 51 55 45 20 5b 20  e> ] |.UNIQUE [ 
22c0: 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65  <conflict-clause
22d0: 3e 20 5d 20 7c 0a 43 48 45 43 4b 20 28 20 3c 65  > ] |.CHECK ( <e
22e0: 78 70 72 3e 20 29 20 5b 20 3c 63 6f 6e 66 6c 69  xpr> ) [ <confli
22f0: 63 74 2d 63 6c 61 75 73 65 3e 20 5d 20 7c 0a 44  ct-clause> ] |.D
2300: 45 46 41 55 4c 54 20 3c 76 61 6c 75 65 3e 0a 7d  EFAULT <value>.}
2310: 20 7b 63 6f 6e 73 74 72 61 69 6e 74 7d 20 7b 0a   {constraint} {.
2320: 50 52 49 4d 41 52 59 20 4b 45 59 20 28 20 3c 6e  PRIMARY KEY ( <n
2330: 61 6d 65 3e 20 5b 2c 20 3c 6e 61 6d 65 3e 5d 2a  ame> [, <name>]*
2340: 20 29 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63   ) [ <conflict-c
2350: 6c 61 75 73 65 3e 20 5d 7c 0a 55 4e 49 51 55 45  lause> ]|.UNIQUE
2360: 20 28 20 3c 6e 61 6d 65 3e 20 5b 2c 20 3c 6e 61   ( <name> [, <na
2370: 6d 65 3e 5d 2a 20 29 20 5b 20 3c 63 6f 6e 66 6c  me>]* ) [ <confl
2380: 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d 20 7c 0a  ict-clause> ] |.
2390: 43 48 45 43 4b 20 28 20 3c 65 78 70 72 3e 20 29  CHECK ( <expr> )
23a0: 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61   [ <conflict-cla
23b0: 75 73 65 3e 20 5d 0a 7d 20 7b 63 6f 6e 66 6c 69  use> ].} {confli
23c0: 63 74 2d 63 6c 61 75 73 65 7d 20 7b 0a 4f 4e 20  ct-clause} {.ON 
23d0: 43 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c 69  CONFLICT <confli
23e0: 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 0a 7d 0a  ct-algorithm>.}.
23f0: 0a 70 75 74 73 20 7b 0a 3c 70 3e 41 20 43 52 45  .puts {.<p>A CRE
2400: 41 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d  ATE TABLE statem
2410: 65 6e 74 20 69 73 20 62 61 73 69 63 61 6c 6c 79  ent is basically
2420: 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22 43   the keywords "C
2430: 52 45 41 54 45 20 54 41 42 4c 45 22 0a 66 6f 6c  REATE TABLE".fol
2440: 6c 6f 77 65 64 20 62 79 20 74 68 65 20 6e 61 6d  lowed by the nam
2450: 65 20 6f 66 20 61 20 6e 65 77 20 74 61 62 6c 65  e of a new table
2460: 20 61 6e 64 20 61 20 70 61 72 65 6e 74 68 65 73   and a parenthes
2470: 69 7a 65 64 20 6c 69 73 74 20 6f 66 20 63 6f 6c  ized list of col
2480: 75 6d 6e 0a 64 65 66 69 6e 69 74 69 6f 6e 73 20  umn.definitions 
2490: 61 6e 64 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e  and constraints.
24a0: 20 20 54 68 65 20 74 61 62 6c 65 20 6e 61 6d 65    The table name
24b0: 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 20 61   can be either a
24c0: 6e 20 69 64 65 6e 74 69 66 69 65 72 0a 6f 72 20  n identifier.or 
24d0: 61 20 73 74 72 69 6e 67 2e 20 20 54 61 62 6c 65  a string.  Table
24e0: 73 20 6e 61 6d 65 73 20 74 68 61 74 20 62 65 67  s names that beg
24f0: 69 6e 20 77 69 74 68 20 22 3c 62 3e 73 71 6c 69  in with "<b>sqli
2500: 74 65 5f 3c 2f 62 3e 22 20 61 72 65 20 72 65 73  te_</b>" are res
2510: 65 72 76 65 64 0a 66 6f 72 20 75 73 65 20 62 79  erved.for use by
2520: 20 74 68 65 20 65 6e 67 69 6e 65 2e 3c 2f 70 3e   the engine.</p>
2530: 0a 0a 3c 70 3e 45 61 63 68 20 63 6f 6c 75 6d 6e  ..<p>Each column
2540: 20 64 65 66 69 6e 69 74 69 6f 6e 20 69 73 20 74   definition is t
2550: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 63  he name of the c
2560: 6f 6c 75 6d 6e 20 66 6f 6c 6c 6f 77 65 64 20 62  olumn followed b
2570: 79 20 74 68 65 0a 64 61 74 61 74 79 70 65 20 66  y the.datatype f
2580: 6f 72 20 74 68 61 74 20 63 6f 6c 75 6d 6e 2c 20  or that column, 
2590: 74 68 65 6e 20 6f 6e 65 20 6f 72 20 6d 6f 72 65  then one or more
25a0: 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6c 75 6d 6e   optional column
25b0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 2e 0a 53 51   constraints..SQ
25c0: 4c 69 74 65 20 69 73 20 3c 61 20 68 72 65 66 3d  Lite is <a href=
25d0: 22 64 61 74 61 74 79 70 65 73 2e 68 74 6d 6c 22  "datatypes.html"
25e0: 3e 74 79 70 65 6c 65 73 73 3c 2f 61 3e 2e 0a 54  >typeless</a>..T
25f0: 68 65 20 64 61 74 61 74 79 70 65 20 66 6f 72 20  he datatype for 
2600: 74 68 65 20 63 6f 6c 75 6d 6e 20 64 6f 65 73 20  the column does 
2610: 6e 6f 74 20 72 65 73 74 72 69 63 74 20 77 68 61  not restrict wha
2620: 74 20 64 61 74 61 20 6d 61 79 20 62 65 20 70 75  t data may be pu
2630: 74 0a 69 6e 20 74 68 61 74 20 63 6f 6c 75 6d 6e  t.in that column
2640: 2e 0a 41 6c 6c 20 69 6e 66 6f 72 6d 61 74 69 6f  ..All informatio
2650: 6e 20 69 73 20 73 74 6f 72 65 64 20 61 73 20 6e  n is stored as n
2660: 75 6c 6c 2d 74 65 72 6d 69 6e 61 74 65 64 20 73  ull-terminated s
2670: 74 72 69 6e 67 73 2e 0a 54 68 65 20 55 4e 49 51  trings..The UNIQ
2680: 55 45 20 63 6f 6e 73 74 72 61 69 6e 74 20 63 61  UE constraint ca
2690: 75 73 65 73 20 61 6e 20 69 6e 64 65 78 20 74 6f  uses an index to
26a0: 20 62 65 20 63 72 65 61 74 65 64 20 6f 6e 20 74   be created on t
26b0: 68 65 20 73 70 65 63 69 66 69 65 64 0a 63 6f 6c  he specified.col
26c0: 75 6d 6e 73 2e 20 20 54 68 69 73 20 69 6e 64 65  umns.  This inde
26d0: 78 20 6d 75 73 74 20 63 6f 6e 74 61 69 6e 20 75  x must contain u
26e0: 6e 69 71 75 65 20 6b 65 79 73 2e 0a 54 68 65 20  nique keys..The 
26f0: 44 45 46 41 55 4c 54 20 63 6f 6e 73 74 72 61 69  DEFAULT constrai
2700: 6e 74 0a 73 70 65 63 69 66 69 65 73 20 61 20 64  nt.specifies a d
2710: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 74 6f 20  efault value to 
2720: 75 73 65 20 77 68 65 6e 20 64 6f 69 6e 67 20 61  use when doing a
2730: 6e 20 49 4e 53 45 52 54 2e 0a 3c 2f 70 3e 0a 0a  n INSERT..</p>..
2740: 3c 70 3e 53 70 65 63 69 66 79 69 6e 67 20 61 20  <p>Specifying a 
2750: 50 52 49 4d 41 52 59 20 4b 45 59 20 6e 6f 72 6d  PRIMARY KEY norm
2760: 61 6c 6c 79 20 6a 75 73 74 20 63 72 65 61 74 65  ally just create
2770: 73 20 61 20 55 4e 49 51 55 45 20 69 6e 64 65 78  s a UNIQUE index
2780: 0a 6f 6e 20 74 68 65 20 70 72 69 6d 61 72 79 20  .on the primary 
2790: 6b 65 79 2e 20 20 48 6f 77 65 76 65 72 2c 20 69  key.  However, i
27a0: 66 20 70 72 69 6d 61 72 79 20 6b 65 79 20 69 73  f primary key is
27b0: 20 6f 6e 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c   on a single col
27c0: 75 6d 6e 0a 74 68 61 74 20 68 61 73 20 64 61 74  umn.that has dat
27d0: 61 74 79 70 65 20 49 4e 54 45 47 45 52 2c 20 74  atype INTEGER, t
27e0: 68 65 6e 20 74 68 61 74 20 63 6f 6c 75 6d 6e 20  hen that column 
27f0: 69 73 20 75 73 65 64 20 69 6e 74 65 72 6e 61 6c  is used internal
2800: 6c 79 0a 61 73 20 74 68 65 20 61 63 74 75 61 6c  ly.as the actual
2810: 20 6b 65 79 20 6f 66 20 74 68 65 20 42 2d 54 72   key of the B-Tr
2820: 65 65 20 66 6f 72 20 74 68 65 20 74 61 62 6c 65  ee for the table
2830: 2e 20 20 54 68 69 73 20 6d 65 61 6e 73 20 74 68  .  This means th
2840: 61 74 20 74 68 65 20 63 6f 6c 75 6d 6e 0a 6d 61  at the column.ma
2850: 79 20 6f 6e 6c 79 20 68 6f 6c 64 20 75 6e 69 71  y only hold uniq
2860: 75 65 20 69 6e 74 65 67 65 72 20 76 61 6c 75 65  ue integer value
2870: 73 2e 20 20 28 45 78 63 65 70 74 20 66 6f 72 20  s.  (Except for 
2880: 74 68 69 73 20 6f 6e 65 20 63 61 73 65 2c 0a 53  this one case,.S
2890: 51 4c 69 74 65 20 69 67 6e 6f 72 65 73 20 74 68  QLite ignores th
28a0: 65 20 64 61 74 61 74 79 70 65 20 73 70 65 63 69  e datatype speci
28b0: 66 69 63 61 74 69 6f 6e 20 6f 66 20 63 6f 6c 75  fication of colu
28c0: 6d 6e 73 20 61 6e 64 20 61 6c 6c 6f 77 73 0a 61  mns and allows.a
28d0: 6e 79 20 6b 69 6e 64 20 6f 66 20 64 61 74 61 20  ny kind of data 
28e0: 74 6f 20 62 65 20 70 75 74 20 69 6e 20 61 20 63  to be put in a c
28f0: 6f 6c 75 6d 6e 20 72 65 67 61 72 64 6c 65 73 73  olumn regardless
2900: 20 6f 66 20 69 74 73 20 64 65 63 6c 61 72 65 64   of its declared
2910: 0a 64 61 74 61 74 79 70 65 2e 29 20 20 49 66 20  .datatype.)  If 
2920: 61 20 74 61 62 6c 65 20 64 6f 65 73 20 6e 6f 74  a table does not
2930: 20 68 61 76 65 20 61 6e 20 49 4e 54 45 47 45 52   have an INTEGER
2940: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c   PRIMARY KEY col
2950: 75 6d 6e 2c 0a 74 68 65 6e 20 74 68 65 20 42 2d  umn,.then the B-
2960: 54 72 65 65 20 6b 65 79 20 77 69 6c 6c 20 62 65  Tree key will be
2970: 20 61 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79   a automatically
2980: 20 67 65 6e 65 72 61 74 65 64 20 69 6e 74 65 67   generated integ
2990: 65 72 2e 20 20 54 68 65 0a 42 2d 54 72 65 65 20  er.  The.B-Tree 
29a0: 6b 65 79 20 66 6f 72 20 61 20 72 6f 77 20 63 61  key for a row ca
29b0: 6e 20 61 6c 77 61 79 73 20 62 65 20 61 63 63 65  n always be acce
29c0: 73 73 65 64 20 75 73 69 6e 67 20 6f 6e 65 20 6f  ssed using one o
29d0: 66 20 74 68 65 0a 73 70 65 63 69 61 6c 20 6e 61  f the.special na
29e0: 6d 65 73 20 22 3c 62 3e 52 4f 57 49 44 3c 2f 62  mes "<b>ROWID</b
29f0: 3e 22 2c 20 22 3c 62 3e 4f 49 44 3c 2f 62 3e 22  >", "<b>OID</b>"
2a00: 2c 20 6f 72 20 22 3c 62 3e 5f 52 4f 57 49 44 5f  , or "<b>_ROWID_
2a10: 3c 2f 62 3e 22 2e 0a 54 68 69 73 20 69 73 20 74  </b>"..This is t
2a20: 72 75 65 20 72 65 67 61 72 64 6c 65 73 73 20 6f  rue regardless o
2a30: 66 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74  f whether or not
2a40: 20 74 68 65 72 65 20 69 73 20 61 6e 20 49 4e 54   there is an INT
2a50: 45 47 45 52 0a 50 52 49 4d 41 52 59 20 4b 45 59  EGER.PRIMARY KEY
2a60: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65  .</p>..<p>If the
2a70: 20 22 54 45 4d 50 22 20 6f 72 20 22 54 45 4d 50   "TEMP" or "TEMP
2a80: 4f 52 41 52 59 22 20 6b 65 79 77 6f 72 64 20 6f  ORARY" keyword o
2a90: 63 63 75 72 73 20 69 6e 20 62 65 74 77 65 65 6e  ccurs in between
2aa0: 20 22 43 52 45 41 54 45 22 0a 61 6e 64 20 22 54   "CREATE".and "T
2ab0: 41 42 4c 45 22 20 74 68 65 6e 20 74 68 65 20 74  ABLE" then the t
2ac0: 61 62 6c 65 20 74 68 61 74 20 69 73 20 63 72 65  able that is cre
2ad0: 61 74 65 64 20 69 73 20 6f 6e 6c 79 20 76 69 73  ated is only vis
2ae0: 69 62 6c 65 20 74 6f 20 74 68 65 0a 70 72 6f 63  ible to the.proc
2af0: 65 73 73 20 74 68 61 74 20 6f 70 65 6e 65 64 20  ess that opened 
2b00: 74 68 65 20 64 61 74 61 62 61 73 65 20 61 6e 64  the database and
2b10: 20 69 73 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c   is automaticall
2b20: 79 20 64 65 6c 65 74 65 64 20 77 68 65 6e 0a 74  y deleted when.t
2b30: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63  he database is c
2b40: 6c 6f 73 65 64 2e 20 20 41 6e 79 20 69 6e 64 69  losed.  Any indi
2b50: 63 65 73 20 63 72 65 61 74 65 64 20 6f 6e 20 61  ces created on a
2b60: 20 74 65 6d 70 6f 72 61 72 79 20 74 61 62 6c 65   temporary table
2b70: 0a 61 72 65 20 61 6c 73 6f 20 74 65 6d 70 6f 72  .are also tempor
2b80: 61 72 79 2e 20 20 54 65 6d 70 6f 72 61 72 79 20  ary.  Temporary 
2b90: 74 61 62 6c 65 73 20 61 6e 64 20 69 6e 64 69 63  tables and indic
2ba0: 65 73 20 61 72 65 20 73 74 6f 72 65 64 20 69 6e  es are stored in
2bb0: 20 61 0a 73 65 70 61 72 61 74 65 20 66 69 6c 65   a.separate file
2bc0: 20 64 69 73 74 69 6e 63 74 20 66 72 6f 6d 20 74   distinct from t
2bd0: 68 65 20 6d 61 69 6e 20 64 61 74 61 62 61 73 65  he main database
2be0: 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54   file.</p>..<p>T
2bf0: 68 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e 66  he optional conf
2c00: 6c 69 63 74 2d 63 6c 61 75 73 65 20 66 6f 6c 6c  lict-clause foll
2c10: 6f 77 69 6e 67 20 65 61 63 68 20 63 6f 6e 73 74  owing each const
2c20: 72 61 69 6e 74 0a 61 6c 6c 6f 77 73 20 74 68 65  raint.allows the
2c30: 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20 6f   specification o
2c40: 66 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65  f an alternative
2c50: 20 64 65 66 61 75 6c 74 0a 63 6f 6e 73 74 72 61   default.constra
2c60: 69 6e 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73  int conflict res
2c70: 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68  olution algorith
2c80: 6d 20 66 6f 72 20 74 68 61 74 20 63 6f 6e 73 74  m for that const
2c90: 72 61 69 6e 74 2e 0a 54 68 65 20 64 65 66 61 75  raint..The defau
2ca0: 6c 74 20 69 73 20 61 62 6f 72 74 20 41 42 4f 52  lt is abort ABOR
2cb0: 54 2e 20 20 44 69 66 66 65 72 65 6e 74 20 63 6f  T.  Different co
2cc0: 6e 73 74 72 61 69 6e 74 73 20 77 69 74 68 69 6e  nstraints within
2cd0: 20 74 68 65 20 73 61 6d 65 0a 74 61 62 6c 65 20   the same.table 
2ce0: 6d 61 79 20 68 61 76 65 20 64 69 66 66 65 72 65  may have differe
2cf0: 6e 74 20 64 65 66 61 75 6c 74 20 63 6f 6e 66 6c  nt default confl
2d00: 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict resolution a
2d10: 6c 67 6f 72 69 74 68 6d 73 2e 0a 49 66 20 61 6e  lgorithms..If an
2d20: 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20 6f   COPY, INSERT, o
2d30: 72 20 55 50 44 41 54 45 20 63 6f 6d 6d 61 6e 64  r UPDATE command
2d40: 20 73 70 65 63 69 66 69 65 73 20 61 20 64 69 66   specifies a dif
2d50: 66 65 72 65 6e 74 20 63 6f 6e 66 6c 69 63 74 0a  ferent conflict.
2d60: 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72  resolution algor
2d70: 69 74 68 6d 2c 20 74 68 65 6e 20 74 68 61 74 20  ithm, then that 
2d80: 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 75 73 65  algorithm is use
2d90: 64 20 69 6e 20 70 6c 61 63 65 20 6f 66 20 74 68  d in place of th
2da0: 65 0a 64 65 66 61 75 6c 74 20 61 6c 67 6f 72 69  e.default algori
2db0: 74 68 6d 20 73 70 65 63 69 66 69 65 64 20 69 6e  thm specified in
2dc0: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
2dd0: 45 20 73 74 61 74 65 6d 65 6e 74 2e 0a 53 65 65  E statement..See
2de0: 20 74 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74   the section tit
2df0: 6c 65 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f  led.<a href="#co
2e00: 6e 66 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c  nflict">ON CONFL
2e10: 49 43 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69  ICT</a> for addi
2e20: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
2e30: 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 43 48 45 43  on.</p>..<p>CHEC
2e40: 4b 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 61 72  K constraints ar
2e50: 65 20 69 67 6e 6f 72 65 64 20 69 6e 20 74 68 65  e ignored in the
2e60: 20 63 75 72 72 65 6e 74 20 69 6d 70 6c 65 6d 65   current impleme
2e70: 6e 74 61 74 69 6f 6e 2e 0a 53 75 70 70 6f 72 74  ntation..Support
2e80: 20 66 6f 72 20 43 48 45 43 4b 20 63 6f 6e 73 74   for CHECK const
2e90: 72 61 69 6e 74 73 20 6d 61 79 20 62 65 20 61 64  raints may be ad
2ea0: 64 65 64 20 69 6e 20 74 68 65 20 66 75 74 75 72  ded in the futur
2eb0: 65 2e 20 20 41 73 20 6f 66 0a 76 65 72 73 69 6f  e.  As of.versio
2ec0: 6e 20 32 2e 33 2e 30 2c 20 4e 4f 54 20 4e 55 4c  n 2.3.0, NOT NUL
2ed0: 4c 2c 20 50 52 49 4d 41 52 59 20 4b 45 59 2c 20  L, PRIMARY KEY, 
2ee0: 61 6e 64 20 55 4e 49 51 55 45 20 63 6f 6e 73 74  and UNIQUE const
2ef0: 72 61 69 6e 74 73 20 61 6c 6c 0a 77 6f 72 6b 2e  raints all.work.
2f00: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61  </p>..<p>There a
2f10: 72 65 20 6e 6f 20 61 72 62 69 74 72 61 72 79 20  re no arbitrary 
2f20: 6c 69 6d 69 74 73 20 6f 6e 20 74 68 65 20 6e 75  limits on the nu
2f30: 6d 62 65 72 0a 6f 66 20 63 6f 6c 75 6d 6e 73 20  mber.of columns 
2f40: 6f 72 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72  or on the number
2f50: 20 6f 66 20 63 6f 6e 73 74 72 61 69 6e 74 73 20   of constraints 
2f60: 69 6e 20 61 20 74 61 62 6c 65 2e 0a 54 68 65 20  in a table..The 
2f70: 74 6f 74 61 6c 20 61 6d 6f 75 6e 74 20 6f 66 20  total amount of 
2f80: 64 61 74 61 20 69 6e 20 61 20 73 69 6e 67 6c 65  data in a single
2f90: 20 72 6f 77 20 69 73 20 6c 69 6d 69 74 65 64 20   row is limited 
2fa0: 74 6f 20 61 62 6f 75 74 0a 31 20 6d 65 67 61 62  to about.1 megab
2fb0: 79 74 65 73 2e 20 20 28 54 68 69 73 20 6c 69 6d  ytes.  (This lim
2fc0: 69 74 20 63 61 6e 20 62 65 20 69 6e 63 72 65 61  it can be increa
2fd0: 73 65 64 20 74 6f 20 31 36 4d 42 20 62 79 20 63  sed to 16MB by c
2fe0: 68 61 6e 67 69 6e 67 0a 61 20 73 69 6e 67 6c 65  hanging.a single
2ff0: 20 23 64 65 66 69 6e 65 20 69 6e 20 74 68 65 20   #define in the 
3000: 73 6f 75 72 63 65 20 63 6f 64 65 20 61 6e 64 20  source code and 
3010: 72 65 63 6f 6d 70 69 6c 69 6e 67 2e 29 3c 2f 70  recompiling.)</p
3020: 3e 0a 0a 3c 70 3e 54 68 65 20 43 52 45 41 54 45  >..<p>The CREATE
3030: 20 54 41 42 4c 45 20 41 53 20 66 6f 72 6d 20 64   TABLE AS form d
3040: 65 66 69 6e 65 73 20 74 68 65 20 74 61 62 6c 65  efines the table
3050: 20 74 6f 20 62 65 0a 74 68 65 20 72 65 73 75 6c   to be.the resul
3060: 74 20 73 65 74 20 6f 66 20 61 20 71 75 65 72 79  t set of a query
3070: 2e 20 20 54 68 65 20 6e 61 6d 65 73 20 6f 66 20  .  The names of 
3080: 74 68 65 20 74 61 62 6c 65 20 63 6f 6c 75 6d 6e  the table column
3090: 73 20 61 72 65 0a 74 68 65 20 6e 61 6d 65 73 20  s are.the names 
30a0: 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e 73 20 69  of the columns i
30b0: 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 3c 2f 70  n the result.</p
30c0: 3e 0a 0a 3c 70 3e 54 68 65 20 65 78 61 63 74 20  >..<p>The exact 
30d0: 74 65 78 74 0a 6f 66 20 65 61 63 68 20 43 52 45  text.of each CRE
30e0: 41 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d  ATE TABLE statem
30f0: 65 6e 74 20 69 73 20 73 74 6f 72 65 64 20 69 6e  ent is stored in
3100: 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d   the <b>sqlite_m
3110: 61 73 74 65 72 3c 2f 62 3e 0a 74 61 62 6c 65 2e  aster</b>.table.
3120: 20 20 45 76 65 72 79 74 69 6d 65 20 74 68 65 20    Everytime the 
3130: 64 61 74 61 62 61 73 65 20 69 73 20 6f 70 65 6e  database is open
3140: 65 64 2c 20 61 6c 6c 20 43 52 45 41 54 45 20 54  ed, all CREATE T
3150: 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 73 0a  ABLE statements.
3160: 61 72 65 20 72 65 61 64 20 66 72 6f 6d 20 74 68  are read from th
3170: 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74  e <b>sqlite_mast
3180: 65 72 3c 2f 62 3e 20 74 61 62 6c 65 20 61 6e 64  er</b> table and
3190: 20 75 73 65 64 20 74 6f 20 72 65 67 65 6e 65 72   used to regener
31a0: 61 74 65 0a 53 51 4c 69 74 65 27 73 20 69 6e 74  ate.SQLite's int
31b0: 65 72 6e 61 6c 20 72 65 70 72 65 73 65 6e 74 61  ernal representa
31c0: 74 69 6f 6e 20 6f 66 20 74 68 65 20 74 61 62 6c  tion of the tabl
31d0: 65 20 6c 61 79 6f 75 74 2e 0a 49 66 20 74 68 65  e layout..If the
31e0: 20 6f 72 69 67 69 6e 61 6c 20 63 6f 6d 6d 61 6e   original comman
31f0: 64 20 77 61 73 20 61 20 43 52 45 41 54 45 20 54  d was a CREATE T
3200: 41 42 4c 45 20 41 53 20 74 68 65 6e 20 74 68 65  ABLE AS then the
3210: 6e 20 61 6e 20 65 71 75 69 76 61 6c 65 6e 74 0a  n an equivalent.
3220: 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74 61  CREATE TABLE sta
3230: 74 65 6d 65 6e 74 20 69 73 20 73 79 6e 74 68 65  tement is synthe
3240: 73 69 7a 65 64 20 61 6e 64 20 73 74 6f 72 65 20  sized and store 
3250: 69 6e 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73  in <b>sqlite_mas
3260: 74 65 72 3c 2f 62 3e 0a 69 6e 20 70 6c 61 63 65  ter</b>.in place
3270: 20 6f 66 20 74 68 65 20 6f 72 69 67 69 6e 61 6c   of the original
3280: 20 63 6f 6d 6d 61 6e 64 2e 0a 54 68 65 20 74 65   command..The te
3290: 78 74 20 6f 66 20 43 52 45 41 54 45 20 54 45 4d  xt of CREATE TEM
32a0: 50 4f 52 41 52 59 20 54 41 42 4c 45 20 73 74 61  PORARY TABLE sta
32b0: 74 65 6d 65 6e 74 73 20 61 72 65 20 73 74 6f 72  tements are stor
32c0: 65 64 20 69 6e 20 74 68 65 0a 3c 62 3e 73 71 6c  ed in the.<b>sql
32d0: 69 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 3c  ite_temp_master<
32e0: 2f 62 3e 20 74 61 62 6c 65 2e 0a 3c 2f 70 3e 0a  /b> table..</p>.
32f0: 7d 0a 53 65 63 74 69 6f 6e 20 7b 43 52 45 41 54  }.Section {CREAT
3300: 45 20 54 52 49 47 47 45 52 7d 20 63 72 65 61 74  E TRIGGER} creat
3310: 65 74 72 69 67 67 65 72 0a 0a 53 79 6e 74 61 78  etrigger..Syntax
3320: 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d   {sql-statement}
3330: 20 7b 0a 43 52 45 41 54 45 20 54 52 49 47 47 45   {.CREATE TRIGGE
3340: 52 20 3c 74 72 69 67 67 65 72 2d 6e 61 6d 65 3e  R <trigger-name>
3350: 20 5b 20 42 45 46 4f 52 45 20 7c 20 41 46 54 45   [ BEFORE | AFTE
3360: 52 20 5d 0a 3c 64 61 74 61 62 61 73 65 2d 65 76  R ].<database-ev
3370: 65 6e 74 3e 20 4f 4e 20 3c 74 61 62 6c 65 2d 6e  ent> ON <table-n
3380: 61 6d 65 3e 0a 3c 74 72 69 67 67 65 72 2d 61 63  ame>.<trigger-ac
3390: 74 69 6f 6e 3e 0a 7d 0a 0a 53 79 6e 74 61 78 20  tion>.}..Syntax 
33a0: 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20  {sql-statement} 
33b0: 7b 0a 43 52 45 41 54 45 20 54 52 49 47 47 45 52  {.CREATE TRIGGER
33c0: 20 3c 74 72 69 67 67 65 72 2d 6e 61 6d 65 3e 20   <trigger-name> 
33d0: 49 4e 53 54 45 41 44 20 4f 46 0a 3c 64 61 74 61  INSTEAD OF.<data
33e0: 62 61 73 65 2d 65 76 65 6e 74 3e 20 4f 4e 20 3c  base-event> ON <
33f0: 76 69 65 77 2d 6e 61 6d 65 3e 0a 3c 74 72 69 67  view-name>.<trig
3400: 67 65 72 2d 61 63 74 69 6f 6e 3e 0a 7d 0a 0a 53  ger-action>.}..S
3410: 79 6e 74 61 78 20 7b 64 61 74 61 62 61 73 65 2d  yntax {database-
3420: 65 76 65 6e 74 7d 20 7b 0a 44 45 4c 45 54 45 20  event} {.DELETE 
3430: 7c 20 0a 49 4e 53 45 52 54 20 7c 20 0a 55 50 44  | .INSERT | .UPD
3440: 41 54 45 20 7c 20 0a 55 50 44 41 54 45 20 4f 46  ATE | .UPDATE OF
3450: 20 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 0a 7d   <column-list>.}
3460: 0a 0a 53 79 6e 74 61 78 20 7b 74 72 69 67 67 65  ..Syntax {trigge
3470: 72 2d 61 63 74 69 6f 6e 7d 20 7b 0a 5b 20 46 4f  r-action} {.[ FO
3480: 52 20 45 41 43 48 20 52 4f 57 20 5d 20 5b 20 57  R EACH ROW ] [ W
3490: 48 45 4e 20 3c 65 78 70 72 65 73 73 69 6f 6e 3e  HEN <expression>
34a0: 20 5d 20 0a 42 45 47 49 4e 20 0a 20 20 3c 74 72   ] .BEGIN .  <tr
34b0: 69 67 67 65 72 2d 73 74 65 70 3e 20 3b 20 5b 20  igger-step> ; [ 
34c0: 3c 74 72 69 67 67 65 72 2d 73 74 65 70 3e 20 3b  <trigger-step> ;
34d0: 20 5d 2a 0a 45 4e 44 0a 7d 0a 0a 53 79 6e 74 61   ]*.END.}..Synta
34e0: 78 20 7b 74 72 69 67 67 65 72 2d 73 74 65 70 7d  x {trigger-step}
34f0: 20 7b 0a 3c 75 70 64 61 74 65 2d 73 74 61 74 65   {.<update-state
3500: 6d 65 6e 74 3e 20 7c 20 3c 69 6e 73 65 72 74 2d  ment> | <insert-
3510: 73 74 61 74 65 6d 65 6e 74 3e 20 7c 20 0a 3c 64  statement> | .<d
3520: 65 6c 65 74 65 2d 73 74 61 74 65 6d 65 6e 74 3e  elete-statement>
3530: 20 7c 20 3c 73 65 6c 65 63 74 2d 73 74 61 74 65   | <select-state
3540: 6d 65 6e 74 3e 20 0a 7d 0a 0a 70 75 74 73 20 7b  ment> .}..puts {
3550: 0a 3c 70 3e 54 68 65 20 43 52 45 41 54 45 20 54  .<p>The CREATE T
3560: 52 49 47 47 45 52 20 73 74 61 74 65 6d 65 6e 74  RIGGER statement
3570: 20 69 73 20 75 73 65 64 20 74 6f 20 61 64 64 20   is used to add 
3580: 74 72 69 67 67 65 72 73 20 74 6f 20 74 68 65 20  triggers to the 
3590: 0a 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61  .database schema
35a0: 2e 20 54 72 69 67 67 65 72 73 20 61 72 65 20 64  . Triggers are d
35b0: 61 74 61 62 61 73 65 20 6f 70 65 72 61 74 69 6f  atabase operatio
35c0: 6e 73 20 28 74 68 65 20 3c 69 3e 74 72 69 67 67  ns (the <i>trigg
35d0: 65 72 2d 61 63 74 69 6f 6e 3c 2f 69 3e 29 20 0a  er-action</i>) .
35e0: 74 68 61 74 20 61 72 65 20 61 75 74 6f 6d 61 74  that are automat
35f0: 69 63 61 6c 6c 79 20 70 65 72 66 6f 72 6d 65 64  ically performed
3600: 20 77 68 65 6e 20 61 20 73 70 65 63 69 66 69 65   when a specifie
3610: 64 20 64 61 74 61 62 61 73 65 20 65 76 65 6e 74  d database event
3620: 20 28 74 68 65 0a 3c 69 3e 64 61 74 61 62 61 73   (the.<i>databas
3630: 65 2d 65 76 65 6e 74 3c 2f 69 3e 29 20 6f 63 63  e-event</i>) occ
3640: 75 72 73 2e 20 20 3c 2f 70 3e 0a 0a 3c 70 3e 41  urs.  </p>..<p>A
3650: 20 74 72 69 67 67 65 72 20 6d 61 79 20 62 65 20   trigger may be 
3660: 73 70 65 63 69 66 69 65 64 20 74 6f 20 66 69 72  specified to fir
3670: 65 20 77 68 65 6e 65 76 65 72 20 61 20 44 45 4c  e whenever a DEL
3680: 45 54 45 2c 20 49 4e 53 45 52 54 20 6f 72 20 55  ETE, INSERT or U
3690: 50 44 41 54 45 20 6f 66 20 61 0a 70 61 72 74 69  PDATE of a.parti
36a0: 63 75 6c 61 72 20 64 61 74 61 62 61 73 65 20 74  cular database t
36b0: 61 62 6c 65 20 6f 63 63 75 72 73 2c 20 6f 72 20  able occurs, or 
36c0: 77 68 65 6e 65 76 65 72 20 61 6e 20 55 50 44 41  whenever an UPDA
36d0: 54 45 20 6f 66 20 6f 6e 65 20 6f 72 20 6d 6f 72  TE of one or mor
36e0: 65 0a 73 70 65 63 69 66 69 65 64 20 63 6f 6c 75  e.specified colu
36f0: 6d 6e 73 20 6f 66 20 61 20 74 61 62 6c 65 20 61  mns of a table a
3700: 72 65 20 75 70 64 61 74 65 64 2e 3c 2f 70 3e 0a  re updated.</p>.
3710: 0a 3c 70 3e 41 74 20 74 68 69 73 20 74 69 6d 65  .<p>At this time
3720: 20 53 51 4c 69 74 65 20 73 75 70 70 6f 72 74 73   SQLite supports
3730: 20 6f 6e 6c 79 20 46 4f 52 20 45 41 43 48 20 52   only FOR EACH R
3740: 4f 57 20 74 72 69 67 67 65 72 73 2c 20 6e 6f 74  OW triggers, not
3750: 20 46 4f 52 20 45 41 43 48 0a 53 54 41 54 45 4d   FOR EACH.STATEM
3760: 45 4e 54 20 74 72 69 67 67 65 72 73 2e 20 48 65  ENT triggers. He
3770: 6e 63 65 20 65 78 70 6c 69 63 69 74 6c 79 20 73  nce explicitly s
3780: 70 65 63 69 66 79 69 6e 67 20 46 4f 52 20 45 41  pecifying FOR EA
3790: 43 48 20 52 4f 57 20 69 73 20 6f 70 74 69 6f 6e  CH ROW is option
37a0: 61 6c 2e 20 20 46 4f 52 0a 45 41 43 48 20 52 4f  al.  FOR.EACH RO
37b0: 57 20 69 6d 70 6c 69 65 73 20 74 68 61 74 20 74  W implies that t
37c0: 68 65 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74  he SQL statement
37d0: 73 20 73 70 65 63 69 66 69 65 64 20 61 73 20 3c  s specified as <
37e0: 69 3e 74 72 69 67 67 65 72 2d 73 74 65 70 73 3c  i>trigger-steps<
37f0: 2f 69 3e 20 0a 6d 61 79 20 62 65 20 65 78 65 63  /i> .may be exec
3800: 75 74 65 64 20 28 64 65 70 65 6e 64 69 6e 67 20  uted (depending 
3810: 6f 6e 20 74 68 65 20 57 48 45 4e 20 63 6c 61 75  on the WHEN clau
3820: 73 65 29 20 66 6f 72 20 65 61 63 68 20 64 61 74  se) for each dat
3830: 61 62 61 73 65 20 72 6f 77 20 62 65 69 6e 67 0a  abase row being.
3840: 69 6e 73 65 72 74 65 64 2c 20 75 70 64 61 74 65  inserted, update
3850: 64 20 6f 72 20 64 65 6c 65 74 65 64 20 62 79 20  d or deleted by 
3860: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20 63 61  the statement ca
3870: 75 73 69 6e 67 20 74 68 65 20 74 72 69 67 67 65  using the trigge
3880: 72 20 74 6f 20 66 69 72 65 2e 3c 2f 70 3e 0a 0a  r to fire.</p>..
3890: 3c 70 3e 42 6f 74 68 20 74 68 65 20 57 48 45 4e  <p>Both the WHEN
38a0: 20 63 6c 61 75 73 65 20 61 6e 64 20 74 68 65 20   clause and the 
38b0: 3c 69 3e 74 72 69 67 67 65 72 2d 73 74 65 70 73  <i>trigger-steps
38c0: 3c 2f 69 3e 20 6d 61 79 20 61 63 63 65 73 73 20  </i> may access 
38d0: 65 6c 65 6d 65 6e 74 73 20 6f 66 20 0a 74 68 65  elements of .the
38e0: 20 72 6f 77 20 62 65 69 6e 67 20 69 6e 73 65 72   row being inser
38f0: 74 65 64 2c 20 64 65 6c 65 74 65 64 20 6f 72 20  ted, deleted or 
3900: 75 70 64 61 74 65 64 20 75 73 69 6e 67 20 72 65  updated using re
3910: 66 65 72 65 6e 63 65 73 20 6f 66 20 74 68 65 20  ferences of the 
3920: 66 6f 72 6d 20 0a 22 4e 45 57 2e 3c 69 3e 63 6f  form ."NEW.<i>co
3930: 6c 75 6d 6e 2d 6e 61 6d 65 3c 2f 69 3e 22 20 61  lumn-name</i>" a
3940: 6e 64 20 22 4f 4c 44 2e 3c 69 3e 63 6f 6c 75 6d  nd "OLD.<i>colum
3950: 6e 2d 6e 61 6d 65 3c 2f 69 3e 22 2c 20 77 68 65  n-name</i>", whe
3960: 72 65 0a 3c 69 3e 63 6f 6c 75 6d 6e 2d 6e 61 6d  re.<i>column-nam
3970: 65 3c 2f 69 3e 20 69 73 20 74 68 65 20 6e 61 6d  e</i> is the nam
3980: 65 20 6f 66 20 61 20 63 6f 6c 75 6d 6e 20 66 72  e of a column fr
3990: 6f 6d 20 74 68 65 20 74 61 62 6c 65 20 74 68 61  om the table tha
39a0: 74 20 74 68 65 20 74 72 69 67 67 65 72 0a 69 73  t the trigger.is
39b0: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
39c0: 2e 20 4f 4c 44 20 61 6e 64 20 4e 45 57 20 72 65  . OLD and NEW re
39d0: 66 65 72 65 6e 63 65 73 20 6d 61 79 20 6f 6e 6c  ferences may onl
39e0: 79 20 62 65 20 75 73 65 64 20 69 6e 20 74 72 69  y be used in tri
39f0: 67 67 65 72 73 20 6f 6e 0a 3c 69 3e 74 72 69 67  ggers on.<i>trig
3a00: 67 65 72 2d 65 76 65 6e 74 3c 2f 69 3e 73 20 66  ger-event</i>s f
3a10: 6f 72 20 77 68 69 63 68 20 74 68 65 79 20 61 72  or which they ar
3a20: 65 20 72 65 6c 65 76 61 6e 74 2c 20 61 73 20 66  e relevant, as f
3a30: 6f 6c 6c 6f 77 73 3a 3c 2f 70 3e 0a 0a 3c 74 61  ollows:</p>..<ta
3a40: 62 6c 65 20 62 6f 72 64 65 72 3d 30 20 63 65 6c  ble border=0 cel
3a50: 6c 70 61 64 64 69 6e 67 3d 31 30 3e 0a 3c 74 72  lpadding=10>.<tr
3a60: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
3a70: 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22  p" align="right"
3a80: 20 77 69 64 74 68 3d 31 32 30 3e 3c 69 3e 49 4e   width=120><i>IN
3a90: 53 45 52 54 3c 2f 69 3e 3c 2f 74 64 3e 0a 3c 74  SERT</i></td>.<t
3aa0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 4e  d valign="top">N
3ab0: 45 57 20 72 65 66 65 72 65 6e 63 65 73 20 61 72  EW references ar
3ac0: 65 20 76 61 6c 69 64 3c 2f 74 64 3e 0a 3c 2f 74  e valid</td>.</t
3ad0: 72 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  r>.<tr>.<td vali
3ae0: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
3af0: 72 69 67 68 74 22 20 77 69 64 74 68 3d 31 32 30  right" width=120
3b00: 3e 3c 69 3e 55 50 44 41 54 45 3c 2f 69 3e 3c 2f  ><i>UPDATE</i></
3b10: 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22  td>.<td valign="
3b20: 74 6f 70 22 3e 4e 45 57 20 61 6e 64 20 4f 4c 44  top">NEW and OLD
3b30: 20 72 65 66 65 72 65 6e 63 65 73 20 61 72 65 20   references are 
3b40: 76 61 6c 69 64 3c 2f 74 64 3e 0a 3c 2f 74 72 3e  valid</td>.</tr>
3b50: 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e  .<tr>.<td valign
3b60: 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69  ="top" align="ri
3b70: 67 68 74 22 20 77 69 64 74 68 3d 31 32 30 3e 3c  ght" width=120><
3b80: 69 3e 44 45 4c 45 54 45 3c 2f 69 3e 3c 2f 74 64  i>DELETE</i></td
3b90: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
3ba0: 70 22 3e 4f 4c 44 20 72 65 66 65 72 65 6e 63 65  p">OLD reference
3bb0: 73 20 61 72 65 20 76 61 6c 69 64 3c 2f 74 64 3e  s are valid</td>
3bc0: 0a 3c 2f 74 72 3e 0a 3c 2f 74 61 62 6c 65 3e 0a  .</tr>.</table>.
3bd0: 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 61 20 57 48  </p>..<p>If a WH
3be0: 45 4e 20 63 6c 61 75 73 65 20 69 73 20 73 75 70  EN clause is sup
3bf0: 70 6c 69 65 64 2c 20 74 68 65 20 53 51 4c 20 73  plied, the SQL s
3c00: 74 61 74 65 6d 65 6e 74 73 20 73 70 65 63 69 66  tatements specif
3c10: 69 65 64 20 61 73 20 3c 69 3e 74 72 69 67 67 65  ied as <i>trigge
3c20: 72 2d 73 74 65 70 73 3c 2f 69 3e 20 61 72 65 20  r-steps</i> are 
3c30: 6f 6e 6c 79 20 65 78 65 63 75 74 65 64 20 66 6f  only executed fo
3c40: 72 20 72 6f 77 73 20 66 6f 72 20 77 68 69 63 68  r rows for which
3c50: 20 74 68 65 20 57 48 45 4e 20 63 6c 61 75 73 65   the WHEN clause
3c60: 20 69 73 20 74 72 75 65 2e 20 49 66 20 6e 6f 20   is true. If no 
3c70: 57 48 45 4e 20 63 6c 61 75 73 65 20 69 73 20 73  WHEN clause is s
3c80: 75 70 70 6c 69 65 64 2c 20 74 68 65 20 53 51 4c  upplied, the SQL
3c90: 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65 20   statements are 
3ca0: 65 78 65 63 75 74 65 64 20 66 6f 72 20 61 6c 6c  executed for all
3cb0: 20 72 6f 77 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54   rows.</p>..<p>T
3cc0: 68 65 20 73 70 65 63 69 66 69 65 64 20 3c 69 3e  he specified <i>
3cd0: 74 72 69 67 67 65 72 2d 74 69 6d 65 3c 2f 69 3e  trigger-time</i>
3ce0: 20 64 65 74 65 72 6d 69 6e 65 73 20 77 68 65 6e   determines when
3cf0: 20 74 68 65 20 3c 69 3e 74 72 69 67 67 65 72 2d   the <i>trigger-
3d00: 73 74 65 70 73 3c 2f 69 3e 0a 77 69 6c 6c 20 62  steps</i>.will b
3d10: 65 20 65 78 65 63 75 74 65 64 20 72 65 6c 61 74  e executed relat
3d20: 69 76 65 20 74 6f 20 74 68 65 20 69 6e 73 65 72  ive to the inser
3d30: 74 69 6f 6e 2c 20 6d 6f 64 69 66 69 63 61 74 69  tion, modificati
3d40: 6f 6e 20 6f 72 20 72 65 6d 6f 76 61 6c 20 6f 66  on or removal of
3d50: 20 74 68 65 0a 61 73 73 6f 63 69 61 74 65 64 20   the.associated 
3d60: 72 6f 77 2e 3c 2f 70 3e 0a 0a 3c 70 3e 41 6e 20  row.</p>..<p>An 
3d70: 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75  ON CONFLICT clau
3d80: 73 65 20 6d 61 79 20 62 65 20 73 70 65 63 69 66  se may be specif
3d90: 69 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 61  ied as part of a
3da0: 6e 20 55 50 44 41 54 45 20 6f 72 20 49 4e 53 45  n UPDATE or INSE
3db0: 52 54 0a 3c 69 3e 74 72 69 67 67 65 72 2d 73 74  RT.<i>trigger-st
3dc0: 65 70 3c 2f 69 3e 2e 20 48 6f 77 65 76 65 72 20  ep</i>. However 
3dd0: 69 66 20 61 6e 20 4f 4e 20 43 4f 4e 46 4c 49 43  if an ON CONFLIC
3de0: 54 20 63 6c 61 75 73 65 20 69 73 20 73 70 65 63  T clause is spec
3df0: 69 66 69 65 64 20 61 73 20 70 61 72 74 20 6f 66  ified as part of
3e00: 20 0a 74 68 65 20 73 74 61 74 65 6d 65 6e 74 20   .the statement 
3e10: 63 61 75 73 69 6e 67 20 74 68 65 20 74 72 69 67  causing the trig
3e20: 67 65 72 20 74 6f 20 66 69 72 65 2c 20 74 68 65  ger to fire, the
3e30: 6e 20 74 68 69 73 20 63 6f 6e 66 6c 69 63 74 20  n this conflict 
3e40: 68 61 6e 64 6c 69 6e 67 0a 70 6f 6c 69 63 79 20  handling.policy 
3e50: 69 73 20 75 73 65 64 20 69 6e 73 74 65 61 64 2e  is used instead.
3e60: 3c 2f 70 3e 0a 0a 3c 70 3e 54 72 69 67 67 65 72  </p>..<p>Trigger
3e70: 73 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 61  s are automatica
3e80: 6c 6c 79 20 64 72 6f 70 70 65 64 20 77 68 65 6e  lly dropped when
3e90: 20 74 68 65 20 74 61 62 6c 65 20 74 68 61 74 20   the table that 
3ea0: 74 68 65 79 20 61 72 65 20 0a 61 73 73 6f 63 69  they are .associ
3eb0: 61 74 65 64 20 77 69 74 68 20 69 73 20 64 72 6f  ated with is dro
3ec0: 70 70 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 72  pped.</p>..<p>Tr
3ed0: 69 67 67 65 72 73 20 6d 61 79 20 62 65 20 63 72  iggers may be cr
3ee0: 65 61 74 65 64 20 6f 6e 20 76 69 65 77 73 2c 20  eated on views, 
3ef0: 61 73 20 77 65 6c 6c 20 61 73 20 6f 72 64 69 6e  as well as ordin
3f00: 61 72 79 20 74 61 62 6c 65 73 2c 20 62 79 20 73  ary tables, by s
3f10: 70 65 63 69 66 79 69 6e 67 0a 49 4e 53 54 45 41  pecifying.INSTEA
3f20: 44 20 4f 46 20 69 6e 20 74 68 65 20 43 52 45 41  D OF in the CREA
3f30: 54 45 20 54 52 49 47 47 45 52 20 73 74 61 74 65  TE TRIGGER state
3f40: 6d 65 6e 74 2e 20 49 66 20 6f 6e 65 20 6f 72 20  ment. If one or 
3f50: 6d 6f 72 65 20 4f 4e 20 49 4e 53 45 52 54 2c 20  more ON INSERT, 
3f60: 4f 4e 20 44 45 4c 45 54 45 0a 6f 72 20 4f 4e 20  ON DELETE.or ON 
3f70: 55 50 44 41 54 45 20 74 72 69 67 67 65 72 73 20  UPDATE triggers 
3f80: 61 72 65 20 64 65 66 69 6e 65 64 20 6f 6e 20 61  are defined on a
3f90: 20 76 69 65 77 2c 20 74 68 65 6e 20 69 74 20 69   view, then it i
3fa0: 73 20 6e 6f 74 20 61 6e 20 65 72 72 6f 72 20 74  s not an error t
3fb0: 6f 20 65 78 65 63 75 74 65 0a 61 6e 20 49 4e 53  o execute.an INS
3fc0: 45 52 54 2c 20 44 45 4c 45 54 45 20 6f 72 20 55  ERT, DELETE or U
3fd0: 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20  PDATE statement 
3fe0: 6f 6e 20 74 68 65 20 76 69 65 77 2c 20 72 65 73  on the view, res
3ff0: 70 65 63 74 69 76 65 6c 79 2e 20 54 68 65 72 65  pectively. There
4000: 61 66 74 65 72 2c 0a 65 78 65 63 75 74 69 6e 67  after,.executing
4010: 20 61 6e 20 49 4e 53 45 52 54 2c 20 44 45 4c 45   an INSERT, DELE
4020: 54 45 20 6f 72 20 55 50 44 41 54 45 20 6f 6e 20  TE or UPDATE on 
4030: 74 68 65 20 76 69 65 77 20 63 61 75 73 65 73 20  the view causes 
4040: 74 68 65 20 61 73 73 6f 63 69 61 74 65 64 0a 20  the associated. 
4050: 20 74 72 69 67 67 65 72 73 20 74 6f 20 66 69 72   triggers to fir
4060: 65 2e 20 54 68 65 20 72 65 61 6c 20 74 61 62 6c  e. The real tabl
4070: 65 73 20 75 6e 64 65 72 6c 79 69 6e 67 20 74 68  es underlying th
4080: 65 20 76 69 65 77 20 61 72 65 20 6e 6f 74 20 6d  e view are not m
4090: 6f 64 69 66 69 65 64 0a 20 20 28 65 78 63 65 70  odified.  (excep
40a0: 74 20 70 6f 73 73 69 62 6c 79 20 65 78 70 6c 69  t possibly expli
40b0: 63 69 74 6c 79 2c 20 62 79 20 61 20 74 72 69 67  citly, by a trig
40c0: 67 65 72 20 70 72 6f 67 72 61 6d 29 2e 3c 2f 70  ger program).</p
40d0: 3e 0a 0a 3c 70 3e 3c 62 3e 45 78 61 6d 70 6c 65  >..<p><b>Example
40e0: 3a 3c 2f 62 3e 3c 2f 70 3e 0a 0a 3c 70 3e 41 73  :</b></p>..<p>As
40f0: 73 75 6d 69 6e 67 20 74 68 61 74 20 63 75 73 74  suming that cust
4100: 6f 6d 65 72 20 72 65 63 6f 72 64 73 20 61 72 65  omer records are
4110: 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65 20 22   stored in the "
4120: 63 75 73 74 6f 6d 65 72 73 22 20 74 61 62 6c 65  customers" table
4130: 2c 20 61 6e 64 0a 74 68 61 74 20 6f 72 64 65 72  , and.that order
4140: 20 72 65 63 6f 72 64 73 20 61 72 65 20 73 74 6f   records are sto
4150: 72 65 64 20 69 6e 20 74 68 65 20 22 6f 72 64 65  red in the "orde
4160: 72 73 22 20 74 61 62 6c 65 2c 20 74 68 65 20 66  rs" table, the f
4170: 6f 6c 6c 6f 77 69 6e 67 20 74 72 69 67 67 65 72  ollowing trigger
4180: 0a 65 6e 73 75 72 65 73 20 74 68 61 74 20 61 6c  .ensures that al
4190: 6c 20 61 73 73 6f 63 69 61 74 65 64 20 6f 72 64  l associated ord
41a0: 65 72 73 20 61 72 65 20 72 65 64 69 72 65 63 74  ers are redirect
41b0: 65 64 20 77 68 65 6e 20 61 20 63 75 73 74 6f 6d  ed when a custom
41c0: 65 72 20 63 68 61 6e 67 65 73 0a 68 69 73 20 6f  er changes.his o
41d0: 72 20 68 65 72 20 61 64 64 72 65 73 73 3a 3c 2f  r her address:</
41e0: 70 3e 0a 7d 0a 45 78 61 6d 70 6c 65 20 7b 0a 43  p>.}.Example {.C
41f0: 52 45 41 54 45 20 54 52 49 47 47 45 52 20 75 70  REATE TRIGGER up
4200: 64 61 74 65 5f 63 75 73 74 6f 6d 65 72 5f 61 64  date_customer_ad
4210: 64 72 65 73 73 20 55 50 44 41 54 45 20 4f 46 20  dress UPDATE OF 
4220: 61 64 64 72 65 73 73 20 4f 4e 20 63 75 73 74 6f  address ON custo
4230: 6d 65 72 73 20 0a 20 20 42 45 47 49 4e 0a 20 20  mers .  BEGIN.  
4240: 20 20 55 50 44 41 54 45 20 6f 72 64 65 72 73 20    UPDATE orders 
4250: 53 45 54 20 61 64 64 72 65 73 73 20 3d 20 6e 65  SET address = ne
4260: 77 2e 61 64 64 72 65 73 73 20 57 48 45 52 45 20  w.address WHERE 
4270: 63 75 73 74 6f 6d 65 72 5f 6e 61 6d 65 20 3d 20  customer_name = 
4280: 6f 6c 64 2e 6e 61 6d 65 3b 0a 20 20 45 4e 44 3b  old.name;.  END;
4290: 0a 7d 0a 70 75 74 73 20 7b 0a 3c 70 3e 57 69 74  .}.puts {.<p>Wit
42a0: 68 20 74 68 69 73 20 74 72 69 67 67 65 72 20 69  h this trigger i
42b0: 6e 73 74 61 6c 6c 65 64 2c 20 65 78 65 63 75 74  nstalled, execut
42c0: 69 6e 67 20 74 68 65 20 73 74 61 74 65 6d 65 6e  ing the statemen
42d0: 74 3a 3c 2f 70 3e 0a 7d 0a 0a 45 78 61 6d 70 6c  t:</p>.}..Exampl
42e0: 65 20 7b 0a 55 50 44 41 54 45 20 63 75 73 74 6f  e {.UPDATE custo
42f0: 6d 65 72 73 20 53 45 54 20 61 64 64 72 65 73 73  mers SET address
4300: 20 3d 20 27 31 20 4d 61 69 6e 20 53 74 2e 27 20   = '1 Main St.' 
4310: 57 48 45 52 45 20 6e 61 6d 65 20 3d 20 27 4a 61  WHERE name = 'Ja
4320: 63 6b 20 4a 6f 6e 65 73 27 3b 0a 7d 0a 70 75 74  ck Jones';.}.put
4330: 73 20 7b 0a 3c 70 3e 63 61 75 73 65 73 20 74 68  s {.<p>causes th
4340: 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 6f 20 62  e following to b
4350: 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  e automatically 
4360: 65 78 65 63 75 74 65 64 3a 3c 2f 70 3e 0a 7d 0a  executed:</p>.}.
4370: 45 78 61 6d 70 6c 65 20 7b 0a 55 50 44 41 54 45  Example {.UPDATE
4380: 20 6f 72 64 65 72 73 20 53 45 54 20 61 64 64 72   orders SET addr
4390: 65 73 73 20 3d 20 27 31 20 4d 61 69 6e 20 53 74  ess = '1 Main St
43a0: 2e 27 20 57 48 45 52 45 20 63 75 73 74 6f 6d 65  .' WHERE custome
43b0: 72 5f 6e 61 6d 65 20 3d 20 27 4a 61 63 6b 20 4a  r_name = 'Jack J
43c0: 6f 6e 65 73 27 3b 0a 7d 0a 0a 70 75 74 73 20 7b  ones';.}..puts {
43d0: 0a 3c 70 3e 4e 6f 74 65 20 74 68 61 74 20 63 75  .<p>Note that cu
43e0: 72 72 65 6e 74 6c 79 2c 20 74 72 69 67 67 65 72  rrently, trigger
43f0: 73 20 6d 61 79 20 62 65 68 61 76 65 20 6f 64 64  s may behave odd
4400: 6c 79 20 77 68 65 6e 20 63 72 65 61 74 65 64 20  ly when created 
4410: 6f 6e 20 74 61 62 6c 65 73 0a 20 20 77 69 74 68  on tables.  with
4420: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59   INTEGER PRIMARY
4430: 20 4b 45 59 20 66 69 65 6c 64 73 2e 20 49 66 20   KEY fields. If 
4440: 61 20 42 45 46 4f 52 45 20 74 72 69 67 67 65 72  a BEFORE trigger
4450: 20 70 72 6f 67 72 61 6d 20 6d 6f 64 69 66 69 65   program modifie
4460: 73 20 74 68 65 20 0a 20 20 49 4e 54 45 47 45 52  s the .  INTEGER
4470: 20 50 52 49 4d 41 52 59 20 4b 45 59 20 66 69 65   PRIMARY KEY fie
4480: 6c 64 20 6f 66 20 61 20 72 6f 77 20 74 68 61 74  ld of a row that
4490: 20 77 69 6c 6c 20 62 65 20 73 75 62 73 65 71 75   will be subsequ
44a0: 65 6e 74 6c 79 20 75 70 64 61 74 65 64 20 62 79  ently updated by
44b0: 20 74 68 65 0a 20 20 73 74 61 74 65 6d 65 6e 74   the.  statement
44c0: 20 74 68 61 74 20 63 61 75 73 65 73 20 74 68 65   that causes the
44d0: 20 74 72 69 67 67 65 72 20 74 6f 20 66 69 72 65   trigger to fire
44e0: 2c 20 74 68 65 6e 20 74 68 65 20 75 70 64 61 74  , then the updat
44f0: 65 20 6d 61 79 20 6e 6f 74 20 6f 63 63 75 72 2e  e may not occur.
4500: 20 0a 20 20 54 68 65 20 77 6f 72 6b 61 72 6f 75   .  The workarou
4510: 6e 64 20 69 73 20 74 6f 20 64 65 63 6c 61 72 65  nd is to declare
4520: 20 74 68 65 20 74 61 62 6c 65 20 77 69 74 68 20   the table with 
4530: 61 20 50 52 49 4d 41 52 59 20 4b 45 59 20 63 6f  a PRIMARY KEY co
4540: 6c 75 6d 6e 20 69 6e 73 74 65 61 64 0a 20 20 6f  lumn instead.  o
4550: 66 20 61 6e 20 49 4e 54 45 47 45 52 20 50 52 49  f an INTEGER PRI
4560: 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e 2e  MARY KEY column.
4570: 3c 2f 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c  </p>.}..puts {.<
4580: 70 3e 41 20 73 70 65 63 69 61 6c 20 53 51 4c 20  p>A special SQL 
4590: 66 75 6e 63 74 69 6f 6e 20 52 41 49 53 45 28 29  function RAISE()
45a0: 20 6d 61 79 20 62 65 20 75 73 65 64 20 77 69 74   may be used wit
45b0: 68 69 6e 20 61 20 74 72 69 67 67 65 72 2d 70 72  hin a trigger-pr
45c0: 6f 67 72 61 6d 2c 20 77 69 74 68 20 74 68 65 20  ogram, with the 
45d0: 66 6f 6c 6c 6f 77 69 6e 67 20 73 79 6e 74 61 78  following syntax
45e0: 3c 2f 70 3e 20 0a 7d 0a 53 79 6e 74 61 78 20 7b  </p> .}.Syntax {
45f0: 72 61 69 73 65 2d 66 75 6e 63 74 69 6f 6e 7d 20  raise-function} 
4600: 7b 0a 52 41 49 53 45 20 28 20 41 42 4f 52 54 2c  {.RAISE ( ABORT,
4610: 20 3c 65 72 72 6f 72 2d 6d 65 73 73 61 67 65 3e   <error-message>
4620: 20 29 20 7c 20 0a 52 41 49 53 45 20 28 20 46 41   ) | .RAISE ( FA
4630: 49 4c 2c 20 3c 65 72 72 6f 72 2d 6d 65 73 73 61  IL, <error-messa
4640: 67 65 3e 20 29 20 7c 20 0a 52 41 49 53 45 20 28  ge> ) | .RAISE (
4650: 20 52 4f 4c 4c 42 41 43 4b 2c 20 3c 65 72 72 6f   ROLLBACK, <erro
4660: 72 2d 6d 65 73 73 61 67 65 3e 20 29 20 7c 20 0a  r-message> ) | .
4670: 52 41 49 53 45 20 28 20 49 47 4e 4f 52 45 20 29  RAISE ( IGNORE )
4680: 0a 7d 0a 70 75 74 73 20 7b 0a 3c 70 3e 57 68 65  .}.puts {.<p>Whe
4690: 6e 20 6f 6e 65 20 6f 66 20 74 68 65 20 66 69 72  n one of the fir
46a0: 73 74 20 74 68 72 65 65 20 66 6f 72 6d 73 20 69  st three forms i
46b0: 73 20 63 61 6c 6c 65 64 20 64 75 72 69 6e 67 20  s called during 
46c0: 74 72 69 67 67 65 72 2d 70 72 6f 67 72 61 6d 20  trigger-program 
46d0: 65 78 65 63 75 74 69 6f 6e 2c 20 74 68 65 20 73  execution, the s
46e0: 70 65 63 69 66 69 65 64 20 4f 4e 20 43 4f 4e 46  pecified ON CONF
46f0: 4c 49 43 54 20 70 72 6f 63 65 73 73 69 6e 67 20  LICT processing 
4700: 69 73 20 70 65 72 66 6f 72 6d 65 64 20 28 65 69  is performed (ei
4710: 74 68 65 72 20 41 42 4f 52 54 2c 20 46 41 49 4c  ther ABORT, FAIL
4720: 20 6f 72 20 0a 20 52 4f 4c 4c 42 41 43 4b 29 20   or . ROLLBACK) 
4730: 61 6e 64 20 74 68 65 20 63 75 72 72 65 6e 74 20  and the current 
4740: 71 75 65 72 79 20 74 65 72 6d 69 6e 61 74 65 73  query terminates
4750: 2e 20 41 6e 20 65 72 72 6f 72 20 63 6f 64 65 20  . An error code 
4760: 6f 66 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52  of SQLITE_CONSTR
4770: 41 49 4e 54 20 69 73 20 72 65 74 75 72 6e 65 64  AINT is returned
4780: 20 74 6f 20 74 68 65 20 75 73 65 72 2c 20 61 6c   to the user, al
4790: 6f 6e 67 20 77 69 74 68 20 74 68 65 20 73 70 65  ong with the spe
47a0: 63 69 66 69 65 64 20 65 72 72 6f 72 20 6d 65 73  cified error mes
47b0: 73 61 67 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68  sage.</p>..<p>Wh
47c0: 65 6e 20 52 41 49 53 45 28 49 47 4e 4f 52 45 29  en RAISE(IGNORE)
47d0: 20 69 73 20 63 61 6c 6c 65 64 2c 20 74 68 65 20   is called, the 
47e0: 72 65 6d 61 69 6e 64 65 72 20 6f 66 20 74 68 65  remainder of the
47f0: 20 63 75 72 72 65 6e 74 20 74 72 69 67 67 65 72   current trigger
4800: 20 70 72 6f 67 72 61 6d 2c 0a 74 68 65 20 73 74   program,.the st
4810: 61 74 65 6d 65 6e 74 20 74 68 61 74 20 63 61 75  atement that cau
4820: 73 65 64 20 74 68 65 20 74 72 69 67 67 65 72 20  sed the trigger 
4830: 70 72 6f 67 72 61 6d 20 74 6f 20 65 78 65 63 75  program to execu
4840: 74 65 20 61 6e 64 20 61 6e 79 20 73 75 62 73 65  te and any subse
4850: 71 75 65 6e 74 0a 20 20 20 20 74 72 69 67 67 65  quent.    trigge
4860: 72 20 70 72 6f 67 72 61 6d 73 20 74 68 61 74 20  r programs that 
4870: 77 6f 75 6c 64 20 6f 66 20 62 65 65 6e 20 65 78  would of been ex
4880: 65 63 75 74 65 64 20 61 72 65 20 61 62 61 6e 64  ecuted are aband
4890: 6f 6e 65 64 2e 20 4e 6f 20 64 61 74 61 62 61 73  oned. No databas
48a0: 65 0a 20 20 20 20 63 68 61 6e 67 65 73 20 61 72  e.    changes ar
48b0: 65 20 72 6f 6c 6c 65 64 20 62 61 63 6b 2e 20 20  e rolled back.  
48c0: 49 66 20 74 68 65 20 73 74 61 74 65 6d 65 6e 74  If the statement
48d0: 20 74 68 61 74 20 63 61 75 73 65 64 20 74 68 65   that caused the
48e0: 20 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d   trigger program
48f0: 0a 20 20 20 20 74 6f 20 65 78 65 63 75 74 65 20  .    to execute 
4900: 69 73 20 69 74 73 65 6c 66 20 70 61 72 74 20 6f  is itself part o
4910: 66 20 61 20 74 72 69 67 67 65 72 20 70 72 6f 67  f a trigger prog
4920: 72 61 6d 2c 20 74 68 65 6e 20 74 68 61 74 20 74  ram, then that t
4930: 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 0a 20  rigger program. 
4940: 20 20 20 72 65 73 75 6d 65 73 20 65 78 65 63 75     resumes execu
4950: 74 69 6f 6e 20 61 74 20 74 68 65 20 62 65 67 69  tion at the begi
4960: 6e 6e 69 6e 67 20 6f 66 20 74 68 65 20 6e 65 78  nning of the nex
4970: 74 20 73 74 65 70 2e 0a 3c 2f 70 3e 0a 7d 0a 0a  t step..</p>.}..
4980: 53 65 63 74 69 6f 6e 20 7b 43 52 45 41 54 45 20  Section {CREATE 
4990: 56 49 45 57 7d 20 7b 63 72 65 61 74 65 76 69 65  VIEW} {createvie
49a0: 77 7d 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  w}..Syntax {sql-
49b0: 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 43 52 45 41 54  command} {.CREAT
49c0: 45 20 56 49 45 57 20 3c 76 69 65 77 2d 6e 61 6d  E VIEW <view-nam
49d0: 65 3e 20 41 53 20 3c 73 65 6c 65 63 74 2d 73 74  e> AS <select-st
49e0: 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74 73  atement>.}..puts
49f0: 20 7b 0a 3c 70 3e 54 68 65 20 43 52 45 41 54 45   {.<p>The CREATE
4a00: 20 56 49 45 57 20 63 6f 6d 6d 61 6e 64 20 61 73   VIEW command as
4a10: 73 69 67 6e 73 20 61 20 6e 61 6d 65 20 74 6f 20  signs a name to 
4a20: 61 20 70 72 65 2d 70 61 63 6b 61 67 65 64 20 53  a pre-packaged S
4a30: 45 4c 45 43 54 0a 73 74 61 74 65 6d 65 6e 74 2e  ELECT.statement.
4a40: 20 20 4f 6e 63 65 20 74 68 65 20 76 69 65 77 20    Once the view 
4a50: 69 73 20 63 72 65 61 74 65 64 2c 20 69 74 20 63  is created, it c
4a60: 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 74 68  an be used in th
4a70: 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 0a 6f 66  e FROM clause.of
4a80: 20 61 6e 6f 74 68 65 72 20 53 45 4c 45 43 54 20   another SELECT 
4a90: 69 6e 20 70 6c 61 63 65 20 6f 66 20 61 20 74 61  in place of a ta
4aa0: 62 6c 65 20 6e 61 6d 65 2e 0a 3c 2f 70 3e 0a 0a  ble name..</p>..
4ab0: 3c 70 3e 59 6f 75 20 63 61 6e 6e 6f 74 20 43 4f  <p>You cannot CO
4ac0: 50 59 2c 20 49 4e 53 45 52 54 20 6f 72 20 55 50  PY, INSERT or UP
4ad0: 44 41 54 45 20 61 20 76 69 65 77 2e 20 20 56 69  DATE a view.  Vi
4ae0: 65 77 73 20 61 72 65 20 72 65 61 64 2d 6f 6e 6c  ews are read-onl
4af0: 79 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f  y.</p>.}..Sectio
4b00: 6e 20 44 45 4c 45 54 45 20 64 65 6c 65 74 65 0a  n DELETE delete.
4b10: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61  .Syntax {sql-sta
4b20: 74 65 6d 65 6e 74 7d 20 7b 0a 44 45 4c 45 54 45  tement} {.DELETE
4b30: 20 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6e 61 6d   FROM <table-nam
4b40: 65 3e 20 5b 57 48 45 52 45 20 3c 65 78 70 72 3e  e> [WHERE <expr>
4b50: 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  ].}..puts {.<p>T
4b60: 68 65 20 44 45 4c 45 54 45 20 63 6f 6d 6d 61 6e  he DELETE comman
4b70: 64 20 69 73 20 75 73 65 64 20 74 6f 20 72 65 6d  d is used to rem
4b80: 6f 76 65 20 72 65 63 6f 72 64 73 20 66 72 6f 6d  ove records from
4b90: 20 61 20 74 61 62 6c 65 2e 0a 54 68 65 20 63 6f   a table..The co
4ba0: 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74 73 20 6f  mmand consists o
4bb0: 66 20 74 68 65 20 22 44 45 4c 45 54 45 20 46 52  f the "DELETE FR
4bc0: 4f 4d 22 20 6b 65 79 77 6f 72 64 73 20 66 6f 6c  OM" keywords fol
4bd0: 6c 6f 77 65 64 20 62 79 0a 74 68 65 20 6e 61 6d  lowed by.the nam
4be0: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 66  e of the table f
4bf0: 72 6f 6d 20 77 68 69 63 68 20 72 65 63 6f 72 64  rom which record
4c00: 73 20 61 72 65 20 74 6f 20 62 65 20 72 65 6d 6f  s are to be remo
4c10: 76 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 57 69  ved..</p>..<p>Wi
4c20: 74 68 6f 75 74 20 61 20 57 48 45 52 45 20 63 6c  thout a WHERE cl
4c30: 61 75 73 65 2c 20 61 6c 6c 20 72 6f 77 73 20 6f  ause, all rows o
4c40: 66 20 74 68 65 20 74 61 62 6c 65 20 61 72 65 20  f the table are 
4c50: 72 65 6d 6f 76 65 64 2e 0a 49 66 20 61 20 57 48  removed..If a WH
4c60: 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 73 75  ERE clause is su
4c70: 70 70 6c 69 65 64 2c 20 74 68 65 6e 20 6f 6e 6c  pplied, then onl
4c80: 79 20 74 68 6f 73 65 20 72 6f 77 73 20 74 68 61  y those rows tha
4c90: 74 20 6d 61 74 63 68 0a 74 68 65 20 65 78 70 72  t match.the expr
4ca0: 65 73 73 69 6f 6e 20 61 72 65 20 72 65 6d 6f 76  ession are remov
4cb0: 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74  ed.</p>.}...Sect
4cc0: 69 6f 6e 20 7b 44 52 4f 50 20 49 4e 44 45 58 7d  ion {DROP INDEX}
4cd0: 20 64 72 6f 70 69 6e 64 65 78 0a 0a 53 79 6e 74   dropindex..Synt
4ce0: 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d  ax {sql-command}
4cf0: 20 7b 0a 44 52 4f 50 20 49 4e 44 45 58 20 3c 69   {.DROP INDEX <i
4d00: 6e 64 65 78 2d 6e 61 6d 65 3e 0a 7d 0a 0a 70 75  ndex-name>.}..pu
4d10: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 44 52 4f 50  ts {.<p>The DROP
4d20: 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74   INDEX statement
4d30: 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74 68 65   consists of the
4d40: 20 6b 65 79 77 6f 72 64 73 20 22 44 52 4f 50 20   keywords "DROP 
4d50: 49 4e 44 45 58 22 20 66 6f 6c 6c 6f 77 65 64 0a  INDEX" followed.
4d60: 62 79 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  by the name of t
4d70: 68 65 20 69 6e 64 65 78 2e 20 20 54 68 65 20 69  he index.  The i
4d80: 6e 64 65 78 20 6e 61 6d 65 64 20 69 73 20 63 6f  ndex named is co
4d90: 6d 70 6c 65 74 65 6c 79 20 72 65 6d 6f 76 65 64  mpletely removed
4da0: 20 66 72 6f 6d 0a 74 68 65 20 64 69 73 6b 2e 20   from.the disk. 
4db0: 20 54 68 65 20 6f 6e 6c 79 20 77 61 79 20 74 6f   The only way to
4dc0: 20 72 65 63 6f 76 65 72 20 74 68 65 20 69 6e 64   recover the ind
4dd0: 65 78 20 69 73 20 74 6f 20 72 65 65 6e 74 65 72  ex is to reenter
4de0: 20 74 68 65 0a 61 70 70 72 6f 70 72 69 61 74 65   the.appropriate
4df0: 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 63 6f   CREATE INDEX co
4e00: 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53 65  mmand.</p>.}..Se
4e10: 63 74 69 6f 6e 20 7b 44 52 4f 50 20 54 41 42 4c  ction {DROP TABL
4e20: 45 7d 20 64 72 6f 70 74 61 62 6c 65 0a 0a 53 79  E} droptable..Sy
4e30: 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e  ntax {sql-comman
4e40: 64 7d 20 7b 0a 44 52 4f 50 20 54 41 42 4c 45 20  d} {.DROP TABLE 
4e50: 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 0a 7d 0a 0a  <table-name>.}..
4e60: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 44 52  puts {.<p>The DR
4e70: 4f 50 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65  OP TABLE stateme
4e80: 6e 74 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74  nt consists of t
4e90: 68 65 20 6b 65 79 77 6f 72 64 73 20 22 44 52 4f  he keywords "DRO
4ea0: 50 20 54 41 42 4c 45 22 20 66 6f 6c 6c 6f 77 65  P TABLE" followe
4eb0: 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20 6f 66  d.by the name of
4ec0: 20 74 68 65 20 74 61 62 6c 65 2e 20 20 54 68 65   the table.  The
4ed0: 20 74 61 62 6c 65 20 6e 61 6d 65 64 20 69 73 20   table named is 
4ee0: 63 6f 6d 70 6c 65 74 65 6c 79 20 72 65 6d 6f 76  completely remov
4ef0: 65 64 20 66 72 6f 6d 0a 74 68 65 20 64 69 73 6b  ed from.the disk
4f00: 2e 20 20 54 68 65 20 74 61 62 6c 65 20 63 61 6e  .  The table can
4f10: 20 6e 6f 74 20 62 65 20 72 65 63 6f 76 65 72 65   not be recovere
4f20: 64 2e 20 20 41 6c 6c 20 69 6e 64 69 63 65 73 20  d.  All indices 
4f30: 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68 0a  associated with.
4f40: 74 68 65 20 74 61 62 6c 65 20 61 72 65 20 61 6c  the table are al
4f50: 73 6f 20 64 65 6c 65 74 65 64 2e 3c 2f 70 3e 7d  so deleted.</p>}
4f60: 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20  ..Section {DROP 
4f70: 54 52 49 47 47 45 52 7d 20 64 72 6f 70 74 72 69  TRIGGER} droptri
4f80: 67 67 65 72 0a 53 79 6e 74 61 78 20 7b 73 71 6c  gger.Syntax {sql
4f90: 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 44 52  -statement} {.DR
4fa0: 4f 50 20 54 52 49 47 47 45 52 20 3c 74 72 69 67  OP TRIGGER <trig
4fb0: 67 65 72 2d 6e 61 6d 65 3e 0a 7d 0a 70 75 74 73  ger-name>.}.puts
4fc0: 20 7b 20 0a 20 20 3c 70 3e 55 73 65 64 20 74 6f   { .  <p>Used to
4fd0: 20 64 72 6f 70 20 61 20 74 72 69 67 67 65 72 20   drop a trigger 
4fe0: 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73  from the databas
4ff0: 65 20 73 63 68 65 6d 61 2e 20 4e 6f 74 65 20 74  e schema. Note t
5000: 68 61 74 20 74 72 69 67 67 65 72 73 0a 20 20 61  hat triggers.  a
5010: 72 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79  re automatically
5020: 20 64 72 6f 70 70 65 64 20 77 68 65 6e 20 74 68   dropped when th
5030: 65 20 61 73 73 6f 63 69 61 74 65 64 20 74 61 62  e associated tab
5040: 6c 65 20 69 73 20 64 72 6f 70 70 65 64 2e 3c 2f  le is dropped.</
5050: 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 7b 44  p>.}..Section {D
5060: 52 4f 50 20 56 49 45 57 7d 20 64 72 6f 70 76 69  ROP VIEW} dropvi
5070: 65 77 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  ew..Syntax {sql-
5080: 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50 20  command} {.DROP 
5090: 56 49 45 57 20 3c 76 69 65 77 2d 6e 61 6d 65 3e  VIEW <view-name>
50a0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
50b0: 65 20 44 52 4f 50 20 56 49 45 57 20 73 74 61 74  e DROP VIEW stat
50c0: 65 6d 65 6e 74 20 63 6f 6e 73 69 73 74 73 20 6f  ement consists o
50d0: 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22  f the keywords "
50e0: 44 52 4f 50 20 56 49 45 57 22 20 66 6f 6c 6c 6f  DROP VIEW" follo
50f0: 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65 20  wed.by the name 
5100: 6f 66 20 74 68 65 20 76 69 65 77 2e 20 20 54 68  of the view.  Th
5110: 65 20 76 69 65 77 20 6e 61 6d 65 64 20 69 73 20  e view named is 
5120: 72 65 6d 6f 76 65 64 20 66 72 6f 6d 20 74 68 65  removed from the
5130: 20 64 61 74 61 62 61 73 65 2e 0a 42 75 74 20 6e   database..But n
5140: 6f 20 61 63 74 75 61 6c 20 64 61 74 61 20 69 73  o actual data is
5150: 20 6d 6f 64 69 66 69 65 64 2e 3c 2f 70 3e 7d 0a   modified.</p>}.
5160: 0a 53 65 63 74 69 6f 6e 20 45 58 50 4c 41 49 4e  .Section EXPLAIN
5170: 20 65 78 70 6c 61 69 6e 0a 0a 53 79 6e 74 61 78   explain..Syntax
5180: 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d   {sql-statement}
5190: 20 7b 0a 45 58 50 4c 41 49 4e 20 3c 73 71 6c 2d   {.EXPLAIN <sql-
51a0: 73 74 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75  statement>.}..pu
51b0: 74 73 20 7b 0a 3c 70 3e 54 68 65 20 45 58 50 4c  ts {.<p>The EXPL
51c0: 41 49 4e 20 63 6f 6d 6d 61 6e 64 20 6d 6f 64 69  AIN command modi
51d0: 66 69 65 72 20 69 73 20 61 20 6e 6f 6e 2d 73 74  fier is a non-st
51e0: 61 6e 64 61 72 64 20 65 78 74 65 6e 73 69 6f 6e  andard extension
51f0: 2e 20 20 54 68 65 0a 69 64 65 61 20 63 6f 6d 65  .  The.idea come
5200: 73 20 66 72 6f 6d 20 61 20 73 69 6d 69 6c 61 72  s from a similar
5210: 20 63 6f 6d 6d 61 6e 64 20 66 6f 75 6e 64 20 69   command found i
5220: 6e 20 50 6f 73 74 67 72 65 53 51 4c 2c 20 62 75  n PostgreSQL, bu
5230: 74 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e 0a  t the operation.
5240: 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 64 69  is completely di
5250: 66 66 65 72 65 6e 74 2e 3c 2f 70 3e 0a 0a 3c 70  fferent.</p>..<p
5260: 3e 49 66 20 74 68 65 20 45 58 50 4c 41 49 4e 20  >If the EXPLAIN 
5270: 6b 65 79 77 6f 72 64 20 61 70 70 65 61 72 73 20  keyword appears 
5280: 62 65 66 6f 72 65 20 61 6e 79 20 6f 74 68 65 72  before any other
5290: 20 53 51 4c 69 74 65 20 53 51 4c 20 63 6f 6d 6d   SQLite SQL comm
52a0: 61 6e 64 0a 74 68 65 6e 20 69 6e 73 74 65 61 64  and.then instead
52b0: 20 6f 66 20 61 63 74 75 61 6c 6c 79 20 65 78 65   of actually exe
52c0: 63 75 74 69 6e 67 20 74 68 65 20 63 6f 6d 6d 61  cuting the comma
52d0: 6e 64 2c 20 74 68 65 20 53 51 4c 69 74 65 20 6c  nd, the SQLite l
52e0: 69 62 72 61 72 79 20 77 69 6c 6c 0a 72 65 70 6f  ibrary will.repo
52f0: 72 74 20 62 61 63 6b 20 74 68 65 20 73 65 71 75  rt back the sequ
5300: 65 6e 63 65 20 6f 66 20 76 69 72 74 75 61 6c 20  ence of virtual 
5310: 6d 61 63 68 69 6e 65 20 69 6e 73 74 72 75 63 74  machine instruct
5320: 69 6f 6e 73 20 69 74 20 77 6f 75 6c 64 20 68 61  ions it would ha
5330: 76 65 0a 75 73 65 64 20 74 6f 20 65 78 65 63 75  ve.used to execu
5340: 74 65 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 68  te the command h
5350: 61 64 20 74 68 65 20 45 58 50 4c 41 49 4e 20 6b  ad the EXPLAIN k
5360: 65 79 77 6f 72 64 20 6e 6f 74 20 62 65 65 6e 20  eyword not been 
5370: 70 72 65 73 65 6e 74 2e 0a 46 6f 72 20 61 64 64  present..For add
5380: 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74  itional informat
5390: 69 6f 6e 20 61 62 6f 75 74 20 76 69 72 74 75 61  ion about virtua
53a0: 6c 20 6d 61 63 68 69 6e 65 20 69 6e 73 74 72 75  l machine instru
53b0: 63 74 69 6f 6e 73 20 73 65 65 0a 74 68 65 20 3c  ctions see.the <
53c0: 61 20 68 72 65 66 3d 22 61 72 63 68 2e 68 74 6d  a href="arch.htm
53d0: 6c 22 3e 61 72 63 68 69 74 65 63 74 75 72 65 20  l">architecture 
53e0: 64 65 73 63 72 69 70 74 69 6f 6e 3c 2f 61 3e 20  description</a> 
53f0: 6f 72 20 74 68 65 20 64 6f 63 75 6d 65 6e 74 61  or the documenta
5400: 74 69 6f 6e 0a 6f 6e 20 3c 61 20 68 72 65 66 3d  tion.on <a href=
5410: 22 6f 70 63 6f 64 65 2e 68 74 6d 6c 22 3e 61 76  "opcode.html">av
5420: 61 69 6c 61 62 6c 65 20 6f 70 63 6f 64 65 73 3c  ailable opcodes<
5430: 2f 61 3e 20 66 6f 72 20 74 68 65 20 76 69 72 74  /a> for the virt
5440: 75 61 6c 20 6d 61 63 68 69 6e 65 2e 3c 2f 70 3e  ual machine.</p>
5450: 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 65 78 70 72  .}..Section expr
5460: 65 73 73 69 6f 6e 20 65 78 70 72 0a 0a 53 79 6e  ession expr..Syn
5470: 74 61 78 20 7b 65 78 70 72 7d 20 7b 0a 3c 65 78  tax {expr} {.<ex
5480: 70 72 3e 20 3c 62 69 6e 61 72 79 2d 6f 70 3e 20  pr> <binary-op> 
5490: 3c 65 78 70 72 3e 20 7c 0a 3c 65 78 70 72 3e 20  <expr> |.<expr> 
54a0: 3c 6c 69 6b 65 2d 6f 70 3e 20 3c 65 78 70 72 3e  <like-op> <expr>
54b0: 20 7c 0a 3c 75 6e 61 72 79 2d 6f 70 3e 20 3c 65   |.<unary-op> <e
54c0: 78 70 72 3e 20 7c 0a 28 20 3c 65 78 70 72 3e 20  xpr> |.( <expr> 
54d0: 29 20 7c 0a 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65  ) |.<column-name
54e0: 3e 20 7c 0a 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  > |.<table-name>
54f0: 20 2e 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e   . <column-name>
5500: 20 7c 0a 3c 6c 69 74 65 72 61 6c 2d 76 61 6c 75   |.<literal-valu
5510: 65 3e 20 7c 0a 3c 66 75 6e 63 74 69 6f 6e 2d 6e  e> |.<function-n
5520: 61 6d 65 3e 20 28 20 3c 65 78 70 72 2d 6c 69 73  ame> ( <expr-lis
5530: 74 3e 20 7c 20 53 54 41 52 20 29 20 7c 0a 3c 65  t> | STAR ) |.<e
5540: 78 70 72 3e 20 49 53 4e 55 4c 4c 20 7c 0a 3c 65  xpr> ISNULL |.<e
5550: 78 70 72 3e 20 4e 4f 54 4e 55 4c 4c 20 7c 0a 3c  xpr> NOTNULL |.<
5560: 65 78 70 72 3e 20 5b 4e 4f 54 5d 20 42 45 54 57  expr> [NOT] BETW
5570: 45 45 4e 20 3c 65 78 70 72 3e 20 41 4e 44 20 3c  EEN <expr> AND <
5580: 65 78 70 72 3e 20 7c 0a 3c 65 78 70 72 3e 20 5b  expr> |.<expr> [
5590: 4e 4f 54 5d 20 49 4e 20 28 20 3c 76 61 6c 75 65  NOT] IN ( <value
55a0: 2d 6c 69 73 74 3e 20 29 20 7c 0a 3c 65 78 70 72  -list> ) |.<expr
55b0: 3e 20 5b 4e 4f 54 5d 20 49 4e 20 28 20 3c 73 65  > [NOT] IN ( <se
55c0: 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 20  lect-statement> 
55d0: 29 20 7c 0a 28 20 3c 73 65 6c 65 63 74 2d 73 74  ) |.( <select-st
55e0: 61 74 65 6d 65 6e 74 3e 20 29 20 7c 0a 43 41 53  atement> ) |.CAS
55f0: 45 20 5b 3c 65 78 70 72 3e 5d 20 28 20 57 48 45  E [<expr>] ( WHE
5600: 4e 20 3c 65 78 70 72 3e 20 54 48 45 4e 20 3c 65  N <expr> THEN <e
5610: 78 70 72 3e 20 29 2b 20 5b 45 4c 53 45 20 3c 65  xpr> )+ [ELSE <e
5620: 78 70 72 3e 5d 20 45 4e 44 0a 7d 20 7b 6c 69 6b  xpr>] END.} {lik
5630: 65 2d 6f 70 7d 20 7b 0a 4c 49 4b 45 20 7c 20 47  e-op} {.LIKE | G
5640: 4c 4f 42 20 7c 20 4e 4f 54 20 4c 49 4b 45 20 7c  LOB | NOT LIKE |
5650: 20 4e 4f 54 20 47 4c 4f 42 0a 7d 0a 0a 70 75 74   NOT GLOB.}..put
5660: 73 20 7b 0a 3c 70 3e 54 68 69 73 20 73 65 63 74  s {.<p>This sect
5670: 69 6f 6e 20 69 73 20 64 69 66 66 65 72 65 6e 74  ion is different
5680: 20 66 72 6f 6d 20 74 68 65 20 6f 74 68 65 72 73   from the others
5690: 2e 20 20 4d 6f 73 74 20 6f 74 68 65 72 20 73 65  .  Most other se
56a0: 63 74 69 6f 6e 73 20 6f 66 0a 74 68 69 73 20 64  ctions of.this d
56b0: 6f 63 75 6d 65 6e 74 20 74 61 6c 6b 73 20 61 62  ocument talks ab
56c0: 6f 75 74 20 61 20 70 61 72 74 69 63 75 6c 61 72  out a particular
56d0: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 20 20 54   SQL command.  T
56e0: 68 69 73 20 73 65 63 74 69 6f 6e 20 64 6f 65 73  his section does
56f0: 0a 6e 6f 74 20 74 61 6c 6b 20 61 62 6f 75 74 20  .not talk about 
5700: 61 20 73 74 61 6e 64 61 6c 6f 6e 65 20 63 6f 6d  a standalone com
5710: 6d 61 6e 64 20 62 75 74 20 61 62 6f 75 74 20 22  mand but about "
5720: 65 78 70 72 65 73 73 69 6f 6e 73 22 20 77 68 69  expressions" whi
5730: 63 68 20 61 72 65 20 0a 73 75 62 63 6f 6d 70 6f  ch are .subcompo
5740: 6e 65 6e 74 20 6f 66 20 6d 6f 73 74 20 6f 74 68  nent of most oth
5750: 65 72 20 63 6f 6d 6d 61 6e 64 73 2e 3c 2f 70 3e  er commands.</p>
5760: 0a 0a 3c 70 3e 53 51 4c 69 74 65 20 75 6e 64 65  ..<p>SQLite unde
5770: 72 73 74 61 6e 64 73 20 74 68 65 20 66 6f 6c 6c  rstands the foll
5780: 6f 77 69 6e 67 20 62 69 6e 61 72 79 20 6f 70 65  owing binary ope
5790: 72 61 74 6f 72 73 2c 20 69 6e 20 6f 72 64 65 72  rators, in order
57a0: 20 66 72 6f 6d 0a 68 69 67 68 65 73 74 20 74 6f   from.highest to
57b0: 20 6c 6f 77 65 73 74 20 70 72 65 63 65 64 65 6e   lowest preceden
57c0: 63 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71  ce:</p>..<blockq
57d0: 75 6f 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f 6e 74  uote><pre>.<font
57e0: 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22   color="#2c2cf0"
57f0: 3e 3c 62 69 67 3e 7c 7c 0a 2a 20 20 20 20 2f 20  ><big>||.*    / 
5800: 20 20 20 25 0a 2b 20 20 20 20 2d 0a 26 6c 74 3b     %.+    -.&lt;
5810: 26 6c 74 3b 20 20 20 26 67 74 3b 26 67 74 3b 20  &lt;   &gt;&gt; 
5820: 20 20 26 61 6d 70 3b 20 20 20 20 7c 0a 26 6c 74    &amp;    |.&lt
5830: 3b 20 20 20 20 26 6c 74 3b 3d 20 20 20 26 67 74  ;    &lt;=   &gt
5840: 3b 20 20 20 20 26 67 74 3b 3d 0a 3d 20 20 20 20  ;    &gt;=.=    
5850: 3d 3d 20 20 20 21 3d 20 20 20 26 6c 74 3b 26 67  ==   !=   &lt;&g
5860: 74 3b 20 20 20 3c 2f 62 69 67 3e 49 4e 0a 41 4e  t;   </big>IN.AN
5870: 44 20 20 20 0a 4f 52 3c 2f 66 6f 6e 74 3e 0a 3c  D   .OR</font>.<
5880: 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74  /pre></blockquot
5890: 65 3e 0a 0a 3c 70 3e 53 75 70 70 6f 72 74 65 64  e>..<p>Supported
58a0: 20 75 6e 61 72 79 20 6f 70 65 72 61 74 65 72 73   unary operaters
58b0: 20 61 72 65 20 74 68 65 73 65 3a 3c 2f 70 3e 0a   are these:</p>.
58c0: 0a 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  .<blockquote><pr
58d0: 65 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22  e>.<font color="
58e0: 23 32 63 32 63 66 30 22 3e 3c 62 69 67 3e 2d 20  #2c2cf0"><big>- 
58f0: 20 20 20 2b 20 20 20 20 21 20 20 20 20 7e 3c 2f     +    !    ~</
5900: 62 69 67 3e 3c 2f 66 6f 6e 74 3e 0a 3c 2f 70 72  big></font>.</pr
5910: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
5920: 0a 3c 70 3e 41 6e 79 20 53 51 4c 69 74 65 20 76  .<p>Any SQLite v
5930: 61 6c 75 65 20 63 61 6e 20 62 65 20 75 73 65 64  alue can be used
5940: 20 61 73 20 70 61 72 74 20 6f 66 20 61 6e 20 65   as part of an e
5950: 78 70 72 65 73 73 69 6f 6e 2e 20 20 0a 46 6f 72  xpression.  .For
5960: 20 61 72 69 74 68 6d 65 74 69 63 20 6f 70 65 72   arithmetic oper
5970: 61 74 69 6f 6e 73 2c 20 69 6e 74 65 67 65 72 73  ations, integers
5980: 20 61 72 65 20 74 72 65 61 74 65 64 20 61 73 20   are treated as 
5990: 69 6e 74 65 67 65 72 73 2e 0a 53 74 72 69 6e 67  integers..String
59a0: 73 20 61 72 65 20 66 69 72 73 74 20 63 6f 6e 76  s are first conv
59b0: 65 72 74 65 64 20 74 6f 20 72 65 61 6c 20 6e 75  erted to real nu
59c0: 6d 62 65 72 73 20 75 73 69 6e 67 20 3c 62 3e 61  mbers using <b>a
59d0: 74 6f 66 28 29 3c 2f 62 3e 2e 0a 46 6f 72 20 63  tof()</b>..For c
59e0: 6f 6d 70 61 72 69 73 6f 6e 20 6f 70 65 72 61 74  omparison operat
59f0: 6f 72 73 2c 20 6e 75 6d 62 65 72 73 20 63 6f 6d  ors, numbers com
5a00: 70 61 72 65 20 61 73 20 6e 75 6d 62 65 72 73 20  pare as numbers 
5a10: 61 6e 64 20 73 74 72 69 6e 67 73 0a 63 6f 6d 70  and strings.comp
5a20: 61 72 65 20 75 73 69 6e 67 20 74 68 65 20 3c 62  are using the <b
5a30: 3e 73 74 72 63 6d 70 28 29 3c 2f 62 3e 20 66 75  >strcmp()</b> fu
5a40: 6e 63 74 69 6f 6e 2e 0a 4e 6f 74 65 20 74 68 61  nction..Note tha
5a50: 74 20 74 68 65 72 65 20 61 72 65 20 74 77 6f 20  t there are two 
5a60: 76 61 72 69 61 74 69 6f 6e 73 20 6f 66 20 74 68  variations of th
5a70: 65 20 65 71 75 61 6c 73 20 61 6e 64 20 6e 6f 74  e equals and not
5a80: 20 65 71 75 61 6c 73 0a 6f 70 65 72 61 74 6f 72   equals.operator
5a90: 73 2e 20 20 45 71 75 61 6c 73 20 63 61 6e 20 62  s.  Equals can b
5aa0: 65 20 65 69 74 68 65 72 7d 0a 70 75 74 73 20 22  e either}.puts "
5ab0: 5b 4f 70 65 72 61 74 6f 72 20 3d 5d 20 6f 72 20  [Operator =] or 
5ac0: 5b 4f 70 65 72 61 74 6f 72 20 3d 3d 5d 2e 0a 54  [Operator ==]..T
5ad0: 68 65 20 6e 6f 6e 2d 65 71 75 61 6c 73 20 6f 70  he non-equals op
5ae0: 65 72 61 74 6f 72 20 63 61 6e 20 62 65 20 65 69  erator can be ei
5af0: 74 68 65 72 0a 5b 4f 70 65 72 61 74 6f 72 20 21  ther.[Operator !
5b00: 3d 5d 20 6f 72 20 5b 4f 70 65 72 61 74 6f 72 20  =] or [Operator 
5b10: 7b 26 6c 74 3b 26 67 74 3b 7d 5d 2e 0a 54 68 65  {&lt;&gt;}]..The
5b20: 20 5b 4f 70 65 72 61 74 6f 72 20 7c 7c 5d 20 6f   [Operator ||] o
5b30: 70 65 72 61 74 6f 72 20 69 73 20 5c 22 63 6f 6e  perator is \"con
5b40: 63 61 74 65 6e 61 74 65 5c 22 20 2d 20 69 74 20  catenate\" - it 
5b50: 6a 6f 69 6e 73 20 74 6f 67 65 74 68 65 72 0a 74  joins together.t
5b60: 68 65 20 74 77 6f 20 73 74 72 69 6e 67 73 20 6f  he two strings o
5b70: 66 20 69 74 73 20 6f 70 65 72 61 6e 64 73 2e 3c  f its operands.<
5b80: 2f 70 3e 22 0a 70 75 74 73 20 7b 0a 0a 3c 70 3e  /p>".puts {..<p>
5b90: 54 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  The LIKE operato
5ba0: 72 20 64 6f 65 73 20 61 20 77 69 6c 64 63 61 72  r does a wildcar
5bb0: 64 20 63 6f 6d 70 61 72 69 73 69 6f 6e 2e 20 20  d comparision.  
5bc0: 54 68 65 20 6f 70 65 72 61 6e 64 0a 74 6f 20 74  The operand.to t
5bd0: 68 65 20 72 69 67 68 74 20 63 6f 6e 74 61 69 6e  he right contain
5be0: 73 20 74 68 65 20 77 69 6c 64 63 61 72 64 73 2e  s the wildcards.
5bf0: 7d 0a 70 75 74 73 20 22 41 20 70 65 72 63 65 6e  }.puts "A percen
5c00: 74 20 73 79 6d 62 6f 6c 20 5b 4f 70 65 72 61 74  t symbol [Operat
5c10: 6f 72 20 25 5d 20 69 6e 20 74 68 65 20 72 69 67  or %] in the rig
5c20: 68 74 20 6f 70 65 72 61 6e 64 0a 6d 61 74 63 68  ht operand.match
5c30: 65 73 20 61 6e 79 20 73 65 71 75 65 6e 63 65 20  es any sequence 
5c40: 6f 66 20 7a 65 72 6f 20 6f 72 20 6d 6f 72 65 20  of zero or more 
5c50: 63 68 61 72 61 63 74 65 72 73 20 6f 6e 20 74 68  characters on th
5c60: 65 20 6c 65 66 74 2e 0a 41 6e 20 75 6e 64 65 72  e left..An under
5c70: 73 63 6f 72 65 20 5b 4f 70 65 72 61 74 6f 72 20  score [Operator 
5c80: 5f 5d 20 6f 6e 20 74 68 65 20 72 69 67 68 74 0a  _] on the right.
5c90: 6d 61 74 63 68 65 73 20 61 6e 79 20 73 69 6e 67  matches any sing
5ca0: 6c 65 20 63 68 61 72 61 63 74 65 72 20 6f 6e 20  le character on 
5cb0: 74 68 65 20 6c 65 66 74 2e 22 0a 70 75 74 73 20  the left.".puts 
5cc0: 7b 54 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74  {The LIKE operat
5cd0: 6f 72 20 69 73 0a 6e 6f 74 20 63 61 73 65 20 73  or is.not case s
5ce0: 65 6e 73 69 74 69 76 65 20 61 6e 64 20 77 69 6c  ensitive and wil
5cf0: 6c 20 6d 61 74 63 68 20 75 70 70 65 72 20 63 61  l match upper ca
5d00: 73 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e  se characters on
5d10: 20 6f 6e 65 0a 73 69 64 65 20 61 67 61 69 6e 73   one.side agains
5d20: 74 20 6c 6f 77 65 72 20 63 61 73 65 20 63 68 61  t lower case cha
5d30: 72 61 63 74 65 72 73 20 6f 6e 20 74 68 65 20 6f  racters on the o
5d40: 74 68 65 72 2e 0a 28 41 20 62 75 67 3a 20 53 51  ther..(A bug: SQ
5d50: 4c 69 74 65 20 6f 6e 6c 79 20 75 6e 64 65 72 73  Lite only unders
5d60: 74 61 6e 64 73 20 75 70 70 65 72 2f 6c 6f 77 65  tands upper/lowe
5d70: 72 20 63 61 73 65 20 66 6f 72 20 37 2d 62 69 74  r case for 7-bit
5d80: 20 4c 61 74 69 6e 0a 63 68 61 72 61 63 74 65 72   Latin.character
5d90: 73 2e 20 20 48 65 6e 63 65 20 74 68 65 20 4c 49  s.  Hence the LI
5da0: 4b 45 20 6f 70 65 72 61 74 6f 72 20 69 73 20 63  KE operator is c
5db0: 61 73 65 20 73 65 6e 73 69 74 69 76 65 20 66 6f  ase sensitive fo
5dc0: 72 0a 38 2d 62 69 74 20 69 73 6f 38 38 35 39 20  r.8-bit iso8859 
5dd0: 63 68 61 72 61 63 74 65 72 73 20 6f 72 20 55 54  characters or UT
5de0: 46 2d 38 20 63 68 61 72 61 63 74 65 72 73 2e 20  F-8 characters. 
5df0: 20 46 6f 72 20 65 78 61 6d 70 6c 65 2c 0a 74 68   For example,.th
5e00: 65 20 65 78 70 72 65 73 73 69 6f 6e 20 3c 62 3e  e expression <b>
5e10: 27 61 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62  'a'&nbsp;LIKE&nb
5e20: 73 70 3b 27 41 27 3c 2f 62 3e 20 69 73 20 54 52  sp;'A'</b> is TR
5e30: 55 45 20 62 75 74 0a 3c 62 3e 27 26 61 65 6c 69  UE but.<b>'&aeli
5e40: 67 3b 27 26 6e 62 73 70 3b 4c 49 4b 45 26 6e 62  g;'&nbsp;LIKE&nb
5e50: 73 70 3b 27 26 41 45 6c 69 67 3b 27 3c 2f 62 3e  sp;'&AElig;'</b>
5e60: 20 69 73 20 46 41 4c 53 45 2e 29 0a 3c 2f 70 3e   is FALSE.).</p>
5e70: 0a 0a 3c 70 3e 54 68 65 20 47 4c 4f 42 20 6f 70  ..<p>The GLOB op
5e80: 65 72 61 74 6f 72 20 69 73 20 73 69 6d 69 6c 61  erator is simila
5e90: 72 20 74 6f 20 4c 49 4b 45 20 62 75 74 20 75 73  r to LIKE but us
5ea0: 65 73 20 74 68 65 20 55 6e 69 78 0a 66 69 6c 65  es the Unix.file
5eb0: 20 67 6c 6f 62 62 69 6e 67 20 73 79 6e 74 61 78   globbing syntax
5ec0: 20 66 6f 72 20 69 74 73 20 77 69 6c 64 63 61 72   for its wildcar
5ed0: 64 73 2e 20 20 41 6c 73 6f 2c 20 47 4c 4f 42 20  ds.  Also, GLOB 
5ee0: 69 73 20 63 61 73 65 0a 73 65 6e 73 69 74 69 76  is case.sensitiv
5ef0: 65 2c 20 75 6e 6c 69 6b 65 20 4c 49 4b 45 2e 20  e, unlike LIKE. 
5f00: 20 42 6f 74 68 20 47 4c 4f 42 20 61 6e 64 20 4c   Both GLOB and L
5f10: 49 4b 45 20 6d 61 79 20 62 65 20 70 72 65 63 65  IKE may be prece
5f20: 64 65 64 20 62 79 0a 74 68 65 20 4e 4f 54 20 6b  ded by.the NOT k
5f30: 65 79 77 6f 72 64 20 74 6f 20 69 6e 76 65 72 74  eyword to invert
5f40: 20 74 68 65 20 73 65 6e 73 65 20 6f 66 20 74 68   the sense of th
5f50: 65 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e  e test.</p>..<p>
5f60: 41 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 63 61  A column name ca
5f70: 6e 20 62 65 20 61 6e 79 20 6f 66 20 74 68 65 20  n be any of the 
5f80: 6e 61 6d 65 73 20 64 65 66 69 6e 65 64 20 69 6e  names defined in
5f90: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
5fa0: 45 0a 73 74 61 74 65 6d 65 6e 74 20 6f 72 20 6f  E.statement or o
5fb0: 6e 65 20 6f 66 20 74 68 65 20 66 6f 6c 6c 6f 77  ne of the follow
5fc0: 69 6e 67 20 73 70 65 63 69 61 6c 20 69 64 65 6e  ing special iden
5fd0: 74 69 66 69 65 72 73 3a 20 22 3c 62 3e 52 4f 57  tifiers: "<b>ROW
5fe0: 49 44 3c 2f 62 3e 22 2c 0a 22 3c 62 3e 4f 49 44  ID</b>",."<b>OID
5ff0: 3c 2f 62 3e 22 2c 20 6f 72 20 22 3c 62 3e 5f 52  </b>", or "<b>_R
6000: 4f 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54 68 65 73  OWID_</b>"..Thes
6010: 65 20 73 70 65 63 69 61 6c 20 69 64 65 6e 74 69  e special identi
6020: 66 69 65 72 73 20 61 6c 6c 20 64 65 73 63 72 69  fiers all descri
6030: 62 65 20 74 68 65 0a 75 6e 69 71 75 65 20 72 61  be the.unique ra
6040: 6e 64 6f 6d 20 69 6e 74 65 67 65 72 20 6b 65 79  ndom integer key
6050: 20 28 74 68 65 20 22 72 6f 77 20 6b 65 79 22 29   (the "row key")
6060: 20 61 73 73 6f 63 69 61 74 65 64 20 77 69 74 68   associated with
6070: 20 65 76 65 72 79 20 0a 72 6f 77 20 6f 66 20 65   every .row of e
6080: 76 65 72 79 20 74 61 62 6c 65 2e 0a 54 68 65 20  very table..The 
6090: 73 70 65 63 69 61 6c 20 69 64 65 6e 74 69 66 69  special identifi
60a0: 65 72 73 20 6f 6e 6c 79 20 72 65 66 65 72 20 74  ers only refer t
60b0: 6f 20 74 68 65 20 72 6f 77 20 6b 65 79 20 69 66  o the row key if
60c0: 20 74 68 65 20 43 52 45 41 54 45 20 54 41 42 4c   the CREATE TABL
60d0: 45 0a 73 74 61 74 65 6d 65 6e 74 20 64 6f 65 73  E.statement does
60e0: 20 6e 6f 74 20 64 65 66 69 6e 65 20 61 20 72 65   not define a re
60f0: 61 6c 20 63 6f 6c 75 6d 6e 20 77 69 74 68 20 74  al column with t
6100: 68 65 20 73 61 6d 65 20 6e 61 6d 65 2e 20 20 52  he same name.  R
6110: 6f 77 20 6b 65 79 73 0a 61 63 74 20 6c 69 6b 65  ow keys.act like
6120: 20 72 65 61 64 2d 6f 6e 6c 79 20 63 6f 6c 75 6d   read-only colum
6130: 6e 73 2e 20 20 41 20 72 6f 77 20 6b 65 79 20 63  ns.  A row key c
6140: 61 6e 20 62 65 20 75 73 65 64 20 61 6e 79 77 68  an be used anywh
6150: 65 72 65 20 61 20 72 65 67 75 6c 61 72 0a 63 6f  ere a regular.co
6160: 6c 75 6d 6e 20 63 61 6e 20 62 65 20 75 73 65 64  lumn can be used
6170: 2c 20 65 78 63 65 70 74 20 74 68 61 74 20 79 6f  , except that yo
6180: 75 20 63 61 6e 6e 6f 74 20 63 68 61 6e 67 65 20  u cannot change 
6190: 74 68 65 20 76 61 6c 75 65 0a 6f 66 20 61 20 72  the value.of a r
61a0: 6f 77 20 6b 65 79 20 69 6e 20 61 6e 20 55 50 44  ow key in an UPD
61b0: 41 54 45 20 6f 72 20 49 4e 53 45 52 54 20 73 74  ATE or INSERT st
61c0: 61 74 65 6d 65 6e 74 2e 0a 22 53 45 4c 45 43 54  atement.."SELECT
61d0: 20 2a 20 2e 2e 2e 22 20 64 6f 65 73 20 6e 6f 74   * ..." does not
61e0: 20 72 65 74 75 72 6e 20 74 68 65 20 72 6f 77 20   return the row 
61f0: 6b 65 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 45 4c  key.</p>..<p>SEL
6200: 45 43 54 20 73 74 61 74 65 6d 65 6e 74 73 20 63  ECT statements c
6210: 61 6e 20 61 70 70 65 61 72 20 69 6e 20 65 78 70  an appear in exp
6220: 72 65 73 73 69 6f 6e 73 20 61 73 20 65 69 74 68  ressions as eith
6230: 65 72 20 74 68 65 0a 72 69 67 68 74 2d 68 61 6e  er the.right-han
6240: 64 20 6f 70 65 72 61 6e 64 20 6f 66 20 74 68 65  d operand of the
6250: 20 49 4e 20 6f 70 65 72 61 74 6f 72 20 6f 72 20   IN operator or 
6260: 61 73 20 61 20 73 63 61 6c 61 72 20 71 75 61 6e  as a scalar quan
6270: 74 69 74 79 2e 0a 49 6e 20 62 6f 74 68 20 63 61  tity..In both ca
6280: 73 65 73 2c 20 74 68 65 20 53 45 4c 45 43 54 20  ses, the SELECT 
6290: 73 68 6f 75 6c 64 20 68 61 76 65 20 6f 6e 6c 79  should have only
62a0: 20 61 20 73 69 6e 67 6c 65 20 63 6f 6c 75 6d 6e   a single column
62b0: 20 69 6e 20 69 74 73 0a 72 65 73 75 6c 74 2e 20   in its.result. 
62c0: 20 43 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54   Compound SELECT
62d0: 73 20 28 63 6f 6e 6e 65 63 74 65 64 20 77 69 74  s (connected wit
62e0: 68 20 6b 65 79 77 6f 72 64 73 20 6c 69 6b 65 20  h keywords like 
62f0: 55 4e 49 4f 4e 20 6f 72 0a 45 58 43 45 50 54 29  UNION or.EXCEPT)
6300: 20 61 72 65 20 61 6c 6c 6f 77 65 64 2e 0a 41 20   are allowed..A 
6310: 53 45 4c 45 43 54 20 69 6e 20 61 6e 20 65 78 70  SELECT in an exp
6320: 72 65 73 73 69 6f 6e 20 69 73 20 65 76 61 6c 75  ression is evalu
6330: 61 74 65 64 20 6f 6e 63 65 20 62 65 66 6f 72 65  ated once before
6340: 20 61 6e 79 20 6f 74 68 65 72 20 70 72 6f 63 65   any other proce
6350: 73 73 69 6e 67 0a 69 73 20 70 65 72 66 6f 72 6d  ssing.is perform
6360: 65 64 2c 20 73 6f 20 6e 6f 6e 65 20 6f 66 20 74  ed, so none of t
6370: 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73 20 77  he expressions w
6380: 69 74 68 69 6e 20 74 68 65 20 73 65 6c 65 63 74  ithin the select
6390: 20 69 74 73 65 6c 66 20 63 61 6e 0a 72 65 66 65   itself can.refe
63a0: 72 20 74 6f 20 71 75 61 6e 74 69 74 69 65 73 20  r to quantities 
63b0: 69 6e 20 74 68 65 20 63 6f 6e 74 61 69 6e 69 6e  in the containin
63c0: 67 20 65 78 70 72 65 73 73 69 6f 6e 2e 3c 2f 70  g expression.</p
63d0: 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45 4c  >..<p>When a SEL
63e0: 45 43 54 20 69 73 20 74 68 65 20 72 69 67 68 74  ECT is the right
63f0: 20 6f 70 65 72 61 6e 64 20 6f 66 20 74 68 65 20   operand of the 
6400: 49 4e 20 6f 70 65 72 61 74 6f 72 2c 20 74 68 65  IN operator, the
6410: 20 49 4e 0a 6f 70 65 72 61 74 6f 72 20 72 65 74   IN.operator ret
6420: 75 72 6e 73 20 54 52 55 45 20 69 66 20 74 68 65  urns TRUE if the
6430: 20 72 65 73 75 6c 74 20 6f 66 20 74 68 65 20 6c   result of the l
6440: 65 66 74 20 6f 70 65 72 61 6e 64 20 69 73 20 61  eft operand is a
6450: 6e 79 20 6f 66 0a 74 68 65 20 76 61 6c 75 65 73  ny of.the values
6460: 20 67 65 6e 65 72 61 74 65 64 20 62 79 20 74 68   generated by th
6470: 65 20 73 65 6c 65 63 74 2e 20 20 54 68 65 20 49  e select.  The I
6480: 4e 20 6f 70 65 72 61 74 6f 72 20 6d 61 79 20 62  N operator may b
6490: 65 20 70 72 65 63 65 64 65 64 0a 62 79 20 74 68  e preceded.by th
64a0: 65 20 4e 4f 54 20 6b 65 79 77 6f 72 64 20 74 6f  e NOT keyword to
64b0: 20 69 6e 76 65 72 74 20 74 68 65 20 73 65 6e 73   invert the sens
64c0: 65 20 6f 66 20 74 68 65 20 74 65 73 74 2e 3c 2f  e of the test.</
64d0: 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 61 20 53 45  p>..<p>When a SE
64e0: 4c 45 43 54 20 61 70 70 65 61 72 73 20 77 69 74  LECT appears wit
64f0: 68 69 6e 20 61 6e 20 65 78 70 72 65 73 73 69 6f  hin an expressio
6500: 6e 20 62 75 74 20 69 73 20 6e 6f 74 20 74 68 65  n but is not the
6510: 20 72 69 67 68 74 0a 6f 70 65 72 61 6e 64 20 6f   right.operand o
6520: 66 20 61 6e 20 49 4e 20 6f 70 65 72 61 74 6f 72  f an IN operator
6530: 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 74  , then the first
6540: 20 72 6f 77 20 6f 66 20 74 68 65 20 72 65 73 75   row of the resu
6550: 6c 74 20 6f 66 20 74 68 65 0a 53 45 4c 45 43 54  lt of the.SELECT
6560: 20 62 65 63 6f 6d 65 73 20 74 68 65 20 76 61 6c   becomes the val
6570: 75 65 20 75 73 65 64 20 69 6e 20 74 68 65 20 65  ue used in the e
6580: 78 70 72 65 73 73 69 6f 6e 2e 20 20 49 66 20 74  xpression.  If t
6590: 68 65 20 53 45 4c 45 43 54 20 79 69 65 6c 64 73  he SELECT yields
65a0: 0a 6d 6f 72 65 20 74 68 61 6e 20 6f 6e 65 20 72  .more than one r
65b0: 65 73 75 6c 74 20 72 6f 77 2c 20 61 6c 6c 20 72  esult row, all r
65c0: 6f 77 73 20 61 66 74 65 72 20 74 68 65 20 66 69  ows after the fi
65d0: 72 73 74 20 61 72 65 20 69 67 6e 6f 72 65 64 2e  rst are ignored.
65e0: 20 20 49 66 0a 74 68 65 20 53 45 4c 45 43 54 20    If.the SELECT 
65f0: 79 65 69 6c 64 73 20 6e 6f 20 72 6f 77 73 2c 20  yeilds no rows, 
6600: 74 68 65 6e 20 74 68 65 20 76 61 6c 75 65 20 6f  then the value o
6610: 66 20 74 68 65 20 53 45 4c 45 43 54 20 69 73 20  f the SELECT is 
6620: 4e 55 4c 4c 2e 3c 2f 70 3e 0a 0a 3c 70 3e 42 6f  NULL.</p>..<p>Bo
6630: 74 68 20 73 69 6d 70 6c 65 20 61 6e 64 20 61 67  th simple and ag
6640: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
6650: 73 20 61 72 65 20 73 75 70 70 6f 72 74 65 64 2e  s are supported.
6660: 20 20 41 20 73 69 6d 70 6c 65 0a 66 75 6e 63 74    A simple.funct
6670: 69 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 20  ion can be used 
6680: 69 6e 20 61 6e 79 20 65 78 70 72 65 73 73 69 6f  in any expressio
6690: 6e 2e 20 20 53 69 6d 70 6c 65 20 66 75 6e 63 74  n.  Simple funct
66a0: 69 6f 6e 73 20 72 65 74 75 72 6e 0a 61 20 72 65  ions return.a re
66b0: 73 75 6c 74 20 69 6d 6d 65 64 69 61 74 65 6c 79  sult immediately
66c0: 20 62 61 73 65 64 20 6f 6e 20 74 68 65 69 72 20   based on their 
66d0: 69 6e 70 75 74 73 2e 20 20 41 67 67 72 65 67 61  inputs.  Aggrega
66e0: 74 65 20 66 75 6e 63 74 69 6f 6e 73 0a 6d 61 79  te functions.may
66f0: 20 6f 6e 6c 79 20 62 65 20 75 73 65 64 20 69 6e   only be used in
6700: 20 61 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d   a SELECT statem
6710: 65 6e 74 2e 20 20 41 67 67 72 65 67 61 74 65 20  ent.  Aggregate 
6720: 66 75 6e 63 74 69 6f 6e 73 20 63 6f 6d 70 75 74  functions comput
6730: 65 0a 74 68 65 69 72 20 72 65 73 75 6c 74 20 61  e.their result a
6740: 63 72 6f 73 73 20 61 6c 6c 20 72 6f 77 73 20 6f  cross all rows o
6750: 66 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74  f the result set
6760: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 66 75  .</p>..<p>The fu
6770: 6e 63 74 69 6f 6e 73 20 73 68 6f 77 6e 20 62 65  nctions shown be
6780: 6c 6f 77 20 61 72 65 20 61 76 61 69 6c 61 62 6c  low are availabl
6790: 65 20 62 79 20 64 65 66 61 75 6c 74 2e 20 20 41  e by default.  A
67a0: 64 64 69 74 69 6f 6e 61 6c 0a 66 75 6e 63 74 69  dditional.functi
67b0: 6f 6e 73 20 6d 61 79 20 62 65 20 77 72 69 74 74  ons may be writt
67c0: 65 6e 20 69 6e 20 43 20 61 6e 64 20 61 64 64 65  en in C and adde
67d0: 64 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73  d to the databas
67e0: 65 20 65 6e 67 69 6e 65 20 75 73 69 6e 67 0a 74  e engine using.t
67f0: 68 65 20 3c 61 20 68 72 65 66 3d 22 63 5f 69 6e  he <a href="c_in
6800: 74 65 72 66 61 63 65 2e 68 74 6d 6c 23 63 66 75  terface.html#cfu
6810: 6e 63 22 3e 73 71 6c 69 74 65 5f 63 72 65 61 74  nc">sqlite_creat
6820: 65 5f 66 75 6e 63 74 69 6f 6e 28 29 3c 2f 61 3e  e_function()</a>
6830: 0a 41 50 49 2e 3c 2f 70 3e 0a 0a 3c 74 61 62 6c  .API.</p>..<tabl
6840: 65 20 62 6f 72 64 65 72 3d 30 20 63 65 6c 6c 70  e border=0 cellp
6850: 61 64 64 69 6e 67 3d 31 30 3e 0a 3c 74 72 3e 0a  adding=10>.<tr>.
6860: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
6870: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 20 77   align="right" w
6880: 69 64 74 68 3d 31 32 30 3e 61 62 73 28 3c 69 3e  idth=120>abs(<i>
6890: 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20  X</i>)</td>.<td 
68a0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
68b0: 75 72 6e 20 74 68 65 20 61 62 73 6f 6c 75 74 65  urn the absolute
68c0: 20 76 61 6c 75 65 20 6f 66 20 61 72 67 75 6d 65   value of argume
68d0: 6e 74 20 3c 69 3e 58 3c 2f 69 3e 2e 3c 2f 74 64  nt <i>X</i>.</td
68e0: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
68f0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
6900: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 63 6f 61  lign="right">coa
6910: 6c 65 73 63 65 28 3c 69 3e 58 3c 2f 69 3e 2c 3c  lesce(<i>X</i>,<
6920: 69 3e 59 3c 2f 69 3e 2c 2e 2e 2e 29 3c 2f 74 64  i>Y</i>,...)</td
6930: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
6940: 70 22 3e 52 65 74 75 72 6e 20 61 20 63 6f 70 79  p">Return a copy
6950: 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 6e 6f   of the first no
6960: 6e 2d 4e 55 4c 4c 20 61 72 67 75 6d 65 6e 74 2e  n-NULL argument.
6970: 20 20 49 66 0a 61 6c 6c 20 61 72 67 75 6d 65 6e    If.all argumen
6980: 74 73 20 61 72 65 20 4e 55 4c 4c 20 74 68 65 6e  ts are NULL then
6990: 20 4e 55 4c 4c 20 69 73 20 72 65 74 75 72 6e 65   NULL is returne
69a0: 64 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c  d.</td>.</tr>..<
69b0: 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22  tr>.<td valign="
69c0: 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68  top" align="righ
69d0: 74 22 3e 67 6c 6f 62 28 3c 69 3e 58 3c 2f 69 3e  t">glob(<i>X</i>
69e0: 2c 3c 69 3e 59 3c 2f 69 3e 29 3c 2f 74 64 3e 0a  ,<i>Y</i>)</td>.
69f0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
6a00: 3e 54 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69  >This function i
6a10: 73 20 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d  s used to implem
6a20: 65 6e 74 20 74 68 65 0a 22 3c 62 3e 59 20 47 4c  ent the."<b>Y GL
6a30: 4f 42 20 58 3c 2f 62 3e 22 20 73 79 6e 74 61 78  OB X</b>" syntax
6a40: 20 6f 66 20 53 51 4c 69 74 65 2e 20 20 54 68 65   of SQLite.  The
6a50: 0a 3c 61 20 68 72 65 66 3d 22 63 5f 69 6e 74 65  .<a href="c_inte
6a60: 72 66 61 63 65 2e 68 74 6d 6c 23 63 66 75 6e 63  rface.html#cfunc
6a70: 22 3e 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f  ">sqlite_create_
6a80: 66 75 6e 63 74 69 6f 6e 28 29 3c 2f 61 3e 20 0a  function()</a> .
6a90: 69 6e 74 65 72 66 61 63 65 20 63 61 6e 0a 62 65  interface can.be
6aa0: 20 75 73 65 64 20 74 6f 20 6f 76 65 72 72 69 64   used to overrid
6ab0: 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  e this function 
6ac0: 61 6e 64 20 74 68 65 72 65 62 79 20 63 68 61 6e  and thereby chan
6ad0: 67 65 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e  ge the operation
6ae0: 0a 6f 66 20 74 68 65 20 47 4c 4f 42 20 6f 70 65  .of the GLOB ope
6af0: 72 61 74 6f 72 2e 3c 2f 74 64 3e 0a 3c 2f 74 72  rator.</td>.</tr
6b00: 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  >..<tr>.<td vali
6b10: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
6b20: 72 69 67 68 74 22 3e 6c 61 73 74 5f 69 6e 73 65  right">last_inse
6b30: 72 74 5f 72 6f 77 69 64 28 29 3c 2f 74 64 3e 0a  rt_rowid()</td>.
6b40: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
6b50: 3e 52 65 74 75 72 6e 20 74 68 65 20 52 4f 57 49  >Return the ROWI
6b60: 44 20 6f 66 20 74 68 65 20 6c 61 73 74 20 72 6f  D of the last ro
6b70: 77 20 69 6e 73 65 72 74 20 66 72 6f 6d 20 74 68  w insert from th
6b80: 69 73 0a 63 6f 6e 6e 65 63 74 69 6f 6e 20 74 6f  is.connection to
6b90: 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20 20   the database.  
6ba0: 54 68 69 73 20 69 73 20 74 68 65 20 73 61 6d 65  This is the same
6bb0: 20 76 61 6c 75 65 20 74 68 61 74 20 77 6f 75 6c   value that woul
6bc0: 64 20 62 65 20 72 65 74 75 72 6e 65 64 0a 66 72  d be returned.fr
6bd0: 6f 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65  om the <b>sqlite
6be0: 5f 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f 77  _last_insert_row
6bf0: 69 64 28 29 3c 2f 62 3e 20 41 50 49 20 66 75 6e  id()</b> API fun
6c00: 63 74 69 6f 6e 2e 3c 2f 74 64 3e 0a 3c 2f 74 72  ction.</td>.</tr
6c10: 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  >..<tr>.<td vali
6c20: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
6c30: 72 69 67 68 74 22 3e 6c 65 6e 67 74 68 28 3c 69  right">length(<i
6c40: 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64  >X</i>)</td>.<td
6c50: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65   valign="top">Re
6c60: 74 75 72 6e 20 74 68 65 20 73 74 72 69 6e 67 20  turn the string 
6c70: 6c 65 6e 67 74 68 20 6f 66 20 3c 69 3e 58 3c 2f  length of <i>X</
6c80: 69 3e 20 69 6e 20 63 68 61 72 61 63 74 65 72 73  i> in characters
6c90: 2e 0a 49 66 20 53 51 4c 69 74 65 20 69 73 20 63  ..If SQLite is c
6ca0: 6f 6e 66 69 67 75 72 65 64 20 74 6f 20 73 75 70  onfigured to sup
6cb0: 70 6f 72 74 20 55 54 46 2d 38 2c 20 74 68 65 6e  port UTF-8, then
6cc0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 55   the number of U
6cd0: 54 46 2d 38 0a 63 68 61 72 61 63 74 65 72 73 20  TF-8.characters 
6ce0: 69 73 20 72 65 74 75 72 6e 65 64 2c 20 6e 6f 74  is returned, not
6cf0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 62   the number of b
6d00: 79 74 65 73 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e  ytes.</td>.</tr>
6d10: 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67  ..<tr>.<td valig
6d20: 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72  n="top" align="r
6d30: 69 67 68 74 22 3e 6c 69 6b 65 28 3c 69 3e 58 3c  ight">like(<i>X<
6d40: 2f 69 3e 2c 3c 69 3e 59 3c 2f 69 3e 29 3c 2f 74  /i>,<i>Y</i>)</t
6d50: 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  d>.<td valign="t
6d60: 6f 70 22 3e 54 68 69 73 20 66 75 6e 63 74 69 6f  op">This functio
6d70: 6e 20 69 73 20 75 73 65 64 20 74 6f 20 69 6d 70  n is used to imp
6d80: 6c 65 6d 65 6e 74 20 74 68 65 0a 22 3c 62 3e 59  lement the."<b>Y
6d90: 20 4c 49 4b 45 20 58 3c 2f 62 3e 22 20 73 79 6e   LIKE X</b>" syn
6da0: 74 61 78 20 6f 66 20 53 51 4c 2e 20 20 54 68 65  tax of SQL.  The
6db0: 0a 3c 61 20 68 72 65 66 3d 22 63 5f 69 6e 74 65  .<a href="c_inte
6dc0: 72 66 61 63 65 2e 68 74 6d 6c 23 63 66 75 6e 63  rface.html#cfunc
6dd0: 22 3e 73 71 6c 69 74 65 5f 63 72 65 61 74 65 5f  ">sqlite_create_
6de0: 66 75 6e 63 74 69 6f 6e 28 29 3c 2f 61 3e 20 0a  function()</a> .
6df0: 69 6e 74 65 72 66 61 63 65 20 63 61 6e 0a 62 65  interface can.be
6e00: 20 75 73 65 64 20 74 6f 20 6f 76 65 72 72 69 64   used to overrid
6e10: 65 20 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20  e this function 
6e20: 61 6e 64 20 74 68 65 72 65 62 79 20 63 68 61 6e  and thereby chan
6e30: 67 65 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e  ge the operation
6e40: 0a 6f 66 20 74 68 65 20 4c 49 4b 45 20 6f 70 65  .of the LIKE ope
6e50: 72 61 74 6f 72 2e 3c 2f 74 64 3e 0a 3c 2f 74 72  rator.</td>.</tr
6e60: 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  >..<tr>.<td vali
6e70: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
6e80: 72 69 67 68 74 22 3e 6c 6f 77 65 72 28 3c 69 3e  right">lower(<i>
6e90: 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20  X</i>)</td>.<td 
6ea0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
6eb0: 75 72 6e 20 61 20 63 6f 70 79 20 6f 66 20 73 74  urn a copy of st
6ec0: 72 69 6e 67 20 3c 69 3e 58 3c 2f 69 3e 20 77 69  ring <i>X</i> wi
6ed0: 6c 6c 20 61 6c 6c 20 63 68 61 72 61 63 74 65 72  ll all character
6ee0: 73 0a 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 6c  s.converted to l
6ef0: 6f 77 65 72 20 63 61 73 65 2e 20 20 54 68 65 20  ower case.  The 
6f00: 43 20 6c 69 62 72 61 72 79 20 3c 62 3e 74 6f 6c  C library <b>tol
6f10: 6f 77 65 72 28 29 3c 2f 62 3e 20 72 6f 75 74 69  ower()</b> routi
6f20: 6e 65 20 69 73 20 75 73 65 64 0a 66 6f 72 20 74  ne is used.for t
6f30: 68 65 20 63 6f 6e 76 65 72 73 69 6f 6e 2c 20 77  he conversion, w
6f40: 68 69 63 68 20 6d 65 61 6e 73 20 74 68 61 74 20  hich means that 
6f50: 74 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 6d 69  this function mi
6f60: 67 68 74 20 6e 6f 74 0a 77 6f 72 6b 20 63 6f 72  ght not.work cor
6f70: 72 65 63 74 6c 79 20 6f 6e 20 55 54 46 2d 38 20  rectly on UTF-8 
6f80: 63 68 61 72 61 63 74 65 72 73 2e 3c 2f 74 64 3e  characters.</td>
6f90: 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64  .</tr>..<tr>.<td
6fa0: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c   valign="top" al
6fb0: 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d 61 78 28  ign="right">max(
6fc0: 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c 2f 69  <i>X</i>,<i>Y</i
6fd0: 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e 0a 3c 74 64 20  >,...)</td>.<td 
6fe0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
6ff0: 75 72 6e 20 74 68 65 20 61 72 67 75 6d 65 6e 74  urn the argument
7000: 20 77 69 74 68 20 74 68 65 20 6d 61 78 69 6d 75   with the maximu
7010: 6d 20 76 61 6c 75 65 2e 20 20 41 72 67 75 6d 65  m value.  Argume
7020: 6e 74 73 0a 6d 61 79 20 62 65 20 73 74 72 69 6e  nts.may be strin
7030: 67 73 20 69 6e 20 61 64 64 69 74 69 6f 6e 20 74  gs in addition t
7040: 6f 20 6e 75 6d 62 65 72 73 2e 20 20 54 68 65 20  o numbers.  The 
7050: 6d 61 78 69 6d 75 6d 20 76 61 6c 75 65 20 69 73  maximum value is
7060: 20 64 65 74 65 72 6d 69 6e 65 64 0a 62 79 20 74   determined.by t
7070: 68 65 20 75 73 75 61 6c 20 73 6f 72 74 20 6f 72  he usual sort or
7080: 64 65 72 2e 20 20 4e 6f 74 65 20 74 68 61 74 20  der.  Note that 
7090: 3c 62 3e 6d 61 78 28 29 3c 2f 62 3e 20 69 73 20  <b>max()</b> is 
70a0: 61 20 73 69 6d 70 6c 65 20 66 75 6e 63 74 69 6f  a simple functio
70b0: 6e 20 77 68 65 6e 0a 69 74 20 68 61 73 20 32 20  n when.it has 2 
70c0: 6f 72 20 6d 6f 72 65 20 61 72 67 75 6d 65 6e 74  or more argument
70d0: 73 20 62 75 74 20 63 6f 6e 76 65 72 74 73 20 74  s but converts t
70e0: 6f 20 61 6e 20 61 67 67 72 65 67 61 74 65 20 66  o an aggregate f
70f0: 75 6e 63 74 69 6f 6e 20 69 66 20 67 69 76 65 6e  unction if given
7100: 0a 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 61  .only a single a
7110: 72 67 75 6d 65 6e 74 2e 3c 2f 74 64 3e 0a 3c 2f  rgument.</td>.</
7120: 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  tr>..<tr>.<td va
7130: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
7140: 3d 22 72 69 67 68 74 22 3e 6d 69 6e 28 3c 69 3e  ="right">min(<i>
7150: 58 3c 2f 69 3e 2c 3c 69 3e 59 3c 2f 69 3e 2c 2e  X</i>,<i>Y</i>,.
7160: 2e 2e 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c  ..)</td>.<td val
7170: 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e  ign="top">Return
7180: 20 74 68 65 20 61 72 67 75 6d 65 6e 74 20 77 69   the argument wi
7190: 74 68 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20 76  th the minimum v
71a0: 61 6c 75 65 2e 20 20 41 72 67 75 6d 65 6e 74 73  alue.  Arguments
71b0: 0a 6d 61 79 20 62 65 20 73 74 72 69 6e 67 73 20  .may be strings 
71c0: 69 6e 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 6e  in addition to n
71d0: 75 6d 62 65 72 73 2e 20 20 54 68 65 20 6d 6d 69  umbers.  The mmi
71e0: 6e 69 6d 75 6d 20 76 61 6c 75 65 20 69 73 20 64  nimum value is d
71f0: 65 74 65 72 6d 69 6e 65 64 0a 62 79 20 74 68 65  etermined.by the
7200: 20 75 73 75 61 6c 20 73 6f 72 74 20 6f 72 64 65   usual sort orde
7210: 72 2e 20 20 4e 6f 74 65 20 74 68 61 74 20 3c 62  r.  Note that <b
7220: 3e 6d 69 6e 28 29 3c 2f 62 3e 20 69 73 20 61 20  >min()</b> is a 
7230: 73 69 6d 70 6c 65 20 66 75 6e 63 74 69 6f 6e 20  simple function 
7240: 77 68 65 6e 0a 69 74 20 68 61 73 20 32 20 6f 72  when.it has 2 or
7250: 20 6d 6f 72 65 20 61 72 67 75 6d 65 6e 74 73 20   more arguments 
7260: 62 75 74 20 63 6f 6e 76 65 72 74 73 20 74 6f 20  but converts to 
7270: 61 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 6e  an aggregate fun
7280: 63 74 69 6f 6e 20 69 66 20 67 69 76 65 6e 0a 6f  ction if given.o
7290: 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 61 72 67  nly a single arg
72a0: 75 6d 65 6e 74 2e 3c 2f 74 64 3e 0a 3c 2f 74 72  ument.</td>.</tr
72b0: 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  >..<tr>.<td vali
72c0: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
72d0: 72 69 67 68 74 22 3e 72 61 6e 64 6f 6d 28 2a 29  right">random(*)
72e0: 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e  </td>.<td valign
72f0: 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 61 20  ="top">Return a 
7300: 72 61 6e 64 6f 6d 20 69 6e 74 65 67 65 72 20 62  random integer b
7310: 65 74 77 65 65 6e 20 2d 32 31 34 37 34 38 33 36  etween -21474836
7320: 34 38 20 61 6e 64 0a 2b 32 31 34 37 34 38 33 36  48 and.+21474836
7330: 34 37 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a  47.</td>.</tr>..
7340: 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d  <tr>.<td valign=
7350: 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67  "top" align="rig
7360: 68 74 22 3e 72 6f 75 6e 64 28 3c 69 3e 58 3c 2f  ht">round(<i>X</
7370: 69 3e 29 3c 62 72 3e 72 6f 75 6e 64 28 3c 69 3e  i>)<br>round(<i>
7380: 58 3c 2f 69 3e 2c 3c 69 3e 59 3c 2f 69 3e 29 3c  X</i>,<i>Y</i>)<
7390: 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d  /td>.<td valign=
73a0: 22 74 6f 70 22 3e 52 6f 75 6e 64 20 6f 66 66 20  "top">Round off 
73b0: 74 68 65 20 6e 75 6d 62 65 72 20 3c 69 3e 58 3c  the number <i>X<
73c0: 2f 69 3e 20 74 6f 20 3c 69 3e 59 3c 2f 69 3e 20  /i> to <i>Y</i> 
73d0: 64 69 67 69 74 73 20 74 6f 20 74 68 65 0a 72 69  digits to the.ri
73e0: 67 68 74 20 6f 66 20 74 68 65 20 64 65 63 69 6d  ght of the decim
73f0: 61 6c 20 70 6f 69 6e 74 2e 20 20 49 66 20 74 68  al point.  If th
7400: 65 20 3c 69 3e 59 3c 2f 69 3e 20 61 72 67 75 6d  e <i>Y</i> argum
7410: 65 6e 74 20 69 73 20 6f 6d 69 74 74 65 64 2c 20  ent is omitted, 
7420: 30 20 69 73 20 0a 61 73 73 75 6d 65 64 2e 3c 2f  0 is .assumed.</
7430: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
7440: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7450: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 73   align="right">s
7460: 75 62 73 74 72 28 3c 69 3e 58 3c 2f 69 3e 2c 3c  ubstr(<i>X</i>,<
7470: 69 3e 59 3c 2f 69 3e 2c 3c 69 3e 5a 3c 2f 69 3e  i>Y</i>,<i>Z</i>
7480: 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67  )</td>.<td valig
7490: 6e 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 61  n="top">Return a
74a0: 20 73 75 62 73 74 72 69 6e 67 20 6f 66 20 69 6e   substring of in
74b0: 70 75 74 20 73 74 72 69 6e 67 20 3c 69 3e 58 3c  put string <i>X<
74c0: 2f 69 3e 20 74 68 61 74 20 62 65 67 69 6e 73 0a  /i> that begins.
74d0: 77 69 74 68 20 74 68 65 20 3c 69 3e 59 3c 2f 69  with the <i>Y</i
74e0: 3e 2d 74 68 20 63 68 61 72 61 63 74 65 72 20 61  >-th character a
74f0: 6e 64 20 77 68 69 63 68 20 69 73 20 3c 69 3e 5a  nd which is <i>Z
7500: 3c 2f 69 3e 20 63 68 61 72 61 63 74 65 72 73 20  </i> characters 
7510: 6c 6f 6e 67 2e 0a 54 68 65 20 6c 65 66 74 2d 6d  long..The left-m
7520: 6f 73 74 20 63 68 61 72 61 63 74 65 72 20 6f 66  ost character of
7530: 20 3c 69 3e 58 3c 2f 69 3e 20 69 73 20 6e 75 6d   <i>X</i> is num
7540: 62 65 72 20 31 2e 20 20 49 66 20 3c 69 3e 59 3c  ber 1.  If <i>Y<
7550: 2f 69 3e 20 69 73 20 6e 65 67 61 74 69 76 65 0a  /i> is negative.
7560: 74 68 65 20 74 68 65 20 66 69 72 73 74 20 63 68  the the first ch
7570: 61 72 61 63 74 65 72 20 6f 66 20 74 68 65 20 73  aracter of the s
7580: 75 62 73 74 72 69 6e 67 20 69 73 20 66 6f 75 6e  ubstring is foun
7590: 64 20 62 79 20 63 6f 75 6e 74 69 6e 67 20 66 72  d by counting fr
75a0: 6f 6d 20 74 68 65 0a 72 69 67 68 74 20 72 61 74  om the.right rat
75b0: 68 65 72 20 74 68 61 6e 20 74 68 65 20 6c 65 66  her than the lef
75c0: 74 2e 20 20 49 66 20 53 51 4c 69 74 65 20 69 73  t.  If SQLite is
75d0: 20 63 6f 6e 66 69 67 75 72 65 64 20 74 6f 20 73   configured to s
75e0: 75 70 70 6f 72 74 20 55 54 46 2d 38 2c 0a 74 68  upport UTF-8,.th
75f0: 65 6e 20 63 68 61 72 61 63 74 65 72 73 20 69 6e  en characters in
7600: 64 69 63 65 73 20 72 65 66 65 72 20 74 6f 20 61  dices refer to a
7610: 63 74 75 61 6c 20 55 54 46 2d 38 20 63 68 61 72  ctual UTF-8 char
7620: 61 63 74 65 72 73 2c 20 6e 6f 74 20 62 79 74 65  acters, not byte
7630: 73 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c  s.</td>.</tr>..<
7640: 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22  tr>.<td valign="
7650: 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68  top" align="righ
7660: 74 22 3e 75 70 70 65 72 28 3c 69 3e 58 3c 2f 69  t">upper(<i>X</i
7670: 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69  >)</td>.<td vali
7680: 67 6e 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20  gn="top">Return 
7690: 61 20 63 6f 70 79 20 6f 66 20 69 6e 70 75 74 20  a copy of input 
76a0: 73 74 72 69 6e 67 20 3c 69 3e 58 3c 2f 69 3e 20  string <i>X</i> 
76b0: 63 6f 6e 76 65 72 74 65 64 20 74 6f 20 61 6c 6c  converted to all
76c0: 0a 75 70 70 65 72 2d 63 61 73 65 20 6c 65 74 74  .upper-case lett
76d0: 65 72 73 2e 20 20 54 68 65 20 69 6d 70 6c 65 6d  ers.  The implem
76e0: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 69 73  entation of this
76f0: 20 66 75 6e 63 74 69 6f 6e 20 75 73 65 73 20 74   function uses t
7700: 68 65 20 43 20 6c 69 62 72 61 72 79 0a 72 6f 75  he C library.rou
7710: 74 69 6e 65 20 3c 62 3e 74 6f 75 70 70 65 72 28  tine <b>toupper(
7720: 29 3c 2f 62 3e 20 77 68 69 63 68 20 6d 65 61 6e  )</b> which mean
7730: 73 20 69 74 20 6d 61 79 20 6e 6f 74 20 77 6f 72  s it may not wor
7740: 6b 20 63 6f 72 72 65 63 74 6c 79 20 6f 6e 20 0a  k correctly on .
7750: 55 54 46 2d 38 20 73 74 72 69 6e 67 73 2e 3c 2f  UTF-8 strings.</
7760: 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 2f 74 61 62 6c  td>.</tr>.</tabl
7770: 65 3e 0a 0a 3c 70 3e 0a 54 68 65 20 66 6f 6c 6c  e>..<p>.The foll
7780: 6f 77 69 6e 67 20 61 67 67 72 65 67 61 74 65 20  owing aggregate 
7790: 66 75 6e 63 74 69 6f 6e 73 20 61 72 65 20 61 76  functions are av
77a0: 61 69 6c 61 62 6c 65 20 62 79 20 64 65 66 61 75  ailable by defau
77b0: 6c 74 2e 20 20 41 64 64 69 74 69 6f 6e 61 6c 0a  lt.  Additional.
77c0: 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69  aggregate functi
77d0: 6f 6e 73 20 77 72 69 74 74 65 6e 20 69 6e 20 43  ons written in C
77e0: 20 6d 61 79 20 62 65 20 61 64 64 65 64 20 75 73   may be added us
77f0: 69 6e 67 20 74 68 65 20 0a 3c 61 20 68 72 65 66  ing the .<a href
7800: 3d 22 63 5f 69 6e 74 65 72 66 61 63 65 2e 68 74  ="c_interface.ht
7810: 6d 6c 23 63 66 75 6e 63 22 3e 73 71 6c 69 74 65  ml#cfunc">sqlite
7820: 5f 63 72 65 61 74 65 5f 61 67 67 72 65 67 61 74  _create_aggregat
7830: 65 28 29 3c 2f 61 3e 20 41 50 49 2e 3c 2f 70 3e  e()</a> API.</p>
7840: 0a 0a 3c 74 61 62 6c 65 20 62 6f 72 64 65 72 3d  ..<table border=
7850: 30 20 63 65 6c 6c 70 61 64 64 69 6e 67 3d 31 30  0 cellpadding=10
7860: 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67  >.<tr>.<td valig
7870: 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72  n="top" align="r
7880: 69 67 68 74 22 20 77 69 64 74 68 3d 31 32 30 3e  ight" width=120>
7890: 61 76 67 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74  avg(<i>X</i>)</t
78a0: 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  d>.<td valign="t
78b0: 6f 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20 61  op">Return the a
78c0: 76 65 72 61 67 65 20 76 61 6c 75 65 20 6f 66 20  verage value of 
78d0: 61 6c 6c 20 3c 69 3e 58 3c 2f 69 3e 20 77 69 74  all <i>X</i> wit
78e0: 68 69 6e 20 61 20 67 72 6f 75 70 2e 3c 2f 74 64  hin a group.</td
78f0: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
7900: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
7910: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 63 6f 75  lign="right">cou
7920: 6e 74 28 3c 69 3e 58 3c 2f 69 3e 29 3c 62 72 3e  nt(<i>X</i>)<br>
7930: 63 6f 75 6e 74 28 2a 29 3c 2f 74 64 3e 0a 3c 74  count(*)</td>.<t
7940: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 54  d valign="top">T
7950: 68 65 20 66 69 72 73 74 20 66 6f 72 6d 20 72 65  he first form re
7960: 74 75 72 6e 20 61 20 63 6f 75 6e 74 20 6f 66 20  turn a count of 
7970: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 74 69  the number of ti
7980: 6d 65 73 0a 74 68 61 74 20 3c 69 3e 58 3c 2f 69  mes.that <i>X</i
7990: 3e 20 69 73 20 6e 6f 74 20 4e 55 4c 4c 20 69 6e  > is not NULL in
79a0: 20 61 20 67 72 6f 75 70 2e 20 20 54 68 65 20 73   a group.  The s
79b0: 65 63 6f 6e 64 20 66 6f 72 6d 20 28 77 69 74 68  econd form (with
79c0: 20 6e 6f 20 61 72 67 75 6d 65 6e 74 29 0a 72 65   no argument).re
79d0: 74 75 72 6e 73 20 74 68 65 20 74 6f 74 61 6c 20  turns the total 
79e0: 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 69  number of rows i
79f0: 6e 20 74 68 65 20 67 72 6f 75 70 2e 3c 2f 74 64  n the group.</td
7a00: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
7a10: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
7a20: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d 61 78  lign="right">max
7a30: 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a  (<i>X</i>)</td>.
7a40: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7a50: 3e 52 65 74 75 72 6e 20 74 68 65 20 6d 61 78 69  >Return the maxi
7a60: 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20 61 6c 6c  mum value of all
7a70: 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 67   values in the g
7a80: 72 6f 75 70 2e 0a 54 68 65 20 75 73 75 61 6c 20  roup..The usual 
7a90: 73 6f 72 74 20 6f 72 64 65 72 20 69 73 20 75 73  sort order is us
7aa0: 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20  ed to determine 
7ab0: 74 68 65 20 6d 61 78 69 6d 75 6d 2e 3c 2f 74 64  the maximum.</td
7ac0: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
7ad0: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
7ae0: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 6d 69 6e  lign="right">min
7af0: 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a  (<i>X</i>)</td>.
7b00: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7b10: 3e 52 65 74 75 72 6e 20 74 68 65 20 6d 69 6e 69  >Return the mini
7b20: 6d 75 6d 20 76 61 6c 75 65 20 6f 66 20 61 6c 6c  mum value of all
7b30: 20 76 61 6c 75 65 73 20 69 6e 20 74 68 65 20 67   values in the g
7b40: 72 6f 75 70 2e 0a 54 68 65 20 75 73 75 61 6c 20  roup..The usual 
7b50: 73 6f 72 74 20 6f 72 64 65 72 20 69 73 20 75 73  sort order is us
7b60: 65 64 20 74 6f 20 64 65 74 65 72 6d 69 6e 65 20  ed to determine 
7b70: 74 68 65 20 6d 69 6e 69 6d 75 6d 2e 3c 2f 74 64  the minimum.</td
7b80: 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74  >.</tr>..<tr>.<t
7b90: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
7ba0: 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 73 75 6d  lign="right">sum
7bb0: 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a  (<i>X</i>)</td>.
7bc0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7bd0: 3e 52 65 74 75 72 6e 20 74 68 65 20 6e 75 6d 65  >Return the nume
7be0: 72 69 63 20 73 75 6d 20 6f 66 20 61 6c 6c 20 76  ric sum of all v
7bf0: 61 6c 75 65 73 20 69 6e 20 74 68 65 20 67 72 6f  alues in the gro
7c00: 75 70 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c  up.</td>.</tr>.<
7c10: 2f 74 61 62 6c 65 3e 0a 7d 0a 0a 53 65 63 74 69  /table>.}..Secti
7c20: 6f 6e 20 49 4e 53 45 52 54 20 69 6e 73 65 72 74  on INSERT insert
7c30: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
7c40: 61 74 65 6d 65 6e 74 7d 20 7b 0a 49 4e 53 45 52  atement} {.INSER
7c50: 54 20 5b 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d  T [OR <conflict-
7c60: 61 6c 67 6f 72 69 74 68 6d 3e 5d 20 49 4e 54 4f  algorithm>] INTO
7c70: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28   <table-name> [(
7c80: 3c 63 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 29 5d 20  <column-list>)] 
7c90: 56 41 4c 55 45 53 28 3c 76 61 6c 75 65 2d 6c 69  VALUES(<value-li
7ca0: 73 74 3e 29 20 7c 0a 49 4e 53 45 52 54 20 5b 4f  st>) |.INSERT [O
7cb0: 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f  R <conflict-algo
7cc0: 72 69 74 68 6d 3e 5d 20 49 4e 54 4f 20 3c 74 61  rithm>] INTO <ta
7cd0: 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 3c 63 6f 6c  ble-name> [(<col
7ce0: 75 6d 6e 2d 6c 69 73 74 3e 29 5d 20 3c 73 65 6c  umn-list>)] <sel
7cf0: 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 0a 7d  ect-statement>.}
7d00: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
7d10: 49 4e 53 45 52 54 20 73 74 61 74 65 6d 65 6e 74  INSERT statement
7d20: 20 63 6f 6d 65 73 20 69 6e 20 74 77 6f 20 62 61   comes in two ba
7d30: 73 69 63 20 66 6f 72 6d 73 2e 20 20 54 68 65 20  sic forms.  The 
7d40: 66 69 72 73 74 20 66 6f 72 6d 0a 28 77 69 74 68  first form.(with
7d50: 20 74 68 65 20 22 56 41 4c 55 45 53 22 20 6b 65   the "VALUES" ke
7d60: 79 77 6f 72 64 29 20 63 72 65 61 74 65 73 20 61  yword) creates a
7d70: 20 73 69 6e 67 6c 65 20 6e 65 77 20 72 6f 77 20   single new row 
7d80: 69 6e 20 61 6e 20 65 78 69 73 74 69 6e 67 20 74  in an existing t
7d90: 61 62 6c 65 2e 0a 49 66 20 6e 6f 20 63 6f 6c 75  able..If no colu
7da0: 6d 6e 2d 6c 69 73 74 20 69 73 20 73 70 65 63 69  mn-list is speci
7db0: 66 69 65 64 20 74 68 65 6e 20 74 68 65 20 6e 75  fied then the nu
7dc0: 6d 62 65 72 20 6f 66 20 76 61 6c 75 65 73 20 6d  mber of values m
7dd0: 75 73 74 0a 62 65 20 74 68 65 20 73 61 6d 65 20  ust.be the same 
7de0: 61 73 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66  as the number of
7df0: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20   columns in the 
7e00: 74 61 62 6c 65 2e 20 20 49 66 20 61 20 63 6f 6c  table.  If a col
7e10: 75 6d 6e 2d 6c 69 73 74 0a 69 73 20 73 70 65 63  umn-list.is spec
7e20: 69 66 69 65 64 2c 20 74 68 65 6e 20 74 68 65 20  ified, then the 
7e30: 6e 75 6d 62 65 72 20 6f 66 20 76 61 6c 75 65 73  number of values
7e40: 20 6d 75 73 74 20 6d 61 74 63 68 20 74 68 65 20   must match the 
7e50: 6e 75 6d 62 65 72 20 6f 66 0a 73 70 65 63 69 66  number of.specif
7e60: 69 65 64 20 63 6f 6c 75 6d 6e 73 2e 20 20 43 6f  ied columns.  Co
7e70: 6c 75 6d 6e 73 20 6f 66 20 74 68 65 20 74 61 62  lumns of the tab
7e80: 6c 65 20 74 68 61 74 20 64 6f 20 6e 6f 74 20 61  le that do not a
7e90: 70 70 65 61 72 20 69 6e 20 74 68 65 0a 63 6f 6c  ppear in the.col
7ea0: 75 6d 6e 20 6c 69 73 74 20 61 72 65 20 66 69 6c  umn list are fil
7eb0: 6c 20 77 69 74 68 20 74 68 65 20 64 65 66 61 75  l with the defau
7ec0: 6c 74 20 76 61 6c 75 65 2c 20 6f 72 20 77 69 74  lt value, or wit
7ed0: 68 20 4e 55 4c 4c 20 69 66 20 6e 6f 74 0a 64 65  h NULL if not.de
7ee0: 66 61 75 6c 74 20 76 61 6c 75 65 20 69 73 20 73  fault value is s
7ef0: 70 65 63 69 66 69 65 64 2e 0a 3c 2f 70 3e 0a 0a  pecified..</p>..
7f00: 3c 70 3e 54 68 65 20 73 65 63 6f 6e 64 20 66 6f  <p>The second fo
7f10: 72 6d 20 6f 66 20 74 68 65 20 49 4e 53 45 52 54  rm of the INSERT
7f20: 20 73 74 61 74 65 6d 65 6e 74 20 74 61 6b 65 73   statement takes
7f30: 20 69 74 20 64 61 74 61 20 66 72 6f 6d 20 61 0a   it data from a.
7f40: 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74  SELECT statement
7f50: 2e 20 20 54 68 65 20 6e 75 6d 62 65 72 20 6f 66  .  The number of
7f60: 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20   columns in the 
7f70: 72 65 73 75 6c 74 20 6f 66 20 74 68 65 0a 53 45  result of the.SE
7f80: 4c 45 43 54 20 6d 75 73 74 20 65 78 61 63 74 6c  LECT must exactl
7f90: 79 20 6d 61 74 63 68 20 74 68 65 20 6e 75 6d 62  y match the numb
7fa0: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e  er of columns in
7fb0: 20 74 68 65 20 74 61 62 6c 65 20 69 66 0a 6e 6f   the table if.no
7fc0: 20 63 6f 6c 75 6d 6e 20 6c 69 73 74 20 69 73 20   column list is 
7fd0: 73 70 65 63 69 66 69 65 64 2c 20 6f 72 20 69 74  specified, or it
7fe0: 20 6d 75 73 74 20 6d 61 74 63 68 20 74 68 65 20   must match the 
7ff0: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e  number of column
8000: 73 0a 6e 61 6d 65 20 69 6e 20 74 68 65 20 63 6f  s.name in the co
8010: 6c 75 6d 6e 20 6c 69 73 74 2e 20 20 41 20 6e 65  lumn list.  A ne
8020: 77 20 65 6e 74 72 79 20 69 73 20 6d 61 64 65 20  w entry is made 
8030: 69 6e 20 74 68 65 20 74 61 62 6c 65 0a 66 6f 72  in the table.for
8040: 20 65 76 65 72 79 20 72 6f 77 20 6f 66 20 74 68   every row of th
8050: 65 20 53 45 4c 45 43 54 20 72 65 73 75 6c 74 2e  e SELECT result.
8060: 20 20 54 68 65 20 53 45 4c 45 43 54 20 6d 61 79    The SELECT may
8070: 20 62 65 20 73 69 6d 70 6c 65 0a 6f 72 20 63 6f   be simple.or co
8080: 6d 70 6f 75 6e 64 2e 20 20 49 66 20 74 68 65 20  mpound.  If the 
8090: 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74  SELECT statement
80a0: 20 68 61 73 20 61 6e 20 4f 52 44 45 52 20 42 59   has an ORDER BY
80b0: 20 63 6c 61 75 73 65 2c 0a 74 68 65 20 4f 52 44   clause,.the ORD
80c0: 45 52 20 42 59 20 69 73 20 69 67 6e 6f 72 65 64  ER BY is ignored
80d0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70  .</p>..<p>The op
80e0: 74 69 6f 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d  tional conflict-
80f0: 63 6c 61 75 73 65 20 61 6c 6c 6f 77 73 20 74 68  clause allows th
8100: 65 20 73 70 65 63 69 66 69 63 61 74 69 6f 6e 20  e specification 
8110: 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61 74 69 76  of an alternativ
8120: 65 0a 63 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e  e.constraint con
8130: 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e  flict resolution
8140: 20 61 6c 67 6f 72 69 74 68 6d 20 74 6f 20 75 73   algorithm to us
8150: 65 20 64 75 72 69 6e 67 20 74 68 69 73 20 6f 6e  e during this on
8160: 65 20 63 6f 6d 6d 61 6e 64 2e 0a 53 65 65 20 74  e command..See t
8170: 68 65 20 73 65 63 74 69 6f 6e 20 74 69 74 6c 65  he section title
8180: 64 0a 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e 66  d.<a href="#conf
8190: 6c 69 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43  lict">ON CONFLIC
81a0: 54 3c 2f 61 3e 20 66 6f 72 20 61 64 64 69 74 69  T</a> for additi
81b0: 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e  onal information
81c0: 2e 0a 46 6f 72 20 63 6f 6d 70 61 74 69 62 69 6c  ..For compatibil
81d0: 69 74 79 20 77 69 74 68 20 4d 79 53 51 4c 2c 20  ity with MySQL, 
81e0: 74 68 65 20 70 61 72 73 65 72 20 61 6c 6c 6f 77  the parser allow
81f0: 73 20 74 68 65 20 75 73 65 20 6f 66 20 74 68 65  s the use of the
8200: 0a 73 69 6e 67 6c 65 20 6b 65 79 77 6f 72 64 20  .single keyword 
8210: 22 52 45 50 4c 41 43 45 22 20 61 73 20 61 6e 20  "REPLACE" as an 
8220: 61 6c 69 61 73 20 66 6f 72 20 22 49 4e 53 45 52  alias for "INSER
8230: 54 20 4f 52 20 52 45 50 4c 41 43 45 22 2e 0a 3c  T OR REPLACE"..<
8240: 2f 70 3e 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 7b  /p>.}..Section {
8250: 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75  ON CONFLICT clau
8260: 73 65 7d 20 63 6f 6e 66 6c 69 63 74 0a 0a 53 79  se} conflict..Sy
8270: 6e 74 61 78 20 7b 63 6f 6e 66 6c 69 63 74 2d 63  ntax {conflict-c
8280: 6c 61 75 73 65 7d 20 7b 0a 4f 4e 20 43 4f 4e 46  lause} {.ON CONF
8290: 4c 49 43 54 20 3c 63 6f 6e 66 6c 69 63 74 2d 61  LICT <conflict-a
82a0: 6c 67 6f 72 69 74 68 6d 3e 0a 7d 20 7b 63 6f 6e  lgorithm>.} {con
82b0: 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d 7d  flict-algorithm}
82c0: 20 7b 0a 52 4f 4c 4c 42 41 43 4b 20 7c 20 41 42   {.ROLLBACK | AB
82d0: 4f 52 54 20 7c 20 46 41 49 4c 20 7c 20 49 47 4e  ORT | FAIL | IGN
82e0: 4f 52 45 20 7c 20 52 45 50 4c 41 43 45 0a 7d 0a  ORE | REPLACE.}.
82f0: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 4f  .puts {.<p>The O
8300: 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73  N CONFLICT claus
8310: 65 20 69 73 20 6e 6f 74 20 61 20 73 65 70 61 72  e is not a separ
8320: 61 74 65 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e  ate SQL command.
8330: 20 20 49 74 20 69 73 20 61 0a 6e 6f 6e 2d 73 74    It is a.non-st
8340: 61 6e 64 61 72 64 20 63 6c 61 75 73 65 20 74 68  andard clause th
8350: 61 74 20 63 61 6e 20 61 70 70 65 61 72 20 69 6e  at can appear in
8360: 20 6d 61 6e 79 20 6f 74 68 65 72 20 53 51 4c 20   many other SQL 
8370: 63 6f 6d 6d 61 6e 64 73 2e 0a 49 74 20 69 73 20  commands..It is 
8380: 67 69 76 65 6e 20 69 74 73 20 6f 77 6e 20 73 65  given its own se
8390: 63 74 69 6f 6e 20 69 6e 20 74 68 69 73 20 64 6f  ction in this do
83a0: 63 75 6d 65 6e 74 20 62 65 63 61 75 73 65 20 69  cument because i
83b0: 74 20 69 73 20 6e 6f 74 0a 70 61 72 74 20 6f 66  t is not.part of
83c0: 20 73 74 61 6e 64 61 72 64 20 53 51 4c 20 61 6e   standard SQL an
83d0: 64 20 74 68 65 72 65 66 6f 72 65 20 6d 69 67 68  d therefore migh
83e0: 74 20 6e 6f 74 20 62 65 20 66 61 6d 69 6c 69 61  t not be familia
83f0: 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 73  r.</p>..<p>The s
8400: 79 6e 74 61 78 20 66 6f 72 20 74 68 65 20 4f 4e  yntax for the ON
8410: 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65   CONFLICT clause
8420: 20 69 73 20 61 73 20 73 68 6f 77 6e 20 61 62 6f   is as shown abo
8430: 76 65 20 66 6f 72 0a 74 68 65 20 43 52 45 41 54  ve for.the CREAT
8440: 45 20 54 41 42 4c 45 2c 20 43 52 45 41 54 45 20  E TABLE, CREATE 
8450: 49 4e 44 45 58 2c 20 61 6e 64 20 42 45 47 49 4e  INDEX, and BEGIN
8460: 20 54 52 41 4e 53 41 43 54 49 4f 4e 20 63 6f 6d   TRANSACTION com
8470: 6d 61 6e 64 73 2e 0a 46 6f 72 20 74 68 65 20 43  mands..For the C
8480: 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20 61 6e 64  OPY, INSERT, and
8490: 20 55 50 44 41 54 45 20 63 6f 6d 6d 61 6e 64 73   UPDATE commands
84a0: 2c 20 74 68 65 20 6b 65 79 77 6f 72 64 73 0a 22  , the keywords."
84b0: 4f 4e 20 43 4f 4e 46 4c 49 43 54 22 20 61 72 65  ON CONFLICT" are
84c0: 20 72 65 70 6c 61 63 65 64 20 62 79 20 22 4f 52   replaced by "OR
84d0: 22 2c 20 74 6f 20 6d 61 6b 65 20 74 68 65 20 73  ", to make the s
84e0: 79 6e 74 61 78 20 73 65 65 6d 20 6d 6f 72 65 0a  yntax seem more.
84f0: 6e 61 74 75 72 61 6c 2e 20 20 42 75 74 20 74 68  natural.  But th
8500: 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20 74 68 65  e meaning of the
8510: 20 63 6c 61 75 73 65 20 69 73 20 74 68 65 20 73   clause is the s
8520: 61 6d 65 20 65 69 74 68 65 72 20 77 61 79 2e 3c  ame either way.<
8530: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4f 4e 20 43  /p>..<p>The ON C
8540: 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 20 73  ONFLICT clause s
8550: 70 65 63 69 66 69 65 73 20 61 6e 20 61 6c 67 6f  pecifies an algo
8560: 72 69 74 68 6d 20 75 73 65 64 20 74 6f 20 72 65  rithm used to re
8570: 73 6f 6c 76 65 0a 63 6f 6e 73 74 72 61 69 6e 74  solve.constraint
8580: 20 63 6f 6e 66 6c 69 63 74 73 2e 20 20 54 68 65   conflicts.  The
8590: 72 65 20 61 72 65 20 66 69 76 65 20 63 68 6f 69  re are five choi
85a0: 63 65 73 3a 20 52 4f 4c 4c 42 41 43 4b 2c 20 41  ces: ROLLBACK, A
85b0: 42 4f 52 54 2c 0a 46 41 49 4c 2c 20 49 47 4e 4f  BORT,.FAIL, IGNO
85c0: 52 45 2c 20 61 6e 64 20 52 45 50 4c 41 43 45 2e  RE, and REPLACE.
85d0: 20 54 68 65 20 64 65 66 61 75 6c 74 20 61 6c 67   The default alg
85e0: 6f 72 69 74 68 6d 20 69 73 20 41 42 4f 52 54 2e  orithm is ABORT.
85f0: 20 20 54 68 69 73 0a 69 73 20 77 68 61 74 20 74    This.is what t
8600: 68 65 79 20 6d 65 61 6e 3a 3c 2f 70 3e 0a 0a 3c  hey mean:</p>..<
8610: 64 6c 3e 0a 3c 64 74 3e 3c 62 3e 52 4f 4c 4c 42  dl>.<dt><b>ROLLB
8620: 41 43 4b 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64  ACK</b></dt>.<dd
8630: 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74  ><p>When a const
8640: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20  raint violation 
8650: 6f 63 63 75 72 73 2c 20 61 6e 20 69 6d 6d 65 64  occurs, an immed
8660: 69 61 74 65 20 52 4f 4c 4c 42 41 43 4b 0a 6f 63  iate ROLLBACK.oc
8670: 63 75 72 73 2c 20 74 68 75 73 20 65 6e 64 69 6e  curs, thus endin
8680: 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 74 72  g the current tr
8690: 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e 64 20 74  ansaction, and t
86a0: 68 65 20 63 6f 6d 6d 61 6e 64 20 61 62 6f 72 74  he command abort
86b0: 73 0a 77 69 74 68 20 61 20 72 65 74 75 72 6e 20  s.with a return 
86c0: 63 6f 64 65 20 6f 66 20 53 51 4c 49 54 45 5f 43  code of SQLITE_C
86d0: 4f 4e 53 54 52 41 49 4e 54 2e 20 20 49 66 20 6e  ONSTRAINT.  If n
86e0: 6f 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 69 73  o transaction is
86f0: 0a 61 63 74 69 76 65 20 28 6f 74 68 65 72 20 74  .active (other t
8700: 68 61 6e 20 74 68 65 20 69 6d 70 6c 69 65 64 20  han the implied 
8710: 74 72 61 6e 73 61 63 74 69 6f 6e 20 74 68 61 74  transaction that
8720: 20 69 73 20 63 72 65 61 74 65 64 20 6f 6e 20 65   is created on e
8730: 76 65 72 79 0a 63 6f 6d 6d 61 6e 64 29 20 74 68  very.command) th
8740: 65 6e 20 74 68 69 73 20 61 6c 67 6f 72 69 74 68  en this algorith
8750: 6d 20 77 6f 72 6b 73 20 74 68 65 20 73 61 6d 65  m works the same
8760: 20 61 73 20 41 42 4f 52 54 2e 3c 2f 70 3e 3c 2f   as ABORT.</p></
8770: 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 41 42 4f 52  dd>..<dt><b>ABOR
8780: 54 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c  T</b></dt>.<dd><
8790: 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74 72 61  p>When a constra
87a0: 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 6f 63  int violation oc
87b0: 63 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d 61 6e  curs, the comman
87c0: 64 20 62 61 63 6b 73 20 6f 75 74 0a 61 6e 79 20  d backs out.any 
87d0: 70 72 69 6f 72 20 63 68 61 6e 67 65 73 20 69 74  prior changes it
87e0: 20 6d 69 67 68 74 20 68 61 76 65 20 6d 61 64 65   might have made
87f0: 20 61 6e 64 20 61 62 6f 72 74 73 20 77 69 74 68   and aborts with
8800: 20 61 20 72 65 74 75 72 6e 20 63 6f 64 65 0a 6f   a return code.o
8810: 66 20 53 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41  f SQLITE_CONSTRA
8820: 49 4e 54 2e 20 20 42 75 74 20 6e 6f 20 52 4f 4c  INT.  But no ROL
8830: 4c 42 41 43 4b 20 69 73 20 65 78 65 63 75 74 65  LBACK is execute
8840: 64 20 73 6f 20 63 68 61 6e 67 65 73 0a 66 72 6f  d so changes.fro
8850: 6d 20 70 72 69 6f 72 20 63 6f 6d 6d 61 6e 64 73  m prior commands
8860: 20 77 69 74 68 69 6e 20 74 68 65 20 73 61 6d 65   within the same
8870: 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a 61 72 65   transaction.are
8880: 20 70 72 65 73 65 72 76 65 64 2e 20 20 54 68 69   preserved.  Thi
8890: 73 20 69 73 20 74 68 65 20 64 65 66 61 75 6c 74  s is the default
88a0: 20 62 65 68 61 76 69 6f 72 2e 3c 2f 70 3e 3c 2f   behavior.</p></
88b0: 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 46 41 49 4c  dd>..<dt><b>FAIL
88c0: 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70  </b></dt>.<dd><p
88d0: 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74 72 61 69  >When a constrai
88e0: 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 6f 63 63  nt violation occ
88f0: 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d 61 6e 64  urs, the command
8900: 20 61 62 6f 72 74 73 20 77 69 74 68 20 61 0a 72   aborts with a.r
8910: 65 74 75 72 6e 20 63 6f 64 65 20 53 51 4c 49 54  eturn code SQLIT
8920: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 2e 20 20 42  E_CONSTRAINT.  B
8930: 75 74 20 61 6e 79 20 63 68 61 6e 67 65 73 20 74  ut any changes t
8940: 6f 20 74 68 65 20 64 61 74 61 62 61 73 65 20 74  o the database t
8950: 68 61 74 0a 74 68 65 20 63 6f 6d 6d 61 6e 64 20  hat.the command 
8960: 6d 61 64 65 20 70 72 69 6f 72 20 74 6f 20 65 6e  made prior to en
8970: 63 6f 75 6e 74 65 72 69 6e 67 20 74 68 65 20 63  countering the c
8980: 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74  onstraint violat
8990: 69 6f 6e 0a 61 72 65 20 70 72 65 73 65 72 76 65  ion.are preserve
89a0: 64 20 61 6e 64 20 61 72 65 20 6e 6f 74 20 62 61  d and are not ba
89b0: 63 6b 65 64 20 6f 75 74 2e 20 20 46 6f 72 20 65  cked out.  For e
89c0: 78 61 6d 70 6c 65 2c 20 69 66 20 61 6e 20 55 50  xample, if an UP
89d0: 44 41 54 45 0a 73 74 61 74 65 6d 65 6e 74 20 65  DATE.statement e
89e0: 6e 63 6f 75 6e 74 65 72 65 64 20 61 20 63 6f 6e  ncountered a con
89f0: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
8a00: 6e 20 6f 6e 20 74 68 65 20 31 30 30 74 68 20 72  n on the 100th r
8a10: 6f 77 20 74 68 61 74 0a 69 74 20 61 74 74 65 6d  ow that.it attem
8a20: 70 74 73 20 74 6f 20 75 70 64 61 74 65 2c 20 74  pts to update, t
8a30: 68 65 6e 20 74 68 65 20 66 69 72 73 74 20 39 39  hen the first 99
8a40: 20 72 6f 77 20 63 68 61 6e 67 65 73 20 61 72 65   row changes are
8a50: 20 70 72 65 73 65 72 76 65 64 0a 62 75 74 20 63   preserved.but c
8a60: 68 61 6e 67 65 73 20 74 6f 20 72 6f 77 73 20 31  hanges to rows 1
8a70: 30 30 20 61 6e 64 20 62 65 79 6f 6e 64 20 6e 65  00 and beyond ne
8a80: 76 65 72 20 6f 63 63 75 72 2e 3c 2f 70 3e 3c 2f  ver occur.</p></
8a90: 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 49 47 4e 4f  dd>..<dt><b>IGNO
8aa0: 52 45 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e  RE</b></dt>.<dd>
8ab0: 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74 72  <p>When a constr
8ac0: 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 6f  aint violation o
8ad0: 63 63 75 72 73 2c 20 74 68 65 20 6f 6e 65 20 72  ccurs, the one r
8ae0: 6f 77 20 74 68 61 74 20 63 6f 6e 74 61 69 6e 73  ow that contains
8af0: 0a 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20  .the constraint 
8b00: 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20 6e 6f 74  violation is not
8b10: 20 69 6e 73 65 72 74 65 64 20 6f 72 20 63 68 61   inserted or cha
8b20: 6e 67 65 64 2e 20 20 42 75 74 20 74 68 65 20 63  nged.  But the c
8b30: 6f 6d 6d 61 6e 64 0a 63 6f 6e 74 69 6e 75 65 73  ommand.continues
8b40: 20 65 78 65 63 75 74 69 6e 67 20 6e 6f 72 6d 61   executing norma
8b50: 6c 6c 79 2e 20 20 4f 74 68 65 72 20 72 6f 77 73  lly.  Other rows
8b60: 20 62 65 66 6f 72 65 20 61 6e 64 20 61 66 74 65   before and afte
8b70: 72 20 74 68 65 20 72 6f 77 20 74 68 61 74 0a 63  r the row that.c
8b80: 6f 6e 74 61 69 6e 65 64 20 74 68 65 20 63 6f 6e  ontained the con
8b90: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
8ba0: 6e 20 63 6f 6e 74 69 6e 75 65 20 74 6f 20 62 65  n continue to be
8bb0: 20 69 6e 73 65 72 74 65 64 20 6f 72 20 75 70 64   inserted or upd
8bc0: 61 74 65 64 0a 6e 6f 72 6d 61 6c 6c 79 2e 20 20  ated.normally.  
8bd0: 4e 6f 20 65 72 72 6f 72 20 69 73 20 72 65 74 75  No error is retu
8be0: 72 6e 65 64 2e 3c 2f 70 3e 3c 2f 64 64 3e 0a 0a  rned.</p></dd>..
8bf0: 3c 64 74 3e 3c 62 3e 52 45 50 4c 41 43 45 3c 2f  <dt><b>REPLACE</
8c00: 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c 70 3e 57  b></dt>.<dd><p>W
8c10: 68 65 6e 20 61 20 55 4e 49 51 55 45 20 63 6f 6e  hen a UNIQUE con
8c20: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
8c30: 6e 20 6f 63 63 75 72 73 2c 20 74 68 65 20 70 72  n occurs, the pr
8c40: 65 2d 65 78 69 73 74 69 6e 67 20 72 6f 77 0a 74  e-existing row.t
8c50: 68 61 74 20 69 73 20 63 61 75 73 69 6e 67 20 74  hat is causing t
8c60: 68 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69  he constraint vi
8c70: 6f 6c 61 74 69 6f 6e 20 69 73 20 72 65 6d 6f 76  olation is remov
8c80: 65 64 20 70 72 69 6f 72 20 74 6f 20 69 6e 73 65  ed prior to inse
8c90: 72 74 69 6e 67 0a 6f 72 20 75 70 64 61 74 69 6e  rting.or updatin
8ca0: 67 20 74 68 65 20 63 75 72 72 65 6e 74 20 72 6f  g the current ro
8cb0: 77 2e 20 20 54 68 75 73 20 74 68 65 20 69 6e 73  w.  Thus the ins
8cc0: 65 72 74 20 6f 72 20 75 70 64 61 74 65 20 61 6c  ert or update al
8cd0: 77 61 79 73 20 6f 63 63 75 72 73 2e 0a 54 68 65  ways occurs..The
8ce0: 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 74 69 6e 75   command continu
8cf0: 65 73 20 65 78 65 63 75 74 69 6e 67 20 6e 6f 72  es executing nor
8d00: 6d 61 6c 6c 79 2e 20 20 4e 6f 20 65 72 72 6f 72  mally.  No error
8d10: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 3c 2f 70   is returned.</p
8d20: 3e 0a 3c 70 3e 49 66 20 61 20 4e 4f 54 20 4e 55  >.<p>If a NOT NU
8d30: 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69  LL constraint vi
8d40: 6f 6c 61 74 69 6f 6e 20 6f 63 63 75 72 73 2c 20  olation occurs, 
8d50: 74 68 65 20 4e 55 4c 4c 20 76 61 6c 75 65 20 69  the NULL value i
8d60: 73 20 72 65 70 6c 61 63 65 64 0a 62 79 20 74 68  s replaced.by th
8d70: 65 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20  e default value 
8d80: 66 6f 72 20 74 68 61 74 20 63 6f 6c 75 6d 6e 2e  for that column.
8d90: 20 20 49 66 20 74 68 65 20 63 6f 6c 75 6d 6e 20    If the column 
8da0: 68 61 73 20 6e 6f 20 64 65 66 61 75 6c 74 0a 76  has no default.v
8db0: 61 6c 75 65 2c 20 74 68 65 6e 20 74 68 65 20 41  alue, then the A
8dc0: 42 4f 52 54 20 61 6c 67 6f 72 69 74 68 6d 20 69  BORT algorithm i
8dd0: 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 3c 2f 64 64  s used.</p>.</dd
8de0: 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 70 3e 0a 54 68 65  >.</dl>..<p>.The
8df0: 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75   conflict resolu
8e00: 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 63  tion algorithm c
8e10: 61 6e 20 62 65 20 73 70 65 63 69 66 69 65 64 20  an be specified 
8e20: 69 6e 20 74 68 72 65 65 20 70 6c 61 63 65 73 2c  in three places,
8e30: 0a 69 6e 20 6f 72 64 65 72 20 66 72 6f 6d 20 6c  .in order from l
8e40: 6f 77 65 73 74 20 74 6f 20 68 69 67 68 65 73 74  owest to highest
8e50: 20 70 72 65 63 65 64 65 6e 63 65 3a 0a 3c 2f 70   precedence:.</p
8e60: 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 0a  >..<ol>.<li><p>.
8e70: 4f 6e 20 61 20 42 45 47 49 4e 20 54 52 41 4e 53  On a BEGIN TRANS
8e80: 41 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e 64 2e 0a  ACTION command..
8e90: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c  </p></li>..<li><
8ea0: 70 3e 0a 4f 6e 20 69 6e 64 69 76 69 64 75 61 6c  p>.On individual
8eb0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 77 69 74   constraints wit
8ec0: 68 69 6e 20 61 20 43 52 45 41 54 45 20 54 41 42  hin a CREATE TAB
8ed0: 4c 45 20 6f 72 20 43 52 45 41 54 45 20 49 4e 44  LE or CREATE IND
8ee0: 45 58 0a 73 74 61 74 65 6d 65 6e 74 2e 0a 3c 2f  EX.statement..</
8ef0: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
8f00: 0a 49 6e 20 74 68 65 20 4f 52 20 63 6c 61 75 73  .In the OR claus
8f10: 65 20 6f 66 20 61 20 43 4f 50 59 2c 20 49 4e 53  e of a COPY, INS
8f20: 45 52 54 2c 20 6f 72 20 55 50 44 41 54 45 20 63  ERT, or UPDATE c
8f30: 6f 6d 6d 61 6e 64 2e 0a 3c 2f 70 3e 3c 2f 6c 69  ommand..</p></li
8f40: 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 54 68 65 20  >.</ol>..<p>The 
8f50: 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63 69 66  algorithm specif
8f60: 69 65 64 20 69 6e 20 74 68 65 20 4f 52 20 63 6c  ied in the OR cl
8f70: 61 75 73 65 20 6f 66 20 61 20 43 4f 50 59 2c 20  ause of a COPY, 
8f80: 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54  INSERT, or UPDAT
8f90: 45 0a 6f 76 65 72 72 69 64 65 73 20 61 6e 79 20  E.overrides any 
8fa0: 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63 69 66  algorithm specif
8fb0: 69 65 64 20 62 79 20 61 20 43 52 45 41 54 45 20  ied by a CREATE 
8fc0: 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20  TABLE or CREATE 
8fd0: 49 4e 44 45 58 2e 0a 54 68 65 20 61 6c 67 6f 72  INDEX..The algor
8fe0: 69 74 68 6d 20 73 70 65 63 69 66 69 65 64 20 77  ithm specified w
8ff0: 69 74 68 69 6e 20 61 20 43 52 45 41 54 45 20 54  ithin a CREATE T
9000: 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20 49  ABLE or CREATE I
9010: 4e 44 45 58 20 77 69 6c 6c 2c 20 69 6e 20 74 75  NDEX will, in tu
9020: 72 6e 2c 0a 6f 76 65 72 72 69 64 65 20 74 68 65  rn,.override the
9030: 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65 63 69   algorithm speci
9040: 66 69 65 64 20 62 79 20 61 20 42 45 47 49 4e 20  fied by a BEGIN 
9050: 54 52 41 4e 53 41 43 54 49 4f 4e 20 63 6f 6d 6d  TRANSACTION comm
9060: 61 6e 64 2e 0a 49 66 20 6e 6f 20 61 6c 67 6f 72  and..If no algor
9070: 69 74 68 6d 20 69 73 20 73 70 65 63 69 66 69 65  ithm is specifie
9080: 64 20 61 6e 79 77 68 65 72 65 2c 20 74 68 65 20  d anywhere, the 
9090: 41 42 4f 52 54 20 61 6c 67 6f 72 69 74 68 6d 20  ABORT algorithm 
90a0: 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 0a 7d 0a  is used.</p>..}.
90b0: 23 20 3c 70 3e 46 6f 72 20 61 64 64 69 74 69 6f  # <p>For additio
90c0: 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c  nal information,
90d0: 20 73 65 65 20 0a 23 20 3c 61 20 68 72 65 66 3d   see .# <a href=
90e0: 22 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c 22 3e  "conflict.html">
90f0: 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c 3c 2f 61  conflict.html</a
9100: 3e 2e 3c 2f 70 3e 0a 0a 0a 53 65 63 74 69 6f 6e  >.</p>...Section
9110: 20 50 52 41 47 4d 41 20 70 72 61 67 6d 61 0a 0a   PRAGMA pragma..
9120: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74  Syntax {sql-stat
9130: 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47 4d 41 20  ement} {.PRAGMA 
9140: 3c 6e 61 6d 65 3e 20 3d 20 3c 76 61 6c 75 65 3e  <name> = <value>
9150: 20 7c 0a 50 52 41 47 4d 41 20 3c 66 75 6e 63 74   |.PRAGMA <funct
9160: 69 6f 6e 3e 28 3c 61 72 67 3e 29 0a 7d 0a 0a 70  ion>(<arg>).}..p
9170: 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 50 52 41  uts {.<p>The PRA
9180: 47 4d 41 20 63 6f 6d 6d 61 6e 64 20 69 73 20 75  GMA command is u
9190: 73 65 64 20 74 6f 20 6d 6f 64 69 66 79 20 74 68  sed to modify th
91a0: 65 20 6f 70 65 72 61 74 69 6f 6e 20 6f 66 20 74  e operation of t
91b0: 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72  he SQLite librar
91c0: 79 2e 0a 54 68 65 20 70 72 61 67 6d 61 20 63 6f  y..The pragma co
91d0: 6d 6d 61 6e 64 20 69 73 20 65 78 70 65 72 69 6d  mmand is experim
91e0: 65 6e 74 61 6c 20 61 6e 64 20 73 70 65 63 69 66  ental and specif
91f0: 69 63 20 70 72 61 67 6d 61 20 73 74 61 74 65 6d  ic pragma statem
9200: 65 6e 74 73 20 6d 61 79 20 62 65 0a 72 65 6d 6f  ents may be.remo
9210: 76 65 64 20 6f 72 20 61 64 64 65 64 20 69 6e 20  ved or added in 
9220: 66 75 74 75 72 65 20 72 65 6c 65 61 73 65 73 20  future releases 
9230: 6f 66 20 53 51 4c 69 74 65 2e 20 20 55 73 65 20  of SQLite.  Use 
9240: 74 68 69 73 20 63 6f 6d 6d 61 6e 64 0a 77 69 74  this command.wit
9250: 68 20 63 61 75 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  h caution.</p>..
9260: 3c 70 3e 54 68 65 20 63 75 72 72 65 6e 74 20 69  <p>The current i
9270: 6d 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 20 73 75  mplementation su
9280: 70 70 6f 72 74 73 20 74 68 65 20 66 6f 6c 6c 6f  pports the follo
9290: 77 69 6e 67 20 70 72 61 67 6d 61 73 3a 3c 2f 70  wing pragmas:</p
92a0: 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 3c 70 3e 3c  >..<ul>.<li><p><
92b0: 62 3e 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73  b>PRAGMA cache_s
92c0: 69 7a 65 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e  ize;.       <br>
92d0: 50 52 41 47 4d 41 20 63 61 63 68 65 5f 73 69 7a  PRAGMA cache_siz
92e0: 65 20 3d 20 3c 2f 62 3e 3c 69 3e 4e 75 6d 62 65  e = </b><i>Numbe
92f0: 72 2d 6f 66 2d 70 61 67 65 73 3c 2f 69 3e 3c 62  r-of-pages</i><b
9300: 3e 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c  >;</b></p>.    <
9310: 70 3e 51 75 65 72 79 20 6f 72 20 63 68 61 6e 67  p>Query or chang
9320: 65 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75  e the maximum nu
9330: 6d 62 65 72 20 6f 66 20 64 61 74 61 62 61 73 65  mber of database
9340: 20 64 69 73 6b 20 70 61 67 65 73 20 74 68 61 74   disk pages that
9350: 20 53 51 4c 69 74 65 0a 20 20 20 20 77 69 6c 6c   SQLite.    will
9360: 20 68 6f 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20   hold in memory 
9370: 61 74 20 6f 6e 63 65 2e 20 20 45 61 63 68 20 70  at once.  Each p
9380: 61 67 65 20 75 73 65 73 20 61 62 6f 75 74 20 31  age uses about 1
9390: 2e 35 4b 20 6f 66 20 6d 65 6d 6f 72 79 2e 0a 20  .5K of memory.. 
93a0: 20 20 20 54 68 65 20 64 65 66 61 75 6c 74 20 63     The default c
93b0: 61 63 68 65 20 73 69 7a 65 20 69 73 20 32 30 30  ache size is 200
93c0: 30 2e 20 20 49 66 20 79 6f 75 20 61 72 65 20 64  0.  If you are d
93d0: 6f 69 6e 67 20 55 50 44 41 54 45 73 20 6f 72 20  oing UPDATEs or 
93e0: 44 45 4c 45 54 45 73 0a 20 20 20 20 74 68 61 74  DELETEs.    that
93f0: 20 63 68 61 6e 67 65 20 6d 61 6e 79 20 72 6f 77   change many row
9400: 73 20 6f 66 20 61 20 64 61 74 61 62 61 73 65 20  s of a database 
9410: 61 6e 64 20 79 6f 75 20 64 6f 20 6e 6f 74 20 6d  and you do not m
9420: 69 6e 64 20 69 66 20 53 51 4c 69 74 65 0a 20 20  ind if SQLite.  
9430: 20 20 75 73 65 73 20 6d 6f 72 65 20 6d 65 6d 6f    uses more memo
9440: 72 79 2c 20 79 6f 75 20 63 61 6e 20 69 6e 63 72  ry, you can incr
9450: 65 61 73 65 20 74 68 65 20 63 61 63 68 65 20 73  ease the cache s
9460: 69 7a 65 20 66 6f 72 20 61 20 70 6f 73 73 69 62  ize for a possib
9470: 6c 65 20 73 70 65 65 64 0a 20 20 20 20 69 6d 70  le speed.    imp
9480: 72 6f 76 65 6d 65 6e 74 2e 3c 2f 70 3e 0a 20 20  rovement.</p>.  
9490: 20 20 3c 70 3e 57 68 65 6e 20 79 6f 75 20 63 68    <p>When you ch
94a0: 61 6e 67 65 20 74 68 65 20 63 61 63 68 65 20 73  ange the cache s
94b0: 69 7a 65 20 75 73 69 6e 67 20 74 68 65 20 63 61  ize using the ca
94c0: 63 68 65 5f 73 69 7a 65 20 70 72 61 67 6d 61 2c  che_size pragma,
94d0: 20 74 68 65 0a 20 20 20 20 63 68 61 6e 67 65 20   the.    change 
94e0: 6f 6e 6c 79 20 65 6e 64 75 72 65 73 20 66 6f 72  only endures for
94f0: 20 74 68 65 20 63 75 72 72 65 6e 74 20 73 65 73   the current ses
9500: 73 69 6f 6e 2e 20 20 54 68 65 20 63 61 63 68 65  sion.  The cache
9510: 20 73 69 7a 65 20 72 65 76 65 72 74 73 0a 20 20   size reverts.  
9520: 20 20 74 6f 20 74 68 65 20 64 65 66 61 75 6c 74    to the default
9530: 20 76 61 6c 75 65 20 77 68 65 6e 20 74 68 65 20   value when the 
9540: 64 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f 73  database is clos
9550: 65 64 20 61 6e 64 20 72 65 6f 70 65 6e 65 64 2e  ed and reopened.
9560: 20 20 55 73 65 0a 20 20 20 20 74 68 65 20 3c 62    Use.    the <b
9570: 3e 64 65 66 61 75 6c 74 5f 63 61 63 68 65 5f 73  >default_cache_s
9580: 69 7a 65 3c 2f 62 3e 20 70 72 61 67 6d 61 20 74  ize</b> pragma t
9590: 6f 20 63 68 65 63 6b 20 74 68 65 20 63 61 63 68  o check the cach
95a0: 65 20 73 69 7a 65 20 70 65 72 6d 61 6e 65 6e 74  e size permanent
95b0: 6c 79 0a 20 20 20 20 3c 2f 70 3e 3c 2f 6c 69 3e  ly.    </p></li>
95c0: 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47  ..<li><p><b>PRAG
95d0: 4d 41 20 63 6f 75 6e 74 5f 63 68 61 6e 67 65 73  MA count_changes
95e0: 20 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62   = ON;.       <b
95f0: 72 3e 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f 63  r>PRAGMA count_c
9600: 68 61 6e 67 65 73 20 3d 20 4f 46 46 3b 3c 2f 62  hanges = OFF;</b
9610: 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 57 68 65  ></p>.    <p>Whe
9620: 6e 20 6f 6e 2c 20 74 68 65 20 43 4f 55 4e 54 5f  n on, the COUNT_
9630: 43 48 41 4e 47 45 53 20 70 72 61 67 6d 61 20 63  CHANGES pragma c
9640: 61 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62 61  auses the callba
9650: 63 6b 20 66 75 6e 63 74 69 6f 6e 20 74 6f 0a 20  ck function to. 
9660: 20 20 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f 6e     be invoked on
9670: 63 65 20 66 6f 72 20 65 61 63 68 20 44 45 4c 45  ce for each DELE
9680: 54 45 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55  TE, INSERT, or U
9690: 50 44 41 54 45 20 6f 70 65 72 61 74 69 6f 6e 2e  PDATE operation.
96a0: 20 20 54 68 65 0a 20 20 20 20 61 72 67 75 6d 65    The.    argume
96b0: 6e 74 20 69 73 20 74 68 65 20 6e 75 6d 62 65 72  nt is the number
96c0: 20 6f 66 20 72 6f 77 73 20 74 68 61 74 20 77 65   of rows that we
96d0: 72 65 20 63 68 61 6e 67 65 64 2e 3c 2f 70 3e 0a  re changed.</p>.
96e0: 20 20 20 20 3c 70 3e 54 68 69 73 20 70 72 61 67      <p>This prag
96f0: 6d 61 20 6d 61 79 20 62 65 20 72 65 6d 6f 76 65  ma may be remove
9700: 64 20 66 72 6f 6d 20 66 75 74 75 72 65 20 76 65  d from future ve
9710: 72 73 69 6f 6e 73 20 6f 66 20 53 51 4c 69 74 65  rsions of SQLite
9720: 2e 0a 20 20 20 20 43 6f 6e 73 69 64 65 72 20 75  ..    Consider u
9730: 73 69 6e 67 20 74 68 65 20 3c 62 3e 73 71 6c 69  sing the <b>sqli
9740: 74 65 5f 63 68 61 6e 67 65 73 28 29 3c 2f 62 3e  te_changes()</b>
9750: 20 41 50 49 20 66 75 6e 63 74 69 6f 6e 20 69 6e   API function in
9760: 73 74 65 61 64 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a  stead.</p></li>.
9770: 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d  .<li><p><b>PRAGM
9780: 41 20 64 65 66 61 75 6c 74 5f 63 61 63 68 65 5f  A default_cache_
9790: 73 69 7a 65 3b 0a 20 20 20 20 20 20 20 3c 62 72  size;.       <br
97a0: 3e 50 52 41 47 4d 41 20 64 65 66 61 75 6c 74 5f  >PRAGMA default_
97b0: 63 61 63 68 65 5f 73 69 7a 65 20 3d 20 3c 2f 62  cache_size = </b
97c0: 3e 3c 69 3e 4e 75 6d 62 65 72 2d 6f 66 2d 70 61  ><i>Number-of-pa
97d0: 67 65 73 3c 2f 69 3e 3c 62 3e 3b 3c 2f 62 3e 3c  ges</i><b>;</b><
97e0: 2f 70 3e 0a 20 20 20 20 3c 70 3e 51 75 65 72 79  /p>.    <p>Query
97f0: 20 6f 72 20 63 68 61 6e 67 65 20 74 68 65 20 6d   or change the m
9800: 61 78 69 6d 75 6d 20 6e 75 6d 62 65 72 20 6f 66  aximum number of
9810: 20 64 61 74 61 62 61 73 65 20 64 69 73 6b 20 70   database disk p
9820: 61 67 65 73 20 74 68 61 74 20 53 51 4c 69 74 65  ages that SQLite
9830: 0a 20 20 20 20 77 69 6c 6c 20 68 6f 6c 64 20 69  .    will hold i
9840: 6e 20 6d 65 6d 6f 72 79 20 61 74 20 6f 6e 63 65  n memory at once
9850: 2e 20 20 45 61 63 68 20 70 61 67 65 20 75 73 65  .  Each page use
9860: 73 20 61 62 6f 75 74 20 31 2e 35 4b 20 6f 66 20  s about 1.5K of 
9870: 6d 65 6d 6f 72 79 2e 0a 20 20 20 20 54 68 69 73  memory..    This
9880: 20 70 72 61 67 6d 61 20 77 6f 72 6b 73 20 6c 69   pragma works li
9890: 6b 65 20 74 68 65 20 3c 62 3e 63 61 63 68 65 5f  ke the <b>cache_
98a0: 73 69 7a 65 3c 2f 62 3e 20 70 72 61 67 6d 61 20  size</b> pragma 
98b0: 77 69 74 68 20 74 68 65 20 61 64 64 69 74 69 6f  with the additio
98c0: 6e 0a 20 20 20 20 66 65 61 74 75 72 65 20 74 68  n.    feature th
98d0: 61 74 20 69 74 20 63 68 61 6e 67 65 73 20 74 68  at it changes th
98e0: 65 20 63 61 63 68 65 20 73 69 7a 65 20 70 65 72  e cache size per
98f0: 73 69 73 74 65 6e 74 6c 79 2e 20 20 57 69 74 68  sistently.  With
9900: 20 74 68 69 73 20 70 72 61 67 6d 61 2c 0a 20 20   this pragma,.  
9910: 20 20 79 6f 75 20 63 61 6e 20 73 65 74 20 74 68    you can set th
9920: 65 20 63 61 63 68 65 20 73 69 7a 65 20 6f 6e 63  e cache size onc
9930: 65 20 61 6e 64 20 74 68 61 74 20 73 65 74 74 69  e and that setti
9940: 6e 67 20 69 73 20 72 65 74 61 69 6e 65 64 20 61  ng is retained a
9950: 6e 64 20 72 65 75 73 65 64 0a 20 20 20 20 65 76  nd reused.    ev
9960: 65 72 79 74 69 6d 65 20 79 6f 75 20 72 65 6f 70  erytime you reop
9970: 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 2e  en the database.
9980: 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c  </p></li>..<li><
9990: 70 3e 3c 62 3e 50 52 41 47 4d 41 20 64 65 66 61  p><b>PRAGMA defa
99a0: 75 6c 74 5f 73 79 6e 63 68 72 6f 6e 6f 75 73 3b  ult_synchronous;
99b0: 0a 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47  .       <br>PRAG
99c0: 4d 41 20 64 65 66 61 75 6c 74 5f 73 79 6e 63 68  MA default_synch
99d0: 72 6f 6e 6f 75 73 20 3d 20 4f 4e 3b 0a 20 20 20  ronous = ON;.   
99e0: 20 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20 64      <br>PRAGMA d
99f0: 65 66 61 75 6c 74 5f 73 79 6e 63 68 72 6f 6e 6f  efault_synchrono
9a00: 75 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70  us = OFF;</b></p
9a10: 3e 0a 20 20 20 20 3c 70 3e 51 75 65 72 79 20 6f  >.    <p>Query o
9a20: 72 20 63 68 61 6e 67 65 20 74 68 65 20 73 65 74  r change the set
9a30: 74 69 6e 67 20 6f 66 20 74 68 65 20 22 73 79 6e  ting of the "syn
9a40: 63 68 72 6f 6e 6f 75 73 22 20 66 6c 61 67 20 69  chronous" flag i
9a50: 6e 0a 20 20 20 20 74 68 65 20 64 61 74 61 62 61  n.    the databa
9a60: 73 65 2e 20 20 57 68 65 6e 20 73 79 6e 63 68 72  se.  When synchr
9a70: 6f 6e 6f 75 73 20 69 73 20 6f 6e 20 28 74 68 65  onous is on (the
9a80: 20 64 65 66 61 75 6c 74 29 2c 20 74 68 65 20 53   default), the S
9a90: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 0a 20  QLite database. 
9aa0: 20 20 20 65 6e 67 69 6e 65 20 77 69 6c 6c 20 70     engine will p
9ab0: 61 75 73 65 20 61 74 20 63 72 69 74 69 63 61 6c  ause at critical
9ac0: 20 6d 6f 6d 65 6e 74 73 20 74 6f 20 6d 61 6b 65   moments to make
9ad0: 20 73 75 72 65 20 74 68 61 74 20 64 61 74 61 20   sure that data 
9ae0: 68 61 73 20 61 63 74 75 61 6c 6c 79 0a 20 20 20  has actually.   
9af0: 20 62 65 20 77 72 69 74 74 65 6e 20 74 6f 20 74   be written to t
9b00: 68 65 20 64 69 73 6b 20 73 75 72 66 61 63 65 2e  he disk surface.
9b10: 20 20 28 49 6e 20 6f 74 68 65 72 20 77 6f 72 64    (In other word
9b20: 73 2c 20 69 74 20 69 6e 76 6f 6b 65 73 20 74 68  s, it invokes th
9b30: 65 0a 20 20 20 20 65 71 75 69 76 61 6c 65 6e 74  e.    equivalent
9b40: 20 6f 66 20 74 68 65 20 3c 62 3e 66 73 79 6e 63   of the <b>fsync
9b50: 28 29 3c 2f 62 3e 20 73 79 73 74 65 6d 20 63 61  ()</b> system ca
9b60: 6c 6c 2e 29 20 20 49 6e 20 73 79 6e 63 68 72 6f  ll.)  In synchro
9b70: 6e 6f 75 73 20 6d 6f 64 65 2c 0a 20 20 20 20 61  nous mode,.    a
9b80: 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  n SQLite databas
9b90: 65 20 73 68 6f 75 6c 64 20 62 65 20 66 75 6c 6c  e should be full
9ba0: 79 20 72 65 63 6f 76 65 72 61 62 6c 65 20 65 76  y recoverable ev
9bb0: 65 6e 20 69 66 20 74 68 65 20 6f 70 65 72 61 74  en if the operat
9bc0: 69 6e 67 0a 20 20 20 20 73 79 73 74 65 6d 20 63  ing.    system c
9bd0: 72 61 73 68 65 73 20 6f 72 20 70 6f 77 65 72 20  rashes or power 
9be0: 69 73 20 69 6e 74 65 72 72 75 70 74 65 64 20 75  is interrupted u
9bf0: 6e 65 78 70 65 63 74 65 64 6c 79 2e 20 20 54 68  nexpectedly.  Th
9c00: 65 20 70 65 6e 61 6c 74 79 20 66 6f 72 0a 20 20  e penalty for.  
9c10: 20 20 74 68 69 73 20 61 73 73 75 72 61 6e 63 65    this assurance
9c20: 20 69 73 20 74 68 61 74 20 73 6f 6d 65 20 64 61   is that some da
9c30: 74 61 62 61 73 65 20 6f 70 65 72 61 74 69 6f 6e  tabase operation
9c40: 73 20 74 61 6b 65 20 6c 6f 6e 67 65 72 20 62 65  s take longer be
9c50: 63 61 75 73 65 20 74 68 65 0a 20 20 20 20 65 6e  cause the.    en
9c60: 67 69 6e 65 20 68 61 73 20 74 6f 20 77 61 69 74  gine has to wait
9c70: 20 6f 6e 20 74 68 65 20 28 72 65 6c 61 74 69 76   on the (relativ
9c80: 65 6c 79 20 73 6c 6f 77 29 20 64 69 73 6b 20 64  ely slow) disk d
9c90: 72 69 76 65 2e 20 20 54 68 65 20 61 6c 74 65 72  rive.  The alter
9ca0: 6e 61 74 69 76 65 0a 20 20 20 20 69 73 20 74 6f  native.    is to
9cb0: 20 74 75 72 6e 20 73 79 6e 63 68 72 6f 6e 6f 75   turn synchronou
9cc0: 73 20 6f 66 66 2e 20 20 57 69 74 68 20 73 79 6e  s off.  With syn
9cd0: 63 68 72 6f 6e 6f 75 73 20 6f 66 66 2c 20 53 51  chronous off, SQ
9ce0: 4c 69 74 65 20 63 6f 6e 74 69 6e 75 65 73 0a 20  Lite continues. 
9cf0: 20 20 20 70 72 6f 63 65 73 73 69 6e 67 20 61 73     processing as
9d00: 20 73 6f 6f 6e 20 61 73 20 69 74 20 68 61 73 20   soon as it has 
9d10: 68 61 6e 64 65 64 20 64 61 74 61 20 6f 66 66 20  handed data off 
9d20: 74 6f 20 74 68 65 20 6f 70 65 72 61 74 69 6e 67  to the operating
9d30: 20 73 79 73 74 65 6d 2e 0a 20 20 20 20 49 66 20   system..    If 
9d40: 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 20  the application 
9d50: 72 75 6e 6e 69 6e 67 20 53 51 4c 69 74 65 20 63  running SQLite c
9d60: 72 61 73 68 65 73 2c 20 74 68 65 20 64 61 74 61  rashes, the data
9d70: 20 77 69 6c 6c 20 62 65 20 73 61 66 65 2c 20 62   will be safe, b
9d80: 75 74 0a 20 20 20 20 74 68 65 20 64 61 74 61 62  ut.    the datab
9d90: 61 73 65 20 63 6f 75 6c 64 20 28 69 6e 20 74 68  ase could (in th
9da0: 65 6f 72 79 29 20 62 65 63 6f 6d 65 20 63 6f 72  eory) become cor
9db0: 72 75 70 74 65 64 20 69 66 20 74 68 65 20 6f 70  rupted if the op
9dc0: 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 0a 20  erating system. 
9dd0: 20 20 20 63 72 61 73 68 65 73 20 6f 72 20 74 68     crashes or th
9de0: 65 20 63 6f 6d 70 75 74 65 72 20 73 75 64 64 65  e computer sudde
9df0: 6e 6c 79 20 6c 6f 73 65 73 20 70 6f 77 65 72 2e  nly loses power.
9e00: 20 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20 68    On the other h
9e10: 61 6e 64 2c 20 73 6f 6d 65 0a 20 20 20 20 6f 70  and, some.    op
9e20: 65 72 61 74 69 6f 6e 73 20 61 72 65 20 61 73 20  erations are as 
9e30: 6d 75 63 68 20 61 73 20 35 30 20 6f 72 20 6d 6f  much as 50 or mo
9e40: 72 65 20 74 69 6d 65 73 20 66 61 73 74 65 72 20  re times faster 
9e50: 77 69 74 68 20 73 79 6e 63 68 72 6f 6e 6f 75 73  with synchronous
9e60: 20 6f 66 66 2e 0a 20 20 20 20 3c 2f 70 3e 0a 20   off..    </p>. 
9e70: 20 20 20 3c 70 3e 54 68 69 73 20 70 72 61 67 6d     <p>This pragm
9e80: 61 20 63 68 61 6e 67 65 73 20 74 68 65 20 73 79  a changes the sy
9e90: 6e 63 68 72 6f 6e 6f 75 73 20 6d 6f 64 65 20 70  nchronous mode p
9ea0: 65 72 73 69 73 74 65 6e 74 6c 79 2e 20 20 4f 6e  ersistently.  On
9eb0: 63 65 20 63 68 61 6e 67 65 64 2c 0a 20 20 20 20  ce changed,.    
9ec0: 74 68 65 20 6d 6f 64 65 20 73 74 61 79 73 20 61  the mode stays a
9ed0: 73 20 73 65 74 20 65 76 65 6e 20 69 66 20 74 68  s set even if th
9ee0: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63 6c  e database is cl
9ef0: 6f 73 65 64 20 61 6e 64 20 72 65 6f 70 65 6e 65  osed and reopene
9f00: 64 2e 20 20 54 68 65 0a 20 20 20 20 3c 62 3e 73  d.  The.    <b>s
9f10: 79 6e 63 68 72 6f 6e 6f 75 73 3c 2f 62 3e 20 70  ynchronous</b> p
9f20: 72 61 67 6d 61 20 64 6f 65 73 20 74 68 65 20 73  ragma does the s
9f30: 61 6d 65 20 74 68 69 6e 67 20 62 75 74 20 6f 6e  ame thing but on
9f40: 6c 79 20 61 70 70 6c 69 65 73 20 74 68 65 20 73  ly applies the s
9f50: 65 74 74 69 6e 67 0a 20 20 20 20 74 6f 20 74 68  etting.    to th
9f60: 65 20 63 75 72 72 65 6e 74 20 73 65 73 73 69 6f  e current sessio
9f70: 6e 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c  n.</p>..<li><p><
9f80: 62 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72  b>PRAGMA empty_r
9f90: 65 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20  esult_callbacks 
9fa0: 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20 3c 62 72  = ON;.       <br
9fb0: 3e 50 52 41 47 4d 41 20 65 6d 70 74 79 5f 72 65  >PRAGMA empty_re
9fc0: 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 20 3d  sult_callbacks =
9fd0: 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20   OFF;</b></p>.  
9fe0: 20 20 3c 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68    <p>When on, th
9ff0: 65 20 45 4d 50 54 59 5f 52 45 53 55 4c 54 5f 43  e EMPTY_RESULT_C
a000: 41 4c 4c 42 41 43 4b 53 20 70 72 61 67 6d 61 20  ALLBACKS pragma 
a010: 63 61 75 73 65 73 20 74 68 65 20 63 61 6c 6c 62  causes the callb
a020: 61 63 6b 0a 20 20 20 20 66 75 6e 63 74 69 6f 6e  ack.    function
a030: 20 74 6f 20 62 65 20 69 6e 76 6f 6b 65 64 20 6f   to be invoked o
a040: 6e 63 65 20 66 6f 72 20 65 61 63 68 20 71 75 65  nce for each que
a050: 72 79 20 74 68 61 74 20 68 61 73 20 61 6e 20 65  ry that has an e
a060: 6d 70 74 79 20 72 65 73 75 6c 74 0a 20 20 20 20  mpty result.    
a070: 73 65 74 2e 20 20 54 68 65 20 74 68 69 72 64 20  set.  The third 
a080: 22 3c 62 3e 61 72 67 76 3c 2f 62 3e 22 20 70 61  "<b>argv</b>" pa
a090: 72 61 6d 65 74 65 72 20 74 6f 20 74 68 65 20 63  rameter to the c
a0a0: 61 6c 6c 62 61 63 6b 20 69 73 20 73 65 74 20 74  allback is set t
a0b0: 6f 20 4e 55 4c 4c 0a 20 20 20 20 62 65 63 61 75  o NULL.    becau
a0c0: 73 65 20 74 68 65 72 65 20 69 73 20 6e 6f 20 64  se there is no d
a0d0: 61 74 61 20 74 6f 20 72 65 70 6f 72 74 2e 20 20  ata to report.  
a0e0: 42 75 74 20 74 68 65 20 73 65 63 6f 6e 64 20 22  But the second "
a0f0: 3c 62 3e 61 72 67 63 3c 2f 62 3e 22 20 61 6e 64  <b>argc</b>" and
a100: 0a 20 20 20 20 66 6f 75 72 74 68 20 22 3c 62 3e  .    fourth "<b>
a110: 63 6f 6c 75 6d 6e 4e 61 6d 65 73 3c 2f 62 3e 22  columnNames</b>"
a120: 20 70 61 72 61 6d 65 74 65 72 73 20 61 72 65 20   parameters are 
a130: 76 61 6c 69 64 20 61 6e 64 20 63 61 6e 20 62 65  valid and can be
a140: 20 75 73 65 64 20 74 6f 0a 20 20 20 20 64 65 74   used to.    det
a150: 65 72 6d 69 6e 65 20 74 68 65 20 6e 75 6d 62 65  ermine the numbe
a160: 72 20 61 6e 64 20 6e 61 6d 65 73 20 6f 66 20 74  r and names of t
a170: 68 65 20 63 6f 6c 75 6d 6e 73 20 74 68 61 74 20  he columns that 
a180: 77 6f 75 6c 64 20 68 61 76 65 20 62 65 65 6e 20  would have been 
a190: 69 6e 0a 20 20 20 20 74 68 65 20 72 65 73 75 6c  in.    the resul
a1a0: 74 20 73 65 74 20 68 61 64 20 74 68 65 20 73 65  t set had the se
a1b0: 74 20 6e 6f 74 20 62 65 65 6e 20 65 6d 70 74 79  t not been empty
a1c0: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
a1d0: 3e 50 52 41 47 4d 41 20 66 75 6c 6c 5f 63 6f 6c  >PRAGMA full_col
a1e0: 75 6d 6e 5f 6e 61 6d 65 73 20 3d 20 4f 4e 3b 0a  umn_names = ON;.
a1f0: 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d         <br>PRAGM
a200: 41 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61  A full_column_na
a210: 6d 65 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f  mes = OFF;</b></
a220: 70 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f  p>.    <p>The co
a230: 6c 75 6d 6e 20 6e 61 6d 65 73 20 72 65 70 6f 72  lumn names repor
a240: 74 65 64 20 69 6e 20 61 6e 20 53 51 4c 69 74 65  ted in an SQLite
a250: 20 63 61 6c 6c 62 61 63 6b 20 61 72 65 20 6e 6f   callback are no
a260: 72 6d 61 6c 6c 79 20 6a 75 73 74 0a 20 20 20 20  rmally just.    
a270: 74 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20  the name of the 
a280: 63 6f 6c 75 6d 6e 20 69 74 73 65 6c 66 2c 20 65  column itself, e
a290: 78 63 65 70 74 20 66 6f 72 20 6a 6f 69 6e 73 20  xcept for joins 
a2a0: 77 68 65 6e 20 22 54 41 42 4c 45 2e 43 4f 4c 55  when "TABLE.COLU
a2b0: 4d 4e 22 0a 20 20 20 20 69 73 20 75 73 65 64 2e  MN".    is used.
a2c0: 20 20 42 75 74 20 77 68 65 6e 20 66 75 6c 6c 5f    But when full_
a2d0: 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 73 20 69 73 20  column_names is 
a2e0: 74 75 72 6e 65 64 20 6f 6e 2c 20 63 6f 6c 75 6d  turned on, colum
a2f0: 6e 20 6e 61 6d 65 73 20 61 72 65 0a 20 20 20 20  n names are.    
a300: 61 6c 77 61 79 73 20 72 65 70 6f 72 74 65 64 20  always reported 
a310: 61 73 20 22 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e  as "TABLE.COLUMN
a320: 22 20 65 76 65 6e 20 66 6f 72 20 73 69 6d 70 6c  " even for simpl
a330: 65 20 71 75 65 72 69 65 73 2e 3c 2f 70 3e 3c 2f  e queries.</p></
a340: 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50  li>..<li><p><b>P
a350: 52 41 47 4d 41 20 69 6e 64 65 78 5f 69 6e 66 6f  RAGMA index_info
a360: 28 3c 2f 62 3e 3c 69 3e 69 6e 64 65 78 2d 6e 61  (</b><i>index-na
a370: 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c  me</i><b>);</b><
a380: 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65  /p>.    <p>For e
a390: 61 63 68 20 63 6f 6c 75 6d 6e 20 74 68 61 74 20  ach column that 
a3a0: 74 68 65 20 6e 61 6d 65 64 20 69 6e 64 65 78 20  the named index 
a3b0: 72 65 66 65 72 65 6e 63 65 73 2c 20 69 6e 76 6f  references, invo
a3c0: 6b 65 20 74 68 65 20 0a 20 20 20 20 63 61 6c 6c  ke the .    call
a3d0: 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20  back function.  
a3e0: 20 20 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f    once with info
a3f0: 72 6d 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68  rmation about th
a400: 61 74 20 63 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75  at column, inclu
a410: 64 69 6e 67 20 74 68 65 20 63 6f 6c 75 6d 6e 20  ding the column 
a420: 6e 61 6d 65 2c 0a 20 20 20 20 61 6e 64 20 74 68  name,.    and th
a430: 65 20 63 6f 6c 75 6d 6e 20 6e 75 6d 62 65 72 2e  e column number.
a440: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
a450: 50 52 41 47 4d 41 20 69 6e 64 65 78 5f 6c 69 73  PRAGMA index_lis
a460: 74 28 3c 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e  t(</b><i>table-n
a470: 61 6d 65 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e  ame</i><b>);</b>
a480: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20  </p>.    <p>For 
a490: 65 61 63 68 20 69 6e 64 65 78 20 6f 6e 20 74 68  each index on th
a4a0: 65 20 6e 61 6d 65 64 20 74 61 62 6c 65 2c 20 69  e named table, i
a4b0: 6e 76 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61  nvoke the callba
a4c0: 63 6b 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20  ck function.    
a4d0: 6f 6e 63 65 20 77 69 74 68 20 69 6e 66 6f 72 6d  once with inform
a4e0: 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 61 74  ation about that
a4f0: 20 69 6e 64 65 78 2e 20 20 41 72 67 75 6d 65 6e   index.  Argumen
a500: 74 73 20 69 6e 63 6c 75 64 65 20 74 68 65 0a 20  ts include the. 
a510: 20 20 20 69 6e 64 65 78 20 6e 61 6d 65 20 61 6e     index name an
a520: 64 20 61 20 66 6c 61 67 20 74 6f 20 69 6e 64 69  d a flag to indi
a530: 63 61 74 65 20 77 68 65 74 68 65 72 20 6f 72 20  cate whether or 
a540: 6e 6f 74 20 74 68 65 20 69 6e 64 65 78 20 6d 75  not the index mu
a550: 73 74 20 62 65 0a 20 20 20 20 75 6e 69 71 75 65  st be.    unique
a560: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
a570: 3e 50 52 41 47 4d 41 20 70 61 72 73 65 72 5f 74  >PRAGMA parser_t
a580: 72 61 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52  race = ON;<br>PR
a590: 41 47 4d 41 20 70 61 72 73 65 72 5f 74 72 61 63  AGMA parser_trac
a5a0: 65 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e  e = OFF;</b></p>
a5b0: 0a 20 20 20 20 3c 70 3e 54 75 72 6e 20 74 72 61  .    <p>Turn tra
a5c0: 63 69 6e 67 20 6f 66 20 74 68 65 20 53 51 4c 20  cing of the SQL 
a5d0: 70 61 72 73 65 72 20 69 6e 73 69 64 65 20 6f 66  parser inside of
a5e0: 20 74 68 65 0a 20 20 20 20 53 51 4c 69 74 65 20   the.    SQLite 
a5f0: 6c 69 62 72 61 72 79 20 6f 6e 20 61 6e 64 20 6f  library on and o
a600: 66 66 2e 20 20 54 68 69 73 20 69 73 20 75 73 65  ff.  This is use
a610: 64 20 66 6f 72 20 64 65 62 75 67 67 69 6e 67 2e  d for debugging.
a620: 0a 20 20 20 20 54 68 69 73 20 6f 6e 6c 79 20 77  .    This only w
a630: 6f 72 6b 73 20 69 66 20 74 68 65 20 6c 69 62 72  orks if the libr
a640: 61 72 79 20 69 73 20 63 6f 6d 70 69 6c 65 64 20  ary is compiled 
a650: 77 69 74 68 6f 75 74 20 74 68 65 20 4e 44 45 42  without the NDEB
a660: 55 47 20 6d 61 63 72 6f 2e 0a 20 20 20 20 3c 2f  UG macro..    </
a670: 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e  p></li>..<li><p>
a680: 3c 62 3e 50 52 41 47 4d 41 20 69 6e 74 65 67 72  <b>PRAGMA integr
a690: 69 74 79 5f 63 68 65 63 6b 3b 3c 2f 62 3e 3c 2f  ity_check;</b></
a6a0: 70 3e 0a 20 20 20 20 3c 70 3e 54 68 65 20 63 6f  p>.    <p>The co
a6b0: 6d 6d 61 6e 64 20 64 6f 65 73 20 61 6e 20 69 6e  mmand does an in
a6c0: 74 65 67 72 69 74 79 20 63 68 65 63 6b 20 6f 66  tegrity check of
a6d0: 20 74 68 65 20 65 6e 74 69 72 65 20 64 61 74 61   the entire data
a6e0: 62 61 73 65 2e 20 20 49 74 0a 20 20 20 20 6c 6f  base.  It.    lo
a6f0: 6f 6b 73 20 66 6f 72 20 6f 75 74 2d 6f 66 2d 6f  oks for out-of-o
a700: 72 64 65 72 20 72 65 63 6f 72 64 73 2c 20 6d 69  rder records, mi
a710: 73 73 69 6e 67 20 70 61 67 65 73 2c 20 61 6e 64  ssing pages, and
a720: 20 6d 61 6c 66 6f 72 6d 65 64 20 72 65 63 6f 72   malformed recor
a730: 64 73 2e 0a 20 20 20 20 49 66 20 61 6e 79 20 70  ds..    If any p
a740: 72 6f 62 6c 65 6d 73 20 61 72 65 20 66 6f 75 6e  roblems are foun
a750: 64 2c 20 74 68 65 6e 20 61 20 73 69 6e 67 6c 65  d, then a single
a760: 20 73 74 72 69 6e 67 20 69 73 20 72 65 74 75 72   string is retur
a770: 6e 65 64 20 77 68 69 63 68 20 69 73 0a 20 20 20  ned which is.   
a780: 20 61 20 64 65 73 63 72 69 70 74 69 6f 6e 20 6f   a description o
a790: 66 20 61 6c 6c 20 70 72 6f 62 6c 65 6d 73 2e 20  f all problems. 
a7a0: 20 49 66 20 65 76 65 72 79 74 68 69 6e 67 20 69   If everything i
a7b0: 73 20 69 6e 20 6f 72 64 65 72 2c 20 22 6f 6b 22  s in order, "ok"
a7c0: 20 69 73 0a 20 20 20 20 72 65 74 75 72 6e 65 64   is.    returned
a7d0: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
a7e0: 3e 50 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e  >PRAGMA synchron
a7f0: 6f 75 73 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e  ous;.       <br>
a800: 50 52 41 47 4d 41 20 73 79 6e 63 68 72 6f 6e 6f  PRAGMA synchrono
a810: 75 73 20 3d 20 4f 4e 3b 0a 20 20 20 20 20 20 20  us = ON;.       
a820: 3c 62 72 3e 50 52 41 47 4d 41 20 73 79 6e 63 68  <br>PRAGMA synch
a830: 72 6f 6e 6f 75 73 20 3d 20 4f 46 46 3b 3c 2f 62  ronous = OFF;</b
a840: 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 51 75 65  ></p>.    <p>Que
a850: 72 79 20 6f 72 20 63 68 61 6e 67 65 20 74 68 65  ry or change the
a860: 20 73 65 74 74 69 6e 67 20 6f 66 20 74 68 65 20   setting of the 
a870: 22 73 79 6e 63 68 72 6f 6e 6f 75 73 22 20 66 6c  "synchronous" fl
a880: 61 67 20 69 6e 0a 20 20 20 20 74 68 65 20 64 61  ag in.    the da
a890: 74 61 62 61 73 65 20 66 6f 72 20 74 68 65 20 64  tabase for the d
a8a0: 75 72 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 63  uration of the c
a8b0: 75 72 72 65 6e 74 20 64 61 74 61 62 61 73 65 20  urrent database 
a8c0: 63 6f 6e 6e 65 63 74 2e 0a 20 20 20 20 54 68 65  connect..    The
a8d0: 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 66 6c 61   synchronous fla
a8e0: 67 20 72 65 76 65 72 74 73 20 74 6f 20 69 74 73  g reverts to its
a8f0: 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 77   default value w
a900: 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65  hen the database
a910: 0a 20 20 20 20 69 73 20 63 6c 6f 73 65 64 20 61  .    is closed a
a920: 6e 64 20 72 65 6f 70 65 6e 65 64 2e 20 20 46 6f  nd reopened.  Fo
a930: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
a940: 6f 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20  ormation on the 
a950: 73 79 6e 63 68 72 6f 6e 6f 75 73 0a 20 20 20 20  synchronous.    
a960: 66 6c 61 67 2c 20 73 65 65 20 74 68 65 20 64 65  flag, see the de
a970: 73 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65  scription of the
a980: 20 3c 62 3e 64 65 66 61 75 6c 74 5f 73 79 6e 63   <b>default_sync
a990: 68 72 6f 6e 6f 75 73 3c 2f 62 3e 20 70 72 61 67  hronous</b> prag
a9a0: 6d 61 2e 3c 2f 70 3e 0a 20 20 20 20 3c 2f 6c 69  ma.</p>.    </li
a9b0: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41  >..<li><p><b>PRA
a9c0: 47 4d 41 20 74 61 62 6c 65 5f 69 6e 66 6f 28 3c  GMA table_info(<
a9d0: 2f 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e 61 6d 65  /b><i>table-name
a9e0: 3c 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f 70  </i><b>);</b></p
a9f0: 3e 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65 61 63  >.    <p>For eac
aa00: 68 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20  h column in the 
aa10: 6e 61 6d 65 64 20 74 61 62 6c 65 2c 20 69 6e 76  named table, inv
aa20: 6f 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63 6b  oke the callback
aa30: 20 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f 6e   function.    on
aa40: 63 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61 74  ce with informat
aa50: 69 6f 6e 20 61 62 6f 75 74 20 74 68 61 74 20 63  ion about that c
aa60: 6f 6c 75 6d 6e 2c 20 69 6e 63 6c 75 64 69 6e 67  olumn, including
aa70: 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65   the column name
aa80: 2c 0a 20 20 20 20 64 61 74 61 20 74 79 70 65 2c  ,.    data type,
aa90: 20 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20   whether or not 
aaa0: 74 68 65 20 63 6f 6c 75 6d 6e 20 63 61 6e 20 62  the column can b
aab0: 65 20 4e 55 4c 4c 2c 20 61 6e 64 20 74 68 65 20  e NULL, and the 
aac0: 64 65 66 61 75 6c 74 0a 20 20 20 20 76 61 6c 75  default.    valu
aad0: 65 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e  e for the column
aae0: 2e 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  .</p>..<li><p><b
aaf0: 3e 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72 61  >PRAGMA vdbe_tra
ab00: 63 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41 47  ce = ON;<br>PRAG
ab10: 4d 41 20 76 64 62 65 5f 74 72 61 63 65 20 3d 20  MA vdbe_trace = 
ab20: 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  OFF;</b></p>.   
ab30: 20 3c 70 3e 54 75 72 6e 20 74 72 61 63 69 6e 67   <p>Turn tracing
ab40: 20 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20   of the virtual 
ab50: 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20  database engine 
ab60: 69 6e 73 69 64 65 20 6f 66 20 74 68 65 0a 20 20  inside of the.  
ab70: 20 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79    SQLite library
ab80: 20 6f 6e 20 61 6e 64 20 6f 66 66 2e 20 20 54 68   on and off.  Th
ab90: 69 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 64  is is used for d
aba0: 65 62 75 67 67 69 6e 67 2e 3c 2f 70 3e 3c 2f 6c  ebugging.</p></l
abb0: 69 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 70 3e 4e 6f 20  i>.</ul>..<p>No 
abc0: 65 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73  error message is
abd0: 20 67 65 6e 65 72 61 74 65 64 20 69 66 20 61 6e   generated if an
abe0: 20 75 6e 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 20   unknown pragma 
abf0: 69 73 20 69 73 73 75 65 64 2e 0a 55 6e 6b 6e 6f  is issued..Unkno
ac00: 77 6e 20 70 72 61 67 6d 61 73 20 61 72 65 20 69  wn pragmas are i
ac10: 67 6e 6f 72 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 53  gnored.</p>.}..S
ac20: 65 63 74 69 6f 6e 20 52 45 50 4c 41 43 45 20 72  ection REPLACE r
ac30: 65 70 6c 61 63 65 0a 0a 53 79 6e 74 61 78 20 7b  eplace..Syntax {
ac40: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
ac50: 0a 52 45 50 4c 41 43 45 20 49 4e 54 4f 20 3c 74  .REPLACE INTO <t
ac60: 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63  able-name> [( <c
ac70: 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 56  olumn-list> )] V
ac80: 41 4c 55 45 53 20 28 20 3c 76 61 6c 75 65 2d 6c  ALUES ( <value-l
ac90: 69 73 74 3e 20 29 20 7c 0a 52 45 50 4c 41 43 45  ist> ) |.REPLACE
aca0: 20 49 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d   INTO <table-nam
acb0: 65 3e 20 5b 28 20 3c 63 6f 6c 75 6d 6e 2d 6c 69  e> [( <column-li
acc0: 73 74 3e 20 29 5d 20 3c 73 65 6c 65 63 74 2d 73  st> )] <select-s
acd0: 74 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74  tatement>.}..put
ace0: 73 20 7b 0a 3c 70 3e 54 68 65 20 52 45 50 4c 41  s {.<p>The REPLA
acf0: 43 45 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e  CE command is an
ad00: 20 61 6c 69 61 73 20 66 6f 72 20 74 68 65 20 22   alias for the "
ad10: 49 4e 53 45 52 54 20 4f 52 20 52 45 50 4c 41 43  INSERT OR REPLAC
ad20: 45 22 20 76 61 72 69 61 6e 74 0a 6f 66 20 74 68  E" variant.of th
ad30: 65 20 3c 61 20 68 72 65 66 3d 22 23 69 6e 73 65  e <a href="#inse
ad40: 72 74 22 3e 49 4e 53 45 52 54 20 63 6f 6d 6d 61  rt">INSERT comma
ad50: 6e 64 3c 2f 61 3e 2e 20 20 54 68 69 73 20 61 6c  nd</a>.  This al
ad60: 69 61 73 20 69 73 20 70 72 6f 76 69 64 65 64 20  ias is provided 
ad70: 66 6f 72 0a 63 6f 6d 70 61 74 69 62 69 6c 69 74  for.compatibilit
ad80: 79 20 77 69 74 68 20 4d 79 53 51 4c 2e 20 20 53  y with MySQL.  S
ad90: 65 65 20 74 68 65 20 0a 3c 61 20 68 72 65 66 3d  ee the .<a href=
ada0: 22 23 69 6e 73 65 72 74 22 3e 49 4e 53 45 52 54  "#insert">INSERT
adb0: 20 63 6f 6d 6d 61 6e 64 3c 2f 61 3e 20 64 6f 63   command</a> doc
adc0: 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61  umentation for a
add0: 64 64 69 74 69 6f 6e 61 6c 0a 69 6e 66 6f 72 6d  dditional.inform
ade0: 61 74 69 6f 6e 2e 3c 2f 70 3e 20 20 0a 7d 0a 0a  ation.</p>  .}..
adf0: 53 65 63 74 69 6f 6e 20 53 45 4c 45 43 54 20 73  Section SELECT s
ae00: 65 6c 65 63 74 0a 0a 53 79 6e 74 61 78 20 7b 73  elect..Syntax {s
ae10: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a  ql-statement} {.
ae20: 53 45 4c 45 43 54 20 3c 72 65 73 75 6c 74 3e 20  SELECT <result> 
ae30: 5b 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6c 69 73  [FROM <table-lis
ae40: 74 3e 5d 0a 5b 57 48 45 52 45 20 3c 65 78 70 72  t>].[WHERE <expr
ae50: 3e 5d 0a 5b 47 52 4f 55 50 20 42 59 20 3c 65 78  >].[GROUP BY <ex
ae60: 70 72 2d 6c 69 73 74 3e 5d 0a 5b 48 41 56 49 4e  pr-list>].[HAVIN
ae70: 47 20 3c 65 78 70 72 3e 5d 0a 5b 3c 63 6f 6d 70  G <expr>].[<comp
ae80: 6f 75 6e 64 2d 6f 70 3e 20 3c 73 65 6c 65 63 74  ound-op> <select
ae90: 3e 5d 2a 0a 5b 4f 52 44 45 52 20 42 59 20 3c 73  >]*.[ORDER BY <s
aea0: 6f 72 74 2d 65 78 70 72 2d 6c 69 73 74 3e 5d 0a  ort-expr-list>].
aeb0: 5b 4c 49 4d 49 54 20 3c 69 6e 74 65 67 65 72 3e  [LIMIT <integer>
aec0: 20 5b 4f 46 46 53 45 54 20 3c 69 6e 74 65 67 65   [OFFSET <intege
aed0: 72 3e 5d 5d 0a 7d 20 7b 72 65 73 75 6c 74 7d 20  r>]].} {result} 
aee0: 7b 0a 3c 72 65 73 75 6c 74 2d 63 6f 6c 75 6d 6e  {.<result-column
aef0: 3e 20 5b 2c 20 3c 72 65 73 75 6c 74 2d 63 6f 6c  > [, <result-col
af00: 75 6d 6e 3e 5d 2a 0a 7d 20 7b 72 65 73 75 6c 74  umn>]*.} {result
af10: 2d 63 6f 6c 75 6d 6e 7d 20 7b 0a 53 54 41 52 20  -column} {.STAR 
af20: 7c 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 2e  | <table-name> .
af30: 20 53 54 41 52 20 7c 20 3c 65 78 70 72 3e 20 5b   STAR | <expr> [
af40: 20 5b 41 53 5d 20 3c 73 74 72 69 6e 67 3e 20 5d   [AS] <string> ]
af50: 0a 7d 20 7b 74 61 62 6c 65 2d 6c 69 73 74 7d 20  .} {table-list} 
af60: 7b 0a 3c 74 61 62 6c 65 3e 20 5b 3c 6a 6f 69 6e  {.<table> [<join
af70: 2d 6f 70 3e 20 3c 74 61 62 6c 65 3e 20 3c 6a 6f  -op> <table> <jo
af80: 69 6e 2d 61 72 67 73 3e 5d 2a 0a 7d 20 7b 74 61  in-args>]*.} {ta
af90: 62 6c 65 7d 20 7b 0a 3c 74 61 62 6c 65 2d 6e 61  ble} {.<table-na
afa0: 6d 65 3e 20 5b 41 53 20 3c 61 6c 69 61 73 3e 5d  me> [AS <alias>]
afb0: 20 7c 0a 28 20 3c 73 65 6c 65 63 74 3e 20 29 20   |.( <select> ) 
afc0: 5b 41 53 20 3c 61 6c 69 61 73 3e 5d 0a 7d 20 7b  [AS <alias>].} {
afd0: 6a 6f 69 6e 2d 6f 70 7d 20 7b 0a 2c 20 7c 20 5b  join-op} {., | [
afe0: 4e 41 54 55 52 41 4c 5d 20 5b 4c 45 46 54 20 7c  NATURAL] [LEFT |
aff0: 20 52 49 47 48 54 20 7c 20 46 55 4c 4c 5d 20 5b   RIGHT | FULL] [
b000: 4f 55 54 45 52 20 7c 20 49 4e 4e 45 52 5d 20 4a  OUTER | INNER] J
b010: 4f 49 4e 0a 7d 20 7b 6a 6f 69 6e 2d 61 72 67 73  OIN.} {join-args
b020: 7d 20 7b 0a 5b 4f 4e 20 3c 65 78 70 72 3e 5d 20  } {.[ON <expr>] 
b030: 5b 55 53 49 4e 47 20 28 20 3c 69 64 2d 6c 69 73  [USING ( <id-lis
b040: 74 3e 20 29 5d 0a 7d 20 7b 73 6f 72 74 2d 65 78  t> )].} {sort-ex
b050: 70 72 2d 6c 69 73 74 7d 20 7b 0a 3c 65 78 70 72  pr-list} {.<expr
b060: 3e 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72 3e 5d  > [<sort-order>]
b070: 20 5b 2c 20 3c 65 78 70 72 3e 20 5b 3c 73 6f 72   [, <expr> [<sor
b080: 74 2d 6f 72 64 65 72 3e 5d 5d 2a 0a 7d 20 7b 73  t-order>]]*.} {s
b090: 6f 72 74 2d 6f 72 64 65 72 7d 20 7b 0a 41 53 43  ort-order} {.ASC
b0a0: 20 7c 20 44 45 53 43 0a 7d 20 7b 63 6f 6d 70 6f   | DESC.} {compo
b0b0: 75 6e 64 5f 6f 70 7d 20 7b 0a 55 4e 49 4f 4e 20  und_op} {.UNION 
b0c0: 7c 20 55 4e 49 4f 4e 20 41 4c 4c 20 7c 20 49 4e  | UNION ALL | IN
b0d0: 54 45 52 53 45 43 54 20 7c 20 45 58 43 45 50 54  TERSECT | EXCEPT
b0e0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
b0f0: 65 20 53 45 4c 45 43 54 20 73 74 61 74 65 6d 65  e SELECT stateme
b100: 6e 74 20 69 73 20 75 73 65 64 20 74 6f 20 71 75  nt is used to qu
b110: 65 72 79 20 74 68 65 20 64 61 74 61 62 61 73 65  ery the database
b120: 2e 20 20 54 68 65 0a 72 65 73 75 6c 74 20 6f 66  .  The.result of
b130: 20 61 20 53 45 4c 45 43 54 20 69 73 20 7a 65 72   a SELECT is zer
b140: 6f 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73 20 6f  o or more rows o
b150: 66 20 64 61 74 61 20 77 68 65 72 65 20 65 61 63  f data where eac
b160: 68 20 72 6f 77 0a 68 61 73 20 61 20 66 69 78 65  h row.has a fixe
b170: 64 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75  d number of colu
b180: 6d 6e 73 2e 20 20 54 68 65 20 6e 75 6d 62 65 72  mns.  The number
b190: 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74   of columns in t
b1a0: 68 65 0a 72 65 73 75 6c 74 20 69 73 20 73 70 65  he.result is spe
b1b0: 63 69 66 69 65 64 20 62 79 20 74 68 65 20 65 78  cified by the ex
b1c0: 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 20 69 6e  pression list in
b1d0: 20 62 65 74 77 65 65 6e 20 74 68 65 0a 53 45 4c   between the.SEL
b1e0: 45 43 54 20 61 6e 64 20 46 52 4f 4d 20 6b 65 79  ECT and FROM key
b1f0: 77 6f 72 64 73 2e 20 20 41 6e 79 20 61 72 62 69  words.  Any arbi
b200: 74 72 61 72 79 20 65 78 70 72 65 73 73 69 6f 6e  trary expression
b210: 20 63 61 6e 20 62 65 20 75 73 65 64 0a 61 73 20   can be used.as 
b220: 61 20 72 65 73 75 6c 74 2e 20 20 49 66 20 61 20  a result.  If a 
b230: 72 65 73 75 6c 74 20 65 78 70 72 65 73 73 69 6f  result expressio
b240: 6e 20 69 73 20 7d 0a 70 75 74 73 20 22 5b 4f 70  n is }.puts "[Op
b250: 65 72 61 74 6f 72 20 2a 5d 20 74 68 65 6e 20 61  erator *] then a
b260: 6c 6c 20 63 6f 6c 75 6d 6e 73 20 6f 66 20 61 6c  ll columns of al
b270: 6c 20 74 61 62 6c 65 73 20 61 72 65 20 73 75 62  l tables are sub
b280: 73 74 69 74 75 74 65 64 22 0a 70 75 74 73 20 7b  stituted".puts {
b290: 66 6f 72 20 74 68 61 74 20 6f 6e 65 20 65 78 70  for that one exp
b2a0: 72 65 73 73 69 6f 6e 2e 20 20 49 66 20 74 68 65  ression.  If the
b2b0: 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73 20 74   expression is t
b2c0: 68 65 20 6e 61 6d 65 20 6f 66 7d 0a 70 75 74 73  he name of}.puts
b2d0: 20 22 61 20 74 61 62 6c 65 20 66 6f 6c 6c 6f 77   "a table follow
b2e0: 65 64 20 62 79 20 5b 4f 70 65 72 61 74 6f 72 20  ed by [Operator 
b2f0: 2e 2a 5d 20 74 68 65 6e 20 74 68 65 20 72 65 73  .*] then the res
b300: 75 6c 74 20 69 73 20 61 6c 6c 20 63 6f 6c 75 6d  ult is all colum
b310: 6e 73 22 0a 70 75 74 73 20 7b 69 6e 20 74 68 61  ns".puts {in tha
b320: 74 20 6f 6e 65 20 74 61 62 6c 65 2e 3c 2f 70 3e  t one table.</p>
b330: 0a 0a 3c 70 3e 54 68 65 20 71 75 65 72 79 20 69  ..<p>The query i
b340: 73 20 65 78 65 63 75 74 65 64 20 61 67 61 69 6e  s executed again
b350: 73 74 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 20 74  st one or more t
b360: 61 62 6c 65 73 20 73 70 65 63 69 66 69 65 64 20  ables specified 
b370: 61 66 74 65 72 0a 74 68 65 20 46 52 4f 4d 20 6b  after.the FROM k
b380: 65 79 77 6f 72 64 2e 20 20 49 66 20 6d 75 6c 74  eyword.  If mult
b390: 69 70 6c 65 20 74 61 62 6c 65 73 20 6e 61 6d 65  iple tables name
b3a0: 73 20 61 72 65 20 73 65 70 61 72 61 74 65 64 20  s are separated 
b3b0: 62 79 20 63 6f 6d 6d 61 73 2c 0a 74 68 65 6e 20  by commas,.then 
b3c0: 74 68 65 20 71 75 65 72 79 20 69 73 20 61 67 61  the query is aga
b3d0: 69 6e 73 74 20 74 68 65 20 63 72 6f 73 73 20 6a  inst the cross j
b3e0: 6f 69 6e 20 6f 66 20 74 68 65 20 76 61 72 69 6f  oin of the vario
b3f0: 75 73 20 74 61 62 6c 65 73 2e 0a 54 68 65 20 66  us tables..The f
b400: 75 6c 6c 20 53 51 4c 2d 39 32 20 6a 6f 69 6e 20  ull SQL-92 join 
b410: 73 79 6e 74 61 78 20 63 61 6e 20 61 6c 73 6f 20  syntax can also 
b420: 62 65 20 75 73 65 64 20 74 6f 20 73 70 65 63 69  be used to speci
b430: 66 79 20 6a 6f 69 6e 73 2e 0a 41 20 73 75 62 2d  fy joins..A sub-
b440: 71 75 65 72 79 0a 69 6e 20 70 61 72 65 6e 74 68  query.in parenth
b450: 65 73 65 73 20 6d 61 79 20 62 65 20 73 75 62 73  eses may be subs
b460: 74 69 74 75 74 65 64 20 66 6f 72 20 61 6e 79 20  tituted for any 
b470: 74 61 62 6c 65 20 6e 61 6d 65 20 69 6e 20 74 68  table name in th
b480: 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 2e 0a 54  e FROM clause..T
b490: 68 65 20 65 6e 74 69 72 65 20 46 52 4f 4d 20 63  he entire FROM c
b4a0: 6c 61 75 73 65 20 6d 61 79 20 62 65 20 6f 6d 69  lause may be omi
b4b0: 74 74 65 64 2c 20 69 6e 20 77 68 69 63 68 20 63  tted, in which c
b4c0: 61 73 65 20 74 68 65 20 72 65 73 75 6c 74 20 69  ase the result i
b4d0: 73 20 61 0a 73 69 6e 67 6c 65 20 72 6f 77 20 63  s a.single row c
b4e0: 6f 6e 73 69 73 74 69 6e 67 20 6f 66 20 74 68 65  onsisting of the
b4f0: 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65 20 65   values of the e
b500: 78 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 2e 0a  xpression list..
b510: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 57 48 45  </p>..<p>The WHE
b520: 52 45 20 63 6c 61 75 73 65 20 63 61 6e 20 62 65  RE clause can be
b530: 20 75 73 65 64 20 74 6f 20 6c 69 6d 69 74 20 74   used to limit t
b540: 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72 6f 77  he number of row
b550: 73 20 6f 76 65 72 0a 77 68 69 63 68 20 74 68 65  s over.which the
b560: 20 71 75 65 72 79 20 6f 70 65 72 61 74 65 73 2e   query operates.
b570: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47 52 4f  </p>..<p>The GRO
b580: 55 50 20 42 59 20 63 6c 61 75 73 65 73 20 63 61  UP BY clauses ca
b590: 75 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f 72 65  uses one or more
b5a0: 20 72 6f 77 73 20 6f 66 20 74 68 65 20 72 65 73   rows of the res
b5b0: 75 6c 74 20 74 6f 0a 62 65 20 63 6f 6d 62 69 6e  ult to.be combin
b5c0: 65 64 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65  ed into a single
b5d0: 20 72 6f 77 20 6f 66 20 6f 75 74 70 75 74 2e 20   row of output. 
b5e0: 20 54 68 69 73 20 69 73 20 65 73 70 65 63 69 61   This is especia
b5f0: 6c 6c 79 20 75 73 65 66 75 6c 0a 77 68 65 6e 20  lly useful.when 
b600: 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6e 74 61  the result conta
b610: 69 6e 73 20 61 67 67 72 65 67 61 74 65 20 66 75  ins aggregate fu
b620: 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65 20 65 78  nctions.  The ex
b630: 70 72 65 73 73 69 6f 6e 73 20 69 6e 0a 74 68 65  pressions in.the
b640: 20 47 52 4f 55 50 20 42 59 20 63 6c 61 75 73 65   GROUP BY clause
b650: 20 64 6f 20 3c 65 6d 3e 6e 6f 74 3c 2f 65 6d 3e   do <em>not</em>
b660: 20 68 61 76 65 20 74 6f 20 62 65 20 65 78 70 72   have to be expr
b670: 65 73 73 69 6f 6e 73 20 74 68 61 74 0a 61 70 70  essions that.app
b680: 65 61 72 20 69 6e 20 74 68 65 20 72 65 73 75 6c  ear in the resul
b690: 74 2e 20 20 54 68 65 20 48 41 56 49 4e 47 20 63  t.  The HAVING c
b6a0: 6c 61 75 73 65 20 69 73 20 73 69 6d 69 6c 61 72  lause is similar
b6b0: 20 74 6f 20 57 48 45 52 45 20 65 78 63 65 70 74   to WHERE except
b6c0: 0a 74 68 61 74 20 48 41 56 49 4e 47 20 61 70 70  .that HAVING app
b6d0: 6c 69 65 73 20 61 66 74 65 72 20 67 72 6f 75 70  lies after group
b6e0: 69 6e 67 20 68 61 73 20 6f 63 63 75 72 72 65 64  ing has occurred
b6f0: 2e 20 20 54 68 65 20 48 41 56 49 4e 47 20 65 78  .  The HAVING ex
b700: 70 72 65 73 73 69 6f 6e 0a 6d 61 79 20 72 65 66  pression.may ref
b710: 65 72 20 74 6f 20 76 61 6c 75 65 73 2c 20 65 76  er to values, ev
b720: 65 6e 20 61 67 67 72 65 67 61 74 65 20 66 75 6e  en aggregate fun
b730: 63 74 69 6f 6e 73 2c 20 74 68 61 74 20 61 72 65  ctions, that are
b740: 20 6e 6f 74 20 69 6e 20 74 68 65 20 72 65 73 75   not in the resu
b750: 6c 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  lt.</p>..<p>The 
b760: 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73 65 20  ORDER BY clause 
b770: 63 61 75 73 65 73 20 74 68 65 20 6f 75 74 70 75  causes the outpu
b780: 74 20 72 6f 77 73 20 74 6f 20 62 65 20 73 6f 72  t rows to be sor
b790: 74 65 64 2e 20 20 0a 54 68 65 20 61 72 67 75 6d  ted.  .The argum
b7a0: 65 6e 74 20 74 6f 20 4f 52 44 45 52 20 42 59 20  ent to ORDER BY 
b7b0: 69 73 20 61 20 6c 69 73 74 20 6f 66 20 65 78 70  is a list of exp
b7c0: 72 65 73 73 69 6f 6e 73 20 74 68 61 74 20 61 72  ressions that ar
b7d0: 65 20 75 73 65 64 20 61 73 20 74 68 65 0a 6b 65  e used as the.ke
b7e0: 79 20 66 6f 72 20 74 68 65 20 73 6f 72 74 2e 20  y for the sort. 
b7f0: 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 73   The expressions
b800: 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 74 6f 20   do not have to 
b810: 62 65 20 70 61 72 74 20 6f 66 20 74 68 65 0a 72  be part of the.r
b820: 65 73 75 6c 74 20 66 6f 72 20 61 20 73 69 6d 70  esult for a simp
b830: 6c 65 20 53 45 4c 45 43 54 2c 20 62 75 74 20 69  le SELECT, but i
b840: 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c  n a compound SEL
b850: 45 43 54 20 65 61 63 68 20 73 6f 72 74 0a 65 78  ECT each sort.ex
b860: 70 72 65 73 73 69 6f 6e 20 6d 75 73 74 20 65 78  pression must ex
b870: 61 63 74 6c 79 20 6d 61 74 63 68 20 6f 6e 65 20  actly match one 
b880: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f  of the result co
b890: 6c 75 6d 6e 73 2e 20 20 45 61 63 68 0a 73 6f 72  lumns.  Each.sor
b8a0: 74 20 65 78 70 72 65 73 73 69 6f 6e 20 6d 61 79  t expression may
b8b0: 20 62 65 20 6f 70 74 69 6f 6e 61 6c 6c 79 20 66   be optionally f
b8c0: 6f 6c 6c 6f 77 65 64 20 62 79 20 41 53 43 20 6f  ollowed by ASC o
b8d0: 72 20 44 45 53 43 20 74 6f 20 73 70 65 63 69 66  r DESC to specif
b8e0: 79 0a 74 68 65 20 73 6f 72 74 20 6f 72 64 65 72  y.the sort order
b8f0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4c 49  .</p>..<p>The LI
b900: 4d 49 54 20 63 6c 61 75 73 65 20 70 6c 61 63 65  MIT clause place
b910: 73 20 61 6e 20 75 70 70 65 72 20 62 6f 75 6e 64  s an upper bound
b920: 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72 20 6f   on the number o
b930: 66 20 72 6f 77 73 0a 72 65 74 75 72 6e 65 64 20  f rows.returned 
b940: 69 6e 20 74 68 65 20 72 65 73 75 6c 74 2e 20 20  in the result.  
b950: 41 20 4c 49 4d 49 54 20 6f 66 20 30 20 69 6e 64  A LIMIT of 0 ind
b960: 69 63 61 74 65 73 20 6e 6f 20 75 70 70 65 72 20  icates no upper 
b970: 62 6f 75 6e 64 2e 0a 54 68 65 20 6f 70 74 69 6f  bound..The optio
b980: 6e 61 6c 20 4f 46 46 53 45 54 20 66 6f 6c 6c 6f  nal OFFSET follo
b990: 77 69 6e 67 20 4c 49 4d 49 54 20 73 70 65 63 69  wing LIMIT speci
b9a0: 66 69 65 73 20 68 6f 77 20 6d 61 6e 79 0a 72 6f  fies how many.ro
b9b0: 77 73 20 74 6f 20 73 6b 69 70 20 61 74 20 74 68  ws to skip at th
b9c0: 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66 20 74  e beginning of t
b9d0: 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e 3c 2f  he result set.</
b9e0: 70 3e 0a 0a 3c 70 3e 41 20 63 6f 6d 70 6f 75 6e  p>..<p>A compoun
b9f0: 64 20 53 45 4c 45 43 54 20 69 73 20 66 6f 72 6d  d SELECT is form
ba00: 65 64 20 66 72 6f 6d 20 74 77 6f 20 6f 72 20 6d  ed from two or m
ba10: 6f 72 65 20 73 69 6d 70 6c 65 20 53 45 4c 45 43  ore simple SELEC
ba20: 54 73 20 63 6f 6e 6e 65 63 74 65 64 0a 62 79 20  Ts connected.by 
ba30: 6f 6e 65 20 6f 66 20 74 68 65 20 6f 70 65 72 61  one of the opera
ba40: 74 6f 72 73 20 55 4e 49 4f 4e 2c 20 55 4e 49 4f  tors UNION, UNIO
ba50: 4e 20 41 4c 4c 2c 20 49 4e 54 45 52 53 45 43 54  N ALL, INTERSECT
ba60: 2c 20 6f 72 20 45 58 43 45 50 54 2e 20 20 49 6e  , or EXCEPT.  In
ba70: 0a 61 20 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45  .a compound SELE
ba80: 43 54 2c 20 61 6c 6c 20 74 68 65 20 63 6f 6e 73  CT, all the cons
ba90: 74 69 74 75 65 6e 74 20 53 45 4c 45 43 54 73 20  tituent SELECTs 
baa0: 6d 75 73 74 20 73 70 65 63 69 66 79 20 74 68 65  must specify the
bab0: 0a 73 61 6d 65 20 6e 75 6d 62 65 72 20 6f 66 20  .same number of 
bac0: 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73 2e 20  result columns. 
bad0: 20 54 68 65 72 65 20 6d 61 79 20 62 65 20 6f 6e   There may be on
bae0: 6c 79 20 61 20 73 69 6e 67 6c 65 20 4f 52 44 45  ly a single ORDE
baf0: 52 20 42 59 0a 63 6c 61 75 73 65 20 61 74 20 74  R BY.clause at t
bb00: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 63 6f  he end of the co
bb10: 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2e 20 20  mpound SELECT.  
bb20: 54 68 65 20 55 4e 49 4f 4e 20 61 6e 64 20 55 4e  The UNION and UN
bb30: 49 4f 4e 20 41 4c 4c 0a 6f 70 65 72 61 74 6f 72  ION ALL.operator
bb40: 73 20 63 6f 6d 62 69 6e 65 20 74 68 65 20 72 65  s combine the re
bb50: 73 75 6c 74 73 20 6f 66 20 74 68 65 20 53 45 4c  sults of the SEL
bb60: 45 43 54 73 20 74 6f 20 74 68 65 20 72 69 67 68  ECTs to the righ
bb70: 74 20 61 6e 64 20 6c 65 66 74 20 69 6e 74 6f 0a  t and left into.
bb80: 61 20 73 69 6e 67 6c 65 20 62 69 67 20 74 61 62  a single big tab
bb90: 6c 65 2e 20 20 54 68 65 20 64 69 66 66 65 72 65  le.  The differe
bba0: 6e 63 65 20 69 73 20 74 68 61 74 20 69 6e 20 55  nce is that in U
bbb0: 4e 49 4f 4e 20 61 6c 6c 20 72 65 73 75 6c 74 20  NION all result 
bbc0: 72 6f 77 73 0a 61 72 65 20 64 69 73 74 69 6e 63  rows.are distinc
bbd0: 74 20 77 68 65 72 65 20 69 6e 20 55 4e 49 4f 4e  t where in UNION
bbe0: 20 41 4c 4c 20 74 68 65 72 65 20 6d 61 79 20 62   ALL there may b
bbf0: 65 20 64 75 70 6c 69 63 61 74 65 73 2e 0a 54 68  e duplicates..Th
bc00: 65 20 49 4e 54 45 52 53 45 43 54 20 6f 70 65 72  e INTERSECT oper
bc10: 61 74 6f 72 20 74 61 6b 65 73 20 74 68 65 20 69  ator takes the i
bc20: 6e 74 65 72 73 65 63 74 69 6f 6e 20 6f 66 20 74  ntersection of t
bc30: 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20 74 68  he results of th
bc40: 65 0a 6c 65 66 74 20 61 6e 64 20 72 69 67 68 74  e.left and right
bc50: 20 53 45 4c 45 43 54 73 2e 20 20 45 58 43 45 50   SELECTs.  EXCEP
bc60: 54 20 74 61 6b 65 73 20 74 68 65 20 72 65 73 75  T takes the resu
bc70: 6c 74 20 6f 66 20 6c 65 66 74 20 53 45 4c 45 43  lt of left SELEC
bc80: 54 20 61 66 74 65 72 0a 72 65 6d 6f 76 69 6e 67  T after.removing
bc90: 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20   the results of 
bca0: 74 68 65 20 72 69 67 68 74 20 53 45 4c 45 43 54  the right SELECT
bcb0: 2e 20 20 57 68 65 6e 20 74 68 72 65 65 20 61 72  .  When three ar
bcc0: 65 20 6d 6f 72 65 20 53 45 4c 45 43 54 73 0a 61  e more SELECTs.a
bcd0: 72 65 20 63 6f 6e 6e 65 63 74 65 64 20 69 6e 74  re connected int
bce0: 6f 20 61 20 63 6f 6d 70 6f 75 6e 64 2c 20 74 68  o a compound, th
bcf0: 65 79 20 67 72 6f 75 70 20 66 72 6f 6d 20 6c 65  ey group from le
bd00: 66 74 20 74 6f 20 72 69 67 68 74 2e 3c 2f 70 3e  ft to right.</p>
bd10: 0a 7d 0a 0a 53 65 63 74 69 6f 6e 20 55 50 44 41  .}..Section UPDA
bd20: 54 45 20 75 70 64 61 74 65 0a 0a 53 79 6e 74 61  TE update..Synta
bd30: 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  x {sql-statement
bd40: 7d 20 7b 0a 55 50 44 41 54 45 20 5b 20 4f 52 20  } {.UPDATE [ OR 
bd50: 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69  <conflict-algori
bd60: 74 68 6d 3e 20 5d 20 3c 74 61 62 6c 65 2d 6e 61  thm> ] <table-na
bd70: 6d 65 3e 0a 53 45 54 20 3c 61 73 73 69 67 6e 6d  me>.SET <assignm
bd80: 65 6e 74 3e 20 5b 2c 20 3c 61 73 73 69 67 6e 6d  ent> [, <assignm
bd90: 65 6e 74 3e 5d 20 0a 5b 57 48 45 52 45 20 3c 65  ent>] .[WHERE <e
bda0: 78 70 72 3e 5d 0a 7d 20 7b 61 73 73 69 67 6e 6d  xpr>].} {assignm
bdb0: 65 6e 74 7d 20 7b 0a 3c 63 6f 6c 75 6d 6e 2d 6e  ent} {.<column-n
bdc0: 61 6d 65 3e 20 3d 20 3c 65 78 70 72 3e 0a 7d 0a  ame> = <expr>.}.
bdd0: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 55  .puts {.<p>The U
bde0: 50 44 41 54 45 20 73 74 61 74 65 6d 65 6e 74 20  PDATE statement 
bdf0: 69 73 20 75 73 65 64 20 74 6f 20 63 68 61 6e 67  is used to chang
be00: 65 20 74 68 65 20 76 61 6c 75 65 20 6f 66 20 63  e the value of c
be10: 6f 6c 75 6d 6e 73 20 69 6e 20 0a 73 65 6c 65 63  olumns in .selec
be20: 74 65 64 20 72 6f 77 73 20 6f 66 20 61 20 74 61  ted rows of a ta
be30: 62 6c 65 2e 20 20 45 61 63 68 20 61 73 73 69 67  ble.  Each assig
be40: 6e 6d 65 6e 74 20 69 6e 20 61 6e 20 55 50 44 41  nment in an UPDA
be50: 54 45 20 73 70 65 63 69 66 69 65 73 0a 61 20 63  TE specifies.a c
be60: 6f 6c 75 6d 6e 20 6e 61 6d 65 20 74 6f 20 74 68  olumn name to th
be70: 65 20 6c 65 66 74 20 6f 66 20 74 68 65 20 65 71  e left of the eq
be80: 75 61 6c 73 20 73 69 67 6e 20 61 6e 64 20 61 6e  uals sign and an
be90: 20 61 72 62 69 74 72 61 72 79 20 65 78 70 72 65   arbitrary expre
bea0: 73 73 69 6f 6e 0a 74 6f 20 74 68 65 20 72 69 67  ssion.to the rig
beb0: 68 74 2e 20 20 54 68 65 20 65 78 70 72 65 73 73  ht.  The express
bec0: 69 6f 6e 73 20 6d 61 79 20 75 73 65 20 74 68 65  ions may use the
bed0: 20 76 61 6c 75 65 73 20 6f 66 20 6f 74 68 65 72   values of other
bee0: 20 63 6f 6c 75 6d 6e 73 2e 0a 41 6c 6c 20 65 78   columns..All ex
bef0: 70 72 65 73 73 69 6f 6e 73 20 61 72 65 20 65 76  pressions are ev
bf00: 61 6c 75 61 74 65 64 20 62 65 66 6f 72 65 20 61  aluated before a
bf10: 6e 79 20 61 73 73 69 67 6e 6d 65 6e 74 73 20 61  ny assignments a
bf20: 72 65 20 6d 61 64 65 2e 0a 41 20 57 48 45 52 45  re made..A WHERE
bf30: 20 63 6c 61 75 73 65 20 63 61 6e 20 62 65 20 75   clause can be u
bf40: 73 65 64 20 74 6f 20 72 65 73 74 72 69 63 74 20  sed to restrict 
bf50: 77 68 69 63 68 20 72 6f 77 73 20 61 72 65 20 75  which rows are u
bf60: 70 64 61 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e  pdated.</p>..<p>
bf70: 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f 6e  The optional con
bf80: 66 6c 69 63 74 2d 63 6c 61 75 73 65 20 61 6c 6c  flict-clause all
bf90: 6f 77 73 20 74 68 65 20 73 70 65 63 69 66 69 63  ows the specific
bfa0: 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61 6c 74 65  ation of an alte
bfb0: 72 6e 61 74 69 76 65 0a 63 6f 6e 73 74 72 61 69  rnative.constrai
bfc0: 6e 74 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f  nt conflict reso
bfd0: 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d  lution algorithm
bfe0: 20 74 6f 20 75 73 65 20 64 75 72 69 6e 67 20 74   to use during t
bff0: 68 69 73 20 6f 6e 65 20 63 6f 6d 6d 61 6e 64 2e  his one command.
c000: 0a 53 65 65 20 74 68 65 20 73 65 63 74 69 6f 6e  .See the section
c010: 20 74 69 74 6c 65 64 0a 3c 61 20 68 72 65 66 3d   titled.<a href=
c020: 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f 4e 20 43  "#conflict">ON C
c030: 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66 6f 72 20  ONFLICT</a> for 
c040: 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72  additional infor
c050: 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 7d 0a 0a 53  mation.</p>.}..S
c060: 65 63 74 69 6f 6e 20 56 41 43 55 55 4d 20 76 61  ection VACUUM va
c070: 63 75 75 6d 0a 0a 53 79 6e 74 61 78 20 7b 73 71  cuum..Syntax {sq
c080: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 56  l-statement} {.V
c090: 41 43 55 55 4d 20 5b 3c 69 6e 64 65 78 2d 6f 72  ACUUM [<index-or
c0a0: 2d 74 61 62 6c 65 2d 6e 61 6d 65 3e 5d 0a 7d 0a  -table-name>].}.
c0b0: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 56  .puts {.<p>The V
c0c0: 41 43 55 55 4d 20 63 6f 6d 6d 61 6e 64 20 69 73  ACUUM command is
c0d0: 20 61 6e 20 53 51 4c 69 74 65 20 65 78 74 65 6e   an SQLite exten
c0e0: 73 69 6f 6e 20 6d 6f 64 65 6c 6c 65 64 20 61 66  sion modelled af
c0f0: 74 65 72 20 61 20 73 69 6d 69 6c 61 72 0a 63 6f  ter a similar.co
c100: 6d 6d 61 6e 64 20 66 6f 75 6e 64 20 69 6e 20 50  mmand found in P
c110: 6f 73 74 67 72 65 53 51 4c 2e 20 20 49 66 20 56  ostgreSQL.  If V
c120: 41 43 55 55 4d 20 69 73 20 69 6e 76 6f 6b 65 64  ACUUM is invoked
c130: 20 77 69 74 68 20 74 68 65 20 6e 61 6d 65 20 6f   with the name o
c140: 66 20 61 0a 74 61 62 6c 65 20 6f 72 20 69 6e 64  f a.table or ind
c150: 65 78 20 74 68 65 6e 20 69 74 20 69 73 20 73 75  ex then it is su
c160: 70 70 6f 73 65 20 74 6f 20 63 6c 65 61 6e 20 75  ppose to clean u
c170: 70 20 74 68 65 20 6e 61 6d 65 64 20 74 61 62 6c  p the named tabl
c180: 65 20 6f 72 20 69 6e 64 65 78 2e 0a 49 6e 20 76  e or index..In v
c190: 65 72 73 69 6f 6e 20 31 2e 30 20 6f 66 20 53 51  ersion 1.0 of SQ
c1a0: 4c 69 74 65 2c 20 74 68 65 20 56 41 43 55 55 4d  Lite, the VACUUM
c1b0: 20 63 6f 6d 6d 61 6e 64 20 77 6f 75 6c 64 20 69   command would i
c1c0: 6e 76 6f 6b 65 20 0a 3c 62 3e 67 64 62 6d 5f 72  nvoke .<b>gdbm_r
c1d0: 65 6f 72 67 61 6e 69 7a 65 28 29 3c 2f 62 3e 20  eorganize()</b> 
c1e0: 74 6f 20 63 6c 65 61 6e 20 75 70 20 74 68 65 20  to clean up the 
c1f0: 62 61 63 6b 65 6e 64 20 64 61 74 61 62 61 73 65  backend database
c200: 20 66 69 6c 65 2e 0a 42 65 67 69 6e 6e 69 6e 67   file..Beginning
c210: 20 77 69 74 68 20 76 65 72 73 69 6f 6e 20 32 2e   with version 2.
c220: 30 20 6f 66 20 53 51 4c 69 74 65 2c 20 47 44 42  0 of SQLite, GDB
c230: 4d 20 69 73 20 6e 6f 20 6c 6f 6e 67 65 72 20 75  M is no longer u
c240: 73 65 64 20 66 6f 72 0a 74 68 65 20 64 61 74 61  sed for.the data
c250: 62 61 73 65 20 62 61 63 6b 65 6e 64 20 61 6e 64  base backend and
c260: 20 56 41 43 55 55 4d 20 68 61 73 20 62 65 63 6f   VACUUM has beco
c270: 6d 65 20 61 20 6e 6f 2d 6f 70 2e 0a 3c 2f 70 3e  me a no-op..</p>
c280: 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 3c  .}...puts {.<p><
c290: 68 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e 3c 61 20  hr /></p>.<p><a 
c2a0: 68 72 65 66 3d 22 69 6e 64 65 78 2e 68 74 6d 6c  href="index.html
c2b0: 22 3e 3c 69 6d 67 20 73 72 63 3d 22 2f 67 6f 62  "><img src="/gob
c2c0: 61 63 6b 2e 6a 70 67 22 20 62 6f 72 64 65 72 3d  ack.jpg" border=
c2d0: 30 20 2f 3e 0a 42 61 63 6b 20 74 6f 20 74 68 65  0 />.Back to the
c2e0: 20 53 51 4c 69 74 65 20 48 6f 6d 65 20 50 61 67   SQLite Home Pag
c2f0: 65 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 2f 62 6f  e</a>.</p>..</bo
c300: 64 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a              dy></html>}.