/ Hex Artifact Content
Login

Artifact 1852abb0efcff02cc15a0d7f4c3a2a1b9c06c256:


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 35 31 20 32 30 30 33  .tcl,v 1.51 2003
0060: 2f 30 35 2f 30 33 20 30 34 3a 35 35 3a 31 39 20  /05/03 04:55:19 
0070: 6a 70 6c 79 6f 6e 20 45 78 70 20 24 7d 0a 0a 70  jplyon Exp $}..p
0080: 75 74 73 20 7b 3c 68 74 6d 6c 3e 0a 3c 68 65 61  uts {<html>.<hea
0090: 64 3e 0a 20 20 3c 74 69 74 6c 65 3e 51 75 65 72  d>.  <title>Quer
00a0: 79 20 4c 61 6e 67 75 61 67 65 20 55 6e 64 65 72  y Language Under
00b0: 73 74 6f 6f 64 20 42 79 20 53 51 4c 69 74 65 3c  stood By SQLite<
00c0: 2f 74 69 74 6c 65 3e 0a 3c 2f 68 65 61 64 3e 0a  /title>.</head>.
00d0: 3c 62 6f 64 79 20 62 67 63 6f 6c 6f 72 3d 77 68  <body bgcolor=wh
00e0: 69 74 65 3e 0a 3c 68 31 20 61 6c 69 67 6e 3d 63  ite>.<h1 align=c
00f0: 65 6e 74 65 72 3e 0a 53 51 4c 20 41 73 20 55 6e  enter>.SQL As Un
0100: 64 65 72 73 74 6f 6f 64 20 42 79 20 53 51 4c 69  derstood By SQLi
0110: 74 65 0a 3c 2f 68 31 3e 7d 0a 70 75 74 73 20 22  te.</h1>}.puts "
0120: 3c 70 20 61 6c 69 67 6e 3d 63 65 6e 74 65 72 3e  <p align=center>
0130: 0a 28 54 68 69 73 20 70 61 67 65 20 77 61 73 20  .(This page was 
0140: 6c 61 73 74 20 6d 6f 64 69 66 69 65 64 20 6f 6e  last modified on
0150: 20 5b 6c 72 61 6e 67 65 20 24 72 63 73 69 64 20   [lrange $rcsid 
0160: 33 20 34 5d 20 55 54 43 29 0a 3c 2f 70 3e 22 0a  3 4] UTC).</p>".
0170: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 53  .puts {.<p>The S
0180: 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20 75 6e  QLite library un
0190: 64 65 72 73 74 61 6e 64 73 20 6d 6f 73 74 20 6f  derstands most o
01a0: 66 20 74 68 65 20 73 74 61 6e 64 61 72 64 20 53  f the standard S
01b0: 51 4c 0a 6c 61 6e 67 75 61 67 65 2e 20 20 42 75  QL.language.  Bu
01c0: 74 20 69 74 20 64 6f 65 73 20 3c 61 20 68 72 65  t it does <a hre
01d0: 66 3d 22 6f 6d 69 74 74 65 64 2e 68 74 6d 6c 22  f="omitted.html"
01e0: 3e 6f 6d 69 74 20 73 6f 6d 65 20 66 65 61 74 75  >omit some featu
01f0: 72 65 73 3c 2f 61 3e 0a 77 68 69 6c 65 20 61 74  res</a>.while at
0200: 20 74 68 65 20 73 61 6d 65 20 74 69 6d 65 0a 61   the same time.a
0210: 64 64 69 6e 67 20 61 20 66 65 77 20 66 65 61 74  dding a few feat
0220: 75 72 65 73 20 6f 66 20 69 74 73 20 6f 77 6e 2e  ures of its own.
0230: 20 20 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20    This document 
0240: 61 74 74 65 6d 70 74 73 20 74 6f 0a 64 65 73 63  attempts to.desc
0250: 72 69 62 65 20 70 65 72 63 69 73 65 6c 79 20 77  ribe percisely w
0260: 68 61 74 20 70 61 72 74 73 20 6f 66 20 74 68 65  hat parts of the
0270: 20 53 51 4c 20 6c 61 6e 67 75 61 67 65 20 53 51   SQL language SQ
0280: 4c 69 74 65 20 64 6f 65 73 0a 61 6e 64 20 64 6f  Lite does.and do
0290: 65 73 20 6e 6f 74 20 73 75 70 70 6f 72 74 2e 3c  es not support.<
02a0: 2f 70 3e 0a 0a 3c 70 3e 49 6e 20 61 6c 6c 20 6f  /p>..<p>In all o
02b0: 66 20 74 68 65 20 73 79 6e 74 61 78 20 64 69 61  f the syntax dia
02c0: 67 72 61 6d 73 20 74 68 61 74 20 66 6f 6c 6c 6f  grams that follo
02d0: 77 2c 20 6c 69 74 65 72 61 6c 20 74 65 78 74 20  w, literal text 
02e0: 69 73 20 73 68 6f 77 6e 20 69 6e 0a 62 6f 6c 64  is shown in.bold
02f0: 20 62 6c 75 65 2e 20 20 4e 6f 6e 2d 74 65 72 6d   blue.  Non-term
0300: 69 6e 61 6c 20 73 79 6d 62 6f 6c 73 20 61 72 65  inal symbols are
0310: 20 73 68 6f 77 6e 20 69 6e 20 69 74 61 6c 69 63   shown in italic
0320: 20 72 65 64 2e 20 20 4f 70 65 72 61 74 6f 72 73   red.  Operators
0330: 0a 74 68 61 74 20 61 72 65 20 70 61 72 74 20 6f  .that are part o
0340: 66 20 74 68 65 20 73 79 6e 74 61 63 74 69 63 20  f the syntactic 
0350: 6d 61 72 6b 75 70 20 69 74 73 65 6c 66 20 61 72  markup itself ar
0360: 65 20 73 68 6f 77 6e 20 69 6e 20 62 6c 61 63 6b  e shown in black
0370: 20 72 6f 6d 61 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e   roman.</p>..<p>
0380: 54 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 69 73  This document is
0390: 20 6a 75 73 74 20 61 6e 20 6f 76 65 72 76 69 65   just an overvie
03a0: 77 20 6f 66 20 74 68 65 20 53 51 4c 20 73 79 6e  w of the SQL syn
03b0: 74 61 78 20 69 6d 70 6c 65 6d 65 6e 74 65 64 0a  tax implemented.
03c0: 62 79 20 53 51 4c 69 74 65 2e 20 20 4d 61 6e 79  by SQLite.  Many
03d0: 20 6c 6f 77 2d 6c 65 76 65 6c 20 70 72 6f 64 75   low-level produ
03e0: 63 74 69 6f 6e 73 20 61 72 65 20 6f 6d 69 74 74  ctions are omitt
03f0: 65 64 2e 20 20 46 6f 72 20 64 65 74 61 69 6c 65  ed.  For detaile
0400: 64 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 0a 6f 6e  d information.on
0410: 20 74 68 65 20 6c 61 6e 67 75 61 67 65 20 74 68   the language th
0420: 61 74 20 53 51 4c 69 74 65 20 75 6e 64 65 72 73  at SQLite unders
0430: 74 61 6e 64 73 2c 20 72 65 66 65 72 20 74 6f 20  tands, refer to 
0440: 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 2e  the source code.
0450: 3c 2f 70 3e 0a 0a 0a 3c 70 3e 53 51 4c 69 74 65  </p>...<p>SQLite
0460: 20 69 6d 70 6c 65 6d 65 6e 74 73 20 74 68 65 20   implements the 
0470: 66 6f 6c 6c 6f 77 20 73 79 6e 74 61 78 3a 3c 2f  follow syntax:</
0480: 70 3e 0a 3c 70 3e 3c 75 6c 3e 0a 7d 0a 0a 66 6f  p>.<p><ul>.}..fo
0490: 72 65 61 63 68 20 7b 73 65 63 74 69 6f 6e 7d 20  reach {section} 
04a0: 5b 6c 73 6f 72 74 20 2d 69 6e 64 65 78 20 30 20  [lsort -index 0 
04b0: 2d 64 69 63 74 69 6f 6e 61 72 79 20 7b 0a 20 20  -dictionary {.  
04c0: 7b 7b 43 52 45 41 54 45 20 54 41 42 4c 45 7d 20  {{CREATE TABLE} 
04d0: 63 72 65 61 74 65 74 61 62 6c 65 7d 0a 20 20 7b  createtable}.  {
04e0: 7b 43 52 45 41 54 45 20 49 4e 44 45 58 7d 20 63  {CREATE INDEX} c
04f0: 72 65 61 74 65 69 6e 64 65 78 7d 0a 20 20 7b 56  reateindex}.  {V
0500: 41 43 55 55 4d 20 76 61 63 75 75 6d 7d 0a 20 20  ACUUM vacuum}.  
0510: 7b 7b 44 52 4f 50 20 54 41 42 4c 45 7d 20 64 72  {{DROP TABLE} dr
0520: 6f 70 74 61 62 6c 65 7d 0a 20 20 7b 7b 44 52 4f  optable}.  {{DRO
0530: 50 20 49 4e 44 45 58 7d 20 64 72 6f 70 69 6e 64  P INDEX} dropind
0540: 65 78 7d 0a 20 20 7b 49 4e 53 45 52 54 20 69 6e  ex}.  {INSERT in
0550: 73 65 72 74 7d 0a 20 20 7b 52 45 50 4c 41 43 45  sert}.  {REPLACE
0560: 20 72 65 70 6c 61 63 65 7d 0a 20 20 7b 44 45 4c   replace}.  {DEL
0570: 45 54 45 20 64 65 6c 65 74 65 7d 0a 20 20 7b 55  ETE delete}.  {U
0580: 50 44 41 54 45 20 75 70 64 61 74 65 7d 0a 20 20  PDATE update}.  
0590: 7b 53 45 4c 45 43 54 20 73 65 6c 65 63 74 7d 0a  {SELECT select}.
05a0: 20 20 7b 63 6f 6d 6d 65 6e 74 20 63 6f 6d 6d 65    {comment comme
05b0: 6e 74 7d 0a 20 20 7b 43 4f 50 59 20 63 6f 70 79  nt}.  {COPY copy
05c0: 7d 0a 20 20 7b 45 58 50 4c 41 49 4e 20 65 78 70  }.  {EXPLAIN exp
05d0: 6c 61 69 6e 7d 0a 20 20 7b 65 78 70 72 65 73 73  lain}.  {express
05e0: 69 6f 6e 20 65 78 70 72 7d 0a 20 20 7b 7b 42 45  ion expr}.  {{BE
05f0: 47 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 7d  GIN TRANSACTION}
0600: 20 74 72 61 6e 73 61 63 74 69 6f 6e 7d 0a 20 20   transaction}.  
0610: 7b 50 52 41 47 4d 41 20 70 72 61 67 6d 61 7d 0a  {PRAGMA pragma}.
0620: 20 20 7b 7b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20    {{ON CONFLICT 
0630: 63 6c 61 75 73 65 7d 20 63 6f 6e 66 6c 69 63 74  clause} conflict
0640: 7d 0a 20 20 7b 7b 43 52 45 41 54 45 20 56 49 45  }.  {{CREATE VIE
0650: 57 7d 20 63 72 65 61 74 65 76 69 65 77 7d 0a 20  W} createview}. 
0660: 20 7b 7b 44 52 4f 50 20 56 49 45 57 7d 20 64 72   {{DROP VIEW} dr
0670: 6f 70 76 69 65 77 7d 0a 20 20 7b 7b 43 52 45 41  opview}.  {{CREA
0680: 54 45 20 54 52 49 47 47 45 52 7d 20 63 72 65 61  TE TRIGGER} crea
0690: 74 65 74 72 69 67 67 65 72 7d 0a 20 20 7b 7b 44  tetrigger}.  {{D
06a0: 52 4f 50 20 54 52 49 47 47 45 52 7d 20 64 72 6f  ROP TRIGGER} dro
06b0: 70 74 72 69 67 67 65 72 7d 0a 20 20 7b 7b 41 54  ptrigger}.  {{AT
06c0: 54 41 43 48 20 44 41 54 41 42 41 53 45 7d 20 61  TACH DATABASE} a
06d0: 74 74 61 63 68 64 61 74 61 62 61 73 65 7d 0a 20  ttachdatabase}. 
06e0: 20 7b 7b 44 45 54 41 43 48 20 44 41 54 41 42 41   {{DETACH DATABA
06f0: 53 45 7d 20 64 65 74 61 63 68 64 61 74 61 62 61  SE} detachdataba
0700: 73 65 7d 0a 7d 5d 20 7b 0a 20 20 70 75 74 73 20  se}.}] {.  puts 
0710: 22 3c 6c 69 3e 3c 61 20 68 72 65 66 3d 5c 22 23  "<li><a href=\"#
0720: 5b 6c 69 6e 64 65 78 20 24 73 65 63 74 69 6f 6e  [lindex $section
0730: 20 31 5d 5c 22 3e 5b 6c 69 6e 64 65 78 20 24 73   1]\">[lindex $s
0740: 65 63 74 69 6f 6e 20 30 5d 3c 2f 61 3e 3c 2f 6c  ection 0]</a></l
0750: 69 3e 22 0a 7d 0a 70 75 74 73 20 7b 3c 2f 75 6c  i>".}.puts {</ul
0760: 3e 3c 2f 70 3e 0a 0a 3c 70 3e 44 65 74 61 69 6c  ></p>..<p>Detail
0770: 73 20 6f 6e 20 74 68 65 20 69 6d 70 6c 65 6d 65  s on the impleme
0780: 6e 74 61 74 69 6f 6e 20 6f 66 20 65 61 63 68 20  ntation of each 
0790: 63 6f 6d 6d 61 6e 64 20 61 72 65 20 70 72 6f 76  command are prov
07a0: 69 64 65 64 20 69 6e 0a 74 68 65 20 73 65 71 75  ided in.the sequ
07b0: 65 6c 2e 3c 2f 70 3e 0a 7d 0a 0a 70 72 6f 63 20  el.</p>.}..proc 
07c0: 53 79 6e 74 61 78 20 7b 61 72 67 73 7d 20 7b 0a  Syntax {args} {.
07d0: 20 20 70 75 74 73 20 7b 3c 74 61 62 6c 65 20 63    puts {<table c
07e0: 65 6c 6c 70 61 64 64 69 6e 67 3d 22 31 30 22 3e  ellpadding="10">
07f0: 7d 0a 20 20 66 6f 72 65 61 63 68 20 7b 72 75 6c  }.  foreach {rul
0800: 65 20 62 6f 64 79 7d 20 24 61 72 67 73 20 7b 0a  e body} $args {.
0810: 20 20 20 20 70 75 74 73 20 22 3c 74 72 3e 3c 74      puts "<tr><t
0820: 64 20 61 6c 69 67 6e 3d 5c 22 72 69 67 68 74 5c  d align=\"right\
0830: 22 20 76 61 6c 69 67 6e 3d 5c 22 74 6f 70 5c 22  " valign=\"top\"
0840: 3e 22 0a 20 20 20 20 70 75 74 73 20 22 3c 69 3e  >".    puts "<i>
0850: 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 66  <font color=\"#f
0860: 66 33 34 33 34 5c 22 3e 24 72 75 6c 65 3c 2f 66  f3434\">$rule</f
0870: 6f 6e 74 3e 3c 2f 69 3e 26 6e 62 73 70 3b 3a 3a  ont></i>&nbsp;::
0880: 3d 3c 2f 74 64 3e 22 0a 20 20 20 20 72 65 67 73  =</td>".    regs
0890: 75 62 20 2d 61 6c 6c 20 3c 20 24 62 6f 64 79 20  ub -all < $body 
08a0: 7b 25 4c 54 7d 20 62 6f 64 79 0a 20 20 20 20 72  {%LT} body.    r
08b0: 65 67 73 75 62 20 2d 61 6c 6c 20 3e 20 24 62 6f  egsub -all > $bo
08c0: 64 79 20 7b 25 47 54 7d 20 62 6f 64 79 0a 20 20  dy {%GT} body.  
08d0: 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 25 4c    regsub -all %L
08e0: 54 20 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e 74 3e  T $body {</font>
08f0: 3c 2f 62 3e 3c 69 3e 3c 66 6f 6e 74 20 63 6f 6c  </b><i><font col
0900: 6f 72 3d 22 23 66 66 33 34 33 34 22 3e 7d 20 62  or="#ff3434">} b
0910: 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62 20 2d  ody.    regsub -
0920: 61 6c 6c 20 25 47 54 20 24 62 6f 64 79 20 7b 3c  all %GT $body {<
0930: 2f 66 6f 6e 74 3e 3c 2f 69 3e 3c 62 3e 3c 66 6f  /font></i><b><fo
0940: 6e 74 20 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66  nt color="#2c2cf
0950: 30 22 3e 7d 20 62 6f 64 79 0a 20 20 20 20 72 65  0">} body.    re
0960: 67 73 75 62 20 2d 61 6c 6c 20 7b 5b 5d 7c 5b 2a  gsub -all {[]|[*
0970: 3f 5d 7d 20 24 62 6f 64 79 20 7b 3c 2f 66 6f 6e  ?]} $body {</fon
0980: 74 3e 3c 2f 62 3e 26 3c 62 3e 3c 66 6f 6e 74 20  t></b>&<b><font 
0990: 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e  color="#2c2cf0">
09a0: 7d 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75  } body.    regsu
09b0: 62 20 2d 61 6c 6c 20 22 5c 6e 22 20 5b 73 74 72  b -all "\n" [str
09c0: 69 6e 67 20 74 72 69 6d 20 24 62 6f 64 79 5d 20  ing trim $body] 
09d0: 22 3c 62 72 3e 5c 6e 22 20 62 6f 64 79 0a 20 20  "<br>\n" body.  
09e0: 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 22 5c    regsub -all "\
09f0: 6e 20 20 2a 22 20 24 62 6f 64 79 20 22 5c 6e 5c  n  *" $body "\n\
0a00: 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62 73 70 3b 5c  \&nbsp;\\&nbsp;\
0a10: 5c 26 6e 62 73 70 3b 5c 5c 26 6e 62 73 70 3b 22  \&nbsp;\\&nbsp;"
0a20: 20 62 6f 64 79 0a 20 20 20 20 72 65 67 73 75 62   body.    regsub
0a30: 20 2d 61 6c 6c 20 7b 5b 7c 2c 2e 2a 28 29 5d 7d   -all {[|,.*()]}
0a40: 20 24 62 6f 64 79 20 7b 3c 62 69 67 3e 26 3c 2f   $body {<big>&</
0a50: 62 69 67 3e 7d 20 62 6f 64 79 0a 20 20 20 20 72  big>} body.    r
0a60: 65 67 73 75 62 20 2d 61 6c 6c 20 7b 20 3d 20 7d  egsub -all { = }
0a70: 20 24 62 6f 64 79 20 7b 20 3c 62 69 67 3e 3d 3c   $body { <big>=<
0a80: 2f 62 69 67 3e 20 7d 20 62 6f 64 79 0a 20 20 20  /big> } body.   
0a90: 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 53 54   regsub -all {ST
0aa0: 41 52 7d 20 24 62 6f 64 79 20 7b 3c 62 69 67 3e  AR} $body {<big>
0ab0: 2a 3c 2f 62 69 67 3e 7d 20 62 6f 64 79 0a 20 20  *</big>} body.  
0ac0: 20 20 70 75 74 73 20 22 3c 74 64 3e 3c 62 3e 3c    puts "<td><b><
0ad0: 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22 23 32 63  font color=\"#2c
0ae0: 32 63 66 30 5c 22 3e 24 62 6f 64 79 3c 2f 66 6f  2cf0\">$body</fo
0af0: 6e 74 3e 3c 2f 62 3e 3c 2f 74 64 3e 3c 2f 74 72  nt></b></td></tr
0b00: 3e 22 0a 20 20 7d 0a 20 20 70 75 74 73 20 7b 3c  >".  }.  puts {<
0b10: 2f 74 61 62 6c 65 3e 7d 0a 7d 0a 70 72 6f 63 20  /table>}.}.proc 
0b20: 4f 70 65 72 61 74 6f 72 20 7b 6e 61 6d 65 7d 20  Operator {name} 
0b30: 7b 0a 20 20 72 65 74 75 72 6e 20 22 3c 66 6f 6e  {.  return "<fon
0b40: 74 20 63 6f 6c 6f 72 3d 5c 22 23 32 63 32 63 66  t color=\"#2c2cf
0b50: 30 5c 22 3e 3c 62 69 67 3e 24 6e 61 6d 65 3c 2f  0\"><big>$name</
0b60: 62 69 67 3e 3c 2f 66 6f 6e 74 3e 22 0a 7d 0a 70  big></font>".}.p
0b70: 72 6f 63 20 4e 6f 6e 74 65 72 6d 69 6e 61 6c 20  roc Nonterminal 
0b80: 7b 6e 61 6d 65 7d 20 7b 0a 20 20 72 65 74 75 72  {name} {.  retur
0b90: 6e 20 22 3c 69 3e 3c 66 6f 6e 74 20 63 6f 6c 6f  n "<i><font colo
0ba0: 72 3d 5c 22 23 66 66 33 34 33 34 5c 22 3e 24 6e  r=\"#ff3434\">$n
0bb0: 61 6d 65 3c 2f 66 6f 6e 74 3e 3c 2f 69 3e 22 0a  ame</font></i>".
0bc0: 7d 0a 70 72 6f 63 20 4b 65 79 77 6f 72 64 20 7b  }.proc Keyword {
0bd0: 6e 61 6d 65 7d 20 7b 0a 20 20 72 65 74 75 72 6e  name} {.  return
0be0: 20 22 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 5c 22   "<font color=\"
0bf0: 23 32 63 32 63 66 30 5c 22 3e 24 6e 61 6d 65 3c  #2c2cf0\">$name<
0c00: 2f 66 6f 6e 74 3e 22 0a 7d 0a 20 0a 0a 70 72 6f  /font>".}. ..pro
0c10: 63 20 53 65 63 74 69 6f 6e 20 7b 6e 61 6d 65 20  c Section {name 
0c20: 7b 6c 61 62 65 6c 20 7b 7d 7d 7d 20 7b 0a 20 20  {label {}}} {.  
0c30: 70 75 74 73 20 22 5c 6e 3c 68 72 20 2f 3e 22 0a  puts "\n<hr />".
0c40: 20 20 69 66 20 7b 24 6c 61 62 65 6c 21 3d 22 22    if {$label!=""
0c50: 7d 20 7b 0a 20 20 20 20 70 75 74 73 20 22 3c 61  } {.    puts "<a
0c60: 20 6e 61 6d 65 3d 5c 22 24 6c 61 62 65 6c 5c 22   name=\"$label\"
0c70: 3e 22 0a 20 20 7d 0a 20 20 70 75 74 73 20 22 3c  >".  }.  puts "<
0c80: 68 31 3e 24 6e 61 6d 65 3c 2f 68 31 3e 5c 6e 22  h1>$name</h1>\n"
0c90: 0a 7d 0a 0a 70 72 6f 63 20 45 78 61 6d 70 6c 65  .}..proc Example
0ca0: 20 7b 74 65 78 74 7d 20 7b 0a 20 20 70 75 74 73   {text} {.  puts
0cb0: 20 22 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70   "<blockquote><p
0cc0: 72 65 3e 24 74 65 78 74 3c 2f 70 72 65 3e 3c 2f  re>$text</pre></
0cd0: 62 6c 6f 63 6b 71 75 6f 74 65 3e 22 0a 7d 0a 0a  blockquote>".}..
0ce0: 0a 53 65 63 74 69 6f 6e 20 7b 41 54 54 41 43 48  .Section {ATTACH
0cf0: 20 44 41 54 41 42 41 53 45 7d 20 61 74 74 61 63   DATABASE} attac
0d00: 68 64 61 74 61 62 61 73 65 0a 0a 53 79 6e 74 61  hdatabase..Synta
0d10: 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74  x {sql-statement
0d20: 7d 20 7b 0a 41 54 54 41 43 48 20 5b 44 41 54 41  } {.ATTACH [DATA
0d30: 42 41 53 45 5d 20 3c 64 61 74 61 62 61 73 65 2d  BASE] <database-
0d40: 66 69 6c 65 6e 61 6d 65 3e 20 41 53 20 3c 64 61  filename> AS <da
0d50: 74 61 62 61 73 65 2d 6e 61 6d 65 3e 0a 7d 0a 0a  tabase-name>.}..
0d60: 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 41 54  puts {.<p>The AT
0d70: 54 41 43 48 20 44 41 54 41 42 41 53 45 20 73 74  TACH DATABASE st
0d80: 61 74 65 6d 65 6e 74 20 6c 65 74 73 20 79 6f 75  atement lets you
0d90: 20 61 64 64 20 61 20 70 72 65 65 78 69 73 74 69   add a preexisti
0da0: 6e 67 20 0a 64 61 74 61 62 61 73 65 20 66 69 6c  ng .database fil
0db0: 65 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74  e to the current
0dc0: 20 64 61 74 61 62 61 73 65 20 63 6f 6e 6e 65 63   database connec
0dd0: 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e 59 6f  tion.</p>..<p>Yo
0de0: 75 20 63 61 6e 20 72 65 61 64 20 61 6e 64 20 77  u can read and w
0df0: 72 69 74 65 20 74 6f 20 74 68 65 20 61 74 74 61  rite to the atta
0e00: 63 68 65 64 20 64 61 74 61 62 61 73 65 2c 20 62  ched database, b
0e10: 75 74 20 79 6f 75 20 63 61 6e 6e 6f 74 20 0a 43  ut you cannot .C
0e20: 52 45 41 54 45 20 54 41 42 4c 45 20 6f 72 20 44  REATE TABLE or D
0e30: 52 4f 50 20 54 41 42 4c 45 20 69 6e 20 74 68 65  ROP TABLE in the
0e40: 20 61 74 74 61 63 68 65 64 20 64 61 74 61 62 61   attached databa
0e50: 73 65 2e 20 59 6f 75 20 63 61 6e 20 6f 6e 6c 79  se. You can only
0e60: 20 0a 43 52 45 41 54 45 20 61 6e 64 20 44 52 4f   .CREATE and DRO
0e70: 50 20 69 6e 20 74 68 65 20 6f 72 69 67 69 6e 61  P in the origina
0e80: 6c 20 64 61 74 61 62 61 73 65 2e 3c 2f 70 3e 0a  l database.</p>.
0e90: 0a 3c 70 3e 57 69 74 68 20 61 6e 20 61 74 74 61  .<p>With an atta
0ea0: 63 68 65 64 20 64 61 74 61 62 61 73 65 2c 20 74  ched database, t
0eb0: 72 61 6e 73 61 63 74 69 6f 6e 73 20 61 72 65 20  ransactions are 
0ec0: 6e 6f 74 20 61 74 6f 6d 69 63 2e 20 0a 54 72 61  not atomic. .Tra
0ed0: 6e 73 61 63 74 69 6f 6e 73 20 63 6f 6e 74 69 6e  nsactions contin
0ee0: 75 65 20 74 6f 20 62 65 20 61 74 6f 6d 69 63 20  ue to be atomic 
0ef0: 77 69 74 68 69 6e 20 65 61 63 68 20 69 6e 64 69  within each indi
0f00: 76 69 64 75 61 6c 0a 64 61 74 61 62 61 73 65 20  vidual.database 
0f10: 66 69 6c 65 2e 20 42 75 74 20 69 66 20 79 6f 75  file. But if you
0f20: 72 20 6d 61 63 68 69 6e 65 20 63 72 61 73 68 65  r machine crashe
0f30: 73 20 69 6e 20 74 68 65 20 6d 69 64 64 6c 65 0a  s in the middle.
0f40: 6f 66 20 61 20 43 4f 4d 4d 49 54 20 77 68 65 72  of a COMMIT wher
0f50: 65 20 79 6f 75 20 68 61 76 65 20 75 70 64 61 74  e you have updat
0f60: 65 64 20 74 77 6f 20 6f 72 20 6d 6f 72 65 20 64  ed two or more d
0f70: 61 74 61 62 61 73 65 0a 66 69 6c 65 73 2c 20 73  atabase.files, s
0f80: 6f 6d 65 20 6f 66 20 74 68 6f 73 65 20 66 69 6c  ome of those fil
0f90: 65 73 20 6d 69 67 68 74 20 67 65 74 20 74 68 65  es might get the
0fa0: 20 63 68 61 6e 67 65 73 20 77 68 65 72 65 20 6f   changes where o
0fb0: 74 68 65 72 73 0a 6d 69 67 68 74 20 6e 6f 74 2e  thers.might not.
0fc0: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 69  </p>..<p>There i
0fd0: 73 20 61 20 63 6f 6d 70 69 6c 65 2d 74 69 6d 65  s a compile-time
0fe0: 20 6c 69 6d 69 74 20 6f 66 20 31 30 20 61 74 74   limit of 10 att
0ff0: 61 63 68 65 64 20 64 61 74 61 62 61 73 65 20 66  ached database f
1000: 69 6c 65 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 45 78  iles.</p>..<p>Ex
1010: 65 63 75 74 69 6e 67 20 61 20 42 45 47 49 4e 20  ecuting a BEGIN 
1020: 54 52 41 4e 53 41 43 54 49 4f 4e 20 73 74 61 74  TRANSACTION stat
1030: 65 6d 65 6e 74 20 6c 6f 63 6b 73 20 61 6c 6c 20  ement locks all 
1040: 64 61 74 61 62 61 73 65 0a 66 69 6c 65 73 2c 20  database.files, 
1050: 73 6f 20 74 68 69 73 20 66 65 61 74 75 72 65 20  so this feature 
1060: 63 61 6e 6e 6f 74 20 28 63 75 72 72 65 6e 74 6c  cannot (currentl
1070: 79 29 20 62 65 20 75 73 65 64 20 74 6f 20 69 6e  y) be used to in
1080: 63 72 65 61 73 65 20 0a 63 6f 6e 63 75 72 72 61  crease .concurra
1090: 6e 63 79 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63  ncy.</p>.}...Sec
10a0: 74 69 6f 6e 20 7b 42 45 47 49 4e 20 54 52 41 4e  tion {BEGIN TRAN
10b0: 53 41 43 54 49 4f 4e 7d 20 74 72 61 6e 73 61 63  SACTION} transac
10c0: 74 69 6f 6e 0a 0a 53 79 6e 74 61 78 20 7b 73 71  tion..Syntax {sq
10d0: 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 42  l-statement} {.B
10e0: 45 47 49 4e 20 5b 54 52 41 4e 53 41 43 54 49 4f  EGIN [TRANSACTIO
10f0: 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 20 5b 4f 4e 20  N [<name>]] [ON 
1100: 43 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c 69  CONFLICT <confli
1110: 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 5d 0a 7d  ct-algorithm>].}
1120: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61  .Syntax {sql-sta
1130: 74 65 6d 65 6e 74 7d 20 7b 0a 45 4e 44 20 5b 54  tement} {.END [T
1140: 52 41 4e 53 41 43 54 49 4f 4e 20 5b 3c 6e 61 6d  RANSACTION [<nam
1150: 65 3e 5d 5d 0a 7d 0a 53 79 6e 74 61 78 20 7b 73  e>]].}.Syntax {s
1160: 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b 0a  ql-statement} {.
1170: 43 4f 4d 4d 49 54 20 5b 54 52 41 4e 53 41 43 54  COMMIT [TRANSACT
1180: 49 4f 4e 20 5b 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a  ION [<name>]].}.
1190: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74  Syntax {sql-stat
11a0: 65 6d 65 6e 74 7d 20 7b 0a 52 4f 4c 4c 42 41 43  ement} {.ROLLBAC
11b0: 4b 20 5b 54 52 41 4e 53 41 43 54 49 4f 4e 20 5b  K [TRANSACTION [
11c0: 3c 6e 61 6d 65 3e 5d 5d 0a 7d 0a 0a 70 75 74 73  <name>]].}..puts
11d0: 20 7b 0a 3c 70 3e 42 65 67 69 6e 6e 69 6e 67 20   {.<p>Beginning 
11e0: 69 6e 20 76 65 72 73 69 6f 6e 20 32 2e 30 2c 20  in version 2.0, 
11f0: 53 51 4c 69 74 65 20 73 75 70 70 6f 72 74 73 20  SQLite supports 
1200: 74 72 61 6e 73 61 63 74 69 6f 6e 73 20 77 69 74  transactions wit
1210: 68 0a 72 6f 6c 6c 62 61 63 6b 20 61 6e 64 20 61  h.rollback and a
1220: 74 6f 6d 69 63 20 63 6f 6d 6d 69 74 2e 3c 2f 70  tomic commit.</p
1230: 3e 0a 0a 3c 70 3e 0a 4e 6f 20 63 68 61 6e 67 65  >..<p>.No change
1240: 73 20 63 61 6e 20 62 65 20 6d 61 64 65 20 74 6f  s can be made to
1250: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 65 78   the database ex
1260: 63 65 70 74 20 77 69 74 68 69 6e 20 61 20 74 72  cept within a tr
1270: 61 6e 73 61 63 74 69 6f 6e 2e 0a 41 6e 79 20 63  ansaction..Any c
1280: 6f 6d 6d 61 6e 64 20 74 68 61 74 20 63 68 61 6e  ommand that chan
1290: 67 65 73 20 74 68 65 20 64 61 74 61 62 61 73 65  ges the database
12a0: 20 28 62 61 73 69 63 61 6c 6c 79 2c 20 61 6e 79   (basically, any
12b0: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a 6f 74 68   SQL command.oth
12c0: 65 72 20 74 68 61 6e 20 53 45 4c 45 43 54 29 20  er than SELECT) 
12d0: 77 69 6c 6c 20 61 75 74 6f 6d 61 74 69 63 61 6c  will automatical
12e0: 6c 79 20 73 74 61 72 74 73 20 61 20 74 72 61 6e  ly starts a tran
12f0: 73 61 63 74 69 6f 6e 20 69 66 0a 6f 6e 65 20 69  saction if.one i
1300: 73 20 6e 6f 74 20 61 6c 72 65 61 64 79 20 69 6e  s not already in
1310: 20 65 66 66 65 63 74 2e 20 20 41 75 74 6f 6d 61   effect.  Automa
1320: 74 69 63 61 6c 6c 79 20 73 74 61 72 74 65 64 20  tically started 
1330: 74 72 61 6e 73 61 63 74 69 6f 6e 73 0a 61 72 65  transactions.are
1340: 20 63 6f 6d 6d 69 74 74 65 64 20 61 74 20 74 68   committed at th
1350: 65 20 63 6f 6e 63 6c 75 73 69 6f 6e 20 6f 66 20  e conclusion of 
1360: 74 68 65 20 63 6f 6d 6d 61 6e 64 2e 0a 3c 2f 70  the command..</p
1370: 3e 0a 0a 3c 70 3e 0a 54 72 61 6e 73 61 63 74 69  >..<p>.Transacti
1380: 6f 6e 73 20 63 61 6e 20 62 65 20 73 74 61 72 74  ons can be start
1390: 65 64 20 6d 61 6e 75 61 6c 6c 79 20 75 73 69 6e  ed manually usin
13a0: 67 20 74 68 65 20 42 45 47 49 4e 0a 63 6f 6d 6d  g the BEGIN.comm
13b0: 61 6e 64 2e 20 53 75 63 68 20 74 72 61 6e 73 61  and. Such transa
13c0: 63 74 69 6f 6e 73 20 75 73 75 61 6c 6c 79 20 70  ctions usually p
13d0: 65 72 73 69 73 74 20 75 6e 74 69 6c 20 74 68 65  ersist until the
13e0: 20 6e 65 78 74 0a 43 4f 4d 4d 49 54 20 6f 72 20   next.COMMIT or 
13f0: 52 4f 4c 4c 42 41 43 4b 20 63 6f 6d 6d 61 6e 64  ROLLBACK command
1400: 2e 20 42 75 74 20 61 20 74 72 61 6e 73 61 63 74  . But a transact
1410: 69 6f 6e 20 77 69 6c 6c 20 61 6c 73 6f 20 0a 52  ion will also .R
1420: 4f 4c 4c 42 41 43 4b 20 69 66 20 74 68 65 20 64  OLLBACK if the d
1430: 61 74 61 62 61 73 65 20 69 73 20 63 6c 6f 73 65  atabase is close
1440: 64 20 6f 72 20 69 66 20 61 6e 20 65 72 72 6f 72  d or if an error
1450: 20 6f 63 63 75 72 73 0a 61 6e 64 20 74 68 65 20   occurs.and the 
1460: 52 4f 4c 4c 42 41 43 4b 20 63 6f 6e 66 6c 69 63  ROLLBACK conflic
1470: 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67  t resolution alg
1480: 6f 72 69 74 68 6d 20 69 73 20 73 70 65 63 69 66  orithm is specif
1490: 69 65 64 2e 0a 53 65 65 20 74 68 65 20 64 6f 63  ied..See the doc
14a0: 75 6d 65 6e 74 69 6f 6e 20 6f 6e 20 74 68 65 20  umention on the 
14b0: 3c 61 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69  <a href="#confli
14c0: 63 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c  ct">ON CONFLICT<
14d0: 2f 61 3e 0a 63 6c 61 75 73 65 20 66 6f 72 20 61  /a>.clause for a
14e0: 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d  dditional inform
14f0: 61 74 69 6f 6e 20 61 62 6f 75 74 20 74 68 65 20  ation about the 
1500: 52 4f 4c 4c 42 41 43 4b 0a 63 6f 6e 66 6c 69 63  ROLLBACK.conflic
1510: 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67  t resolution alg
1520: 6f 72 69 74 68 6d 2e 0a 3c 2f 70 3e 0a 0a 3c 70  orithm..</p>..<p
1530: 3e 0a 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 4f  >.The optional O
1540: 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73  N CONFLICT claus
1550: 65 20 61 74 20 74 68 65 20 65 6e 64 20 6f 66 20  e at the end of 
1560: 61 20 42 45 47 49 4e 20 73 74 61 74 65 6d 65 6e  a BEGIN statemen
1570: 74 0a 63 61 6e 20 62 65 20 75 73 65 64 20 74 6f  t.can be used to
1580: 20 63 68 61 6e 67 65 64 20 74 68 65 20 64 65 66   changed the def
1590: 61 75 6c 74 20 63 6f 6e 66 6c 69 63 74 20 72 65  ault conflict re
15a0: 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74  solution algorit
15b0: 68 6d 2e 0a 54 68 65 20 6e 6f 72 6d 61 6c 20 64  hm..The normal d
15c0: 65 66 61 75 6c 74 20 69 73 20 41 42 4f 52 54 2e  efault is ABORT.
15d0: 20 20 49 66 20 61 6e 20 61 6c 74 65 72 6e 61 74    If an alternat
15e0: 69 76 65 20 69 73 20 73 70 65 63 69 66 69 65 64  ive is specified
15f0: 20 62 79 0a 74 68 65 20 4f 4e 20 43 4f 4e 46 4c   by.the ON CONFL
1600: 49 43 54 20 63 6c 61 75 73 65 20 6f 66 20 61 20  ICT clause of a 
1610: 42 45 47 49 4e 2c 20 74 68 65 6e 20 74 68 61 74  BEGIN, then that
1620: 20 61 6c 74 65 72 6e 61 74 69 76 65 20 69 73 20   alternative is 
1630: 75 73 65 64 0a 61 73 20 74 68 65 20 64 65 66 61  used.as the defa
1640: 75 6c 74 20 66 6f 72 20 61 6c 6c 20 63 6f 6d 6d  ult for all comm
1650: 61 6e 64 73 20 77 69 74 68 69 6e 20 74 68 65 20  ands within the 
1660: 74 72 61 6e 73 61 63 74 69 6f 6e 2e 20 20 54 68  transaction.  Th
1670: 65 20 64 65 66 61 75 6c 74 0a 61 6c 67 6f 72 69  e default.algori
1680: 74 68 6d 20 69 73 20 6f 76 65 72 72 69 64 64 65  thm is overridde
1690: 6e 20 62 79 20 4f 4e 20 43 4f 4e 46 4c 49 43 54  n by ON CONFLICT
16a0: 20 63 6c 61 75 73 65 73 20 6f 6e 20 69 6e 64 69   clauses on indi
16b0: 76 69 64 75 61 6c 0a 63 6f 6e 73 74 72 61 69 6e  vidual.constrain
16c0: 74 73 20 77 69 74 68 69 6e 20 74 68 65 20 43 52  ts within the CR
16d0: 45 41 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52  EATE TABLE or CR
16e0: 45 41 54 45 20 49 4e 44 45 58 20 73 74 61 74 65  EATE INDEX state
16f0: 6d 65 6e 74 73 0a 61 6e 64 20 62 79 20 74 68 65  ments.and by the
1700: 20 4f 52 20 63 6c 61 75 73 65 73 20 6f 6e 20 43   OR clauses on C
1710: 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20 61 6e 64  OPY, INSERT, and
1720: 20 55 50 44 41 54 45 20 63 6f 6d 6d 61 6e 64 73   UPDATE commands
1730: 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69  ..</p>.}...Secti
1740: 6f 6e 20 63 6f 6d 6d 65 6e 74 20 63 6f 6d 6d 65  on comment comme
1750: 6e 74 0a 0a 53 79 6e 74 61 78 20 7b 63 6f 6d 6d  nt..Syntax {comm
1760: 65 6e 74 7d 20 7b 3c 53 51 4c 2d 63 6f 6d 6d 65  ent} {<SQL-comme
1770: 6e 74 3e 20 7c 20 3c 43 2d 63 6f 6d 6d 65 6e 74  nt> | <C-comment
1780: 3e 0a 7d 20 7b 53 51 4c 2d 63 6f 6d 6d 65 6e 74  >.} {SQL-comment
1790: 7d 20 7b 2d 2d 20 3c 73 69 6e 67 6c 65 2d 6c 69  } {-- <single-li
17a0: 6e 65 3e 0a 7d 20 7b 43 2d 63 6f 6d 6d 65 6e 74  ne>.} {C-comment
17b0: 7d 20 7b 2f 53 54 41 52 20 3c 6d 75 6c 74 69 70  } {/STAR <multip
17c0: 6c 65 2d 6c 69 6e 65 73 3e 20 5b 53 54 41 52 2f  le-lines> [STAR/
17d0: 5d 0a 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  ].}...puts {.<p>
17e0: 20 43 6f 6d 6d 65 6e 74 73 20 61 72 65 6e 27 74   Comments aren't
17f0: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 73 2c 20 62   SQL commands, b
1800: 75 74 20 63 61 6e 20 6f 63 63 75 72 20 69 6e 20  ut can occur in 
1810: 53 51 4c 20 71 75 65 72 69 65 73 2e 20 54 68 65  SQL queries. The
1820: 79 20 61 72 65 20 0a 74 72 65 61 74 65 64 20 61  y are .treated a
1830: 73 20 77 68 69 74 65 73 70 61 63 65 20 62 79 20  s whitespace by 
1840: 74 68 65 20 70 61 72 73 65 72 2e 20 54 68 65 79  the parser. They
1850: 20 63 61 6e 20 62 65 67 69 6e 20 61 6e 79 77 68   can begin anywh
1860: 65 72 65 20 77 68 69 74 65 73 70 61 63 65 20 0a  ere whitespace .
1870: 63 61 6e 20 62 65 20 66 6f 75 6e 64 2c 20 69 6e  can be found, in
1880: 63 6c 75 64 69 6e 67 20 69 6e 73 69 64 65 20 65  cluding inside e
1890: 78 70 72 65 73 73 69 6f 6e 73 20 74 68 61 74 20  xpressions that 
18a0: 73 70 61 6e 20 6d 75 6c 74 69 70 6c 65 20 6c 69  span multiple li
18b0: 6e 65 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 20 53  nes..</p>..<p> S
18c0: 51 4c 20 63 6f 6d 6d 65 6e 74 73 20 6f 6e 6c 79  QL comments only
18d0: 20 65 78 74 65 6e 64 20 74 6f 20 74 68 65 20 65   extend to the e
18e0: 6e 64 20 6f 66 20 74 68 65 20 63 75 72 72 65 6e  nd of the curren
18f0: 74 20 6c 69 6e 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e  t line.</p>..<p>
1900: 20 43 20 63 6f 6d 6d 65 6e 74 73 20 63 61 6e 20   C comments can 
1910: 73 70 61 6e 20 61 6e 79 20 6e 75 6d 62 65 72 20  span any number 
1920: 6f 66 20 6c 69 6e 65 73 2e 20 49 66 20 74 68 65  of lines. If the
1930: 72 65 20 69 73 20 6e 6f 20 74 65 72 6d 69 6e 61  re is no termina
1940: 74 69 6e 67 0a 64 65 6c 69 6d 69 74 65 72 2c 20  ting.delimiter, 
1950: 74 68 65 79 20 65 78 74 65 6e 64 20 74 6f 20 74  they extend to t
1960: 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20 69 6e  he end of the in
1970: 70 75 74 2e 20 54 68 69 73 20 69 73 20 6e 6f 74  put. This is not
1980: 20 74 72 65 61 74 65 64 20 61 73 20 0a 61 6e 20   treated as .an 
1990: 65 72 72 6f 72 2e 20 41 20 6e 65 77 20 53 51 4c  error. A new SQL
19a0: 20 73 74 61 74 65 6d 65 6e 74 20 63 61 6e 20 62   statement can b
19b0: 65 67 69 6e 20 6f 6e 20 61 20 6c 69 6e 65 20 61  egin on a line a
19c0: 66 74 65 72 20 61 20 6d 75 6c 74 69 6c 69 6e 65  fter a multiline
19d0: 20 0a 63 6f 6d 6d 65 6e 74 20 65 6e 64 73 2e 20   .comment ends. 
19e0: 43 20 63 6f 6d 6d 65 6e 74 73 20 63 61 6e 20 62  C comments can b
19f0: 65 20 65 6d 62 65 64 64 65 64 20 61 6e 79 77 68  e embedded anywh
1a00: 65 72 65 20 77 68 69 74 65 73 70 61 63 65 20 63  ere whitespace c
1a10: 61 6e 20 6f 63 63 75 72 2c 20 0a 69 6e 63 6c 75  an occur, .inclu
1a20: 64 69 6e 67 20 69 6e 73 69 64 65 20 65 78 70 72  ding inside expr
1a30: 65 73 73 69 6f 6e 73 2c 20 61 6e 64 20 69 6e 20  essions, and in 
1a40: 74 68 65 20 6d 69 64 64 6c 65 20 6f 66 20 6f 74  the middle of ot
1a50: 68 65 72 20 53 51 4c 20 73 74 61 74 65 6d 65 6e  her SQL statemen
1a60: 74 73 2e 0a 43 20 63 6f 6d 6d 65 6e 74 73 20 64  ts..C comments d
1a70: 6f 20 6e 6f 74 20 6e 65 73 74 2e 20 53 51 4c 20  o not nest. SQL 
1a80: 63 6f 6d 6d 65 6e 74 73 20 69 6e 73 69 64 65 20  comments inside 
1a90: 61 20 43 20 63 6f 6d 6d 65 6e 74 20 77 69 6c 6c  a C comment will
1aa0: 20 62 65 20 69 67 6e 6f 72 65 64 2e 0a 3c 2f 70   be ignored..</p
1ab0: 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 43 4f  >.}...Section CO
1ac0: 50 59 20 63 6f 70 79 0a 0a 53 79 6e 74 61 78 20  PY copy..Syntax 
1ad0: 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20  {sql-statement} 
1ae0: 7b 0a 43 4f 50 59 20 5b 20 4f 52 20 3c 63 6f 6e  {.COPY [ OR <con
1af0: 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d 3e  flict-algorithm>
1b00: 20 5d 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20   ] <table-name> 
1b10: 46 52 4f 4d 20 3c 66 69 6c 65 6e 61 6d 65 3e 0a  FROM <filename>.
1b20: 5b 20 55 53 49 4e 47 20 44 45 4c 49 4d 49 54 45  [ USING DELIMITE
1b30: 52 53 20 3c 64 65 6c 69 6d 3e 20 5d 0a 7d 0a 0a  RS <delim> ].}..
1b40: 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 43  .puts {.<p>The C
1b50: 4f 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61  OPY command is a
1b60: 6e 20 65 78 74 65 6e 73 69 6f 6e 20 75 73 65 64  n extension used
1b70: 20 74 6f 20 6c 6f 61 64 20 6c 61 72 67 65 20 61   to load large a
1b80: 6d 6f 75 6e 74 73 20 6f 66 0a 64 61 74 61 20 69  mounts of.data i
1b90: 6e 74 6f 20 61 20 74 61 62 6c 65 2e 20 20 49 74  nto a table.  It
1ba0: 20 69 73 20 6d 6f 64 65 6c 65 64 20 61 66 74 65   is modeled afte
1bb0: 72 20 61 20 73 69 6d 69 6c 61 72 20 63 6f 6d 6d  r a similar comm
1bc0: 61 6e 64 20 66 6f 75 6e 64 0a 69 6e 20 50 6f 73  and found.in Pos
1bd0: 74 67 72 65 53 51 4c 2e 20 20 49 6e 20 66 61 63  tgreSQL.  In fac
1be0: 74 2c 20 74 68 65 20 53 51 4c 69 74 65 20 43 4f  t, the SQLite CO
1bf0: 50 59 20 63 6f 6d 6d 61 6e 64 20 69 73 20 73 70  PY command is sp
1c00: 65 63 69 66 69 63 61 6c 6c 79 0a 64 65 73 69 67  ecifically.desig
1c10: 6e 65 64 20 74 6f 20 62 65 20 61 62 6c 65 20 74  ned to be able t
1c20: 6f 20 72 65 61 64 20 74 68 65 20 6f 75 74 70 75  o read the outpu
1c30: 74 20 6f 66 20 74 68 65 20 50 6f 73 74 67 72 65  t of the Postgre
1c40: 53 51 4c 20 64 75 6d 70 0a 75 74 69 6c 69 74 79  SQL dump.utility
1c50: 20 3c 62 3e 70 67 5f 64 75 6d 70 3c 2f 62 3e 20   <b>pg_dump</b> 
1c60: 73 6f 20 74 68 61 74 20 64 61 74 61 20 63 61 6e  so that data can
1c70: 20 62 65 20 65 61 73 69 6c 79 20 74 72 61 6e 73   be easily trans
1c80: 66 65 72 72 65 64 20 66 72 6f 6d 0a 50 6f 73 74  ferred from.Post
1c90: 67 72 65 53 51 4c 20 69 6e 74 6f 20 53 51 4c 69  greSQL into SQLi
1ca0: 74 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  te.</p>..<p>The 
1cb0: 74 61 62 6c 65 2d 6e 61 6d 65 20 69 73 20 74 68  table-name is th
1cc0: 65 20 6e 61 6d 65 20 6f 66 20 61 6e 20 65 78 69  e name of an exi
1cd0: 73 74 69 6e 67 20 74 61 62 6c 65 20 77 68 69 63  sting table whic
1ce0: 68 20 69 73 20 74 6f 0a 62 65 20 66 69 6c 6c 65  h is to.be fille
1cf0: 64 20 77 69 74 68 20 64 61 74 61 2e 20 20 54 68  d with data.  Th
1d00: 65 20 66 69 6c 65 6e 61 6d 65 20 69 73 20 61 20  e filename is a 
1d10: 73 74 72 69 6e 67 20 6f 72 20 69 64 65 6e 74 69  string or identi
1d20: 66 69 65 72 20 74 68 61 74 0a 6e 61 6d 65 73 20  fier that.names 
1d30: 61 20 66 69 6c 65 20 66 72 6f 6d 20 77 68 69 63  a file from whic
1d40: 68 20 64 61 74 61 20 77 69 6c 6c 20 62 65 20 72  h data will be r
1d50: 65 61 64 2e 20 20 54 68 65 20 66 69 6c 65 6e 61  ead.  The filena
1d60: 6d 65 20 63 61 6e 20 62 65 0a 74 68 65 20 3c 62  me can be.the <b
1d70: 3e 53 54 44 49 4e 3c 2f 62 3e 20 74 6f 20 72 65  >STDIN</b> to re
1d80: 61 64 20 64 61 74 61 20 66 72 6f 6d 20 73 74 61  ad data from sta
1d90: 6e 64 61 72 64 20 69 6e 70 75 74 2e 3c 2f 70 3e  ndard input.</p>
1da0: 0a 0a 3c 70 3e 45 61 63 68 20 6c 69 6e 65 20 6f  ..<p>Each line o
1db0: 66 20 74 68 65 20 69 6e 70 75 74 20 66 69 6c 65  f the input file
1dc0: 20 69 73 20 63 6f 6e 76 65 72 74 65 64 20 69 6e   is converted in
1dd0: 74 6f 20 61 20 73 69 6e 67 6c 65 20 72 65 63 6f  to a single reco
1de0: 72 64 0a 69 6e 20 74 68 65 20 74 61 62 6c 65 2e  rd.in the table.
1df0: 20 20 43 6f 6c 75 6d 6e 73 20 61 72 65 20 73 65    Columns are se
1e00: 70 61 72 61 74 65 64 20 62 79 20 74 61 62 73 2e  parated by tabs.
1e10: 20 20 49 66 20 61 20 74 61 62 20 6f 63 63 75 72    If a tab occur
1e20: 73 20 61 73 0a 64 61 74 61 20 77 69 74 68 69 6e  s as.data within
1e30: 20 61 20 63 6f 6c 75 6d 6e 2c 20 74 68 65 6e 20   a column, then 
1e40: 74 68 61 74 20 74 61 62 20 69 73 20 70 72 65 63  that tab is prec
1e50: 65 64 65 64 20 62 79 20 61 20 62 61 73 6b 73 6c  eded by a basksl
1e60: 61 73 68 20 22 5c 22 0a 63 68 61 72 61 63 74 65  ash "\".characte
1e70: 72 2e 20 20 41 20 62 61 73 6b 73 6c 61 73 68 20  r.  A baskslash 
1e80: 69 6e 20 74 68 65 20 64 61 74 61 20 61 70 70 65  in the data appe
1e90: 61 72 73 20 61 73 20 74 77 6f 20 62 61 63 6b 73  ars as two backs
1ea0: 6c 61 73 68 65 73 20 69 6e 0a 61 20 72 6f 77 2e  lashes in.a row.
1eb0: 20 20 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20 55    The optional U
1ec0: 53 49 4e 47 20 44 45 4c 49 4d 49 54 45 52 53 20  SING DELIMITERS 
1ed0: 63 6c 61 75 73 65 20 63 61 6e 20 73 70 65 63 69  clause can speci
1ee0: 66 79 20 61 20 64 65 6c 69 6d 69 74 65 72 0a 6f  fy a delimiter.o
1ef0: 74 68 65 72 20 74 68 61 6e 20 74 61 62 2e 3c 2f  ther than tab.</
1f00: 70 3e 0a 0a 3c 70 3e 49 66 20 61 20 63 6f 6c 75  p>..<p>If a colu
1f10: 6d 6e 20 63 6f 6e 73 69 73 74 73 20 6f 66 20 74  mn consists of t
1f20: 68 65 20 63 68 61 72 61 63 74 65 72 20 22 5c 4e  he character "\N
1f30: 22 2c 20 74 68 61 74 20 63 6f 6c 75 6d 6e 20 69  ", that column i
1f40: 73 20 66 69 6c 6c 65 64 0a 77 69 74 68 20 74 68  s filled.with th
1f50: 65 20 76 61 6c 75 65 20 4e 55 4c 4c 2e 3c 2f 70  e value NULL.</p
1f60: 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74 69 6f 6e  >..<p>The option
1f70: 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  al conflict-clau
1f80: 73 65 20 61 6c 6c 6f 77 73 20 74 68 65 20 73 70  se allows the sp
1f90: 65 63 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 61  ecification of a
1fa0: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 63 6f  n alternative.co
1fb0: 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66 6c 69 63  nstraint conflic
1fc0: 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67  t resolution alg
1fd0: 6f 72 69 74 68 6d 20 74 6f 20 75 73 65 20 66 6f  orithm to use fo
1fe0: 72 20 74 68 69 73 20 6f 6e 65 20 63 6f 6d 6d 61  r this one comma
1ff0: 6e 64 2e 0a 53 65 65 20 74 68 65 20 73 65 63 74  nd..See the sect
2000: 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68 72  ion titled.<a hr
2010: 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f  ef="#conflict">O
2020: 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66  N CONFLICT</a> f
2030: 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  or additional in
2040: 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a  formation.</p>..
2050: 3c 70 3e 57 68 65 6e 20 74 68 65 20 69 6e 70 75  <p>When the inpu
2060: 74 20 64 61 74 61 20 73 6f 75 72 63 65 20 69 73  t data source is
2070: 20 53 54 44 49 4e 2c 20 74 68 65 20 69 6e 70 75   STDIN, the inpu
2080: 74 20 63 61 6e 20 62 65 20 74 65 72 6d 69 6e 61  t can be termina
2090: 74 65 64 0a 62 79 20 61 20 6c 69 6e 65 20 74 68  ted.by a line th
20a0: 61 74 20 63 6f 6e 74 61 69 6e 73 20 6f 6e 6c 79  at contains only
20b0: 20 61 20 62 61 73 6b 73 6c 61 73 68 20 61 6e 64   a baskslash and
20c0: 20 61 20 64 6f 74 3a 7d 0a 70 75 74 73 20 22 5c   a dot:}.puts "\
20d0: 22 5b 4f 70 65 72 61 74 6f 72 20 5c 5c 2e 5d 5c  "[Operator \\.]\
20e0: 22 2e 3c 2f 70 3e 22 0a 0a 0a 53 65 63 74 69 6f  ".</p>"...Sectio
20f0: 6e 20 7b 43 52 45 41 54 45 20 49 4e 44 45 58 7d  n {CREATE INDEX}
2100: 20 63 72 65 61 74 65 69 6e 64 65 78 0a 0a 53 79   createindex..Sy
2110: 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d  ntax {sql-statem
2120: 65 6e 74 7d 20 7b 0a 43 52 45 41 54 45 20 5b 54  ent} {.CREATE [T
2130: 45 4d 50 20 7c 20 54 45 4d 50 4f 52 41 52 59 5d  EMP | TEMPORARY]
2140: 20 5b 55 4e 49 51 55 45 5d 20 49 4e 44 45 58 20   [UNIQUE] INDEX 
2150: 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 20 0a 4f 4e  <index-name> .ON
2160: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20 28 20   <table-name> ( 
2170: 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 5b 2c  <column-name> [,
2180: 20 3c 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 5d 2a   <column-name>]*
2190: 20 29 0a 5b 20 4f 4e 20 43 4f 4e 46 4c 49 43 54   ).[ ON CONFLICT
21a0: 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72   <conflict-algor
21b0: 69 74 68 6d 3e 20 5d 0a 7d 20 7b 63 6f 6c 75 6d  ithm> ].} {colum
21c0: 6e 2d 6e 61 6d 65 7d 20 7b 0a 3c 6e 61 6d 65 3e  n-name} {.<name>
21d0: 20 5b 20 41 53 43 20 7c 20 44 45 53 43 20 5d 0a   [ ASC | DESC ].
21e0: 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  }...puts {.<p>Th
21f0: 65 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 63  e CREATE INDEX c
2200: 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74 73 20  ommand consists 
2210: 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20  of the keywords 
2220: 22 43 52 45 41 54 45 20 49 4e 44 45 58 22 20 66  "CREATE INDEX" f
2230: 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65 20 6e  ollowed.by the n
2240: 61 6d 65 20 6f 66 20 74 68 65 20 6e 65 77 20 69  ame of the new i
2250: 6e 64 65 78 2c 20 74 68 65 20 6b 65 79 77 6f 72  ndex, the keywor
2260: 64 20 22 4f 4e 22 2c 20 74 68 65 20 6e 61 6d 65  d "ON", the name
2270: 20 6f 66 20 61 20 70 72 65 76 69 6f 75 73 6c 79   of a previously
2280: 0a 63 72 65 61 74 65 64 20 74 61 62 6c 65 20 74  .created table t
2290: 68 61 74 20 69 73 20 74 6f 20 62 65 20 69 6e 64  hat is to be ind
22a0: 65 78 65 64 2c 20 61 6e 64 20 61 20 70 61 72 65  exed, and a pare
22b0: 6e 74 68 65 73 69 7a 65 64 20 6c 69 73 74 20 6f  nthesized list o
22c0: 66 20 6e 61 6d 65 73 20 6f 66 0a 63 6f 6c 75 6d  f names of.colum
22d0: 6e 73 20 69 6e 20 74 68 65 20 74 61 62 6c 65 20  ns in the table 
22e0: 74 68 61 74 20 61 72 65 20 75 73 65 64 20 66 6f  that are used fo
22f0: 72 20 74 68 65 20 69 6e 64 65 78 20 6b 65 79 2e  r the index key.
2300: 0a 45 61 63 68 20 63 6f 6c 75 6d 6e 20 6e 61 6d  .Each column nam
2310: 65 20 63 61 6e 20 62 65 20 66 6f 6c 6c 6f 77 65  e can be followe
2320: 64 20 62 79 20 6f 6e 65 20 6f 66 20 74 68 65 20  d by one of the 
2330: 22 41 53 43 22 20 6f 72 20 22 44 45 53 43 22 20  "ASC" or "DESC" 
2340: 6b 65 79 77 6f 72 64 73 0a 74 6f 20 69 6e 64 69  keywords.to indi
2350: 63 61 74 65 20 73 6f 72 74 20 6f 72 64 65 72 2c  cate sort order,
2360: 20 62 75 74 20 74 68 65 20 73 6f 72 74 20 6f 72   but the sort or
2370: 64 65 72 20 69 73 20 69 67 6e 6f 72 65 64 20 69  der is ignored i
2380: 6e 20 74 68 65 20 63 75 72 72 65 6e 74 0a 69 6d  n the current.im
2390: 70 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 3c 2f 70  plementation.</p
23a0: 3e 0a 0a 3c 70 3e 54 68 65 72 65 20 61 72 65 20  >..<p>There are 
23b0: 6e 6f 20 61 72 62 69 74 72 61 72 79 20 6c 69 6d  no arbitrary lim
23c0: 69 74 73 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65  its on the numbe
23d0: 72 20 6f 66 20 69 6e 64 69 63 65 73 20 74 68 61  r of indices tha
23e0: 74 20 63 61 6e 20 62 65 0a 61 74 74 61 63 68 65  t can be.attache
23f0: 64 20 74 6f 20 61 20 73 69 6e 67 6c 65 20 74 61  d to a single ta
2400: 62 6c 65 2c 20 6e 6f 72 20 6f 6e 20 74 68 65 20  ble, nor on the 
2410: 6e 75 6d 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e  number of column
2420: 73 20 69 6e 20 61 6e 20 69 6e 64 65 78 2e 3c 2f  s in an index.</
2430: 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65 20 55 4e  p>..<p>If the UN
2440: 49 51 55 45 20 6b 65 79 77 6f 72 64 20 61 70 70  IQUE keyword app
2450: 65 61 72 73 20 62 65 74 77 65 65 6e 20 43 52 45  ears between CRE
2460: 41 54 45 20 61 6e 64 20 49 4e 44 45 58 20 74 68  ATE and INDEX th
2470: 65 6e 20 64 75 70 6c 69 63 61 74 65 0a 69 6e 64  en duplicate.ind
2480: 65 78 20 65 6e 74 72 69 65 73 20 61 72 65 20 6e  ex entries are n
2490: 6f 74 20 61 6c 6c 6f 77 65 64 2e 20 20 41 6e 79  ot allowed.  Any
24a0: 20 61 74 74 65 6d 70 74 20 74 6f 20 69 6e 73 65   attempt to inse
24b0: 72 74 20 61 20 64 75 70 6c 69 63 61 74 65 20 65  rt a duplicate e
24c0: 6e 74 72 79 0a 77 69 6c 6c 20 72 65 73 75 6c 74  ntry.will result
24d0: 20 69 6e 20 61 6e 20 65 72 72 6f 72 2e 3c 2f 70   in an error.</p
24e0: 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74 69 6f 6e  >..<p>The option
24f0: 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  al conflict-clau
2500: 73 65 20 61 6c 6c 6f 77 73 20 74 68 65 20 73 70  se allows the sp
2510: 65 63 69 66 69 63 61 74 69 6f 6e 20 6f 66 20 61  ecification of a
2520: 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 64 65  n alternative.de
2530: 66 61 75 6c 74 20 63 6f 6e 73 74 72 61 69 6e 74  fault constraint
2540: 20 63 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75   conflict resolu
2550: 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 20 66  tion algorithm f
2560: 6f 72 20 74 68 69 73 20 69 6e 64 65 78 2e 0a 54  or this index..T
2570: 68 69 73 20 6f 6e 6c 79 20 6d 61 6b 65 73 20 73  his only makes s
2580: 65 6e 73 65 20 69 66 20 74 68 65 20 55 4e 49 51  ense if the UNIQ
2590: 55 45 20 6b 65 79 77 6f 72 64 20 69 73 20 75 73  UE keyword is us
25a0: 65 64 20 73 69 6e 63 65 20 6f 74 68 65 72 77 69  ed since otherwi
25b0: 73 65 0a 74 68 65 72 65 20 61 72 65 20 6e 6f 74  se.there are not
25c0: 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 6f 6e 20   constraints on 
25d0: 74 68 65 20 69 6e 64 65 78 2e 20 20 54 68 65 20  the index.  The 
25e0: 64 65 66 61 75 6c 74 20 61 6c 67 6f 72 69 74 68  default algorith
25f0: 6d 20 69 73 0a 41 42 4f 52 54 2e 20 20 49 66 20  m is.ABORT.  If 
2600: 61 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20  a COPY, INSERT, 
2610: 6f 72 20 55 50 44 41 54 45 20 73 74 61 74 65 6d  or UPDATE statem
2620: 65 6e 74 20 73 70 65 63 69 66 69 65 73 20 61 20  ent specifies a 
2630: 70 61 72 74 69 63 75 6c 61 72 0a 63 6f 6e 66 6c  particular.confl
2640: 69 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict resolution a
2650: 6c 67 6f 72 69 74 68 6d 2c 20 74 68 61 74 20 61  lgorithm, that a
2660: 6c 67 6f 72 69 74 68 6d 20 69 73 20 75 73 65 64  lgorithm is used
2670: 20 69 6e 20 70 6c 61 63 65 20 6f 66 0a 74 68 65   in place of.the
2680: 20 64 65 66 61 75 6c 74 20 61 6c 67 6f 72 69 74   default algorit
2690: 68 6d 20 73 70 65 63 69 66 69 65 64 20 68 65 72  hm specified her
26a0: 65 2e 0a 53 65 65 20 74 68 65 20 73 65 63 74 69  e..See the secti
26b0: 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68 72 65  on titled.<a hre
26c0: 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f 4e  f="#conflict">ON
26d0: 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66 6f   CONFLICT</a> fo
26e0: 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66  r additional inf
26f0: 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c  ormation.</p>..<
2700: 70 3e 54 68 65 20 65 78 61 63 74 20 74 65 78 74  p>The exact text
2710: 0a 6f 66 20 65 61 63 68 20 43 52 45 41 54 45 20  .of each CREATE 
2720: 49 4e 44 45 58 20 73 74 61 74 65 6d 65 6e 74 20  INDEX statement 
2730: 69 73 20 73 74 6f 72 65 64 20 69 6e 20 74 68 65  is stored in the
2740: 20 3c 62 3e 73 71 6c 69 74 65 5f 6d 61 73 74 65   <b>sqlite_maste
2750: 72 3c 2f 62 3e 0a 6f 72 20 3c 62 3e 73 71 6c 69  r</b>.or <b>sqli
2760: 74 65 5f 74 65 6d 70 5f 6d 61 73 74 65 72 3c 2f  te_temp_master</
2770: 62 3e 20 74 61 62 6c 65 2c 20 64 65 70 65 6e 64  b> table, depend
2780: 69 6e 67 20 6f 6e 20 77 68 65 74 68 65 72 20 74  ing on whether t
2790: 68 65 20 74 61 62 6c 65 0a 62 65 69 6e 67 20 69  he table.being i
27a0: 6e 64 65 78 65 64 20 69 73 20 74 65 6d 70 6f 72  ndexed is tempor
27b0: 61 72 79 2e 20 20 45 76 65 72 79 74 69 6d 65 20  ary.  Everytime 
27c0: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
27d0: 6f 70 65 6e 65 64 2c 0a 61 6c 6c 20 43 52 45 41  opened,.all CREA
27e0: 54 45 20 49 4e 44 45 58 20 73 74 61 74 65 6d 65  TE INDEX stateme
27f0: 6e 74 73 0a 61 72 65 20 72 65 61 64 20 66 72 6f  nts.are read fro
2800: 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f  m the <b>sqlite_
2810: 6d 61 73 74 65 72 3c 2f 62 3e 20 74 61 62 6c 65  master</b> table
2820: 20 61 6e 64 20 75 73 65 64 20 74 6f 20 72 65 67   and used to reg
2830: 65 6e 65 72 61 74 65 0a 53 51 4c 69 74 65 27 73  enerate.SQLite's
2840: 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73   internal repres
2850: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
2860: 69 6e 64 65 78 20 6c 61 79 6f 75 74 2e 3c 2f 70  index layout.</p
2870: 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 43  >.}...Section {C
2880: 52 45 41 54 45 20 54 41 42 4c 45 7d 20 7b 63 72  REATE TABLE} {cr
2890: 65 61 74 65 74 61 62 6c 65 7d 0a 0a 53 79 6e 74  eatetable}..Synt
28a0: 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d  ax {sql-command}
28b0: 20 7b 0a 43 52 45 41 54 45 20 5b 54 45 4d 50 20   {.CREATE [TEMP 
28c0: 7c 20 54 45 4d 50 4f 52 41 52 59 5d 20 54 41 42  | TEMPORARY] TAB
28d0: 4c 45 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 20  LE <table-name> 
28e0: 28 0a 20 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e  (.  <column-def>
28f0: 20 5b 2c 20 3c 63 6f 6c 75 6d 6e 2d 64 65 66 3e   [, <column-def>
2900: 5d 2a 0a 20 20 5b 2c 20 3c 63 6f 6e 73 74 72 61  ]*.  [, <constra
2910: 69 6e 74 3e 5d 2a 0a 29 0a 7d 20 7b 73 71 6c 2d  int>]*.).} {sql-
2920: 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 43 52 45 41 54  command} {.CREAT
2930: 45 20 5b 54 45 4d 50 20 7c 20 54 45 4d 50 4f 52  E [TEMP | TEMPOR
2940: 41 52 59 5d 20 54 41 42 4c 45 20 3c 74 61 62 6c  ARY] TABLE <tabl
2950: 65 2d 6e 61 6d 65 3e 20 41 53 20 3c 73 65 6c 65  e-name> AS <sele
2960: 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 0a 7d 20  ct-statement>.} 
2970: 7b 63 6f 6c 75 6d 6e 2d 64 65 66 7d 20 7b 0a 3c  {column-def} {.<
2980: 6e 61 6d 65 3e 20 5b 3c 74 79 70 65 3e 5d 20 5b  name> [<type>] [
2990: 5b 43 4f 4e 53 54 52 41 49 4e 54 20 3c 6e 61 6d  [CONSTRAINT <nam
29a0: 65 3e 5d 20 3c 63 6f 6c 75 6d 6e 2d 63 6f 6e 73  e>] <column-cons
29b0: 74 72 61 69 6e 74 3e 5d 2a 0a 7d 20 7b 74 79 70  traint>]*.} {typ
29c0: 65 7d 20 7b 0a 3c 74 79 70 65 6e 61 6d 65 3e 20  e} {.<typename> 
29d0: 7c 0a 3c 74 79 70 65 6e 61 6d 65 3e 20 28 20 3c  |.<typename> ( <
29e0: 6e 75 6d 62 65 72 3e 20 29 20 7c 0a 3c 74 79 70  number> ) |.<typ
29f0: 65 6e 61 6d 65 3e 20 28 20 3c 6e 75 6d 62 65 72  ename> ( <number
2a00: 3e 20 2c 20 3c 6e 75 6d 62 65 72 3e 20 29 0a 7d  > , <number> ).}
2a10: 20 7b 63 6f 6c 75 6d 6e 2d 63 6f 6e 73 74 72 61   {column-constra
2a20: 69 6e 74 7d 20 7b 0a 4e 4f 54 20 4e 55 4c 4c 20  int} {.NOT NULL 
2a30: 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75  [ <conflict-clau
2a40: 73 65 3e 20 5d 20 7c 0a 50 52 49 4d 41 52 59 20  se> ] |.PRIMARY 
2a50: 4b 45 59 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72  KEY [<sort-order
2a60: 3e 5d 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63  >] [ <conflict-c
2a70: 6c 61 75 73 65 3e 20 5d 20 7c 0a 55 4e 49 51 55  lause> ] |.UNIQU
2a80: 45 20 5b 20 3c 63 6f 6e 66 6c 69 63 74 2d 63 6c  E [ <conflict-cl
2a90: 61 75 73 65 3e 20 5d 20 7c 0a 43 48 45 43 4b 20  ause> ] |.CHECK 
2aa0: 28 20 3c 65 78 70 72 3e 20 29 20 5b 20 3c 63 6f  ( <expr> ) [ <co
2ab0: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20 5d  nflict-clause> ]
2ac0: 20 7c 0a 44 45 46 41 55 4c 54 20 3c 76 61 6c 75   |.DEFAULT <valu
2ad0: 65 3e 0a 7d 20 7b 63 6f 6e 73 74 72 61 69 6e 74  e>.} {constraint
2ae0: 7d 20 7b 0a 50 52 49 4d 41 52 59 20 4b 45 59 20  } {.PRIMARY KEY 
2af0: 28 20 3c 6e 61 6d 65 3e 20 5b 2c 20 3c 6e 61 6d  ( <name> [, <nam
2b00: 65 3e 5d 2a 20 29 20 5b 20 3c 63 6f 6e 66 6c 69  e>]* ) [ <confli
2b10: 63 74 2d 63 6c 61 75 73 65 3e 20 5d 7c 0a 55 4e  ct-clause> ]|.UN
2b20: 49 51 55 45 20 28 20 3c 6e 61 6d 65 3e 20 5b 2c  IQUE ( <name> [,
2b30: 20 3c 6e 61 6d 65 3e 5d 2a 20 29 20 5b 20 3c 63   <name>]* ) [ <c
2b40: 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 3e 20  onflict-clause> 
2b50: 5d 20 7c 0a 43 48 45 43 4b 20 28 20 3c 65 78 70  ] |.CHECK ( <exp
2b60: 72 3e 20 29 20 5b 20 3c 63 6f 6e 66 6c 69 63 74  r> ) [ <conflict
2b70: 2d 63 6c 61 75 73 65 3e 20 5d 0a 7d 20 7b 63 6f  -clause> ].} {co
2b80: 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 7d 20 7b  nflict-clause} {
2b90: 0a 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 3c 63 6f  .ON CONFLICT <co
2ba0: 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74 68 6d  nflict-algorithm
2bb0: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 41  >.}..puts {.<p>A
2bc0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74   CREATE TABLE st
2bd0: 61 74 65 6d 65 6e 74 20 69 73 20 62 61 73 69 63  atement is basic
2be0: 61 6c 6c 79 20 74 68 65 20 6b 65 79 77 6f 72 64  ally the keyword
2bf0: 73 20 22 43 52 45 41 54 45 20 54 41 42 4c 45 22  s "CREATE TABLE"
2c00: 0a 66 6f 6c 6c 6f 77 65 64 20 62 79 20 74 68 65  .followed by the
2c10: 20 6e 61 6d 65 20 6f 66 20 61 20 6e 65 77 20 74   name of a new t
2c20: 61 62 6c 65 20 61 6e 64 20 61 20 70 61 72 65 6e  able and a paren
2c30: 74 68 65 73 69 7a 65 64 20 6c 69 73 74 20 6f 66  thesized list of
2c40: 20 63 6f 6c 75 6d 6e 0a 64 65 66 69 6e 69 74 69   column.definiti
2c50: 6f 6e 73 20 61 6e 64 20 63 6f 6e 73 74 72 61 69  ons and constrai
2c60: 6e 74 73 2e 20 20 54 68 65 20 74 61 62 6c 65 20  nts.  The table 
2c70: 6e 61 6d 65 20 63 61 6e 20 62 65 20 65 69 74 68  name can be eith
2c80: 65 72 20 61 6e 20 69 64 65 6e 74 69 66 69 65 72  er an identifier
2c90: 0a 6f 72 20 61 20 73 74 72 69 6e 67 2e 20 20 54  .or a string.  T
2ca0: 61 62 6c 65 73 20 6e 61 6d 65 73 20 74 68 61 74  ables names that
2cb0: 20 62 65 67 69 6e 20 77 69 74 68 20 22 3c 62 3e   begin with "<b>
2cc0: 73 71 6c 69 74 65 5f 3c 2f 62 3e 22 20 61 72 65  sqlite_</b>" are
2cd0: 20 72 65 73 65 72 76 65 64 0a 66 6f 72 20 75 73   reserved.for us
2ce0: 65 20 62 79 20 74 68 65 20 65 6e 67 69 6e 65 2e  e by the engine.
2cf0: 3c 2f 70 3e 0a 0a 3c 70 3e 45 61 63 68 20 63 6f  </p>..<p>Each co
2d00: 6c 75 6d 6e 20 64 65 66 69 6e 69 74 69 6f 6e 20  lumn definition 
2d10: 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66 20 74  is the name of t
2d20: 68 65 20 63 6f 6c 75 6d 6e 20 66 6f 6c 6c 6f 77  he column follow
2d30: 65 64 20 62 79 20 74 68 65 0a 64 61 74 61 74 79  ed by the.dataty
2d40: 70 65 20 66 6f 72 20 74 68 61 74 20 63 6f 6c 75  pe for that colu
2d50: 6d 6e 2c 20 74 68 65 6e 20 6f 6e 65 20 6f 72 20  mn, then one or 
2d60: 6d 6f 72 65 20 6f 70 74 69 6f 6e 61 6c 20 63 6f  more optional co
2d70: 6c 75 6d 6e 20 63 6f 6e 73 74 72 61 69 6e 74 73  lumn constraints
2d80: 2e 0a 53 51 4c 69 74 65 20 69 73 20 3c 61 20 68  ..SQLite is <a h
2d90: 72 65 66 3d 22 64 61 74 61 74 79 70 65 73 2e 68  ref="datatypes.h
2da0: 74 6d 6c 22 3e 74 79 70 65 6c 65 73 73 3c 2f 61  tml">typeless</a
2db0: 3e 2e 0a 54 68 65 20 64 61 74 61 74 79 70 65 20  >..The datatype 
2dc0: 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 20 64  for the column d
2dd0: 6f 65 73 20 6e 6f 74 20 72 65 73 74 72 69 63 74  oes not restrict
2de0: 20 77 68 61 74 20 64 61 74 61 20 6d 61 79 20 62   what data may b
2df0: 65 20 70 75 74 0a 69 6e 20 74 68 61 74 20 63 6f  e put.in that co
2e00: 6c 75 6d 6e 2e 0a 41 6c 6c 20 69 6e 66 6f 72 6d  lumn..All inform
2e10: 61 74 69 6f 6e 20 69 73 20 73 74 6f 72 65 64 20  ation is stored 
2e20: 61 73 20 6e 75 6c 6c 2d 74 65 72 6d 69 6e 61 74  as null-terminat
2e30: 65 64 20 73 74 72 69 6e 67 73 2e 0a 54 68 65 20  ed strings..The 
2e40: 55 4e 49 51 55 45 20 63 6f 6e 73 74 72 61 69 6e  UNIQUE constrain
2e50: 74 20 63 61 75 73 65 73 20 61 6e 20 69 6e 64 65  t causes an inde
2e60: 78 20 74 6f 20 62 65 20 63 72 65 61 74 65 64 20  x to be created 
2e70: 6f 6e 20 74 68 65 20 73 70 65 63 69 66 69 65 64  on the specified
2e80: 0a 63 6f 6c 75 6d 6e 73 2e 20 20 54 68 69 73 20  .columns.  This 
2e90: 69 6e 64 65 78 20 6d 75 73 74 20 63 6f 6e 74 61  index must conta
2ea0: 69 6e 20 75 6e 69 71 75 65 20 6b 65 79 73 2e 0a  in unique keys..
2eb0: 54 68 65 20 44 45 46 41 55 4c 54 20 63 6f 6e 73  The DEFAULT cons
2ec0: 74 72 61 69 6e 74 0a 73 70 65 63 69 66 69 65 73  traint.specifies
2ed0: 20 61 20 64 65 66 61 75 6c 74 20 76 61 6c 75 65   a default value
2ee0: 20 74 6f 20 75 73 65 20 77 68 65 6e 20 64 6f 69   to use when doi
2ef0: 6e 67 20 61 6e 20 49 4e 53 45 52 54 2e 0a 3c 2f  ng an INSERT..</
2f00: 70 3e 0a 0a 3c 70 3e 53 70 65 63 69 66 79 69 6e  p>..<p>Specifyin
2f10: 67 20 61 20 50 52 49 4d 41 52 59 20 4b 45 59 20  g a PRIMARY KEY 
2f20: 6e 6f 72 6d 61 6c 6c 79 20 6a 75 73 74 20 63 72  normally just cr
2f30: 65 61 74 65 73 20 61 20 55 4e 49 51 55 45 20 69  eates a UNIQUE i
2f40: 6e 64 65 78 0a 6f 6e 20 74 68 65 20 70 72 69 6d  ndex.on the prim
2f50: 61 72 79 20 6b 65 79 2e 20 20 48 6f 77 65 76 65  ary key.  Howeve
2f60: 72 2c 20 69 66 20 70 72 69 6d 61 72 79 20 6b 65  r, if primary ke
2f70: 79 20 69 73 20 6f 6e 20 61 20 73 69 6e 67 6c 65  y is on a single
2f80: 20 63 6f 6c 75 6d 6e 0a 74 68 61 74 20 68 61 73   column.that has
2f90: 20 64 61 74 61 74 79 70 65 20 49 4e 54 45 47 45   datatype INTEGE
2fa0: 52 2c 20 74 68 65 6e 20 74 68 61 74 20 63 6f 6c  R, then that col
2fb0: 75 6d 6e 20 69 73 20 75 73 65 64 20 69 6e 74 65  umn is used inte
2fc0: 72 6e 61 6c 6c 79 0a 61 73 20 74 68 65 20 61 63  rnally.as the ac
2fd0: 74 75 61 6c 20 6b 65 79 20 6f 66 20 74 68 65 20  tual key of the 
2fe0: 42 2d 54 72 65 65 20 66 6f 72 20 74 68 65 20 74  B-Tree for the t
2ff0: 61 62 6c 65 2e 20 20 54 68 69 73 20 6d 65 61 6e  able.  This mean
3000: 73 20 74 68 61 74 20 74 68 65 20 63 6f 6c 75 6d  s that the colum
3010: 6e 0a 6d 61 79 20 6f 6e 6c 79 20 68 6f 6c 64 20  n.may only hold 
3020: 75 6e 69 71 75 65 20 69 6e 74 65 67 65 72 20 76  unique integer v
3030: 61 6c 75 65 73 2e 20 20 28 45 78 63 65 70 74 20  alues.  (Except 
3040: 66 6f 72 20 74 68 69 73 20 6f 6e 65 20 63 61 73  for this one cas
3050: 65 2c 0a 53 51 4c 69 74 65 20 69 67 6e 6f 72 65  e,.SQLite ignore
3060: 73 20 74 68 65 20 64 61 74 61 74 79 70 65 20 73  s the datatype s
3070: 70 65 63 69 66 69 63 61 74 69 6f 6e 20 6f 66 20  pecification of 
3080: 63 6f 6c 75 6d 6e 73 20 61 6e 64 20 61 6c 6c 6f  columns and allo
3090: 77 73 0a 61 6e 79 20 6b 69 6e 64 20 6f 66 20 64  ws.any kind of d
30a0: 61 74 61 20 74 6f 20 62 65 20 70 75 74 20 69 6e  ata to be put in
30b0: 20 61 20 63 6f 6c 75 6d 6e 20 72 65 67 61 72 64   a column regard
30c0: 6c 65 73 73 20 6f 66 20 69 74 73 20 64 65 63 6c  less of its decl
30d0: 61 72 65 64 0a 64 61 74 61 74 79 70 65 2e 29 20  ared.datatype.) 
30e0: 20 49 66 20 61 20 74 61 62 6c 65 20 64 6f 65 73   If a table does
30f0: 20 6e 6f 74 20 68 61 76 65 20 61 6e 20 49 4e 54   not have an INT
3100: 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59  EGER PRIMARY KEY
3110: 20 63 6f 6c 75 6d 6e 2c 0a 74 68 65 6e 20 74 68   column,.then th
3120: 65 20 42 2d 54 72 65 65 20 6b 65 79 20 77 69 6c  e B-Tree key wil
3130: 6c 20 62 65 20 61 20 61 75 74 6f 6d 61 74 69 63  l be a automatic
3140: 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 64 20 69  ally generated i
3150: 6e 74 65 67 65 72 2e 20 20 54 68 65 0a 42 2d 54  nteger.  The.B-T
3160: 72 65 65 20 6b 65 79 20 66 6f 72 20 61 20 72 6f  ree key for a ro
3170: 77 20 63 61 6e 20 61 6c 77 61 79 73 20 62 65 20  w can always be 
3180: 61 63 63 65 73 73 65 64 20 75 73 69 6e 67 20 6f  accessed using o
3190: 6e 65 20 6f 66 20 74 68 65 0a 73 70 65 63 69 61  ne of the.specia
31a0: 6c 20 6e 61 6d 65 73 20 22 3c 62 3e 52 4f 57 49  l names "<b>ROWI
31b0: 44 3c 2f 62 3e 22 2c 20 22 3c 62 3e 4f 49 44 3c  D</b>", "<b>OID<
31c0: 2f 62 3e 22 2c 20 6f 72 20 22 3c 62 3e 5f 52 4f  /b>", or "<b>_RO
31d0: 57 49 44 5f 3c 2f 62 3e 22 2e 0a 54 68 69 73 20  WID_</b>"..This 
31e0: 69 73 20 74 72 75 65 20 72 65 67 61 72 64 6c 65  is true regardle
31f0: 73 73 20 6f 66 20 77 68 65 74 68 65 72 20 6f 72  ss of whether or
3200: 20 6e 6f 74 20 74 68 65 72 65 20 69 73 20 61 6e   not there is an
3210: 20 49 4e 54 45 47 45 52 0a 50 52 49 4d 41 52 59   INTEGER.PRIMARY
3220: 20 4b 45 59 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66   KEY.</p>..<p>If
3230: 20 74 68 65 20 22 54 45 4d 50 22 20 6f 72 20 22   the "TEMP" or "
3240: 54 45 4d 50 4f 52 41 52 59 22 20 6b 65 79 77 6f  TEMPORARY" keywo
3250: 72 64 20 6f 63 63 75 72 73 20 69 6e 20 62 65 74  rd occurs in bet
3260: 77 65 65 6e 20 22 43 52 45 41 54 45 22 0a 61 6e  ween "CREATE".an
3270: 64 20 22 54 41 42 4c 45 22 20 74 68 65 6e 20 74  d "TABLE" then t
3280: 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 69 73  he table that is
3290: 20 63 72 65 61 74 65 64 20 69 73 20 6f 6e 6c 79   created is only
32a0: 20 76 69 73 69 62 6c 65 20 74 6f 20 74 68 65 0a   visible to the.
32b0: 70 72 6f 63 65 73 73 20 74 68 61 74 20 6f 70 65  process that ope
32c0: 6e 65 64 20 74 68 65 20 64 61 74 61 62 61 73 65  ned the database
32d0: 20 61 6e 64 20 69 73 20 61 75 74 6f 6d 61 74 69   and is automati
32e0: 63 61 6c 6c 79 20 64 65 6c 65 74 65 64 20 77 68  cally deleted wh
32f0: 65 6e 0a 74 68 65 20 64 61 74 61 62 61 73 65 20  en.the database 
3300: 69 73 20 63 6c 6f 73 65 64 2e 20 20 41 6e 79 20  is closed.  Any 
3310: 69 6e 64 69 63 65 73 20 63 72 65 61 74 65 64 20  indices created 
3320: 6f 6e 20 61 20 74 65 6d 70 6f 72 61 72 79 20 74  on a temporary t
3330: 61 62 6c 65 0a 61 72 65 20 61 6c 73 6f 20 74 65  able.are also te
3340: 6d 70 6f 72 61 72 79 2e 20 20 54 65 6d 70 6f 72  mporary.  Tempor
3350: 61 72 79 20 74 61 62 6c 65 73 20 61 6e 64 20 69  ary tables and i
3360: 6e 64 69 63 65 73 20 61 72 65 20 73 74 6f 72 65  ndices are store
3370: 64 20 69 6e 20 61 0a 73 65 70 61 72 61 74 65 20  d in a.separate 
3380: 66 69 6c 65 20 64 69 73 74 69 6e 63 74 20 66 72  file distinct fr
3390: 6f 6d 20 74 68 65 20 6d 61 69 6e 20 64 61 74 61  om the main data
33a0: 62 61 73 65 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a  base file.</p>..
33b0: 3c 70 3e 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20  <p>The optional 
33c0: 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 20  conflict-clause 
33d0: 66 6f 6c 6c 6f 77 69 6e 67 20 65 61 63 68 20 63  following each c
33e0: 6f 6e 73 74 72 61 69 6e 74 0a 61 6c 6c 6f 77 73  onstraint.allows
33f0: 20 74 68 65 20 73 70 65 63 69 66 69 63 61 74 69   the specificati
3400: 6f 6e 20 6f 66 20 61 6e 20 61 6c 74 65 72 6e 61  on of an alterna
3410: 74 69 76 65 20 64 65 66 61 75 6c 74 0a 63 6f 6e  tive default.con
3420: 73 74 72 61 69 6e 74 20 63 6f 6e 66 6c 69 63 74  straint conflict
3430: 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f   resolution algo
3440: 72 69 74 68 6d 20 66 6f 72 20 74 68 61 74 20 63  rithm for that c
3450: 6f 6e 73 74 72 61 69 6e 74 2e 0a 54 68 65 20 64  onstraint..The d
3460: 65 66 61 75 6c 74 20 69 73 20 61 62 6f 72 74 20  efault is abort 
3470: 41 42 4f 52 54 2e 20 20 44 69 66 66 65 72 65 6e  ABORT.  Differen
3480: 74 20 63 6f 6e 73 74 72 61 69 6e 74 73 20 77 69  t constraints wi
3490: 74 68 69 6e 20 74 68 65 20 73 61 6d 65 0a 74 61  thin the same.ta
34a0: 62 6c 65 20 6d 61 79 20 68 61 76 65 20 64 69 66  ble may have dif
34b0: 66 65 72 65 6e 74 20 64 65 66 61 75 6c 74 20 63  ferent default c
34c0: 6f 6e 66 6c 69 63 74 20 72 65 73 6f 6c 75 74 69  onflict resoluti
34d0: 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 73 2e 0a 49  on algorithms..I
34e0: 66 20 61 6e 20 43 4f 50 59 2c 20 49 4e 53 45 52  f an COPY, INSER
34f0: 54 2c 20 6f 72 20 55 50 44 41 54 45 20 63 6f 6d  T, or UPDATE com
3500: 6d 61 6e 64 20 73 70 65 63 69 66 69 65 73 20 61  mand specifies a
3510: 20 64 69 66 66 65 72 65 6e 74 20 63 6f 6e 66 6c   different confl
3520: 69 63 74 0a 72 65 73 6f 6c 75 74 69 6f 6e 20 61  ict.resolution a
3530: 6c 67 6f 72 69 74 68 6d 2c 20 74 68 65 6e 20 74  lgorithm, then t
3540: 68 61 74 20 61 6c 67 6f 72 69 74 68 6d 20 69 73  hat algorithm is
3550: 20 75 73 65 64 20 69 6e 20 70 6c 61 63 65 20 6f   used in place o
3560: 66 20 74 68 65 0a 64 65 66 61 75 6c 74 20 61 6c  f the.default al
3570: 67 6f 72 69 74 68 6d 20 73 70 65 63 69 66 69 65  gorithm specifie
3580: 64 20 69 6e 20 74 68 65 20 43 52 45 41 54 45 20  d in the CREATE 
3590: 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e 74 2e  TABLE statement.
35a0: 0a 53 65 65 20 74 68 65 20 73 65 63 74 69 6f 6e  .See the section
35b0: 20 74 69 74 6c 65 64 0a 3c 61 20 68 72 65 66 3d   titled.<a href=
35c0: 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f 4e 20 43  "#conflict">ON C
35d0: 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66 6f 72 20  ONFLICT</a> for 
35e0: 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f 72  additional infor
35f0: 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70 3e  mation.</p>..<p>
3600: 43 48 45 43 4b 20 63 6f 6e 73 74 72 61 69 6e 74  CHECK constraint
3610: 73 20 61 72 65 20 69 67 6e 6f 72 65 64 20 69 6e  s are ignored in
3620: 20 74 68 65 20 63 75 72 72 65 6e 74 20 69 6d 70   the current imp
3630: 6c 65 6d 65 6e 74 61 74 69 6f 6e 2e 0a 53 75 70  lementation..Sup
3640: 70 6f 72 74 20 66 6f 72 20 43 48 45 43 4b 20 63  port for CHECK c
3650: 6f 6e 73 74 72 61 69 6e 74 73 20 6d 61 79 20 62  onstraints may b
3660: 65 20 61 64 64 65 64 20 69 6e 20 74 68 65 20 66  e added in the f
3670: 75 74 75 72 65 2e 20 20 41 73 20 6f 66 0a 76 65  uture.  As of.ve
3680: 72 73 69 6f 6e 20 32 2e 33 2e 30 2c 20 4e 4f 54  rsion 2.3.0, NOT
3690: 20 4e 55 4c 4c 2c 20 50 52 49 4d 41 52 59 20 4b   NULL, PRIMARY K
36a0: 45 59 2c 20 61 6e 64 20 55 4e 49 51 55 45 20 63  EY, and UNIQUE c
36b0: 6f 6e 73 74 72 61 69 6e 74 73 20 61 6c 6c 0a 77  onstraints all.w
36c0: 6f 72 6b 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65  ork.</p>..<p>The
36d0: 72 65 20 61 72 65 20 6e 6f 20 61 72 62 69 74 72  re are no arbitr
36e0: 61 72 79 20 6c 69 6d 69 74 73 20 6f 6e 20 74 68  ary limits on th
36f0: 65 20 6e 75 6d 62 65 72 0a 6f 66 20 63 6f 6c 75  e number.of colu
3700: 6d 6e 73 20 6f 72 20 6f 6e 20 74 68 65 20 6e 75  mns or on the nu
3710: 6d 62 65 72 20 6f 66 20 63 6f 6e 73 74 72 61 69  mber of constrai
3720: 6e 74 73 20 69 6e 20 61 20 74 61 62 6c 65 2e 0a  nts in a table..
3730: 54 68 65 20 74 6f 74 61 6c 20 61 6d 6f 75 6e 74  The total amount
3740: 20 6f 66 20 64 61 74 61 20 69 6e 20 61 20 73 69   of data in a si
3750: 6e 67 6c 65 20 72 6f 77 20 69 73 20 6c 69 6d 69  ngle row is limi
3760: 74 65 64 20 74 6f 20 61 62 6f 75 74 0a 31 20 6d  ted to about.1 m
3770: 65 67 61 62 79 74 65 73 2e 20 20 28 54 68 69 73  egabytes.  (This
3780: 20 6c 69 6d 69 74 20 63 61 6e 20 62 65 20 69 6e   limit can be in
3790: 63 72 65 61 73 65 64 20 74 6f 20 31 36 4d 42 20  creased to 16MB 
37a0: 62 79 20 63 68 61 6e 67 69 6e 67 0a 61 20 73 69  by changing.a si
37b0: 6e 67 6c 65 20 23 64 65 66 69 6e 65 20 69 6e 20  ngle #define in 
37c0: 74 68 65 20 73 6f 75 72 63 65 20 63 6f 64 65 20  the source code 
37d0: 61 6e 64 20 72 65 63 6f 6d 70 69 6c 69 6e 67 2e  and recompiling.
37e0: 29 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 43 52  )</p>..<p>The CR
37f0: 45 41 54 45 20 54 41 42 4c 45 20 41 53 20 66 6f  EATE TABLE AS fo
3800: 72 6d 20 64 65 66 69 6e 65 73 20 74 68 65 20 74  rm defines the t
3810: 61 62 6c 65 20 74 6f 20 62 65 0a 74 68 65 20 72  able to be.the r
3820: 65 73 75 6c 74 20 73 65 74 20 6f 66 20 61 20 71  esult set of a q
3830: 75 65 72 79 2e 20 20 54 68 65 20 6e 61 6d 65 73  uery.  The names
3840: 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 63 6f   of the table co
3850: 6c 75 6d 6e 73 20 61 72 65 0a 74 68 65 20 6e 61  lumns are.the na
3860: 6d 65 73 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d  mes of the colum
3870: 6e 73 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74  ns in the result
3880: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 65 78  .</p>..<p>The ex
3890: 61 63 74 20 74 65 78 74 0a 6f 66 20 65 61 63 68  act text.of each
38a0: 20 43 52 45 41 54 45 20 54 41 42 4c 45 20 73 74   CREATE TABLE st
38b0: 61 74 65 6d 65 6e 74 20 69 73 20 73 74 6f 72 65  atement is store
38c0: 64 20 69 6e 20 74 68 65 20 3c 62 3e 73 71 6c 69  d in the <b>sqli
38d0: 74 65 5f 6d 61 73 74 65 72 3c 2f 62 3e 0a 74 61  te_master</b>.ta
38e0: 62 6c 65 2e 20 20 45 76 65 72 79 74 69 6d 65 20  ble.  Everytime 
38f0: 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20  the database is 
3900: 6f 70 65 6e 65 64 2c 20 61 6c 6c 20 43 52 45 41  opened, all CREA
3910: 54 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65  TE TABLE stateme
3920: 6e 74 73 0a 61 72 65 20 72 65 61 64 20 66 72 6f  nts.are read fro
3930: 6d 20 74 68 65 20 3c 62 3e 73 71 6c 69 74 65 5f  m the <b>sqlite_
3940: 6d 61 73 74 65 72 3c 2f 62 3e 20 74 61 62 6c 65  master</b> table
3950: 20 61 6e 64 20 75 73 65 64 20 74 6f 20 72 65 67   and used to reg
3960: 65 6e 65 72 61 74 65 0a 53 51 4c 69 74 65 27 73  enerate.SQLite's
3970: 20 69 6e 74 65 72 6e 61 6c 20 72 65 70 72 65 73   internal repres
3980: 65 6e 74 61 74 69 6f 6e 20 6f 66 20 74 68 65 20  entation of the 
3990: 74 61 62 6c 65 20 6c 61 79 6f 75 74 2e 0a 49 66  table layout..If
39a0: 20 74 68 65 20 6f 72 69 67 69 6e 61 6c 20 63 6f   the original co
39b0: 6d 6d 61 6e 64 20 77 61 73 20 61 20 43 52 45 41  mmand was a CREA
39c0: 54 45 20 54 41 42 4c 45 20 41 53 20 74 68 65 6e  TE TABLE AS then
39d0: 20 74 68 65 6e 20 61 6e 20 65 71 75 69 76 61 6c   then an equival
39e0: 65 6e 74 0a 43 52 45 41 54 45 20 54 41 42 4c 45  ent.CREATE TABLE
39f0: 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20 73 79   statement is sy
3a00: 6e 74 68 65 73 69 7a 65 64 20 61 6e 64 20 73 74  nthesized and st
3a10: 6f 72 65 20 69 6e 20 3c 62 3e 73 71 6c 69 74 65  ore in <b>sqlite
3a20: 5f 6d 61 73 74 65 72 3c 2f 62 3e 0a 69 6e 20 70  _master</b>.in p
3a30: 6c 61 63 65 20 6f 66 20 74 68 65 20 6f 72 69 67  lace of the orig
3a40: 69 6e 61 6c 20 63 6f 6d 6d 61 6e 64 2e 0a 54 68  inal command..Th
3a50: 65 20 74 65 78 74 20 6f 66 20 43 52 45 41 54 45  e text of CREATE
3a60: 20 54 45 4d 50 4f 52 41 52 59 20 54 41 42 4c 45   TEMPORARY TABLE
3a70: 20 73 74 61 74 65 6d 65 6e 74 73 20 61 72 65 20   statements are 
3a80: 73 74 6f 72 65 64 20 69 6e 20 74 68 65 0a 3c 62  stored in the.<b
3a90: 3e 73 71 6c 69 74 65 5f 74 65 6d 70 5f 6d 61 73  >sqlite_temp_mas
3aa0: 74 65 72 3c 2f 62 3e 20 74 61 62 6c 65 2e 0a 3c  ter</b> table..<
3ab0: 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20  /p>.}...Section 
3ac0: 7b 43 52 45 41 54 45 20 54 52 49 47 47 45 52 7d  {CREATE TRIGGER}
3ad0: 20 63 72 65 61 74 65 74 72 69 67 67 65 72 0a 0a   createtrigger..
3ae0: 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74  Syntax {sql-stat
3af0: 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41 54 45 20  ement} {.CREATE 
3b00: 5b 54 45 4d 50 20 7c 20 54 45 4d 50 4f 52 41 52  [TEMP | TEMPORAR
3b10: 59 5d 20 54 52 49 47 47 45 52 20 3c 74 72 69 67  Y] TRIGGER <trig
3b20: 67 65 72 2d 6e 61 6d 65 3e 20 5b 20 42 45 46 4f  ger-name> [ BEFO
3b30: 52 45 20 7c 20 41 46 54 45 52 20 5d 0a 3c 64 61  RE | AFTER ].<da
3b40: 74 61 62 61 73 65 2d 65 76 65 6e 74 3e 20 4f 4e  tabase-event> ON
3b50: 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e 0a 3c 74   <table-name>.<t
3b60: 72 69 67 67 65 72 2d 61 63 74 69 6f 6e 3e 0a 7d  rigger-action>.}
3b70: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
3b80: 61 74 65 6d 65 6e 74 7d 20 7b 0a 43 52 45 41 54  atement} {.CREAT
3b90: 45 20 5b 54 45 4d 50 20 7c 20 54 45 4d 50 4f 52  E [TEMP | TEMPOR
3ba0: 41 52 59 5d 20 54 52 49 47 47 45 52 20 3c 74 72  ARY] TRIGGER <tr
3bb0: 69 67 67 65 72 2d 6e 61 6d 65 3e 20 49 4e 53 54  igger-name> INST
3bc0: 45 41 44 20 4f 46 0a 3c 64 61 74 61 62 61 73 65  EAD OF.<database
3bd0: 2d 65 76 65 6e 74 3e 20 4f 4e 20 3c 76 69 65 77  -event> ON <view
3be0: 2d 6e 61 6d 65 3e 0a 3c 74 72 69 67 67 65 72 2d  -name>.<trigger-
3bf0: 61 63 74 69 6f 6e 3e 0a 7d 0a 0a 53 79 6e 74 61  action>.}..Synta
3c00: 78 20 7b 64 61 74 61 62 61 73 65 2d 65 76 65 6e  x {database-even
3c10: 74 7d 20 7b 0a 44 45 4c 45 54 45 20 7c 20 0a 49  t} {.DELETE | .I
3c20: 4e 53 45 52 54 20 7c 20 0a 55 50 44 41 54 45 20  NSERT | .UPDATE 
3c30: 7c 20 0a 55 50 44 41 54 45 20 4f 46 20 3c 63 6f  | .UPDATE OF <co
3c40: 6c 75 6d 6e 2d 6c 69 73 74 3e 0a 7d 0a 0a 53 79  lumn-list>.}..Sy
3c50: 6e 74 61 78 20 7b 74 72 69 67 67 65 72 2d 61 63  ntax {trigger-ac
3c60: 74 69 6f 6e 7d 20 7b 0a 5b 20 46 4f 52 20 45 41  tion} {.[ FOR EA
3c70: 43 48 20 52 4f 57 20 5d 20 5b 20 57 48 45 4e 20  CH ROW ] [ WHEN 
3c80: 3c 65 78 70 72 65 73 73 69 6f 6e 3e 20 5d 20 0a  <expression> ] .
3c90: 42 45 47 49 4e 20 0a 20 20 3c 74 72 69 67 67 65  BEGIN .  <trigge
3ca0: 72 2d 73 74 65 70 3e 20 3b 20 5b 20 3c 74 72 69  r-step> ; [ <tri
3cb0: 67 67 65 72 2d 73 74 65 70 3e 20 3b 20 5d 2a 0a  gger-step> ; ]*.
3cc0: 45 4e 44 0a 7d 0a 0a 53 79 6e 74 61 78 20 7b 74  END.}..Syntax {t
3cd0: 72 69 67 67 65 72 2d 73 74 65 70 7d 20 7b 0a 3c  rigger-step} {.<
3ce0: 75 70 64 61 74 65 2d 73 74 61 74 65 6d 65 6e 74  update-statement
3cf0: 3e 20 7c 20 3c 69 6e 73 65 72 74 2d 73 74 61 74  > | <insert-stat
3d00: 65 6d 65 6e 74 3e 20 7c 20 0a 3c 64 65 6c 65 74  ement> | .<delet
3d10: 65 2d 73 74 61 74 65 6d 65 6e 74 3e 20 7c 20 3c  e-statement> | <
3d20: 73 65 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74  select-statement
3d30: 3e 20 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  > .}..puts {.<p>
3d40: 54 68 65 20 43 52 45 41 54 45 20 54 52 49 47 47  The CREATE TRIGG
3d50: 45 52 20 73 74 61 74 65 6d 65 6e 74 20 69 73 20  ER statement is 
3d60: 75 73 65 64 20 74 6f 20 61 64 64 20 74 72 69 67  used to add trig
3d70: 67 65 72 73 20 74 6f 20 74 68 65 20 0a 64 61 74  gers to the .dat
3d80: 61 62 61 73 65 20 73 63 68 65 6d 61 2e 20 54 72  abase schema. Tr
3d90: 69 67 67 65 72 73 20 61 72 65 20 64 61 74 61 62  iggers are datab
3da0: 61 73 65 20 6f 70 65 72 61 74 69 6f 6e 73 20 28  ase operations (
3db0: 74 68 65 20 3c 69 3e 74 72 69 67 67 65 72 2d 61  the <i>trigger-a
3dc0: 63 74 69 6f 6e 3c 2f 69 3e 29 20 0a 74 68 61 74  ction</i>) .that
3dd0: 20 61 72 65 20 61 75 74 6f 6d 61 74 69 63 61 6c   are automatical
3de0: 6c 79 20 70 65 72 66 6f 72 6d 65 64 20 77 68 65  ly performed whe
3df0: 6e 20 61 20 73 70 65 63 69 66 69 65 64 20 64 61  n a specified da
3e00: 74 61 62 61 73 65 20 65 76 65 6e 74 20 28 74 68  tabase event (th
3e10: 65 0a 3c 69 3e 64 61 74 61 62 61 73 65 2d 65 76  e.<i>database-ev
3e20: 65 6e 74 3c 2f 69 3e 29 20 6f 63 63 75 72 73 2e  ent</i>) occurs.
3e30: 20 20 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 74 72 69    </p>..<p>A tri
3e40: 67 67 65 72 20 6d 61 79 20 62 65 20 73 70 65 63  gger may be spec
3e50: 69 66 69 65 64 20 74 6f 20 66 69 72 65 20 77 68  ified to fire wh
3e60: 65 6e 65 76 65 72 20 61 20 44 45 4c 45 54 45 2c  enever a DELETE,
3e70: 20 49 4e 53 45 52 54 20 6f 72 20 55 50 44 41 54   INSERT or UPDAT
3e80: 45 20 6f 66 20 61 0a 70 61 72 74 69 63 75 6c 61  E of a.particula
3e90: 72 20 64 61 74 61 62 61 73 65 20 74 61 62 6c 65  r database table
3ea0: 20 6f 63 63 75 72 73 2c 20 6f 72 20 77 68 65 6e   occurs, or when
3eb0: 65 76 65 72 20 61 6e 20 55 50 44 41 54 45 20 6f  ever an UPDATE o
3ec0: 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65 0a 73 70  f one or more.sp
3ed0: 65 63 69 66 69 65 64 20 63 6f 6c 75 6d 6e 73 20  ecified columns 
3ee0: 6f 66 20 61 20 74 61 62 6c 65 20 61 72 65 20 75  of a table are u
3ef0: 70 64 61 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e  pdated.</p>..<p>
3f00: 41 74 20 74 68 69 73 20 74 69 6d 65 20 53 51 4c  At this time SQL
3f10: 69 74 65 20 73 75 70 70 6f 72 74 73 20 6f 6e 6c  ite supports onl
3f20: 79 20 46 4f 52 20 45 41 43 48 20 52 4f 57 20 74  y FOR EACH ROW t
3f30: 72 69 67 67 65 72 73 2c 20 6e 6f 74 20 46 4f 52  riggers, not FOR
3f40: 20 45 41 43 48 0a 53 54 41 54 45 4d 45 4e 54 20   EACH.STATEMENT 
3f50: 74 72 69 67 67 65 72 73 2e 20 48 65 6e 63 65 20  triggers. Hence 
3f60: 65 78 70 6c 69 63 69 74 6c 79 20 73 70 65 63 69  explicitly speci
3f70: 66 79 69 6e 67 20 46 4f 52 20 45 41 43 48 20 52  fying FOR EACH R
3f80: 4f 57 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 20  OW is optional. 
3f90: 20 46 4f 52 0a 45 41 43 48 20 52 4f 57 20 69 6d   FOR.EACH ROW im
3fa0: 70 6c 69 65 73 20 74 68 61 74 20 74 68 65 20 53  plies that the S
3fb0: 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 73 70  QL statements sp
3fc0: 65 63 69 66 69 65 64 20 61 73 20 3c 69 3e 74 72  ecified as <i>tr
3fd0: 69 67 67 65 72 2d 73 74 65 70 73 3c 2f 69 3e 20  igger-steps</i> 
3fe0: 0a 6d 61 79 20 62 65 20 65 78 65 63 75 74 65 64  .may be executed
3ff0: 20 28 64 65 70 65 6e 64 69 6e 67 20 6f 6e 20 74   (depending on t
4000: 68 65 20 57 48 45 4e 20 63 6c 61 75 73 65 29 20  he WHEN clause) 
4010: 66 6f 72 20 65 61 63 68 20 64 61 74 61 62 61 73  for each databas
4020: 65 20 72 6f 77 20 62 65 69 6e 67 0a 69 6e 73 65  e row being.inse
4030: 72 74 65 64 2c 20 75 70 64 61 74 65 64 20 6f 72  rted, updated or
4040: 20 64 65 6c 65 74 65 64 20 62 79 20 74 68 65 20   deleted by the 
4050: 73 74 61 74 65 6d 65 6e 74 20 63 61 75 73 69 6e  statement causin
4060: 67 20 74 68 65 20 74 72 69 67 67 65 72 20 74 6f  g the trigger to
4070: 20 66 69 72 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 42   fire.</p>..<p>B
4080: 6f 74 68 20 74 68 65 20 57 48 45 4e 20 63 6c 61  oth the WHEN cla
4090: 75 73 65 20 61 6e 64 20 74 68 65 20 3c 69 3e 74  use and the <i>t
40a0: 72 69 67 67 65 72 2d 73 74 65 70 73 3c 2f 69 3e  rigger-steps</i>
40b0: 20 6d 61 79 20 61 63 63 65 73 73 20 65 6c 65 6d   may access elem
40c0: 65 6e 74 73 20 6f 66 20 0a 74 68 65 20 72 6f 77  ents of .the row
40d0: 20 62 65 69 6e 67 20 69 6e 73 65 72 74 65 64 2c   being inserted,
40e0: 20 64 65 6c 65 74 65 64 20 6f 72 20 75 70 64 61   deleted or upda
40f0: 74 65 64 20 75 73 69 6e 67 20 72 65 66 65 72 65  ted using refere
4100: 6e 63 65 73 20 6f 66 20 74 68 65 20 66 6f 72 6d  nces of the form
4110: 20 0a 22 4e 45 57 2e 3c 69 3e 63 6f 6c 75 6d 6e   ."NEW.<i>column
4120: 2d 6e 61 6d 65 3c 2f 69 3e 22 20 61 6e 64 20 22  -name</i>" and "
4130: 4f 4c 44 2e 3c 69 3e 63 6f 6c 75 6d 6e 2d 6e 61  OLD.<i>column-na
4140: 6d 65 3c 2f 69 3e 22 2c 20 77 68 65 72 65 0a 3c  me</i>", where.<
4150: 69 3e 63 6f 6c 75 6d 6e 2d 6e 61 6d 65 3c 2f 69  i>column-name</i
4160: 3e 20 69 73 20 74 68 65 20 6e 61 6d 65 20 6f 66  > is the name of
4170: 20 61 20 63 6f 6c 75 6d 6e 20 66 72 6f 6d 20 74   a column from t
4180: 68 65 20 74 61 62 6c 65 20 74 68 61 74 20 74 68  he table that th
4190: 65 20 74 72 69 67 67 65 72 0a 69 73 20 61 73 73  e trigger.is ass
41a0: 6f 63 69 61 74 65 64 20 77 69 74 68 2e 20 4f 4c  ociated with. OL
41b0: 44 20 61 6e 64 20 4e 45 57 20 72 65 66 65 72 65  D and NEW refere
41c0: 6e 63 65 73 20 6d 61 79 20 6f 6e 6c 79 20 62 65  nces may only be
41d0: 20 75 73 65 64 20 69 6e 20 74 72 69 67 67 65 72   used in trigger
41e0: 73 20 6f 6e 0a 3c 69 3e 74 72 69 67 67 65 72 2d  s on.<i>trigger-
41f0: 65 76 65 6e 74 3c 2f 69 3e 73 20 66 6f 72 20 77  event</i>s for w
4200: 68 69 63 68 20 74 68 65 79 20 61 72 65 20 72 65  hich they are re
4210: 6c 65 76 61 6e 74 2c 20 61 73 20 66 6f 6c 6c 6f  levant, as follo
4220: 77 73 3a 3c 2f 70 3e 0a 0a 3c 74 61 62 6c 65 20  ws:</p>..<table 
4230: 62 6f 72 64 65 72 3d 30 20 63 65 6c 6c 70 61 64  border=0 cellpad
4240: 64 69 6e 67 3d 31 30 3e 0a 3c 74 72 3e 0a 3c 74  ding=10>.<tr>.<t
4250: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61  d valign="top" a
4260: 6c 69 67 6e 3d 22 72 69 67 68 74 22 20 77 69 64  lign="right" wid
4270: 74 68 3d 31 32 30 3e 3c 69 3e 49 4e 53 45 52 54  th=120><i>INSERT
4280: 3c 2f 69 3e 3c 2f 74 64 3e 0a 3c 74 64 20 76 61  </i></td>.<td va
4290: 6c 69 67 6e 3d 22 74 6f 70 22 3e 4e 45 57 20 72  lign="top">NEW r
42a0: 65 66 65 72 65 6e 63 65 73 20 61 72 65 20 76 61  eferences are va
42b0: 6c 69 64 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c  lid</td>.</tr>.<
42c0: 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22  tr>.<td valign="
42d0: 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68  top" align="righ
42e0: 74 22 20 77 69 64 74 68 3d 31 32 30 3e 3c 69 3e  t" width=120><i>
42f0: 55 50 44 41 54 45 3c 2f 69 3e 3c 2f 74 64 3e 0a  UPDATE</i></td>.
4300: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
4310: 3e 4e 45 57 20 61 6e 64 20 4f 4c 44 20 72 65 66  >NEW and OLD ref
4320: 65 72 65 6e 63 65 73 20 61 72 65 20 76 61 6c 69  erences are vali
4330: 64 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 74 72  d</td>.</tr>.<tr
4340: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
4350: 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22  p" align="right"
4360: 20 77 69 64 74 68 3d 31 32 30 3e 3c 69 3e 44 45   width=120><i>DE
4370: 4c 45 54 45 3c 2f 69 3e 3c 2f 74 64 3e 0a 3c 74  LETE</i></td>.<t
4380: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 4f  d valign="top">O
4390: 4c 44 20 72 65 66 65 72 65 6e 63 65 73 20 61 72  LD references ar
43a0: 65 20 76 61 6c 69 64 3c 2f 74 64 3e 0a 3c 2f 74  e valid</td>.</t
43b0: 72 3e 0a 3c 2f 74 61 62 6c 65 3e 0a 3c 2f 70 3e  r>.</table>.</p>
43c0: 0a 0a 3c 70 3e 49 66 20 61 20 57 48 45 4e 20 63  ..<p>If a WHEN c
43d0: 6c 61 75 73 65 20 69 73 20 73 75 70 70 6c 69 65  lause is supplie
43e0: 64 2c 20 74 68 65 20 53 51 4c 20 73 74 61 74 65  d, the SQL state
43f0: 6d 65 6e 74 73 20 73 70 65 63 69 66 69 65 64 20  ments specified 
4400: 61 73 20 3c 69 3e 74 72 69 67 67 65 72 2d 73 74  as <i>trigger-st
4410: 65 70 73 3c 2f 69 3e 20 61 72 65 20 6f 6e 6c 79  eps</i> are only
4420: 20 65 78 65 63 75 74 65 64 20 66 6f 72 20 72 6f   executed for ro
4430: 77 73 20 66 6f 72 20 77 68 69 63 68 20 74 68 65  ws for which the
4440: 20 57 48 45 4e 20 63 6c 61 75 73 65 20 69 73 20   WHEN clause is 
4450: 74 72 75 65 2e 20 49 66 20 6e 6f 20 57 48 45 4e  true. If no WHEN
4460: 20 63 6c 61 75 73 65 20 69 73 20 73 75 70 70 6c   clause is suppl
4470: 69 65 64 2c 20 74 68 65 20 53 51 4c 20 73 74 61  ied, the SQL sta
4480: 74 65 6d 65 6e 74 73 20 61 72 65 20 65 78 65 63  tements are exec
4490: 75 74 65 64 20 66 6f 72 20 61 6c 6c 20 72 6f 77  uted for all row
44a0: 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 73  s.</p>..<p>The s
44b0: 70 65 63 69 66 69 65 64 20 3c 69 3e 74 72 69 67  pecified <i>trig
44c0: 67 65 72 2d 74 69 6d 65 3c 2f 69 3e 20 64 65 74  ger-time</i> det
44d0: 65 72 6d 69 6e 65 73 20 77 68 65 6e 20 74 68 65  ermines when the
44e0: 20 3c 69 3e 74 72 69 67 67 65 72 2d 73 74 65 70   <i>trigger-step
44f0: 73 3c 2f 69 3e 0a 77 69 6c 6c 20 62 65 20 65 78  s</i>.will be ex
4500: 65 63 75 74 65 64 20 72 65 6c 61 74 69 76 65 20  ecuted relative 
4510: 74 6f 20 74 68 65 20 69 6e 73 65 72 74 69 6f 6e  to the insertion
4520: 2c 20 6d 6f 64 69 66 69 63 61 74 69 6f 6e 20 6f  , modification o
4530: 72 20 72 65 6d 6f 76 61 6c 20 6f 66 20 74 68 65  r removal of the
4540: 0a 61 73 73 6f 63 69 61 74 65 64 20 72 6f 77 2e  .associated row.
4550: 3c 2f 70 3e 0a 0a 3c 70 3e 41 6e 20 4f 4e 20 43  </p>..<p>An ON C
4560: 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73 65 20 6d  ONFLICT clause m
4570: 61 79 20 62 65 20 73 70 65 63 69 66 69 65 64 20  ay be specified 
4580: 61 73 20 70 61 72 74 20 6f 66 20 61 6e 20 55 50  as part of an UP
4590: 44 41 54 45 20 6f 72 20 49 4e 53 45 52 54 0a 3c  DATE or INSERT.<
45a0: 69 3e 74 72 69 67 67 65 72 2d 73 74 65 70 3c 2f  i>trigger-step</
45b0: 69 3e 2e 20 48 6f 77 65 76 65 72 20 69 66 20 61  i>. However if a
45c0: 6e 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c  n ON CONFLICT cl
45d0: 61 75 73 65 20 69 73 20 73 70 65 63 69 66 69 65  ause is specifie
45e0: 64 20 61 73 20 70 61 72 74 20 6f 66 20 0a 74 68  d as part of .th
45f0: 65 20 73 74 61 74 65 6d 65 6e 74 20 63 61 75 73  e statement caus
4600: 69 6e 67 20 74 68 65 20 74 72 69 67 67 65 72 20  ing the trigger 
4610: 74 6f 20 66 69 72 65 2c 20 74 68 65 6e 20 74 68  to fire, then th
4620: 69 73 20 63 6f 6e 66 6c 69 63 74 20 68 61 6e 64  is conflict hand
4630: 6c 69 6e 67 0a 70 6f 6c 69 63 79 20 69 73 20 75  ling.policy is u
4640: 73 65 64 20 69 6e 73 74 65 61 64 2e 3c 2f 70 3e  sed instead.</p>
4650: 0a 0a 3c 70 3e 54 72 69 67 67 65 72 73 20 61 72  ..<p>Triggers ar
4660: 65 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  e automatically 
4670: 64 72 6f 70 70 65 64 20 77 68 65 6e 20 74 68 65  dropped when the
4680: 20 74 61 62 6c 65 20 74 68 61 74 20 74 68 65 79   table that they
4690: 20 61 72 65 20 0a 61 73 73 6f 63 69 61 74 65 64   are .associated
46a0: 20 77 69 74 68 20 69 73 20 64 72 6f 70 70 65 64   with is dropped
46b0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 72 69 67 67 65  .</p>..<p>Trigge
46c0: 72 73 20 6d 61 79 20 62 65 20 63 72 65 61 74 65  rs may be create
46d0: 64 20 6f 6e 20 76 69 65 77 73 2c 20 61 73 20 77  d on views, as w
46e0: 65 6c 6c 20 61 73 20 6f 72 64 69 6e 61 72 79 20  ell as ordinary 
46f0: 74 61 62 6c 65 73 2c 20 62 79 20 73 70 65 63 69  tables, by speci
4700: 66 79 69 6e 67 0a 49 4e 53 54 45 41 44 20 4f 46  fying.INSTEAD OF
4710: 20 69 6e 20 74 68 65 20 43 52 45 41 54 45 20 54   in the CREATE T
4720: 52 49 47 47 45 52 20 73 74 61 74 65 6d 65 6e 74  RIGGER statement
4730: 2e 20 49 66 20 6f 6e 65 20 6f 72 20 6d 6f 72 65  . If one or more
4740: 20 4f 4e 20 49 4e 53 45 52 54 2c 20 4f 4e 20 44   ON INSERT, ON D
4750: 45 4c 45 54 45 0a 6f 72 20 4f 4e 20 55 50 44 41  ELETE.or ON UPDA
4760: 54 45 20 74 72 69 67 67 65 72 73 20 61 72 65 20  TE triggers are 
4770: 64 65 66 69 6e 65 64 20 6f 6e 20 61 20 76 69 65  defined on a vie
4780: 77 2c 20 74 68 65 6e 20 69 74 20 69 73 20 6e 6f  w, then it is no
4790: 74 20 61 6e 20 65 72 72 6f 72 20 74 6f 20 65 78  t an error to ex
47a0: 65 63 75 74 65 0a 61 6e 20 49 4e 53 45 52 54 2c  ecute.an INSERT,
47b0: 20 44 45 4c 45 54 45 20 6f 72 20 55 50 44 41 54   DELETE or UPDAT
47c0: 45 20 73 74 61 74 65 6d 65 6e 74 20 6f 6e 20 74  E statement on t
47d0: 68 65 20 76 69 65 77 2c 20 72 65 73 70 65 63 74  he view, respect
47e0: 69 76 65 6c 79 2e 20 54 68 65 72 65 61 66 74 65  ively. Thereafte
47f0: 72 2c 0a 65 78 65 63 75 74 69 6e 67 20 61 6e 20  r,.executing an 
4800: 49 4e 53 45 52 54 2c 20 44 45 4c 45 54 45 20 6f  INSERT, DELETE o
4810: 72 20 55 50 44 41 54 45 20 6f 6e 20 74 68 65 20  r UPDATE on the 
4820: 76 69 65 77 20 63 61 75 73 65 73 20 74 68 65 20  view causes the 
4830: 61 73 73 6f 63 69 61 74 65 64 0a 20 20 74 72 69  associated.  tri
4840: 67 67 65 72 73 20 74 6f 20 66 69 72 65 2e 20 54  ggers to fire. T
4850: 68 65 20 72 65 61 6c 20 74 61 62 6c 65 73 20 75  he real tables u
4860: 6e 64 65 72 6c 79 69 6e 67 20 74 68 65 20 76 69  nderlying the vi
4870: 65 77 20 61 72 65 20 6e 6f 74 20 6d 6f 64 69 66  ew are not modif
4880: 69 65 64 0a 20 20 28 65 78 63 65 70 74 20 70 6f  ied.  (except po
4890: 73 73 69 62 6c 79 20 65 78 70 6c 69 63 69 74 6c  ssibly explicitl
48a0: 79 2c 20 62 79 20 61 20 74 72 69 67 67 65 72 20  y, by a trigger 
48b0: 70 72 6f 67 72 61 6d 29 2e 3c 2f 70 3e 0a 0a 3c  program).</p>..<
48c0: 70 3e 3c 62 3e 45 78 61 6d 70 6c 65 3a 3c 2f 62  p><b>Example:</b
48d0: 3e 3c 2f 70 3e 0a 0a 3c 70 3e 41 73 73 75 6d 69  ></p>..<p>Assumi
48e0: 6e 67 20 74 68 61 74 20 63 75 73 74 6f 6d 65 72  ng that customer
48f0: 20 72 65 63 6f 72 64 73 20 61 72 65 20 73 74 6f   records are sto
4900: 72 65 64 20 69 6e 20 74 68 65 20 22 63 75 73 74  red in the "cust
4910: 6f 6d 65 72 73 22 20 74 61 62 6c 65 2c 20 61 6e  omers" table, an
4920: 64 0a 74 68 61 74 20 6f 72 64 65 72 20 72 65 63  d.that order rec
4930: 6f 72 64 73 20 61 72 65 20 73 74 6f 72 65 64 20  ords are stored 
4940: 69 6e 20 74 68 65 20 22 6f 72 64 65 72 73 22 20  in the "orders" 
4950: 74 61 62 6c 65 2c 20 74 68 65 20 66 6f 6c 6c 6f  table, the follo
4960: 77 69 6e 67 20 74 72 69 67 67 65 72 0a 65 6e 73  wing trigger.ens
4970: 75 72 65 73 20 74 68 61 74 20 61 6c 6c 20 61 73  ures that all as
4980: 73 6f 63 69 61 74 65 64 20 6f 72 64 65 72 73 20  sociated orders 
4990: 61 72 65 20 72 65 64 69 72 65 63 74 65 64 20 77  are redirected w
49a0: 68 65 6e 20 61 20 63 75 73 74 6f 6d 65 72 20 63  hen a customer c
49b0: 68 61 6e 67 65 73 0a 68 69 73 20 6f 72 20 68 65  hanges.his or he
49c0: 72 20 61 64 64 72 65 73 73 3a 3c 2f 70 3e 0a 7d  r address:</p>.}
49d0: 0a 45 78 61 6d 70 6c 65 20 7b 0a 43 52 45 41 54  .Example {.CREAT
49e0: 45 20 54 52 49 47 47 45 52 20 75 70 64 61 74 65  E TRIGGER update
49f0: 5f 63 75 73 74 6f 6d 65 72 5f 61 64 64 72 65 73  _customer_addres
4a00: 73 20 55 50 44 41 54 45 20 4f 46 20 61 64 64 72  s UPDATE OF addr
4a10: 65 73 73 20 4f 4e 20 63 75 73 74 6f 6d 65 72 73  ess ON customers
4a20: 20 0a 20 20 42 45 47 49 4e 0a 20 20 20 20 55 50   .  BEGIN.    UP
4a30: 44 41 54 45 20 6f 72 64 65 72 73 20 53 45 54 20  DATE orders SET 
4a40: 61 64 64 72 65 73 73 20 3d 20 6e 65 77 2e 61 64  address = new.ad
4a50: 64 72 65 73 73 20 57 48 45 52 45 20 63 75 73 74  dress WHERE cust
4a60: 6f 6d 65 72 5f 6e 61 6d 65 20 3d 20 6f 6c 64 2e  omer_name = old.
4a70: 6e 61 6d 65 3b 0a 20 20 45 4e 44 3b 0a 7d 0a 70  name;.  END;.}.p
4a80: 75 74 73 20 7b 0a 3c 70 3e 57 69 74 68 20 74 68  uts {.<p>With th
4a90: 69 73 20 74 72 69 67 67 65 72 20 69 6e 73 74 61  is trigger insta
4aa0: 6c 6c 65 64 2c 20 65 78 65 63 75 74 69 6e 67 20  lled, executing 
4ab0: 74 68 65 20 73 74 61 74 65 6d 65 6e 74 3a 3c 2f  the statement:</
4ac0: 70 3e 0a 7d 0a 0a 45 78 61 6d 70 6c 65 20 7b 0a  p>.}..Example {.
4ad0: 55 50 44 41 54 45 20 63 75 73 74 6f 6d 65 72 73  UPDATE customers
4ae0: 20 53 45 54 20 61 64 64 72 65 73 73 20 3d 20 27   SET address = '
4af0: 31 20 4d 61 69 6e 20 53 74 2e 27 20 57 48 45 52  1 Main St.' WHER
4b00: 45 20 6e 61 6d 65 20 3d 20 27 4a 61 63 6b 20 4a  E name = 'Jack J
4b10: 6f 6e 65 73 27 3b 0a 7d 0a 70 75 74 73 20 7b 0a  ones';.}.puts {.
4b20: 3c 70 3e 63 61 75 73 65 73 20 74 68 65 20 66 6f  <p>causes the fo
4b30: 6c 6c 6f 77 69 6e 67 20 74 6f 20 62 65 20 61 75  llowing to be au
4b40: 74 6f 6d 61 74 69 63 61 6c 6c 79 20 65 78 65 63  tomatically exec
4b50: 75 74 65 64 3a 3c 2f 70 3e 0a 7d 0a 45 78 61 6d  uted:</p>.}.Exam
4b60: 70 6c 65 20 7b 0a 55 50 44 41 54 45 20 6f 72 64  ple {.UPDATE ord
4b70: 65 72 73 20 53 45 54 20 61 64 64 72 65 73 73 20  ers SET address 
4b80: 3d 20 27 31 20 4d 61 69 6e 20 53 74 2e 27 20 57  = '1 Main St.' W
4b90: 48 45 52 45 20 63 75 73 74 6f 6d 65 72 5f 6e 61  HERE customer_na
4ba0: 6d 65 20 3d 20 27 4a 61 63 6b 20 4a 6f 6e 65 73  me = 'Jack Jones
4bb0: 27 3b 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  ';.}..puts {.<p>
4bc0: 4e 6f 74 65 20 74 68 61 74 20 63 75 72 72 65 6e  Note that curren
4bd0: 74 6c 79 2c 20 74 72 69 67 67 65 72 73 20 6d 61  tly, triggers ma
4be0: 79 20 62 65 68 61 76 65 20 6f 64 64 6c 79 20 77  y behave oddly w
4bf0: 68 65 6e 20 63 72 65 61 74 65 64 20 6f 6e 20 74  hen created on t
4c00: 61 62 6c 65 73 0a 20 20 77 69 74 68 20 49 4e 54  ables.  with INT
4c10: 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59  EGER PRIMARY KEY
4c20: 20 66 69 65 6c 64 73 2e 20 49 66 20 61 20 42 45   fields. If a BE
4c30: 46 4f 52 45 20 74 72 69 67 67 65 72 20 70 72 6f  FORE trigger pro
4c40: 67 72 61 6d 20 6d 6f 64 69 66 69 65 73 20 74 68  gram modifies th
4c50: 65 20 0a 20 20 49 4e 54 45 47 45 52 20 50 52 49  e .  INTEGER PRI
4c60: 4d 41 52 59 20 4b 45 59 20 66 69 65 6c 64 20 6f  MARY KEY field o
4c70: 66 20 61 20 72 6f 77 20 74 68 61 74 20 77 69 6c  f a row that wil
4c80: 6c 20 62 65 20 73 75 62 73 65 71 75 65 6e 74 6c  l be subsequentl
4c90: 79 20 75 70 64 61 74 65 64 20 62 79 20 74 68 65  y updated by the
4ca0: 0a 20 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61  .  statement tha
4cb0: 74 20 63 61 75 73 65 73 20 74 68 65 20 74 72 69  t causes the tri
4cc0: 67 67 65 72 20 74 6f 20 66 69 72 65 2c 20 74 68  gger to fire, th
4cd0: 65 6e 20 74 68 65 20 75 70 64 61 74 65 20 6d 61  en the update ma
4ce0: 79 20 6e 6f 74 20 6f 63 63 75 72 2e 20 0a 20 20  y not occur. .  
4cf0: 54 68 65 20 77 6f 72 6b 61 72 6f 75 6e 64 20 69  The workaround i
4d00: 73 20 74 6f 20 64 65 63 6c 61 72 65 20 74 68 65  s to declare the
4d10: 20 74 61 62 6c 65 20 77 69 74 68 20 61 20 50 52   table with a PR
4d20: 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d 6e  IMARY KEY column
4d30: 20 69 6e 73 74 65 61 64 0a 20 20 6f 66 20 61 6e   instead.  of an
4d40: 20 49 4e 54 45 47 45 52 20 50 52 49 4d 41 52 59   INTEGER PRIMARY
4d50: 20 4b 45 59 20 63 6f 6c 75 6d 6e 2e 3c 2f 70 3e   KEY column.</p>
4d60: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 41 20  .}..puts {.<p>A 
4d70: 73 70 65 63 69 61 6c 20 53 51 4c 20 66 75 6e 63  special SQL func
4d80: 74 69 6f 6e 20 52 41 49 53 45 28 29 20 6d 61 79  tion RAISE() may
4d90: 20 62 65 20 75 73 65 64 20 77 69 74 68 69 6e 20   be used within 
4da0: 61 20 74 72 69 67 67 65 72 2d 70 72 6f 67 72 61  a trigger-progra
4db0: 6d 2c 20 77 69 74 68 20 74 68 65 20 66 6f 6c 6c  m, with the foll
4dc0: 6f 77 69 6e 67 20 73 79 6e 74 61 78 3c 2f 70 3e  owing syntax</p>
4dd0: 20 0a 7d 0a 53 79 6e 74 61 78 20 7b 72 61 69 73   .}.Syntax {rais
4de0: 65 2d 66 75 6e 63 74 69 6f 6e 7d 20 7b 0a 52 41  e-function} {.RA
4df0: 49 53 45 20 28 20 41 42 4f 52 54 2c 20 3c 65 72  ISE ( ABORT, <er
4e00: 72 6f 72 2d 6d 65 73 73 61 67 65 3e 20 29 20 7c  ror-message> ) |
4e10: 20 0a 52 41 49 53 45 20 28 20 46 41 49 4c 2c 20   .RAISE ( FAIL, 
4e20: 3c 65 72 72 6f 72 2d 6d 65 73 73 61 67 65 3e 20  <error-message> 
4e30: 29 20 7c 20 0a 52 41 49 53 45 20 28 20 52 4f 4c  ) | .RAISE ( ROL
4e40: 4c 42 41 43 4b 2c 20 3c 65 72 72 6f 72 2d 6d 65  LBACK, <error-me
4e50: 73 73 61 67 65 3e 20 29 20 7c 20 0a 52 41 49 53  ssage> ) | .RAIS
4e60: 45 20 28 20 49 47 4e 4f 52 45 20 29 0a 7d 0a 70  E ( IGNORE ).}.p
4e70: 75 74 73 20 7b 0a 3c 70 3e 57 68 65 6e 20 6f 6e  uts {.<p>When on
4e80: 65 20 6f 66 20 74 68 65 20 66 69 72 73 74 20 74  e of the first t
4e90: 68 72 65 65 20 66 6f 72 6d 73 20 69 73 20 63 61  hree forms is ca
4ea0: 6c 6c 65 64 20 64 75 72 69 6e 67 20 74 72 69 67  lled during trig
4eb0: 67 65 72 2d 70 72 6f 67 72 61 6d 20 65 78 65 63  ger-program exec
4ec0: 75 74 69 6f 6e 2c 20 74 68 65 20 73 70 65 63 69  ution, the speci
4ed0: 66 69 65 64 20 4f 4e 20 43 4f 4e 46 4c 49 43 54  fied ON CONFLICT
4ee0: 20 70 72 6f 63 65 73 73 69 6e 67 20 69 73 20 70   processing is p
4ef0: 65 72 66 6f 72 6d 65 64 20 28 65 69 74 68 65 72  erformed (either
4f00: 20 41 42 4f 52 54 2c 20 46 41 49 4c 20 6f 72 20   ABORT, FAIL or 
4f10: 0a 20 52 4f 4c 4c 42 41 43 4b 29 20 61 6e 64 20  . ROLLBACK) and 
4f20: 74 68 65 20 63 75 72 72 65 6e 74 20 71 75 65 72  the current quer
4f30: 79 20 74 65 72 6d 69 6e 61 74 65 73 2e 20 41 6e  y terminates. An
4f40: 20 65 72 72 6f 72 20 63 6f 64 65 20 6f 66 20 53   error code of S
4f50: 51 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54  QLITE_CONSTRAINT
4f60: 20 69 73 20 72 65 74 75 72 6e 65 64 20 74 6f 20   is returned to 
4f70: 74 68 65 20 75 73 65 72 2c 20 61 6c 6f 6e 67 20  the user, along 
4f80: 77 69 74 68 20 74 68 65 20 73 70 65 63 69 66 69  with the specifi
4f90: 65 64 20 65 72 72 6f 72 20 6d 65 73 73 61 67 65  ed error message
4fa0: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 57 68 65 6e 20 52  .</p>..<p>When R
4fb0: 41 49 53 45 28 49 47 4e 4f 52 45 29 20 69 73 20  AISE(IGNORE) is 
4fc0: 63 61 6c 6c 65 64 2c 20 74 68 65 20 72 65 6d 61  called, the rema
4fd0: 69 6e 64 65 72 20 6f 66 20 74 68 65 20 63 75 72  inder of the cur
4fe0: 72 65 6e 74 20 74 72 69 67 67 65 72 20 70 72 6f  rent trigger pro
4ff0: 67 72 61 6d 2c 0a 74 68 65 20 73 74 61 74 65 6d  gram,.the statem
5000: 65 6e 74 20 74 68 61 74 20 63 61 75 73 65 64 20  ent that caused 
5010: 74 68 65 20 74 72 69 67 67 65 72 20 70 72 6f 67  the trigger prog
5020: 72 61 6d 20 74 6f 20 65 78 65 63 75 74 65 20 61  ram to execute a
5030: 6e 64 20 61 6e 79 20 73 75 62 73 65 71 75 65 6e  nd any subsequen
5040: 74 0a 20 20 20 20 74 72 69 67 67 65 72 20 70 72  t.    trigger pr
5050: 6f 67 72 61 6d 73 20 74 68 61 74 20 77 6f 75 6c  ograms that woul
5060: 64 20 6f 66 20 62 65 65 6e 20 65 78 65 63 75 74  d of been execut
5070: 65 64 20 61 72 65 20 61 62 61 6e 64 6f 6e 65 64  ed are abandoned
5080: 2e 20 4e 6f 20 64 61 74 61 62 61 73 65 0a 20 20  . No database.  
5090: 20 20 63 68 61 6e 67 65 73 20 61 72 65 20 72 6f    changes are ro
50a0: 6c 6c 65 64 20 62 61 63 6b 2e 20 20 49 66 20 74  lled back.  If t
50b0: 68 65 20 73 74 61 74 65 6d 65 6e 74 20 74 68 61  he statement tha
50c0: 74 20 63 61 75 73 65 64 20 74 68 65 20 74 72 69  t caused the tri
50d0: 67 67 65 72 20 70 72 6f 67 72 61 6d 0a 20 20 20  gger program.   
50e0: 20 74 6f 20 65 78 65 63 75 74 65 20 69 73 20 69   to execute is i
50f0: 74 73 65 6c 66 20 70 61 72 74 20 6f 66 20 61 20  tself part of a 
5100: 74 72 69 67 67 65 72 20 70 72 6f 67 72 61 6d 2c  trigger program,
5110: 20 74 68 65 6e 20 74 68 61 74 20 74 72 69 67 67   then that trigg
5120: 65 72 20 70 72 6f 67 72 61 6d 0a 20 20 20 20 72  er program.    r
5130: 65 73 75 6d 65 73 20 65 78 65 63 75 74 69 6f 6e  esumes execution
5140: 20 61 74 20 74 68 65 20 62 65 67 69 6e 6e 69 6e   at the beginnin
5150: 67 20 6f 66 20 74 68 65 20 6e 65 78 74 20 73 74  g of the next st
5160: 65 70 2e 0a 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63  ep..</p>.}...Sec
5170: 74 69 6f 6e 20 7b 43 52 45 41 54 45 20 56 49 45  tion {CREATE VIE
5180: 57 7d 20 7b 63 72 65 61 74 65 76 69 65 77 7d 0a  W} {createview}.
5190: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d  .Syntax {sql-com
51a0: 6d 61 6e 64 7d 20 7b 0a 43 52 45 41 54 45 20 5b  mand} {.CREATE [
51b0: 54 45 4d 50 20 7c 20 54 45 4d 50 4f 52 41 52 59  TEMP | TEMPORARY
51c0: 5d 20 56 49 45 57 20 3c 76 69 65 77 2d 6e 61 6d  ] VIEW <view-nam
51d0: 65 3e 20 41 53 20 3c 73 65 6c 65 63 74 2d 73 74  e> AS <select-st
51e0: 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74 73  atement>.}..puts
51f0: 20 7b 0a 3c 70 3e 54 68 65 20 43 52 45 41 54 45   {.<p>The CREATE
5200: 20 56 49 45 57 20 63 6f 6d 6d 61 6e 64 20 61 73   VIEW command as
5210: 73 69 67 6e 73 20 61 20 6e 61 6d 65 20 74 6f 20  signs a name to 
5220: 61 20 70 72 65 2d 70 61 63 6b 61 67 65 64 20 53  a pre-packaged S
5230: 45 4c 45 43 54 0a 73 74 61 74 65 6d 65 6e 74 2e  ELECT.statement.
5240: 20 20 4f 6e 63 65 20 74 68 65 20 76 69 65 77 20    Once the view 
5250: 69 73 20 63 72 65 61 74 65 64 2c 20 69 74 20 63  is created, it c
5260: 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 74 68  an be used in th
5270: 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 0a 6f 66  e FROM clause.of
5280: 20 61 6e 6f 74 68 65 72 20 53 45 4c 45 43 54 20   another SELECT 
5290: 69 6e 20 70 6c 61 63 65 20 6f 66 20 61 20 74 61  in place of a ta
52a0: 62 6c 65 20 6e 61 6d 65 2e 0a 3c 2f 70 3e 0a 0a  ble name..</p>..
52b0: 3c 70 3e 59 6f 75 20 63 61 6e 6e 6f 74 20 43 4f  <p>You cannot CO
52c0: 50 59 2c 20 49 4e 53 45 52 54 20 6f 72 20 55 50  PY, INSERT or UP
52d0: 44 41 54 45 20 61 20 76 69 65 77 2e 20 20 56 69  DATE a view.  Vi
52e0: 65 77 73 20 61 72 65 20 72 65 61 64 2d 6f 6e 6c  ews are read-onl
52f0: 79 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69  y.</p>.}...Secti
5300: 6f 6e 20 44 45 4c 45 54 45 20 64 65 6c 65 74 65  on DELETE delete
5310: 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74  ..Syntax {sql-st
5320: 61 74 65 6d 65 6e 74 7d 20 7b 0a 44 45 4c 45 54  atement} {.DELET
5330: 45 20 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6e 61  E FROM <table-na
5340: 6d 65 3e 20 5b 57 48 45 52 45 20 3c 65 78 70 72  me> [WHERE <expr
5350: 3e 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  >].}..puts {.<p>
5360: 54 68 65 20 44 45 4c 45 54 45 20 63 6f 6d 6d 61  The DELETE comma
5370: 6e 64 20 69 73 20 75 73 65 64 20 74 6f 20 72 65  nd is used to re
5380: 6d 6f 76 65 20 72 65 63 6f 72 64 73 20 66 72 6f  move records fro
5390: 6d 20 61 20 74 61 62 6c 65 2e 0a 54 68 65 20 63  m a table..The c
53a0: 6f 6d 6d 61 6e 64 20 63 6f 6e 73 69 73 74 73 20  ommand consists 
53b0: 6f 66 20 74 68 65 20 22 44 45 4c 45 54 45 20 46  of the "DELETE F
53c0: 52 4f 4d 22 20 6b 65 79 77 6f 72 64 73 20 66 6f  ROM" keywords fo
53d0: 6c 6c 6f 77 65 64 20 62 79 0a 74 68 65 20 6e 61  llowed by.the na
53e0: 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  me of the table 
53f0: 66 72 6f 6d 20 77 68 69 63 68 20 72 65 63 6f 72  from which recor
5400: 64 73 20 61 72 65 20 74 6f 20 62 65 20 72 65 6d  ds are to be rem
5410: 6f 76 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 57  oved..</p>..<p>W
5420: 69 74 68 6f 75 74 20 61 20 57 48 45 52 45 20 63  ithout a WHERE c
5430: 6c 61 75 73 65 2c 20 61 6c 6c 20 72 6f 77 73 20  lause, all rows 
5440: 6f 66 20 74 68 65 20 74 61 62 6c 65 20 61 72 65  of the table are
5450: 20 72 65 6d 6f 76 65 64 2e 0a 49 66 20 61 20 57   removed..If a W
5460: 48 45 52 45 20 63 6c 61 75 73 65 20 69 73 20 73  HERE clause is s
5470: 75 70 70 6c 69 65 64 2c 20 74 68 65 6e 20 6f 6e  upplied, then on
5480: 6c 79 20 74 68 6f 73 65 20 72 6f 77 73 20 74 68  ly those rows th
5490: 61 74 20 6d 61 74 63 68 0a 74 68 65 20 65 78 70  at match.the exp
54a0: 72 65 73 73 69 6f 6e 20 61 72 65 20 72 65 6d 6f  ression are remo
54b0: 76 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63  ved.</p>.}...Sec
54c0: 74 69 6f 6e 20 7b 44 45 54 41 43 48 20 44 41 54  tion {DETACH DAT
54d0: 41 42 41 53 45 7d 20 64 65 74 61 63 68 64 61 74  ABASE} detachdat
54e0: 61 62 61 73 65 0a 0a 53 79 6e 74 61 78 20 7b 73  abase..Syntax {s
54f0: 71 6c 2d 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 44 45  ql-command} {.DE
5500: 54 41 43 48 20 5b 44 41 54 41 42 41 53 45 5d 20  TACH [DATABASE] 
5510: 3c 64 61 74 61 62 61 73 65 2d 6e 61 6d 65 3e 0a  <database-name>.
5520: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 69  }..puts {.<p>Thi
5530: 73 20 73 74 61 74 65 6d 65 6e 74 20 64 65 74 61  s statement deta
5540: 63 68 65 73 20 61 6e 20 61 64 64 69 74 69 6f 6e  ches an addition
5550: 61 6c 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  al database file
5560: 20 70 72 65 76 69 6f 69 75 73 6c 79 20 61 74 74   previoiusly att
5570: 61 63 68 65 64 0a 75 73 69 6e 67 20 74 68 65 20  ached.using the 
5580: 41 54 54 41 43 48 20 44 41 54 41 42 41 53 45 20  ATTACH DATABASE 
5590: 73 74 61 74 65 6d 65 6e 74 2e 3c 2f 70 3e 0a 0a  statement.</p>..
55a0: 3c 70 3e 54 68 69 73 20 73 74 61 74 65 6d 65 6e  <p>This statemen
55b0: 74 20 77 69 6c 6c 20 66 61 69 6c 20 69 66 20 53  t will fail if S
55c0: 51 4c 69 74 65 20 69 73 20 69 6e 20 74 68 65 20  QLite is in the 
55d0: 6d 69 64 64 6c 65 20 6f 66 20 61 20 74 72 61 6e  middle of a tran
55e0: 73 61 63 74 69 6f 6e 2e 3c 2f 70 3e 0a 7d 0a 0a  saction.</p>.}..
55f0: 0a 53 65 63 74 69 6f 6e 20 7b 44 52 4f 50 20 49  .Section {DROP I
5600: 4e 44 45 58 7d 20 64 72 6f 70 69 6e 64 65 78 0a  NDEX} dropindex.
5610: 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 63 6f 6d  .Syntax {sql-com
5620: 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50 20 49 4e 44  mand} {.DROP IND
5630: 45 58 20 3c 69 6e 64 65 78 2d 6e 61 6d 65 3e 0a  EX <index-name>.
5640: 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65  }..puts {.<p>The
5650: 20 44 52 4f 50 20 49 4e 44 45 58 20 73 74 61 74   DROP INDEX stat
5660: 65 6d 65 6e 74 20 63 6f 6e 73 69 73 74 73 20 6f  ement consists o
5670: 66 20 74 68 65 20 6b 65 79 77 6f 72 64 73 20 22  f the keywords "
5680: 44 52 4f 50 20 49 4e 44 45 58 22 20 66 6f 6c 6c  DROP INDEX" foll
5690: 6f 77 65 64 0a 62 79 20 74 68 65 20 6e 61 6d 65  owed.by the name
56a0: 20 6f 66 20 74 68 65 20 69 6e 64 65 78 2e 20 20   of the index.  
56b0: 54 68 65 20 69 6e 64 65 78 20 6e 61 6d 65 64 20  The index named 
56c0: 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79 20 72 65  is completely re
56d0: 6d 6f 76 65 64 20 66 72 6f 6d 0a 74 68 65 20 64  moved from.the d
56e0: 69 73 6b 2e 20 20 54 68 65 20 6f 6e 6c 79 20 77  isk.  The only w
56f0: 61 79 20 74 6f 20 72 65 63 6f 76 65 72 20 74 68  ay to recover th
5700: 65 20 69 6e 64 65 78 20 69 73 20 74 6f 20 72 65  e index is to re
5710: 65 6e 74 65 72 20 74 68 65 0a 61 70 70 72 6f 70  enter the.approp
5720: 72 69 61 74 65 20 43 52 45 41 54 45 20 49 4e 44  riate CREATE IND
5730: 45 58 20 63 6f 6d 6d 61 6e 64 2e 3c 2f 70 3e 0a  EX command.</p>.
5740: 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 7b 44 52 4f  }...Section {DRO
5750: 50 20 54 41 42 4c 45 7d 20 64 72 6f 70 74 61 62  P TABLE} droptab
5760: 6c 65 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d  le..Syntax {sql-
5770: 63 6f 6d 6d 61 6e 64 7d 20 7b 0a 44 52 4f 50 20  command} {.DROP 
5780: 54 41 42 4c 45 20 3c 74 61 62 6c 65 2d 6e 61 6d  TABLE <table-nam
5790: 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  e>.}..puts {.<p>
57a0: 54 68 65 20 44 52 4f 50 20 54 41 42 4c 45 20 73  The DROP TABLE s
57b0: 74 61 74 65 6d 65 6e 74 20 63 6f 6e 73 69 73 74  tatement consist
57c0: 73 20 6f 66 20 74 68 65 20 6b 65 79 77 6f 72 64  s of the keyword
57d0: 73 20 22 44 52 4f 50 20 54 41 42 4c 45 22 20 66  s "DROP TABLE" f
57e0: 6f 6c 6c 6f 77 65 64 0a 62 79 20 74 68 65 20 6e  ollowed.by the n
57f0: 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65  ame of the table
5800: 2e 20 20 54 68 65 20 74 61 62 6c 65 20 6e 61 6d  .  The table nam
5810: 65 64 20 69 73 20 63 6f 6d 70 6c 65 74 65 6c 79  ed is completely
5820: 20 72 65 6d 6f 76 65 64 20 66 72 6f 6d 0a 74 68   removed from.th
5830: 65 20 64 69 73 6b 2e 20 20 54 68 65 20 74 61 62  e disk.  The tab
5840: 6c 65 20 63 61 6e 20 6e 6f 74 20 62 65 20 72 65  le can not be re
5850: 63 6f 76 65 72 65 64 2e 20 20 41 6c 6c 20 69 6e  covered.  All in
5860: 64 69 63 65 73 20 61 73 73 6f 63 69 61 74 65 64  dices associated
5870: 20 77 69 74 68 0a 74 68 65 20 74 61 62 6c 65 20   with.the table 
5880: 61 72 65 20 61 6c 73 6f 20 64 65 6c 65 74 65 64  are also deleted
5890: 2e 3c 2f 70 3e 7d 0a 0a 0a 53 65 63 74 69 6f 6e  .</p>}...Section
58a0: 20 7b 44 52 4f 50 20 54 52 49 47 47 45 52 7d 20   {DROP TRIGGER} 
58b0: 64 72 6f 70 74 72 69 67 67 65 72 0a 53 79 6e 74  droptrigger.Synt
58c0: 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e  ax {sql-statemen
58d0: 74 7d 20 7b 0a 44 52 4f 50 20 54 52 49 47 47 45  t} {.DROP TRIGGE
58e0: 52 20 3c 74 72 69 67 67 65 72 2d 6e 61 6d 65 3e  R <trigger-name>
58f0: 0a 7d 0a 70 75 74 73 20 7b 20 0a 20 20 3c 70 3e  .}.puts { .  <p>
5900: 55 73 65 64 20 74 6f 20 64 72 6f 70 20 61 20 74  Used to drop a t
5910: 72 69 67 67 65 72 20 66 72 6f 6d 20 74 68 65 20  rigger from the 
5920: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 2e  database schema.
5930: 20 4e 6f 74 65 20 74 68 61 74 20 74 72 69 67 67   Note that trigg
5940: 65 72 73 0a 20 20 61 72 65 20 61 75 74 6f 6d 61  ers.  are automa
5950: 74 69 63 61 6c 6c 79 20 64 72 6f 70 70 65 64 20  tically dropped 
5960: 77 68 65 6e 20 74 68 65 20 61 73 73 6f 63 69 61  when the associa
5970: 74 65 64 20 74 61 62 6c 65 20 69 73 20 64 72 6f  ted table is dro
5980: 70 70 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65  pped.</p>.}...Se
5990: 63 74 69 6f 6e 20 7b 44 52 4f 50 20 56 49 45 57  ction {DROP VIEW
59a0: 7d 20 64 72 6f 70 76 69 65 77 0a 0a 53 79 6e 74  } dropview..Synt
59b0: 61 78 20 7b 73 71 6c 2d 63 6f 6d 6d 61 6e 64 7d  ax {sql-command}
59c0: 20 7b 0a 44 52 4f 50 20 56 49 45 57 20 3c 76 69   {.DROP VIEW <vi
59d0: 65 77 2d 6e 61 6d 65 3e 0a 7d 0a 0a 70 75 74 73  ew-name>.}..puts
59e0: 20 7b 0a 3c 70 3e 54 68 65 20 44 52 4f 50 20 56   {.<p>The DROP V
59f0: 49 45 57 20 73 74 61 74 65 6d 65 6e 74 20 63 6f  IEW statement co
5a00: 6e 73 69 73 74 73 20 6f 66 20 74 68 65 20 6b 65  nsists of the ke
5a10: 79 77 6f 72 64 73 20 22 44 52 4f 50 20 56 49 45  ywords "DROP VIE
5a20: 57 22 20 66 6f 6c 6c 6f 77 65 64 0a 62 79 20 74  W" followed.by t
5a30: 68 65 20 6e 61 6d 65 20 6f 66 20 74 68 65 20 76  he name of the v
5a40: 69 65 77 2e 20 20 54 68 65 20 76 69 65 77 20 6e  iew.  The view n
5a50: 61 6d 65 64 20 69 73 20 72 65 6d 6f 76 65 64 20  amed is removed 
5a60: 66 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73  from the databas
5a70: 65 2e 0a 42 75 74 20 6e 6f 20 61 63 74 75 61 6c  e..But no actual
5a80: 20 64 61 74 61 20 69 73 20 6d 6f 64 69 66 69 65   data is modifie
5a90: 64 2e 3c 2f 70 3e 7d 0a 0a 0a 53 65 63 74 69 6f  d.</p>}...Sectio
5aa0: 6e 20 45 58 50 4c 41 49 4e 20 65 78 70 6c 61 69  n EXPLAIN explai
5ab0: 6e 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  n..Syntax {sql-s
5ac0: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 45 58 50 4c  tatement} {.EXPL
5ad0: 41 49 4e 20 3c 73 71 6c 2d 73 74 61 74 65 6d 65  AIN <sql-stateme
5ae0: 6e 74 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  nt>.}..puts {.<p
5af0: 3e 54 68 65 20 45 58 50 4c 41 49 4e 20 63 6f 6d  >The EXPLAIN com
5b00: 6d 61 6e 64 20 6d 6f 64 69 66 69 65 72 20 69 73  mand modifier is
5b10: 20 61 20 6e 6f 6e 2d 73 74 61 6e 64 61 72 64 20   a non-standard 
5b20: 65 78 74 65 6e 73 69 6f 6e 2e 20 20 54 68 65 0a  extension.  The.
5b30: 69 64 65 61 20 63 6f 6d 65 73 20 66 72 6f 6d 20  idea comes from 
5b40: 61 20 73 69 6d 69 6c 61 72 20 63 6f 6d 6d 61 6e  a similar comman
5b50: 64 20 66 6f 75 6e 64 20 69 6e 20 50 6f 73 74 67  d found in Postg
5b60: 72 65 53 51 4c 2c 20 62 75 74 20 74 68 65 20 6f  reSQL, but the o
5b70: 70 65 72 61 74 69 6f 6e 0a 69 73 20 63 6f 6d 70  peration.is comp
5b80: 6c 65 74 65 6c 79 20 64 69 66 66 65 72 65 6e 74  letely different
5b90: 2e 3c 2f 70 3e 0a 0a 3c 70 3e 49 66 20 74 68 65  .</p>..<p>If the
5ba0: 20 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64   EXPLAIN keyword
5bb0: 20 61 70 70 65 61 72 73 20 62 65 66 6f 72 65 20   appears before 
5bc0: 61 6e 79 20 6f 74 68 65 72 20 53 51 4c 69 74 65  any other SQLite
5bd0: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 0a 74 68 65   SQL command.the
5be0: 6e 20 69 6e 73 74 65 61 64 20 6f 66 20 61 63 74  n instead of act
5bf0: 75 61 6c 6c 79 20 65 78 65 63 75 74 69 6e 67 20  ually executing 
5c00: 74 68 65 20 63 6f 6d 6d 61 6e 64 2c 20 74 68 65  the command, the
5c10: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20   SQLite library 
5c20: 77 69 6c 6c 0a 72 65 70 6f 72 74 20 62 61 63 6b  will.report back
5c30: 20 74 68 65 20 73 65 71 75 65 6e 63 65 20 6f 66   the sequence of
5c40: 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65   virtual machine
5c50: 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 69 74   instructions it
5c60: 20 77 6f 75 6c 64 20 68 61 76 65 0a 75 73 65 64   would have.used
5c70: 20 74 6f 20 65 78 65 63 75 74 65 20 74 68 65 20   to execute the 
5c80: 63 6f 6d 6d 61 6e 64 20 68 61 64 20 74 68 65 20  command had the 
5c90: 45 58 50 4c 41 49 4e 20 6b 65 79 77 6f 72 64 20  EXPLAIN keyword 
5ca0: 6e 6f 74 20 62 65 65 6e 20 70 72 65 73 65 6e 74  not been present
5cb0: 2e 0a 46 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c  ..For additional
5cc0: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 61 62 6f   information abo
5cd0: 75 74 20 76 69 72 74 75 61 6c 20 6d 61 63 68 69  ut virtual machi
5ce0: 6e 65 20 69 6e 73 74 72 75 63 74 69 6f 6e 73 20  ne instructions 
5cf0: 73 65 65 0a 74 68 65 20 3c 61 20 68 72 65 66 3d  see.the <a href=
5d00: 22 61 72 63 68 2e 68 74 6d 6c 22 3e 61 72 63 68  "arch.html">arch
5d10: 69 74 65 63 74 75 72 65 20 64 65 73 63 72 69 70  itecture descrip
5d20: 74 69 6f 6e 3c 2f 61 3e 20 6f 72 20 74 68 65 20  tion</a> or the 
5d30: 64 6f 63 75 6d 65 6e 74 61 74 69 6f 6e 0a 6f 6e  documentation.on
5d40: 20 3c 61 20 68 72 65 66 3d 22 6f 70 63 6f 64 65   <a href="opcode
5d50: 2e 68 74 6d 6c 22 3e 61 76 61 69 6c 61 62 6c 65  .html">available
5d60: 20 6f 70 63 6f 64 65 73 3c 2f 61 3e 20 66 6f 72   opcodes</a> for
5d70: 20 74 68 65 20 76 69 72 74 75 61 6c 20 6d 61 63   the virtual mac
5d80: 68 69 6e 65 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65  hine.</p>.}...Se
5d90: 63 74 69 6f 6e 20 65 78 70 72 65 73 73 69 6f 6e  ction expression
5da0: 20 65 78 70 72 0a 0a 53 79 6e 74 61 78 20 7b 65   expr..Syntax {e
5db0: 78 70 72 7d 20 7b 0a 3c 65 78 70 72 3e 20 3c 62  xpr} {.<expr> <b
5dc0: 69 6e 61 72 79 2d 6f 70 3e 20 3c 65 78 70 72 3e  inary-op> <expr>
5dd0: 20 7c 0a 3c 65 78 70 72 3e 20 3c 6c 69 6b 65 2d   |.<expr> <like-
5de0: 6f 70 3e 20 3c 65 78 70 72 3e 20 7c 0a 3c 75 6e  op> <expr> |.<un
5df0: 61 72 79 2d 6f 70 3e 20 3c 65 78 70 72 3e 20 7c  ary-op> <expr> |
5e00: 0a 28 20 3c 65 78 70 72 3e 20 29 20 7c 0a 3c 63  .( <expr> ) |.<c
5e10: 6f 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 74  olumn-name> |.<t
5e20: 61 62 6c 65 2d 6e 61 6d 65 3e 20 2e 20 3c 63 6f  able-name> . <co
5e30: 6c 75 6d 6e 2d 6e 61 6d 65 3e 20 7c 0a 3c 6c 69  lumn-name> |.<li
5e40: 74 65 72 61 6c 2d 76 61 6c 75 65 3e 20 7c 0a 3c  teral-value> |.<
5e50: 66 75 6e 63 74 69 6f 6e 2d 6e 61 6d 65 3e 20 28  function-name> (
5e60: 20 3c 65 78 70 72 2d 6c 69 73 74 3e 20 7c 20 53   <expr-list> | S
5e70: 54 41 52 20 29 20 7c 0a 3c 65 78 70 72 3e 20 28  TAR ) |.<expr> (
5e80: 2b 29 20 7c 0a 3c 65 78 70 72 3e 20 49 53 4e 55  +) |.<expr> ISNU
5e90: 4c 4c 20 7c 0a 3c 65 78 70 72 3e 20 4e 4f 54 4e  LL |.<expr> NOTN
5ea0: 55 4c 4c 20 7c 0a 3c 65 78 70 72 3e 20 5b 4e 4f  ULL |.<expr> [NO
5eb0: 54 5d 20 42 45 54 57 45 45 4e 20 3c 65 78 70 72  T] BETWEEN <expr
5ec0: 3e 20 41 4e 44 20 3c 65 78 70 72 3e 20 7c 0a 3c  > AND <expr> |.<
5ed0: 65 78 70 72 3e 20 5b 4e 4f 54 5d 20 49 4e 20 28  expr> [NOT] IN (
5ee0: 20 3c 76 61 6c 75 65 2d 6c 69 73 74 3e 20 29 20   <value-list> ) 
5ef0: 7c 0a 3c 65 78 70 72 3e 20 5b 4e 4f 54 5d 20 49  |.<expr> [NOT] I
5f00: 4e 20 28 20 3c 73 65 6c 65 63 74 2d 73 74 61 74  N ( <select-stat
5f10: 65 6d 65 6e 74 3e 20 29 20 7c 0a 28 20 3c 73 65  ement> ) |.( <se
5f20: 6c 65 63 74 2d 73 74 61 74 65 6d 65 6e 74 3e 20  lect-statement> 
5f30: 29 20 7c 0a 43 41 53 45 20 5b 3c 65 78 70 72 3e  ) |.CASE [<expr>
5f40: 5d 20 28 20 57 48 45 4e 20 3c 65 78 70 72 3e 20  ] ( WHEN <expr> 
5f50: 54 48 45 4e 20 3c 65 78 70 72 3e 20 29 2b 20 5b  THEN <expr> )+ [
5f60: 45 4c 53 45 20 3c 65 78 70 72 3e 5d 20 45 4e 44  ELSE <expr>] END
5f70: 0a 7d 20 7b 6c 69 6b 65 2d 6f 70 7d 20 7b 0a 4c  .} {like-op} {.L
5f80: 49 4b 45 20 7c 20 47 4c 4f 42 20 7c 20 4e 4f 54  IKE | GLOB | NOT
5f90: 20 4c 49 4b 45 20 7c 20 4e 4f 54 20 47 4c 4f 42   LIKE | NOT GLOB
5fa0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
5fb0: 69 73 20 73 65 63 74 69 6f 6e 20 69 73 20 64 69  is section is di
5fc0: 66 66 65 72 65 6e 74 20 66 72 6f 6d 20 74 68 65  fferent from the
5fd0: 20 6f 74 68 65 72 73 2e 20 20 4d 6f 73 74 20 6f   others.  Most o
5fe0: 74 68 65 72 20 73 65 63 74 69 6f 6e 73 20 6f 66  ther sections of
5ff0: 0a 74 68 69 73 20 64 6f 63 75 6d 65 6e 74 20 74  .this document t
6000: 61 6c 6b 73 20 61 62 6f 75 74 20 61 20 70 61 72  alks about a par
6010: 74 69 63 75 6c 61 72 20 53 51 4c 20 63 6f 6d 6d  ticular SQL comm
6020: 61 6e 64 2e 20 20 54 68 69 73 20 73 65 63 74 69  and.  This secti
6030: 6f 6e 20 64 6f 65 73 0a 6e 6f 74 20 74 61 6c 6b  on does.not talk
6040: 20 61 62 6f 75 74 20 61 20 73 74 61 6e 64 61 6c   about a standal
6050: 6f 6e 65 20 63 6f 6d 6d 61 6e 64 20 62 75 74 20  one command but 
6060: 61 62 6f 75 74 20 22 65 78 70 72 65 73 73 69 6f  about "expressio
6070: 6e 73 22 20 77 68 69 63 68 20 61 72 65 20 0a 73  ns" which are .s
6080: 75 62 63 6f 6d 70 6f 6e 65 6e 74 20 6f 66 20 6d  ubcomponent of m
6090: 6f 73 74 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e  ost other comman
60a0: 64 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 53 51 4c 69  ds.</p>..<p>SQLi
60b0: 74 65 20 75 6e 64 65 72 73 74 61 6e 64 73 20 74  te understands t
60c0: 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20 62 69 6e  he following bin
60d0: 61 72 79 20 6f 70 65 72 61 74 6f 72 73 2c 20 69  ary operators, i
60e0: 6e 20 6f 72 64 65 72 20 66 72 6f 6d 0a 68 69 67  n order from.hig
60f0: 68 65 73 74 20 74 6f 20 6c 6f 77 65 73 74 20 70  hest to lowest p
6100: 72 65 63 65 64 65 6e 63 65 3a 3c 2f 70 3e 0a 0a  recedence:</p>..
6110: 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72 65  <blockquote><pre
6120: 3e 0a 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23  >.<font color="#
6130: 32 63 32 63 66 30 22 3e 3c 62 69 67 3e 7c 7c 0a  2c2cf0"><big>||.
6140: 2a 20 20 20 20 2f 20 20 20 20 25 0a 2b 20 20 20  *    /    %.+   
6150: 20 2d 0a 26 6c 74 3b 26 6c 74 3b 20 20 20 26 67   -.&lt;&lt;   &g
6160: 74 3b 26 67 74 3b 20 20 20 26 61 6d 70 3b 20 20  t;&gt;   &amp;  
6170: 20 20 7c 0a 26 6c 74 3b 20 20 20 20 26 6c 74 3b    |.&lt;    &lt;
6180: 3d 20 20 20 26 67 74 3b 20 20 20 20 26 67 74 3b  =   &gt;    &gt;
6190: 3d 0a 3d 20 20 20 20 3d 3d 20 20 20 21 3d 20 20  =.=    ==   !=  
61a0: 20 26 6c 74 3b 26 67 74 3b 20 20 20 3c 2f 62 69   &lt;&gt;   </bi
61b0: 67 3e 49 4e 0a 41 4e 44 20 20 20 0a 4f 52 3c 2f  g>IN.AND   .OR</
61c0: 66 6f 6e 74 3e 0a 3c 2f 70 72 65 3e 3c 2f 62 6c  font>.</pre></bl
61d0: 6f 63 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 53 75  ockquote>..<p>Su
61e0: 70 70 6f 72 74 65 64 20 75 6e 61 72 79 20 6f 70  pported unary op
61f0: 65 72 61 74 65 72 73 20 61 72 65 20 74 68 65 73  eraters are thes
6200: 65 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75  e:</p>..<blockqu
6210: 6f 74 65 3e 3c 70 72 65 3e 0a 3c 66 6f 6e 74 20  ote><pre>.<font 
6220: 63 6f 6c 6f 72 3d 22 23 32 63 32 63 66 30 22 3e  color="#2c2cf0">
6230: 3c 62 69 67 3e 2d 20 20 20 20 2b 20 20 20 20 21  <big>-    +    !
6240: 20 20 20 20 7e 3c 2f 62 69 67 3e 3c 2f 66 6f 6e      ~</big></fon
6250: 74 3e 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b  t>.</pre></block
6260: 71 75 6f 74 65 3e 0a 0a 3c 70 3e 41 6e 79 20 53  quote>..<p>Any S
6270: 51 4c 69 74 65 20 76 61 6c 75 65 20 63 61 6e 20  QLite value can 
6280: 62 65 20 75 73 65 64 20 61 73 20 70 61 72 74 20  be used as part 
6290: 6f 66 20 61 6e 20 65 78 70 72 65 73 73 69 6f 6e  of an expression
62a0: 2e 20 20 0a 46 6f 72 20 61 72 69 74 68 6d 65 74  .  .For arithmet
62b0: 69 63 20 6f 70 65 72 61 74 69 6f 6e 73 2c 20 69  ic operations, i
62c0: 6e 74 65 67 65 72 73 20 61 72 65 20 74 72 65 61  ntegers are trea
62d0: 74 65 64 20 61 73 20 69 6e 74 65 67 65 72 73 2e  ted as integers.
62e0: 0a 53 74 72 69 6e 67 73 20 61 72 65 20 66 69 72  .Strings are fir
62f0: 73 74 20 63 6f 6e 76 65 72 74 65 64 20 74 6f 20  st converted to 
6300: 72 65 61 6c 20 6e 75 6d 62 65 72 73 20 75 73 69  real numbers usi
6310: 6e 67 20 3c 62 3e 61 74 6f 66 28 29 3c 2f 62 3e  ng <b>atof()</b>
6320: 2e 0a 46 6f 72 20 63 6f 6d 70 61 72 69 73 6f 6e  ..For comparison
6330: 20 6f 70 65 72 61 74 6f 72 73 2c 20 6e 75 6d 62   operators, numb
6340: 65 72 73 20 63 6f 6d 70 61 72 65 20 61 73 20 6e  ers compare as n
6350: 75 6d 62 65 72 73 20 61 6e 64 20 73 74 72 69 6e  umbers and strin
6360: 67 73 0a 63 6f 6d 70 61 72 65 20 75 73 69 6e 67  gs.compare using
6370: 20 74 68 65 20 3c 62 3e 73 74 72 63 6d 70 28 29   the <b>strcmp()
6380: 3c 2f 62 3e 20 66 75 6e 63 74 69 6f 6e 2e 0a 4e  </b> function..N
6390: 6f 74 65 20 74 68 61 74 20 74 68 65 72 65 20 61  ote that there a
63a0: 72 65 20 74 77 6f 20 76 61 72 69 61 74 69 6f 6e  re two variation
63b0: 73 20 6f 66 20 74 68 65 20 65 71 75 61 6c 73 20  s of the equals 
63c0: 61 6e 64 20 6e 6f 74 20 65 71 75 61 6c 73 0a 6f  and not equals.o
63d0: 70 65 72 61 74 6f 72 73 2e 20 20 45 71 75 61 6c  perators.  Equal
63e0: 73 20 63 61 6e 20 62 65 20 65 69 74 68 65 72 7d  s can be either}
63f0: 0a 70 75 74 73 20 22 5b 4f 70 65 72 61 74 6f 72  .puts "[Operator
6400: 20 3d 5d 20 6f 72 20 5b 4f 70 65 72 61 74 6f 72   =] or [Operator
6410: 20 3d 3d 5d 2e 0a 54 68 65 20 6e 6f 6e 2d 65 71   ==]..The non-eq
6420: 75 61 6c 73 20 6f 70 65 72 61 74 6f 72 20 63 61  uals operator ca
6430: 6e 20 62 65 20 65 69 74 68 65 72 0a 5b 4f 70 65  n be either.[Ope
6440: 72 61 74 6f 72 20 21 3d 5d 20 6f 72 20 5b 4f 70  rator !=] or [Op
6450: 65 72 61 74 6f 72 20 7b 26 6c 74 3b 26 67 74 3b  erator {&lt;&gt;
6460: 7d 5d 2e 0a 54 68 65 20 5b 4f 70 65 72 61 74 6f  }]..The [Operato
6470: 72 20 7c 7c 5d 20 6f 70 65 72 61 74 6f 72 20 69  r ||] operator i
6480: 73 20 5c 22 63 6f 6e 63 61 74 65 6e 61 74 65 5c  s \"concatenate\
6490: 22 20 2d 20 69 74 20 6a 6f 69 6e 73 20 74 6f 67  " - it joins tog
64a0: 65 74 68 65 72 0a 74 68 65 20 74 77 6f 20 73 74  ether.the two st
64b0: 72 69 6e 67 73 20 6f 66 20 69 74 73 20 6f 70 65  rings of its ope
64c0: 72 61 6e 64 73 2e 0a 54 68 65 20 6f 70 65 72 61  rands..The opera
64d0: 74 6f 72 20 5b 4f 70 65 72 61 74 6f 72 20 25 5d  tor [Operator %]
64e0: 20 6f 75 74 70 75 74 73 20 74 68 65 20 72 65 6d   outputs the rem
64f0: 61 69 6e 64 65 72 20 6f 66 20 69 74 73 20 6c 65  ainder of its le
6500: 66 74 20 0a 6f 70 65 72 61 6e 64 20 6d 6f 64 75  ft .operand modu
6510: 6c 6f 20 69 74 73 20 72 69 67 68 74 20 6f 70 65  lo its right ope
6520: 72 61 6e 64 2e 3c 2f 70 3e 22 0a 70 75 74 73 20  rand.</p>".puts 
6530: 7b 0a 0a 3c 70 3e 54 68 65 20 4c 49 4b 45 20 6f  {..<p>The LIKE o
6540: 70 65 72 61 74 6f 72 20 64 6f 65 73 20 61 20 77  perator does a w
6550: 69 6c 64 63 61 72 64 20 63 6f 6d 70 61 72 69 73  ildcard comparis
6560: 69 6f 6e 2e 20 20 54 68 65 20 6f 70 65 72 61 6e  ion.  The operan
6570: 64 0a 74 6f 20 74 68 65 20 72 69 67 68 74 20 63  d.to the right c
6580: 6f 6e 74 61 69 6e 73 20 74 68 65 20 77 69 6c 64  ontains the wild
6590: 63 61 72 64 73 2e 7d 0a 70 75 74 73 20 22 41 20  cards.}.puts "A 
65a0: 70 65 72 63 65 6e 74 20 73 79 6d 62 6f 6c 20 5b  percent symbol [
65b0: 4f 70 65 72 61 74 6f 72 20 25 5d 20 69 6e 20 74  Operator %] in t
65c0: 68 65 20 72 69 67 68 74 20 6f 70 65 72 61 6e 64  he right operand
65d0: 0a 6d 61 74 63 68 65 73 20 61 6e 79 20 73 65 71  .matches any seq
65e0: 75 65 6e 63 65 20 6f 66 20 7a 65 72 6f 20 6f 72  uence of zero or
65f0: 20 6d 6f 72 65 20 63 68 61 72 61 63 74 65 72 73   more characters
6600: 20 6f 6e 20 74 68 65 20 6c 65 66 74 2e 0a 41 6e   on the left..An
6610: 20 75 6e 64 65 72 73 63 6f 72 65 20 5b 4f 70 65   underscore [Ope
6620: 72 61 74 6f 72 20 5f 5d 20 6f 6e 20 74 68 65 20  rator _] on the 
6630: 72 69 67 68 74 0a 6d 61 74 63 68 65 73 20 61 6e  right.matches an
6640: 79 20 73 69 6e 67 6c 65 20 63 68 61 72 61 63 74  y single charact
6650: 65 72 20 6f 6e 20 74 68 65 20 6c 65 66 74 2e 22  er on the left."
6660: 0a 70 75 74 73 20 7b 54 68 65 20 4c 49 4b 45 20  .puts {The LIKE 
6670: 6f 70 65 72 61 74 6f 72 20 69 73 0a 6e 6f 74 20  operator is.not 
6680: 63 61 73 65 20 73 65 6e 73 69 74 69 76 65 20 61  case sensitive a
6690: 6e 64 20 77 69 6c 6c 20 6d 61 74 63 68 20 75 70  nd will match up
66a0: 70 65 72 20 63 61 73 65 20 63 68 61 72 61 63 74  per case charact
66b0: 65 72 73 20 6f 6e 20 6f 6e 65 0a 73 69 64 65 20  ers on one.side 
66c0: 61 67 61 69 6e 73 74 20 6c 6f 77 65 72 20 63 61  against lower ca
66d0: 73 65 20 63 68 61 72 61 63 74 65 72 73 20 6f 6e  se characters on
66e0: 20 74 68 65 20 6f 74 68 65 72 2e 0a 28 41 20 62   the other..(A b
66f0: 75 67 3a 20 53 51 4c 69 74 65 20 6f 6e 6c 79 20  ug: SQLite only 
6700: 75 6e 64 65 72 73 74 61 6e 64 73 20 75 70 70 65  understands uppe
6710: 72 2f 6c 6f 77 65 72 20 63 61 73 65 20 66 6f 72  r/lower case for
6720: 20 37 2d 62 69 74 20 4c 61 74 69 6e 0a 63 68 61   7-bit Latin.cha
6730: 72 61 63 74 65 72 73 2e 20 20 48 65 6e 63 65 20  racters.  Hence 
6740: 74 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f  the LIKE operato
6750: 72 20 69 73 20 63 61 73 65 20 73 65 6e 73 69 74  r is case sensit
6760: 69 76 65 20 66 6f 72 0a 38 2d 62 69 74 20 69 73  ive for.8-bit is
6770: 6f 38 38 35 39 20 63 68 61 72 61 63 74 65 72 73  o8859 characters
6780: 20 6f 72 20 55 54 46 2d 38 20 63 68 61 72 61 63   or UTF-8 charac
6790: 74 65 72 73 2e 20 20 46 6f 72 20 65 78 61 6d 70  ters.  For examp
67a0: 6c 65 2c 0a 74 68 65 20 65 78 70 72 65 73 73 69  le,.the expressi
67b0: 6f 6e 20 3c 62 3e 27 61 27 26 6e 62 73 70 3b 4c  on <b>'a'&nbsp;L
67c0: 49 4b 45 26 6e 62 73 70 3b 27 41 27 3c 2f 62 3e  IKE&nbsp;'A'</b>
67d0: 20 69 73 20 54 52 55 45 20 62 75 74 0a 3c 62 3e   is TRUE but.<b>
67e0: 27 26 61 65 6c 69 67 3b 27 26 6e 62 73 70 3b 4c  '&aelig;'&nbsp;L
67f0: 49 4b 45 26 6e 62 73 70 3b 27 26 41 45 6c 69 67  IKE&nbsp;'&AElig
6800: 3b 27 3c 2f 62 3e 20 69 73 20 46 41 4c 53 45 2e  ;'</b> is FALSE.
6810: 29 0a 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47  ).</p>..<p>The G
6820: 4c 4f 42 20 6f 70 65 72 61 74 6f 72 20 69 73 20  LOB operator is 
6830: 73 69 6d 69 6c 61 72 20 74 6f 20 4c 49 4b 45 20  similar to LIKE 
6840: 62 75 74 20 75 73 65 73 20 74 68 65 20 55 6e 69  but uses the Uni
6850: 78 0a 66 69 6c 65 20 67 6c 6f 62 62 69 6e 67 20  x.file globbing 
6860: 73 79 6e 74 61 78 20 66 6f 72 20 69 74 73 20 77  syntax for its w
6870: 69 6c 64 63 61 72 64 73 2e 20 20 41 6c 73 6f 2c  ildcards.  Also,
6880: 20 47 4c 4f 42 20 69 73 20 63 61 73 65 0a 73 65   GLOB is case.se
6890: 6e 73 69 74 69 76 65 2c 20 75 6e 6c 69 6b 65 20  nsitive, unlike 
68a0: 4c 49 4b 45 2e 20 20 42 6f 74 68 20 47 4c 4f 42  LIKE.  Both GLOB
68b0: 20 61 6e 64 20 4c 49 4b 45 20 6d 61 79 20 62 65   and LIKE may be
68c0: 20 70 72 65 63 65 64 65 64 20 62 79 0a 74 68 65   preceded by.the
68d0: 20 4e 4f 54 20 6b 65 79 77 6f 72 64 20 74 6f 20   NOT keyword to 
68e0: 69 6e 76 65 72 74 20 74 68 65 20 73 65 6e 73 65  invert the sense
68f0: 20 6f 66 20 74 68 65 20 74 65 73 74 2e 3c 2f 70   of the test.</p
6900: 3e 0a 0a 3c 70 3e 41 20 63 6f 6c 75 6d 6e 20 6e  >..<p>A column n
6910: 61 6d 65 20 63 61 6e 20 62 65 20 61 6e 79 20 6f  ame can be any o
6920: 66 20 74 68 65 20 6e 61 6d 65 73 20 64 65 66 69  f the names defi
6930: 6e 65 64 20 69 6e 20 74 68 65 20 43 52 45 41 54  ned in the CREAT
6940: 45 20 54 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e  E TABLE.statemen
6950: 74 20 6f 72 20 6f 6e 65 20 6f 66 20 74 68 65 20  t or one of the 
6960: 66 6f 6c 6c 6f 77 69 6e 67 20 73 70 65 63 69 61  following specia
6970: 6c 20 69 64 65 6e 74 69 66 69 65 72 73 3a 20 22  l identifiers: "
6980: 3c 62 3e 52 4f 57 49 44 3c 2f 62 3e 22 2c 0a 22  <b>ROWID</b>",."
6990: 3c 62 3e 4f 49 44 3c 2f 62 3e 22 2c 20 6f 72 20  <b>OID</b>", or 
69a0: 22 3c 62 3e 5f 52 4f 57 49 44 5f 3c 2f 62 3e 22  "<b>_ROWID_</b>"
69b0: 2e 0a 54 68 65 73 65 20 73 70 65 63 69 61 6c 20  ..These special 
69c0: 69 64 65 6e 74 69 66 69 65 72 73 20 61 6c 6c 20  identifiers all 
69d0: 64 65 73 63 72 69 62 65 20 74 68 65 0a 75 6e 69  describe the.uni
69e0: 71 75 65 20 72 61 6e 64 6f 6d 20 69 6e 74 65 67  que random integ
69f0: 65 72 20 6b 65 79 20 28 74 68 65 20 22 72 6f 77  er key (the "row
6a00: 20 6b 65 79 22 29 20 61 73 73 6f 63 69 61 74 65   key") associate
6a10: 64 20 77 69 74 68 20 65 76 65 72 79 20 0a 72 6f  d with every .ro
6a20: 77 20 6f 66 20 65 76 65 72 79 20 74 61 62 6c 65  w of every table
6a30: 2e 0a 54 68 65 20 73 70 65 63 69 61 6c 20 69 64  ..The special id
6a40: 65 6e 74 69 66 69 65 72 73 20 6f 6e 6c 79 20 72  entifiers only r
6a50: 65 66 65 72 20 74 6f 20 74 68 65 20 72 6f 77 20  efer to the row 
6a60: 6b 65 79 20 69 66 20 74 68 65 20 43 52 45 41 54  key if the CREAT
6a70: 45 20 54 41 42 4c 45 0a 73 74 61 74 65 6d 65 6e  E TABLE.statemen
6a80: 74 20 64 6f 65 73 20 6e 6f 74 20 64 65 66 69 6e  t does not defin
6a90: 65 20 61 20 72 65 61 6c 20 63 6f 6c 75 6d 6e 20  e a real column 
6aa0: 77 69 74 68 20 74 68 65 20 73 61 6d 65 20 6e 61  with the same na
6ab0: 6d 65 2e 20 20 52 6f 77 20 6b 65 79 73 0a 61 63  me.  Row keys.ac
6ac0: 74 20 6c 69 6b 65 20 72 65 61 64 2d 6f 6e 6c 79  t like read-only
6ad0: 20 63 6f 6c 75 6d 6e 73 2e 20 20 41 20 72 6f 77   columns.  A row
6ae0: 20 6b 65 79 20 63 61 6e 20 62 65 20 75 73 65 64   key can be used
6af0: 20 61 6e 79 77 68 65 72 65 20 61 20 72 65 67 75   anywhere a regu
6b00: 6c 61 72 0a 63 6f 6c 75 6d 6e 20 63 61 6e 20 62  lar.column can b
6b10: 65 20 75 73 65 64 2c 20 65 78 63 65 70 74 20 74  e used, except t
6b20: 68 61 74 20 79 6f 75 20 63 61 6e 6e 6f 74 20 63  hat you cannot c
6b30: 68 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 0a  hange the value.
6b40: 6f 66 20 61 20 72 6f 77 20 6b 65 79 20 69 6e 20  of a row key in 
6b50: 61 6e 20 55 50 44 41 54 45 20 6f 72 20 49 4e 53  an UPDATE or INS
6b60: 45 52 54 20 73 74 61 74 65 6d 65 6e 74 2e 0a 22  ERT statement.."
6b70: 53 45 4c 45 43 54 20 2a 20 2e 2e 2e 22 20 64 6f  SELECT * ..." do
6b80: 65 73 20 6e 6f 74 20 72 65 74 75 72 6e 20 74 68  es not return th
6b90: 65 20 72 6f 77 20 6b 65 79 2e 3c 2f 70 3e 0a 0a  e row key.</p>..
6ba0: 3c 70 3e 53 51 4c 69 74 65 20 73 75 70 70 6f 72  <p>SQLite suppor
6bb0: 74 73 20 61 20 6d 69 6e 69 6d 61 6c 20 4f 72 61  ts a minimal Ora
6bc0: 63 6c 65 38 20 6f 75 74 65 72 20 6a 6f 69 6e 20  cle8 outer join 
6bd0: 62 65 68 61 76 69 6f 72 2e 20 41 20 63 6f 6c 75  behavior. A colu
6be0: 6d 6e 20 0a 65 78 70 72 65 73 73 69 6f 6e 20 6f  mn .expression o
6bf0: 66 20 74 68 65 20 66 6f 72 6d 20 22 63 6f 6c 75  f the form "colu
6c00: 6d 6e 22 20 6f 72 20 22 74 61 62 6c 65 2e 63 6f  mn" or "table.co
6c10: 6c 75 6d 6e 22 20 63 61 6e 20 62 65 20 66 6f 6c  lumn" can be fol
6c20: 6c 6f 77 65 64 20 62 79 20 0a 74 68 65 20 73 70  lowed by .the sp
6c30: 65 63 69 61 6c 20 22 3c 62 3e 28 2b 29 3c 2f 62  ecial "<b>(+)</b
6c40: 3e 22 20 6f 70 65 72 61 74 6f 72 2e 20 20 49 66  >" operator.  If
6c50: 20 74 68 65 20 74 61 62 6c 65 20 6f 66 20 74 68   the table of th
6c60: 65 20 63 6f 6c 75 6d 6e 20 65 78 70 72 65 73 73  e column express
6c70: 69 6f 6e 20 0a 69 73 20 74 68 65 20 73 65 63 6f  ion .is the seco
6c80: 6e 64 20 6f 72 20 73 75 62 73 65 71 75 65 6e 74  nd or subsequent
6c90: 20 74 61 62 6c 65 20 69 6e 20 61 20 6a 6f 69 6e   table in a join
6ca0: 2c 20 74 68 65 6e 20 74 68 61 74 20 74 61 62 6c  , then that tabl
6cb0: 65 20 62 65 63 6f 6d 65 73 20 0a 74 68 65 20 6c  e becomes .the l
6cc0: 65 66 74 20 74 61 62 6c 65 20 69 6e 20 61 20 4c  eft table in a L
6cd0: 45 46 54 20 4f 55 54 45 52 20 4a 4f 49 4e 2e 20  EFT OUTER JOIN. 
6ce0: 20 54 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20   The expression 
6cf0: 74 68 61 74 20 75 73 65 73 20 74 68 61 74 20 0a  that uses that .
6d00: 74 61 62 6c 65 20 62 65 63 6f 6d 65 73 20 70 61  table becomes pa
6d10: 72 74 20 6f 66 20 74 68 65 20 4f 4e 20 63 6c 61  rt of the ON cla
6d20: 75 73 65 20 66 6f 72 20 74 68 65 20 6a 6f 69 6e  use for the join
6d30: 2e 0a 54 68 65 20 65 78 61 63 74 20 4f 72 61 63  ..The exact Orac
6d40: 6c 65 38 20 62 65 68 61 76 69 6f 72 20 69 73 20  le8 behavior is 
6d50: 6e 6f 74 20 69 6d 70 6c 65 6d 65 6e 74 65 64 2c  not implemented,
6d60: 20 62 75 74 20 69 74 20 69 73 20 70 6f 73 73 69   but it is possi
6d70: 62 6c 65 20 74 6f 20 0a 63 6f 6e 73 74 72 75 63  ble to .construc
6d80: 74 20 71 75 65 72 69 65 73 20 74 68 61 74 20 77  t queries that w
6d90: 69 6c 6c 20 77 6f 72 6b 20 63 6f 72 72 65 63 74  ill work correct
6da0: 6c 79 20 66 6f 72 20 62 6f 74 68 20 53 51 4c 69  ly for both SQLi
6db0: 74 65 20 61 6e 64 20 4f 72 61 63 6c 65 38 2e 3c  te and Oracle8.<
6dc0: 2f 70 3e 0a 0a 3c 70 3e 53 45 4c 45 43 54 20 73  /p>..<p>SELECT s
6dd0: 74 61 74 65 6d 65 6e 74 73 20 63 61 6e 20 61 70  tatements can ap
6de0: 70 65 61 72 20 69 6e 20 65 78 70 72 65 73 73 69  pear in expressi
6df0: 6f 6e 73 20 61 73 20 65 69 74 68 65 72 20 74 68  ons as either th
6e00: 65 0a 72 69 67 68 74 2d 68 61 6e 64 20 6f 70 65  e.right-hand ope
6e10: 72 61 6e 64 20 6f 66 20 74 68 65 20 49 4e 20 6f  rand of the IN o
6e20: 70 65 72 61 74 6f 72 20 6f 72 20 61 73 20 61 20  perator or as a 
6e30: 73 63 61 6c 61 72 20 71 75 61 6e 74 69 74 79 2e  scalar quantity.
6e40: 0a 49 6e 20 62 6f 74 68 20 63 61 73 65 73 2c 20  .In both cases, 
6e50: 74 68 65 20 53 45 4c 45 43 54 20 73 68 6f 75 6c  the SELECT shoul
6e60: 64 20 68 61 76 65 20 6f 6e 6c 79 20 61 20 73 69  d have only a si
6e70: 6e 67 6c 65 20 63 6f 6c 75 6d 6e 20 69 6e 20 69  ngle column in i
6e80: 74 73 0a 72 65 73 75 6c 74 2e 20 20 43 6f 6d 70  ts.result.  Comp
6e90: 6f 75 6e 64 20 53 45 4c 45 43 54 73 20 28 63 6f  ound SELECTs (co
6ea0: 6e 6e 65 63 74 65 64 20 77 69 74 68 20 6b 65 79  nnected with key
6eb0: 77 6f 72 64 73 20 6c 69 6b 65 20 55 4e 49 4f 4e  words like UNION
6ec0: 20 6f 72 0a 45 58 43 45 50 54 29 20 61 72 65 20   or.EXCEPT) are 
6ed0: 61 6c 6c 6f 77 65 64 2e 0a 41 20 53 45 4c 45 43  allowed..A SELEC
6ee0: 54 20 69 6e 20 61 6e 20 65 78 70 72 65 73 73 69  T in an expressi
6ef0: 6f 6e 20 69 73 20 65 76 61 6c 75 61 74 65 64 20  on is evaluated 
6f00: 6f 6e 63 65 20 62 65 66 6f 72 65 20 61 6e 79 20  once before any 
6f10: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 69 6e 67  other processing
6f20: 0a 69 73 20 70 65 72 66 6f 72 6d 65 64 2c 20 73  .is performed, s
6f30: 6f 20 6e 6f 6e 65 20 6f 66 20 74 68 65 20 65 78  o none of the ex
6f40: 70 72 65 73 73 69 6f 6e 73 20 77 69 74 68 69 6e  pressions within
6f50: 20 74 68 65 20 73 65 6c 65 63 74 20 69 74 73 65   the select itse
6f60: 6c 66 20 63 61 6e 0a 72 65 66 65 72 20 74 6f 20  lf can.refer to 
6f70: 71 75 61 6e 74 69 74 69 65 73 20 69 6e 20 74 68  quantities in th
6f80: 65 20 63 6f 6e 74 61 69 6e 69 6e 67 20 65 78 70  e containing exp
6f90: 72 65 73 73 69 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 70  ression.</p>..<p
6fa0: 3e 57 68 65 6e 20 61 20 53 45 4c 45 43 54 20 69  >When a SELECT i
6fb0: 73 20 74 68 65 20 72 69 67 68 74 20 6f 70 65 72  s the right oper
6fc0: 61 6e 64 20 6f 66 20 74 68 65 20 49 4e 20 6f 70  and of the IN op
6fd0: 65 72 61 74 6f 72 2c 20 74 68 65 20 49 4e 0a 6f  erator, the IN.o
6fe0: 70 65 72 61 74 6f 72 20 72 65 74 75 72 6e 73 20  perator returns 
6ff0: 54 52 55 45 20 69 66 20 74 68 65 20 72 65 73 75  TRUE if the resu
7000: 6c 74 20 6f 66 20 74 68 65 20 6c 65 66 74 20 6f  lt of the left o
7010: 70 65 72 61 6e 64 20 69 73 20 61 6e 79 20 6f 66  perand is any of
7020: 0a 74 68 65 20 76 61 6c 75 65 73 20 67 65 6e 65  .the values gene
7030: 72 61 74 65 64 20 62 79 20 74 68 65 20 73 65 6c  rated by the sel
7040: 65 63 74 2e 20 20 54 68 65 20 49 4e 20 6f 70 65  ect.  The IN ope
7050: 72 61 74 6f 72 20 6d 61 79 20 62 65 20 70 72 65  rator may be pre
7060: 63 65 64 65 64 0a 62 79 20 74 68 65 20 4e 4f 54  ceded.by the NOT
7070: 20 6b 65 79 77 6f 72 64 20 74 6f 20 69 6e 76 65   keyword to inve
7080: 72 74 20 74 68 65 20 73 65 6e 73 65 20 6f 66 20  rt the sense of 
7090: 74 68 65 20 74 65 73 74 2e 3c 2f 70 3e 0a 0a 3c  the test.</p>..<
70a0: 70 3e 57 68 65 6e 20 61 20 53 45 4c 45 43 54 20  p>When a SELECT 
70b0: 61 70 70 65 61 72 73 20 77 69 74 68 69 6e 20 61  appears within a
70c0: 6e 20 65 78 70 72 65 73 73 69 6f 6e 20 62 75 74  n expression but
70d0: 20 69 73 20 6e 6f 74 20 74 68 65 20 72 69 67 68   is not the righ
70e0: 74 0a 6f 70 65 72 61 6e 64 20 6f 66 20 61 6e 20  t.operand of an 
70f0: 49 4e 20 6f 70 65 72 61 74 6f 72 2c 20 74 68 65  IN operator, the
7100: 6e 20 74 68 65 20 66 69 72 73 74 20 72 6f 77 20  n the first row 
7110: 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20 6f 66  of the result of
7120: 20 74 68 65 0a 53 45 4c 45 43 54 20 62 65 63 6f   the.SELECT beco
7130: 6d 65 73 20 74 68 65 20 76 61 6c 75 65 20 75 73  mes the value us
7140: 65 64 20 69 6e 20 74 68 65 20 65 78 70 72 65 73  ed in the expres
7150: 73 69 6f 6e 2e 20 20 49 66 20 74 68 65 20 53 45  sion.  If the SE
7160: 4c 45 43 54 20 79 69 65 6c 64 73 0a 6d 6f 72 65  LECT yields.more
7170: 20 74 68 61 6e 20 6f 6e 65 20 72 65 73 75 6c 74   than one result
7180: 20 72 6f 77 2c 20 61 6c 6c 20 72 6f 77 73 20 61   row, all rows a
7190: 66 74 65 72 20 74 68 65 20 66 69 72 73 74 20 61  fter the first a
71a0: 72 65 20 69 67 6e 6f 72 65 64 2e 20 20 49 66 0a  re ignored.  If.
71b0: 74 68 65 20 53 45 4c 45 43 54 20 79 65 69 6c 64  the SELECT yeild
71c0: 73 20 6e 6f 20 72 6f 77 73 2c 20 74 68 65 6e 20  s no rows, then 
71d0: 74 68 65 20 76 61 6c 75 65 20 6f 66 20 74 68 65  the value of the
71e0: 20 53 45 4c 45 43 54 20 69 73 20 4e 55 4c 4c 2e   SELECT is NULL.
71f0: 3c 2f 70 3e 0a 0a 3c 70 3e 42 6f 74 68 20 73 69  </p>..<p>Both si
7200: 6d 70 6c 65 20 61 6e 64 20 61 67 67 72 65 67 61  mple and aggrega
7210: 74 65 20 66 75 6e 63 74 69 6f 6e 73 20 61 72 65  te functions are
7220: 20 73 75 70 70 6f 72 74 65 64 2e 20 20 41 20 73   supported.  A s
7230: 69 6d 70 6c 65 0a 66 75 6e 63 74 69 6f 6e 20 63  imple.function c
7240: 61 6e 20 62 65 20 75 73 65 64 20 69 6e 20 61 6e  an be used in an
7250: 79 20 65 78 70 72 65 73 73 69 6f 6e 2e 20 20 53  y expression.  S
7260: 69 6d 70 6c 65 20 66 75 6e 63 74 69 6f 6e 73 20  imple functions 
7270: 72 65 74 75 72 6e 0a 61 20 72 65 73 75 6c 74 20  return.a result 
7280: 69 6d 6d 65 64 69 61 74 65 6c 79 20 62 61 73 65  immediately base
7290: 64 20 6f 6e 20 74 68 65 69 72 20 69 6e 70 75 74  d on their input
72a0: 73 2e 20 20 41 67 67 72 65 67 61 74 65 20 66 75  s.  Aggregate fu
72b0: 6e 63 74 69 6f 6e 73 0a 6d 61 79 20 6f 6e 6c 79  nctions.may only
72c0: 20 62 65 20 75 73 65 64 20 69 6e 20 61 20 53 45   be used in a SE
72d0: 4c 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 20  LECT statement. 
72e0: 20 41 67 67 72 65 67 61 74 65 20 66 75 6e 63 74   Aggregate funct
72f0: 69 6f 6e 73 20 63 6f 6d 70 75 74 65 0a 74 68 65  ions compute.the
7300: 69 72 20 72 65 73 75 6c 74 20 61 63 72 6f 73 73  ir result across
7310: 20 61 6c 6c 20 72 6f 77 73 20 6f 66 20 74 68 65   all rows of the
7320: 20 72 65 73 75 6c 74 20 73 65 74 2e 3c 2f 70 3e   result set.</p>
7330: 0a 0a 3c 70 3e 54 68 65 20 66 75 6e 63 74 69 6f  ..<p>The functio
7340: 6e 73 20 73 68 6f 77 6e 20 62 65 6c 6f 77 20 61  ns shown below a
7350: 72 65 20 61 76 61 69 6c 61 62 6c 65 20 62 79 20  re available by 
7360: 64 65 66 61 75 6c 74 2e 20 20 41 64 64 69 74 69  default.  Additi
7370: 6f 6e 61 6c 0a 66 75 6e 63 74 69 6f 6e 73 20 6d  onal.functions m
7380: 61 79 20 62 65 20 77 72 69 74 74 65 6e 20 69 6e  ay be written in
7390: 20 43 20 61 6e 64 20 61 64 64 65 64 20 74 6f 20   C and added to 
73a0: 74 68 65 20 64 61 74 61 62 61 73 65 20 65 6e 67  the database eng
73b0: 69 6e 65 20 75 73 69 6e 67 0a 74 68 65 20 3c 61  ine using.the <a
73c0: 20 68 72 65 66 3d 22 63 5f 69 6e 74 65 72 66 61   href="c_interfa
73d0: 63 65 2e 68 74 6d 6c 23 63 66 75 6e 63 22 3e 73  ce.html#cfunc">s
73e0: 71 6c 69 74 65 5f 63 72 65 61 74 65 5f 66 75 6e  qlite_create_fun
73f0: 63 74 69 6f 6e 28 29 3c 2f 61 3e 0a 41 50 49 2e  ction()</a>.API.
7400: 3c 2f 70 3e 0a 0a 3c 74 61 62 6c 65 20 62 6f 72  </p>..<table bor
7410: 64 65 72 3d 30 20 63 65 6c 6c 70 61 64 64 69 6e  der=0 cellpaddin
7420: 67 3d 31 30 3e 0a 3c 74 72 3e 0a 3c 74 64 20 76  g=10>.<tr>.<td v
7430: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67  align="top" alig
7440: 6e 3d 22 72 69 67 68 74 22 20 77 69 64 74 68 3d  n="right" width=
7450: 31 32 30 3e 61 62 73 28 3c 69 3e 58 3c 2f 69 3e  120>abs(<i>X</i>
7460: 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67  )</td>.<td valig
7470: 6e 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74  n="top">Return t
7480: 68 65 20 61 62 73 6f 6c 75 74 65 20 76 61 6c 75  he absolute valu
7490: 65 20 6f 66 20 61 72 67 75 6d 65 6e 74 20 3c 69  e of argument <i
74a0: 3e 58 3c 2f 69 3e 2e 3c 2f 74 64 3e 0a 3c 2f 74  >X</i>.</td>.</t
74b0: 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c  r>..<tr>.<td val
74c0: 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d  ign="top" align=
74d0: 22 72 69 67 68 74 22 3e 63 6f 61 6c 65 73 63 65  "right">coalesce
74e0: 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c 2f  (<i>X</i>,<i>Y</
74f0: 69 3e 2c 2e 2e 2e 29 3c 2f 74 64 3e 0a 3c 74 64  i>,...)</td>.<td
7500: 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65   valign="top">Re
7510: 74 75 72 6e 20 61 20 63 6f 70 79 20 6f 66 20 74  turn a copy of t
7520: 68 65 20 66 69 72 73 74 20 6e 6f 6e 2d 4e 55 4c  he first non-NUL
7530: 4c 20 61 72 67 75 6d 65 6e 74 2e 20 20 49 66 0a  L argument.  If.
7540: 61 6c 6c 20 61 72 67 75 6d 65 6e 74 73 20 61 72  all arguments ar
7550: 65 20 4e 55 4c 4c 20 74 68 65 6e 20 4e 55 4c 4c  e NULL then NULL
7560: 20 69 73 20 72 65 74 75 72 6e 65 64 2e 3c 2f 74   is returned.</t
7570: 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c  d>.</tr>..<tr>.<
7580: 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20  td valign="top" 
7590: 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 67 6c  align="right">gl
75a0: 6f 62 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59  ob(<i>X</i>,<i>Y
75b0: 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20 76  </i>)</td>.<td v
75c0: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 54 68 69 73  align="top">This
75d0: 20 66 75 6e 63 74 69 6f 6e 20 69 73 20 75 73 65   function is use
75e0: 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e 74 20 74  d to implement t
75f0: 68 65 0a 22 3c 62 3e 59 20 47 4c 4f 42 20 58 3c  he."<b>Y GLOB X<
7600: 2f 62 3e 22 20 73 79 6e 74 61 78 20 6f 66 20 53  /b>" syntax of S
7610: 51 4c 69 74 65 2e 20 20 54 68 65 0a 3c 61 20 68  QLite.  The.<a h
7620: 72 65 66 3d 22 63 5f 69 6e 74 65 72 66 61 63 65  ref="c_interface
7630: 2e 68 74 6d 6c 23 63 66 75 6e 63 22 3e 73 71 6c  .html#cfunc">sql
7640: 69 74 65 5f 63 72 65 61 74 65 5f 66 75 6e 63 74  ite_create_funct
7650: 69 6f 6e 28 29 3c 2f 61 3e 20 0a 69 6e 74 65 72  ion()</a> .inter
7660: 66 61 63 65 20 63 61 6e 0a 62 65 20 75 73 65 64  face can.be used
7670: 20 74 6f 20 6f 76 65 72 72 69 64 65 20 74 68 69   to override thi
7680: 73 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 20 74  s function and t
7690: 68 65 72 65 62 79 20 63 68 61 6e 67 65 20 74 68  hereby change th
76a0: 65 20 6f 70 65 72 61 74 69 6f 6e 0a 6f 66 20 74  e operation.of t
76b0: 68 65 20 47 4c 4f 42 20 6f 70 65 72 61 74 6f 72  he GLOB operator
76c0: 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74  .</td>.</tr>..<t
76d0: 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  r>.<td valign="t
76e0: 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74  op" align="right
76f0: 22 3e 6c 61 73 74 5f 69 6e 73 65 72 74 5f 72 6f  ">last_insert_ro
7700: 77 69 64 28 29 3c 2f 74 64 3e 0a 3c 74 64 20 76  wid()</td>.<td v
7710: 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74 75  align="top">Retu
7720: 72 6e 20 74 68 65 20 52 4f 57 49 44 20 6f 66 20  rn the ROWID of 
7730: 74 68 65 20 6c 61 73 74 20 72 6f 77 20 69 6e 73  the last row ins
7740: 65 72 74 20 66 72 6f 6d 20 74 68 69 73 0a 63 6f  ert from this.co
7750: 6e 6e 65 63 74 69 6f 6e 20 74 6f 20 74 68 65 20  nnection to the 
7760: 64 61 74 61 62 61 73 65 2e 20 20 54 68 69 73 20  database.  This 
7770: 69 73 20 74 68 65 20 73 61 6d 65 20 76 61 6c 75  is the same valu
7780: 65 20 74 68 61 74 20 77 6f 75 6c 64 20 62 65 20  e that would be 
7790: 72 65 74 75 72 6e 65 64 0a 66 72 6f 6d 20 74 68  returned.from th
77a0: 65 20 3c 62 3e 73 71 6c 69 74 65 5f 6c 61 73 74  e <b>sqlite_last
77b0: 5f 69 6e 73 65 72 74 5f 72 6f 77 69 64 28 29 3c  _insert_rowid()<
77c0: 2f 62 3e 20 41 50 49 20 66 75 6e 63 74 69 6f 6e  /b> API function
77d0: 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74  .</td>.</tr>..<t
77e0: 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  r>.<td valign="t
77f0: 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74  op" align="right
7800: 22 3e 6c 65 6e 67 74 68 28 3c 69 3e 58 3c 2f 69  ">length(<i>X</i
7810: 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69  >)</td>.<td vali
7820: 67 6e 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20  gn="top">Return 
7830: 74 68 65 20 73 74 72 69 6e 67 20 6c 65 6e 67 74  the string lengt
7840: 68 20 6f 66 20 3c 69 3e 58 3c 2f 69 3e 20 69 6e  h of <i>X</i> in
7850: 20 63 68 61 72 61 63 74 65 72 73 2e 0a 49 66 20   characters..If 
7860: 53 51 4c 69 74 65 20 69 73 20 63 6f 6e 66 69 67  SQLite is config
7870: 75 72 65 64 20 74 6f 20 73 75 70 70 6f 72 74 20  ured to support 
7880: 55 54 46 2d 38 2c 20 74 68 65 6e 20 74 68 65 20  UTF-8, then the 
7890: 6e 75 6d 62 65 72 20 6f 66 20 55 54 46 2d 38 0a  number of UTF-8.
78a0: 63 68 61 72 61 63 74 65 72 73 20 69 73 20 72 65  characters is re
78b0: 74 75 72 6e 65 64 2c 20 6e 6f 74 20 74 68 65 20  turned, not the 
78c0: 6e 75 6d 62 65 72 20 6f 66 20 62 79 74 65 73 2e  number of bytes.
78d0: 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72  </td>.</tr>..<tr
78e0: 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f  >.<td valign="to
78f0: 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22  p" align="right"
7900: 3e 6c 69 6b 65 28 3c 69 3e 58 3c 2f 69 3e 2c 3c  >like(<i>X</i>,<
7910: 69 3e 59 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74  i>Y</i>)</td>.<t
7920: 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 54  d valign="top">T
7930: 68 69 73 20 66 75 6e 63 74 69 6f 6e 20 69 73 20  his function is 
7940: 75 73 65 64 20 74 6f 20 69 6d 70 6c 65 6d 65 6e  used to implemen
7950: 74 20 74 68 65 0a 22 3c 62 3e 59 20 4c 49 4b 45  t the."<b>Y LIKE
7960: 20 58 3c 2f 62 3e 22 20 73 79 6e 74 61 78 20 6f   X</b>" syntax o
7970: 66 20 53 51 4c 2e 20 20 54 68 65 0a 3c 61 20 68  f SQL.  The.<a h
7980: 72 65 66 3d 22 63 5f 69 6e 74 65 72 66 61 63 65  ref="c_interface
7990: 2e 68 74 6d 6c 23 63 66 75 6e 63 22 3e 73 71 6c  .html#cfunc">sql
79a0: 69 74 65 5f 63 72 65 61 74 65 5f 66 75 6e 63 74  ite_create_funct
79b0: 69 6f 6e 28 29 3c 2f 61 3e 20 0a 69 6e 74 65 72  ion()</a> .inter
79c0: 66 61 63 65 20 63 61 6e 0a 62 65 20 75 73 65 64  face can.be used
79d0: 20 74 6f 20 6f 76 65 72 72 69 64 65 20 74 68 69   to override thi
79e0: 73 20 66 75 6e 63 74 69 6f 6e 20 61 6e 64 20 74  s function and t
79f0: 68 65 72 65 62 79 20 63 68 61 6e 67 65 20 74 68  hereby change th
7a00: 65 20 6f 70 65 72 61 74 69 6f 6e 0a 6f 66 20 74  e operation.of t
7a10: 68 65 20 4c 49 4b 45 20 6f 70 65 72 61 74 6f 72  he LIKE operator
7a20: 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74  .</td>.</tr>..<t
7a30: 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  r>.<td valign="t
7a40: 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74  op" align="right
7a50: 22 3e 6c 6f 77 65 72 28 3c 69 3e 58 3c 2f 69 3e  ">lower(<i>X</i>
7a60: 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67  )</td>.<td valig
7a70: 6e 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 61  n="top">Return a
7a80: 20 63 6f 70 79 20 6f 66 20 73 74 72 69 6e 67 20   copy of string 
7a90: 3c 69 3e 58 3c 2f 69 3e 20 77 69 6c 6c 20 61 6c  <i>X</i> will al
7aa0: 6c 20 63 68 61 72 61 63 74 65 72 73 0a 63 6f 6e  l characters.con
7ab0: 76 65 72 74 65 64 20 74 6f 20 6c 6f 77 65 72 20  verted to lower 
7ac0: 63 61 73 65 2e 20 20 54 68 65 20 43 20 6c 69 62  case.  The C lib
7ad0: 72 61 72 79 20 3c 62 3e 74 6f 6c 6f 77 65 72 28  rary <b>tolower(
7ae0: 29 3c 2f 62 3e 20 72 6f 75 74 69 6e 65 20 69 73  )</b> routine is
7af0: 20 75 73 65 64 0a 66 6f 72 20 74 68 65 20 63 6f   used.for the co
7b00: 6e 76 65 72 73 69 6f 6e 2c 20 77 68 69 63 68 20  nversion, which 
7b10: 6d 65 61 6e 73 20 74 68 61 74 20 74 68 69 73 20  means that this 
7b20: 66 75 6e 63 74 69 6f 6e 20 6d 69 67 68 74 20 6e  function might n
7b30: 6f 74 0a 77 6f 72 6b 20 63 6f 72 72 65 63 74 6c  ot.work correctl
7b40: 79 20 6f 6e 20 55 54 46 2d 38 20 63 68 61 72 61  y on UTF-8 chara
7b50: 63 74 65 72 73 2e 3c 2f 74 64 3e 0a 3c 2f 74 72  cters.</td>.</tr
7b60: 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69  >..<tr>.<td vali
7b70: 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22  gn="top" align="
7b80: 72 69 67 68 74 22 3e 6d 61 78 28 3c 69 3e 58 3c  right">max(<i>X<
7b90: 2f 69 3e 2c 3c 69 3e 59 3c 2f 69 3e 2c 2e 2e 2e  /i>,<i>Y</i>,...
7ba0: 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67  )</td>.<td valig
7bb0: 6e 3d 22 74 6f 70 22 3e 52 65 74 75 72 6e 20 74  n="top">Return t
7bc0: 68 65 20 61 72 67 75 6d 65 6e 74 20 77 69 74 68  he argument with
7bd0: 20 74 68 65 20 6d 61 78 69 6d 75 6d 20 76 61 6c   the maximum val
7be0: 75 65 2e 20 20 41 72 67 75 6d 65 6e 74 73 0a 6d  ue.  Arguments.m
7bf0: 61 79 20 62 65 20 73 74 72 69 6e 67 73 20 69 6e  ay be strings in
7c00: 20 61 64 64 69 74 69 6f 6e 20 74 6f 20 6e 75 6d   addition to num
7c10: 62 65 72 73 2e 20 20 54 68 65 20 6d 61 78 69 6d  bers.  The maxim
7c20: 75 6d 20 76 61 6c 75 65 20 69 73 20 64 65 74 65  um value is dete
7c30: 72 6d 69 6e 65 64 0a 62 79 20 74 68 65 20 75 73  rmined.by the us
7c40: 75 61 6c 20 73 6f 72 74 20 6f 72 64 65 72 2e 20  ual sort order. 
7c50: 20 4e 6f 74 65 20 74 68 61 74 20 3c 62 3e 6d 61   Note that <b>ma
7c60: 78 28 29 3c 2f 62 3e 20 69 73 20 61 20 73 69 6d  x()</b> is a sim
7c70: 70 6c 65 20 66 75 6e 63 74 69 6f 6e 20 77 68 65  ple function whe
7c80: 6e 0a 69 74 20 68 61 73 20 32 20 6f 72 20 6d 6f  n.it has 2 or mo
7c90: 72 65 20 61 72 67 75 6d 65 6e 74 73 20 62 75 74  re arguments but
7ca0: 20 63 6f 6e 76 65 72 74 73 20 74 6f 20 61 6e 20   converts to an 
7cb0: 61 67 67 72 65 67 61 74 65 20 66 75 6e 63 74 69  aggregate functi
7cc0: 6f 6e 20 69 66 20 67 69 76 65 6e 0a 6f 6e 6c 79  on if given.only
7cd0: 20 61 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65   a single argume
7ce0: 6e 74 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a  nt.</td>.</tr>..
7cf0: 3c 74 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d  <tr>.<td valign=
7d00: 22 74 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67  "top" align="rig
7d10: 68 74 22 3e 6d 69 6e 28 3c 69 3e 58 3c 2f 69 3e  ht">min(<i>X</i>
7d20: 2c 3c 69 3e 59 3c 2f 69 3e 2c 2e 2e 2e 29 3c 2f  ,<i>Y</i>,...)</
7d30: 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22  td>.<td valign="
7d40: 74 6f 70 22 3e 52 65 74 75 72 6e 20 74 68 65 20  top">Return the 
7d50: 61 72 67 75 6d 65 6e 74 20 77 69 74 68 20 74 68  argument with th
7d60: 65 20 6d 69 6e 69 6d 75 6d 20 76 61 6c 75 65 2e  e minimum value.
7d70: 20 20 41 72 67 75 6d 65 6e 74 73 0a 6d 61 79 20    Arguments.may 
7d80: 62 65 20 73 74 72 69 6e 67 73 20 69 6e 20 61 64  be strings in ad
7d90: 64 69 74 69 6f 6e 20 74 6f 20 6e 75 6d 62 65 72  dition to number
7da0: 73 2e 20 20 54 68 65 20 6d 6d 69 6e 69 6d 75 6d  s.  The mminimum
7db0: 20 76 61 6c 75 65 20 69 73 20 64 65 74 65 72 6d   value is determ
7dc0: 69 6e 65 64 0a 62 79 20 74 68 65 20 75 73 75 61  ined.by the usua
7dd0: 6c 20 73 6f 72 74 20 6f 72 64 65 72 2e 20 20 4e  l sort order.  N
7de0: 6f 74 65 20 74 68 61 74 20 3c 62 3e 6d 69 6e 28  ote that <b>min(
7df0: 29 3c 2f 62 3e 20 69 73 20 61 20 73 69 6d 70 6c  )</b> is a simpl
7e00: 65 20 66 75 6e 63 74 69 6f 6e 20 77 68 65 6e 0a  e function when.
7e10: 69 74 20 68 61 73 20 32 20 6f 72 20 6d 6f 72 65  it has 2 or more
7e20: 20 61 72 67 75 6d 65 6e 74 73 20 62 75 74 20 63   arguments but c
7e30: 6f 6e 76 65 72 74 73 20 74 6f 20 61 6e 20 61 67  onverts to an ag
7e40: 67 72 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e  gregate function
7e50: 20 69 66 20 67 69 76 65 6e 0a 6f 6e 6c 79 20 61   if given.only a
7e60: 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65 6e 74   single argument
7e70: 2e 3c 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74  .</td>.</tr>..<t
7e80: 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  r>.<td valign="t
7e90: 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74  op" align="right
7ea0: 22 3e 72 61 6e 64 6f 6d 28 2a 29 3c 2f 74 64 3e  ">random(*)</td>
7eb0: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
7ec0: 22 3e 52 65 74 75 72 6e 20 61 20 72 61 6e 64 6f  ">Return a rando
7ed0: 6d 20 69 6e 74 65 67 65 72 20 62 65 74 77 65 65  m integer betwee
7ee0: 6e 20 2d 32 31 34 37 34 38 33 36 34 38 20 61 6e  n -2147483648 an
7ef0: 64 0a 2b 32 31 34 37 34 38 33 36 34 37 2e 3c 2f  d.+2147483647.</
7f00: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
7f10: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7f20: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 72   align="right">r
7f30: 6f 75 6e 64 28 3c 69 3e 58 3c 2f 69 3e 29 3c 62  ound(<i>X</i>)<b
7f40: 72 3e 72 6f 75 6e 64 28 3c 69 3e 58 3c 2f 69 3e  r>round(<i>X</i>
7f50: 2c 3c 69 3e 59 3c 2f 69 3e 29 3c 2f 74 64 3e 0a  ,<i>Y</i>)</td>.
7f60: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
7f70: 3e 52 6f 75 6e 64 20 6f 66 66 20 74 68 65 20 6e  >Round off the n
7f80: 75 6d 62 65 72 20 3c 69 3e 58 3c 2f 69 3e 20 74  umber <i>X</i> t
7f90: 6f 20 3c 69 3e 59 3c 2f 69 3e 20 64 69 67 69 74  o <i>Y</i> digit
7fa0: 73 20 74 6f 20 74 68 65 0a 72 69 67 68 74 20 6f  s to the.right o
7fb0: 66 20 74 68 65 20 64 65 63 69 6d 61 6c 20 70 6f  f the decimal po
7fc0: 69 6e 74 2e 20 20 49 66 20 74 68 65 20 3c 69 3e  int.  If the <i>
7fd0: 59 3c 2f 69 3e 20 61 72 67 75 6d 65 6e 74 20 69  Y</i> argument i
7fe0: 73 20 6f 6d 69 74 74 65 64 2c 20 30 20 69 73 20  s omitted, 0 is 
7ff0: 0a 61 73 73 75 6d 65 64 2e 3c 2f 74 64 3e 0a 3c  .assumed.</td>.<
8000: 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76  /tr>..<tr>.<td v
8010: 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67  align="top" alig
8020: 6e 3d 22 72 69 67 68 74 22 3e 73 6f 75 6e 64 65  n="right">sounde
8030: 78 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e  x(<i>X</i>)</td>
8040: 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70  .<td valign="top
8050: 22 3e 43 6f 6d 70 75 74 65 20 74 68 65 20 73 6f  ">Compute the so
8060: 75 6e 64 65 78 20 65 6e 63 6f 64 69 6e 67 20 6f  undex encoding o
8070: 66 20 74 68 65 20 73 74 72 69 6e 67 20 3c 69 3e  f the string <i>
8080: 58 3c 2f 69 3e 2e 0a 54 68 69 73 20 72 65 74 75  X</i>..This retu
8090: 72 6e 73 20 22 3f 30 30 30 22 20 66 6f 72 20 61  rns "?000" for a
80a0: 20 4e 55 4c 4c 20 61 72 67 75 6d 65 6e 74 2e 0a   NULL argument..
80b0: 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20  </tr>..<tr>.<td 
80c0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69  valign="top" ali
80d0: 67 6e 3d 22 72 69 67 68 74 22 3e 73 75 62 73 74  gn="right">subst
80e0: 72 28 3c 69 3e 58 3c 2f 69 3e 2c 3c 69 3e 59 3c  r(<i>X</i>,<i>Y<
80f0: 2f 69 3e 2c 3c 69 3e 5a 3c 2f 69 3e 29 3c 2f 74  /i>,<i>Z</i>)</t
8100: 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  d>.<td valign="t
8110: 6f 70 22 3e 52 65 74 75 72 6e 20 61 20 73 75 62  op">Return a sub
8120: 73 74 72 69 6e 67 20 6f 66 20 69 6e 70 75 74 20  string of input 
8130: 73 74 72 69 6e 67 20 3c 69 3e 58 3c 2f 69 3e 20  string <i>X</i> 
8140: 74 68 61 74 20 62 65 67 69 6e 73 0a 77 69 74 68  that begins.with
8150: 20 74 68 65 20 3c 69 3e 59 3c 2f 69 3e 2d 74 68   the <i>Y</i>-th
8160: 20 63 68 61 72 61 63 74 65 72 20 61 6e 64 20 77   character and w
8170: 68 69 63 68 20 69 73 20 3c 69 3e 5a 3c 2f 69 3e  hich is <i>Z</i>
8180: 20 63 68 61 72 61 63 74 65 72 73 20 6c 6f 6e 67   characters long
8190: 2e 0a 54 68 65 20 6c 65 66 74 2d 6d 6f 73 74 20  ..The left-most 
81a0: 63 68 61 72 61 63 74 65 72 20 6f 66 20 3c 69 3e  character of <i>
81b0: 58 3c 2f 69 3e 20 69 73 20 6e 75 6d 62 65 72 20  X</i> is number 
81c0: 31 2e 20 20 49 66 20 3c 69 3e 59 3c 2f 69 3e 20  1.  If <i>Y</i> 
81d0: 69 73 20 6e 65 67 61 74 69 76 65 0a 74 68 65 20  is negative.the 
81e0: 74 68 65 20 66 69 72 73 74 20 63 68 61 72 61 63  the first charac
81f0: 74 65 72 20 6f 66 20 74 68 65 20 73 75 62 73 74  ter of the subst
8200: 72 69 6e 67 20 69 73 20 66 6f 75 6e 64 20 62 79  ring is found by
8210: 20 63 6f 75 6e 74 69 6e 67 20 66 72 6f 6d 20 74   counting from t
8220: 68 65 0a 72 69 67 68 74 20 72 61 74 68 65 72 20  he.right rather 
8230: 74 68 61 6e 20 74 68 65 20 6c 65 66 74 2e 20 20  than the left.  
8240: 49 66 20 53 51 4c 69 74 65 20 69 73 20 63 6f 6e  If SQLite is con
8250: 66 69 67 75 72 65 64 20 74 6f 20 73 75 70 70 6f  figured to suppo
8260: 72 74 20 55 54 46 2d 38 2c 0a 74 68 65 6e 20 63  rt UTF-8,.then c
8270: 68 61 72 61 63 74 65 72 73 20 69 6e 64 69 63 65  haracters indice
8280: 73 20 72 65 66 65 72 20 74 6f 20 61 63 74 75 61  s refer to actua
8290: 6c 20 55 54 46 2d 38 20 63 68 61 72 61 63 74 65  l UTF-8 characte
82a0: 72 73 2c 20 6e 6f 74 20 62 79 74 65 73 2e 3c 2f  rs, not bytes.</
82b0: 74 64 3e 0a 3c 2f 74 72 3e 0a 0a 3c 74 72 3e 0a  td>.</tr>..<tr>.
82c0: 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22  <td valign="top"
82d0: 20 61 6c 69 67 6e 3d 22 72 69 67 68 74 22 3e 75   align="right">u
82e0: 70 70 65 72 28 3c 69 3e 58 3c 2f 69 3e 29 3c 2f  pper(<i>X</i>)</
82f0: 74 64 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22  td>.<td valign="
8300: 74 6f 70 22 3e 52 65 74 75 72 6e 20 61 20 63 6f  top">Return a co
8310: 70 79 20 6f 66 20 69 6e 70 75 74 20 73 74 72 69  py of input stri
8320: 6e 67 20 3c 69 3e 58 3c 2f 69 3e 20 63 6f 6e 76  ng <i>X</i> conv
8330: 65 72 74 65 64 20 74 6f 20 61 6c 6c 0a 75 70 70  erted to all.upp
8340: 65 72 2d 63 61 73 65 20 6c 65 74 74 65 72 73 2e  er-case letters.
8350: 20 20 54 68 65 20 69 6d 70 6c 65 6d 65 6e 74 61    The implementa
8360: 74 69 6f 6e 20 6f 66 20 74 68 69 73 20 66 75 6e  tion of this fun
8370: 63 74 69 6f 6e 20 75 73 65 73 20 74 68 65 20 43  ction uses the C
8380: 20 6c 69 62 72 61 72 79 0a 72 6f 75 74 69 6e 65   library.routine
8390: 20 3c 62 3e 74 6f 75 70 70 65 72 28 29 3c 2f 62   <b>toupper()</b
83a0: 3e 20 77 68 69 63 68 20 6d 65 61 6e 73 20 69 74  > which means it
83b0: 20 6d 61 79 20 6e 6f 74 20 77 6f 72 6b 20 63 6f   may not work co
83c0: 72 72 65 63 74 6c 79 20 6f 6e 20 0a 55 54 46 2d  rrectly on .UTF-
83d0: 38 20 73 74 72 69 6e 67 73 2e 3c 2f 74 64 3e 0a  8 strings.</td>.
83e0: 3c 2f 74 72 3e 0a 3c 2f 74 61 62 6c 65 3e 0a 0a  </tr>.</table>..
83f0: 3c 70 3e 0a 54 68 65 20 66 6f 6c 6c 6f 77 69 6e  <p>.The followin
8400: 67 20 61 67 67 72 65 67 61 74 65 20 66 75 6e 63  g aggregate func
8410: 74 69 6f 6e 73 20 61 72 65 20 61 76 61 69 6c 61  tions are availa
8420: 62 6c 65 20 62 79 20 64 65 66 61 75 6c 74 2e 20  ble by default. 
8430: 20 41 64 64 69 74 69 6f 6e 61 6c 0a 61 67 67 72   Additional.aggr
8440: 65 67 61 74 65 20 66 75 6e 63 74 69 6f 6e 73 20  egate functions 
8450: 77 72 69 74 74 65 6e 20 69 6e 20 43 20 6d 61 79  written in C may
8460: 20 62 65 20 61 64 64 65 64 20 75 73 69 6e 67 20   be added using 
8470: 74 68 65 20 0a 3c 61 20 68 72 65 66 3d 22 63 5f  the .<a href="c_
8480: 69 6e 74 65 72 66 61 63 65 2e 68 74 6d 6c 23 63  interface.html#c
8490: 66 75 6e 63 22 3e 73 71 6c 69 74 65 5f 63 72 65  func">sqlite_cre
84a0: 61 74 65 5f 61 67 67 72 65 67 61 74 65 28 29 3c  ate_aggregate()<
84b0: 2f 61 3e 20 41 50 49 2e 3c 2f 70 3e 0a 0a 3c 74  /a> API.</p>..<t
84c0: 61 62 6c 65 20 62 6f 72 64 65 72 3d 30 20 63 65  able border=0 ce
84d0: 6c 6c 70 61 64 64 69 6e 67 3d 31 30 3e 0a 3c 74  llpadding=10>.<t
84e0: 72 3e 0a 3c 74 64 20 76 61 6c 69 67 6e 3d 22 74  r>.<td valign="t
84f0: 6f 70 22 20 61 6c 69 67 6e 3d 22 72 69 67 68 74  op" align="right
8500: 22 20 77 69 64 74 68 3d 31 32 30 3e 61 76 67 28  " width=120>avg(
8510: 3c 69 3e 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c  <i>X</i>)</td>.<
8520: 74 64 20 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e  td valign="top">
8530: 52 65 74 75 72 6e 20 74 68 65 20 61 76 65 72 61  Return the avera
8540: 67 65 20 76 61 6c 75 65 20 6f 66 20 61 6c 6c 20  ge value of all 
8550: 3c 69 3e 58 3c 2f 69 3e 20 77 69 74 68 69 6e 20  <i>X</i> within 
8560: 61 20 67 72 6f 75 70 2e 3c 2f 74 64 3e 0a 3c 2f  a group.</td>.</
8570: 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  tr>..<tr>.<td va
8580: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
8590: 3d 22 72 69 67 68 74 22 3e 63 6f 75 6e 74 28 3c  ="right">count(<
85a0: 69 3e 58 3c 2f 69 3e 29 3c 62 72 3e 63 6f 75 6e  i>X</i>)<br>coun
85b0: 74 28 2a 29 3c 2f 74 64 3e 0a 3c 74 64 20 76 61  t(*)</td>.<td va
85c0: 6c 69 67 6e 3d 22 74 6f 70 22 3e 54 68 65 20 66  lign="top">The f
85d0: 69 72 73 74 20 66 6f 72 6d 20 72 65 74 75 72 6e  irst form return
85e0: 20 61 20 63 6f 75 6e 74 20 6f 66 20 74 68 65 20   a count of the 
85f0: 6e 75 6d 62 65 72 20 6f 66 20 74 69 6d 65 73 0a  number of times.
8600: 74 68 61 74 20 3c 69 3e 58 3c 2f 69 3e 20 69 73  that <i>X</i> is
8610: 20 6e 6f 74 20 4e 55 4c 4c 20 69 6e 20 61 20 67   not NULL in a g
8620: 72 6f 75 70 2e 20 20 54 68 65 20 73 65 63 6f 6e  roup.  The secon
8630: 64 20 66 6f 72 6d 20 28 77 69 74 68 20 6e 6f 20  d form (with no 
8640: 61 72 67 75 6d 65 6e 74 29 0a 72 65 74 75 72 6e  argument).return
8650: 73 20 74 68 65 20 74 6f 74 61 6c 20 6e 75 6d 62  s the total numb
8660: 65 72 20 6f 66 20 72 6f 77 73 20 69 6e 20 74 68  er of rows in th
8670: 65 20 67 72 6f 75 70 2e 3c 2f 74 64 3e 0a 3c 2f  e group.</td>.</
8680: 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  tr>..<tr>.<td va
8690: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
86a0: 3d 22 72 69 67 68 74 22 3e 6d 61 78 28 3c 69 3e  ="right">max(<i>
86b0: 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20  X</i>)</td>.<td 
86c0: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
86d0: 75 72 6e 20 74 68 65 20 6d 61 78 69 6d 75 6d 20  urn the maximum 
86e0: 76 61 6c 75 65 20 6f 66 20 61 6c 6c 20 76 61 6c  value of all val
86f0: 75 65 73 20 69 6e 20 74 68 65 20 67 72 6f 75 70  ues in the group
8700: 2e 0a 54 68 65 20 75 73 75 61 6c 20 73 6f 72 74  ..The usual sort
8710: 20 6f 72 64 65 72 20 69 73 20 75 73 65 64 20 74   order is used t
8720: 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20  o determine the 
8730: 6d 61 78 69 6d 75 6d 2e 3c 2f 74 64 3e 0a 3c 2f  maximum.</td>.</
8740: 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  tr>..<tr>.<td va
8750: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
8760: 3d 22 72 69 67 68 74 22 3e 6d 69 6e 28 3c 69 3e  ="right">min(<i>
8770: 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20  X</i>)</td>.<td 
8780: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
8790: 75 72 6e 20 74 68 65 20 6d 69 6e 69 6d 75 6d 20  urn the minimum 
87a0: 76 61 6c 75 65 20 6f 66 20 61 6c 6c 20 76 61 6c  value of all val
87b0: 75 65 73 20 69 6e 20 74 68 65 20 67 72 6f 75 70  ues in the group
87c0: 2e 0a 54 68 65 20 75 73 75 61 6c 20 73 6f 72 74  ..The usual sort
87d0: 20 6f 72 64 65 72 20 69 73 20 75 73 65 64 20 74   order is used t
87e0: 6f 20 64 65 74 65 72 6d 69 6e 65 20 74 68 65 20  o determine the 
87f0: 6d 69 6e 69 6d 75 6d 2e 3c 2f 74 64 3e 0a 3c 2f  minimum.</td>.</
8800: 74 72 3e 0a 0a 3c 74 72 3e 0a 3c 74 64 20 76 61  tr>..<tr>.<td va
8810: 6c 69 67 6e 3d 22 74 6f 70 22 20 61 6c 69 67 6e  lign="top" align
8820: 3d 22 72 69 67 68 74 22 3e 73 75 6d 28 3c 69 3e  ="right">sum(<i>
8830: 58 3c 2f 69 3e 29 3c 2f 74 64 3e 0a 3c 74 64 20  X</i>)</td>.<td 
8840: 76 61 6c 69 67 6e 3d 22 74 6f 70 22 3e 52 65 74  valign="top">Ret
8850: 75 72 6e 20 74 68 65 20 6e 75 6d 65 72 69 63 20  urn the numeric 
8860: 73 75 6d 20 6f 66 20 61 6c 6c 20 76 61 6c 75 65  sum of all value
8870: 73 20 69 6e 20 74 68 65 20 67 72 6f 75 70 2e 3c  s in the group.<
8880: 2f 74 64 3e 0a 3c 2f 74 72 3e 0a 3c 2f 74 61 62  /td>.</tr>.</tab
8890: 6c 65 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20  le>.}...Section 
88a0: 49 4e 53 45 52 54 20 69 6e 73 65 72 74 0a 0a 53  INSERT insert..S
88b0: 79 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65  yntax {sql-state
88c0: 6d 65 6e 74 7d 20 7b 0a 49 4e 53 45 52 54 20 5b  ment} {.INSERT [
88d0: 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67  OR <conflict-alg
88e0: 6f 72 69 74 68 6d 3e 5d 20 49 4e 54 4f 20 3c 74  orithm>] INTO <t
88f0: 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 3c 63 6f  able-name> [(<co
8900: 6c 75 6d 6e 2d 6c 69 73 74 3e 29 5d 20 56 41 4c  lumn-list>)] VAL
8910: 55 45 53 28 3c 76 61 6c 75 65 2d 6c 69 73 74 3e  UES(<value-list>
8920: 29 20 7c 0a 49 4e 53 45 52 54 20 5b 4f 52 20 3c  ) |.INSERT [OR <
8930: 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74  conflict-algorit
8940: 68 6d 3e 5d 20 49 4e 54 4f 20 3c 74 61 62 6c 65  hm>] INTO <table
8950: 2d 6e 61 6d 65 3e 20 5b 28 3c 63 6f 6c 75 6d 6e  -name> [(<column
8960: 2d 6c 69 73 74 3e 29 5d 20 3c 73 65 6c 65 63 74  -list>)] <select
8970: 2d 73 74 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70  -statement>.}..p
8980: 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20 49 4e 53  uts {.<p>The INS
8990: 45 52 54 20 73 74 61 74 65 6d 65 6e 74 20 63 6f  ERT statement co
89a0: 6d 65 73 20 69 6e 20 74 77 6f 20 62 61 73 69 63  mes in two basic
89b0: 20 66 6f 72 6d 73 2e 20 20 54 68 65 20 66 69 72   forms.  The fir
89c0: 73 74 20 66 6f 72 6d 0a 28 77 69 74 68 20 74 68  st form.(with th
89d0: 65 20 22 56 41 4c 55 45 53 22 20 6b 65 79 77 6f  e "VALUES" keywo
89e0: 72 64 29 20 63 72 65 61 74 65 73 20 61 20 73 69  rd) creates a si
89f0: 6e 67 6c 65 20 6e 65 77 20 72 6f 77 20 69 6e 20  ngle new row in 
8a00: 61 6e 20 65 78 69 73 74 69 6e 67 20 74 61 62 6c  an existing tabl
8a10: 65 2e 0a 49 66 20 6e 6f 20 63 6f 6c 75 6d 6e 2d  e..If no column-
8a20: 6c 69 73 74 20 69 73 20 73 70 65 63 69 66 69 65  list is specifie
8a30: 64 20 74 68 65 6e 20 74 68 65 20 6e 75 6d 62 65  d then the numbe
8a40: 72 20 6f 66 20 76 61 6c 75 65 73 20 6d 75 73 74  r of values must
8a50: 0a 62 65 20 74 68 65 20 73 61 6d 65 20 61 73 20  .be the same as 
8a60: 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  the number of co
8a70: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 74 61 62  lumns in the tab
8a80: 6c 65 2e 20 20 49 66 20 61 20 63 6f 6c 75 6d 6e  le.  If a column
8a90: 2d 6c 69 73 74 0a 69 73 20 73 70 65 63 69 66 69  -list.is specifi
8aa0: 65 64 2c 20 74 68 65 6e 20 74 68 65 20 6e 75 6d  ed, then the num
8ab0: 62 65 72 20 6f 66 20 76 61 6c 75 65 73 20 6d 75  ber of values mu
8ac0: 73 74 20 6d 61 74 63 68 20 74 68 65 20 6e 75 6d  st match the num
8ad0: 62 65 72 20 6f 66 0a 73 70 65 63 69 66 69 65 64  ber of.specified
8ae0: 20 63 6f 6c 75 6d 6e 73 2e 20 20 43 6f 6c 75 6d   columns.  Colum
8af0: 6e 73 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20  ns of the table 
8b00: 74 68 61 74 20 64 6f 20 6e 6f 74 20 61 70 70 65  that do not appe
8b10: 61 72 20 69 6e 20 74 68 65 0a 63 6f 6c 75 6d 6e  ar in the.column
8b20: 20 6c 69 73 74 20 61 72 65 20 66 69 6c 6c 20 77   list are fill w
8b30: 69 74 68 20 74 68 65 20 64 65 66 61 75 6c 74 20  ith the default 
8b40: 76 61 6c 75 65 2c 20 6f 72 20 77 69 74 68 20 4e  value, or with N
8b50: 55 4c 4c 20 69 66 20 6e 6f 74 0a 64 65 66 61 75  ULL if not.defau
8b60: 6c 74 20 76 61 6c 75 65 20 69 73 20 73 70 65 63  lt value is spec
8b70: 69 66 69 65 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e  ified..</p>..<p>
8b80: 54 68 65 20 73 65 63 6f 6e 64 20 66 6f 72 6d 20  The second form 
8b90: 6f 66 20 74 68 65 20 49 4e 53 45 52 54 20 73 74  of the INSERT st
8ba0: 61 74 65 6d 65 6e 74 20 74 61 6b 65 73 20 69 74  atement takes it
8bb0: 20 64 61 74 61 20 66 72 6f 6d 20 61 0a 53 45 4c   data from a.SEL
8bc0: 45 43 54 20 73 74 61 74 65 6d 65 6e 74 2e 20 20  ECT statement.  
8bd0: 54 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  The number of co
8be0: 6c 75 6d 6e 73 20 69 6e 20 74 68 65 20 72 65 73  lumns in the res
8bf0: 75 6c 74 20 6f 66 20 74 68 65 0a 53 45 4c 45 43  ult of the.SELEC
8c00: 54 20 6d 75 73 74 20 65 78 61 63 74 6c 79 20 6d  T must exactly m
8c10: 61 74 63 68 20 74 68 65 20 6e 75 6d 62 65 72 20  atch the number 
8c20: 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 74 68  of columns in th
8c30: 65 20 74 61 62 6c 65 20 69 66 0a 6e 6f 20 63 6f  e table if.no co
8c40: 6c 75 6d 6e 20 6c 69 73 74 20 69 73 20 73 70 65  lumn list is spe
8c50: 63 69 66 69 65 64 2c 20 6f 72 20 69 74 20 6d 75  cified, or it mu
8c60: 73 74 20 6d 61 74 63 68 20 74 68 65 20 6e 75 6d  st match the num
8c70: 62 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 0a 6e  ber of columns.n
8c80: 61 6d 65 20 69 6e 20 74 68 65 20 63 6f 6c 75 6d  ame in the colum
8c90: 6e 20 6c 69 73 74 2e 20 20 41 20 6e 65 77 20 65  n list.  A new e
8ca0: 6e 74 72 79 20 69 73 20 6d 61 64 65 20 69 6e 20  ntry is made in 
8cb0: 74 68 65 20 74 61 62 6c 65 0a 66 6f 72 20 65 76  the table.for ev
8cc0: 65 72 79 20 72 6f 77 20 6f 66 20 74 68 65 20 53  ery row of the S
8cd0: 45 4c 45 43 54 20 72 65 73 75 6c 74 2e 20 20 54  ELECT result.  T
8ce0: 68 65 20 53 45 4c 45 43 54 20 6d 61 79 20 62 65  he SELECT may be
8cf0: 20 73 69 6d 70 6c 65 0a 6f 72 20 63 6f 6d 70 6f   simple.or compo
8d00: 75 6e 64 2e 20 20 49 66 20 74 68 65 20 53 45 4c  und.  If the SEL
8d10: 45 43 54 20 73 74 61 74 65 6d 65 6e 74 20 68 61  ECT statement ha
8d20: 73 20 61 6e 20 4f 52 44 45 52 20 42 59 20 63 6c  s an ORDER BY cl
8d30: 61 75 73 65 2c 0a 74 68 65 20 4f 52 44 45 52 20  ause,.the ORDER 
8d40: 42 59 20 69 73 20 69 67 6e 6f 72 65 64 2e 3c 2f  BY is ignored.</
8d50: 70 3e 0a 0a 3c 70 3e 54 68 65 20 6f 70 74 69 6f  p>..<p>The optio
8d60: 6e 61 6c 20 63 6f 6e 66 6c 69 63 74 2d 63 6c 61  nal conflict-cla
8d70: 75 73 65 20 61 6c 6c 6f 77 73 20 74 68 65 20 73  use allows the s
8d80: 70 65 63 69 66 69 63 61 74 69 6f 6e 20 6f 66 20  pecification of 
8d90: 61 6e 20 61 6c 74 65 72 6e 61 74 69 76 65 0a 63  an alternative.c
8da0: 6f 6e 73 74 72 61 69 6e 74 20 63 6f 6e 66 6c 69  onstraint confli
8db0: 63 74 20 72 65 73 6f 6c 75 74 69 6f 6e 20 61 6c  ct resolution al
8dc0: 67 6f 72 69 74 68 6d 20 74 6f 20 75 73 65 20 64  gorithm to use d
8dd0: 75 72 69 6e 67 20 74 68 69 73 20 6f 6e 65 20 63  uring this one c
8de0: 6f 6d 6d 61 6e 64 2e 0a 53 65 65 20 74 68 65 20  ommand..See the 
8df0: 73 65 63 74 69 6f 6e 20 74 69 74 6c 65 64 0a 3c  section titled.<
8e00: 61 20 68 72 65 66 3d 22 23 63 6f 6e 66 6c 69 63  a href="#conflic
8e10: 74 22 3e 4f 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f  t">ON CONFLICT</
8e20: 61 3e 20 66 6f 72 20 61 64 64 69 74 69 6f 6e 61  a> for additiona
8e30: 6c 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2e 0a 46  l information..F
8e40: 6f 72 20 63 6f 6d 70 61 74 69 62 69 6c 69 74 79  or compatibility
8e50: 20 77 69 74 68 20 4d 79 53 51 4c 2c 20 74 68 65   with MySQL, the
8e60: 20 70 61 72 73 65 72 20 61 6c 6c 6f 77 73 20 74   parser allows t
8e70: 68 65 20 75 73 65 20 6f 66 20 74 68 65 0a 73 69  he use of the.si
8e80: 6e 67 6c 65 20 6b 65 79 77 6f 72 64 20 3c 61 20  ngle keyword <a 
8e90: 68 72 65 66 3d 22 23 72 65 70 6c 61 63 65 22 3e  href="#replace">
8ea0: 52 45 50 4c 41 43 45 3c 2f 61 3e 20 61 73 20 61  REPLACE</a> as a
8eb0: 6e 20 61 6c 69 61 73 20 66 6f 72 20 22 49 4e 53  n alias for "INS
8ec0: 45 52 54 20 4f 52 20 52 45 50 4c 41 43 45 22 2e  ERT OR REPLACE".
8ed0: 0a 3c 2f 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f  .</p>.}...Sectio
8ee0: 6e 20 7b 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63  n {ON CONFLICT c
8ef0: 6c 61 75 73 65 7d 20 63 6f 6e 66 6c 69 63 74 0a  lause} conflict.
8f00: 0a 53 79 6e 74 61 78 20 7b 63 6f 6e 66 6c 69 63  .Syntax {conflic
8f10: 74 2d 63 6c 61 75 73 65 7d 20 7b 0a 4f 4e 20 43  t-clause} {.ON C
8f20: 4f 4e 46 4c 49 43 54 20 3c 63 6f 6e 66 6c 69 63  ONFLICT <conflic
8f30: 74 2d 61 6c 67 6f 72 69 74 68 6d 3e 0a 7d 20 7b  t-algorithm>.} {
8f40: 63 6f 6e 66 6c 69 63 74 2d 61 6c 67 6f 72 69 74  conflict-algorit
8f50: 68 6d 7d 20 7b 0a 52 4f 4c 4c 42 41 43 4b 20 7c  hm} {.ROLLBACK |
8f60: 20 41 42 4f 52 54 20 7c 20 46 41 49 4c 20 7c 20   ABORT | FAIL | 
8f70: 49 47 4e 4f 52 45 20 7c 20 52 45 50 4c 41 43 45  IGNORE | REPLACE
8f80: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
8f90: 65 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c  e ON CONFLICT cl
8fa0: 61 75 73 65 20 69 73 20 6e 6f 74 20 61 20 73 65  ause is not a se
8fb0: 70 61 72 61 74 65 20 53 51 4c 20 63 6f 6d 6d 61  parate SQL comma
8fc0: 6e 64 2e 20 20 49 74 20 69 73 20 61 0a 6e 6f 6e  nd.  It is a.non
8fd0: 2d 73 74 61 6e 64 61 72 64 20 63 6c 61 75 73 65  -standard clause
8fe0: 20 74 68 61 74 20 63 61 6e 20 61 70 70 65 61 72   that can appear
8ff0: 20 69 6e 20 6d 61 6e 79 20 6f 74 68 65 72 20 53   in many other S
9000: 51 4c 20 63 6f 6d 6d 61 6e 64 73 2e 0a 49 74 20  QL commands..It 
9010: 69 73 20 67 69 76 65 6e 20 69 74 73 20 6f 77 6e  is given its own
9020: 20 73 65 63 74 69 6f 6e 20 69 6e 20 74 68 69 73   section in this
9030: 20 64 6f 63 75 6d 65 6e 74 20 62 65 63 61 75 73   document becaus
9040: 65 20 69 74 20 69 73 20 6e 6f 74 0a 70 61 72 74  e it is not.part
9050: 20 6f 66 20 73 74 61 6e 64 61 72 64 20 53 51 4c   of standard SQL
9060: 20 61 6e 64 20 74 68 65 72 65 66 6f 72 65 20 6d   and therefore m
9070: 69 67 68 74 20 6e 6f 74 20 62 65 20 66 61 6d 69  ight not be fami
9080: 6c 69 61 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  liar.</p>..<p>Th
9090: 65 20 73 79 6e 74 61 78 20 66 6f 72 20 74 68 65  e syntax for the
90a0: 20 4f 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61   ON CONFLICT cla
90b0: 75 73 65 20 69 73 20 61 73 20 73 68 6f 77 6e 20  use is as shown 
90c0: 61 62 6f 76 65 20 66 6f 72 0a 74 68 65 20 43 52  above for.the CR
90d0: 45 41 54 45 20 54 41 42 4c 45 2c 20 43 52 45 41  EATE TABLE, CREA
90e0: 54 45 20 49 4e 44 45 58 2c 20 61 6e 64 20 42 45  TE INDEX, and BE
90f0: 47 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20  GIN TRANSACTION 
9100: 63 6f 6d 6d 61 6e 64 73 2e 0a 46 6f 72 20 74 68  commands..For th
9110: 65 20 43 4f 50 59 2c 20 49 4e 53 45 52 54 2c 20  e COPY, INSERT, 
9120: 61 6e 64 20 55 50 44 41 54 45 20 63 6f 6d 6d 61  and UPDATE comma
9130: 6e 64 73 2c 20 74 68 65 20 6b 65 79 77 6f 72 64  nds, the keyword
9140: 73 0a 22 4f 4e 20 43 4f 4e 46 4c 49 43 54 22 20  s."ON CONFLICT" 
9150: 61 72 65 20 72 65 70 6c 61 63 65 64 20 62 79 20  are replaced by 
9160: 22 4f 52 22 2c 20 74 6f 20 6d 61 6b 65 20 74 68  "OR", to make th
9170: 65 20 73 79 6e 74 61 78 20 73 65 65 6d 20 6d 6f  e syntax seem mo
9180: 72 65 0a 6e 61 74 75 72 61 6c 2e 20 20 42 75 74  re.natural.  But
9190: 20 74 68 65 20 6d 65 61 6e 69 6e 67 20 6f 66 20   the meaning of 
91a0: 74 68 65 20 63 6c 61 75 73 65 20 69 73 20 74 68  the clause is th
91b0: 65 20 73 61 6d 65 20 65 69 74 68 65 72 20 77 61  e same either wa
91c0: 79 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 4f  y.</p>..<p>The O
91d0: 4e 20 43 4f 4e 46 4c 49 43 54 20 63 6c 61 75 73  N CONFLICT claus
91e0: 65 20 73 70 65 63 69 66 69 65 73 20 61 6e 20 61  e specifies an a
91f0: 6c 67 6f 72 69 74 68 6d 20 75 73 65 64 20 74 6f  lgorithm used to
9200: 20 72 65 73 6f 6c 76 65 0a 63 6f 6e 73 74 72 61   resolve.constra
9210: 69 6e 74 20 63 6f 6e 66 6c 69 63 74 73 2e 20 20  int conflicts.  
9220: 54 68 65 72 65 20 61 72 65 20 66 69 76 65 20 63  There are five c
9230: 68 6f 69 63 65 73 3a 20 52 4f 4c 4c 42 41 43 4b  hoices: ROLLBACK
9240: 2c 20 41 42 4f 52 54 2c 0a 46 41 49 4c 2c 20 49  , ABORT,.FAIL, I
9250: 47 4e 4f 52 45 2c 20 61 6e 64 20 52 45 50 4c 41  GNORE, and REPLA
9260: 43 45 2e 20 54 68 65 20 64 65 66 61 75 6c 74 20  CE. The default 
9270: 61 6c 67 6f 72 69 74 68 6d 20 69 73 20 41 42 4f  algorithm is ABO
9280: 52 54 2e 20 20 54 68 69 73 0a 69 73 20 77 68 61  RT.  This.is wha
9290: 74 20 74 68 65 79 20 6d 65 61 6e 3a 3c 2f 70 3e  t they mean:</p>
92a0: 0a 0a 3c 64 6c 3e 0a 3c 64 74 3e 3c 62 3e 52 4f  ..<dl>.<dt><b>RO
92b0: 4c 4c 42 41 43 4b 3c 2f 62 3e 3c 2f 64 74 3e 0a  LLBACK</b></dt>.
92c0: 3c 64 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f  <dd><p>When a co
92d0: 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69  nstraint violati
92e0: 6f 6e 20 6f 63 63 75 72 73 2c 20 61 6e 20 69 6d  on occurs, an im
92f0: 6d 65 64 69 61 74 65 20 52 4f 4c 4c 42 41 43 4b  mediate ROLLBACK
9300: 0a 6f 63 63 75 72 73 2c 20 74 68 75 73 20 65 6e  .occurs, thus en
9310: 64 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74  ding the current
9320: 20 74 72 61 6e 73 61 63 74 69 6f 6e 2c 20 61 6e   transaction, an
9330: 64 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 61 62  d the command ab
9340: 6f 72 74 73 0a 77 69 74 68 20 61 20 72 65 74 75  orts.with a retu
9350: 72 6e 20 63 6f 64 65 20 6f 66 20 53 51 4c 49 54  rn code of SQLIT
9360: 45 5f 43 4f 4e 53 54 52 41 49 4e 54 2e 20 20 49  E_CONSTRAINT.  I
9370: 66 20 6e 6f 20 74 72 61 6e 73 61 63 74 69 6f 6e  f no transaction
9380: 20 69 73 0a 61 63 74 69 76 65 20 28 6f 74 68 65   is.active (othe
9390: 72 20 74 68 61 6e 20 74 68 65 20 69 6d 70 6c 69  r than the impli
93a0: 65 64 20 74 72 61 6e 73 61 63 74 69 6f 6e 20 74  ed transaction t
93b0: 68 61 74 20 69 73 20 63 72 65 61 74 65 64 20 6f  hat is created o
93c0: 6e 20 65 76 65 72 79 0a 63 6f 6d 6d 61 6e 64 29  n every.command)
93d0: 20 74 68 65 6e 20 74 68 69 73 20 61 6c 67 6f 72   then this algor
93e0: 69 74 68 6d 20 77 6f 72 6b 73 20 74 68 65 20 73  ithm works the s
93f0: 61 6d 65 20 61 73 20 41 42 4f 52 54 2e 3c 2f 70  ame as ABORT.</p
9400: 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 41  ></dd>..<dt><b>A
9410: 42 4f 52 54 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64  BORT</b></dt>.<d
9420: 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73  d><p>When a cons
9430: 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e  traint violation
9440: 20 6f 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d   occurs, the com
9450: 6d 61 6e 64 20 62 61 63 6b 73 20 6f 75 74 0a 61  mand backs out.a
9460: 6e 79 20 70 72 69 6f 72 20 63 68 61 6e 67 65 73  ny prior changes
9470: 20 69 74 20 6d 69 67 68 74 20 68 61 76 65 20 6d   it might have m
9480: 61 64 65 20 61 6e 64 20 61 62 6f 72 74 73 20 77  ade and aborts w
9490: 69 74 68 20 61 20 72 65 74 75 72 6e 20 63 6f 64  ith a return cod
94a0: 65 0a 6f 66 20 53 51 4c 49 54 45 5f 43 4f 4e 53  e.of SQLITE_CONS
94b0: 54 52 41 49 4e 54 2e 20 20 42 75 74 20 6e 6f 20  TRAINT.  But no 
94c0: 52 4f 4c 4c 42 41 43 4b 20 69 73 20 65 78 65 63  ROLLBACK is exec
94d0: 75 74 65 64 20 73 6f 20 63 68 61 6e 67 65 73 0a  uted so changes.
94e0: 66 72 6f 6d 20 70 72 69 6f 72 20 63 6f 6d 6d 61  from prior comma
94f0: 6e 64 73 20 77 69 74 68 69 6e 20 74 68 65 20 73  nds within the s
9500: 61 6d 65 20 74 72 61 6e 73 61 63 74 69 6f 6e 0a  ame transaction.
9510: 61 72 65 20 70 72 65 73 65 72 76 65 64 2e 20 20  are preserved.  
9520: 54 68 69 73 20 69 73 20 74 68 65 20 64 65 66 61  This is the defa
9530: 75 6c 74 20 62 65 68 61 76 69 6f 72 2e 3c 2f 70  ult behavior.</p
9540: 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 46  ></dd>..<dt><b>F
9550: 41 49 4c 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64  AIL</b></dt>.<dd
9560: 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e 73 74  ><p>When a const
9570: 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20  raint violation 
9580: 6f 63 63 75 72 73 2c 20 74 68 65 20 63 6f 6d 6d  occurs, the comm
9590: 61 6e 64 20 61 62 6f 72 74 73 20 77 69 74 68 20  and aborts with 
95a0: 61 0a 72 65 74 75 72 6e 20 63 6f 64 65 20 53 51  a.return code SQ
95b0: 4c 49 54 45 5f 43 4f 4e 53 54 52 41 49 4e 54 2e  LITE_CONSTRAINT.
95c0: 20 20 42 75 74 20 61 6e 79 20 63 68 61 6e 67 65    But any change
95d0: 73 20 74 6f 20 74 68 65 20 64 61 74 61 62 61 73  s to the databas
95e0: 65 20 74 68 61 74 0a 74 68 65 20 63 6f 6d 6d 61  e that.the comma
95f0: 6e 64 20 6d 61 64 65 20 70 72 69 6f 72 20 74 6f  nd made prior to
9600: 20 65 6e 63 6f 75 6e 74 65 72 69 6e 67 20 74 68   encountering th
9610: 65 20 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f  e constraint vio
9620: 6c 61 74 69 6f 6e 0a 61 72 65 20 70 72 65 73 65  lation.are prese
9630: 72 76 65 64 20 61 6e 64 20 61 72 65 20 6e 6f 74  rved and are not
9640: 20 62 61 63 6b 65 64 20 6f 75 74 2e 20 20 46 6f   backed out.  Fo
9650: 72 20 65 78 61 6d 70 6c 65 2c 20 69 66 20 61 6e  r example, if an
9660: 20 55 50 44 41 54 45 0a 73 74 61 74 65 6d 65 6e   UPDATE.statemen
9670: 74 20 65 6e 63 6f 75 6e 74 65 72 65 64 20 61 20  t encountered a 
9680: 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61  constraint viola
9690: 74 69 6f 6e 20 6f 6e 20 74 68 65 20 31 30 30 74  tion on the 100t
96a0: 68 20 72 6f 77 20 74 68 61 74 0a 69 74 20 61 74  h row that.it at
96b0: 74 65 6d 70 74 73 20 74 6f 20 75 70 64 61 74 65  tempts to update
96c0: 2c 20 74 68 65 6e 20 74 68 65 20 66 69 72 73 74  , then the first
96d0: 20 39 39 20 72 6f 77 20 63 68 61 6e 67 65 73 20   99 row changes 
96e0: 61 72 65 20 70 72 65 73 65 72 76 65 64 0a 62 75  are preserved.bu
96f0: 74 20 63 68 61 6e 67 65 73 20 74 6f 20 72 6f 77  t changes to row
9700: 73 20 31 30 30 20 61 6e 64 20 62 65 79 6f 6e 64  s 100 and beyond
9710: 20 6e 65 76 65 72 20 6f 63 63 75 72 2e 3c 2f 70   never occur.</p
9720: 3e 3c 2f 64 64 3e 0a 0a 3c 64 74 3e 3c 62 3e 49  ></dd>..<dt><b>I
9730: 47 4e 4f 52 45 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c  GNORE</b></dt>.<
9740: 64 64 3e 3c 70 3e 57 68 65 6e 20 61 20 63 6f 6e  dd><p>When a con
9750: 73 74 72 61 69 6e 74 20 76 69 6f 6c 61 74 69 6f  straint violatio
9760: 6e 20 6f 63 63 75 72 73 2c 20 74 68 65 20 6f 6e  n occurs, the on
9770: 65 20 72 6f 77 20 74 68 61 74 20 63 6f 6e 74 61  e row that conta
9780: 69 6e 73 0a 74 68 65 20 63 6f 6e 73 74 72 61 69  ins.the constrai
9790: 6e 74 20 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20  nt violation is 
97a0: 6e 6f 74 20 69 6e 73 65 72 74 65 64 20 6f 72 20  not inserted or 
97b0: 63 68 61 6e 67 65 64 2e 20 20 42 75 74 20 74 68  changed.  But th
97c0: 65 20 63 6f 6d 6d 61 6e 64 0a 63 6f 6e 74 69 6e  e command.contin
97d0: 75 65 73 20 65 78 65 63 75 74 69 6e 67 20 6e 6f  ues executing no
97e0: 72 6d 61 6c 6c 79 2e 20 20 4f 74 68 65 72 20 72  rmally.  Other r
97f0: 6f 77 73 20 62 65 66 6f 72 65 20 61 6e 64 20 61  ows before and a
9800: 66 74 65 72 20 74 68 65 20 72 6f 77 20 74 68 61  fter the row tha
9810: 74 0a 63 6f 6e 74 61 69 6e 65 64 20 74 68 65 20  t.contained the 
9820: 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61  constraint viola
9830: 74 69 6f 6e 20 63 6f 6e 74 69 6e 75 65 20 74 6f  tion continue to
9840: 20 62 65 20 69 6e 73 65 72 74 65 64 20 6f 72 20   be inserted or 
9850: 75 70 64 61 74 65 64 0a 6e 6f 72 6d 61 6c 6c 79  updated.normally
9860: 2e 20 20 4e 6f 20 65 72 72 6f 72 20 69 73 20 72  .  No error is r
9870: 65 74 75 72 6e 65 64 2e 3c 2f 70 3e 3c 2f 64 64  eturned.</p></dd
9880: 3e 0a 0a 3c 64 74 3e 3c 62 3e 52 45 50 4c 41 43  >..<dt><b>REPLAC
9890: 45 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c  E</b></dt>.<dd><
98a0: 70 3e 57 68 65 6e 20 61 20 55 4e 49 51 55 45 20  p>When a UNIQUE 
98b0: 63 6f 6e 73 74 72 61 69 6e 74 20 76 69 6f 6c 61  constraint viola
98c0: 74 69 6f 6e 20 6f 63 63 75 72 73 2c 20 74 68 65  tion occurs, the
98d0: 20 70 72 65 2d 65 78 69 73 74 69 6e 67 20 72 6f   pre-existing ro
98e0: 77 0a 74 68 61 74 20 69 73 20 63 61 75 73 69 6e  w.that is causin
98f0: 67 20 74 68 65 20 63 6f 6e 73 74 72 61 69 6e 74  g the constraint
9900: 20 76 69 6f 6c 61 74 69 6f 6e 20 69 73 20 72 65   violation is re
9910: 6d 6f 76 65 64 20 70 72 69 6f 72 20 74 6f 20 69  moved prior to i
9920: 6e 73 65 72 74 69 6e 67 0a 6f 72 20 75 70 64 61  nserting.or upda
9930: 74 69 6e 67 20 74 68 65 20 63 75 72 72 65 6e 74  ting the current
9940: 20 72 6f 77 2e 20 20 54 68 75 73 20 74 68 65 20   row.  Thus the 
9950: 69 6e 73 65 72 74 20 6f 72 20 75 70 64 61 74 65  insert or update
9960: 20 61 6c 77 61 79 73 20 6f 63 63 75 72 73 2e 0a   always occurs..
9970: 54 68 65 20 63 6f 6d 6d 61 6e 64 20 63 6f 6e 74  The command cont
9980: 69 6e 75 65 73 20 65 78 65 63 75 74 69 6e 67 20  inues executing 
9990: 6e 6f 72 6d 61 6c 6c 79 2e 20 20 4e 6f 20 65 72  normally.  No er
99a0: 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64 2e  ror is returned.
99b0: 3c 2f 70 3e 0a 3c 70 3e 49 66 20 61 20 4e 4f 54  </p>.<p>If a NOT
99c0: 20 4e 55 4c 4c 20 63 6f 6e 73 74 72 61 69 6e 74   NULL constraint
99d0: 20 76 69 6f 6c 61 74 69 6f 6e 20 6f 63 63 75 72   violation occur
99e0: 73 2c 20 74 68 65 20 4e 55 4c 4c 20 76 61 6c 75  s, the NULL valu
99f0: 65 20 69 73 20 72 65 70 6c 61 63 65 64 0a 62 79  e is replaced.by
9a00: 20 74 68 65 20 64 65 66 61 75 6c 74 20 76 61 6c   the default val
9a10: 75 65 20 66 6f 72 20 74 68 61 74 20 63 6f 6c 75  ue for that colu
9a20: 6d 6e 2e 20 20 49 66 20 74 68 65 20 63 6f 6c 75  mn.  If the colu
9a30: 6d 6e 20 68 61 73 20 6e 6f 20 64 65 66 61 75 6c  mn has no defaul
9a40: 74 0a 76 61 6c 75 65 2c 20 74 68 65 6e 20 74 68  t.value, then th
9a50: 65 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74 68  e ABORT algorith
9a60: 6d 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a 3c  m is used.</p>.<
9a70: 2f 64 64 3e 0a 3c 2f 64 6c 3e 0a 0a 3c 70 3e 0a  /dd>.</dl>..<p>.
9a80: 54 68 65 20 63 6f 6e 66 6c 69 63 74 20 72 65 73  The conflict res
9a90: 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68  olution algorith
9aa0: 6d 20 63 61 6e 20 62 65 20 73 70 65 63 69 66 69  m can be specifi
9ab0: 65 64 20 69 6e 20 74 68 72 65 65 20 70 6c 61 63  ed in three plac
9ac0: 65 73 2c 0a 69 6e 20 6f 72 64 65 72 20 66 72 6f  es,.in order fro
9ad0: 6d 20 6c 6f 77 65 73 74 20 74 6f 20 68 69 67 68  m lowest to high
9ae0: 65 73 74 20 70 72 65 63 65 64 65 6e 63 65 3a 0a  est precedence:.
9af0: 3c 2f 70 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c  </p>..<ol>.<li><
9b00: 70 3e 0a 4f 6e 20 61 20 42 45 47 49 4e 20 54 52  p>.On a BEGIN TR
9b10: 41 4e 53 41 43 54 49 4f 4e 20 63 6f 6d 6d 61 6e  ANSACTION comman
9b20: 64 2e 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c  d..</p></li>..<l
9b30: 69 3e 3c 70 3e 0a 4f 6e 20 69 6e 64 69 76 69 64  i><p>.On individ
9b40: 75 61 6c 20 63 6f 6e 73 74 72 61 69 6e 74 73 20  ual constraints 
9b50: 77 69 74 68 69 6e 20 61 20 43 52 45 41 54 45 20  within a CREATE 
9b60: 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54 45 20  TABLE or CREATE 
9b70: 49 4e 44 45 58 0a 73 74 61 74 65 6d 65 6e 74 2e  INDEX.statement.
9b80: 0a 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e  .</p></li>..<li>
9b90: 3c 70 3e 0a 49 6e 20 74 68 65 20 4f 52 20 63 6c  <p>.In the OR cl
9ba0: 61 75 73 65 20 6f 66 20 61 20 43 4f 50 59 2c 20  ause of a COPY, 
9bb0: 49 4e 53 45 52 54 2c 20 6f 72 20 55 50 44 41 54  INSERT, or UPDAT
9bc0: 45 20 63 6f 6d 6d 61 6e 64 2e 0a 3c 2f 70 3e 3c  E command..</p><
9bd0: 2f 6c 69 3e 0a 3c 2f 6f 6c 3e 0a 0a 3c 70 3e 54  /li>.</ol>..<p>T
9be0: 68 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65  he algorithm spe
9bf0: 63 69 66 69 65 64 20 69 6e 20 74 68 65 20 4f 52  cified in the OR
9c00: 20 63 6c 61 75 73 65 20 6f 66 20 61 20 43 4f 50   clause of a COP
9c10: 59 2c 20 49 4e 53 45 52 54 2c 20 6f 72 20 55 50  Y, INSERT, or UP
9c20: 44 41 54 45 0a 6f 76 65 72 72 69 64 65 73 20 61  DATE.overrides a
9c30: 6e 79 20 61 6c 67 6f 72 69 74 68 6d 20 73 70 65  ny algorithm spe
9c40: 63 69 66 69 65 64 20 62 79 20 61 20 43 52 45 41  cified by a CREA
9c50: 54 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41  TE TABLE or CREA
9c60: 54 45 20 49 4e 44 45 58 2e 0a 54 68 65 20 61 6c  TE INDEX..The al
9c70: 67 6f 72 69 74 68 6d 20 73 70 65 63 69 66 69 65  gorithm specifie
9c80: 64 20 77 69 74 68 69 6e 20 61 20 43 52 45 41 54  d within a CREAT
9c90: 45 20 54 41 42 4c 45 20 6f 72 20 43 52 45 41 54  E TABLE or CREAT
9ca0: 45 20 49 4e 44 45 58 20 77 69 6c 6c 2c 20 69 6e  E INDEX will, in
9cb0: 20 74 75 72 6e 2c 0a 6f 76 65 72 72 69 64 65 20   turn,.override 
9cc0: 74 68 65 20 61 6c 67 6f 72 69 74 68 6d 20 73 70  the algorithm sp
9cd0: 65 63 69 66 69 65 64 20 62 79 20 61 20 42 45 47  ecified by a BEG
9ce0: 49 4e 20 54 52 41 4e 53 41 43 54 49 4f 4e 20 63  IN TRANSACTION c
9cf0: 6f 6d 6d 61 6e 64 2e 0a 49 66 20 6e 6f 20 61 6c  ommand..If no al
9d00: 67 6f 72 69 74 68 6d 20 69 73 20 73 70 65 63 69  gorithm is speci
9d10: 66 69 65 64 20 61 6e 79 77 68 65 72 65 2c 20 74  fied anywhere, t
9d20: 68 65 20 41 42 4f 52 54 20 61 6c 67 6f 72 69 74  he ABORT algorit
9d30: 68 6d 20 69 73 20 75 73 65 64 2e 3c 2f 70 3e 0a  hm is used.</p>.
9d40: 0a 7d 0a 23 20 3c 70 3e 46 6f 72 20 61 64 64 69  .}.# <p>For addi
9d50: 74 69 6f 6e 61 6c 20 69 6e 66 6f 72 6d 61 74 69  tional informati
9d60: 6f 6e 2c 20 73 65 65 20 0a 23 20 3c 61 20 68 72  on, see .# <a hr
9d70: 65 66 3d 22 63 6f 6e 66 6c 69 63 74 2e 68 74 6d  ef="conflict.htm
9d80: 6c 22 3e 63 6f 6e 66 6c 69 63 74 2e 68 74 6d 6c  l">conflict.html
9d90: 3c 2f 61 3e 2e 3c 2f 70 3e 0a 0a 0a 53 65 63 74  </a>.</p>...Sect
9da0: 69 6f 6e 20 50 52 41 47 4d 41 20 70 72 61 67 6d  ion PRAGMA pragm
9db0: 61 0a 0a 53 79 6e 74 61 78 20 7b 73 71 6c 2d 73  a..Syntax {sql-s
9dc0: 74 61 74 65 6d 65 6e 74 7d 20 7b 0a 50 52 41 47  tatement} {.PRAG
9dd0: 4d 41 20 3c 6e 61 6d 65 3e 20 5b 3d 20 3c 76 61  MA <name> [= <va
9de0: 6c 75 65 3e 5d 20 7c 0a 50 52 41 47 4d 41 20 3c  lue>] |.PRAGMA <
9df0: 66 75 6e 63 74 69 6f 6e 3e 28 3c 61 72 67 3e 29  function>(<arg>)
9e00: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
9e10: 65 20 50 52 41 47 4d 41 20 63 6f 6d 6d 61 6e 64  e PRAGMA command
9e20: 20 69 73 20 75 73 65 64 20 74 6f 20 6d 6f 64 69   is used to modi
9e30: 66 79 20 74 68 65 20 6f 70 65 72 61 74 69 6f 6e  fy the operation
9e40: 20 6f 66 20 74 68 65 20 53 51 4c 69 74 65 20 6c   of the SQLite l
9e50: 69 62 72 61 72 79 2e 0a 54 68 65 20 70 72 61 67  ibrary..The prag
9e60: 6d 61 20 63 6f 6d 6d 61 6e 64 20 69 73 20 65 78  ma command is ex
9e70: 70 65 72 69 6d 65 6e 74 61 6c 20 61 6e 64 20 73  perimental and s
9e80: 70 65 63 69 66 69 63 20 70 72 61 67 6d 61 20 73  pecific pragma s
9e90: 74 61 74 65 6d 65 6e 74 73 20 6d 61 79 20 62 65  tatements may be
9ea0: 0a 72 65 6d 6f 76 65 64 20 6f 72 20 61 64 64 65  .removed or adde
9eb0: 64 20 69 6e 20 66 75 74 75 72 65 20 72 65 6c 65  d in future rele
9ec0: 61 73 65 73 20 6f 66 20 53 51 4c 69 74 65 2e 20  ases of SQLite. 
9ed0: 20 55 73 65 20 74 68 69 73 20 63 6f 6d 6d 61 6e   Use this comman
9ee0: 64 0a 77 69 74 68 20 63 61 75 74 69 6f 6e 2e 3c  d.with caution.<
9ef0: 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 63 75 72 72  /p>..<p>The curr
9f00: 65 6e 74 20 69 6d 70 6c 65 6d 65 6e 74 61 74 69  ent implementati
9f10: 6f 6e 20 73 75 70 70 6f 72 74 73 20 74 68 65 20  on supports the 
9f20: 66 6f 6c 6c 6f 77 69 6e 67 20 70 72 61 67 6d 61  following pragma
9f30: 73 3a 3c 2f 70 3e 0a 0a 3c 75 6c 3e 0a 3c 6c 69  s:</p>..<ul>.<li
9f40: 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 63 61  ><p><b>PRAGMA ca
9f50: 63 68 65 5f 73 69 7a 65 3b 0a 20 20 20 20 20 20  che_size;.      
9f60: 20 3c 62 72 3e 50 52 41 47 4d 41 20 63 61 63 68   <br>PRAGMA cach
9f70: 65 5f 73 69 7a 65 20 3d 20 3c 2f 62 3e 3c 69 3e  e_size = </b><i>
9f80: 4e 75 6d 62 65 72 2d 6f 66 2d 70 61 67 65 73 3c  Number-of-pages<
9f90: 2f 69 3e 3c 62 3e 3b 3c 2f 62 3e 3c 2f 70 3e 0a  /i><b>;</b></p>.
9fa0: 20 20 20 20 3c 70 3e 51 75 65 72 79 20 6f 72 20      <p>Query or 
9fb0: 63 68 61 6e 67 65 20 74 68 65 20 6d 61 78 69 6d  change the maxim
9fc0: 75 6d 20 6e 75 6d 62 65 72 20 6f 66 20 64 61 74  um number of dat
9fd0: 61 62 61 73 65 20 64 69 73 6b 20 70 61 67 65 73  abase disk pages
9fe0: 20 74 68 61 74 20 53 51 4c 69 74 65 0a 20 20 20   that SQLite.   
9ff0: 20 77 69 6c 6c 20 68 6f 6c 64 20 69 6e 20 6d 65   will hold in me
a000: 6d 6f 72 79 20 61 74 20 6f 6e 63 65 2e 20 20 45  mory at once.  E
a010: 61 63 68 20 70 61 67 65 20 75 73 65 73 20 61 62  ach page uses ab
a020: 6f 75 74 20 31 2e 35 4b 20 6f 66 20 6d 65 6d 6f  out 1.5K of memo
a030: 72 79 2e 0a 20 20 20 20 54 68 65 20 64 65 66 61  ry..    The defa
a040: 75 6c 74 20 63 61 63 68 65 20 73 69 7a 65 20 69  ult cache size i
a050: 73 20 32 30 30 30 2e 20 20 49 66 20 79 6f 75 20  s 2000.  If you 
a060: 61 72 65 20 64 6f 69 6e 67 20 55 50 44 41 54 45  are doing UPDATE
a070: 73 20 6f 72 20 44 45 4c 45 54 45 73 0a 20 20 20  s or DELETEs.   
a080: 20 74 68 61 74 20 63 68 61 6e 67 65 20 6d 61 6e   that change man
a090: 79 20 72 6f 77 73 20 6f 66 20 61 20 64 61 74 61  y rows of a data
a0a0: 62 61 73 65 20 61 6e 64 20 79 6f 75 20 64 6f 20  base and you do 
a0b0: 6e 6f 74 20 6d 69 6e 64 20 69 66 20 53 51 4c 69  not mind if SQLi
a0c0: 74 65 0a 20 20 20 20 75 73 65 73 20 6d 6f 72 65  te.    uses more
a0d0: 20 6d 65 6d 6f 72 79 2c 20 79 6f 75 20 63 61 6e   memory, you can
a0e0: 20 69 6e 63 72 65 61 73 65 20 74 68 65 20 63 61   increase the ca
a0f0: 63 68 65 20 73 69 7a 65 20 66 6f 72 20 61 20 70  che size for a p
a100: 6f 73 73 69 62 6c 65 20 73 70 65 65 64 0a 20 20  ossible speed.  
a110: 20 20 69 6d 70 72 6f 76 65 6d 65 6e 74 2e 3c 2f    improvement.</
a120: 70 3e 0a 20 20 20 20 3c 70 3e 57 68 65 6e 20 79  p>.    <p>When y
a130: 6f 75 20 63 68 61 6e 67 65 20 74 68 65 20 63 61  ou change the ca
a140: 63 68 65 20 73 69 7a 65 20 75 73 69 6e 67 20 74  che size using t
a150: 68 65 20 63 61 63 68 65 5f 73 69 7a 65 20 70 72  he cache_size pr
a160: 61 67 6d 61 2c 20 74 68 65 0a 20 20 20 20 63 68  agma, the.    ch
a170: 61 6e 67 65 20 6f 6e 6c 79 20 65 6e 64 75 72 65  ange only endure
a180: 73 20 66 6f 72 20 74 68 65 20 63 75 72 72 65 6e  s for the curren
a190: 74 20 73 65 73 73 69 6f 6e 2e 20 20 54 68 65 20  t session.  The 
a1a0: 63 61 63 68 65 20 73 69 7a 65 20 72 65 76 65 72  cache size rever
a1b0: 74 73 0a 20 20 20 20 74 6f 20 74 68 65 20 64 65  ts.    to the de
a1c0: 66 61 75 6c 74 20 76 61 6c 75 65 20 77 68 65 6e  fault value when
a1d0: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 69 73   the database is
a1e0: 20 63 6c 6f 73 65 64 20 61 6e 64 20 72 65 6f 70   closed and reop
a1f0: 65 6e 65 64 2e 20 20 55 73 65 0a 20 20 20 20 74  ened.  Use.    t
a200: 68 65 20 3c 62 3e 64 65 66 61 75 6c 74 5f 63 61  he <b>default_ca
a210: 63 68 65 5f 73 69 7a 65 3c 2f 62 3e 20 70 72 61  che_size</b> pra
a220: 67 6d 61 20 74 6f 20 63 68 65 63 6b 20 74 68 65  gma to check the
a230: 20 63 61 63 68 65 20 73 69 7a 65 20 70 65 72 6d   cache size perm
a240: 61 6e 65 6e 74 6c 79 0a 20 20 20 20 3c 2f 70 3e  anently.    </p>
a250: 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62  </li>..<li><p><b
a260: 3e 50 52 41 47 4d 41 20 63 6f 75 6e 74 5f 63 68  >PRAGMA count_ch
a270: 61 6e 67 65 73 20 3d 20 4f 4e 3b 0a 20 20 20 20  anges = ON;.    
a280: 20 20 20 3c 62 72 3e 50 52 41 47 4d 41 20 63 6f     <br>PRAGMA co
a290: 75 6e 74 5f 63 68 61 6e 67 65 73 20 3d 20 4f 46  unt_changes = OF
a2a0: 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c  F;</b></p>.    <
a2b0: 70 3e 57 68 65 6e 20 6f 6e 2c 20 74 68 65 20 43  p>When on, the C
a2c0: 4f 55 4e 54 5f 43 48 41 4e 47 45 53 20 70 72 61  OUNT_CHANGES pra
a2d0: 67 6d 61 20 63 61 75 73 65 73 20 74 68 65 20 63  gma causes the c
a2e0: 61 6c 6c 62 61 63 6b 20 66 75 6e 63 74 69 6f 6e  allback function
a2f0: 20 74 6f 0a 20 20 20 20 62 65 20 69 6e 76 6f 6b   to.    be invok
a300: 65 64 20 6f 6e 63 65 20 66 6f 72 20 65 61 63 68  ed once for each
a310: 20 44 45 4c 45 54 45 2c 20 49 4e 53 45 52 54 2c   DELETE, INSERT,
a320: 20 6f 72 20 55 50 44 41 54 45 20 6f 70 65 72 61   or UPDATE opera
a330: 74 69 6f 6e 2e 20 20 54 68 65 0a 20 20 20 20 61  tion.  The.    a
a340: 72 67 75 6d 65 6e 74 20 69 73 20 74 68 65 20 6e  rgument is the n
a350: 75 6d 62 65 72 20 6f 66 20 72 6f 77 73 20 74 68  umber of rows th
a360: 61 74 20 77 65 72 65 20 63 68 61 6e 67 65 64 2e  at were changed.
a370: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 54 68 69 73  </p>.    <p>This
a380: 20 70 72 61 67 6d 61 20 6d 61 79 20 62 65 20 72   pragma may be r
a390: 65 6d 6f 76 65 64 20 66 72 6f 6d 20 66 75 74 75  emoved from futu
a3a0: 72 65 20 76 65 72 73 69 6f 6e 73 20 6f 66 20 53  re versions of S
a3b0: 51 4c 69 74 65 2e 0a 20 20 20 20 43 6f 6e 73 69  QLite..    Consi
a3c0: 64 65 72 20 75 73 69 6e 67 20 74 68 65 20 3c 62  der using the <b
a3d0: 3e 73 71 6c 69 74 65 5f 63 68 61 6e 67 65 73 28  >sqlite_changes(
a3e0: 29 3c 2f 62 3e 20 41 50 49 20 66 75 6e 63 74 69  )</b> API functi
a3f0: 6f 6e 20 69 6e 73 74 65 61 64 2e 3c 2f 70 3e 3c  on instead.</p><
a400: 2f 6c 69 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  /li>..<li><p><b>
a410: 50 52 41 47 4d 41 20 64 65 66 61 75 6c 74 5f 63  PRAGMA default_c
a420: 61 63 68 65 5f 73 69 7a 65 3b 0a 20 20 20 20 20  ache_size;.     
a430: 20 20 3c 62 72 3e 50 52 41 47 4d 41 20 64 65 66    <br>PRAGMA def
a440: 61 75 6c 74 5f 63 61 63 68 65 5f 73 69 7a 65 20  ault_cache_size 
a450: 3d 20 3c 2f 62 3e 3c 69 3e 4e 75 6d 62 65 72 2d  = </b><i>Number-
a460: 6f 66 2d 70 61 67 65 73 3c 2f 69 3e 3c 62 3e 3b  of-pages</i><b>;
a470: 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e  </b></p>.    <p>
a480: 51 75 65 72 79 20 6f 72 20 63 68 61 6e 67 65 20  Query or change 
a490: 74 68 65 20 6d 61 78 69 6d 75 6d 20 6e 75 6d 62  the maximum numb
a4a0: 65 72 20 6f 66 20 64 61 74 61 62 61 73 65 20 64  er of database d
a4b0: 69 73 6b 20 70 61 67 65 73 20 74 68 61 74 20 53  isk pages that S
a4c0: 51 4c 69 74 65 0a 20 20 20 20 77 69 6c 6c 20 68  QLite.    will h
a4d0: 6f 6c 64 20 69 6e 20 6d 65 6d 6f 72 79 20 61 74  old in memory at
a4e0: 20 6f 6e 63 65 2e 20 20 45 61 63 68 20 70 61 67   once.  Each pag
a4f0: 65 20 75 73 65 73 20 61 62 6f 75 74 20 31 2e 35  e uses about 1.5
a500: 4b 20 6f 66 20 6d 65 6d 6f 72 79 2e 0a 20 20 20  K of memory..   
a510: 20 54 68 69 73 20 70 72 61 67 6d 61 20 77 6f 72   This pragma wor
a520: 6b 73 20 6c 69 6b 65 20 74 68 65 20 3c 62 3e 63  ks like the <b>c
a530: 61 63 68 65 5f 73 69 7a 65 3c 2f 62 3e 20 70 72  ache_size</b> pr
a540: 61 67 6d 61 20 77 69 74 68 20 74 68 65 20 61 64  agma with the ad
a550: 64 69 74 69 6f 6e 0a 20 20 20 20 66 65 61 74 75  dition.    featu
a560: 72 65 20 74 68 61 74 20 69 74 20 63 68 61 6e 67  re that it chang
a570: 65 73 20 74 68 65 20 63 61 63 68 65 20 73 69 7a  es the cache siz
a580: 65 20 70 65 72 73 69 73 74 65 6e 74 6c 79 2e 20  e persistently. 
a590: 20 57 69 74 68 20 74 68 69 73 20 70 72 61 67 6d   With this pragm
a5a0: 61 2c 0a 20 20 20 20 79 6f 75 20 63 61 6e 20 73  a,.    you can s
a5b0: 65 74 20 74 68 65 20 63 61 63 68 65 20 73 69 7a  et the cache siz
a5c0: 65 20 6f 6e 63 65 20 61 6e 64 20 74 68 61 74 20  e once and that 
a5d0: 73 65 74 74 69 6e 67 20 69 73 20 72 65 74 61 69  setting is retai
a5e0: 6e 65 64 20 61 6e 64 20 72 65 75 73 65 64 0a 20  ned and reused. 
a5f0: 20 20 20 65 76 65 72 79 74 69 6d 65 20 79 6f 75     everytime you
a600: 20 72 65 6f 70 65 6e 20 74 68 65 20 64 61 74 61   reopen the data
a610: 62 61 73 65 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a  base.</p></li>..
a620: 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41  <li><p><b>PRAGMA
a630: 20 64 65 66 61 75 6c 74 5f 73 79 6e 63 68 72 6f   default_synchro
a640: 6e 6f 75 73 3b 0a 20 20 20 20 20 20 20 3c 62 72  nous;.       <br
a650: 3e 50 52 41 47 4d 41 20 64 65 66 61 75 6c 74 5f  >PRAGMA default_
a660: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 3d 20 46 55  synchronous = FU
a670: 4c 4c 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e 50  LL;.       <br>P
a680: 52 41 47 4d 41 20 64 65 66 61 75 6c 74 5f 73 79  RAGMA default_sy
a690: 6e 63 68 72 6f 6e 6f 75 73 20 3d 20 4e 4f 52 4d  nchronous = NORM
a6a0: 41 4c 3b 0a 20 20 20 20 20 20 20 3c 62 72 3e 50  AL;.       <br>P
a6b0: 52 41 47 4d 41 20 64 65 66 61 75 6c 74 5f 73 79  RAGMA default_sy
a6c0: 6e 63 68 72 6f 6e 6f 75 73 20 3d 20 4f 46 46 3b  nchronous = OFF;
a6d0: 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e  </b></p>.    <p>
a6e0: 51 75 65 72 79 20 6f 72 20 63 68 61 6e 67 65 20  Query or change 
a6f0: 74 68 65 20 73 65 74 74 69 6e 67 20 6f 66 20 74  the setting of t
a700: 68 65 20 22 73 79 6e 63 68 72 6f 6e 6f 75 73 22  he "synchronous"
a710: 20 66 6c 61 67 20 69 6e 0a 20 20 20 20 74 68 65   flag in.    the
a720: 20 64 61 74 61 62 61 73 65 2e 20 20 57 68 65 6e   database.  When
a730: 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 69 73 20   synchronous is 
a740: 46 55 4c 4c 2c 20 74 68 65 20 53 51 4c 69 74 65  FULL, the SQLite
a750: 20 64 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65   database engine
a760: 20 77 69 6c 6c 0a 20 20 20 20 70 61 75 73 65 20   will.    pause 
a770: 61 74 20 63 72 69 74 69 63 61 6c 20 6d 6f 6d 65  at critical mome
a780: 6e 74 73 20 74 6f 20 6d 61 6b 65 20 73 75 72 65  nts to make sure
a790: 20 74 68 61 74 20 64 61 74 61 20 68 61 73 20 61   that data has a
a7a0: 63 74 75 61 6c 6c 79 20 62 65 65 6e 20 0a 20 20  ctually been .  
a7b0: 20 20 77 72 69 74 74 65 6e 20 74 6f 20 74 68 65    written to the
a7c0: 20 64 69 73 6b 20 73 75 72 66 61 63 65 20 62 65   disk surface be
a7d0: 66 6f 72 65 20 63 6f 6e 74 69 6e 75 69 6e 67 2e  fore continuing.
a7e0: 20 20 54 68 69 73 20 65 6e 73 75 72 65 73 20 74    This ensures t
a7f0: 68 61 74 20 69 66 0a 20 20 20 20 74 68 65 20 6f  hat if.    the o
a800: 70 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 20  perating system 
a810: 63 72 61 73 68 65 73 20 6f 72 20 69 66 20 74 68  crashes or if th
a820: 65 72 65 20 69 73 20 61 20 70 6f 77 65 72 20 66  ere is a power f
a830: 61 69 6c 75 72 65 2c 20 74 68 65 20 64 61 74 61  ailure, the data
a840: 62 61 73 65 0a 20 20 20 20 77 69 6c 6c 20 62 65  base.    will be
a850: 20 75 6e 63 6f 72 72 75 70 74 65 64 20 61 66 74   uncorrupted aft
a860: 65 72 20 72 65 62 6f 6f 74 69 6e 67 2e 20 20 46  er rebooting.  F
a870: 55 4c 4c 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20  ULL synchronous 
a880: 69 73 20 76 65 72 79 20 0a 20 20 20 20 73 61 66  is very .    saf
a890: 65 2c 20 62 75 74 20 69 74 20 69 73 20 61 6c 73  e, but it is als
a8a0: 6f 20 73 6c 6f 77 2e 20 20 0a 20 20 20 20 57 68  o slow.  .    Wh
a8b0: 65 6e 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 69  en synchronous i
a8c0: 73 20 4e 4f 52 4d 41 4c 20 28 74 68 65 20 64 65  s NORMAL (the de
a8d0: 66 61 75 6c 74 29 2c 20 74 68 65 20 53 51 4c 69  fault), the SQLi
a8e0: 74 65 20 64 61 74 61 62 61 73 65 0a 20 20 20 20  te database.    
a8f0: 65 6e 67 69 6e 65 20 77 69 6c 6c 20 73 74 69 6c  engine will stil
a900: 6c 20 70 61 75 73 65 20 61 74 20 74 68 65 20 6d  l pause at the m
a910: 6f 73 74 20 63 72 69 74 69 63 61 6c 20 6d 6f 6d  ost critical mom
a920: 65 6e 74 73 2c 20 62 75 74 20 6c 65 73 73 20 6f  ents, but less o
a930: 66 74 65 6e 0a 20 20 20 20 74 68 61 6e 20 69 6e  ften.    than in
a940: 20 46 55 4c 4c 20 6d 6f 64 65 2e 20 20 54 68 65   FULL mode.  The
a950: 72 65 20 69 73 20 61 20 76 65 72 79 20 73 6d 61  re is a very sma
a960: 6c 6c 20 28 74 68 6f 75 67 68 20 6e 6f 6e 2d 7a  ll (though non-z
a970: 65 72 6f 29 20 63 68 61 6e 63 65 20 74 68 61 74  ero) chance that
a980: 0a 20 20 20 20 61 20 70 6f 77 65 72 20 66 61 69  .    a power fai
a990: 6c 75 72 65 20 61 74 20 6a 75 73 74 20 74 68 65  lure at just the
a9a0: 20 77 72 6f 6e 67 20 74 69 6d 65 20 63 6f 75 6c   wrong time coul
a9b0: 64 20 63 6f 72 72 75 70 74 20 74 68 65 20 64 61  d corrupt the da
a9c0: 74 61 62 61 73 65 20 69 6e 0a 20 20 20 20 4e 4f  tabase in.    NO
a9d0: 52 4d 41 4c 20 6d 6f 64 65 2e 20 20 42 75 74 20  RMAL mode.  But 
a9e0: 69 6e 20 70 72 61 63 74 69 63 65 2c 20 79 6f 75  in practice, you
a9f0: 20 61 72 65 20 6d 6f 72 65 20 6c 69 6b 65 6c 79   are more likely
aa00: 20 74 6f 20 73 75 66 66 65 72 0a 20 20 20 20 61   to suffer.    a
aa10: 20 63 61 74 61 73 74 72 6f 70 68 69 63 20 64 69   catastrophic di
aa20: 73 6b 20 66 61 69 6c 75 72 65 20 6f 72 20 73 6f  sk failure or so
aa30: 6d 65 20 6f 74 68 65 72 20 75 6e 72 65 63 6f 76  me other unrecov
aa40: 65 72 61 62 6c 65 20 68 61 72 64 77 61 72 65 0a  erable hardware.
aa50: 20 20 20 20 66 61 75 6c 74 2e 20 20 53 6f 20 4e      fault.  So N
aa60: 4f 52 4d 41 4c 20 69 73 20 74 68 65 20 64 65 66  ORMAL is the def
aa70: 61 75 6c 74 20 6d 6f 64 65 2e 0a 20 20 20 20 57  ault mode..    W
aa80: 69 74 68 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20  ith synchronous 
aa90: 4f 46 46 2c 20 53 51 4c 69 74 65 20 63 6f 6e 74  OFF, SQLite cont
aaa0: 69 6e 75 65 73 20 77 69 74 68 6f 75 74 20 70 61  inues without pa
aab0: 75 73 69 6e 67 0a 20 20 20 20 61 73 20 73 6f 6f  using.    as soo
aac0: 6e 20 61 73 20 69 74 20 68 61 73 20 68 61 6e 64  n as it has hand
aad0: 65 64 20 64 61 74 61 20 6f 66 66 20 74 6f 20 74  ed data off to t
aae0: 68 65 20 6f 70 65 72 61 74 69 6e 67 20 73 79 73  he operating sys
aaf0: 74 65 6d 2e 0a 20 20 20 20 49 66 20 74 68 65 20  tem..    If the 
ab00: 61 70 70 6c 69 63 61 74 69 6f 6e 20 72 75 6e 6e  application runn
ab10: 69 6e 67 20 53 51 4c 69 74 65 20 63 72 61 73 68  ing SQLite crash
ab20: 65 73 2c 20 74 68 65 20 64 61 74 61 20 77 69 6c  es, the data wil
ab30: 6c 20 62 65 20 73 61 66 65 2c 20 62 75 74 0a 20  l be safe, but. 
ab40: 20 20 20 74 68 65 20 64 61 74 61 62 61 73 65 20     the database 
ab50: 6d 69 67 68 74 20 62 65 63 6f 6d 65 20 63 6f 72  might become cor
ab60: 72 75 70 74 65 64 20 69 66 20 74 68 65 20 6f 70  rupted if the op
ab70: 65 72 61 74 69 6e 67 20 73 79 73 74 65 6d 0a 20  erating system. 
ab80: 20 20 20 63 72 61 73 68 65 73 20 6f 72 20 74 68     crashes or th
ab90: 65 20 63 6f 6d 70 75 74 65 72 20 6c 6f 73 65 73  e computer loses
aba0: 20 70 6f 77 65 72 20 62 65 66 6f 72 65 20 74 68   power before th
abb0: 61 74 20 64 61 74 61 20 68 61 73 20 62 65 65 6e  at data has been
abc0: 20 77 72 69 74 74 65 6e 0a 20 20 20 20 74 6f 20   written.    to 
abd0: 74 68 65 20 64 69 73 6b 20 73 75 72 66 61 63 65  the disk surface
abe0: 2e 20 20 4f 6e 20 74 68 65 20 6f 74 68 65 72 20  .  On the other 
abf0: 68 61 6e 64 2c 20 73 6f 6d 65 0a 20 20 20 20 6f  hand, some.    o
ac00: 70 65 72 61 74 69 6f 6e 73 20 61 72 65 20 61 73  perations are as
ac10: 20 6d 75 63 68 20 61 73 20 35 30 20 6f 72 20 6d   much as 50 or m
ac20: 6f 72 65 20 74 69 6d 65 73 20 66 61 73 74 65 72  ore times faster
ac30: 20 77 69 74 68 20 73 79 6e 63 68 72 6f 6e 6f 75   with synchronou
ac40: 73 20 4f 46 46 2e 0a 20 20 20 20 3c 2f 70 3e 0a  s OFF..    </p>.
ac50: 20 20 20 20 3c 70 3e 54 68 69 73 20 70 72 61 67      <p>This prag
ac60: 6d 61 20 63 68 61 6e 67 65 73 20 74 68 65 20 73  ma changes the s
ac70: 79 6e 63 68 72 6f 6e 6f 75 73 20 6d 6f 64 65 20  ynchronous mode 
ac80: 70 65 72 73 69 73 74 65 6e 74 6c 79 2e 20 20 4f  persistently.  O
ac90: 6e 63 65 20 63 68 61 6e 67 65 64 2c 0a 20 20 20  nce changed,.   
aca0: 20 74 68 65 20 6d 6f 64 65 20 73 74 61 79 73 20   the mode stays 
acb0: 61 73 20 73 65 74 20 65 76 65 6e 20 69 66 20 74  as set even if t
acc0: 68 65 20 64 61 74 61 62 61 73 65 20 69 73 20 63  he database is c
acd0: 6c 6f 73 65 64 20 61 6e 64 20 72 65 6f 70 65 6e  losed and reopen
ace0: 65 64 2e 20 20 54 68 65 0a 20 20 20 20 3c 62 3e  ed.  The.    <b>
acf0: 73 79 6e 63 68 72 6f 6e 6f 75 73 3c 2f 62 3e 20  synchronous</b> 
ad00: 70 72 61 67 6d 61 20 64 6f 65 73 20 74 68 65 20  pragma does the 
ad10: 73 61 6d 65 20 74 68 69 6e 67 20 62 75 74 20 6f  same thing but o
ad20: 6e 6c 79 20 61 70 70 6c 69 65 73 20 74 68 65 20  nly applies the 
ad30: 73 65 74 74 69 6e 67 0a 20 20 20 20 74 6f 20 74  setting.    to t
ad40: 68 65 20 63 75 72 72 65 6e 74 20 73 65 73 73 69  he current sessi
ad50: 6f 6e 2e 3c 2f 70 3e 0a 0a 3c 61 20 6e 61 6d 65  on.</p>..<a name
ad60: 3d 22 70 72 61 67 6d 61 5f 65 6d 70 74 79 5f 72  ="pragma_empty_r
ad70: 65 73 75 6c 74 5f 63 61 6c 6c 62 61 63 6b 73 22  esult_callbacks"
ad80: 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47  >.<li><p><b>PRAG
ad90: 4d 41 20 65 6d 70 74 79 5f 72 65 73 75 6c 74 5f  MA empty_result_
ada0: 63 61 6c 6c 62 61 63 6b 73 20 3d 20 4f 4e 3b 0a  callbacks = ON;.
adb0: 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d         <br>PRAGM
adc0: 41 20 65 6d 70 74 79 5f 72 65 73 75 6c 74 5f 63  A empty_result_c
add0: 61 6c 6c 62 61 63 6b 73 20 3d 20 4f 46 46 3b 3c  allbacks = OFF;<
ade0: 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 57  /b></p>.    <p>W
adf0: 68 65 6e 20 6f 6e 2c 20 74 68 65 20 45 4d 50 54  hen on, the EMPT
ae00: 59 5f 52 45 53 55 4c 54 5f 43 41 4c 4c 42 41 43  Y_RESULT_CALLBAC
ae10: 4b 53 20 70 72 61 67 6d 61 20 63 61 75 73 65 73  KS pragma causes
ae20: 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 0a 20 20   the callback.  
ae30: 20 20 66 75 6e 63 74 69 6f 6e 20 74 6f 20 62 65    function to be
ae40: 20 69 6e 76 6f 6b 65 64 20 6f 6e 63 65 20 66 6f   invoked once fo
ae50: 72 20 65 61 63 68 20 71 75 65 72 79 20 74 68 61  r each query tha
ae60: 74 20 68 61 73 20 61 6e 20 65 6d 70 74 79 20 72  t has an empty r
ae70: 65 73 75 6c 74 0a 20 20 20 20 73 65 74 2e 20 20  esult.    set.  
ae80: 54 68 65 20 74 68 69 72 64 20 22 3c 62 3e 61 72  The third "<b>ar
ae90: 67 76 3c 2f 62 3e 22 20 70 61 72 61 6d 65 74 65  gv</b>" paramete
aea0: 72 20 74 6f 20 74 68 65 20 63 61 6c 6c 62 61 63  r to the callbac
aeb0: 6b 20 69 73 20 73 65 74 20 74 6f 20 4e 55 4c 4c  k is set to NULL
aec0: 0a 20 20 20 20 62 65 63 61 75 73 65 20 74 68 65  .    because the
aed0: 72 65 20 69 73 20 6e 6f 20 64 61 74 61 20 74 6f  re is no data to
aee0: 20 72 65 70 6f 72 74 2e 20 20 42 75 74 20 74 68   report.  But th
aef0: 65 20 73 65 63 6f 6e 64 20 22 3c 62 3e 61 72 67  e second "<b>arg
af00: 63 3c 2f 62 3e 22 20 61 6e 64 0a 20 20 20 20 66  c</b>" and.    f
af10: 6f 75 72 74 68 20 22 3c 62 3e 63 6f 6c 75 6d 6e  ourth "<b>column
af20: 4e 61 6d 65 73 3c 2f 62 3e 22 20 70 61 72 61 6d  Names</b>" param
af30: 65 74 65 72 73 20 61 72 65 20 76 61 6c 69 64 20  eters are valid 
af40: 61 6e 64 20 63 61 6e 20 62 65 20 75 73 65 64 20  and can be used 
af50: 74 6f 0a 20 20 20 20 64 65 74 65 72 6d 69 6e 65  to.    determine
af60: 20 74 68 65 20 6e 75 6d 62 65 72 20 61 6e 64 20   the number and 
af70: 6e 61 6d 65 73 20 6f 66 20 74 68 65 20 63 6f 6c  names of the col
af80: 75 6d 6e 73 20 74 68 61 74 20 77 6f 75 6c 64 20  umns that would 
af90: 68 61 76 65 20 62 65 65 6e 20 69 6e 0a 20 20 20  have been in.   
afa0: 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 20   the result set 
afb0: 68 61 64 20 74 68 65 20 73 65 74 20 6e 6f 74 20  had the set not 
afc0: 62 65 65 6e 20 65 6d 70 74 79 2e 3c 2f 70 3e 0a  been empty.</p>.
afd0: 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d  .<li><p><b>PRAGM
afe0: 41 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e 5f 6e 61  A full_column_na
aff0: 6d 65 73 20 3d 20 4f 4e 3b 0a 20 20 20 20 20 20  mes = ON;.      
b000: 20 3c 62 72 3e 50 52 41 47 4d 41 20 66 75 6c 6c   <br>PRAGMA full
b010: 5f 63 6f 6c 75 6d 6e 5f 6e 61 6d 65 73 20 3d 20  _column_names = 
b020: 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  OFF;</b></p>.   
b030: 20 3c 70 3e 54 68 65 20 63 6f 6c 75 6d 6e 20 6e   <p>The column n
b040: 61 6d 65 73 20 72 65 70 6f 72 74 65 64 20 69 6e  ames reported in
b050: 20 61 6e 20 53 51 4c 69 74 65 20 63 61 6c 6c 62   an SQLite callb
b060: 61 63 6b 20 61 72 65 20 6e 6f 72 6d 61 6c 6c 79  ack are normally
b070: 20 6a 75 73 74 0a 20 20 20 20 74 68 65 20 6e 61   just.    the na
b080: 6d 65 20 6f 66 20 74 68 65 20 63 6f 6c 75 6d 6e  me of the column
b090: 20 69 74 73 65 6c 66 2c 20 65 78 63 65 70 74 20   itself, except 
b0a0: 66 6f 72 20 6a 6f 69 6e 73 20 77 68 65 6e 20 22  for joins when "
b0b0: 54 41 42 4c 45 2e 43 4f 4c 55 4d 4e 22 0a 20 20  TABLE.COLUMN".  
b0c0: 20 20 69 73 20 75 73 65 64 2e 20 20 42 75 74 20    is used.  But 
b0d0: 77 68 65 6e 20 66 75 6c 6c 5f 63 6f 6c 75 6d 6e  when full_column
b0e0: 5f 6e 61 6d 65 73 20 69 73 20 74 75 72 6e 65 64  _names is turned
b0f0: 20 6f 6e 2c 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65   on, column name
b100: 73 20 61 72 65 0a 20 20 20 20 61 6c 77 61 79 73  s are.    always
b110: 20 72 65 70 6f 72 74 65 64 20 61 73 20 22 54 41   reported as "TA
b120: 42 4c 45 2e 43 4f 4c 55 4d 4e 22 20 65 76 65 6e  BLE.COLUMN" even
b130: 20 66 6f 72 20 73 69 6d 70 6c 65 20 71 75 65 72   for simple quer
b140: 69 65 73 2e 3c 2f 70 3e 3c 2f 6c 69 3e 0a 0a 3c  ies.</p></li>..<
b150: 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20  li><p><b>PRAGMA 
b160: 69 6e 64 65 78 5f 69 6e 66 6f 28 3c 2f 62 3e 3c  index_info(</b><
b170: 69 3e 69 6e 64 65 78 2d 6e 61 6d 65 3c 2f 69 3e  i>index-name</i>
b180: 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20  <b>);</b></p>.  
b190: 20 20 3c 70 3e 46 6f 72 20 65 61 63 68 20 63 6f    <p>For each co
b1a0: 6c 75 6d 6e 20 74 68 61 74 20 74 68 65 20 6e 61  lumn that the na
b1b0: 6d 65 64 20 69 6e 64 65 78 20 72 65 66 65 72 65  med index refere
b1c0: 6e 63 65 73 2c 20 69 6e 76 6f 6b 65 20 74 68 65  nces, invoke the
b1d0: 20 0a 20 20 20 20 63 61 6c 6c 62 61 63 6b 20 66   .    callback f
b1e0: 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f 6e 63 65  unction.    once
b1f0: 20 77 69 74 68 20 69 6e 66 6f 72 6d 61 74 69 6f   with informatio
b200: 6e 20 61 62 6f 75 74 20 74 68 61 74 20 63 6f 6c  n about that col
b210: 75 6d 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 20 74  umn, including t
b220: 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 2c 0a  he column name,.
b230: 20 20 20 20 61 6e 64 20 74 68 65 20 63 6f 6c 75      and the colu
b240: 6d 6e 20 6e 75 6d 62 65 72 2e 3c 2f 70 3e 0a 0a  mn number.</p>..
b250: 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d 41  <li><p><b>PRAGMA
b260: 20 69 6e 64 65 78 5f 6c 69 73 74 28 3c 2f 62 3e   index_list(</b>
b270: 3c 69 3e 74 61 62 6c 65 2d 6e 61 6d 65 3c 2f 69  <i>table-name</i
b280: 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20  ><b>);</b></p>. 
b290: 20 20 20 3c 70 3e 46 6f 72 20 65 61 63 68 20 69     <p>For each i
b2a0: 6e 64 65 78 20 6f 6e 20 74 68 65 20 6e 61 6d 65  ndex on the name
b2b0: 64 20 74 61 62 6c 65 2c 20 69 6e 76 6f 6b 65 20  d table, invoke 
b2c0: 74 68 65 20 63 61 6c 6c 62 61 63 6b 20 66 75 6e  the callback fun
b2d0: 63 74 69 6f 6e 0a 20 20 20 20 6f 6e 63 65 20 77  ction.    once w
b2e0: 69 74 68 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20  ith information 
b2f0: 61 62 6f 75 74 20 74 68 61 74 20 69 6e 64 65 78  about that index
b300: 2e 20 20 41 72 67 75 6d 65 6e 74 73 20 69 6e 63  .  Arguments inc
b310: 6c 75 64 65 20 74 68 65 0a 20 20 20 20 69 6e 64  lude the.    ind
b320: 65 78 20 6e 61 6d 65 20 61 6e 64 20 61 20 66 6c  ex name and a fl
b330: 61 67 20 74 6f 20 69 6e 64 69 63 61 74 65 20 77  ag to indicate w
b340: 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74 68  hether or not th
b350: 65 20 69 6e 64 65 78 20 6d 75 73 74 20 62 65 0a  e index must be.
b360: 20 20 20 20 75 6e 69 71 75 65 2e 3c 2f 70 3e 0a      unique.</p>.
b370: 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47 4d  .<li><p><b>PRAGM
b380: 41 20 70 61 72 73 65 72 5f 74 72 61 63 65 20 3d  A parser_trace =
b390: 20 4f 4e 3b 3c 62 72 3e 50 52 41 47 4d 41 20 70   ON;<br>PRAGMA p
b3a0: 61 72 73 65 72 5f 74 72 61 63 65 20 3d 20 4f 46  arser_trace = OF
b3b0: 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20 3c  F;</b></p>.    <
b3c0: 70 3e 54 75 72 6e 20 74 72 61 63 69 6e 67 20 6f  p>Turn tracing o
b3d0: 66 20 74 68 65 20 53 51 4c 20 70 61 72 73 65 72  f the SQL parser
b3e0: 20 69 6e 73 69 64 65 20 6f 66 20 74 68 65 0a 20   inside of the. 
b3f0: 20 20 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72     SQLite librar
b400: 79 20 6f 6e 20 61 6e 64 20 6f 66 66 2e 20 20 54  y on and off.  T
b410: 68 69 73 20 69 73 20 75 73 65 64 20 66 6f 72 20  his is used for 
b420: 64 65 62 75 67 67 69 6e 67 2e 0a 20 20 20 20 54  debugging..    T
b430: 68 69 73 20 6f 6e 6c 79 20 77 6f 72 6b 73 20 69  his only works i
b440: 66 20 74 68 65 20 6c 69 62 72 61 72 79 20 69 73  f the library is
b450: 20 63 6f 6d 70 69 6c 65 64 20 77 69 74 68 6f 75   compiled withou
b460: 74 20 74 68 65 20 4e 44 45 42 55 47 20 6d 61 63  t the NDEBUG mac
b470: 72 6f 2e 0a 20 20 20 20 3c 2f 70 3e 3c 2f 6c 69  ro..    </p></li
b480: 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41  >..<li><p><b>PRA
b490: 47 4d 41 20 69 6e 74 65 67 72 69 74 79 5f 63 68  GMA integrity_ch
b4a0: 65 63 6b 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20  eck;</b></p>.   
b4b0: 20 3c 70 3e 54 68 65 20 63 6f 6d 6d 61 6e 64 20   <p>The command 
b4c0: 64 6f 65 73 20 61 6e 20 69 6e 74 65 67 72 69 74  does an integrit
b4d0: 79 20 63 68 65 63 6b 20 6f 66 20 74 68 65 20 65  y check of the e
b4e0: 6e 74 69 72 65 20 64 61 74 61 62 61 73 65 2e 20  ntire database. 
b4f0: 20 49 74 0a 20 20 20 20 6c 6f 6f 6b 73 20 66 6f   It.    looks fo
b500: 72 20 6f 75 74 2d 6f 66 2d 6f 72 64 65 72 20 72  r out-of-order r
b510: 65 63 6f 72 64 73 2c 20 6d 69 73 73 69 6e 67 20  ecords, missing 
b520: 70 61 67 65 73 2c 20 61 6e 64 20 6d 61 6c 66 6f  pages, and malfo
b530: 72 6d 65 64 20 72 65 63 6f 72 64 73 2e 0a 20 20  rmed records..  
b540: 20 20 49 66 20 61 6e 79 20 70 72 6f 62 6c 65 6d    If any problem
b550: 73 20 61 72 65 20 66 6f 75 6e 64 2c 20 74 68 65  s are found, the
b560: 6e 20 61 20 73 69 6e 67 6c 65 20 73 74 72 69 6e  n a single strin
b570: 67 20 69 73 20 72 65 74 75 72 6e 65 64 20 77 68  g is returned wh
b580: 69 63 68 20 69 73 0a 20 20 20 20 61 20 64 65 73  ich is.    a des
b590: 63 72 69 70 74 69 6f 6e 20 6f 66 20 61 6c 6c 20  cription of all 
b5a0: 70 72 6f 62 6c 65 6d 73 2e 20 20 49 66 20 65 76  problems.  If ev
b5b0: 65 72 79 74 68 69 6e 67 20 69 73 20 69 6e 20 6f  erything is in o
b5c0: 72 64 65 72 2c 20 22 6f 6b 22 20 69 73 0a 20 20  rder, "ok" is.  
b5d0: 20 20 72 65 74 75 72 6e 65 64 2e 3c 2f 70 3e 0a    returned.</p>.
b5e0: 0a 3c 61 20 6e 61 6d 65 3d 22 70 72 61 67 6d 61  .<a name="pragma
b5f0: 5f 73 68 6f 77 5f 64 61 74 61 74 79 70 65 73 22  _show_datatypes"
b600: 3e 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47  >.<li><p><b>PRAG
b610: 4d 41 20 73 68 6f 77 5f 64 61 74 61 74 79 70 65  MA show_datatype
b620: 73 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41 47 4d  s = ON;<br>PRAGM
b630: 41 20 73 68 6f 77 5f 64 61 74 61 74 79 70 65 73  A show_datatypes
b640: 20 3d 20 4f 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a   = OFF;</b></p>.
b650: 20 20 20 20 3c 70 3e 57 68 65 6e 20 74 75 72 6e      <p>When turn
b660: 65 64 20 6f 6e 2c 20 74 68 65 20 53 48 4f 57 5f  ed on, the SHOW_
b670: 44 41 54 41 54 59 50 45 53 20 70 72 61 67 6d 61  DATATYPES pragma
b680: 20 63 61 75 73 65 73 20 65 78 74 72 61 20 65 6e   causes extra en
b690: 74 72 69 65 73 20 63 6f 6e 74 61 69 6e 69 6e 67  tries containing
b6a0: 0a 20 20 20 20 74 68 65 20 6e 61 6d 65 73 20 6f  .    the names o
b6b0: 66 20 3c 61 20 68 72 65 66 3d 22 64 61 74 61 74  f <a href="datat
b6c0: 79 70 65 73 2e 68 74 6d 6c 22 3e 64 61 74 61 74  ypes.html">datat
b6d0: 79 70 65 73 3c 2f 61 3e 20 6f 66 20 63 6f 6c 75  ypes</a> of colu
b6e0: 6d 6e 73 20 74 6f 20 62 65 0a 20 20 20 20 61 70  mns to be.    ap
b6f0: 70 65 6e 64 65 64 20 74 6f 20 74 68 65 20 34 74  pended to the 4t
b700: 68 20 28 22 63 6f 6c 75 6d 6e 4e 61 6d 65 73 22  h ("columnNames"
b710: 29 20 61 72 67 75 6d 65 6e 74 20 74 6f 20 3c 62  ) argument to <b
b720: 3e 73 71 6c 69 74 65 5f 65 78 65 63 28 29 3c 2f  >sqlite_exec()</
b730: 62 3e 0a 20 20 20 20 63 61 6c 6c 62 61 63 6b 73  b>.    callbacks
b740: 2e 20 20 57 68 65 6e 0a 20 20 20 20 74 75 72 6e  .  When.    turn
b750: 65 64 20 6f 66 66 2c 20 74 68 65 20 34 74 68 20  ed off, the 4th 
b760: 61 72 67 75 6d 65 6e 74 20 74 6f 20 63 61 6c 6c  argument to call
b770: 62 61 63 6b 73 20 63 6f 6e 74 61 69 6e 73 20 6f  backs contains o
b780: 6e 6c 79 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6e  nly the column n
b790: 61 6d 65 73 2e 0a 20 20 20 20 54 68 65 20 64 61  ames..    The da
b7a0: 74 61 74 79 70 65 20 66 6f 72 20 74 61 62 6c 65  tatype for table
b7b0: 20 63 6f 6c 75 6d 6e 73 20 69 73 20 74 61 6b 65   columns is take
b7c0: 6e 20 66 72 6f 6d 20 74 68 65 20 43 52 45 41 54  n from the CREAT
b7d0: 45 20 54 41 42 4c 45 20 73 74 61 74 65 6d 65 6e  E TABLE statemen
b7e0: 74 0a 20 20 20 20 74 68 61 74 20 64 65 66 69 6e  t.    that defin
b7f0: 65 73 20 74 68 65 20 74 61 62 6c 65 2e 20 20 43  es the table.  C
b800: 6f 6c 75 6d 6e 73 20 77 69 74 68 20 61 6e 20 75  olumns with an u
b810: 6e 73 70 65 63 69 66 69 65 64 20 64 61 74 61 74  nspecified datat
b820: 79 70 65 20 68 61 76 65 20 61 0a 20 20 20 20 64  ype have a.    d
b830: 61 74 61 74 79 70 65 20 6f 66 20 22 4e 55 4d 45  atatype of "NUME
b840: 52 49 43 22 20 61 6e 64 20 74 68 65 20 72 65 73  RIC" and the res
b850: 75 6c 74 73 20 6f 66 20 65 78 70 72 65 73 73 69  ults of expressi
b860: 6f 6e 20 68 61 76 65 20 61 20 64 61 74 61 74 79  on have a dataty
b870: 70 65 20 6f 66 0a 20 20 20 20 65 69 74 68 65 72  pe of.    either
b880: 20 22 54 45 58 54 22 20 6f 72 20 22 4e 55 4d 45   "TEXT" or "NUME
b890: 52 49 43 22 20 64 65 70 65 6e 64 69 6e 67 20 6f  RIC" depending o
b8a0: 6e 20 74 68 65 20 65 78 70 72 65 73 73 69 6f 6e  n the expression
b8b0: 2e 0a 20 20 20 20 54 68 65 20 66 6f 6c 6c 6f 77  ..    The follow
b8c0: 69 6e 67 20 63 68 61 72 74 20 69 6c 6c 75 73 74  ing chart illust
b8d0: 72 61 74 65 73 20 74 68 65 20 64 69 66 66 65 72  rates the differ
b8e0: 65 6e 63 65 20 66 6f 72 20 74 68 65 20 71 75 65  ence for the que
b8f0: 72 79 0a 20 20 20 20 22 53 45 4c 45 43 54 20 27  ry.    "SELECT '
b900: 78 79 7a 7a 79 27 2c 20 35 2c 20 4e 55 4c 4c 20  xyzzy', 5, NULL 
b910: 41 53 20 65 6d 70 74 79 20 22 3a 3c 2f 70 3e 0a  AS empty ":</p>.
b920: 0a 20 20 20 20 3c 62 6c 6f 63 6b 71 75 6f 74 65  .    <blockquote
b930: 3e 3c 74 61 62 6c 65 20 62 6f 72 64 65 72 3d 30  ><table border=0
b940: 3e 0a 20 20 20 20 3c 74 72 3e 3c 74 68 3e 73 68  >.    <tr><th>sh
b950: 6f 77 5f 64 61 74 61 74 79 70 65 73 3d 4f 46 46  ow_datatypes=OFF
b960: 3c 2f 74 68 3e 3c 74 68 20 77 69 64 74 68 3d 33  </th><th width=3
b970: 30 3e 3c 2f 74 68 3e 0a 20 20 20 20 20 20 20 20  0></th>.        
b980: 3c 74 68 3e 73 68 6f 77 5f 64 61 74 61 74 79 70  <th>show_datatyp
b990: 65 73 3d 4f 4e 3c 2f 74 68 3e 3c 2f 74 72 3e 0a  es=ON</th></tr>.
b9a0: 20 20 20 20 3c 74 72 3e 3c 74 64 20 76 61 6c 69      <tr><td vali
b9b0: 67 6e 3d 22 74 6f 70 22 3e 0a 20 20 20 20 20 20  gn="top">.      
b9c0: 20 61 7a 43 6f 6c 5b 30 5d 20 3d 20 22 78 79 7a   azCol[0] = "xyz
b9d0: 7a 79 22 3b 3c 62 72 3e 0a 20 20 20 20 20 20 20  zy";<br>.       
b9e0: 61 7a 43 6f 6c 5b 31 5d 20 3d 20 22 35 22 3b 3c  azCol[1] = "5";<
b9f0: 62 72 3e 0a 20 20 20 20 20 20 20 61 7a 43 6f 6c  br>.       azCol
ba00: 5b 32 5d 20 3d 20 22 65 6d 70 74 79 22 3b 3c 62  [2] = "empty";<b
ba10: 72 3e 0a 20 20 20 20 20 20 20 61 7a 43 6f 6c 5b  r>.       azCol[
ba20: 33 5d 20 3d 20 30 3b 0a 20 20 20 20 3c 2f 74 64  3] = 0;.    </td
ba30: 3e 3c 74 64 3e 3c 2f 74 64 3e 3c 74 64 20 76 61  ><td></td><td va
ba40: 6c 69 67 6e 3d 22 74 6f 70 22 3e 0a 20 20 20 20  lign="top">.    
ba50: 20 20 20 61 7a 43 6f 6c 5b 30 5d 20 3d 20 22 78     azCol[0] = "x
ba60: 79 7a 7a 79 22 3b 3c 62 72 3e 0a 20 20 20 20 20  yzzy";<br>.     
ba70: 20 20 61 7a 43 6f 6c 5b 31 5d 20 3d 20 22 35 22    azCol[1] = "5"
ba80: 3b 3c 62 72 3e 0a 20 20 20 20 20 20 20 61 7a 43  ;<br>.       azC
ba90: 6f 6c 5b 32 5d 20 3d 20 22 65 6d 70 74 79 22 3b  ol[2] = "empty";
baa0: 3c 62 72 3e 0a 20 20 20 20 20 20 20 61 7a 43 6f  <br>.       azCo
bab0: 6c 5b 33 5d 20 3d 20 22 54 45 58 54 22 3b 3c 62  l[3] = "TEXT";<b
bac0: 72 3e 0a 20 20 20 20 20 20 20 61 7a 43 6f 6c 5b  r>.       azCol[
bad0: 34 5d 20 3d 20 22 4e 55 4d 45 52 49 43 22 3b 3c  4] = "NUMERIC";<
bae0: 62 72 3e 0a 20 20 20 20 20 20 20 61 7a 43 6f 6c  br>.       azCol
baf0: 5b 35 5d 20 3d 20 22 54 45 58 54 22 3b 3c 62 72  [5] = "TEXT";<br
bb00: 3e 0a 20 20 20 20 20 20 20 61 7a 43 6f 6c 5b 36  >.       azCol[6
bb10: 5d 20 3d 20 30 3b 0a 20 20 20 20 3c 2f 74 64 3e  ] = 0;.    </td>
bb20: 3c 2f 74 61 62 6c 65 3e 3c 2f 62 6c 6f 63 6b 71  </table></blockq
bb30: 75 6f 74 65 3e 3c 2f 6c 69 3e 0a 0a 3c 6c 69 3e  uote></li>..<li>
bb40: 3c 70 3e 3c 62 3e 50 52 41 47 4d 41 20 73 79 6e  <p><b>PRAGMA syn
bb50: 63 68 72 6f 6e 6f 75 73 3b 0a 20 20 20 20 20 20  chronous;.      
bb60: 20 3c 62 72 3e 50 52 41 47 4d 41 20 73 79 6e 63   <br>PRAGMA sync
bb70: 68 72 6f 6e 6f 75 73 20 3d 20 46 55 4c 4c 3b 0a  hronous = FULL;.
bb80: 20 20 20 20 20 20 20 3c 62 72 3e 50 52 41 47 4d         <br>PRAGM
bb90: 41 20 73 79 6e 63 68 72 6f 6e 6f 75 73 20 3d 20  A synchronous = 
bba0: 4e 4f 52 4d 41 4c 3b 0a 20 20 20 20 20 20 20 3c  NORMAL;.       <
bbb0: 62 72 3e 50 52 41 47 4d 41 20 73 79 6e 63 68 72  br>PRAGMA synchr
bbc0: 6f 6e 6f 75 73 20 3d 20 4f 46 46 3b 3c 2f 62 3e  onous = OFF;</b>
bbd0: 3c 2f 70 3e 0a 20 20 20 20 3c 70 3e 51 75 65 72  </p>.    <p>Quer
bbe0: 79 20 6f 72 20 63 68 61 6e 67 65 20 74 68 65 20  y or change the 
bbf0: 73 65 74 74 69 6e 67 20 6f 66 20 74 68 65 20 22  setting of the "
bc00: 73 79 6e 63 68 72 6f 6e 6f 75 73 22 20 66 6c 61  synchronous" fla
bc10: 67 20 69 6e 0a 20 20 20 20 74 68 65 20 64 61 74  g in.    the dat
bc20: 61 62 61 73 65 20 66 6f 72 20 74 68 65 20 64 75  abase for the du
bc30: 72 61 74 69 6f 6e 20 6f 66 20 74 68 65 20 63 75  ration of the cu
bc40: 72 72 65 6e 74 20 64 61 74 61 62 61 73 65 20 63  rrent database c
bc50: 6f 6e 6e 65 63 74 2e 0a 20 20 20 20 54 68 65 20  onnect..    The 
bc60: 73 79 6e 63 68 72 6f 6e 6f 75 73 20 66 6c 61 67  synchronous flag
bc70: 20 72 65 76 65 72 74 73 20 74 6f 20 69 74 73 20   reverts to its 
bc80: 64 65 66 61 75 6c 74 20 76 61 6c 75 65 20 77 68  default value wh
bc90: 65 6e 20 74 68 65 20 64 61 74 61 62 61 73 65 0a  en the database.
bca0: 20 20 20 20 69 73 20 63 6c 6f 73 65 64 20 61 6e      is closed an
bcb0: 64 20 72 65 6f 70 65 6e 65 64 2e 20 20 46 6f 72  d reopened.  For
bcc0: 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e 66 6f   additional info
bcd0: 72 6d 61 74 69 6f 6e 20 6f 6e 20 74 68 65 20 73  rmation on the s
bce0: 79 6e 63 68 72 6f 6e 6f 75 73 0a 20 20 20 20 66  ynchronous.    f
bcf0: 6c 61 67 2c 20 73 65 65 20 74 68 65 20 64 65 73  lag, see the des
bd00: 63 72 69 70 74 69 6f 6e 20 6f 66 20 74 68 65 20  cription of the 
bd10: 3c 62 3e 64 65 66 61 75 6c 74 5f 73 79 6e 63 68  <b>default_synch
bd20: 72 6f 6e 6f 75 73 3c 2f 62 3e 20 70 72 61 67 6d  ronous</b> pragm
bd30: 61 2e 3c 2f 70 3e 0a 20 20 20 20 3c 2f 6c 69 3e  a.</p>.    </li>
bd40: 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e 50 52 41 47  ..<li><p><b>PRAG
bd50: 4d 41 20 74 61 62 6c 65 5f 69 6e 66 6f 28 3c 2f  MA table_info(</
bd60: 62 3e 3c 69 3e 74 61 62 6c 65 2d 6e 61 6d 65 3c  b><i>table-name<
bd70: 2f 69 3e 3c 62 3e 29 3b 3c 2f 62 3e 3c 2f 70 3e  /i><b>);</b></p>
bd80: 0a 20 20 20 20 3c 70 3e 46 6f 72 20 65 61 63 68  .    <p>For each
bd90: 20 63 6f 6c 75 6d 6e 20 69 6e 20 74 68 65 20 6e   column in the n
bda0: 61 6d 65 64 20 74 61 62 6c 65 2c 20 69 6e 76 6f  amed table, invo
bdb0: 6b 65 20 74 68 65 20 63 61 6c 6c 62 61 63 6b 20  ke the callback 
bdc0: 66 75 6e 63 74 69 6f 6e 0a 20 20 20 20 6f 6e 63  function.    onc
bdd0: 65 20 77 69 74 68 20 69 6e 66 6f 72 6d 61 74 69  e with informati
bde0: 6f 6e 20 61 62 6f 75 74 20 74 68 61 74 20 63 6f  on about that co
bdf0: 6c 75 6d 6e 2c 20 69 6e 63 6c 75 64 69 6e 67 20  lumn, including 
be00: 74 68 65 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 2c  the column name,
be10: 0a 20 20 20 20 64 61 74 61 20 74 79 70 65 2c 20  .    data type, 
be20: 77 68 65 74 68 65 72 20 6f 72 20 6e 6f 74 20 74  whether or not t
be30: 68 65 20 63 6f 6c 75 6d 6e 20 63 61 6e 20 62 65  he column can be
be40: 20 4e 55 4c 4c 2c 20 61 6e 64 20 74 68 65 20 64   NULL, and the d
be50: 65 66 61 75 6c 74 0a 20 20 20 20 76 61 6c 75 65  efault.    value
be60: 20 66 6f 72 20 74 68 65 20 63 6f 6c 75 6d 6e 2e   for the column.
be70: 3c 2f 70 3e 0a 0a 3c 6c 69 3e 3c 70 3e 3c 62 3e  </p>..<li><p><b>
be80: 50 52 41 47 4d 41 20 76 64 62 65 5f 74 72 61 63  PRAGMA vdbe_trac
be90: 65 20 3d 20 4f 4e 3b 3c 62 72 3e 50 52 41 47 4d  e = ON;<br>PRAGM
bea0: 41 20 76 64 62 65 5f 74 72 61 63 65 20 3d 20 4f  A vdbe_trace = O
beb0: 46 46 3b 3c 2f 62 3e 3c 2f 70 3e 0a 20 20 20 20  FF;</b></p>.    
bec0: 3c 70 3e 54 75 72 6e 20 74 72 61 63 69 6e 67 20  <p>Turn tracing 
bed0: 6f 66 20 74 68 65 20 76 69 72 74 75 61 6c 20 64  of the virtual d
bee0: 61 74 61 62 61 73 65 20 65 6e 67 69 6e 65 20 69  atabase engine i
bef0: 6e 73 69 64 65 20 6f 66 20 74 68 65 0a 20 20 20  nside of the.   
bf00: 20 53 51 4c 69 74 65 20 6c 69 62 72 61 72 79 20   SQLite library 
bf10: 6f 6e 20 61 6e 64 20 6f 66 66 2e 20 20 54 68 69  on and off.  Thi
bf20: 73 20 69 73 20 75 73 65 64 20 66 6f 72 20 64 65  s is used for de
bf30: 62 75 67 67 69 6e 67 2e 3c 2f 70 3e 3c 2f 6c 69  bugging.</p></li
bf40: 3e 0a 3c 2f 75 6c 3e 0a 0a 3c 70 3e 4e 6f 20 65  >.</ul>..<p>No e
bf50: 72 72 6f 72 20 6d 65 73 73 61 67 65 20 69 73 20  rror message is 
bf60: 67 65 6e 65 72 61 74 65 64 20 69 66 20 61 6e 20  generated if an 
bf70: 75 6e 6b 6e 6f 77 6e 20 70 72 61 67 6d 61 20 69  unknown pragma i
bf80: 73 20 69 73 73 75 65 64 2e 0a 55 6e 6b 6e 6f 77  s issued..Unknow
bf90: 6e 20 70 72 61 67 6d 61 73 20 61 72 65 20 69 67  n pragmas are ig
bfa0: 6e 6f 72 65 64 2e 3c 2f 70 3e 0a 7d 0a 0a 0a 53  nored.</p>.}...S
bfb0: 65 63 74 69 6f 6e 20 52 45 50 4c 41 43 45 20 72  ection REPLACE r
bfc0: 65 70 6c 61 63 65 0a 0a 53 79 6e 74 61 78 20 7b  eplace..Syntax {
bfd0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
bfe0: 0a 52 45 50 4c 41 43 45 20 49 4e 54 4f 20 3c 74  .REPLACE INTO <t
bff0: 61 62 6c 65 2d 6e 61 6d 65 3e 20 5b 28 20 3c 63  able-name> [( <c
c000: 6f 6c 75 6d 6e 2d 6c 69 73 74 3e 20 29 5d 20 56  olumn-list> )] V
c010: 41 4c 55 45 53 20 28 20 3c 76 61 6c 75 65 2d 6c  ALUES ( <value-l
c020: 69 73 74 3e 20 29 20 7c 0a 52 45 50 4c 41 43 45  ist> ) |.REPLACE
c030: 20 49 4e 54 4f 20 3c 74 61 62 6c 65 2d 6e 61 6d   INTO <table-nam
c040: 65 3e 20 5b 28 20 3c 63 6f 6c 75 6d 6e 2d 6c 69  e> [( <column-li
c050: 73 74 3e 20 29 5d 20 3c 73 65 6c 65 63 74 2d 73  st> )] <select-s
c060: 74 61 74 65 6d 65 6e 74 3e 0a 7d 0a 0a 70 75 74  tatement>.}..put
c070: 73 20 7b 0a 3c 70 3e 54 68 65 20 52 45 50 4c 41  s {.<p>The REPLA
c080: 43 45 20 63 6f 6d 6d 61 6e 64 20 69 73 20 61 6e  CE command is an
c090: 20 61 6c 69 61 73 20 66 6f 72 20 74 68 65 20 22   alias for the "
c0a0: 49 4e 53 45 52 54 20 4f 52 20 52 45 50 4c 41 43  INSERT OR REPLAC
c0b0: 45 22 20 76 61 72 69 61 6e 74 0a 6f 66 20 74 68  E" variant.of th
c0c0: 65 20 3c 61 20 68 72 65 66 3d 22 23 69 6e 73 65  e <a href="#inse
c0d0: 72 74 22 3e 49 4e 53 45 52 54 20 63 6f 6d 6d 61  rt">INSERT comma
c0e0: 6e 64 3c 2f 61 3e 2e 20 20 54 68 69 73 20 61 6c  nd</a>.  This al
c0f0: 69 61 73 20 69 73 20 70 72 6f 76 69 64 65 64 20  ias is provided 
c100: 66 6f 72 0a 63 6f 6d 70 61 74 69 62 69 6c 69 74  for.compatibilit
c110: 79 20 77 69 74 68 20 4d 79 53 51 4c 2e 20 20 53  y with MySQL.  S
c120: 65 65 20 74 68 65 20 0a 3c 61 20 68 72 65 66 3d  ee the .<a href=
c130: 22 23 69 6e 73 65 72 74 22 3e 49 4e 53 45 52 54  "#insert">INSERT
c140: 20 63 6f 6d 6d 61 6e 64 3c 2f 61 3e 20 64 6f 63   command</a> doc
c150: 75 6d 65 6e 74 61 74 69 6f 6e 20 66 6f 72 20 61  umentation for a
c160: 64 64 69 74 69 6f 6e 61 6c 0a 69 6e 66 6f 72 6d  dditional.inform
c170: 61 74 69 6f 6e 2e 3c 2f 70 3e 20 20 0a 7d 0a 0a  ation.</p>  .}..
c180: 0a 53 65 63 74 69 6f 6e 20 53 45 4c 45 43 54 20  .Section SELECT 
c190: 73 65 6c 65 63 74 0a 0a 53 79 6e 74 61 78 20 7b  select..Syntax {
c1a0: 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d 20 7b  sql-statement} {
c1b0: 0a 53 45 4c 45 43 54 20 5b 41 4c 4c 20 7c 20 44  .SELECT [ALL | D
c1c0: 49 53 54 49 4e 43 54 5d 20 3c 72 65 73 75 6c 74  ISTINCT] <result
c1d0: 3e 20 5b 46 52 4f 4d 20 3c 74 61 62 6c 65 2d 6c  > [FROM <table-l
c1e0: 69 73 74 3e 5d 0a 5b 57 48 45 52 45 20 3c 65 78  ist>].[WHERE <ex
c1f0: 70 72 3e 5d 0a 5b 47 52 4f 55 50 20 42 59 20 3c  pr>].[GROUP BY <
c200: 65 78 70 72 2d 6c 69 73 74 3e 5d 0a 5b 48 41 56  expr-list>].[HAV
c210: 49 4e 47 20 3c 65 78 70 72 3e 5d 0a 5b 3c 63 6f  ING <expr>].[<co
c220: 6d 70 6f 75 6e 64 2d 6f 70 3e 20 3c 73 65 6c 65  mpound-op> <sele
c230: 63 74 3e 5d 2a 0a 5b 4f 52 44 45 52 20 42 59 20  ct>]*.[ORDER BY 
c240: 3c 73 6f 72 74 2d 65 78 70 72 2d 6c 69 73 74 3e  <sort-expr-list>
c250: 5d 0a 5b 4c 49 4d 49 54 20 3c 69 6e 74 65 67 65  ].[LIMIT <intege
c260: 72 3e 20 5b 4f 46 46 53 45 54 20 3c 69 6e 74 65  r> [OFFSET <inte
c270: 67 65 72 3e 5d 5d 0a 7d 20 7b 72 65 73 75 6c 74  ger>]].} {result
c280: 7d 20 7b 0a 3c 72 65 73 75 6c 74 2d 63 6f 6c 75  } {.<result-colu
c290: 6d 6e 3e 20 5b 2c 20 3c 72 65 73 75 6c 74 2d 63  mn> [, <result-c
c2a0: 6f 6c 75 6d 6e 3e 5d 2a 0a 7d 20 7b 72 65 73 75  olumn>]*.} {resu
c2b0: 6c 74 2d 63 6f 6c 75 6d 6e 7d 20 7b 0a 53 54 41  lt-column} {.STA
c2c0: 52 20 7c 20 3c 74 61 62 6c 65 2d 6e 61 6d 65 3e  R | <table-name>
c2d0: 20 2e 20 53 54 41 52 20 7c 20 3c 65 78 70 72 3e   . STAR | <expr>
c2e0: 20 5b 20 5b 41 53 5d 20 3c 73 74 72 69 6e 67 3e   [ [AS] <string>
c2f0: 20 5d 0a 7d 20 7b 74 61 62 6c 65 2d 6c 69 73 74   ].} {table-list
c300: 7d 20 7b 0a 3c 74 61 62 6c 65 3e 20 5b 3c 6a 6f  } {.<table> [<jo
c310: 69 6e 2d 6f 70 3e 20 3c 74 61 62 6c 65 3e 20 3c  in-op> <table> <
c320: 6a 6f 69 6e 2d 61 72 67 73 3e 5d 2a 0a 7d 20 7b  join-args>]*.} {
c330: 74 61 62 6c 65 7d 20 7b 0a 3c 74 61 62 6c 65 2d  table} {.<table-
c340: 6e 61 6d 65 3e 20 5b 41 53 20 3c 61 6c 69 61 73  name> [AS <alias
c350: 3e 5d 20 7c 0a 28 20 3c 73 65 6c 65 63 74 3e 20  >] |.( <select> 
c360: 29 20 5b 41 53 20 3c 61 6c 69 61 73 3e 5d 0a 7d  ) [AS <alias>].}
c370: 20 7b 6a 6f 69 6e 2d 6f 70 7d 20 7b 0a 2c 20 7c   {join-op} {., |
c380: 20 5b 4e 41 54 55 52 41 4c 5d 20 5b 4c 45 46 54   [NATURAL] [LEFT
c390: 20 7c 20 52 49 47 48 54 20 7c 20 46 55 4c 4c 5d   | RIGHT | FULL]
c3a0: 20 5b 4f 55 54 45 52 20 7c 20 49 4e 4e 45 52 5d   [OUTER | INNER]
c3b0: 20 4a 4f 49 4e 0a 7d 20 7b 6a 6f 69 6e 2d 61 72   JOIN.} {join-ar
c3c0: 67 73 7d 20 7b 0a 5b 4f 4e 20 3c 65 78 70 72 3e  gs} {.[ON <expr>
c3d0: 5d 20 5b 55 53 49 4e 47 20 28 20 3c 69 64 2d 6c  ] [USING ( <id-l
c3e0: 69 73 74 3e 20 29 5d 0a 7d 20 7b 73 6f 72 74 2d  ist> )].} {sort-
c3f0: 65 78 70 72 2d 6c 69 73 74 7d 20 7b 0a 3c 65 78  expr-list} {.<ex
c400: 70 72 3e 20 5b 3c 73 6f 72 74 2d 6f 72 64 65 72  pr> [<sort-order
c410: 3e 5d 20 5b 2c 20 3c 65 78 70 72 3e 20 5b 3c 73  >] [, <expr> [<s
c420: 6f 72 74 2d 6f 72 64 65 72 3e 5d 5d 2a 0a 7d 20  ort-order>]]*.} 
c430: 7b 73 6f 72 74 2d 6f 72 64 65 72 7d 20 7b 0a 41  {sort-order} {.A
c440: 53 43 20 7c 20 44 45 53 43 0a 7d 20 7b 63 6f 6d  SC | DESC.} {com
c450: 70 6f 75 6e 64 5f 6f 70 7d 20 7b 0a 55 4e 49 4f  pound_op} {.UNIO
c460: 4e 20 7c 20 55 4e 49 4f 4e 20 41 4c 4c 20 7c 20  N | UNION ALL | 
c470: 49 4e 54 45 52 53 45 43 54 20 7c 20 45 58 43 45  INTERSECT | EXCE
c480: 50 54 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e  PT.}..puts {.<p>
c490: 54 68 65 20 53 45 4c 45 43 54 20 73 74 61 74 65  The SELECT state
c4a0: 6d 65 6e 74 20 69 73 20 75 73 65 64 20 74 6f 20  ment is used to 
c4b0: 71 75 65 72 79 20 74 68 65 20 64 61 74 61 62 61  query the databa
c4c0: 73 65 2e 20 20 54 68 65 0a 72 65 73 75 6c 74 20  se.  The.result 
c4d0: 6f 66 20 61 20 53 45 4c 45 43 54 20 69 73 20 7a  of a SELECT is z
c4e0: 65 72 6f 20 6f 72 20 6d 6f 72 65 20 72 6f 77 73  ero or more rows
c4f0: 20 6f 66 20 64 61 74 61 20 77 68 65 72 65 20 65   of data where e
c500: 61 63 68 20 72 6f 77 0a 68 61 73 20 61 20 66 69  ach row.has a fi
c510: 78 65 64 20 6e 75 6d 62 65 72 20 6f 66 20 63 6f  xed number of co
c520: 6c 75 6d 6e 73 2e 20 20 54 68 65 20 6e 75 6d 62  lumns.  The numb
c530: 65 72 20 6f 66 20 63 6f 6c 75 6d 6e 73 20 69 6e  er of columns in
c540: 20 74 68 65 0a 72 65 73 75 6c 74 20 69 73 20 73   the.result is s
c550: 70 65 63 69 66 69 65 64 20 62 79 20 74 68 65 20  pecified by the 
c560: 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 73 74 20  expression list 
c570: 69 6e 20 62 65 74 77 65 65 6e 20 74 68 65 0a 53  in between the.S
c580: 45 4c 45 43 54 20 61 6e 64 20 46 52 4f 4d 20 6b  ELECT and FROM k
c590: 65 79 77 6f 72 64 73 2e 20 20 41 6e 79 20 61 72  eywords.  Any ar
c5a0: 62 69 74 72 61 72 79 20 65 78 70 72 65 73 73 69  bitrary expressi
c5b0: 6f 6e 20 63 61 6e 20 62 65 20 75 73 65 64 0a 61  on can be used.a
c5c0: 73 20 61 20 72 65 73 75 6c 74 2e 20 20 49 66 20  s a result.  If 
c5d0: 61 20 72 65 73 75 6c 74 20 65 78 70 72 65 73 73  a result express
c5e0: 69 6f 6e 20 69 73 20 7d 0a 70 75 74 73 20 22 5b  ion is }.puts "[
c5f0: 4f 70 65 72 61 74 6f 72 20 2a 5d 20 74 68 65 6e  Operator *] then
c600: 20 61 6c 6c 20 63 6f 6c 75 6d 6e 73 20 6f 66 20   all columns of 
c610: 61 6c 6c 20 74 61 62 6c 65 73 20 61 72 65 20 73  all tables are s
c620: 75 62 73 74 69 74 75 74 65 64 22 0a 70 75 74 73  ubstituted".puts
c630: 20 7b 66 6f 72 20 74 68 61 74 20 6f 6e 65 20 65   {for that one e
c640: 78 70 72 65 73 73 69 6f 6e 2e 20 20 49 66 20 74  xpression.  If t
c650: 68 65 20 65 78 70 72 65 73 73 69 6f 6e 20 69 73  he expression is
c660: 20 74 68 65 20 6e 61 6d 65 20 6f 66 7d 0a 70 75   the name of}.pu
c670: 74 73 20 22 61 20 74 61 62 6c 65 20 66 6f 6c 6c  ts "a table foll
c680: 6f 77 65 64 20 62 79 20 5b 4f 70 65 72 61 74 6f  owed by [Operato
c690: 72 20 2e 2a 5d 20 74 68 65 6e 20 74 68 65 20 72  r .*] then the r
c6a0: 65 73 75 6c 74 20 69 73 20 61 6c 6c 20 63 6f 6c  esult is all col
c6b0: 75 6d 6e 73 22 0a 70 75 74 73 20 7b 69 6e 20 74  umns".puts {in t
c6c0: 68 61 74 20 6f 6e 65 20 74 61 62 6c 65 2e 3c 2f  hat one table.</
c6d0: 70 3e 0a 0a 3c 70 3e 54 68 65 20 71 75 65 72 79  p>..<p>The query
c6e0: 20 69 73 20 65 78 65 63 75 74 65 64 20 61 67 61   is executed aga
c6f0: 69 6e 73 74 20 6f 6e 65 20 6f 72 20 6d 6f 72 65  inst one or more
c700: 20 74 61 62 6c 65 73 20 73 70 65 63 69 66 69 65   tables specifie
c710: 64 20 61 66 74 65 72 0a 74 68 65 20 46 52 4f 4d  d after.the FROM
c720: 20 6b 65 79 77 6f 72 64 2e 20 20 49 66 20 6d 75   keyword.  If mu
c730: 6c 74 69 70 6c 65 20 74 61 62 6c 65 73 20 6e 61  ltiple tables na
c740: 6d 65 73 20 61 72 65 20 73 65 70 61 72 61 74 65  mes are separate
c750: 64 20 62 79 20 63 6f 6d 6d 61 73 2c 0a 74 68 65  d by commas,.the
c760: 6e 20 74 68 65 20 71 75 65 72 79 20 69 73 20 61  n the query is a
c770: 67 61 69 6e 73 74 20 74 68 65 20 63 72 6f 73 73  gainst the cross
c780: 20 6a 6f 69 6e 20 6f 66 20 74 68 65 20 76 61 72   join of the var
c790: 69 6f 75 73 20 74 61 62 6c 65 73 2e 0a 54 68 65  ious tables..The
c7a0: 20 66 75 6c 6c 20 53 51 4c 2d 39 32 20 6a 6f 69   full SQL-92 joi
c7b0: 6e 20 73 79 6e 74 61 78 20 63 61 6e 20 61 6c 73  n syntax can als
c7c0: 6f 20 62 65 20 75 73 65 64 20 74 6f 20 73 70 65  o be used to spe
c7d0: 63 69 66 79 20 6a 6f 69 6e 73 2e 0a 41 20 73 75  cify joins..A su
c7e0: 62 2d 71 75 65 72 79 0a 69 6e 20 70 61 72 65 6e  b-query.in paren
c7f0: 74 68 65 73 65 73 20 6d 61 79 20 62 65 20 73 75  theses may be su
c800: 62 73 74 69 74 75 74 65 64 20 66 6f 72 20 61 6e  bstituted for an
c810: 79 20 74 61 62 6c 65 20 6e 61 6d 65 20 69 6e 20  y table name in 
c820: 74 68 65 20 46 52 4f 4d 20 63 6c 61 75 73 65 2e  the FROM clause.
c830: 0a 54 68 65 20 65 6e 74 69 72 65 20 46 52 4f 4d  .The entire FROM
c840: 20 63 6c 61 75 73 65 20 6d 61 79 20 62 65 20 6f   clause may be o
c850: 6d 69 74 74 65 64 2c 20 69 6e 20 77 68 69 63 68  mitted, in which
c860: 20 63 61 73 65 20 74 68 65 20 72 65 73 75 6c 74   case the result
c870: 20 69 73 20 61 0a 73 69 6e 67 6c 65 20 72 6f 77   is a.single row
c880: 20 63 6f 6e 73 69 73 74 69 6e 67 20 6f 66 20 74   consisting of t
c890: 68 65 20 76 61 6c 75 65 73 20 6f 66 20 74 68 65  he values of the
c8a0: 20 65 78 70 72 65 73 73 69 6f 6e 20 6c 69 73 74   expression list
c8b0: 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 57  ..</p>..<p>The W
c8c0: 48 45 52 45 20 63 6c 61 75 73 65 20 63 61 6e 20  HERE clause can 
c8d0: 62 65 20 75 73 65 64 20 74 6f 20 6c 69 6d 69 74  be used to limit
c8e0: 20 74 68 65 20 6e 75 6d 62 65 72 20 6f 66 20 72   the number of r
c8f0: 6f 77 73 20 6f 76 65 72 0a 77 68 69 63 68 20 74  ows over.which t
c900: 68 65 20 71 75 65 72 79 20 6f 70 65 72 61 74 65  he query operate
c910: 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 47  s.</p>..<p>The G
c920: 52 4f 55 50 20 42 59 20 63 6c 61 75 73 65 73 20  ROUP BY clauses 
c930: 63 61 75 73 65 73 20 6f 6e 65 20 6f 72 20 6d 6f  causes one or mo
c940: 72 65 20 72 6f 77 73 20 6f 66 20 74 68 65 20 72  re rows of the r
c950: 65 73 75 6c 74 20 74 6f 0a 62 65 20 63 6f 6d 62  esult to.be comb
c960: 69 6e 65 64 20 69 6e 74 6f 20 61 20 73 69 6e 67  ined into a sing
c970: 6c 65 20 72 6f 77 20 6f 66 20 6f 75 74 70 75 74  le row of output
c980: 2e 20 20 54 68 69 73 20 69 73 20 65 73 70 65 63  .  This is espec
c990: 69 61 6c 6c 79 20 75 73 65 66 75 6c 0a 77 68 65  ially useful.whe
c9a0: 6e 20 74 68 65 20 72 65 73 75 6c 74 20 63 6f 6e  n the result con
c9b0: 74 61 69 6e 73 20 61 67 67 72 65 67 61 74 65 20  tains aggregate 
c9c0: 66 75 6e 63 74 69 6f 6e 73 2e 20 20 54 68 65 20  functions.  The 
c9d0: 65 78 70 72 65 73 73 69 6f 6e 73 20 69 6e 0a 74  expressions in.t
c9e0: 68 65 20 47 52 4f 55 50 20 42 59 20 63 6c 61 75  he GROUP BY clau
c9f0: 73 65 20 64 6f 20 3c 65 6d 3e 6e 6f 74 3c 2f 65  se do <em>not</e
ca00: 6d 3e 20 68 61 76 65 20 74 6f 20 62 65 20 65 78  m> have to be ex
ca10: 70 72 65 73 73 69 6f 6e 73 20 74 68 61 74 0a 61  pressions that.a
ca20: 70 70 65 61 72 20 69 6e 20 74 68 65 20 72 65 73  ppear in the res
ca30: 75 6c 74 2e 20 20 54 68 65 20 48 41 56 49 4e 47  ult.  The HAVING
ca40: 20 63 6c 61 75 73 65 20 69 73 20 73 69 6d 69 6c   clause is simil
ca50: 61 72 20 74 6f 20 57 48 45 52 45 20 65 78 63 65  ar to WHERE exce
ca60: 70 74 0a 74 68 61 74 20 48 41 56 49 4e 47 20 61  pt.that HAVING a
ca70: 70 70 6c 69 65 73 20 61 66 74 65 72 20 67 72 6f  pplies after gro
ca80: 75 70 69 6e 67 20 68 61 73 20 6f 63 63 75 72 72  uping has occurr
ca90: 65 64 2e 20 20 54 68 65 20 48 41 56 49 4e 47 20  ed.  The HAVING 
caa0: 65 78 70 72 65 73 73 69 6f 6e 0a 6d 61 79 20 72  expression.may r
cab0: 65 66 65 72 20 74 6f 20 76 61 6c 75 65 73 2c 20  efer to values, 
cac0: 65 76 65 6e 20 61 67 67 72 65 67 61 74 65 20 66  even aggregate f
cad0: 75 6e 63 74 69 6f 6e 73 2c 20 74 68 61 74 20 61  unctions, that a
cae0: 72 65 20 6e 6f 74 20 69 6e 20 74 68 65 20 72 65  re not in the re
caf0: 73 75 6c 74 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68  sult.</p>..<p>Th
cb00: 65 20 4f 52 44 45 52 20 42 59 20 63 6c 61 75 73  e ORDER BY claus
cb10: 65 20 63 61 75 73 65 73 20 74 68 65 20 6f 75 74  e causes the out
cb20: 70 75 74 20 72 6f 77 73 20 74 6f 20 62 65 20 73  put rows to be s
cb30: 6f 72 74 65 64 2e 20 20 0a 54 68 65 20 61 72 67  orted.  .The arg
cb40: 75 6d 65 6e 74 20 74 6f 20 4f 52 44 45 52 20 42  ument to ORDER B
cb50: 59 20 69 73 20 61 20 6c 69 73 74 20 6f 66 20 65  Y is a list of e
cb60: 78 70 72 65 73 73 69 6f 6e 73 20 74 68 61 74 20  xpressions that 
cb70: 61 72 65 20 75 73 65 64 20 61 73 20 74 68 65 0a  are used as the.
cb80: 6b 65 79 20 66 6f 72 20 74 68 65 20 73 6f 72 74  key for the sort
cb90: 2e 20 20 54 68 65 20 65 78 70 72 65 73 73 69 6f  .  The expressio
cba0: 6e 73 20 64 6f 20 6e 6f 74 20 68 61 76 65 20 74  ns do not have t
cbb0: 6f 20 62 65 20 70 61 72 74 20 6f 66 20 74 68 65  o be part of the
cbc0: 0a 72 65 73 75 6c 74 20 66 6f 72 20 61 20 73 69  .result for a si
cbd0: 6d 70 6c 65 20 53 45 4c 45 43 54 2c 20 62 75 74  mple SELECT, but
cbe0: 20 69 6e 20 61 20 63 6f 6d 70 6f 75 6e 64 20 53   in a compound S
cbf0: 45 4c 45 43 54 20 65 61 63 68 20 73 6f 72 74 0a  ELECT each sort.
cc00: 65 78 70 72 65 73 73 69 6f 6e 20 6d 75 73 74 20  expression must 
cc10: 65 78 61 63 74 6c 79 20 6d 61 74 63 68 20 6f 6e  exactly match on
cc20: 65 20 6f 66 20 74 68 65 20 72 65 73 75 6c 74 20  e of the result 
cc30: 63 6f 6c 75 6d 6e 73 2e 20 20 45 61 63 68 0a 73  columns.  Each.s
cc40: 6f 72 74 20 65 78 70 72 65 73 73 69 6f 6e 20 6d  ort expression m
cc50: 61 79 20 62 65 20 6f 70 74 69 6f 6e 61 6c 6c 79  ay be optionally
cc60: 20 66 6f 6c 6c 6f 77 65 64 20 62 79 20 41 53 43   followed by ASC
cc70: 20 6f 72 20 44 45 53 43 20 74 6f 20 73 70 65 63   or DESC to spec
cc80: 69 66 79 0a 74 68 65 20 73 6f 72 74 20 6f 72 64  ify.the sort ord
cc90: 65 72 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20  er.</p>..<p>The 
cca0: 4c 49 4d 49 54 20 63 6c 61 75 73 65 20 70 6c 61  LIMIT clause pla
ccb0: 63 65 73 20 61 6e 20 75 70 70 65 72 20 62 6f 75  ces an upper bou
ccc0: 6e 64 20 6f 6e 20 74 68 65 20 6e 75 6d 62 65 72  nd on the number
ccd0: 20 6f 66 20 72 6f 77 73 0a 72 65 74 75 72 6e 65   of rows.returne
cce0: 64 20 69 6e 20 74 68 65 20 72 65 73 75 6c 74 2e  d in the result.
ccf0: 20 20 41 20 4c 49 4d 49 54 20 6f 66 20 30 20 69    A LIMIT of 0 i
cd00: 6e 64 69 63 61 74 65 73 20 6e 6f 20 75 70 70 65  ndicates no uppe
cd10: 72 20 62 6f 75 6e 64 2e 0a 54 68 65 20 6f 70 74  r bound..The opt
cd20: 69 6f 6e 61 6c 20 4f 46 46 53 45 54 20 66 6f 6c  ional OFFSET fol
cd30: 6c 6f 77 69 6e 67 20 4c 49 4d 49 54 20 73 70 65  lowing LIMIT spe
cd40: 63 69 66 69 65 73 20 68 6f 77 20 6d 61 6e 79 0a  cifies how many.
cd50: 72 6f 77 73 20 74 6f 20 73 6b 69 70 20 61 74 20  rows to skip at 
cd60: 74 68 65 20 62 65 67 69 6e 6e 69 6e 67 20 6f 66  the beginning of
cd70: 20 74 68 65 20 72 65 73 75 6c 74 20 73 65 74 2e   the result set.
cd80: 3c 2f 70 3e 0a 0a 3c 70 3e 41 20 63 6f 6d 70 6f  </p>..<p>A compo
cd90: 75 6e 64 20 53 45 4c 45 43 54 20 69 73 20 66 6f  und SELECT is fo
cda0: 72 6d 65 64 20 66 72 6f 6d 20 74 77 6f 20 6f 72  rmed from two or
cdb0: 20 6d 6f 72 65 20 73 69 6d 70 6c 65 20 53 45 4c   more simple SEL
cdc0: 45 43 54 73 20 63 6f 6e 6e 65 63 74 65 64 0a 62  ECTs connected.b
cdd0: 79 20 6f 6e 65 20 6f 66 20 74 68 65 20 6f 70 65  y one of the ope
cde0: 72 61 74 6f 72 73 20 55 4e 49 4f 4e 2c 20 55 4e  rators UNION, UN
cdf0: 49 4f 4e 20 41 4c 4c 2c 20 49 4e 54 45 52 53 45  ION ALL, INTERSE
ce00: 43 54 2c 20 6f 72 20 45 58 43 45 50 54 2e 20 20  CT, or EXCEPT.  
ce10: 49 6e 0a 61 20 63 6f 6d 70 6f 75 6e 64 20 53 45  In.a compound SE
ce20: 4c 45 43 54 2c 20 61 6c 6c 20 74 68 65 20 63 6f  LECT, all the co
ce30: 6e 73 74 69 74 75 65 6e 74 20 53 45 4c 45 43 54  nstituent SELECT
ce40: 73 20 6d 75 73 74 20 73 70 65 63 69 66 79 20 74  s must specify t
ce50: 68 65 0a 73 61 6d 65 20 6e 75 6d 62 65 72 20 6f  he.same number o
ce60: 66 20 72 65 73 75 6c 74 20 63 6f 6c 75 6d 6e 73  f result columns
ce70: 2e 20 20 54 68 65 72 65 20 6d 61 79 20 62 65 20  .  There may be 
ce80: 6f 6e 6c 79 20 61 20 73 69 6e 67 6c 65 20 4f 52  only a single OR
ce90: 44 45 52 20 42 59 0a 63 6c 61 75 73 65 20 61 74  DER BY.clause at
cea0: 20 74 68 65 20 65 6e 64 20 6f 66 20 74 68 65 20   the end of the 
ceb0: 63 6f 6d 70 6f 75 6e 64 20 53 45 4c 45 43 54 2e  compound SELECT.
cec0: 20 20 54 68 65 20 55 4e 49 4f 4e 20 61 6e 64 20    The UNION and 
ced0: 55 4e 49 4f 4e 20 41 4c 4c 0a 6f 70 65 72 61 74  UNION ALL.operat
cee0: 6f 72 73 20 63 6f 6d 62 69 6e 65 20 74 68 65 20  ors combine the 
cef0: 72 65 73 75 6c 74 73 20 6f 66 20 74 68 65 20 53  results of the S
cf00: 45 4c 45 43 54 73 20 74 6f 20 74 68 65 20 72 69  ELECTs to the ri
cf10: 67 68 74 20 61 6e 64 20 6c 65 66 74 20 69 6e 74  ght and left int
cf20: 6f 0a 61 20 73 69 6e 67 6c 65 20 62 69 67 20 74  o.a single big t
cf30: 61 62 6c 65 2e 20 20 54 68 65 20 64 69 66 66 65  able.  The diffe
cf40: 72 65 6e 63 65 20 69 73 20 74 68 61 74 20 69 6e  rence is that in
cf50: 20 55 4e 49 4f 4e 20 61 6c 6c 20 72 65 73 75 6c   UNION all resul
cf60: 74 20 72 6f 77 73 0a 61 72 65 20 64 69 73 74 69  t rows.are disti
cf70: 6e 63 74 20 77 68 65 72 65 20 69 6e 20 55 4e 49  nct where in UNI
cf80: 4f 4e 20 41 4c 4c 20 74 68 65 72 65 20 6d 61 79  ON ALL there may
cf90: 20 62 65 20 64 75 70 6c 69 63 61 74 65 73 2e 0a   be duplicates..
cfa0: 54 68 65 20 49 4e 54 45 52 53 45 43 54 20 6f 70  The INTERSECT op
cfb0: 65 72 61 74 6f 72 20 74 61 6b 65 73 20 74 68 65  erator takes the
cfc0: 20 69 6e 74 65 72 73 65 63 74 69 6f 6e 20 6f 66   intersection of
cfd0: 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f 66 20   the results of 
cfe0: 74 68 65 0a 6c 65 66 74 20 61 6e 64 20 72 69 67  the.left and rig
cff0: 68 74 20 53 45 4c 45 43 54 73 2e 20 20 45 58 43  ht SELECTs.  EXC
d000: 45 50 54 20 74 61 6b 65 73 20 74 68 65 20 72 65  EPT takes the re
d010: 73 75 6c 74 20 6f 66 20 6c 65 66 74 20 53 45 4c  sult of left SEL
d020: 45 43 54 20 61 66 74 65 72 0a 72 65 6d 6f 76 69  ECT after.removi
d030: 6e 67 20 74 68 65 20 72 65 73 75 6c 74 73 20 6f  ng the results o
d040: 66 20 74 68 65 20 72 69 67 68 74 20 53 45 4c 45  f the right SELE
d050: 43 54 2e 20 20 57 68 65 6e 20 74 68 72 65 65 20  CT.  When three 
d060: 61 72 65 20 6d 6f 72 65 20 53 45 4c 45 43 54 73  are more SELECTs
d070: 0a 61 72 65 20 63 6f 6e 6e 65 63 74 65 64 20 69  .are connected i
d080: 6e 74 6f 20 61 20 63 6f 6d 70 6f 75 6e 64 2c 20  nto a compound, 
d090: 74 68 65 79 20 67 72 6f 75 70 20 66 72 6f 6d 20  they group from 
d0a0: 6c 65 66 74 20 74 6f 20 72 69 67 68 74 2e 3c 2f  left to right.</
d0b0: 70 3e 0a 7d 0a 0a 0a 53 65 63 74 69 6f 6e 20 55  p>.}...Section U
d0c0: 50 44 41 54 45 20 75 70 64 61 74 65 0a 0a 53 79  PDATE update..Sy
d0d0: 6e 74 61 78 20 7b 73 71 6c 2d 73 74 61 74 65 6d  ntax {sql-statem
d0e0: 65 6e 74 7d 20 7b 0a 55 50 44 41 54 45 20 5b 20  ent} {.UPDATE [ 
d0f0: 4f 52 20 3c 63 6f 6e 66 6c 69 63 74 2d 61 6c 67  OR <conflict-alg
d100: 6f 72 69 74 68 6d 3e 20 5d 20 3c 74 61 62 6c 65  orithm> ] <table
d110: 2d 6e 61 6d 65 3e 0a 53 45 54 20 3c 61 73 73 69  -name>.SET <assi
d120: 67 6e 6d 65 6e 74 3e 20 5b 2c 20 3c 61 73 73 69  gnment> [, <assi
d130: 67 6e 6d 65 6e 74 3e 5d 2a 0a 5b 57 48 45 52 45  gnment>]*.[WHERE
d140: 20 3c 65 78 70 72 3e 5d 0a 7d 20 7b 61 73 73 69   <expr>].} {assi
d150: 67 6e 6d 65 6e 74 7d 20 7b 0a 3c 63 6f 6c 75 6d  gnment} {.<colum
d160: 6e 2d 6e 61 6d 65 3e 20 3d 20 3c 65 78 70 72 3e  n-name> = <expr>
d170: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
d180: 65 20 55 50 44 41 54 45 20 73 74 61 74 65 6d 65  e UPDATE stateme
d190: 6e 74 20 69 73 20 75 73 65 64 20 74 6f 20 63 68  nt is used to ch
d1a0: 61 6e 67 65 20 74 68 65 20 76 61 6c 75 65 20 6f  ange the value o
d1b0: 66 20 63 6f 6c 75 6d 6e 73 20 69 6e 20 0a 73 65  f columns in .se
d1c0: 6c 65 63 74 65 64 20 72 6f 77 73 20 6f 66 20 61  lected rows of a
d1d0: 20 74 61 62 6c 65 2e 20 20 45 61 63 68 20 61 73   table.  Each as
d1e0: 73 69 67 6e 6d 65 6e 74 20 69 6e 20 61 6e 20 55  signment in an U
d1f0: 50 44 41 54 45 20 73 70 65 63 69 66 69 65 73 0a  PDATE specifies.
d200: 61 20 63 6f 6c 75 6d 6e 20 6e 61 6d 65 20 74 6f  a column name to
d210: 20 74 68 65 20 6c 65 66 74 20 6f 66 20 74 68 65   the left of the
d220: 20 65 71 75 61 6c 73 20 73 69 67 6e 20 61 6e 64   equals sign and
d230: 20 61 6e 20 61 72 62 69 74 72 61 72 79 20 65 78   an arbitrary ex
d240: 70 72 65 73 73 69 6f 6e 0a 74 6f 20 74 68 65 20  pression.to the 
d250: 72 69 67 68 74 2e 20 20 54 68 65 20 65 78 70 72  right.  The expr
d260: 65 73 73 69 6f 6e 73 20 6d 61 79 20 75 73 65 20  essions may use 
d270: 74 68 65 20 76 61 6c 75 65 73 20 6f 66 20 6f 74  the values of ot
d280: 68 65 72 20 63 6f 6c 75 6d 6e 73 2e 0a 41 6c 6c  her columns..All
d290: 20 65 78 70 72 65 73 73 69 6f 6e 73 20 61 72 65   expressions are
d2a0: 20 65 76 61 6c 75 61 74 65 64 20 62 65 66 6f 72   evaluated befor
d2b0: 65 20 61 6e 79 20 61 73 73 69 67 6e 6d 65 6e 74  e any assignment
d2c0: 73 20 61 72 65 20 6d 61 64 65 2e 0a 41 20 57 48  s are made..A WH
d2d0: 45 52 45 20 63 6c 61 75 73 65 20 63 61 6e 20 62  ERE clause can b
d2e0: 65 20 75 73 65 64 20 74 6f 20 72 65 73 74 72 69  e used to restri
d2f0: 63 74 20 77 68 69 63 68 20 72 6f 77 73 20 61 72  ct which rows ar
d300: 65 20 75 70 64 61 74 65 64 2e 3c 2f 70 3e 0a 0a  e updated.</p>..
d310: 3c 70 3e 54 68 65 20 6f 70 74 69 6f 6e 61 6c 20  <p>The optional 
d320: 63 6f 6e 66 6c 69 63 74 2d 63 6c 61 75 73 65 20  conflict-clause 
d330: 61 6c 6c 6f 77 73 20 74 68 65 20 73 70 65 63 69  allows the speci
d340: 66 69 63 61 74 69 6f 6e 20 6f 66 20 61 6e 20 61  fication of an a
d350: 6c 74 65 72 6e 61 74 69 76 65 0a 63 6f 6e 73 74  lternative.const
d360: 72 61 69 6e 74 20 63 6f 6e 66 6c 69 63 74 20 72  raint conflict r
d370: 65 73 6f 6c 75 74 69 6f 6e 20 61 6c 67 6f 72 69  esolution algori
d380: 74 68 6d 20 74 6f 20 75 73 65 20 64 75 72 69 6e  thm to use durin
d390: 67 20 74 68 69 73 20 6f 6e 65 20 63 6f 6d 6d 61  g this one comma
d3a0: 6e 64 2e 0a 53 65 65 20 74 68 65 20 73 65 63 74  nd..See the sect
d3b0: 69 6f 6e 20 74 69 74 6c 65 64 0a 3c 61 20 68 72  ion titled.<a hr
d3c0: 65 66 3d 22 23 63 6f 6e 66 6c 69 63 74 22 3e 4f  ef="#conflict">O
d3d0: 4e 20 43 4f 4e 46 4c 49 43 54 3c 2f 61 3e 20 66  N CONFLICT</a> f
d3e0: 6f 72 20 61 64 64 69 74 69 6f 6e 61 6c 20 69 6e  or additional in
d3f0: 66 6f 72 6d 61 74 69 6f 6e 2e 3c 2f 70 3e 0a 7d  formation.</p>.}
d400: 0a 0a 0a 53 65 63 74 69 6f 6e 20 56 41 43 55 55  ...Section VACUU
d410: 4d 20 76 61 63 75 75 6d 0a 0a 53 79 6e 74 61 78  M vacuum..Syntax
d420: 20 7b 73 71 6c 2d 73 74 61 74 65 6d 65 6e 74 7d   {sql-statement}
d430: 20 7b 0a 56 41 43 55 55 4d 20 5b 3c 69 6e 64 65   {.VACUUM [<inde
d440: 78 2d 6f 72 2d 74 61 62 6c 65 2d 6e 61 6d 65 3e  x-or-table-name>
d450: 5d 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  ].}..puts {.<p>T
d460: 68 65 20 56 41 43 55 55 4d 20 63 6f 6d 6d 61 6e  he VACUUM comman
d470: 64 20 69 73 20 61 6e 20 53 51 4c 69 74 65 20 65  d is an SQLite e
d480: 78 74 65 6e 73 69 6f 6e 20 6d 6f 64 65 6c 6c 65  xtension modelle
d490: 64 20 61 66 74 65 72 20 61 20 73 69 6d 69 6c 61  d after a simila
d4a0: 72 0a 63 6f 6d 6d 61 6e 64 20 66 6f 75 6e 64 20  r.command found 
d4b0: 69 6e 20 50 6f 73 74 67 72 65 53 51 4c 2e 20 20  in PostgreSQL.  
d4c0: 49 66 20 56 41 43 55 55 4d 20 69 73 20 69 6e 76  If VACUUM is inv
d4d0: 6f 6b 65 64 20 77 69 74 68 20 74 68 65 20 6e 61  oked with the na
d4e0: 6d 65 20 6f 66 20 61 0a 74 61 62 6c 65 20 6f 72  me of a.table or
d4f0: 20 69 6e 64 65 78 20 74 68 65 6e 20 69 74 20 69   index then it i
d500: 73 20 73 75 70 70 6f 73 65 20 74 6f 20 63 6c 65  s suppose to cle
d510: 61 6e 20 75 70 20 74 68 65 20 6e 61 6d 65 64 20  an up the named 
d520: 74 61 62 6c 65 20 6f 72 20 69 6e 64 65 78 2e 0a  table or index..
d530: 49 6e 20 76 65 72 73 69 6f 6e 20 31 2e 30 20 6f  In version 1.0 o
d540: 66 20 53 51 4c 69 74 65 2c 20 74 68 65 20 56 41  f SQLite, the VA
d550: 43 55 55 4d 20 63 6f 6d 6d 61 6e 64 20 77 6f 75  CUUM command wou
d560: 6c 64 20 69 6e 76 6f 6b 65 20 0a 3c 62 3e 67 64  ld invoke .<b>gd
d570: 62 6d 5f 72 65 6f 72 67 61 6e 69 7a 65 28 29 3c  bm_reorganize()<
d580: 2f 62 3e 20 74 6f 20 63 6c 65 61 6e 20 75 70 20  /b> to clean up 
d590: 74 68 65 20 62 61 63 6b 65 6e 64 20 64 61 74 61  the backend data
d5a0: 62 61 73 65 20 66 69 6c 65 2e 3c 2f 70 3e 0a 0a  base file.</p>..
d5b0: 3c 70 3e 0a 54 68 69 73 20 63 6f 6d 6d 61 6e 64  <p>.This command
d5c0: 20 77 61 73 20 72 65 61 64 64 65 64 20 61 66 74   was readded aft
d5d0: 65 72 20 76 65 72 73 69 6f 6e 20 32 2e 38 2e 30  er version 2.8.0
d5e0: 2e 20 6f 66 20 53 51 4c 69 74 65 2e 20 20 49 74  . of SQLite.  It
d5f0: 20 6e 6f 77 20 63 6c 65 61 6e 73 0a 74 68 65 20   now cleans.the 
d600: 64 61 74 61 62 61 73 65 20 62 79 20 63 6f 70 79  database by copy
d610: 69 6e 67 20 69 74 73 20 63 6f 6e 74 65 6e 74 73  ing its contents
d620: 20 74 6f 20 61 20 74 65 6d 70 6f 72 61 72 79 20   to a temporary 
d630: 64 61 74 61 62 61 73 65 20 66 69 6c 65 2c 20 61  database file, a
d640: 6e 64 20 0a 72 65 6c 6f 61 64 69 6e 67 20 74 68  nd .reloading th
d650: 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65 20  e database file 
d660: 66 72 6f 6d 20 69 74 2e 20 20 54 68 69 73 20 77  from it.  This w
d670: 69 6c 6c 20 65 6c 69 6d 69 6e 61 74 65 20 66 72  ill eliminate fr
d680: 65 65 20 70 61 67 65 73 2c 20 0a 61 6c 69 67 6e  ee pages, .align
d690: 20 74 61 62 6c 65 20 64 61 74 61 20 74 6f 20 62   table data to b
d6a0: 65 20 63 6f 6e 74 69 67 75 6f 75 73 2c 20 61 6e  e contiguous, an
d6b0: 64 20 6f 74 68 65 72 77 69 73 65 20 63 6c 65 61  d otherwise clea
d6c0: 6e 20 75 70 20 74 68 65 20 64 61 74 61 62 61 73  n up the databas
d6d0: 65 20 0a 66 69 6c 65 20 73 74 72 75 63 74 75 72  e .file structur
d6e0: 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 69 73 20  e.</p>..<p>This 
d6f0: 63 6f 6d 6d 61 6e 64 20 77 69 6c 6c 20 66 61 69  command will fai
d700: 6c 20 69 66 20 74 68 65 72 65 20 69 73 20 61 6e  l if there is an
d710: 20 61 63 74 69 76 65 20 74 72 61 6e 73 61 63 74   active transact
d720: 69 6f 6e 2e 20 20 54 68 69 73 20 0a 63 6f 6d 6d  ion.  This .comm
d730: 61 6e 64 20 68 61 73 20 6e 6f 20 65 66 66 65 63  and has no effec
d740: 74 20 6f 6e 20 61 6e 20 69 6e 2d 6d 65 6d 6f 72  t on an in-memor
d750: 79 20 64 61 74 61 62 61 73 65 2e 3c 2f 70 3e 0a  y database.</p>.
d760: 7d 0a 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 3c 68  }...puts {.<p><h
d770: 72 20 2f 3e 3c 2f 70 3e 0a 3c 70 3e 3c 61 20 68  r /></p>.<p><a h
d780: 72 65 66 3d 22 69 6e 64 65 78 2e 68 74 6d 6c 22  ref="index.html"
d790: 3e 3c 69 6d 67 20 73 72 63 3d 22 2f 67 6f 62 61  ><img src="/goba
d7a0: 63 6b 2e 6a 70 67 22 20 62 6f 72 64 65 72 3d 30  ck.jpg" border=0
d7b0: 20 2f 3e 0a 42 61 63 6b 20 74 6f 20 74 68 65 20   />.Back to the 
d7c0: 53 51 4c 69 74 65 20 48 6f 6d 65 20 50 61 67 65  SQLite Home Page
d7d0: 3c 2f 61 3e 0a 3c 2f 70 3e 0a 0a 3c 2f 62 6f 64  </a>.</p>..</bod
d7e0: 79 3e 3c 2f 68 74 6d 6c 3e 7d 0a 0a 0a 0a 0a 0a  y></html>}......
d7f0: 0a                                               .