/ Hex Artifact Content
Login

Artifact 83f4a9d37bdf2b7ef079a82d54eaf2e3509ee6ea:


0000: 2e 5c 22 20 20 20 20 20 20 20 20 20 20 20 20 20  .\"             
0010: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0020: 20 20 20 20 20 20 20 20 20 48 65 79 2c 20 45 4d           Hey, EM
0030: 41 43 53 3a 20 2d 2a 2d 20 6e 72 6f 66 66 20 2d  ACS: -*- nroff -
0040: 2a 2d 0a 2e 5c 22 20 46 69 72 73 74 20 70 61 72  *-..\" First par
0050: 61 6d 65 74 65 72 2c 20 4e 41 4d 45 2c 20 73 68  ameter, NAME, sh
0060: 6f 75 6c 64 20 62 65 20 61 6c 6c 20 63 61 70 73  ould be all caps
0070: 0a 2e 5c 22 20 53 65 63 6f 6e 64 20 70 61 72 61  ..\" Second para
0080: 6d 65 74 65 72 2c 20 53 45 43 54 49 4f 4e 2c 20  meter, SECTION, 
0090: 73 68 6f 75 6c 64 20 62 65 20 31 2d 38 2c 20 6d  should be 1-8, m
00a0: 61 79 62 65 20 77 2f 20 73 75 62 73 65 63 74 69  aybe w/ subsecti
00b0: 6f 6e 0a 2e 5c 22 20 6f 74 68 65 72 20 70 61 72  on..\" other par
00c0: 61 6d 65 74 65 72 73 20 61 72 65 20 61 6c 6c 6f  ameters are allo
00d0: 77 65 64 3a 20 73 65 65 20 6d 61 6e 28 37 29 2c  wed: see man(7),
00e0: 20 6d 61 6e 28 31 29 0a 2e 54 48 20 53 51 4c 49   man(1)..TH SQLI
00f0: 54 45 20 31 20 22 4d 6f 6e 20 41 70 72 20 31 35  TE 1 "Mon Apr 15
0100: 20 32 33 3a 34 39 3a 31 37 20 32 30 30 32 22 0a   23:49:17 2002".
0110: 2e 5c 22 20 50 6c 65 61 73 65 20 61 64 6a 75 73  .\" Please adjus
0120: 74 20 74 68 69 73 20 64 61 74 65 20 77 68 65 6e  t this date when
0130: 65 76 65 72 20 72 65 76 69 73 69 6e 67 20 74 68  ever revising th
0140: 65 20 6d 61 6e 70 61 67 65 2e 0a 2e 5c 22 0a 2e  e manpage...\"..
0150: 5c 22 20 53 6f 6d 65 20 72 6f 66 66 20 6d 61 63  \" Some roff mac
0160: 72 6f 73 2c 20 66 6f 72 20 72 65 66 65 72 65 6e  ros, for referen
0170: 63 65 3a 0a 2e 5c 22 20 2e 6e 68 20 20 20 20 20  ce:..\" .nh     
0180: 20 20 20 64 69 73 61 62 6c 65 20 68 79 70 68 65     disable hyphe
0190: 6e 61 74 69 6f 6e 0a 2e 5c 22 20 2e 68 79 20 20  nation..\" .hy  
01a0: 20 20 20 20 20 20 65 6e 61 62 6c 65 20 68 79 70        enable hyp
01b0: 68 65 6e 61 74 69 6f 6e 0a 2e 5c 22 20 2e 61 64  henation..\" .ad
01c0: 20 6c 20 20 20 20 20 20 6c 65 66 74 20 6a 75 73   l      left jus
01d0: 74 69 66 79 0a 2e 5c 22 20 2e 61 64 20 62 20 20  tify..\" .ad b  
01e0: 20 20 20 20 6a 75 73 74 69 66 79 20 74 6f 20 62      justify to b
01f0: 6f 74 68 20 6c 65 66 74 20 61 6e 64 20 72 69 67  oth left and rig
0200: 68 74 20 6d 61 72 67 69 6e 73 0a 2e 5c 22 20 2e  ht margins..\" .
0210: 6e 66 20 20 20 20 20 20 20 20 64 69 73 61 62 6c  nf        disabl
0220: 65 20 66 69 6c 6c 69 6e 67 0a 2e 5c 22 20 2e 66  e filling..\" .f
0230: 69 20 20 20 20 20 20 20 20 65 6e 61 62 6c 65 20  i        enable 
0240: 66 69 6c 6c 69 6e 67 0a 2e 5c 22 20 2e 62 72 20  filling..\" .br 
0250: 20 20 20 20 20 20 20 69 6e 73 65 72 74 20 6c 69         insert li
0260: 6e 65 20 62 72 65 61 6b 0a 2e 5c 22 20 2e 73 70  ne break..\" .sp
0270: 20 3c 6e 3e 20 20 20 20 69 6e 73 65 72 74 20 6e   <n>    insert n
0280: 2b 31 20 65 6d 70 74 79 20 6c 69 6e 65 73 0a 2e  +1 empty lines..
0290: 5c 22 20 66 6f 72 20 6d 61 6e 70 61 67 65 2d 73  \" for manpage-s
02a0: 70 65 63 69 66 69 63 20 6d 61 63 72 6f 73 2c 20  pecific macros, 
02b0: 73 65 65 20 6d 61 6e 28 37 29 0a 2e 53 48 20 4e  see man(7)..SH N
02c0: 41 4d 45 0a 73 71 6c 69 74 65 20 5c 2d 20 41 20  AME.sqlite \- A 
02d0: 63 6f 6d 6d 61 6e 64 20 6c 69 6e 65 20 69 6e 74  command line int
02e0: 65 72 66 61 63 65 20 66 6f 72 20 53 51 4c 69 74  erface for SQLit
02f0: 65 0a 2e 53 48 20 53 59 4e 4f 50 53 49 53 0a 2e  e..SH SYNOPSIS..
0300: 42 20 73 71 6c 69 74 65 0a 2e 52 49 20 5b 20 6f  B sqlite..RI [ o
0310: 70 74 69 6f 6e 73 20 5d 20 22 20 66 69 6c 65 6e  ptions ] " filen
0320: 61 6d 65 20 22 20 5b 20 53 51 4c 20 5d 0a 2e 53  ame " [ SQL ]..S
0330: 53 20 53 55 4d 4d 41 52 59 0a 2e 50 50 0a 73 71  S SUMMARY..PP.sq
0340: 6c 69 74 65 20 69 73 20 61 20 74 65 72 6d 69 6e  lite is a termin
0350: 61 6c 2d 62 61 73 65 64 20 66 72 6f 6e 74 2d 65  al-based front-e
0360: 6e 64 20 74 6f 20 74 68 65 20 53 51 4c 69 74 65  nd to the SQLite
0370: 20 6c 69 62 72 61 72 79 2e 20 49 74 20 65 6e 61   library. It ena
0380: 62 6c 65 73 0a 79 6f 75 20 74 6f 20 74 79 70 65  bles.you to type
0390: 20 69 6e 20 71 75 65 72 69 65 73 20 69 6e 74 65   in queries inte
03a0: 72 61 63 74 69 76 65 6c 79 2c 20 69 73 73 75 65  ractively, issue
03b0: 20 74 68 65 6d 20 74 6f 20 53 51 4c 69 74 65 20   them to SQLite 
03c0: 61 6e 64 20 73 65 65 20 74 68 65 0a 72 65 73 75  and see the.resu
03d0: 6c 74 73 2e 20 41 6c 74 65 72 6e 61 74 69 76 65  lts. Alternative
03e0: 6c 79 2c 20 79 6f 75 20 63 61 6e 20 73 70 65 63  ly, you can spec
03f0: 69 66 79 20 53 51 4c 20 63 6f 64 65 20 6f 6e 20  ify SQL code on 
0400: 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65  the command-line
0410: 2e 20 49 6e 0a 61 64 64 69 74 69 6f 6e 20 69 74  . In.addition it
0420: 20 70 72 6f 76 69 64 65 73 20 61 20 6e 75 6d 62   provides a numb
0430: 65 72 20 6f 66 20 6d 65 74 61 2d 63 6f 6d 6d 61  er of meta-comma
0440: 6e 64 73 2e 0a 0a 2e 53 48 20 44 45 53 43 52 49  nds....SH DESCRI
0450: 50 54 49 4f 4e 0a 54 68 69 73 20 6d 61 6e 75 61  PTION.This manua
0460: 6c 20 70 61 67 65 20 64 6f 63 75 6d 65 6e 74 73  l page documents
0470: 20 62 72 69 65 66 6c 79 20 74 68 65 0a 2e 42 20   briefly the..B 
0480: 73 71 6c 69 74 65 0a 63 6f 6d 6d 61 6e 64 2e 0a  sqlite.command..
0490: 54 68 69 73 20 6d 61 6e 75 61 6c 20 70 61 67 65  This manual page
04a0: 20 77 61 73 20 77 72 69 74 74 65 6e 20 66 6f 72   was written for
04b0: 20 74 68 65 20 44 65 62 69 61 6e 20 47 4e 55 2f   the Debian GNU/
04c0: 4c 69 6e 75 78 20 64 69 73 74 72 69 62 75 74 69  Linux distributi
04d0: 6f 6e 0a 62 65 63 61 75 73 65 20 74 68 65 20 6f  on.because the o
04e0: 72 69 67 69 6e 61 6c 20 70 72 6f 67 72 61 6d 20  riginal program 
04f0: 64 6f 65 73 20 6e 6f 74 20 68 61 76 65 20 61 20  does not have a 
0500: 6d 61 6e 75 61 6c 20 70 61 67 65 2e 0a 2e 53 53  manual page...SS
0510: 20 47 45 54 54 49 4e 47 20 53 54 41 52 54 45 44   GETTING STARTED
0520: 0a 2e 50 50 0a 54 6f 20 73 74 61 72 74 20 74 68  ..PP.To start th
0530: 65 20 73 71 6c 69 74 65 20 70 72 6f 67 72 61 6d  e sqlite program
0540: 2c 20 6a 75 73 74 20 74 79 70 65 20 22 73 71 6c  , just type "sql
0550: 69 74 65 22 20 66 6f 6c 6c 6f 77 65 64 20 62 79  ite" followed by
0560: 20 74 68 65 20 6e 61 6d 65 0a 74 68 65 20 66 69   the name.the fi
0570: 6c 65 20 74 68 61 74 20 68 6f 6c 64 73 20 74 68  le that holds th
0580: 65 20 53 51 4c 69 74 65 20 64 61 74 61 62 61 73  e SQLite databas
0590: 65 2e 20 49 66 20 74 68 65 20 66 69 6c 65 20 64  e. If the file d
05a0: 6f 65 73 20 6e 6f 74 20 65 78 69 73 74 2c 20 61  oes not exist, a
05b0: 0a 6e 65 77 20 6f 6e 65 20 69 73 20 63 72 65 61  .new one is crea
05c0: 74 65 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c  ted automaticall
05d0: 79 2e 20 54 68 65 20 73 71 6c 69 74 65 20 70 72  y. The sqlite pr
05e0: 6f 67 72 61 6d 20 77 69 6c 6c 20 74 68 65 6e 20  ogram will then 
05f0: 70 72 6f 6d 70 74 0a 79 6f 75 20 74 6f 20 65 6e  prompt.you to en
0600: 74 65 72 20 53 51 4c 2e 20 54 79 70 65 20 69 6e  ter SQL. Type in
0610: 20 53 51 4c 20 73 74 61 74 65 6d 65 6e 74 73 20   SQL statements 
0620: 28 74 65 72 6d 69 6e 61 74 65 64 20 62 79 20 61  (terminated by a
0630: 20 73 65 6d 69 63 6f 6c 6f 6e 29 2c 0a 70 72 65   semicolon),.pre
0640: 73 73 20 22 45 6e 74 65 72 22 20 61 6e 64 20 74  ss "Enter" and t
0650: 68 65 20 53 51 4c 20 77 69 6c 6c 20 62 65 20 65  he SQL will be e
0660: 78 65 63 75 74 65 64 2e 0a 0a 46 6f 72 20 65 78  xecuted...For ex
0670: 61 6d 70 6c 65 2c 20 74 6f 20 63 72 65 61 74 65  ample, to create
0680: 20 61 20 6e 65 77 20 53 51 4c 69 74 65 20 64 61   a new SQLite da
0690: 74 61 62 61 73 65 20 6e 61 6d 65 64 20 22 65 78  tabase named "ex
06a0: 31 22 20 77 69 74 68 20 61 20 73 69 6e 67 6c 65  1" with a single
06b0: 0a 74 61 62 6c 65 20 6e 61 6d 65 64 20 22 74 62  .table named "tb
06c0: 6c 31 22 2c 20 79 6f 75 20 6d 69 67 68 74 20 64  l1", you might d
06d0: 6f 20 74 68 69 73 3a 0a 2e 73 70 0a 2e 6e 66 0a  o this:..sp..nf.
06e0: 24 20 73 71 6c 69 74 65 20 65 78 31 0a 53 51 4c  $ sqlite ex1.SQL
06f0: 69 74 65 20 76 65 72 73 69 6f 6e 20 32 2e 30 2e  ite version 2.0.
0700: 30 0a 45 6e 74 65 72 20 22 2e 68 65 6c 70 22 20  0.Enter ".help" 
0710: 66 6f 72 20 69 6e 73 74 72 75 63 74 69 6f 6e 73  for instructions
0720: 0a 73 71 6c 69 74 65 3e 20 63 72 65 61 74 65 20  .sqlite> create 
0730: 74 61 62 6c 65 20 74 62 6c 31 28 6f 6e 65 20 76  table tbl1(one v
0740: 61 72 63 68 61 72 28 31 30 29 2c 20 74 77 6f 20  archar(10), two 
0750: 73 6d 61 6c 6c 69 6e 74 29 3b 0a 73 71 6c 69 74  smallint);.sqlit
0760: 65 3e 20 69 6e 73 65 72 74 20 69 6e 74 6f 20 74  e> insert into t
0770: 62 6c 31 20 76 61 6c 75 65 73 28 27 68 65 6c 6c  bl1 values('hell
0780: 6f 21 27 2c 31 30 29 3b 0a 73 71 6c 69 74 65 3e  o!',10);.sqlite>
0790: 20 69 6e 73 65 72 74 20 69 6e 74 6f 20 74 62 6c   insert into tbl
07a0: 31 20 76 61 6c 75 65 73 28 27 67 6f 6f 64 62 79  1 values('goodby
07b0: 65 27 2c 20 32 30 29 3b 0a 73 71 6c 69 74 65 3e  e', 20);.sqlite>
07c0: 20 73 65 6c 65 63 74 20 2a 20 66 72 6f 6d 20 74   select * from t
07d0: 62 6c 31 3b 0a 68 65 6c 6c 6f 21 7c 31 30 0a 67  bl1;.hello!|10.g
07e0: 6f 6f 64 62 79 65 7c 32 30 0a 73 71 6c 69 74 65  oodbye|20.sqlite
07f0: 3e 0a 2e 73 70 0a 2e 66 69 0a 0a 2e 53 53 20 53  >..sp..fi...SS S
0800: 51 4c 49 54 45 20 4d 45 54 41 2d 43 4f 4d 4d 41  QLITE META-COMMA
0810: 4e 44 53 0a 2e 50 50 0a 4d 6f 73 74 20 6f 66 20  NDS..PP.Most of 
0820: 74 68 65 20 74 69 6d 65 2c 20 73 71 6c 69 74 65  the time, sqlite
0830: 20 6a 75 73 74 20 72 65 61 64 73 20 6c 69 6e 65   just reads line
0840: 73 20 6f 66 20 69 6e 70 75 74 20 61 6e 64 20 70  s of input and p
0850: 61 73 73 65 73 20 74 68 65 6d 20 6f 6e 0a 74 6f  asses them on.to
0860: 20 74 68 65 20 53 51 4c 69 74 65 20 6c 69 62 72   the SQLite libr
0870: 61 72 79 20 66 6f 72 20 65 78 65 63 75 74 69 6f  ary for executio
0880: 6e 2e 20 42 75 74 20 69 66 20 61 6e 20 69 6e 70  n. But if an inp
0890: 75 74 20 6c 69 6e 65 20 62 65 67 69 6e 73 20 77  ut line begins w
08a0: 69 74 68 0a 61 20 64 6f 74 20 28 22 2e 22 29 2c  ith.a dot ("."),
08b0: 20 74 68 65 6e 20 74 68 61 74 20 6c 69 6e 65 20   then that line 
08c0: 69 73 20 69 6e 74 65 72 63 65 70 74 65 64 20 61  is intercepted a
08d0: 6e 64 20 69 6e 74 65 72 70 72 65 74 65 64 20 62  nd interpreted b
08e0: 79 20 74 68 65 0a 73 71 6c 69 74 65 20 70 72 6f  y the.sqlite pro
08f0: 67 72 61 6d 20 69 74 73 65 6c 66 2e 20 54 68 65  gram itself. The
0900: 73 65 20 22 64 6f 74 20 63 6f 6d 6d 61 6e 64 73  se "dot commands
0910: 22 20 61 72 65 20 74 79 70 69 63 61 6c 6c 79 20  " are typically 
0920: 75 73 65 64 20 74 6f 0a 63 68 61 6e 67 65 20 74  used to.change t
0930: 68 65 20 6f 75 74 70 75 74 20 66 6f 72 6d 61 74  he output format
0940: 20 6f 66 20 71 75 65 72 69 65 73 2c 20 6f 72 20   of queries, or 
0950: 74 6f 20 65 78 65 63 75 74 65 20 63 65 72 74 61  to execute certa
0960: 69 6e 20 70 72 65 70 61 63 6b 61 67 65 64 0a 71  in prepackaged.q
0970: 75 65 72 79 20 73 74 61 74 65 6d 65 6e 74 73 2e  uery statements.
0980: 0a 0a 46 6f 72 20 61 20 6c 69 73 74 69 6e 67 20  ..For a listing 
0990: 6f 66 20 74 68 65 20 61 76 61 69 6c 61 62 6c 65  of the available
09a0: 20 64 6f 74 20 63 6f 6d 6d 61 6e 64 73 2c 20 79   dot commands, y
09b0: 6f 75 20 63 61 6e 20 65 6e 74 65 72 20 22 2e 68  ou can enter ".h
09c0: 65 6c 70 22 20 61 74 0a 61 6e 79 20 74 69 6d 65  elp" at.any time
09d0: 2e 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a 0a 2e  . For example:..
09e0: 73 70 0a 2e 6e 66 0a 2e 63 63 20 7c 0a 73 71 6c  sp..nf..cc |.sql
09f0: 69 74 65 3e 20 2e 68 65 6c 70 0a 2e 64 75 6d 70  ite> .help..dump
0a00: 20 3f 54 41 42 4c 45 3f 20 2e 2e 2e 20 20 20 20   ?TABLE? ...    
0a10: 20 20 44 75 6d 70 20 74 68 65 20 64 61 74 61 62    Dump the datab
0a20: 61 73 65 20 69 6e 20 61 6e 20 74 65 78 74 20 66  ase in an text f
0a30: 6f 72 6d 61 74 0a 2e 65 63 68 6f 20 4f 4e 7c 4f  ormat..echo ON|O
0a40: 46 46 20 20 20 20 20 20 20 20 20 20 20 54 75 72  FF           Tur
0a50: 6e 20 63 6f 6d 6d 61 6e 64 20 65 63 68 6f 20 6f  n command echo o
0a60: 6e 20 6f 72 20 6f 66 66 0a 2e 65 78 69 74 20 20  n or off..exit  
0a70: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0a80: 45 78 69 74 20 74 68 69 73 20 70 72 6f 67 72 61  Exit this progra
0a90: 6d 0a 2e 65 78 70 6c 61 69 6e 20 4f 4e 7c 4f 46  m..explain ON|OF
0aa0: 46 20 20 20 20 20 20 20 20 54 75 72 6e 20 6f 75  F        Turn ou
0ab0: 74 70 75 74 20 6d 6f 64 65 20 73 75 69 74 61 62  tput mode suitab
0ac0: 6c 65 20 66 6f 72 20 45 58 50 4c 41 49 4e 20 6f  le for EXPLAIN o
0ad0: 6e 20 6f 72 20 6f 66 66 2e 0a 20 20 20 20 20 20  n or off..      
0ae0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0af0: 20 22 6f 66 66 22 20 77 69 6c 6c 20 72 65 76 65   "off" will reve
0b00: 72 74 20 74 6f 20 74 68 65 20 6f 75 74 70 75 74  rt to the output
0b10: 20 6d 6f 64 65 20 74 68 61 74 20 77 61 73 0a 20   mode that was. 
0b20: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0b30: 20 20 20 20 20 20 70 72 65 76 69 6f 75 73 6c 79        previously
0b40: 20 69 6e 20 65 66 66 65 63 74 0a 2e 68 65 61 64   in effect..head
0b50: 65 72 28 73 29 20 4f 4e 7c 4f 46 46 20 20 20 20  er(s) ON|OFF    
0b60: 20 20 54 75 72 6e 20 64 69 73 70 6c 61 79 20 6f    Turn display o
0b70: 66 20 68 65 61 64 65 72 73 20 6f 6e 20 6f 72 20  f headers on or 
0b80: 6f 66 66 0a 2e 68 65 6c 70 20 20 20 20 20 20 20  off..help       
0b90: 20 20 20 20 20 20 20 20 20 20 20 53 68 6f 77 20             Show 
0ba0: 74 68 69 73 20 6d 65 73 73 61 67 65 0a 2e 69 6e  this message..in
0bb0: 64 69 63 65 73 20 54 41 42 4c 45 20 20 20 20 20  dices TABLE     
0bc0: 20 20 20 20 53 68 6f 77 20 6e 61 6d 65 73 20 6f      Show names o
0bd0: 66 20 61 6c 6c 20 69 6e 64 69 63 65 73 20 6f 6e  f all indices on
0be0: 20 54 41 42 4c 45 0a 2e 6d 6f 64 65 20 4d 4f 44   TABLE..mode MOD
0bf0: 45 20 20 20 20 20 20 20 20 20 20 20 20 20 53 65  E             Se
0c00: 74 20 6d 6f 64 65 20 74 6f 20 6f 6e 65 20 6f 66  t mode to one of
0c10: 20 22 6c 69 6e 65 28 73 29 22 2c 20 22 63 6f 6c   "line(s)", "col
0c20: 75 6d 6e 28 73 29 22 2c 0a 20 20 20 20 20 20 20  umn(s)",.       
0c30: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0c40: 22 69 6e 73 65 72 74 22 2c 20 22 6c 69 73 74 22  "insert", "list"
0c50: 2c 20 6f 72 20 22 68 74 6d 6c 22 0a 2e 6d 6f 64  , or "html"..mod
0c60: 65 20 69 6e 73 65 72 74 20 54 41 42 4c 45 20 20  e insert TABLE  
0c70: 20 20 20 47 65 6e 65 72 61 74 65 20 53 51 4c 20     Generate SQL 
0c80: 69 6e 73 65 72 74 20 73 74 61 74 65 6d 65 6e 74  insert statement
0c90: 73 20 66 6f 72 20 54 41 42 4c 45 0a 2e 6e 75 6c  s for TABLE..nul
0ca0: 6c 76 61 6c 75 65 20 53 54 52 49 4e 47 20 20 20  lvalue STRING   
0cb0: 20 20 20 50 72 69 6e 74 20 53 54 52 49 4e 47 20     Print STRING 
0cc0: 69 6e 73 74 65 61 64 20 6f 66 20 6e 6f 74 68 69  instead of nothi
0cd0: 6e 67 20 66 6f 72 20 4e 55 4c 4c 20 64 61 74 61  ng for NULL data
0ce0: 0a 2e 6f 75 74 70 75 74 20 46 49 4c 45 4e 41 4d  ..output FILENAM
0cf0: 45 20 20 20 20 20 20 20 53 65 6e 64 20 6f 75 74  E       Send out
0d00: 70 75 74 20 74 6f 20 46 49 4c 45 4e 41 4d 45 0a  put to FILENAME.
0d10: 2e 6f 75 74 70 75 74 20 73 74 64 6f 75 74 20 20  .output stdout  
0d20: 20 20 20 20 20 20 20 53 65 6e 64 20 6f 75 74 70         Send outp
0d30: 75 74 20 74 6f 20 74 68 65 20 73 63 72 65 65 6e  ut to the screen
0d40: 0a 2e 70 72 6f 6d 70 74 20 4d 41 49 4e 20 43 4f  ..prompt MAIN CO
0d50: 4e 54 49 4e 55 45 20 20 52 65 70 6c 61 63 65 20  NTINUE  Replace 
0d60: 74 68 65 20 73 74 61 6e 64 61 72 64 20 70 72 6f  the standard pro
0d70: 6d 70 74 73 0a 20 20 20 20 20 20 20 20 20 20 20  mpts.           
0d80: 20 20 20 20 20 20 20 20 20 20 20 20 22 73 71 6c              "sql
0d90: 69 74 65 20 3e 20 22 20 61 6e 64 20 22 20 20 20  ite > " and "   
0da0: 2e 2e 2e 3e 20 22 0a 20 20 20 20 20 20 20 20 20  ...> ".         
0db0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 77 69                wi
0dc0: 74 68 20 74 68 65 20 73 74 72 69 6e 67 73 20 4d  th the strings M
0dd0: 41 49 4e 20 61 6e 64 20 43 4f 4e 54 49 4e 55 45  AIN and CONTINUE
0de0: 0a 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20  .               
0df0: 20 20 20 20 20 20 20 20 43 4f 4e 54 49 4e 55 45          CONTINUE
0e00: 20 69 73 20 6f 70 74 69 6f 6e 61 6c 2e 0a 2e 71   is optional...q
0e10: 75 69 74 20 20 20 20 20 20 20 20 20 20 20 20 20  uit             
0e20: 20 20 20 20 20 45 78 69 74 20 74 68 69 73 20 70       Exit this p
0e30: 72 6f 67 72 61 6d 0a 2e 72 65 61 64 20 46 49 4c  rogram..read FIL
0e40: 45 4e 41 4d 45 20 20 20 20 20 20 20 20 20 45 78  ENAME         Ex
0e50: 65 63 75 74 65 20 53 51 4c 20 69 6e 20 46 49 4c  ecute SQL in FIL
0e60: 45 4e 41 4d 45 0a 2e 72 65 69 6e 64 65 78 20 3f  ENAME..reindex ?
0e70: 54 41 42 4c 45 3f 20 20 20 20 20 20 20 52 65 62  TABLE?       Reb
0e80: 75 69 6c 64 20 69 6e 64 69 63 65 73 0a 2e 73 63  uild indices..sc
0e90: 68 65 6d 61 20 3f 54 41 42 4c 45 3f 20 20 20 20  hema ?TABLE?    
0ea0: 20 20 20 20 53 68 6f 77 20 74 68 65 20 43 52 45      Show the CRE
0eb0: 41 54 45 20 73 74 61 74 65 6d 65 6e 74 73 0a 2e  ATE statements..
0ec0: 73 65 70 61 72 61 74 6f 72 20 53 54 52 49 4e 47  separator STRING
0ed0: 20 20 20 20 20 20 43 68 61 6e 67 65 20 73 65 70        Change sep
0ee0: 61 72 61 74 6f 72 20 73 74 72 69 6e 67 20 66 6f  arator string fo
0ef0: 72 20 22 6c 69 73 74 22 20 6d 6f 64 65 0a 2e 73  r "list" mode..s
0f00: 68 6f 77 20 20 20 20 20 20 20 20 20 20 20 20 20  how             
0f10: 20 20 20 20 20 53 68 6f 77 20 74 68 65 20 63 75       Show the cu
0f20: 72 72 65 6e 74 20 76 61 6c 75 65 73 20 66 6f 72  rrent values for
0f30: 20 74 68 65 20 66 6f 6c 6c 6f 77 69 6e 67 3a 0a   the following:.
0f40: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0f50: 20 20 20 20 20 20 20 2e 65 63 68 6f 0a 20 20 20         .echo.   
0f60: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0f70: 20 20 20 20 2e 65 78 70 6c 61 69 6e 0a 20 20 20      .explain.   
0f80: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0f90: 20 20 20 20 2e 6d 6f 64 65 0a 20 20 20 20 20 20      .mode.      
0fa0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0fb0: 20 2e 6e 75 6c 6c 76 61 6c 75 65 0a 20 20 20 20   .nullvalue.    
0fc0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0fd0: 20 20 20 2e 6f 75 74 70 75 74 0a 20 20 20 20 20     .output.     
0fe0: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
0ff0: 20 20 2e 73 65 70 61 72 61 74 6f 72 0a 20 20 20    .separator.   
1000: 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20 20                  
1010: 20 20 20 20 2e 77 69 64 74 68 0a 2e 74 61 62 6c      .width..tabl
1020: 65 73 20 3f 50 41 54 54 45 52 4e 3f 20 20 20 20  es ?PATTERN?    
1030: 20 20 4c 69 73 74 20 6e 61 6d 65 73 20 6f 66 20    List names of 
1040: 74 61 62 6c 65 73 20 6d 61 74 63 68 69 6e 67 20  tables matching 
1050: 61 20 70 61 74 74 65 72 6e 0a 2e 74 69 6d 65 6f  a pattern..timeo
1060: 75 74 20 4d 53 20 20 20 20 20 20 20 20 20 20 20  ut MS           
1070: 20 54 72 79 20 6f 70 65 6e 69 6e 67 20 6c 6f 63   Try opening loc
1080: 6b 65 64 20 74 61 62 6c 65 73 20 66 6f 72 20 4d  ked tables for M
1090: 53 20 6d 69 6c 6c 69 73 65 63 6f 6e 64 73 0a 2e  S milliseconds..
10a0: 77 69 64 74 68 20 4e 55 4d 20 4e 55 4d 20 2e 2e  width NUM NUM ..
10b0: 2e 20 20 20 20 20 53 65 74 20 63 6f 6c 75 6d 6e  .     Set column
10c0: 20 77 69 64 74 68 73 20 66 6f 72 20 22 63 6f 6c   widths for "col
10d0: 75 6d 6e 22 20 6d 6f 64 65 0a 73 71 6c 69 74 65  umn" mode.sqlite
10e0: 3e 0a 7c 63 63 20 2e 0a 2e 73 70 0a 2e 66 69 0a  >.|cc ...sp..fi.
10f0: 0a 2e 53 48 20 4f 50 54 49 4f 4e 53 0a 54 68 65  ..SH OPTIONS.The
1100: 20 70 72 6f 67 72 61 6d 20 68 61 73 20 74 68 65   program has the
1110: 20 66 6f 6c 6c 6f 77 69 6e 67 20 6f 70 74 69 6f   following optio
1120: 6e 73 3a 0a 2e 54 50 0a 2e 42 49 20 5c 2d 69 6e  ns:..TP..BI \-in
1130: 69 74 5c 20 66 69 6c 65 0a 52 65 61 64 20 69 6e  it\ file.Read in
1140: 20 61 6e 64 20 70 72 6f 63 65 73 73 20 27 66 69   and process 'fi
1150: 6c 65 27 2c 20 77 68 69 63 68 20 63 6f 6e 74 61  le', which conta
1160: 69 6e 73 20 22 64 6f 74 20 63 6f 6d 6d 61 6e 64  ins "dot command
1170: 73 22 2e 0a 59 6f 75 20 63 61 6e 20 75 73 65 20  s"..You can use 
1180: 74 68 69 73 20 66 69 6c 65 20 74 6f 20 69 6e 69  this file to ini
1190: 74 69 61 6c 69 7a 65 20 64 69 73 70 6c 61 79 20  tialize display 
11a0: 73 65 74 74 69 6e 67 73 2e 0a 2e 54 50 0a 2e 42  settings...TP..B
11b0: 20 5c 2d 68 74 6d 6c 0a 53 65 74 20 6f 75 74 70   \-html.Set outp
11c0: 75 74 20 6d 6f 64 65 20 74 6f 20 48 54 4d 4c 2e  ut mode to HTML.
11d0: 0a 2e 54 50 0a 2e 42 20 5c 2d 6c 69 73 74 0a 53  ..TP..B \-list.S
11e0: 65 74 20 6f 75 74 70 75 74 20 6d 6f 64 65 20 74  et output mode t
11f0: 6f 20 27 6c 69 73 74 27 2e 0a 2e 54 50 0a 2e 42  o 'list'...TP..B
1200: 20 5c 2d 6c 69 6e 65 0a 53 65 74 20 6f 75 74 70   \-line.Set outp
1210: 75 74 20 6d 6f 64 65 20 74 6f 20 27 6c 69 6e 65  ut mode to 'line
1220: 27 2e 0a 2e 54 50 0a 2e 42 20 5c 2d 63 6f 6c 75  '...TP..B \-colu
1230: 6d 6e 0a 53 65 74 20 6f 75 74 70 75 74 20 6d 6f  mn.Set output mo
1240: 64 65 20 74 6f 20 27 63 6f 6c 75 6d 6e 27 2e 0a  de to 'column'..
1250: 2e 54 50 0a 2e 42 49 20 5c 2d 73 65 70 61 72 61  .TP..BI \-separa
1260: 74 6f 72 5c 20 20 73 65 70 61 72 61 74 6f 72 0a  tor\  separator.
1270: 53 70 65 63 69 66 79 20 77 68 69 63 68 20 6f 75  Specify which ou
1280: 74 70 75 74 20 66 69 65 6c 64 20 73 65 70 61 72  tput field separ
1290: 61 74 6f 72 20 66 6f 72 20 27 6c 69 73 74 27 20  ator for 'list' 
12a0: 6d 6f 64 65 20 74 6f 20 75 73 65 2e 0a 44 65 66  mode to use..Def
12b0: 61 75 6c 74 20 69 73 20 27 7c 27 2e 0a 2e 54 50  ault is '|'...TP
12c0: 0a 2e 42 49 20 5c 2d 6e 75 6c 6c 76 61 6c 75 65  ..BI \-nullvalue
12d0: 5c 20 20 73 74 72 69 6e 67 0a 57 68 65 6e 20 61  \  string.When a
12e0: 20 6e 75 6c 6c 20 69 73 20 65 6e 63 6f 75 6e 74   null is encount
12f0: 65 72 65 64 2c 20 70 72 69 6e 74 20 27 73 74 72  ered, print 'str
1300: 69 6e 67 27 2e 20 44 65 66 61 75 6c 74 20 69 73  ing'. Default is
1310: 20 6e 6f 20 73 74 72 69 6e 67 2e 0a 2e 54 50 0a   no string...TP.
1320: 2e 42 20 5c 2d 5b 6e 6f 5d 68 65 61 64 65 72 0a  .B \-[no]header.
1330: 54 75 72 6e 20 68 65 61 64 65 72 73 20 6f 6e 20  Turn headers on 
1340: 6f 72 20 6f 66 66 2e 20 44 65 66 61 75 6c 74 20  or off. Default 
1350: 69 73 20 6f 66 66 2e 0a 2e 54 50 0a 2e 42 20 5c  is off...TP..B \
1360: 2d 65 63 68 6f 0a 50 72 69 6e 74 20 63 6f 6d 6d  -echo.Print comm
1370: 61 6e 64 73 20 62 65 66 6f 72 65 20 65 78 65 63  ands before exec
1380: 75 74 69 6f 6e 2e 0a 0a 0a 2e 53 48 20 4f 55 54  ution.....SH OUT
1390: 50 55 54 20 4d 4f 44 45 0a 54 68 65 20 53 51 4c  PUT MODE.The SQL
13a0: 69 74 65 20 70 72 6f 67 72 61 6d 20 68 61 73 20  ite program has 
13b0: 64 69 66 66 65 72 65 6e 74 20 6f 75 74 70 75 74  different output
13c0: 20 6d 6f 64 65 73 2c 20 77 68 69 63 68 20 64 65   modes, which de
13d0: 66 69 6e 65 20 74 68 65 20 77 61 79 0a 74 68 65  fine the way.the
13e0: 20 6f 75 74 70 75 74 20 28 66 72 6f 6d 20 71 75   output (from qu
13f0: 65 72 69 65 73 29 20 69 73 20 66 6f 72 6d 61 74  eries) is format
1400: 74 65 64 2e 0a 0a 49 6e 20 27 6c 69 73 74 27 20  ted...In 'list' 
1410: 6d 6f 64 65 2c 20 77 68 69 63 68 20 69 73 20 74  mode, which is t
1420: 68 65 20 64 65 66 61 75 6c 74 2c 20 6f 6e 65 20  he default, one 
1430: 72 65 63 6f 72 64 20 70 65 72 20 6c 69 6e 65 20  record per line 
1440: 69 73 20 6f 75 74 70 75 74 2c 0a 65 61 63 68 20  is output,.each 
1450: 66 69 65 6c 64 20 73 65 70 61 72 61 74 65 64 20  field separated 
1460: 62 79 20 74 68 65 20 73 65 70 61 72 61 74 6f 72  by the separator
1470: 20 73 70 65 63 69 66 69 65 64 20 77 69 74 68 20   specified with 
1480: 74 68 65 0a 5c 66 42 2d 73 65 70 61 72 61 74 6f  the.\fB-separato
1490: 72 5c 66 50 20 6f 70 74 69 6f 6e 20 6f 72 20 5c  r\fP option or \
14a0: 66 42 2e 73 65 70 61 72 61 74 6f 72 5c 66 50 20  fB.separator\fP 
14b0: 63 6f 6d 6d 61 6e 64 2e 0a 0a 49 6e 20 27 6c 69  command...In 'li
14c0: 6e 65 27 20 6d 6f 64 65 2c 20 65 61 63 68 20 63  ne' mode, each c
14d0: 6f 6c 75 6d 6e 20 69 73 20 6f 75 74 70 75 74 20  olumn is output 
14e0: 6f 6e 20 69 74 73 20 6f 77 6e 20 6c 69 6e 65 2c  on its own line,
14f0: 20 72 65 63 6f 72 64 73 20 61 72 65 0a 73 65 70   records are.sep
1500: 61 72 61 74 65 64 20 62 79 20 62 6c 61 6e 6b 20  arated by blank 
1510: 6c 69 6e 65 73 2e 0a 0a 49 6e 20 48 54 4d 4c 20  lines...In HTML 
1520: 6d 6f 64 65 2c 20 61 6e 20 58 48 54 4d 4c 20 74  mode, an XHTML t
1530: 61 62 6c 65 20 69 73 20 67 65 6e 65 72 61 74 65  able is generate
1540: 64 2e 0a 0a 49 6e 20 27 63 6f 6c 75 6d 6e 27 20  d...In 'column' 
1550: 6d 6f 64 65 2c 20 6f 6e 65 20 72 65 63 6f 72 64  mode, one record
1560: 20 70 65 72 20 6c 69 6e 65 20 69 73 20 6f 75 74   per line is out
1570: 70 75 74 2c 20 61 6c 69 67 6e 65 64 20 6e 65 61  put, aligned nea
1580: 74 6c 79 20 69 6e 20 63 6f 6c 75 6d 73 2e 0a 0a  tly in colums...
1590: 2e 53 48 20 49 4e 49 54 20 46 49 4c 45 0a 73 71  .SH INIT FILE.sq
15a0: 6c 69 74 65 20 63 61 6e 20 62 65 20 69 6e 69 74  lite can be init
15b0: 69 61 6c 69 7a 65 64 20 75 73 69 6e 67 20 72 65  ialized using re
15c0: 73 6f 75 72 63 65 20 66 69 6c 65 73 2e 20 54 68  source files. Th
15d0: 65 73 65 20 63 61 6e 20 62 65 20 63 6f 6d 62 69  ese can be combi
15e0: 6e 65 64 20 77 69 74 68 0a 63 6f 6d 6d 61 6e 64  ned with.command
15f0: 20 6c 69 6e 65 20 61 72 67 75 6d 65 6e 74 73 20   line arguments 
1600: 74 6f 20 73 65 74 20 75 70 20 73 71 6c 69 74 65  to set up sqlite
1610: 20 65 78 61 63 74 6c 79 20 74 68 65 20 77 61 79   exactly the way
1620: 20 79 6f 75 20 77 61 6e 74 20 69 74 2e 0a 49 6e   you want it..In
1630: 69 74 69 61 6c 69 7a 61 74 69 6f 6e 20 70 72 6f  itialization pro
1640: 63 65 65 64 73 20 61 73 20 66 6f 6c 6c 6f 77 73  ceeds as follows
1650: 3a 0a 0a 6f 20 54 68 65 20 64 65 66 61 75 6c 74  :..o The default
1660: 73 20 6f 66 0a 0a 2e 73 70 0a 2e 6e 66 0a 2e 63  s of...sp..nf..c
1670: 63 20 7c 0a 6d 6f 64 65 20 20 20 20 20 20 20 20  c |.mode        
1680: 20 20 20 20 3d 20 4c 49 53 54 0a 73 65 70 61 72      = LIST.separ
1690: 61 74 6f 72 20 20 20 20 20 20 20 3d 20 22 7c 22  ator       = "|"
16a0: 0a 6d 61 69 6e 20 70 72 6f 6d 70 74 20 20 20 20  .main prompt    
16b0: 20 3d 20 22 73 71 6c 69 74 65 3e 20 22 0a 63 6f   = "sqlite> ".co
16c0: 6e 74 69 6e 75 65 20 70 72 6f 6d 70 74 20 3d 20  ntinue prompt = 
16d0: 22 20 20 20 2e 2e 2e 3e 20 22 0a 7c 63 63 20 2e  "   ...> ".|cc .
16e0: 0a 2e 73 70 0a 2e 66 69 0a 0a 61 72 65 20 65 73  ..sp..fi..are es
16f0: 74 61 62 6c 69 73 68 65 64 2e 0a 0a 6f 20 49 66  tablished...o If
1700: 20 61 20 66 69 6c 65 20 2e 73 71 6c 69 74 65 72   a file .sqliter
1710: 63 20 63 61 6e 20 62 65 20 66 6f 75 6e 64 20 69  c can be found i
1720: 6e 20 74 68 65 20 75 73 65 72 27 73 20 68 6f 6d  n the user's hom
1730: 65 20 64 69 72 65 63 74 6f 72 79 2c 20 69 74 20  e directory, it 
1740: 69 73 0a 72 65 61 64 20 61 6e 64 20 70 72 6f 63  is.read and proc
1750: 65 73 73 65 64 2e 20 49 74 20 73 68 6f 75 6c 64  essed. It should
1760: 20 6f 6e 6c 79 20 63 6f 6e 74 61 69 6e 20 22 64   only contain "d
1770: 6f 74 20 63 6f 6d 6d 61 6e 64 73 22 2e 20 20 49  ot commands".  I
1780: 66 20 74 68 65 0a 66 69 6c 65 20 69 73 20 6e 6f  f the.file is no
1790: 74 20 66 6f 75 6e 64 20 6f 72 20 63 61 6e 6e 6f  t found or canno
17a0: 74 20 62 65 20 72 65 61 64 2c 20 70 72 6f 63 65  t be read, proce
17b0: 73 73 69 6e 67 20 63 6f 6e 74 69 6e 75 65 73 20  ssing continues 
17c0: 77 69 74 68 6f 75 74 0a 6e 6f 74 69 66 69 63 61  without.notifica
17d0: 74 69 6f 6e 2e 0a 0a 6f 20 49 66 20 61 20 66 69  tion...o If a fi
17e0: 6c 65 20 69 73 20 73 70 65 63 69 66 69 65 64 20  le is specified 
17f0: 6f 6e 20 74 68 65 20 63 6f 6d 6d 61 6e 64 20 6c  on the command l
1800: 69 6e 65 20 77 69 74 68 20 74 68 65 20 2d 69 6e  ine with the -in
1810: 69 74 20 6f 70 74 69 6f 6e 2c 20 69 74 0a 69 73  it option, it.is
1820: 20 70 72 6f 63 65 73 73 65 64 20 69 6e 20 74 68   processed in th
1830: 65 20 73 61 6d 65 20 6d 61 6e 6e 65 72 20 61 73  e same manner as
1840: 20 2e 73 71 6c 69 74 65 72 63 0a 0a 6f 20 41 6c   .sqliterc..o Al
1850: 6c 20 6f 74 68 65 72 20 63 6f 6d 6d 61 6e 64 20  l other command 
1860: 6c 69 6e 65 20 6f 70 74 69 6f 6e 73 20 61 72 65  line options are
1870: 20 70 72 6f 63 65 73 73 65 64 0a 0a 6f 20 54 68   processed..o Th
1880: 65 20 64 61 74 61 62 61 73 65 20 69 73 20 6f 70  e database is op
1890: 65 6e 65 64 20 61 6e 64 20 79 6f 75 20 61 72 65  ened and you are
18a0: 20 6e 6f 77 20 72 65 61 64 79 20 74 6f 20 62 65   now ready to be
18b0: 67 69 6e 2e 0a 0a 2e 53 48 20 53 45 45 20 41 4c  gin....SH SEE AL
18c0: 53 4f 0a 68 74 74 70 3a 2f 2f 77 77 77 2e 68 77  SO.http://www.hw
18d0: 61 63 69 2e 63 6f 6d 2f 73 77 2f 73 71 6c 69 74  aci.com/sw/sqlit
18e0: 65 2f 0a 2e 62 72 0a 54 68 65 20 73 71 6c 69 74  e/..br.The sqlit
18f0: 65 2d 64 6f 63 20 70 61 63 6b 61 67 65 0a 2e 53  e-doc package..S
1900: 48 20 41 55 54 48 4f 52 0a 54 68 69 73 20 6d 61  H AUTHOR.This ma
1910: 6e 75 61 6c 20 70 61 67 65 20 77 61 73 20 6f 72  nual page was or
1920: 69 67 69 6e 61 6c 6c 79 20 77 72 69 74 74 65 6e  iginally written
1930: 20 62 79 20 41 6e 64 72 65 61 73 20 52 6f 74 74   by Andreas Rott
1940: 6d 61 6e 6e 0a 3c 72 6f 74 74 79 40 64 65 62 69  mann.<rotty@debi
1950: 61 6e 2e 6f 72 67 3e 2c 20 66 6f 72 20 74 68 65  an.org>, for the
1960: 20 44 65 62 69 61 6e 20 47 4e 55 2f 4c 69 6e 75   Debian GNU/Linu
1970: 78 20 73 79 73 74 65 6d 20 28 62 75 74 20 6d 61  x system (but ma
1980: 79 20 62 65 20 75 73 65 64 0a 62 79 20 6f 74 68  y be used.by oth
1990: 65 72 73 29 2e 0a                                ers)..