/ Hex Artifact Content
Login

Artifact 8b5884354cb615049aed83039f8dfe1552a44279:


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 73 71 6c 69  rcsid {$Id: sqli
0050: 74 65 2e 74 63 6c 2c 76 20 31 2e 31 36 20 32 30  te.tcl,v 1.16 20
0060: 30 31 2f 31 31 2f 32 34 20 31 33 3a 32 33 3a 30  01/11/24 13:23:0
0070: 35 20 64 72 68 20 45 78 70 20 24 7d 0a 0a 70 75  5 drh Exp $}..pu
0080: 74 73 20 7b 3c 68 74 6d 6c 3e 0a 3c 68 65 61 64  ts {<html>.<head
0090: 3e 0a 20 20 3c 74 69 74 6c 65 3e 73 71 6c 69 74  >.  <title>sqlit
00a0: 65 3a 20 41 20 70 72 6f 67 72 61 6d 20 6f 66 20  e: A program of 
00b0: 69 6e 74 65 72 61 63 74 69 6e 67 20 77 69 74 68  interacting with
00c0: 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65   SQLite database
00d0: 73 3c 2f 74 69 74 6c 65 3e 0a 3c 2f 68 65 61 64  s</title>.</head
00e0: 3e 0a 3c 62 6f 64 79 20 62 67 63 6f 6c 6f 72 3d  >.<body bgcolor=
00f0: 77 68 69 74 65 3e 0a 3c 68 31 20 61 6c 69 67 6e  white>.<h1 align
0100: 3d 63 65 6e 74 65 72 3e 0a 73 71 6c 69 74 65 3a  =center>.sqlite:
0110: 20 41 20 70 72 6f 67 72 61 6d 20 74 6f 20 61 64   A program to ad
0120: 6d 69 6e 69 73 74 65 72 20 53 51 4c 69 74 65 20  minister SQLite 
0130: 64 61 74 61 62 61 73 65 73 0a 3c 2f 68 31 3e 7d  databases.</h1>}
0140: 0a 70 75 74 73 20 22 3c 70 20 61 6c 69 67 6e 3d  .puts "<p align=
0150: 63 65 6e 74 65 72 3e 0a 28 54 68 69 73 20 70 61  center>.(This pa
0160: 67 65 20 77 61 73 20 6c 61 73 74 20 6d 6f 64 69  ge was last modi
0170: 66 69 65 64 20 6f 6e 20 5b 6c 72 61 6e 67 65 20  fied on [lrange 
0180: 24 72 63 73 69 64 20 33 20 34 5d 20 55 54 43 29  $rcsid 3 4] UTC)
0190: 0a 3c 2f 70 3e 22 0a 0a 70 75 74 73 20 7b 0a 3c  .</p>"..puts {.<
01a0: 70 3e 54 68 65 20 53 51 4c 69 74 65 20 6c 69 62  p>The SQLite lib
01b0: 72 61 72 79 20 69 6e 63 6c 75 64 65 73 20 61 20  rary includes a 
01c0: 73 69 6d 70 6c 65 20 63 6f 6d 6d 61 6e 64 2d 6c  simple command-l
01d0: 69 6e 65 20 75 74 69 6c 69 74 79 20 6e 61 6d 65  ine utility name
01e0: 64 0a 3c 62 3e 73 71 6c 69 74 65 3c 2f 62 3e 20  d.<b>sqlite</b> 
01f0: 74 68 61 74 20 61 6c 6c 6f 77 73 20 74 68 65 20  that allows the 
0200: 75 73 65 72 20 74 6f 20 6d 61 6e 75 61 6c 6c 79  user to manually
0210: 20 65 6e 74 65 72 20 61 6e 64 20 65 78 65 63 75   enter and execu
0220: 74 65 20 53 51 4c 0a 63 6f 6d 6d 61 6e 64 73 20  te SQL.commands 
0230: 61 67 61 69 6e 73 74 20 61 6e 20 53 51 4c 69 74  against an SQLit
0240: 65 20 64 61 74 61 62 61 73 65 2e 20 20 54 68 69  e database.  Thi
0250: 73 20 64 6f 63 75 6d 65 6e 74 20 70 72 6f 76 69  s document provi
0260: 64 65 73 20 61 20 62 72 69 65 66 0a 69 6e 74 72  des a brief.intr
0270: 6f 64 75 63 74 69 6f 6e 20 6f 6e 20 68 6f 77 20  oduction on how 
0280: 74 6f 20 75 73 65 20 3c 62 3e 73 71 6c 69 74 65  to use <b>sqlite
0290: 3c 2f 62 3e 2e 0a 0a 3c 68 32 3e 47 65 74 74 69  </b>...<h2>Getti
02a0: 6e 67 20 53 74 61 72 74 65 64 3c 2f 68 32 3e 0a  ng Started</h2>.
02b0: 0a 3c 70 3e 54 6f 20 73 74 61 72 74 20 74 68 65  .<p>To start the
02c0: 20 3c 62 3e 73 71 6c 69 74 65 3c 2f 62 3e 20 70   <b>sqlite</b> p
02d0: 72 6f 67 72 61 6d 2c 20 6a 75 73 74 20 74 79 70  rogram, just typ
02e0: 65 20 22 73 71 6c 69 74 65 22 20 66 6f 6c 6c 6f  e "sqlite" follo
02f0: 77 65 64 20 62 79 0a 74 68 65 20 6e 61 6d 65 20  wed by.the name 
0300: 74 68 65 20 66 69 6c 65 20 74 68 61 74 20 68 6f  the file that ho
0310: 6c 64 73 20 74 68 65 20 53 51 4c 69 74 65 20 64  lds the SQLite d
0320: 61 74 61 62 61 73 65 2e 20 20 49 66 20 74 68 65  atabase.  If the
0330: 20 66 69 6c 65 20 64 6f 65 73 0a 6e 6f 74 20 65   file does.not e
0340: 78 69 73 74 2c 20 61 20 6e 65 77 20 6f 6e 65 20  xist, a new one 
0350: 69 73 20 63 72 65 61 74 65 64 20 61 75 74 6f 6d  is created autom
0360: 61 74 69 63 61 6c 6c 79 2e 0a 54 68 65 20 3c 62  atically..The <b
0370: 3e 73 71 6c 69 74 65 3c 2f 62 3e 20 70 72 6f 67  >sqlite</b> prog
0380: 72 61 6d 20 77 69 6c 6c 0a 74 68 65 6e 20 70 72  ram will.then pr
0390: 6f 6d 70 74 20 79 6f 75 20 74 6f 20 65 6e 74 65  ompt you to ente
03a0: 72 20 53 51 4c 2e 20 20 54 79 70 65 20 69 6e 20  r SQL.  Type in 
03b0: 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20 28  SQL statements (
03c0: 74 65 72 6d 69 6e 61 74 65 64 20 62 79 20 61 0a  terminated by a.
03d0: 73 65 6d 69 63 6f 6c 6f 6e 29 2c 20 70 72 65 73  semicolon), pres
03e0: 73 20 22 45 6e 74 65 72 22 20 61 6e 64 20 74 68  s "Enter" and th
03f0: 65 20 53 51 4c 20 77 69 6c 6c 20 62 65 20 65 78  e SQL will be ex
0400: 65 63 75 74 65 64 2e 3c 2f 70 3e 0a 0a 3c 70 3e  ecuted.</p>..<p>
0410: 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20  For example, to 
0420: 63 72 65 61 74 65 20 61 20 6e 65 77 20 53 51 4c  create a new SQL
0430: 69 74 65 20 64 61 74 61 62 61 73 65 20 6e 61 6d  ite database nam
0440: 65 64 20 22 65 78 31 22 20 0a 77 69 74 68 20 61  ed "ex1" .with a
0450: 20 73 69 6e 67 6c 65 20 74 61 62 6c 65 20 6e 61   single table na
0460: 6d 65 64 20 22 74 62 6c 31 22 2c 20 79 6f 75 20  med "tbl1", you 
0470: 6d 69 67 68 74 20 64 6f 20 74 68 69 73 3a 3c 2f  might do this:</
0480: 70 3e 0a 7d 0a 0a 70 72 6f 63 20 43 6f 64 65 20  p>.}..proc Code 
0490: 7b 62 6f 64 79 7d 20 7b 0a 20 20 70 75 74 73 20  {body} {.  puts 
04a0: 7b 3c 62 6c 6f 63 6b 71 75 6f 74 65 3e 3c 70 72  {<blockquote><pr
04b0: 65 3e 7d 0a 20 20 72 65 67 73 75 62 20 2d 61 6c  e>}.  regsub -al
04c0: 6c 20 7b 26 7d 20 5b 73 74 72 69 6e 67 20 74 72  l {&} [string tr
04d0: 69 6d 20 24 62 6f 64 79 5d 20 7b 5c 26 61 6d 70  im $body] {\&amp
04e0: 3b 7d 20 62 6f 64 79 0a 20 20 72 65 67 73 75 62  ;} body.  regsub
04f0: 20 2d 61 6c 6c 20 7b 3e 7d 20 24 62 6f 64 79 20   -all {>} $body 
0500: 7b 5c 26 67 74 3b 7d 20 62 6f 64 79 0a 20 20 72  {\&gt;} body.  r
0510: 65 67 73 75 62 20 2d 61 6c 6c 20 7b 3c 7d 20 24  egsub -all {<} $
0520: 62 6f 64 79 20 7b 5c 26 6c 74 3b 7d 20 62 6f 64  body {\&lt;} bod
0530: 79 0a 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20  y.  regsub -all 
0540: 7b 5c 28 5c 28 5c 28 7d 20 24 62 6f 64 79 20 7b  {\(\(\(} $body {
0550: 3c 66 6f 6e 74 20 63 6f 6c 6f 72 3d 22 23 30 30  <font color="#00
0560: 36 37 31 66 22 3e 3c 75 3e 7d 20 62 6f 64 79 0a  671f"><u>} body.
0570: 20 20 72 65 67 73 75 62 20 2d 61 6c 6c 20 7b 5c    regsub -all {\
0580: 29 5c 29 5c 29 7d 20 24 62 6f 64 79 20 7b 3c 2f  )\)\)} $body {</
0590: 75 3e 3c 2f 66 6f 6e 74 3e 7d 20 62 6f 64 79 0a  u></font>} body.
05a0: 20 20 70 75 74 73 20 24 62 6f 64 79 0a 20 20 70    puts $body.  p
05b0: 75 74 73 20 7b 3c 2f 70 72 65 3e 3c 2f 62 6c 6f  uts {</pre></blo
05c0: 63 6b 71 75 6f 74 65 3e 7d 0a 7d 0a 0a 43 6f 64  ckquote>}.}..Cod
05d0: 65 20 7b 0a 24 20 28 28 28 73 71 6c 69 74 65 20  e {.$ (((sqlite 
05e0: 65 78 31 29 29 29 0a 53 51 4c 69 74 65 20 76 65  ex1))).SQLite ve
05f0: 72 73 69 6f 6e 20 32 2e 30 2e 30 0a 45 6e 74 65  rsion 2.0.0.Ente
0600: 72 20 22 2e 68 65 6c 70 22 20 66 6f 72 20 69 6e  r ".help" for in
0610: 73 74 72 75 63 74 69 6f 6e 73 0a 73 71 6c 69 74  structions.sqlit
0620: 65 3e 20 28 28 28 63 72 65 61 74 65 20 74 61 62  e> (((create tab
0630: 6c 65 20 74 62 6c 31 28 6f 6e 65 20 76 61 72 63  le tbl1(one varc
0640: 68 61 72 28 31 30 29 2c 20 74 77 6f 20 73 6d 61  har(10), two sma
0650: 6c 6c 69 6e 74 29 3b 29 29 29 0a 73 71 6c 69 74  llint);))).sqlit
0660: 65 3e 20 28 28 28 69 6e 73 65 72 74 20 69 6e 74  e> (((insert int
0670: 6f 20 74 62 6c 31 20 76 61 6c 75 65 73 28 27 68  o tbl1 values('h
0680: 65 6c 6c 6f 21 27 2c 31 30 29 3b 29 29 29 0a 73  ello!',10);))).s
0690: 71 6c 69 74 65 3e 20 28 28 28 69 6e 73 65 72 74  qlite> (((insert
06a0: 20 69 6e 74 6f 20 74 62 6c 31 20 76 61 6c 75 65   into tbl1 value
06b0: 73 28 27 67 6f 6f 64 62 79 65 27 2c 20 32 30 29  s('goodbye', 20)
06c0: 3b 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28  ;))).sqlite> (((
06d0: 73 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62  select * from tb
06e0: 6c 31 3b 29 29 29 0a 68 65 6c 6c 6f 21 7c 31 30  l1;))).hello!|10
06f0: 0a 67 6f 6f 64 62 79 65 7c 32 30 0a 73 71 6c 69  .goodbye|20.sqli
0700: 74 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70  te>.}..puts {.<p
0710: 3e 28 49 6e 20 74 68 65 20 65 78 61 6d 70 6c 65  >(In the example
0720: 20 61 62 6f 76 65 2c 20 61 6e 64 20 69 6e 20 61   above, and in a
0730: 6c 6c 20 73 75 62 73 65 71 75 65 6e 74 20 65 78  ll subsequent ex
0740: 61 6d 70 6c 65 73 2c 20 74 68 65 20 63 6f 6d 6d  amples, the comm
0750: 61 6e 64 73 0a 79 6f 75 20 74 79 70 65 20 61 72  ands.you type ar
0760: 65 20 75 6e 64 65 72 6c 69 6e 65 64 20 61 6e 64  e underlined and
0770: 20 73 68 6f 77 6e 20 77 69 74 68 20 61 20 67 72   shown with a gr
0780: 65 65 6e 20 74 69 6e 74 20 61 6e 64 20 74 68 65  een tint and the
0790: 20 72 65 73 70 6f 6e 73 65 73 0a 66 72 6f 6d 20   responses.from 
07a0: 74 68 65 20 63 6f 6d 70 75 74 65 72 20 61 72 65  the computer are
07b0: 20 73 68 6f 77 6e 20 69 6e 20 62 6c 61 63 6b 20   shown in black 
07c0: 77 69 74 68 6f 75 74 20 75 6e 64 65 72 6c 69 6e  without underlin
07d0: 69 6e 67 2e 29 3c 2f 70 3e 0a 0a 3c 70 3e 59 6f  ing.)</p>..<p>Yo
07e0: 75 20 63 61 6e 20 74 65 72 6d 69 6e 61 74 65 20  u can terminate 
07f0: 74 68 65 20 73 71 6c 69 74 65 20 70 72 6f 67 72  the sqlite progr
0800: 61 6d 20 62 79 20 74 79 70 69 6e 67 20 79 6f 75  am by typing you
0810: 72 20 73 79 73 74 65 6d 73 0a 45 6e 64 2d 4f 66  r systems.End-Of
0820: 2d 46 69 6c 65 20 63 68 61 72 61 63 74 65 72 20  -File character 
0830: 28 75 73 75 61 6c 6c 79 20 61 20 43 6f 6e 74 72  (usually a Contr
0840: 6f 6c 2d 44 29 20 6f 72 20 74 68 65 20 69 6e 74  ol-D) or the int
0850: 65 72 72 75 70 74 0a 63 68 61 72 61 63 74 65 72  errupt.character
0860: 20 28 75 73 75 61 6c 6c 79 20 61 20 43 6f 6e 74   (usually a Cont
0870: 72 6f 6c 2d 43 29 2e 3c 2f 70 3e 0a 0a 3c 70 3e  rol-C).</p>..<p>
0880: 4d 61 6b 65 20 73 75 72 65 20 79 6f 75 20 74 79  Make sure you ty
0890: 70 65 20 61 20 73 65 6d 69 63 6f 6c 6f 6e 20 61  pe a semicolon a
08a0: 74 20 74 68 65 20 65 6e 64 20 6f 66 20 65 61 63  t the end of eac
08b0: 68 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 21 0a 54  h SQL command!.T
08c0: 68 65 20 73 71 6c 69 74 65 20 6c 6f 6f 6b 73 20  he sqlite looks 
08d0: 66 6f 72 20 61 20 73 65 6d 69 63 6f 6c 6f 6e 20  for a semicolon 
08e0: 74 6f 20 6b 6e 6f 77 20 77 68 65 6e 20 79 6f 75  to know when you
08f0: 72 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 20 69 73  r SQL command is
0900: 0a 63 6f 6d 70 6c 65 74 65 2e 20 20 49 66 20 79  .complete.  If y
0910: 6f 75 20 6f 6d 69 74 20 74 68 65 20 73 65 6d 69  ou omit the semi
0920: 63 6f 6c 6f 6e 2c 20 73 71 6c 69 74 65 20 77 69  colon, sqlite wi
0930: 6c 6c 20 67 69 76 65 20 79 6f 75 20 61 0a 63 6f  ll give you a.co
0940: 6e 74 69 6e 75 61 74 69 6f 6e 20 70 72 6f 6d 70  ntinuation promp
0950: 74 20 61 6e 64 20 77 61 69 74 20 66 6f 72 20 79  t and wait for y
0960: 6f 75 20 74 6f 20 65 6e 74 65 72 20 6d 6f 72 65  ou to enter more
0970: 20 74 65 78 74 20 74 6f 20 62 65 0a 61 64 64 65   text to be.adde
0980: 64 20 74 6f 20 74 68 65 20 63 75 72 72 65 6e 74  d to the current
0990: 20 53 51 4c 20 63 6f 6d 6d 61 6e 64 2e 20 20 54   SQL command.  T
09a0: 68 69 73 20 66 65 61 74 75 72 65 20 61 6c 6c 6f  his feature allo
09b0: 77 73 20 79 6f 75 20 74 6f 0a 65 6e 74 65 72 20  ws you to.enter 
09c0: 53 51 4c 20 63 6f 6d 6d 61 6e 64 73 20 74 68 61  SQL commands tha
09d0: 74 20 73 70 61 6e 20 6d 75 6c 74 69 70 6c 65 20  t span multiple 
09e0: 6c 69 6e 65 73 2e 20 20 46 6f 72 20 65 78 61 6d  lines.  For exam
09f0: 70 6c 65 3a 3c 2f 70 3e 0a 7d 0a 0a 43 6f 64 65  ple:</p>.}..Code
0a00: 20 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 43 52   {.sqlite> (((CR
0a10: 45 41 54 45 20 54 41 42 4c 45 20 74 62 6c 32 20  EATE TABLE tbl2 
0a20: 28 29 29 29 0a 20 20 20 2e 2e 2e 3e 20 28 28 28  ())).   ...> (((
0a30: 20 20 66 31 20 76 61 72 63 68 61 72 28 33 30 29    f1 varchar(30)
0a40: 20 70 72 69 6d 61 72 79 20 6b 65 79 2c 29 29 29   primary key,)))
0a50: 0a 20 20 20 2e 2e 2e 3e 20 28 28 28 20 20 66 32  .   ...> (((  f2
0a60: 20 74 65 78 74 2c 29 29 29 0a 20 20 20 2e 2e 2e   text,))).   ...
0a70: 3e 20 28 28 28 20 20 66 33 20 72 65 61 6c 29 29  > (((  f3 real))
0a80: 29 0a 20 20 20 2e 2e 2e 3e 20 28 28 28 29 3b 29  ).   ...> ((();)
0a90: 29 29 0a 73 71 6c 69 74 65 3e 20 0a 7d 0a 0a 70  )).sqlite> .}..p
0aa0: 75 74 73 20 7b 0a 0a 3c 68 32 3e 41 73 69 64 65  uts {..<h2>Aside
0ab0: 3a 20 51 75 65 72 79 69 6e 67 20 74 68 65 20 53  : Querying the S
0ac0: 51 4c 49 54 45 5f 4d 41 53 54 45 52 20 74 61 62  QLITE_MASTER tab
0ad0: 6c 65 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 20  le</h2>..<p>The 
0ae0: 64 61 74 61 62 61 73 65 20 73 63 68 65 6d 61 20  database schema 
0af0: 69 6e 20 61 6e 20 53 51 4c 69 74 65 20 64 61 74  in an SQLite dat
0b00: 61 62 61 73 65 20 69 73 20 73 74 6f 72 65 64 20  abase is stored 
0b10: 69 6e 0a 61 20 73 70 65 63 69 61 6c 20 74 61 62  in.a special tab
0b20: 6c 65 20 6e 61 6d 65 64 20 22 73 71 6c 69 74 65  le named "sqlite
0b30: 5f 6d 61 73 74 65 72 22 2e 0a 59 6f 75 20 63 61  _master"..You ca
0b40: 6e 20 65 78 65 63 75 74 65 20 22 53 45 4c 45 43  n execute "SELEC
0b50: 54 22 20 73 74 61 74 65 6d 65 6e 74 73 20 61 67  T" statements ag
0b60: 61 69 6e 73 74 20 74 68 65 0a 73 70 65 63 69 61  ainst the.specia
0b70: 6c 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72 20  l sqlite_master 
0b80: 74 61 62 6c 65 20 6a 75 73 74 20 6c 69 6b 65 20  table just like 
0b90: 61 6e 79 20 6f 74 68 65 72 20 74 61 62 6c 65 0a  any other table.
0ba0: 69 6e 20 61 6e 20 53 51 4c 69 74 65 20 64 61 74  in an SQLite dat
0bb0: 61 62 61 73 65 2e 20 20 46 6f 72 20 65 78 61 6d  abase.  For exam
0bc0: 70 6c 65 3a 3c 2f 70 3e 0a 7d 0a 0a 43 6f 64 65  ple:</p>.}..Code
0bd0: 20 7b 0a 24 20 28 28 28 73 71 6c 69 74 65 20 65   {.$ (((sqlite e
0be0: 78 31 29 29 29 0a 53 51 6c 69 74 65 20 76 72 65  x1))).SQlite vre
0bf0: 73 69 6f 6e 20 32 2e 30 2e 30 0a 45 6e 74 65 72  sion 2.0.0.Enter
0c00: 20 22 2e 68 65 6c 70 22 20 66 6f 72 20 69 6e 73   ".help" for ins
0c10: 74 72 75 63 74 69 6f 6e 73 0a 73 71 6c 69 74 65  tructions.sqlite
0c20: 3e 20 28 28 28 73 65 6c 65 63 74 20 2a 20 66 72  > (((select * fr
0c30: 6f 6d 20 73 71 6c 69 74 65 5f 6d 61 73 74 65 72  om sqlite_master
0c40: 3b 29 29 29 0a 20 20 20 20 74 79 70 65 20 3d 20  ;))).    type = 
0c50: 74 61 62 6c 65 0a 20 20 20 20 6e 61 6d 65 20 3d  table.    name =
0c60: 20 74 62 6c 31 0a 74 62 6c 5f 6e 61 6d 65 20 3d   tbl1.tbl_name =
0c70: 20 74 62 6c 31 0a 72 6f 6f 74 70 61 67 65 20 3d   tbl1.rootpage =
0c80: 20 33 0a 20 20 20 20 20 73 71 6c 20 3d 20 63 72   3.     sql = cr
0c90: 65 61 74 65 20 74 61 62 6c 65 20 74 62 6c 31 28  eate table tbl1(
0ca0: 6f 6e 65 20 76 61 72 63 68 61 72 28 31 30 29 2c  one varchar(10),
0cb0: 20 74 77 6f 20 73 6d 61 6c 6c 69 6e 74 29 0a 73   two smallint).s
0cc0: 71 6c 69 74 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b  qlite>.}..puts {
0cd0: 0a 3c 70 3e 0a 42 75 74 20 79 6f 75 20 63 61 6e  .<p>.But you can
0ce0: 6e 6f 74 20 65 78 65 63 75 74 65 20 44 52 4f 50  not execute DROP
0cf0: 20 54 41 42 4c 45 2c 20 55 50 44 41 54 45 2c 20   TABLE, UPDATE, 
0d00: 49 4e 53 45 52 54 20 6f 72 20 44 45 4c 45 54 45  INSERT or DELETE
0d10: 20 61 67 61 69 6e 73 74 0a 74 68 65 20 73 71 6c   against.the sql
0d20: 69 74 65 5f 6d 61 73 74 65 72 20 74 61 62 6c 65  ite_master table
0d30: 2e 20 20 54 68 65 20 73 71 6c 69 74 65 5f 6d 61  .  The sqlite_ma
0d40: 73 74 65 72 0a 74 61 62 6c 65 20 69 73 20 75 70  ster.table is up
0d50: 64 61 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61  dated automatica
0d60: 6c 6c 79 20 61 73 20 79 6f 75 20 63 72 65 61 74  lly as you creat
0d70: 65 20 6f 72 20 64 72 6f 70 20 74 61 62 6c 65 73  e or drop tables
0d80: 20 61 6e 64 0a 69 6e 64 69 63 65 73 20 66 72 6f   and.indices fro
0d90: 6d 20 74 68 65 20 64 61 74 61 62 61 73 65 2e 20  m the database. 
0da0: 20 59 6f 75 20 63 61 6e 20 6e 6f 74 20 6d 61 6b   You can not mak
0db0: 65 20 6d 61 6e 75 61 6c 20 63 68 61 6e 67 65 73  e manual changes
0dc0: 0a 74 6f 20 74 68 65 20 73 71 6c 69 74 65 5f 6d  .to the sqlite_m
0dd0: 61 73 74 65 72 20 74 61 62 6c 65 2e 0a 3c 2f 70  aster table..</p
0de0: 3e 0a 0a 3c 68 32 3e 53 70 65 63 69 61 6c 20 63  >..<h2>Special c
0df0: 6f 6d 6d 61 6e 64 73 20 74 6f 20 73 71 6c 69 74  ommands to sqlit
0e00: 65 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 4d 6f 73 74  e</h2>..<p>.Most
0e10: 20 6f 66 20 74 68 65 20 74 69 6d 65 2c 20 73 71   of the time, sq
0e20: 6c 69 74 65 20 6a 75 73 74 20 72 65 61 64 73 20  lite just reads 
0e30: 6c 69 6e 65 73 20 6f 66 20 69 6e 70 75 74 20 61  lines of input a
0e40: 6e 64 20 70 61 73 73 65 73 20 74 68 65 6d 0a 6f  nd passes them.o
0e50: 6e 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65 20  n to the SQLite 
0e60: 6c 69 62 72 61 72 79 20 66 6f 72 20 65 78 65 63  library for exec
0e70: 75 74 69 6f 6e 2e 0a 42 75 74 20 69 66 20 61 6e  ution..But if an
0e80: 20 69 6e 70 75 74 20 6c 69 6e 65 20 62 65 67 69   input line begi
0e90: 6e 73 20 77 69 74 68 20 61 20 64 6f 74 20 28 22  ns with a dot ("
0ea0: 2e 22 29 2c 20 74 68 65 6e 0a 74 68 61 74 20 6c  ."), then.that l
0eb0: 69 6e 65 20 69 73 20 69 6e 74 65 72 63 65 70 74  ine is intercept
0ec0: 65 64 20 61 6e 64 20 69 6e 74 65 72 70 72 65 74  ed and interpret
0ed0: 65 64 20 62 79 20 74 68 65 20 73 71 6c 69 74 65  ed by the sqlite
0ee0: 20 70 72 6f 67 72 61 6d 20 69 74 73 65 6c 66 2e   program itself.
0ef0: 0a 54 68 65 73 65 20 22 64 6f 74 20 63 6f 6d 6d  .These "dot comm
0f00: 61 6e 64 73 22 20 61 72 65 20 74 79 70 69 63 61  ands" are typica
0f10: 6c 6c 79 20 75 73 65 64 20 74 6f 20 63 68 61 6e  lly used to chan
0f20: 67 65 20 74 68 65 20 6f 75 74 70 75 74 20 66 6f  ge the output fo
0f30: 72 6d 61 74 0a 6f 66 20 71 75 65 72 69 65 73 2c  rmat.of queries,
0f40: 20 6f 72 20 74 6f 20 65 78 65 63 75 74 65 20 63   or to execute c
0f50: 65 72 74 61 69 6e 20 70 72 65 70 61 63 6b 61 67  ertain prepackag
0f60: 65 64 20 71 75 65 72 79 20 73 74 61 74 65 6d 65  ed query stateme
0f70: 6e 74 73 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 46  nts..</p>..<p>.F
0f80: 6f 72 20 61 20 6c 69 73 74 69 6e 67 20 6f 66 20  or a listing of 
0f90: 74 68 65 20 61 76 61 69 6c 61 62 6c 65 20 64 6f  the available do
0fa0: 74 20 63 6f 6d 6d 61 6e 64 73 2c 20 79 6f 75 20  t commands, you 
0fb0: 63 61 6e 20 65 6e 74 65 72 20 22 2e 68 65 6c 70  can enter ".help
0fc0: 22 0a 61 74 20 61 6e 79 20 74 69 6d 65 2e 20 20  ".at any time.  
0fd0: 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 3c 2f 70  For example:.</p
0fe0: 3e 7d 0a 0a 43 6f 64 65 20 7b 0a 73 71 6c 69 74  >}..Code {.sqlit
0ff0: 65 3e 20 28 28 28 2e 68 65 6c 70 29 29 29 0a 2e  e> (((.help)))..
1000: 64 75 6d 70 20 20 20 20 20 20 20 20 20 20 20 20  dump            
1010: 20 20 20 20 20 20 44 75 6d 70 20 64 61 74 61 62        Dump datab
1020: 61 73 65 20 69 6e 20 61 20 74 65 78 74 20 66 6f  ase in a text fo
1030: 72 6d 61 74 0a 2e 65 78 69 74 20 20 20 20 20 20  rmat..exit      
1040: 20 20 20 20 20 20 20 20 20 20 20 20 45 78 69 74              Exit
1050: 20 74 68 69 73 20 70 72 6f 67 72 61 6d 0a 2e 65   this program..e
1060: 78 70 6c 61 69 6e 20 20 20 20 20 20 20 20 20 20  xplain          
1070: 20 20 20 20 20 53 65 74 20 6f 75 74 70 75 74 20       Set output 
1080: 6d 6f 64 65 20 73 75 69 74 61 62 6c 65 20 66 6f  mode suitable fo
1090: 72 20 45 58 50 4c 41 49 4e 0a 2e 68 65 61 64 65  r EXPLAIN..heade
10a0: 72 20 4f 4e 7c 4f 46 46 20 20 20 20 20 20 20 20  r ON|OFF        
10b0: 20 54 75 72 6e 20 64 69 73 70 6c 61 79 20 6f 66   Turn display of
10c0: 20 68 65 61 64 65 72 73 20 6f 6e 20 6f 72 20 6f   headers on or o
10d0: 66 66 0a 2e 68 65 6c 70 20 20 20 20 20 20 20 20  ff..help        
10e0: 20 20 20 20 20 20 20 20 20 20 53 68 6f 77 20 74            Show t
10f0: 68 69 73 20 6d 65 73 73 61 67 65 0a 2e 69 6e 64  his message..ind
1100: 69 63 65 73 20 54 41 42 4c 45 20 20 20 20 20 20  ices TABLE      
1110: 20 20 20 53 68 6f 77 20 6e 61 6d 65 73 20 6f 66     Show names of
1120: 20 61 6c 6c 20 69 6e 64 69 63 65 73 20 6f 6e 20   all indices on 
1130: 54 41 42 4c 45 0a 2e 6d 6f 64 65 20 4d 4f 44 45  TABLE..mode MODE
1140: 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65 74               Set
1150: 20 6d 6f 64 65 20 74 6f 20 6f 6e 65 20 6f 66 20   mode to one of 
1160: 22 6c 69 6e 65 22 2c 20 22 63 6f 6c 75 6d 6e 22  "line", "column"
1170: 2c 20 22 6c 69 73 74 22 2c 20 6f 72 20 22 68 74  , "list", or "ht
1180: 6d 6c 22 0a 2e 6d 6f 64 65 20 69 6e 73 65 72 74  ml"..mode insert
1190: 20 54 41 42 4c 45 20 20 20 20 20 47 65 6e 65 72   TABLE     Gener
11a0: 61 74 65 20 53 51 4c 20 69 6e 73 65 72 74 20 73  ate SQL insert s
11b0: 74 61 74 65 6d 65 6e 74 73 20 66 6f 72 20 54 41  tatements for TA
11c0: 42 4c 45 0a 2e 6f 75 74 70 75 74 20 46 49 4c 45  BLE..output FILE
11d0: 4e 41 4d 45 20 20 20 20 20 20 20 53 65 6e 64 20  NAME       Send 
11e0: 6f 75 74 70 75 74 20 74 6f 20 46 49 4c 45 4e 41  output to FILENA
11f0: 4d 45 0a 2e 6f 75 74 70 75 74 20 73 74 64 6f 75  ME..output stdou
1200: 74 20 20 20 20 20 20 20 20 20 53 65 6e 64 20 6f  t         Send o
1210: 75 74 70 75 74 20 74 6f 20 74 68 65 20 73 63 72  utput to the scr
1220: 65 65 6e 0a 2e 73 63 68 65 6d 61 20 3f 54 41 42  een..schema ?TAB
1230: 4c 45 3f 20 20 20 20 20 20 20 20 53 68 6f 77 20  LE?        Show 
1240: 74 68 65 20 43 52 45 41 54 45 20 73 74 61 74 65  the CREATE state
1250: 6d 65 6e 74 73 0a 2e 73 65 70 61 72 61 74 6f 72  ments..separator
1260: 20 53 54 52 49 4e 47 20 20 20 20 20 20 43 68 61   STRING      Cha
1270: 6e 67 65 20 73 65 70 61 72 61 74 6f 72 20 73 74  nge separator st
1280: 72 69 6e 67 20 66 6f 72 20 22 6c 69 73 74 22 20  ring for "list" 
1290: 6d 6f 64 65 0a 2e 74 61 62 6c 65 73 20 20 20 20  mode..tables    
12a0: 20 20 20 20 20 20 20 20 20 20 20 20 4c 69 73 74              List
12b0: 20 6e 61 6d 65 73 20 61 6c 6c 20 74 61 62 6c 65   names all table
12c0: 73 20 69 6e 20 74 68 65 20 64 61 74 61 62 61 73  s in the databas
12d0: 65 0a 2e 74 69 6d 65 6f 75 74 20 4d 53 20 20 20  e..timeout MS   
12e0: 20 20 20 20 20 20 20 20 20 54 72 79 20 6f 70 65           Try ope
12f0: 6e 69 6e 67 20 6c 6f 63 6b 65 64 20 74 61 62 6c  ning locked tabl
1300: 65 73 20 66 6f 72 20 4d 53 20 6d 69 6c 6c 69 73  es for MS millis
1310: 65 63 6f 6e 64 73 0a 2e 77 69 64 74 68 20 4e 55  econds..width NU
1320: 4d 20 4e 55 4d 20 2e 2e 2e 20 20 20 20 20 53 65  M NUM ...     Se
1330: 74 20 63 6f 6c 75 6d 6e 20 77 69 64 74 68 73 20  t column widths 
1340: 66 6f 72 20 22 63 6f 6c 75 6d 6e 22 20 6d 6f 64  for "column" mod
1350: 65 0a 73 71 6c 69 74 65 3e 20 0a 7d 0a 0a 70 75  e.sqlite> .}..pu
1360: 74 73 20 7b 0a 3c 68 32 3e 43 68 61 6e 67 69 6e  ts {.<h2>Changin
1370: 67 20 4f 75 74 70 75 74 20 46 6f 72 6d 61 74 73  g Output Formats
1380: 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 20 73 71  </h2>..<p>The sq
1390: 6c 69 74 65 20 70 72 6f 67 72 61 6d 20 69 73 20  lite program is 
13a0: 61 62 6c 65 20 74 6f 20 73 68 6f 77 20 74 68 65  able to show the
13b0: 20 72 65 73 75 6c 74 73 20 6f 66 20 61 20 71 75   results of a qu
13c0: 65 72 79 0a 69 6e 20 66 69 76 65 20 64 69 66 66  ery.in five diff
13d0: 65 72 65 6e 74 20 66 6f 72 6d 61 74 73 3a 20 22  erent formats: "
13e0: 6c 69 6e 65 22 2c 20 22 63 6f 6c 75 6d 6e 22 2c  line", "column",
13f0: 20 22 6c 69 73 74 22 2c 20 22 68 74 6d 6c 22 2c   "list", "html",
1400: 20 61 6e 64 20 22 69 6e 73 65 72 74 22 2e 0a 59   and "insert"..Y
1410: 6f 75 20 63 61 6e 20 75 73 65 20 74 68 65 20 22  ou can use the "
1420: 2e 6d 6f 64 65 22 20 64 6f 74 20 63 6f 6d 6d 61  .mode" dot comma
1430: 6e 64 20 74 6f 20 73 77 69 74 63 68 20 62 65 74  nd to switch bet
1440: 77 65 65 6e 20 74 68 65 73 65 20 74 68 72 65 65  ween these three
1450: 20 6f 75 74 70 75 74 0a 66 6f 72 6d 61 74 73 2e   output.formats.
1460: 3c 2f 70 3e 0a 0a 3c 70 3e 54 68 65 20 64 65 66  </p>..<p>The def
1470: 61 75 6c 74 20 6f 75 74 70 75 74 20 6d 6f 64 65  ault output mode
1480: 20 69 73 20 22 6c 69 73 74 22 2e 20 20 49 6e 0a   is "list".  In.
1490: 6c 69 73 74 20 6d 6f 64 65 2c 20 65 61 63 68 20  list mode, each 
14a0: 72 65 63 6f 72 64 20 6f 66 20 61 20 71 75 65 72  record of a quer
14b0: 79 20 72 65 73 75 6c 74 20 69 73 20 77 72 69 74  y result is writ
14c0: 74 65 6e 20 6f 6e 20 6f 6e 65 20 6c 69 6e 65 20  ten on one line 
14d0: 6f 66 0a 6f 75 74 70 75 74 20 61 6e 64 20 65 61  of.output and ea
14e0: 63 68 20 63 6f 6c 75 6d 6e 20 77 69 74 68 69 6e  ch column within
14f0: 20 74 68 61 74 20 72 65 63 6f 72 64 20 69 73 20   that record is 
1500: 73 65 70 61 72 61 74 65 64 20 62 79 20 61 20 73  separated by a s
1510: 70 65 63 69 66 69 63 0a 73 65 70 61 72 61 74 6f  pecific.separato
1520: 72 20 73 74 72 69 6e 67 2e 20 20 54 68 65 20 64  r string.  The d
1530: 65 66 61 75 6c 74 20 73 65 70 61 72 61 74 6f 72  efault separator
1540: 20 69 73 20 61 20 70 69 70 65 20 73 79 6d 62 6f   is a pipe symbo
1550: 6c 20 28 22 7c 22 29 2e 0a 4c 69 73 74 20 6d 6f  l ("|")..List mo
1560: 64 65 20 69 73 20 65 73 70 65 63 69 61 6c 6c 79  de is especially
1570: 20 75 73 65 66 75 6c 20 77 68 65 6e 20 79 6f 75   useful when you
1580: 20 61 72 65 20 67 6f 69 6e 67 20 74 6f 20 73 65   are going to se
1590: 6e 64 20 74 68 65 20 6f 75 74 70 75 74 0a 6f 66  nd the output.of
15a0: 20 61 20 71 75 65 72 79 20 74 6f 20 61 6e 6f 74   a query to anot
15b0: 68 65 72 20 70 72 6f 67 72 61 6d 20 28 73 75 63  her program (suc
15c0: 68 20 61 73 20 41 57 4b 29 20 66 6f 72 20 61 64  h as AWK) for ad
15d0: 64 69 74 69 6f 6e 61 6c 20 70 72 6f 63 65 73 73  ditional process
15e0: 69 6e 67 2e 3c 2f 70 3e 7d 0a 0a 43 6f 64 65 20  ing.</p>}..Code 
15f0: 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e 6d 6f  {.sqlite> (((.mo
1600: 64 65 20 6c 69 73 74 29 29 29 0a 73 71 6c 69 74  de list))).sqlit
1610: 65 3e 20 28 28 28 73 65 6c 65 63 74 20 2a 20 66  e> (((select * f
1620: 72 6f 6d 20 74 62 6c 31 3b 29 29 29 0a 68 65 6c  rom tbl1;))).hel
1630: 6c 6f 7c 31 30 0a 67 6f 6f 64 62 79 65 7c 32 30  lo|10.goodbye|20
1640: 0a 73 71 6c 69 74 65 3e 0a 7d 0a 0a 70 75 74 73  .sqlite>.}..puts
1650: 20 7b 0a 3c 70 3e 59 6f 75 20 63 61 6e 20 75 73   {.<p>You can us
1660: 65 20 74 68 65 20 22 2e 73 65 70 61 72 61 74 6f  e the ".separato
1670: 72 22 20 64 6f 74 20 63 6f 6d 6d 61 6e 64 20 74  r" dot command t
1680: 6f 20 63 68 61 6e 67 65 20 74 68 65 20 73 65 70  o change the sep
1690: 61 72 61 74 6f 72 0a 66 6f 72 20 6c 69 73 74 20  arator.for list 
16a0: 6d 6f 64 65 2e 20 20 46 6f 72 20 65 78 61 6d 70  mode.  For examp
16b0: 6c 65 2c 20 74 6f 20 63 68 61 6e 67 65 20 74 68  le, to change th
16c0: 65 20 73 65 70 61 72 61 74 6f 72 20 74 6f 20 61  e separator to a
16d0: 20 63 6f 6d 6d 61 20 61 6e 64 0a 61 20 73 70 61   comma and.a spa
16e0: 63 65 2c 20 79 6f 75 20 63 6f 75 6c 64 20 64 6f  ce, you could do
16f0: 20 74 68 69 73 3a 3c 2f 70 3e 7d 0a 0a 43 6f 64   this:</p>}..Cod
1700: 65 20 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e  e {.sqlite> (((.
1710: 73 65 70 61 72 61 74 6f 72 20 22 2c 20 22 29 29  separator ", "))
1720: 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 73 65 6c  ).sqlite> (((sel
1730: 65 63 74 20 2a 20 66 72 6f 6d 20 74 62 6c 31 3b  ect * from tbl1;
1740: 29 29 29 0a 68 65 6c 6c 6f 2c 20 31 30 0a 67 6f  ))).hello, 10.go
1750: 6f 64 62 79 65 2c 20 32 30 0a 73 71 6c 69 74 65  odbye, 20.sqlite
1760: 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 49  >.}..puts {.<p>I
1770: 6e 20 22 6c 69 6e 65 22 20 6d 6f 64 65 2c 20 65  n "line" mode, e
1780: 61 63 68 20 63 6f 6c 75 6d 6e 20 69 6e 20 61 20  ach column in a 
1790: 72 6f 77 20 6f 66 20 74 68 65 20 64 61 74 61 62  row of the datab
17a0: 61 73 65 0a 69 73 20 73 68 6f 77 6e 20 6f 6e 20  ase.is shown on 
17b0: 61 20 6c 69 6e 65 20 62 79 20 69 74 73 65 6c 66  a line by itself
17c0: 2e 20 20 45 61 63 68 20 6c 69 6e 65 20 63 6f 6e  .  Each line con
17d0: 73 69 73 74 73 20 6f 66 20 74 68 65 20 63 6f 6c  sists of the col
17e0: 75 6d 6e 0a 6e 61 6d 65 2c 20 61 6e 20 65 71 75  umn.name, an equ
17f0: 61 6c 20 73 69 67 6e 20 61 6e 64 20 74 68 65 20  al sign and the 
1800: 63 6f 6c 75 6d 6e 20 64 61 74 61 2e 20 20 53 75  column data.  Su
1810: 63 63 65 73 73 69 76 65 20 72 65 63 6f 72 64 73  ccessive records
1820: 20 61 72 65 0a 73 65 70 61 72 61 74 65 64 20 62   are.separated b
1830: 79 20 61 20 62 6c 61 6e 6b 20 6c 69 6e 65 2e 20  y a blank line. 
1840: 20 48 65 72 65 20 69 73 20 61 6e 20 65 78 61 6d   Here is an exam
1850: 70 6c 65 20 6f 66 20 6c 69 6e 65 20 6d 6f 64 65  ple of line mode
1860: 0a 6f 75 74 70 75 74 3a 3c 2f 70 3e 7d 0a 0a 43  .output:</p>}..C
1870: 6f 64 65 20 7b 0a 73 71 6c 69 74 65 3e 20 28 28  ode {.sqlite> ((
1880: 28 2e 6d 6f 64 65 20 6c 69 6e 65 29 29 29 0a 73  (.mode line))).s
1890: 71 6c 69 74 65 3e 20 28 28 28 73 65 6c 65 63 74  qlite> (((select
18a0: 20 2a 20 66 72 6f 6d 20 74 62 6c 31 3b 29 29 29   * from tbl1;)))
18b0: 0a 6f 6e 65 20 3d 20 68 65 6c 6c 6f 0a 74 77 6f  .one = hello.two
18c0: 20 3d 20 31 30 0a 0a 6f 6e 65 20 3d 20 67 6f 6f   = 10..one = goo
18d0: 64 62 79 65 0a 74 77 6f 20 3d 20 32 30 0a 73 71  dbye.two = 20.sq
18e0: 6c 69 74 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a  lite>.}..puts {.
18f0: 3c 70 3e 49 6e 20 63 6f 6c 75 6d 6e 20 6d 6f 64  <p>In column mod
1900: 65 2c 20 65 61 63 68 20 72 65 63 6f 72 64 20 69  e, each record i
1910: 73 20 73 68 6f 77 6e 20 6f 6e 20 61 20 73 65 70  s shown on a sep
1920: 61 72 61 74 65 20 6c 69 6e 65 20 77 69 74 68 20  arate line with 
1930: 74 68 65 0a 64 61 74 61 20 61 6c 69 67 6e 65 64  the.data aligned
1940: 20 69 6e 20 63 6f 6c 75 6d 6e 73 2e 20 20 46 6f   in columns.  Fo
1950: 72 20 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e 7d 0a  r example:</p>}.
1960: 0a 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65 3e 20  .Code {.sqlite> 
1970: 28 28 28 2e 6d 6f 64 65 20 63 6f 6c 75 6d 6e 29  (((.mode column)
1980: 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 73 65  )).sqlite> (((se
1990: 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62 6c 31  lect * from tbl1
19a0: 3b 29 29 29 0a 6f 6e 65 20 20 20 20 20 20 20 20  ;))).one        
19b0: 20 74 77 6f 20 20 20 20 20 20 20 0a 2d 2d 2d 2d   two       .----
19c0: 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d 2d 2d 2d 2d  ------  --------
19d0: 2d 2d 0a 68 65 6c 6c 6f 20 20 20 20 20 20 20 31  --.hello       1
19e0: 30 20 20 20 20 20 20 20 20 0a 67 6f 6f 64 62 79  0        .goodby
19f0: 65 20 20 20 20 20 32 30 20 20 20 20 20 20 20 20  e     20        
1a00: 0a 73 71 6c 69 74 65 3e 0a 7d 0a 0a 70 75 74 73  .sqlite>.}..puts
1a10: 20 7b 0a 3c 70 3e 42 79 20 64 65 66 61 75 6c 74   {.<p>By default
1a20: 2c 20 65 61 63 68 20 63 6f 6c 75 6d 6e 20 69 73  , each column is
1a30: 20 61 74 20 6c 65 61 73 74 20 31 30 20 63 68 61   at least 10 cha
1a40: 72 61 63 74 65 72 73 20 77 69 64 65 2e 20 0a 44  racters wide. .D
1a50: 61 74 61 20 74 68 61 74 20 69 73 20 74 6f 6f 20  ata that is too 
1a60: 77 69 64 65 20 74 6f 20 66 69 74 20 69 6e 20 61  wide to fit in a
1a70: 20 63 6f 6c 75 6d 6e 20 69 73 20 74 72 75 6e 63   column is trunc
1a80: 61 74 65 64 2e 20 20 59 6f 75 20 63 61 6e 0a 61  ated.  You can.a
1a90: 64 6a 75 73 74 20 74 68 65 20 63 6f 6c 75 6d 6e  djust the column
1aa0: 20 77 69 64 74 68 73 20 75 73 69 6e 67 20 74 68   widths using th
1ab0: 65 20 22 2e 77 69 64 74 68 22 20 63 6f 6d 6d 61  e ".width" comma
1ac0: 6e 64 2e 20 20 4c 69 6b 65 20 74 68 69 73 3a 3c  nd.  Like this:<
1ad0: 2f 70 3e 7d 0a 0a 43 6f 64 65 20 7b 0a 73 71 6c  /p>}..Code {.sql
1ae0: 69 74 65 3e 20 28 28 28 2e 77 69 64 74 68 20 31  ite> (((.width 1
1af0: 32 20 36 29 29 29 0a 73 71 6c 69 74 65 3e 20 28  2 6))).sqlite> (
1b00: 28 28 73 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20  ((select * from 
1b10: 74 62 6c 31 3b 29 29 29 0a 6f 6e 65 20 20 20 20  tbl1;))).one    
1b20: 20 20 20 20 20 20 20 74 77 6f 20 20 20 0a 2d 2d         two   .--
1b30: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d  ----------  ----
1b40: 2d 2d 0a 68 65 6c 6c 6f 20 20 20 20 20 20 20 20  --.hello        
1b50: 20 31 30 20 20 20 20 0a 67 6f 6f 64 62 79 65 20   10    .goodbye 
1b60: 20 20 20 20 20 20 32 30 20 20 20 20 0a 73 71 6c        20    .sql
1b70: 69 74 65 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c  ite>.}..puts {.<
1b80: 70 3e 54 68 65 20 22 2e 77 69 64 74 68 22 20 63  p>The ".width" c
1b90: 6f 6d 6d 61 6e 64 20 69 6e 20 74 68 65 20 65 78  ommand in the ex
1ba0: 61 6d 70 6c 65 20 61 62 6f 76 65 20 73 65 74 73  ample above sets
1bb0: 20 74 68 65 20 77 69 64 74 68 20 6f 66 20 74 68   the width of th
1bc0: 65 20 66 69 72 73 74 0a 63 6f 6c 75 6d 6e 20 74  e first.column t
1bd0: 6f 20 31 32 20 61 6e 64 20 74 68 65 20 77 69 64  o 12 and the wid
1be0: 74 68 20 6f 66 20 74 68 65 20 73 65 63 6f 6e 64  th of the second
1bf0: 20 63 6f 6c 75 6d 6e 20 74 6f 20 36 2e 20 20 41   column to 6.  A
1c00: 6c 6c 20 6f 74 68 65 72 20 63 6f 6c 75 6d 6e 0a  ll other column.
1c10: 77 69 64 74 68 73 20 77 65 72 65 20 75 6e 61 6c  widths were unal
1c20: 74 65 72 65 64 2e 20 20 59 6f 75 20 63 61 6e 20  tered.  You can 
1c30: 67 69 76 65 73 20 61 73 20 6d 61 6e 79 20 61 72  gives as many ar
1c40: 67 75 6d 65 6e 74 73 20 74 6f 20 22 2e 77 69 64  guments to ".wid
1c50: 74 68 22 20 61 73 0a 6e 65 63 65 73 73 61 72 79  th" as.necessary
1c60: 20 74 6f 20 73 70 65 63 69 66 79 20 74 68 65 20   to specify the 
1c70: 77 69 64 74 68 73 20 6f 66 20 61 73 20 6d 61 6e  widths of as man
1c80: 79 20 63 6f 6c 75 6d 6e 73 20 61 73 20 61 72 65  y columns as are
1c90: 20 69 6e 20 79 6f 75 72 0a 71 75 65 72 79 20 72   in your.query r
1ca0: 65 73 75 6c 74 73 2e 3c 2f 70 3e 0a 0a 3c 70 3e  esults.</p>..<p>
1cb0: 49 66 20 79 6f 75 20 73 70 65 63 69 66 79 20 61  If you specify a
1cc0: 20 63 6f 6c 75 6d 6e 20 61 20 77 69 64 74 68 20   column a width 
1cd0: 6f 66 20 30 2c 20 74 68 65 6e 20 74 68 65 20 63  of 0, then the c
1ce0: 6f 6c 75 6d 6e 0a 77 69 64 74 68 20 69 73 20 61  olumn.width is a
1cf0: 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20 61 64 6a  utomatically adj
1d00: 75 73 74 65 64 20 74 6f 20 62 65 20 74 68 65 20  usted to be the 
1d10: 6d 61 78 69 6d 75 6d 20 6f 66 20 74 68 72 65 65  maximum of three
1d20: 0a 6e 75 6d 62 65 72 73 3a 20 31 30 2c 20 74 68  .numbers: 10, th
1d30: 65 20 77 69 64 74 68 20 6f 66 20 74 68 65 20 68  e width of the h
1d40: 65 61 64 65 72 2c 20 61 6e 64 20 74 68 65 20 77  eader, and the w
1d50: 69 64 74 68 20 6f 66 20 74 68 65 0a 66 69 72 73  idth of the.firs
1d60: 74 20 72 6f 77 20 6f 66 20 64 61 74 61 2e 20 20  t row of data.  
1d70: 54 68 69 73 20 6d 61 6b 65 73 20 74 68 65 20 63  This makes the c
1d80: 6f 6c 75 6d 6e 20 77 69 64 74 68 20 73 65 6c 66  olumn width self
1d90: 2d 61 64 6a 75 73 74 69 6e 67 2e 0a 54 68 65 20  -adjusting..The 
1da0: 64 65 66 61 75 6c 74 20 77 69 64 74 68 20 73 65  default width se
1db0: 74 74 69 6e 67 20 66 6f 72 20 65 76 65 72 79 20  tting for every 
1dc0: 63 6f 6c 75 6d 6e 20 69 73 20 74 68 69 73 20 0a  column is this .
1dd0: 61 75 74 6f 2d 61 64 6a 75 73 74 69 6e 67 20 30  auto-adjusting 0
1de0: 20 76 61 6c 75 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e   value.</p>..<p>
1df0: 54 68 65 20 63 6f 6c 75 6d 6e 20 6c 61 62 65 6c  The column label
1e00: 73 20 74 68 61 74 20 61 70 70 65 61 72 20 6f 6e  s that appear on
1e10: 20 74 68 65 20 66 69 72 73 74 20 74 77 6f 20 6c   the first two l
1e20: 69 6e 65 73 20 6f 66 20 6f 75 74 70 75 74 0a 63  ines of output.c
1e30: 61 6e 20 62 65 20 74 75 72 6e 65 64 20 6f 6e 20  an be turned on 
1e40: 61 6e 64 20 6f 66 66 20 75 73 69 6e 67 20 74 68  and off using th
1e50: 65 20 22 2e 68 65 61 64 65 72 22 20 64 6f 74 20  e ".header" dot 
1e60: 63 6f 6d 6d 61 6e 64 2e 20 20 49 6e 20 74 68 65  command.  In the
1e70: 0a 65 78 61 6d 70 6c 65 73 20 61 62 6f 76 65 2c  .examples above,
1e80: 20 74 68 65 20 63 6f 6c 75 6d 6e 20 6c 61 62 65   the column labe
1e90: 6c 73 20 61 72 65 20 6f 6e 2e 20 20 54 6f 20 74  ls are on.  To t
1ea0: 75 72 6e 20 74 68 65 6d 20 6f 66 66 20 79 6f 75  urn them off you
1eb0: 0a 63 6f 75 6c 64 20 64 6f 20 74 68 69 73 3a 3c  .could do this:<
1ec0: 2f 70 3e 7d 0a 0a 43 6f 64 65 20 7b 0a 73 71 6c  /p>}..Code {.sql
1ed0: 69 74 65 3e 20 28 28 28 2e 68 65 61 64 65 72 20  ite> (((.header 
1ee0: 6f 66 66 29 29 29 0a 73 71 6c 69 74 65 3e 20 28  off))).sqlite> (
1ef0: 28 28 73 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20  ((select * from 
1f00: 74 62 6c 31 3b 29 29 29 0a 68 65 6c 6c 6f 20 20  tbl1;))).hello  
1f10: 20 20 20 20 20 20 20 31 30 20 20 20 20 0a 67 6f         10    .go
1f20: 6f 64 62 79 65 20 20 20 20 20 20 20 32 30 20 20  odbye       20  
1f30: 20 20 0a 73 71 6c 69 74 65 3e 0a 7d 0a 0a 70 75    .sqlite>.}..pu
1f40: 74 73 20 7b 0a 3c 70 3e 41 6e 6f 74 68 65 72 20  ts {.<p>Another 
1f50: 75 73 65 66 75 6c 20 6f 75 74 70 75 74 20 6d 6f  useful output mo
1f60: 64 65 20 69 73 20 22 69 6e 73 65 72 74 22 2e 20  de is "insert". 
1f70: 20 49 6e 20 69 6e 73 65 72 74 20 6d 6f 64 65 2c   In insert mode,
1f80: 20 74 68 65 20 6f 75 74 70 75 74 0a 69 73 20 66   the output.is f
1f90: 6f 72 6d 61 74 74 65 64 20 74 6f 20 6c 6f 6f 6b  ormatted to look
1fa0: 20 6c 69 6b 65 20 53 51 4c 20 49 4e 53 45 52 54   like SQL INSERT
1fb0: 20 73 74 61 74 65 6d 65 6e 74 73 2e 20 20 59 6f   statements.  Yo
1fc0: 75 20 63 61 6e 20 75 73 65 20 69 6e 73 65 72 74  u can use insert
1fd0: 0a 6d 6f 64 65 20 74 6f 20 67 65 6e 65 72 61 74  .mode to generat
1fe0: 65 20 74 65 78 74 20 74 68 61 74 20 63 61 6e 20  e text that can 
1ff0: 6c 61 74 65 72 20 62 65 20 75 73 65 64 20 74 6f  later be used to
2000: 20 69 6e 70 75 74 20 64 61 74 61 20 69 6e 74 6f   input data into
2010: 20 61 20 0a 64 69 66 66 65 72 65 6e 74 20 64 61   a .different da
2020: 74 61 62 61 73 65 2e 3c 2f 70 3e 0a 0a 3c 70 3e  tabase.</p>..<p>
2030: 57 68 65 6e 20 73 70 65 63 69 66 79 69 6e 67 20  When specifying 
2040: 69 6e 73 65 72 74 20 6d 6f 64 65 2c 20 79 6f 75  insert mode, you
2050: 20 68 61 76 65 20 74 6f 20 67 69 76 65 20 61 6e   have to give an
2060: 20 65 78 74 72 61 20 61 72 67 75 6d 65 6e 74 0a   extra argument.
2070: 77 68 69 63 68 20 69 73 20 74 68 65 20 6e 61 6d  which is the nam
2080: 65 20 6f 66 20 74 68 65 20 74 61 62 6c 65 20 74  e of the table t
2090: 6f 20 62 65 20 69 6e 73 65 72 74 65 64 20 69 6e  o be inserted in
20a0: 74 6f 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65  to.  For example
20b0: 3a 3c 2f 70 3e 0a 7d 0a 0a 43 6f 64 65 20 7b 0a  :</p>.}..Code {.
20c0: 73 71 6c 69 74 65 3e 20 28 28 28 2e 6d 6f 64 65  sqlite> (((.mode
20d0: 20 69 6e 73 65 72 74 20 6e 65 77 5f 74 61 62 6c   insert new_tabl
20e0: 65 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28  e))).sqlite> (((
20f0: 73 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62  select * from tb
2100: 6c 31 3b 29 29 29 0a 49 4e 53 45 52 54 20 49 4e  l1;))).INSERT IN
2110: 54 4f 20 27 6e 65 77 5f 74 61 62 6c 65 27 20 56  TO 'new_table' V
2120: 41 4c 55 45 53 28 27 68 65 6c 6c 6f 27 2c 31 30  ALUES('hello',10
2130: 29 3b 0a 49 4e 53 45 52 54 20 49 4e 54 4f 20 27  );.INSERT INTO '
2140: 6e 65 77 5f 74 61 62 6c 65 27 20 56 41 4c 55 45  new_table' VALUE
2150: 53 28 27 67 6f 6f 64 62 79 65 27 2c 32 30 29 3b  S('goodbye',20);
2160: 0a 73 71 6c 69 74 65 3e 0a 7d 0a 0a 70 75 74 73  .sqlite>.}..puts
2170: 20 7b 0a 3c 70 3e 54 68 65 20 6c 61 73 74 20 6f   {.<p>The last o
2180: 75 74 70 75 74 20 6d 6f 64 65 20 69 73 20 22 68  utput mode is "h
2190: 74 6d 6c 22 2e 20 20 49 6e 20 74 68 69 73 20 6d  tml".  In this m
21a0: 6f 64 65 2c 20 73 71 6c 69 74 65 20 77 72 69 74  ode, sqlite writ
21b0: 65 73 0a 74 68 65 20 72 65 73 75 6c 74 73 20 6f  es.the results o
21c0: 66 20 74 68 65 20 71 75 65 72 79 20 61 73 20 61  f the query as a
21d0: 6e 20 58 48 54 4d 4c 20 74 61 62 6c 65 2e 20 20  n XHTML table.  
21e0: 54 68 65 20 62 65 67 69 6e 6e 69 6e 67 0a 26 6c  The beginning.&l
21f0: 74 3b 54 41 42 4c 45 26 67 74 3b 20 61 6e 64 20  t;TABLE&gt; and 
2200: 74 68 65 20 65 6e 64 69 6e 67 20 26 6c 74 3b 2f  the ending &lt;/
2210: 54 41 42 4c 45 26 67 74 3b 20 61 72 65 20 6e 6f  TABLE&gt; are no
2220: 74 20 77 72 69 74 74 65 6e 2c 20 62 75 74 0a 61  t written, but.a
2230: 6c 6c 20 6f 66 20 74 68 65 20 69 6e 74 65 72 76  ll of the interv
2240: 65 6e 69 6e 67 20 26 6c 74 3b 54 52 26 67 74 3b  ening &lt;TR&gt;
2250: 73 2c 20 26 6c 74 3b 54 48 26 67 74 3b 73 2c 20  s, &lt;TH&gt;s, 
2260: 61 6e 64 20 26 6c 74 3b 54 44 26 67 74 3b 73 0a  and &lt;TD&gt;s.
2270: 61 72 65 2e 20 20 54 68 65 20 68 74 6d 6c 20 6f  are.  The html o
2280: 75 74 70 75 74 20 6d 6f 64 65 20 69 73 20 65 6e  utput mode is en
2290: 76 69 73 69 6f 6e 65 64 20 61 73 20 62 65 69 6e  visioned as bein
22a0: 67 20 75 73 65 66 75 6c 20 66 6f 72 0a 43 47 49  g useful for.CGI
22b0: 2e 3c 2f 70 3e 0a 7d 0a 0a 70 75 74 73 20 7b 0a  .</p>.}..puts {.
22c0: 3c 68 32 3e 57 72 69 74 69 6e 67 20 72 65 73 75  <h2>Writing resu
22d0: 6c 74 73 20 74 6f 20 61 20 66 69 6c 65 3c 2f 68  lts to a file</h
22e0: 32 3e 0a 0a 3c 70 3e 42 79 20 64 65 66 61 75 6c  2>..<p>By defaul
22f0: 74 2c 20 73 71 6c 69 74 65 20 73 65 6e 64 73 20  t, sqlite sends 
2300: 71 75 65 72 79 20 72 65 73 75 6c 74 73 20 74 6f  query results to
2310: 20 73 74 61 6e 64 61 72 64 20 6f 75 74 70 75 74   standard output
2320: 2e 20 20 59 6f 75 0a 63 61 6e 20 63 68 61 6e 67  .  You.can chang
2330: 65 20 74 68 69 73 20 75 73 69 6e 67 20 74 68 65  e this using the
2340: 20 22 2e 6f 75 74 70 75 74 22 20 63 6f 6d 6d 61   ".output" comma
2350: 6e 64 2e 20 20 4a 75 73 74 20 70 75 74 20 74 68  nd.  Just put th
2360: 65 20 6e 61 6d 65 20 6f 66 0a 61 6e 20 6f 75 74  e name of.an out
2370: 70 75 74 20 66 69 6c 65 20 61 73 20 61 6e 20 61  put file as an a
2380: 72 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 2e  rgument to the .
2390: 6f 75 74 70 75 74 20 63 6f 6d 6d 61 6e 64 20 61  output command a
23a0: 6e 64 20 61 6c 6c 20 73 75 62 73 65 71 75 65 6e  nd all subsequen
23b0: 74 0a 71 75 65 72 79 20 72 65 73 75 6c 74 73 20  t.query results 
23c0: 77 69 6c 6c 20 62 65 20 77 72 69 74 74 65 6e 20  will be written 
23d0: 74 6f 20 74 68 61 74 20 66 69 6c 65 2e 20 20 55  to that file.  U
23e0: 73 65 20 22 2e 6f 75 74 70 75 74 20 73 74 64 6f  se ".output stdo
23f0: 75 74 22 20 74 6f 0a 62 65 67 69 6e 20 77 72 69  ut" to.begin wri
2400: 74 69 6e 67 20 74 6f 20 73 74 61 6e 64 61 72 64  ting to standard
2410: 20 6f 75 74 70 75 74 20 61 67 61 69 6e 2e 20 20   output again.  
2420: 46 6f 72 20 65 78 61 6d 70 6c 65 3a 3c 2f 70 3e  For example:</p>
2430: 7d 0a 0a 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65  }..Code {.sqlite
2440: 3e 20 28 28 28 2e 6d 6f 64 65 20 6c 69 73 74 29  > (((.mode list)
2450: 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e 73  )).sqlite> (((.s
2460: 65 70 61 72 61 74 6f 72 20 7c 29 29 29 0a 73 71  eparator |))).sq
2470: 6c 69 74 65 3e 20 28 28 28 2e 6f 75 74 70 75 74  lite> (((.output
2480: 20 74 65 73 74 5f 66 69 6c 65 5f 31 2e 74 78 74   test_file_1.txt
2490: 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 73  ))).sqlite> (((s
24a0: 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74 62 6c  elect * from tbl
24b0: 31 3b 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28  1;))).sqlite> ((
24c0: 28 2e 65 78 69 74 29 29 29 0a 24 20 28 28 28 63  (.exit))).$ (((c
24d0: 61 74 20 74 65 73 74 5f 66 69 6c 65 5f 31 2e 74  at test_file_1.t
24e0: 78 74 29 29 29 0a 68 65 6c 6c 6f 7c 31 30 0a 67  xt))).hello|10.g
24f0: 6f 6f 64 62 79 65 7c 32 30 0a 24 0a 7d 0a 0a 70  oodbye|20.$.}..p
2500: 75 74 73 20 7b 0a 3c 68 32 3e 51 75 65 72 79 69  uts {.<h2>Queryi
2510: 6e 67 20 74 68 65 20 64 61 74 61 62 61 73 65 20  ng the database 
2520: 73 63 68 65 6d 61 3c 2f 68 32 3e 0a 0a 3c 70 3e  schema</h2>..<p>
2530: 54 68 65 20 73 71 6c 69 74 65 20 70 72 6f 67 72  The sqlite progr
2540: 61 6d 20 70 72 6f 76 69 64 65 73 20 73 65 76 65  am provides seve
2550: 72 61 6c 20 63 6f 6e 76 65 6e 69 65 6e 63 65 20  ral convenience 
2560: 63 6f 6d 6d 61 6e 64 73 20 74 68 61 74 0a 61 72  commands that.ar
2570: 65 20 75 73 65 66 75 6c 20 66 6f 72 20 6c 6f 6f  e useful for loo
2580: 6b 69 6e 67 20 61 74 20 74 68 65 20 73 63 68 65  king at the sche
2590: 6d 61 20 6f 66 20 74 68 65 20 64 61 74 61 62 61  ma of the databa
25a0: 73 65 2e 20 20 54 68 65 72 65 20 69 73 0a 6e 6f  se.  There is.no
25b0: 74 68 69 6e 67 20 74 68 61 74 20 74 68 65 73 65  thing that these
25c0: 20 63 6f 6d 6d 61 6e 64 73 20 64 6f 20 74 68 61   commands do tha
25d0: 74 20 63 61 6e 6e 6f 74 20 62 65 20 64 6f 6e 65  t cannot be done
25e0: 20 62 79 20 73 6f 6d 65 20 6f 74 68 65 72 0a 6d   by some other.m
25f0: 65 61 6e 73 2e 20 20 54 68 65 73 65 20 63 6f 6d  eans.  These com
2600: 6d 61 6e 64 73 20 61 72 65 20 70 72 6f 76 69 64  mands are provid
2610: 65 64 20 70 75 72 65 6c 79 20 61 73 20 61 20 73  ed purely as a s
2620: 68 6f 72 74 63 75 74 2e 3c 2f 70 3e 0a 0a 3c 70  hortcut.</p>..<p
2630: 3e 46 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f  >For example, to
2640: 20 73 65 65 20 61 20 6c 69 73 74 20 6f 66 20 74   see a list of t
2650: 68 65 20 74 61 62 6c 65 73 20 69 6e 20 74 68 65  he tables in the
2660: 20 64 61 74 61 62 61 73 65 2c 20 79 6f 75 0a 63   database, you.c
2670: 61 6e 20 65 6e 74 65 72 20 22 2e 74 61 62 6c 65  an enter ".table
2680: 73 22 2e 3c 2f 70 3e 0a 7d 0a 0a 43 6f 64 65 20  s".</p>.}..Code 
2690: 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e 74 61  {.sqlite> (((.ta
26a0: 62 6c 65 73 29 29 29 0a 74 62 6c 31 0a 74 62 6c  bles))).tbl1.tbl
26b0: 32 0a 73 71 6c 69 74 65 3e 0a 7d 0a 0a 70 75 74  2.sqlite>.}..put
26c0: 73 20 7b 0a 3c 70 3e 54 68 65 20 22 2e 74 61 62  s {.<p>The ".tab
26d0: 6c 65 73 22 20 63 6f 6d 6d 61 6e 64 20 69 73 20  les" command is 
26e0: 74 68 65 20 73 61 6d 65 20 61 73 20 73 65 74 74  the same as sett
26f0: 69 6e 67 20 6c 69 73 74 20 6d 6f 64 65 20 74 68  ing list mode th
2700: 65 6e 0a 65 78 65 63 75 74 69 6e 67 20 74 68 65  en.executing the
2710: 20 66 6f 6c 6c 6f 77 69 6e 67 20 71 75 65 72 79   following query
2720: 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f  :</p>..<blockquo
2730: 74 65 3e 3c 70 72 65 3e 0a 53 45 4c 45 43 54 20  te><pre>.SELECT 
2740: 6e 61 6d 65 20 46 52 4f 4d 20 73 71 6c 69 74 65  name FROM sqlite
2750: 5f 6d 61 73 74 65 72 20 0a 57 48 45 52 45 20 74  _master .WHERE t
2760: 79 70 65 3d 27 74 61 62 6c 65 27 20 0a 4f 52 44  ype='table' .ORD
2770: 45 52 20 42 59 20 6e 61 6d 65 3b 0a 3c 2f 70 72  ER BY name;.</pr
2780: 65 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a  e></blockquote>.
2790: 0a 3c 70 3e 49 6e 20 66 61 63 74 2c 20 69 66 20  .<p>In fact, if 
27a0: 79 6f 75 20 6c 6f 6f 6b 20 61 74 20 74 68 65 20  you look at the 
27b0: 73 6f 75 72 63 65 20 63 6f 64 65 20 74 6f 20 74  source code to t
27c0: 68 65 20 73 71 6c 69 74 65 20 70 72 6f 67 72 61  he sqlite progra
27d0: 6d 0a 28 66 6f 75 6e 64 20 69 6e 20 74 68 65 20  m.(found in the 
27e0: 73 6f 75 72 63 65 20 74 72 65 65 20 69 6e 20 74  source tree in t
27f0: 68 65 20 66 69 6c 65 20 73 72 63 2f 73 68 65 6c  he file src/shel
2800: 6c 2e 63 29 20 79 6f 75 27 6c 6c 20 66 69 6e 64  l.c) you'll find
2810: 0a 65 78 61 63 74 6c 79 20 74 68 65 20 61 62 6f  .exactly the abo
2820: 76 65 20 71 75 65 72 79 2e 3c 2f 70 3e 0a 0a 3c  ve query.</p>..<
2830: 70 3e 54 68 65 20 22 2e 69 6e 64 69 63 65 73 22  p>The ".indices"
2840: 20 63 6f 6d 6d 61 6e 64 20 77 6f 72 6b 73 20 69   command works i
2850: 6e 20 61 20 73 69 6d 69 6c 61 72 20 77 61 79 20  n a similar way 
2860: 74 6f 20 6c 69 73 74 20 61 6c 6c 20 6f 66 0a 74  to list all of.t
2870: 68 65 20 69 6e 64 69 63 65 73 20 66 6f 72 20 61  he indices for a
2880: 20 70 61 72 74 69 63 75 6c 61 72 20 74 61 62 6c   particular tabl
2890: 65 2e 20 20 54 68 65 20 22 2e 69 6e 64 69 63 65  e.  The ".indice
28a0: 73 22 20 63 6f 6d 6d 61 6e 64 20 74 61 6b 65 73  s" command takes
28b0: 0a 61 20 73 69 6e 67 6c 65 20 61 72 67 75 6d 65  .a single argume
28c0: 6e 74 20 77 68 69 63 68 20 69 73 20 74 68 65 20  nt which is the 
28d0: 6e 61 6d 65 20 6f 66 20 74 68 65 20 74 61 62 6c  name of the tabl
28e0: 65 20 66 6f 72 20 77 68 69 63 68 20 74 68 65 0a  e for which the.
28f0: 69 6e 64 69 63 65 73 20 61 72 65 20 64 65 73 69  indices are desi
2900: 72 65 64 2e 20 20 4c 61 73 74 2c 20 62 75 74 20  red.  Last, but 
2910: 6e 6f 74 20 6c 65 61 73 74 2c 20 69 73 20 74 68  not least, is th
2920: 65 20 22 2e 73 63 68 65 6d 61 22 20 63 6f 6d 6d  e ".schema" comm
2930: 61 6e 64 2e 0a 57 69 74 68 20 6e 6f 20 61 72 67  and..With no arg
2940: 75 6d 65 6e 74 73 2c 20 74 68 65 20 22 2e 73 63  uments, the ".sc
2950: 68 65 6d 61 22 20 63 6f 6d 6d 61 6e 64 20 73 68  hema" command sh
2960: 6f 77 73 20 74 68 65 20 6f 72 69 67 69 6e 61 6c  ows the original
2970: 20 43 52 45 41 54 45 20 54 41 42 4c 45 0a 61 6e   CREATE TABLE.an
2980: 64 20 43 52 45 41 54 45 20 49 4e 44 45 58 20 73  d CREATE INDEX s
2990: 74 61 74 65 6d 65 6e 74 73 20 74 68 61 74 20 77  tatements that w
29a0: 65 72 65 20 75 73 65 64 20 74 6f 20 62 75 69 6c  ere used to buil
29b0: 64 20 74 68 65 20 63 75 72 72 65 6e 74 20 64 61  d the current da
29c0: 74 61 62 61 73 65 2e 0a 49 66 20 79 6f 75 20 67  tabase..If you g
29d0: 69 76 65 20 74 68 65 20 6e 61 6d 65 20 6f 66 20  ive the name of 
29e0: 61 20 74 61 62 6c 65 20 74 6f 20 22 2e 73 63 68  a table to ".sch
29f0: 65 6d 61 22 2c 20 69 74 20 73 68 6f 77 73 20 74  ema", it shows t
2a00: 68 65 20 6f 72 69 67 69 6e 61 6c 0a 43 52 45 41  he original.CREA
2a10: 54 45 20 73 74 61 74 65 6d 65 6e 74 20 75 73 65  TE statement use
2a20: 64 20 74 6f 20 6d 61 6b 65 20 74 68 61 74 20 74  d to make that t
2a30: 61 62 6c 65 20 61 6e 64 20 61 6c 6c 20 69 66 20  able and all if 
2a40: 69 74 73 20 69 6e 64 69 63 65 73 2e 0a 57 65 20  its indices..We 
2a50: 68 61 76 65 3a 3c 2f 70 3e 7d 0a 0a 43 6f 64 65  have:</p>}..Code
2a60: 20 7b 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e 73   {.sqlite> (((.s
2a70: 63 68 65 6d 61 29 29 29 0a 63 72 65 61 74 65 20  chema))).create 
2a80: 74 61 62 6c 65 20 74 62 6c 31 28 6f 6e 65 20 76  table tbl1(one v
2a90: 61 72 63 68 61 72 28 31 30 29 2c 20 74 77 6f 20  archar(10), two 
2aa0: 73 6d 61 6c 6c 69 6e 74 29 0a 43 52 45 41 54 45  smallint).CREATE
2ab0: 20 54 41 42 4c 45 20 74 62 6c 32 20 28 0a 20 20   TABLE tbl2 (.  
2ac0: 66 31 20 76 61 72 63 68 61 72 28 33 30 29 20 70  f1 varchar(30) p
2ad0: 72 69 6d 61 72 79 20 6b 65 79 2c 0a 20 20 66 32  rimary key,.  f2
2ae0: 20 74 65 78 74 2c 0a 20 20 66 33 20 72 65 61 6c   text,.  f3 real
2af0: 0a 29 0a 73 71 6c 69 74 65 3e 20 28 28 28 2e 73  .).sqlite> (((.s
2b00: 63 68 65 6d 61 20 74 62 6c 32 29 29 29 0a 43 52  chema tbl2))).CR
2b10: 45 41 54 45 20 54 41 42 4c 45 20 74 62 6c 32 20  EATE TABLE tbl2 
2b20: 28 0a 20 20 66 31 20 76 61 72 63 68 61 72 28 33  (.  f1 varchar(3
2b30: 30 29 20 70 72 69 6d 61 72 79 20 6b 65 79 2c 0a  0) primary key,.
2b40: 20 20 66 32 20 74 65 78 74 2c 0a 20 20 66 33 20    f2 text,.  f3 
2b50: 72 65 61 6c 0a 29 0a 73 71 6c 69 74 65 3e 0a 7d  real.).sqlite>.}
2b60: 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68 65 20  ..puts {.<p>The 
2b70: 22 2e 73 63 68 65 6d 61 22 20 63 6f 6d 6d 61 6e  ".schema" comman
2b80: 64 20 61 63 63 6f 6d 70 6c 69 73 68 65 73 20 74  d accomplishes t
2b90: 68 65 20 73 61 6d 65 20 74 68 69 6e 67 20 61 73  he same thing as
2ba0: 20 73 65 74 74 69 6e 67 0a 6c 69 73 74 20 6d 6f   setting.list mo
2bb0: 64 65 2c 20 74 68 65 6e 20 65 6e 74 65 72 69 6e  de, then enterin
2bc0: 67 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 20  g the following 
2bd0: 71 75 65 72 79 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f  query:</p>..<blo
2be0: 63 6b 71 75 6f 74 65 3e 3c 70 72 65 3e 0a 53 45  ckquote><pre>.SE
2bf0: 4c 45 43 54 20 73 71 6c 20 46 52 4f 4d 20 73 71  LECT sql FROM sq
2c00: 6c 69 74 65 5f 6d 61 73 74 65 72 0a 57 48 45 52  lite_master.WHER
2c10: 45 20 74 79 70 65 21 3d 27 6d 65 74 61 27 0a 4f  E type!='meta'.O
2c20: 52 44 45 52 20 42 59 20 74 62 6c 5f 6e 61 6d 65  RDER BY tbl_name
2c30: 2c 20 74 79 70 65 20 44 45 53 43 2c 20 6e 61 6d  , type DESC, nam
2c40: 65 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63 6b 71  e.</pre></blockq
2c50: 75 6f 74 65 3e 0a 0a 3c 70 3e 4f 72 2c 20 69 66  uote>..<p>Or, if
2c60: 20 79 6f 75 20 67 69 76 65 20 61 6e 20 61 72 67   you give an arg
2c70: 75 6d 65 6e 74 20 74 6f 20 22 2e 73 63 68 65 6d  ument to ".schem
2c80: 61 22 20 62 65 63 61 75 73 65 20 79 6f 75 20 6f  a" because you o
2c90: 6e 6c 79 0a 77 61 6e 74 20 74 68 65 20 73 63 68  nly.want the sch
2ca0: 65 6d 61 20 66 6f 72 20 61 20 73 69 6e 67 6c 65  ema for a single
2cb0: 20 74 61 62 6c 65 2c 20 74 68 65 20 71 75 65 72   table, the quer
2cc0: 79 20 6c 6f 6f 6b 73 20 6c 69 6b 65 20 74 68 69  y looks like thi
2cd0: 73 3a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75  s:</p>..<blockqu
2ce0: 6f 74 65 3e 3c 70 72 65 3e 0a 53 45 4c 45 43 54  ote><pre>.SELECT
2cf0: 20 73 71 6c 20 46 52 4f 4d 20 73 71 6c 69 74 65   sql FROM sqlite
2d00: 5f 6d 61 73 74 65 72 0a 57 48 45 52 45 20 74 62  _master.WHERE tb
2d10: 6c 5f 6e 61 6d 65 20 4c 49 4b 45 20 27 25 73 27  l_name LIKE '%s'
2d20: 20 41 4e 44 20 74 79 70 65 21 3d 27 6d 65 74 61   AND type!='meta
2d30: 27 0a 4f 52 44 45 52 20 42 59 20 74 79 70 65 20  '.ORDER BY type 
2d40: 44 45 53 43 2c 20 6e 61 6d 65 0a 3c 2f 70 72 65  DESC, name.</pre
2d50: 3e 3c 2f 62 6c 6f 63 6b 71 75 6f 74 65 3e 0a 0a  ></blockquote>..
2d60: 3c 70 3e 54 68 65 20 3c 62 3e 25 73 3c 2f 62 3e  <p>The <b>%s</b>
2d70: 20 69 6e 20 74 68 65 20 71 75 65 72 79 20 61 62   in the query ab
2d80: 6f 76 65 20 69 73 20 72 65 70 6c 61 63 65 64 20  ove is replaced 
2d90: 62 79 20 74 68 65 20 61 72 67 75 6d 65 6e 74 0a  by the argument.
2da0: 74 6f 20 22 2e 73 63 68 65 6d 61 22 2c 20 6f 66  to ".schema", of
2db0: 20 63 6f 75 72 73 65 2e 20 20 4e 6f 74 69 63 65   course.  Notice
2dc0: 20 74 68 61 74 20 74 68 65 20 61 72 67 75 6d 65   that the argume
2dd0: 6e 74 20 74 6f 20 74 68 65 20 22 2e 73 63 68 65  nt to the ".sche
2de0: 6d 61 22 0a 63 6f 6d 6d 61 6e 64 20 61 70 70 65  ma".command appe
2df0: 61 72 73 20 74 6f 20 74 68 65 20 72 69 67 68 74  ars to the right
2e00: 20 6f 66 20 61 6e 20 53 51 4c 20 4c 49 4b 45 20   of an SQL LIKE 
2e10: 6f 70 65 72 61 74 6f 72 2e 20 20 53 6f 20 79 6f  operator.  So yo
2e20: 75 20 63 61 6e 0a 75 73 65 20 77 69 6c 64 63 61  u can.use wildca
2e30: 72 64 73 20 69 6e 20 74 68 65 20 6e 61 6d 65 20  rds in the name 
2e40: 6f 66 20 74 68 65 20 74 61 62 6c 65 2e 20 20 46  of the table.  F
2e50: 6f 72 20 65 78 61 6d 70 6c 65 2c 20 74 6f 20 67  or example, to g
2e60: 65 74 20 74 68 65 0a 73 63 68 65 6d 61 20 66 6f  et the.schema fo
2e70: 72 20 61 6c 6c 20 74 61 62 6c 65 73 20 77 68 6f  r all tables who
2e80: 73 65 20 6e 61 6d 65 73 20 63 6f 6e 74 61 69 6e  se names contain
2e90: 20 74 68 65 20 63 68 61 72 61 63 74 65 72 20 73   the character s
2ea0: 74 72 69 6e 67 0a 22 61 62 63 22 20 79 6f 75 20  tring."abc" you 
2eb0: 63 6f 75 6c 64 20 65 6e 74 65 72 3a 3c 2f 70 3e  could enter:</p>
2ec0: 7d 0a 0a 43 6f 64 65 20 7b 0a 73 71 6c 69 74 65  }..Code {.sqlite
2ed0: 3e 20 28 28 28 2e 73 63 68 65 6d 61 20 25 61 62  > (((.schema %ab
2ee0: 63 25 29 29 29 0a 7d 0a 0a 70 75 74 73 20 7b 0a  c%))).}..puts {.
2ef0: 3c 70 3e 0a 41 6c 6f 6e 67 20 74 68 65 73 65 20  <p>.Along these 
2f00: 73 61 6d 65 20 6c 69 6e 65 73 2c 0a 74 68 65 20  same lines,.the 
2f10: 22 2e 74 61 62 6c 65 22 20 63 6f 6d 6d 61 6e 64  ".table" command
2f20: 20 61 6c 73 6f 20 61 63 63 65 70 74 73 20 61 20   also accepts a 
2f30: 70 61 74 74 65 72 6e 20 61 73 20 69 74 73 20 66  pattern as its f
2f40: 69 72 73 74 20 61 72 67 75 6d 65 6e 74 2e 0a 49  irst argument..I
2f50: 66 20 79 6f 75 20 67 69 76 65 20 61 6e 20 61 72  f you give an ar
2f60: 67 75 6d 65 6e 74 20 74 6f 20 74 68 65 20 2e 74  gument to the .t
2f70: 61 62 6c 65 20 63 6f 6d 6d 61 6e 64 2c 20 61 20  able command, a 
2f80: 22 25 22 20 69 73 20 62 6f 74 68 0a 61 70 70 65  "%" is both.appe
2f90: 6e 64 65 64 20 61 6e 64 20 70 72 65 70 65 6e 64  nded and prepend
2fa0: 65 64 20 61 6e 64 20 61 20 4c 49 4b 45 20 63 6c  ed and a LIKE cl
2fb0: 61 75 73 65 20 69 73 20 61 64 64 65 64 20 74 6f  ause is added to
2fc0: 20 74 68 65 20 71 75 65 72 79 2e 0a 54 68 69 73   the query..This
2fd0: 20 61 6c 6c 6f 77 73 20 79 6f 75 20 74 6f 20 6c   allows you to l
2fe0: 69 73 74 20 6f 6e 6c 79 20 74 68 6f 73 65 20 74  ist only those t
2ff0: 61 62 6c 65 73 20 74 68 61 74 20 6d 61 74 63 68  ables that match
3000: 20 61 20 70 61 72 74 69 63 75 6c 61 72 0a 70 61   a particular.pa
3010: 74 74 65 72 6e 2e 3c 2f 70 3e 0a 0a 3c 68 32 3e  ttern.</p>..<h2>
3020: 43 6f 6e 76 65 72 74 69 6e 67 20 41 6e 20 45 6e  Converting An En
3030: 74 69 72 65 20 44 61 74 61 62 61 73 65 20 54 6f  tire Database To
3040: 20 41 6e 20 41 53 43 49 49 20 54 65 78 74 20 46   An ASCII Text F
3050: 69 6c 65 3c 2f 68 32 3e 0a 0a 3c 70 3e 55 73 65  ile</h2>..<p>Use
3060: 20 74 68 65 20 22 2e 64 75 6d 70 22 20 63 6f 6d   the ".dump" com
3070: 6d 61 6e 64 20 74 6f 20 63 6f 6e 76 65 72 74 20  mand to convert 
3080: 74 68 65 20 65 6e 74 69 72 65 20 63 6f 6e 74 65  the entire conte
3090: 6e 74 73 20 6f 66 20 61 0a 64 61 74 61 62 61 73  nts of a.databas
30a0: 65 20 69 6e 74 6f 20 61 20 73 69 6e 67 6c 65 20  e into a single 
30b0: 41 53 43 49 49 20 74 65 78 74 20 66 69 6c 65 2e  ASCII text file.
30c0: 20 20 54 68 69 73 20 66 69 6c 65 20 63 61 6e 20    This file can 
30d0: 62 65 20 63 6f 6e 76 65 72 74 65 64 0a 62 61 63  be converted.bac
30e0: 6b 20 69 6e 74 6f 20 61 20 64 61 74 61 62 61 73  k into a databas
30f0: 65 20 62 79 20 70 69 70 69 6e 67 20 69 74 20 62  e by piping it b
3100: 61 63 6b 20 69 6e 74 6f 20 3c 62 3e 73 71 6c 69  ack into <b>sqli
3110: 74 65 3c 2f 62 3e 2e 3c 2f 70 3e 0a 0a 3c 70 3e  te</b>.</p>..<p>
3120: 41 20 67 6f 6f 64 20 77 61 79 20 74 6f 20 6d 61  A good way to ma
3130: 6b 65 20 61 6e 20 61 72 63 68 69 76 61 6c 20 63  ke an archival c
3140: 6f 70 79 20 6f 66 20 61 20 64 61 74 61 62 61 73  opy of a databas
3150: 65 20 69 73 20 74 68 69 73 3a 3c 2f 70 3e 0a 7d  e is this:</p>.}
3160: 0a 0a 43 6f 64 65 20 7b 0a 24 20 28 28 28 65 63  ..Code {.$ (((ec
3170: 68 6f 20 27 2e 64 75 6d 70 27 20 7c 20 73 71 6c  ho '.dump' | sql
3180: 69 74 65 20 65 78 31 20 7c 20 67 7a 69 70 20 2d  ite ex1 | gzip -
3190: 63 20 3e 65 78 31 2e 64 75 6d 70 2e 67 7a 29 29  c >ex1.dump.gz))
31a0: 29 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54  ).}..puts {.<p>T
31b0: 68 69 73 20 67 65 6e 65 72 61 74 65 73 20 61 20  his generates a 
31c0: 66 69 6c 65 20 6e 61 6d 65 64 20 3c 62 3e 65 78  file named <b>ex
31d0: 31 2e 64 75 6d 70 2e 67 7a 3c 2f 62 3e 20 74 68  1.dump.gz</b> th
31e0: 61 74 20 63 6f 6e 74 61 69 6e 73 20 65 76 65 72  at contains ever
31f0: 79 74 68 69 6e 67 0a 79 6f 75 20 6e 65 65 64 20  ything.you need 
3200: 74 6f 20 72 65 63 6f 6e 73 74 72 75 63 74 20 74  to reconstruct t
3210: 68 65 20 64 61 74 61 62 61 73 65 20 61 74 20 61  he database at a
3220: 20 6c 61 74 65 72 20 74 69 6d 65 2c 20 6f 72 20   later time, or 
3230: 6f 6e 20 61 6e 6f 74 68 65 72 0a 6d 61 63 68 69  on another.machi
3240: 6e 65 2e 20 20 54 6f 20 72 65 63 6f 6e 73 74 72  ne.  To reconstr
3250: 75 63 74 20 74 68 65 20 64 61 74 61 62 61 73 65  uct the database
3260: 2c 20 6a 75 73 74 20 74 79 70 65 3a 3c 2f 70 3e  , just type:</p>
3270: 0a 7d 0a 0a 43 6f 64 65 20 7b 0a 24 20 28 28 28  .}..Code {.$ (((
3280: 7a 63 61 74 20 65 78 31 2e 64 75 6d 70 2e 67 7a  zcat ex1.dump.gz
3290: 20 7c 20 73 71 6c 69 74 65 20 65 78 32 29 29 29   | sqlite ex2)))
32a0: 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 70 3e 54 68  .}..puts {.<p>Th
32b0: 65 20 74 65 78 74 20 66 6f 72 6d 61 74 20 75 73  e text format us
32c0: 65 64 20 69 73 20 74 68 65 20 73 61 6d 65 20 61  ed is the same a
32d0: 73 20 75 73 65 64 20 62 79 0a 3c 61 20 68 72 65  s used by.<a hre
32e0: 66 3d 22 68 74 74 70 3a 2f 2f 77 77 77 2e 70 6f  f="http://www.po
32f0: 73 74 67 72 65 73 71 6c 2e 6f 72 67 2f 22 3e 50  stgresql.org/">P
3300: 6f 73 74 67 72 65 53 51 4c 3c 2f 61 3e 2c 20 73  ostgreSQL</a>, s
3310: 6f 20 79 6f 75 0a 63 61 6e 20 61 6c 73 6f 20 75  o you.can also u
3320: 73 65 20 74 68 65 20 2e 64 75 6d 70 20 63 6f 6d  se the .dump com
3330: 6d 61 6e 64 20 74 6f 20 65 78 70 6f 72 74 20 61  mand to export a
3340: 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  n SQLite databas
3350: 65 0a 69 6e 74 6f 20 61 20 50 6f 73 74 67 72 65  e.into a Postgre
3360: 53 51 4c 20 64 61 74 61 62 61 73 65 2e 20 20 4c  SQL database.  L
3370: 69 6b 65 20 74 68 69 73 3a 3c 2f 70 3e 0a 7d 0a  ike this:</p>.}.
3380: 0a 43 6f 64 65 20 7b 0a 24 20 28 28 28 63 72 65  .Code {.$ (((cre
3390: 61 74 65 64 62 20 65 78 32 29 29 29 0a 24 20 28  atedb ex2))).$ (
33a0: 28 28 65 63 68 6f 20 27 2e 64 75 6d 70 27 20 7c  ((echo '.dump' |
33b0: 20 73 71 6c 69 74 65 20 65 78 31 20 7c 20 70 73   sqlite ex1 | ps
33c0: 71 6c 20 65 78 32 29 29 29 0a 7d 0a 0a 70 75 74  ql ex2))).}..put
33d0: 73 20 7b 0a 3c 70 3e 59 6f 75 20 63 61 6e 20 61  s {.<p>You can a
33e0: 6c 6d 6f 73 74 20 28 62 75 74 20 6e 6f 74 20 71  lmost (but not q
33f0: 75 69 74 65 29 20 67 6f 20 74 68 65 20 6f 74 68  uite) go the oth
3400: 65 72 20 77 61 79 20 61 6e 64 20 65 78 70 6f 72  er way and expor
3410: 74 0a 61 20 50 6f 73 74 67 72 65 53 51 4c 20 64  t.a PostgreSQL d
3420: 61 74 61 62 61 73 65 20 69 6e 74 6f 20 53 51 4c  atabase into SQL
3430: 69 74 65 20 75 73 69 6e 67 20 74 68 65 20 3c 62  ite using the <b
3440: 3e 70 67 5f 64 75 6d 70 3c 2f 62 3e 20 75 74 69  >pg_dump</b> uti
3450: 6c 69 74 79 2e 0a 55 6e 66 6f 72 74 75 6e 61 74  lity..Unfortunat
3460: 65 6c 79 2c 20 77 68 65 6e 20 3c 62 3e 70 67 5f  ely, when <b>pg_
3470: 64 75 6d 70 3c 2f 62 3e 20 77 72 69 74 65 73 20  dump</b> writes 
3480: 74 68 65 20 64 61 74 61 62 61 73 65 20 73 63 68  the database sch
3490: 65 6d 61 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 2c  ema information,
34a0: 0a 69 74 20 75 73 65 73 20 73 6f 6d 65 20 53 51  .it uses some SQ
34b0: 4c 20 73 79 6e 74 61 78 20 74 68 61 74 20 53 51  L syntax that SQ
34c0: 4c 69 74 65 20 64 6f 65 73 20 6e 6f 74 20 75 6e  Lite does not un
34d0: 64 65 72 73 74 61 6e 64 2e 0a 53 6f 20 79 6f 75  derstand..So you
34e0: 20 63 61 6e 6e 6f 74 20 70 69 70 65 20 74 68 65   cannot pipe the
34f0: 20 6f 75 74 70 75 74 20 6f 66 20 3c 62 3e 70 67   output of <b>pg
3500: 5f 64 75 6d 70 3c 2f 62 3e 20 64 69 72 65 63 74  _dump</b> direct
3510: 6c 79 20 0a 69 6e 74 6f 20 3c 62 3e 73 71 6c 69  ly .into <b>sqli
3520: 74 65 3c 2f 62 3e 2e 0a 42 75 74 20 69 66 20 79  te</b>..But if y
3530: 6f 75 20 63 61 6e 20 72 65 63 72 65 61 74 65 20  ou can recreate 
3540: 74 68 65 0a 73 63 68 65 6d 61 20 73 65 70 61 72  the.schema separ
3550: 61 74 65 6c 79 2c 20 79 6f 75 20 63 61 6e 20 75  ately, you can u
3560: 73 65 20 3c 62 3e 70 67 5f 64 75 6d 70 3c 2f 62  se <b>pg_dump</b
3570: 3e 20 77 69 74 68 20 74 68 65 20 3c 62 3e 2d 61  > with the <b>-a
3580: 3c 2f 62 3e 0a 6f 70 74 69 6f 6e 20 74 6f 20 6c  </b>.option to l
3590: 69 73 74 20 6a 75 73 74 20 74 68 65 20 64 61 74  ist just the dat
35a0: 61 0a 6f 66 20 61 20 50 6f 73 74 67 72 65 53 51  a.of a PostgreSQ
35b0: 4c 20 64 61 74 61 62 61 73 65 20 61 6e 64 20 69  L database and i
35c0: 6d 70 6f 72 74 20 74 68 61 74 20 64 69 72 65 63  mport that direc
35d0: 74 6c 79 20 69 6e 74 6f 20 53 51 4c 69 74 65 2e  tly into SQLite.
35e0: 3c 2f 70 3e 0a 7d 0a 0a 43 6f 64 65 20 7b 0a 24  </p>.}..Code {.$
35f0: 20 28 28 28 73 71 6c 69 74 65 20 65 78 33 20 3c   (((sqlite ex3 <
3600: 73 63 68 65 6d 61 2e 73 71 6c 29 29 29 0a 24 20  schema.sql))).$ 
3610: 28 28 28 70 67 5f 64 75 6d 70 20 2d 61 20 65 78  (((pg_dump -a ex
3620: 32 20 7c 20 73 71 6c 69 74 65 20 65 78 33 29 29  2 | sqlite ex3))
3630: 29 0a 7d 0a 0a 70 75 74 73 20 7b 0a 3c 68 32 3e  ).}..puts {.<h2>
3640: 4f 74 68 65 72 20 44 6f 74 20 43 6f 6d 6d 61 6e  Other Dot Comman
3650: 64 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 54 68 65 20  ds</h2>..<p>The 
3660: 22 2e 65 78 70 6c 61 69 6e 22 20 64 6f 74 20 63  ".explain" dot c
3670: 6f 6d 6d 61 6e 64 20 63 61 6e 20 62 65 20 75 73  ommand can be us
3680: 65 64 20 74 6f 20 73 65 74 20 74 68 65 20 6f 75  ed to set the ou
3690: 74 70 75 74 20 6d 6f 64 65 0a 74 6f 20 22 63 6f  tput mode.to "co
36a0: 6c 75 6d 6e 22 20 61 6e 64 20 74 6f 20 73 65 74  lumn" and to set
36b0: 20 74 68 65 20 63 6f 6c 75 6d 6e 20 77 69 64 74   the column widt
36c0: 68 73 20 74 6f 20 76 61 6c 75 65 73 20 74 68 61  hs to values tha
36d0: 74 20 61 72 65 20 72 65 61 73 6f 6e 61 62 6c 65  t are reasonable
36e0: 0a 66 6f 72 20 6c 6f 6f 6b 69 6e 67 20 61 74 20  .for looking at 
36f0: 74 68 65 20 6f 75 74 70 75 74 20 6f 66 20 61 6e  the output of an
3700: 20 45 58 50 4c 41 49 4e 20 63 6f 6d 6d 61 6e 64   EXPLAIN command
3710: 2e 20 20 54 68 65 20 45 58 50 4c 41 49 4e 20 63  .  The EXPLAIN c
3720: 6f 6d 6d 61 6e 64 0a 69 73 20 61 6e 20 53 51 4c  ommand.is an SQL
3730: 69 74 65 2d 73 70 65 63 69 66 69 63 20 53 51 4c  ite-specific SQL
3740: 20 65 78 74 65 6e 73 69 6f 6e 20 74 68 61 74 20   extension that 
3750: 69 73 20 75 73 65 66 75 6c 20 66 6f 72 20 64 65  is useful for de
3760: 62 75 67 67 69 6e 67 2e 20 20 49 66 20 61 6e 79  bugging.  If any
3770: 0a 72 65 67 75 6c 61 72 20 53 51 4c 20 69 73 20  .regular SQL is 
3780: 70 72 65 66 61 63 65 64 20 62 79 20 45 58 50 4c  prefaced by EXPL
3790: 41 49 4e 2c 20 74 68 65 6e 20 74 68 65 20 53 51  AIN, then the SQ
37a0: 4c 20 63 6f 6d 6d 61 6e 64 20 69 73 20 70 61 72  L command is par
37b0: 73 65 64 20 61 6e 64 0a 61 6e 61 6c 79 7a 65 64  sed and.analyzed
37c0: 20 62 75 74 20 69 73 20 6e 6f 74 20 65 78 65 63   but is not exec
37d0: 75 74 65 64 2e 20 20 49 6e 73 74 65 61 64 2c 20  uted.  Instead, 
37e0: 74 68 65 20 73 65 71 75 65 6e 63 65 20 6f 66 20  the sequence of 
37f0: 76 69 72 74 75 61 6c 20 6d 61 63 68 69 6e 65 0a  virtual machine.
3800: 69 6e 73 74 72 75 63 74 69 6f 6e 73 20 74 68 61  instructions tha
3810: 74 20 77 6f 75 6c 64 20 68 61 76 65 20 62 65 65  t would have bee
3820: 6e 20 75 73 65 64 20 74 6f 20 65 78 65 63 75 74  n used to execut
3830: 65 20 74 68 65 20 53 51 4c 20 63 6f 6d 6d 61 6e  e the SQL comman
3840: 64 20 61 72 65 0a 72 65 74 75 72 6e 65 64 20 6c  d are.returned l
3850: 69 6b 65 20 61 20 71 75 65 72 79 20 72 65 73 75  ike a query resu
3860: 6c 74 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65  lt.  For example
3870: 3a 3c 2f 70 3e 7d 0a 0a 43 6f 64 65 20 7b 0a 73  :</p>}..Code {.s
3880: 71 6c 69 74 65 3e 20 28 28 28 2e 65 78 70 6c 61  qlite> (((.expla
3890: 69 6e 29 29 29 0a 73 71 6c 69 74 65 3e 20 28 28  in))).sqlite> ((
38a0: 28 65 78 70 6c 61 69 6e 20 64 65 6c 65 74 65 20  (explain delete 
38b0: 66 72 6f 6d 20 74 62 6c 31 20 77 68 65 72 65 20  from tbl1 where 
38c0: 74 77 6f 3c 32 30 3b 29 29 29 0a 61 64 64 72 20  two<20;))).addr 
38d0: 20 6f 70 63 6f 64 65 20 20 20 20 20 20 20 20 70   opcode        p
38e0: 31 20 20 20 20 20 70 32 20 20 20 20 20 70 33 20  1     p2     p3 
38f0: 20 20 20 20 20 20 20 20 20 0a 2d 2d 2d 2d 20 20           .----  
3900: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 20 20 2d 2d  ------------  --
3910: 2d 2d 2d 20 20 2d 2d 2d 2d 2d 20 20 2d 2d 2d 2d  ---  -----  ----
3920: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3930: 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d 2d  ----------------
3940: 2d 20 20 20 0a 30 20 20 20 20 20 4c 69 73 74 4f  -   .0     ListO
3950: 70 65 6e 20 20 20 20 20 20 30 20 20 20 20 20 20  pen      0      
3960: 30 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  0               
3970: 20 20 20 0a 31 20 20 20 20 20 4f 70 65 6e 20 20     .1     Open  
3980: 20 20 20 20 20 20 20 20 30 20 20 20 20 20 20 31          0      1
3990: 20 20 20 20 20 20 74 62 6c 31 20 20 20 20 20 20        tbl1      
39a0: 20 20 0a 32 20 20 20 20 20 4e 65 78 74 20 20 20    .2     Next   
39b0: 20 20 20 20 20 20 20 30 20 20 20 20 20 20 39 20         0      9 
39c0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
39d0: 20 0a 33 20 20 20 20 20 46 69 65 6c 64 20 20 20   .3     Field   
39e0: 20 20 20 20 20 20 30 20 20 20 20 20 20 31 20 20        0      1  
39f0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
3a00: 0a 34 20 20 20 20 20 49 6e 74 65 67 65 72 20 20  .4     Integer  
3a10: 20 20 20 20 20 32 30 20 20 20 20 20 30 20 20 20       20     0   
3a20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a                 .
3a30: 35 20 20 20 20 20 47 65 20 20 20 20 20 20 20 20  5     Ge        
3a40: 20 20 20 20 30 20 20 20 20 20 20 32 20 20 20 20      0      2    
3a50: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 0a 36                .6
3a60: 20 20 20 20 20 4b 65 79 20 20 20 20 20 20 20 20       Key        
3a70: 20 20 20 30 20 20 20 20 20 20 30 20 20 20 20 20     0      0     
3a80: 20 20 20 20 20 20 20 20 20 20 20 20 20 0a 37 20               .7 
3a90: 20 20 20 20 4c 69 73 74 57 72 69 74 65 20 20 20      ListWrite   
3aa0: 20 20 30 20 20 20 20 20 20 30 20 20 20 20 20 20    0      0      
3ab0: 20 20 20 20 20 20 20 20 20 20 20 20 0a 38 20 20              .8  
3ac0: 20 20 20 47 6f 74 6f 20 20 20 20 20 20 20 20 20     Goto         
3ad0: 20 30 20 20 20 20 20 20 32 20 20 20 20 20 20 20   0      2       
3ae0: 20 20 20 20 20 20 20 20 20 20 20 0a 39 20 20 20             .9   
3af0: 20 20 4e 6f 6f 70 20 20 20 20 20 20 20 20 20 20    Noop          
3b00: 30 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20  0      0        
3b10: 20 20 20 20 20 20 20 20 20 20 0a 31 30 20 20 20            .10   
3b20: 20 4c 69 73 74 52 65 77 69 6e 64 20 20 20 20 30   ListRewind    0
3b30: 20 20 20 20 20 20 30 20 20 20 20 20 20 20 20 20        0         
3b40: 20 20 20 20 20 20 20 20 20 0a 31 31 20 20 20 20           .11    
3b50: 4c 69 73 74 52 65 61 64 20 20 20 20 20 20 30 20  ListRead      0 
3b60: 20 20 20 20 20 31 34 20 20 20 20 20 20 20 20 20       14         
3b70: 20 20 20 20 20 20 20 20 0a 31 32 20 20 20 20 44          .12    D
3b80: 65 6c 65 74 65 20 20 20 20 20 20 20 20 30 20 20  elete        0  
3b90: 20 20 20 20 30 20 20 20 20 20 20 20 20 20 20 20      0           
3ba0: 20 20 20 20 20 20 20 0a 31 33 20 20 20 20 47 6f         .13    Go
3bb0: 74 6f 20 20 20 20 20 20 20 20 20 20 30 20 20 20  to          0   
3bc0: 20 20 20 31 31 20 20 20 20 20 20 20 20 20 20 20     11           
3bd0: 20 20 20 20 20 20 0a 31 34 20 20 20 20 4c 69 73        .14    Lis
3be0: 74 43 6c 6f 73 65 20 20 20 20 20 30 20 20 20 20  tClose     0    
3bf0: 20 20 30 20 20 20 20 20 20 20 20 20 20 20 20 20    0             
3c00: 20 20 20 20 20 0a 7d 0a 0a 70 75 74 73 20 7b 0a       .}..puts {.
3c10: 0a 3c 70 3e 54 68 65 20 22 2e 74 69 6d 65 6f 75  .<p>The ".timeou
3c20: 74 22 20 63 6f 6d 6d 61 6e 64 20 73 65 74 73 20  t" command sets 
3c30: 74 68 65 20 61 6d 6f 75 6e 74 20 6f 66 20 74 69  the amount of ti
3c40: 6d 65 20 74 68 61 74 20 74 68 65 20 3c 62 3e 73  me that the <b>s
3c50: 71 6c 69 74 65 3c 2f 62 3e 0a 70 72 6f 67 72 61  qlite</b>.progra
3c60: 6d 20 77 69 6c 6c 20 77 61 69 74 20 66 6f 72 20  m will wait for 
3c70: 6c 6f 63 6b 73 20 74 6f 20 63 6c 65 61 72 20 6f  locks to clear o
3c80: 6e 20 66 69 6c 65 73 20 69 74 20 69 73 20 74 72  n files it is tr
3c90: 79 69 6e 67 20 74 6f 20 61 63 63 65 73 73 0a 62  ying to access.b
3ca0: 65 66 6f 72 65 20 72 65 74 75 72 6e 69 6e 67 20  efore returning 
3cb0: 61 6e 20 65 72 72 6f 72 2e 20 20 54 68 65 20 64  an error.  The d
3cc0: 65 66 61 75 6c 74 20 76 61 6c 75 65 20 6f 66 20  efault value of 
3cd0: 74 68 65 20 74 69 6d 65 6f 75 74 20 69 73 20 7a  the timeout is z
3ce0: 65 72 6f 20 73 6f 0a 74 68 61 74 20 61 6e 20 65  ero so.that an e
3cf0: 72 72 6f 72 20 69 73 20 72 65 74 75 72 6e 65 64  rror is returned
3d00: 20 69 6d 6d 65 64 69 61 74 65 6c 79 20 69 66 20   immediately if 
3d10: 61 6e 79 20 6e 65 65 64 65 64 20 64 61 74 61 62  any needed datab
3d20: 61 73 65 20 74 61 62 6c 65 20 6f 72 0a 69 6e 64  ase table or.ind
3d30: 65 78 20 69 73 20 6c 6f 63 6b 65 64 2e 3c 2f 70  ex is locked.</p
3d40: 3e 0a 0a 3c 70 3e 41 6e 64 20 66 69 6e 61 6c 6c  >..<p>And finall
3d50: 79 2c 20 77 65 20 6d 65 6e 74 69 6f 6e 20 74 68  y, we mention th
3d60: 65 20 22 2e 65 78 69 74 22 20 63 6f 6d 6d 61 6e  e ".exit" comman
3d70: 64 20 77 68 69 63 68 20 63 61 75 73 65 73 20 74  d which causes t
3d80: 68 65 0a 73 71 6c 69 74 65 20 70 72 6f 67 72 61  he.sqlite progra
3d90: 6d 20 74 6f 20 65 78 69 74 2e 3c 2f 70 3e 0a 0a  m to exit.</p>..
3da0: 3c 68 32 3e 55 73 69 6e 67 20 73 71 6c 69 74 65  <h2>Using sqlite
3db0: 20 69 6e 20 61 20 73 68 65 6c 6c 20 73 63 72 69   in a shell scri
3dc0: 70 74 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a 4f 6e 65  pt</h2>..<p>.One
3dd0: 20 77 61 79 20 74 6f 20 75 73 65 20 73 71 6c 69   way to use sqli
3de0: 74 65 20 69 6e 20 61 20 73 68 65 6c 6c 20 73 63  te in a shell sc
3df0: 72 69 70 74 20 69 73 20 74 6f 20 75 73 65 20 22  ript is to use "
3e00: 65 63 68 6f 22 20 6f 72 0a 22 63 61 74 22 20 74  echo" or."cat" t
3e10: 6f 20 67 65 6e 65 72 61 74 65 20 61 20 73 65 71  o generate a seq
3e20: 75 65 6e 63 65 20 6f 66 20 63 6f 6d 6d 61 6e 64  uence of command
3e30: 73 20 69 6e 20 61 20 66 69 6c 65 2c 20 74 68 65  s in a file, the
3e40: 6e 20 69 6e 76 6f 6b 65 20 73 71 6c 69 74 65 20  n invoke sqlite 
3e50: 0a 77 68 69 6c 65 20 72 65 64 69 72 65 63 74 69  .while redirecti
3e60: 6e 67 20 69 6e 70 75 74 20 66 72 6f 6d 20 74 68  ng input from th
3e70: 65 20 67 65 6e 65 72 61 74 65 64 20 63 6f 6d 6d  e generated comm
3e80: 61 6e 64 20 66 69 6c 65 2e 20 20 54 68 69 73 0a  and file.  This.
3e90: 77 6f 72 6b 73 20 66 69 6e 65 20 61 6e 64 20 69  works fine and i
3ea0: 73 20 61 70 70 72 6f 70 72 69 61 74 65 20 69 6e  s appropriate in
3eb0: 20 6d 61 6e 79 20 63 69 72 63 75 6d 73 74 61 6e   many circumstan
3ec0: 63 65 73 2e 20 20 42 75 74 20 61 73 0a 61 6e 20  ces.  But as.an 
3ed0: 61 64 64 65 64 20 63 6f 6e 76 65 6e 69 65 6e 63  added convenienc
3ee0: 65 2c 20 73 71 6c 69 74 65 20 61 6c 6c 6f 77 73  e, sqlite allows
3ef0: 20 61 20 73 69 6e 67 6c 65 20 53 51 4c 20 63 6f   a single SQL co
3f00: 6d 6d 61 6e 64 20 74 6f 20 62 65 0a 65 6e 74 65  mmand to be.ente
3f10: 72 65 64 20 6f 6e 20 74 68 65 20 63 6f 6d 6d 61  red on the comma
3f20: 6e 64 20 6c 69 6e 65 20 61 73 20 61 20 73 65 63  nd line as a sec
3f30: 6f 6e 64 20 61 72 67 75 6d 65 6e 74 20 61 66 74  ond argument aft
3f40: 65 72 20 74 68 65 0a 64 61 74 61 62 61 73 65 20  er the.database 
3f50: 6e 61 6d 65 2e 20 20 57 68 65 6e 20 74 68 65 20  name.  When the 
3f60: 73 71 6c 69 74 65 20 70 72 6f 67 72 61 6d 20 69  sqlite program i
3f70: 73 20 6c 61 75 6e 63 68 65 64 20 77 69 74 68 20  s launched with 
3f80: 74 77 6f 0a 61 72 67 75 6d 65 6e 74 73 2c 20 74  two.arguments, t
3f90: 68 65 20 73 65 63 6f 6e 64 20 61 72 67 75 6d 65  he second argume
3fa0: 6e 74 20 69 73 20 70 61 73 73 65 64 20 74 6f 20  nt is passed to 
3fb0: 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72 61  the SQLite libra
3fc0: 72 79 0a 66 6f 72 20 70 72 6f 63 65 73 73 69 6e  ry.for processin
3fd0: 67 2c 20 74 68 65 20 71 75 65 72 79 20 72 65 73  g, the query res
3fe0: 75 6c 74 73 20 61 72 65 20 70 72 69 6e 74 65 64  ults are printed
3ff0: 20 6f 6e 20 73 74 61 6e 64 61 72 64 20 6f 75 74   on standard out
4000: 70 75 74 0a 69 6e 20 6c 69 73 74 20 6d 6f 64 65  put.in list mode
4010: 2c 20 61 6e 64 20 74 68 65 20 70 72 6f 67 72 61  , and the progra
4020: 6d 20 65 78 69 74 73 2e 20 20 54 68 69 73 20 6d  m exits.  This m
4030: 65 63 68 61 6e 69 73 6d 20 69 73 20 64 65 73 69  echanism is desi
4040: 67 6e 65 64 0a 74 6f 20 6d 61 6b 65 20 73 71 6c  gned.to make sql
4050: 69 74 65 20 65 61 73 79 20 74 6f 20 75 73 65 20  ite easy to use 
4060: 69 6e 20 63 6f 6e 6a 75 6e 63 74 69 6f 6e 20 77  in conjunction w
4070: 69 74 68 20 70 72 6f 67 72 61 6d 73 20 6c 69 6b  ith programs lik
4080: 65 0a 22 61 77 6b 22 2e 20 20 46 6f 72 20 65 78  e."awk".  For ex
4090: 61 6d 70 6c 65 3a 3c 2f 70 3e 7d 0a 0a 43 6f 64  ample:</p>}..Cod
40a0: 65 20 7b 0a 24 20 28 28 28 73 71 6c 69 74 65 20  e {.$ (((sqlite 
40b0: 65 78 31 20 27 73 65 6c 65 63 74 20 2a 20 66 72  ex1 'select * fr
40c0: 6f 6d 20 74 62 6c 31 27 20 7c 29 29 29 0a 3e 20  om tbl1' |))).> 
40d0: 28 28 28 20 61 77 6b 20 27 7b 70 72 69 6e 74 66  ((( awk '{printf
40e0: 20 22 3c 74 72 3e 3c 74 64 3e 25 73 3c 74 64 3e   "<tr><td>%s<td>
40f0: 25 73 5c 6e 22 2c 24 31 2c 24 32 20 7d 27 29 29  %s\n",$1,$2 }'))
4100: 29 0a 3c 74 72 3e 3c 74 64 3e 68 65 6c 6c 6f 3c  ).<tr><td>hello<
4110: 74 64 3e 31 30 0a 3c 74 72 3e 3c 74 64 3e 67 6f  td>10.<tr><td>go
4120: 6f 64 62 79 65 3c 74 64 3e 32 30 0a 24 0a 7d 0a  odbye<td>20.$.}.
4130: 0a 70 75 74 73 20 7b 0a 3c 68 32 3e 43 6f 6d 70  .puts {.<h2>Comp
4140: 69 6c 69 6e 67 20 74 68 65 20 73 71 6c 69 74 65  iling the sqlite
4150: 20 70 72 6f 67 72 61 6d 20 66 72 6f 6d 20 73 6f   program from so
4160: 75 72 63 65 73 3c 2f 68 32 3e 0a 0a 3c 70 3e 0a  urces</h2>..<p>.
4170: 54 68 65 20 73 71 6c 69 74 65 20 70 72 6f 67 72  The sqlite progr
4180: 61 6d 20 69 73 20 62 75 69 6c 74 20 61 75 74 6f  am is built auto
4190: 6d 61 74 69 63 61 6c 6c 79 20 77 68 65 6e 20 79  matically when y
41a0: 6f 75 20 63 6f 6d 70 69 6c 65 20 74 68 65 0a 73  ou compile the.s
41b0: 71 6c 69 74 65 20 6c 69 62 72 61 72 79 2e 20 20  qlite library.  
41c0: 4a 75 73 74 20 67 65 74 20 61 20 63 6f 70 79 20  Just get a copy 
41d0: 6f 66 20 74 68 65 20 73 6f 75 72 63 65 20 74 72  of the source tr
41e0: 65 65 2c 20 72 75 6e 0a 22 63 6f 6e 66 69 67 75  ee, run."configu
41f0: 72 65 22 20 61 6e 64 20 74 68 65 6e 20 22 6d 61  re" and then "ma
4200: 6b 65 22 2e 3c 2f 70 3e 0a 7d 0a 0a 70 75 74 73  ke".</p>.}..puts
4210: 20 7b 0a 3c 70 3e 3c 68 72 20 2f 3e 3c 2f 70 3e   {.<p><hr /></p>
4220: 0a 3c 70 3e 3c 61 20 68 72 65 66 3d 22 69 6e 64  .<p><a href="ind
4230: 65 78 2e 68 74 6d 6c 22 3e 3c 69 6d 67 20 73 72  ex.html"><img sr
4240: 63 3d 22 2f 67 6f 62 61 63 6b 2e 6a 70 67 22 20  c="/goback.jpg" 
4250: 62 6f 72 64 65 72 3d 30 20 2f 3e 0a 42 61 63 6b  border=0 />.Back
4260: 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65 20 48   to the SQLite H
4270: 6f 6d 65 20 50 61 67 65 3c 2f 61 3e 0a 3c 2f 70  ome Page</a>.</p
4280: 3e 0a 0a 3c 2f 62 6f 64 79 3e 3c 2f 68 74 6d 6c  >..</body></html
4290: 3e 7d 0a                                         >}.