/ Hex Artifact Content
Login

Artifact b357f5ba954b046ee35392ce0f884a2fcfcdea06:


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 61 75 74 6f 69 6e 63 2e  ate the autoinc.
0030: 68 74 6d 6c 20 66 69 6c 65 2e 0a 23 0a 73 65 74  html file..#.set
0040: 20 72 63 73 69 64 20 7b 24 49 64 3a 20 7d 0a 73   rcsid {$Id: }.s
0050: 6f 75 72 63 65 20 63 6f 6d 6d 6f 6e 2e 74 63 6c  ource common.tcl
0060: 0a 0a 69 66 20 7b 5b 6c 6c 65 6e 67 74 68 20 24  ..if {[llength $
0070: 61 72 67 76 5d 3e 30 7d 20 7b 0a 20 20 73 65 74  argv]>0} {.  set
0080: 20 6f 75 74 70 75 74 64 69 72 20 5b 6c 69 6e 64   outputdir [lind
0090: 65 78 20 24 61 72 67 76 20 30 5d 0a 7d 20 65 6c  ex $argv 0].} el
00a0: 73 65 20 7b 0a 20 20 73 65 74 20 6f 75 74 70 75  se {.  set outpu
00b0: 74 64 69 72 20 22 22 0a 7d 0a 0a 68 65 61 64 65  tdir "".}..heade
00c0: 72 20 7b 53 51 4c 69 74 65 20 41 75 74 6f 69 6e  r {SQLite Autoin
00d0: 63 72 65 6d 65 6e 74 7d 0a 70 75 74 73 20 7b 0a  crement}.puts {.
00e0: 3c 68 31 3e 53 51 4c 69 74 65 20 41 75 74 6f 69  <h1>SQLite Autoi
00f0: 6e 63 72 65 6d 65 6e 74 3c 2f 68 31 3e 0a 0a 3c  ncrement</h1>..<
0100: 70 3e 0a 49 6e 20 53 51 4c 69 74 65 2c 20 65 76  p>.In SQLite, ev
0110: 65 72 79 20 72 6f 77 20 6f 66 20 65 76 65 72 79  ery row of every
0120: 20 74 61 62 6c 65 20 68 61 73 20 61 6e 20 69 6e   table has an in
0130: 74 65 67 65 72 20 52 4f 57 49 44 2e 0a 54 68 65  teger ROWID..The
0140: 20 52 4f 57 49 44 20 66 6f 72 20 65 61 63 68 20   ROWID for each 
0150: 72 6f 77 20 69 73 20 75 6e 69 71 75 65 20 61 6d  row is unique am
0160: 6f 6e 67 20 61 6c 6c 20 72 6f 77 73 20 69 6e 20  ong all rows in 
0170: 74 68 65 20 73 61 6d 65 20 74 61 62 6c 65 2e 0a  the same table..
0180: 49 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f  In SQLite versio
0190: 6e 20 32 2e 38 20 74 68 65 20 52 4f 57 49 44 20  n 2.8 the ROWID 
01a0: 69 73 20 61 20 33 32 2d 62 69 74 20 73 69 67 6e  is a 32-bit sign
01b0: 65 64 20 69 6e 74 65 67 65 72 2e 0a 56 65 72 73  ed integer..Vers
01c0: 69 6f 6e 20 33 2e 30 20 6f 66 20 53 51 4c 69 74  ion 3.0 of SQLit
01d0: 65 20 65 78 70 61 6e 64 65 64 20 74 68 65 20 52  e expanded the R
01e0: 4f 57 49 44 20 74 6f 20 62 65 20 61 20 36 34 2d  OWID to be a 64-
01f0: 62 69 74 20 73 69 67 6e 65 64 20 69 6e 74 65 67  bit signed integ
0200: 65 72 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 59 6f  er..</p>..<p>.Yo
0210: 75 20 63 61 6e 20 61 63 63 65 73 73 20 74 68 65  u can access the
0220: 20 52 4f 57 49 44 20 6f 66 20 61 6e 20 53 51 4c   ROWID of an SQL
0230: 69 74 65 20 74 61 62 6c 65 20 75 73 69 6e 67 20  ite table using 
0240: 6f 6e 65 20 74 68 65 20 73 70 65 63 69 61 6c 20  one the special 
0250: 63 6f 6c 75 6d 6e 0a 6e 61 6d 65 73 20 52 4f 57  column.names ROW
0260: 49 44 2c 20 5f 52 4f 57 49 44 5f 2c 20 6f 72 20  ID, _ROWID_, or 
0270: 4f 49 44 2e 0a 45 78 63 65 70 74 20 69 66 20 79  OID..Except if y
0280: 6f 75 20 64 65 63 6c 61 72 65 20 61 6e 20 6f 72  ou declare an or
0290: 64 69 6e 61 72 79 20 74 61 62 6c 65 20 63 6f 6c  dinary table col
02a0: 75 6d 6e 20 74 6f 20 75 73 65 20 6f 6e 65 20 6f  umn to use one o
02b0: 66 20 74 68 6f 73 65 20 73 70 65 63 69 61 6c 0a  f those special.
02c0: 6e 61 6d 65 73 2c 20 74 68 65 6e 20 74 68 65 20  names, then the 
02d0: 75 73 65 20 6f 66 20 74 68 61 74 20 6e 61 6d 65  use of that name
02e0: 20 77 69 6c 6c 20 72 65 66 65 72 20 74 6f 20 74   will refer to t
02f0: 68 65 20 64 65 63 6c 61 72 65 64 20 63 6f 6c 75  he declared colu
0300: 6d 6e 20 6e 6f 74 0a 74 6f 20 74 68 65 20 69 6e  mn not.to the in
0310: 74 65 72 6e 61 6c 20 52 4f 57 49 44 2e 0a 3c 2f  ternal ROWID..</
0320: 70 3e 0a 0a 3c 70 3e 0a 49 66 20 61 20 74 61 62  p>..<p>.If a tab
0330: 6c 65 20 63 6f 6e 74 61 69 6e 73 20 61 20 63 6f  le contains a co
0340: 6c 75 6d 6e 20 6f 66 20 74 79 70 65 20 49 4e 54  lumn of type INT
0350: 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59  EGER PRIMARY KEY
0360: 2c 20 74 68 65 6e 20 74 68 61 74 0a 63 6f 6c 75  , then that.colu
0370: 6d 6e 20 62 65 63 6f 6d 65 73 20 61 6e 20 61 6c  mn becomes an al
0380: 69 61 73 20 66 6f 72 20 74 68 65 20 52 4f 57 49  ias for the ROWI
0390: 44 2e 20 20 59 6f 75 20 63 61 6e 20 74 68 65 6e  D.  You can then
03a0: 20 61 63 63 65 73 73 20 74 68 65 20 52 4f 57 49   access the ROWI
03b0: 44 0a 75 73 69 6e 67 20 61 6e 79 20 6f 66 20 66  D.using any of f
03c0: 6f 75 72 20 64 69 66 66 65 72 65 6e 74 20 6e 61  our different na
03d0: 6d 65 73 2c 20 74 68 65 20 6f 72 69 67 69 6e 61  mes, the origina
03e0: 6c 20 74 68 72 65 65 20 6e 61 6d 65 73 20 64 65  l three names de
03f0: 73 63 72 69 62 65 64 20 61 62 6f 76 65 0a 6f 72  scribed above.or
0400: 20 74 68 65 20 6e 61 6d 65 20 67 69 76 65 6e 20   the name given 
0410: 74 6f 20 74 68 65 20 49 4e 54 45 47 45 52 20 50  to the INTEGER P
0420: 52 49 4d 41 52 59 20 4b 45 59 20 63 6f 6c 75 6d  RIMARY KEY colum
0430: 6e 2e 20 20 41 6c 6c 20 74 68 65 73 65 20 6e 61  n.  All these na
0440: 6d 65 73 20 61 72 65 0a 61 6c 69 61 73 65 73 20  mes are.aliases 
0450: 66 6f 72 20 6f 6e 65 20 61 6e 6f 74 68 65 72 20  for one another 
0460: 61 6e 64 20 77 6f 72 6b 20 65 71 75 61 6c 6c 79  and work equally
0470: 20 77 65 6c 6c 20 69 6e 20 61 6e 79 20 63 6f 6e   well in any con
0480: 74 65 78 74 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  text..</p>..<p>.
0490: 57 68 65 6e 20 61 20 6e 65 77 20 72 6f 77 20 69  When a new row i
04a0: 73 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f 20  s inserted into 
04b0: 61 6e 20 53 51 4c 69 74 65 20 74 61 62 6c 65 2c  an SQLite table,
04c0: 20 74 68 65 20 52 4f 57 49 44 20 63 61 6e 20 65   the ROWID can e
04d0: 69 74 68 65 72 0a 62 65 20 73 70 65 63 69 66 69  ither.be specifi
04e0: 65 64 20 61 73 20 70 61 72 74 20 6f 66 20 74 68  ed as part of th
04f0: 65 20 49 4e 53 45 52 54 20 73 74 61 74 65 6d 65  e INSERT stateme
0500: 6e 74 20 6f 72 20 69 74 20 63 61 6e 20 62 65 20  nt or it can be 
0510: 61 73 73 69 67 6e 65 64 0a 61 75 74 6f 6d 61 74  assigned.automat
0520: 69 63 61 6c 6c 79 20 62 79 20 74 68 65 20 64 61  ically by the da
0530: 74 61 62 61 73 65 20 65 6e 67 69 6e 65 2e 20 20  tabase engine.  
0540: 54 6f 20 73 70 65 63 69 66 79 20 61 20 52 4f 57  To specify a ROW
0550: 49 44 20 6d 61 6e 75 61 6c 6c 79 2c 0a 6a 75 73  ID manually,.jus
0560: 74 20 69 6e 63 6c 75 64 65 20 69 74 20 69 6e 20  t include it in 
0570: 74 68 65 20 6c 69 73 74 20 6f 66 20 76 61 6c 75  the list of valu
0580: 65 73 20 74 6f 20 62 65 20 69 6e 73 65 72 74 65  es to be inserte
0590: 64 2e 20 20 46 6f 72 20 65 78 61 6d 70 6c 65 3a  d.  For example:
05a0: 0a 3c 2f 70 3e 0a 0a 3c 62 6c 6f 63 6b 71 75 6f  .</p>..<blockquo
05b0: 74 65 3e 3c 70 72 65 3e 0a 43 52 45 41 54 45 20  te><pre>.CREATE 
05c0: 54 41 42 4c 45 20 74 65 73 74 31 28 61 20 49 4e  TABLE test1(a IN
05d0: 54 2c 20 62 20 54 45 58 54 29 3b 0a 49 4e 53 45  T, b TEXT);.INSE
05e0: 52 54 20 49 4e 54 4f 20 74 65 73 74 31 28 72 6f  RT INTO test1(ro
05f0: 77 69 64 2c 20 61 2c 20 62 29 20 56 41 4c 55 45  wid, a, b) VALUE
0600: 53 28 31 32 33 2c 20 35 2c 20 27 68 65 6c 6c 6f  S(123, 5, 'hello
0610: 27 29 3b 0a 3c 2f 70 72 65 3e 3c 2f 62 6c 6f 63  ');.</pre></bloc
0620: 6b 71 75 6f 74 65 3e 0a 0a 3c 70 3e 0a 49 66 20  kquote>..<p>.If 
0630: 6e 6f 20 52 4f 57 49 44 20 69 73 20 73 70 65 63  no ROWID is spec
0640: 69 66 69 65 64 20 6f 6e 20 74 68 65 20 69 6e 73  ified on the ins
0650: 65 72 74 2c 20 61 6e 20 61 70 70 72 6f 70 72 69  ert, an appropri
0660: 61 74 65 20 52 4f 57 49 44 20 69 73 20 63 72 65  ate ROWID is cre
0670: 61 74 65 64 0a 61 75 74 6f 6d 61 74 69 63 61 6c  ated.automatical
0680: 6c 79 2e 20 20 54 68 65 20 75 73 75 61 6c 20 61  ly.  The usual a
0690: 6c 67 6f 72 69 74 68 6d 20 69 73 20 74 6f 20 67  lgorithm is to g
06a0: 69 76 65 20 74 68 65 20 6e 65 77 6c 79 20 63 72  ive the newly cr
06b0: 65 61 74 65 64 20 72 6f 77 0a 61 20 52 4f 57 49  eated row.a ROWI
06c0: 44 20 74 68 61 74 20 69 73 20 6f 6e 65 20 6c 61  D that is one la
06d0: 72 67 65 72 20 74 68 61 6e 20 74 68 65 20 6c 61  rger than the la
06e0: 72 67 65 73 74 20 52 4f 57 49 44 20 69 6e 20 74  rgest ROWID in t
06f0: 68 65 20 74 61 62 6c 65 20 70 72 69 6f 72 0a 74  he table prior.t
0700: 6f 20 74 68 65 20 69 6e 73 65 72 74 2e 20 20 49  o the insert.  I
0710: 66 20 74 68 65 20 74 61 62 6c 65 20 69 73 20 69  f the table is i
0720: 6e 69 74 69 61 6c 6c 79 20 65 6d 70 74 79 2c 20  nitially empty, 
0730: 74 68 65 6e 20 61 20 52 4f 57 49 44 20 6f 66 20  then a ROWID of 
0740: 31 20 69 73 0a 75 73 65 64 2e 20 20 49 66 20 74  1 is.used.  If t
0750: 68 65 20 6c 61 72 67 65 73 74 20 52 4f 57 49 44  he largest ROWID
0760: 20 69 73 20 65 71 75 61 6c 20 74 6f 20 74 68 65   is equal to the
0770: 20 6c 61 72 67 65 73 74 20 70 6f 73 73 69 62 6c   largest possibl
0780: 65 20 69 6e 74 65 67 65 72 0a 28 39 32 32 33 33  e integer.(92233
0790: 37 32 30 33 36 38 35 34 37 37 35 38 30 37 20 69  72036854775807 i
07a0: 6e 20 53 51 4c 69 74 65 20 76 65 72 73 69 6f 6e  n SQLite version
07b0: 20 33 2e 30 20 61 6e 64 20 6c 61 74 65 72 29 20   3.0 and later) 
07c0: 74 68 65 6e 20 74 68 65 20 64 61 74 61 62 61 73  then the databas
07d0: 65 0a 65 6e 67 69 6e 65 20 73 74 61 72 74 73 20  e.engine starts 
07e0: 70 69 63 6b 69 6e 67 20 63 61 6e 64 69 64 61 74  picking candidat
07f0: 65 20 52 4f 57 49 44 73 20 61 74 20 72 61 6e 64  e ROWIDs at rand
0800: 6f 6d 20 75 6e 74 69 6c 20 69 74 20 66 69 6e 64  om until it find
0810: 73 20 6f 6e 65 0a 74 68 61 74 20 69 73 20 6e 6f  s one.that is no
0820: 74 20 70 72 65 76 69 6f 75 73 6c 79 20 75 73 65  t previously use
0830: 64 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a 54 68 65  d..</p>..<p>.The
0840: 20 6e 6f 72 6d 61 6c 20 52 4f 57 49 44 20 73 65   normal ROWID se
0850: 6c 65 63 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68  lection algorith
0860: 6d 20 64 65 73 63 72 69 62 65 64 20 61 62 6f 76  m described abov
0870: 65 0a 77 69 6c 6c 20 67 65 6e 65 72 61 74 65 20  e.will generate 
0880: 6d 6f 6e 6f 74 6f 6e 69 63 61 6c 6c 79 20 69 6e  monotonically in
0890: 63 72 65 61 73 69 6e 67 0a 75 6e 69 71 75 65 20  creasing.unique 
08a0: 52 4f 57 49 44 73 20 61 73 20 6c 6f 6e 67 20 61  ROWIDs as long a
08b0: 73 20 79 6f 75 20 6e 65 76 65 72 20 75 73 65 20  s you never use 
08c0: 74 68 65 20 6d 61 78 69 6d 75 6d 20 52 4f 57 49  the maximum ROWI
08d0: 44 20 76 61 6c 75 65 20 61 6e 64 20 79 6f 75 20  D value and you 
08e0: 6e 65 76 65 72 0a 64 65 6c 65 74 65 20 74 68 65  never.delete the
08f0: 20 65 6e 74 72 79 20 69 6e 20 74 68 65 20 74 61   entry in the ta
0900: 62 6c 65 20 77 69 74 68 20 74 68 65 20 6c 61 72  ble with the lar
0910: 67 65 73 74 20 52 4f 57 49 44 2e 20 0a 49 66 20  gest ROWID. .If 
0920: 79 6f 75 20 65 76 65 72 20 64 65 6c 65 74 65 20  you ever delete 
0930: 72 6f 77 73 20 6f 72 20 69 66 20 79 6f 75 20 65  rows or if you e
0940: 76 65 72 20 63 72 65 61 74 65 20 61 20 72 6f 77  ver create a row
0950: 20 77 69 74 68 20 74 68 65 20 6d 61 78 69 6d 75   with the maximu
0960: 6d 20 70 6f 73 73 69 62 6c 65 0a 52 4f 57 49 44  m possible.ROWID
0970: 2c 20 74 68 65 6e 20 52 4f 57 49 44 73 20 66 72  , then ROWIDs fr
0980: 6f 6d 20 70 72 65 76 69 6f 75 73 6c 79 20 64 65  om previously de
0990: 6c 65 74 65 64 20 72 6f 77 73 20 6d 69 67 68 74  leted rows might
09a0: 20 62 65 20 72 65 75 73 65 64 20 77 68 65 6e 20   be reused when 
09b0: 63 72 65 61 74 69 6e 67 0a 6e 65 77 20 72 6f 77  creating.new row
09c0: 73 20 61 6e 64 20 6e 65 77 6c 79 20 63 72 65 61  s and newly crea
09d0: 74 65 64 20 52 4f 57 49 44 73 20 6d 69 67 68 74  ted ROWIDs might
09e0: 20 6e 6f 74 20 62 65 20 69 6e 20 73 74 72 69 63   not be in stric
09f0: 74 6c 79 20 61 63 63 65 6e 64 69 6e 67 20 6f 72  tly accending or
0a00: 64 65 72 2e 0a 3c 2f 70 3e 0a 0a 0a 3c 68 32 3e  der..</p>...<h2>
0a10: 54 68 65 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e  The AUTOINCREMEN
0a20: 54 20 4b 65 79 77 6f 72 64 3c 2f 68 32 3e 0a 0a  T Keyword</h2>..
0a30: 3c 70 3e 0a 49 66 20 61 20 63 6f 6c 75 6d 6e 20  <p>.If a column 
0a40: 68 61 73 20 74 68 65 20 74 79 70 65 20 49 4e 54  has the type INT
0a50: 45 47 45 52 20 50 52 49 4d 41 52 59 20 4b 45 59  EGER PRIMARY KEY
0a60: 20 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 20 74   AUTOINCREMENT t
0a70: 68 65 6e 20 61 20 73 6c 69 67 68 74 6c 79 0a 64  hen a slightly.d
0a80: 69 66 66 65 72 65 6e 74 20 52 4f 57 49 44 20 73  ifferent ROWID s
0a90: 65 6c 65 63 74 69 6f 6e 20 61 6c 67 6f 72 69 74  election algorit
0aa0: 68 6d 20 69 73 20 75 73 65 64 2e 20 20 0a 54 68  hm is used.  .Th
0ab0: 65 20 52 4f 57 49 44 20 63 68 6f 73 65 6e 20 66  e ROWID chosen f
0ac0: 6f 72 20 74 68 65 20 6e 65 77 20 72 6f 77 20 69  or the new row i
0ad0: 73 20 6f 6e 65 20 6c 61 72 67 65 72 20 74 68 61  s one larger tha
0ae0: 6e 20 74 68 65 20 6c 61 72 67 65 73 74 20 52 4f  n the largest RO
0af0: 57 49 44 0a 74 68 61 74 20 68 61 73 20 65 76 65  WID.that has eve
0b00: 72 20 62 65 66 6f 72 65 20 65 78 69 73 74 65 64  r before existed
0b10: 20 69 6e 20 74 68 61 74 20 73 61 6d 65 20 74 61   in that same ta
0b20: 62 6c 65 2e 20 20 49 66 20 74 68 65 20 74 61 62  ble.  If the tab
0b30: 6c 65 20 68 61 73 20 6e 65 76 65 72 0a 62 65 66  le has never.bef
0b40: 6f 72 65 20 63 6f 6e 74 61 69 6e 65 64 20 61 6e  ore contained an
0b50: 79 20 64 61 74 61 2c 20 74 68 65 6e 20 61 20 52  y data, then a R
0b60: 4f 57 49 44 20 6f 66 20 31 20 69 73 20 75 73 65  OWID of 1 is use
0b70: 64 2e 20 20 49 66 20 74 68 65 20 74 61 62 6c 65  d.  If the table
0b80: 0a 68 61 73 20 70 72 65 76 69 6f 75 73 6c 79 20  .has previously 
0b90: 68 65 6c 64 20 61 20 72 6f 77 20 77 69 74 68 20  held a row with 
0ba0: 74 68 65 20 6c 61 72 67 65 73 74 20 70 6f 73 73  the largest poss
0bb0: 69 62 6c 65 20 52 4f 57 49 44 2c 20 74 68 65 6e  ible ROWID, then
0bc0: 20 6e 65 77 20 49 4e 53 45 52 54 73 0a 61 72 65   new INSERTs.are
0bd0: 20 6e 6f 74 20 61 6c 6c 6f 77 65 64 20 61 6e 64   not allowed and
0be0: 20 61 6e 79 20 61 74 74 65 6d 70 74 20 74 6f 20   any attempt to 
0bf0: 69 6e 73 65 72 74 20 61 20 6e 65 77 20 72 6f 77  insert a new row
0c00: 20 77 69 6c 6c 20 66 61 69 6c 20 77 69 74 68 20   will fail with 
0c10: 61 6e 0a 53 51 4c 49 54 45 5f 46 55 4c 4c 20 65  an.SQLITE_FULL e
0c20: 72 72 6f 72 2e 0a 3c 2f 70 3e 0a 0a 3c 70 3e 0a  rror..</p>..<p>.
0c30: 53 51 4c 69 74 65 20 6b 65 65 70 73 20 74 72 61  SQLite keeps tra
0c40: 63 6b 20 6f 66 20 74 68 65 20 6c 61 72 67 65 73  ck of the larges
0c50: 74 20 52 4f 57 49 44 20 74 68 61 74 20 61 20 74  t ROWID that a t
0c60: 61 62 6c 65 20 68 61 73 20 65 76 65 72 20 68 65  able has ever he
0c70: 6c 64 20 75 73 69 6e 67 0a 74 68 65 20 73 70 65  ld using.the spe
0c80: 63 69 61 6c 20 53 51 4c 49 54 45 5f 53 45 51 55  cial SQLITE_SEQU
0c90: 45 4e 43 45 20 74 61 62 6c 65 2e 20 20 54 68 65  ENCE table.  The
0ca0: 20 53 51 4c 49 54 45 5f 53 45 51 55 45 4e 43 45   SQLITE_SEQUENCE
0cb0: 20 74 61 62 6c 65 20 69 73 20 63 72 65 61 74 65   table is create
0cc0: 64 0a 61 6e 64 20 69 6e 69 74 69 61 6c 69 7a 65  d.and initialize
0cd0: 64 20 61 75 74 6f 6d 61 74 69 63 61 6c 6c 79 20  d automatically 
0ce0: 77 68 65 6e 65 76 65 72 20 61 20 6e 6f 72 6d 61  whenever a norma
0cf0: 6c 20 74 61 62 6c 65 20 74 68 61 74 20 63 6f 6e  l table that con
0d00: 74 61 69 6e 73 20 61 6e 0a 41 55 54 4f 49 4e 43  tains an.AUTOINC
0d10: 52 45 4d 45 4e 54 20 63 6f 6c 75 6d 6e 20 69 73  REMENT column is
0d20: 20 63 72 65 61 74 65 64 2e 20 20 54 68 65 20 63   created.  The c
0d30: 6f 6e 74 65 6e 74 20 6f 66 20 74 68 65 20 53 51  ontent of the SQ
0d40: 4c 49 54 45 5f 53 45 51 55 45 4e 43 45 20 74 61  LITE_SEQUENCE ta
0d50: 62 6c 65 0a 63 61 6e 20 62 65 20 6d 6f 64 69 66  ble.can be modif
0d60: 69 65 64 20 75 73 69 6e 67 20 6f 72 64 69 6e 61  ied using ordina
0d70: 72 79 20 55 50 44 41 54 45 2c 20 49 4e 53 45 52  ry UPDATE, INSER
0d80: 54 2c 20 61 6e 64 20 44 45 4c 45 54 45 20 73 74  T, and DELETE st
0d90: 61 74 65 6d 65 6e 74 73 2e 0a 42 75 74 20 6d 61  atements..But ma
0da0: 6b 69 6e 67 20 6d 6f 64 69 66 69 63 61 74 69 6f  king modificatio
0db0: 6e 73 20 74 6f 20 74 68 69 73 20 74 61 62 6c 65  ns to this table
0dc0: 20 77 69 6c 6c 20 6c 69 6b 65 6c 79 20 70 65 72   will likely per
0dd0: 74 75 72 62 20 74 68 65 20 41 55 54 4f 49 4e 43  turb the AUTOINC
0de0: 52 45 4d 45 4e 54 0a 6b 65 79 20 67 65 6e 65 72  REMENT.key gener
0df0: 61 74 69 6f 6e 20 61 6c 67 6f 72 69 74 68 6d 2e  ation algorithm.
0e00: 20 20 4d 61 6b 65 20 73 75 72 65 20 79 6f 75 20    Make sure you 
0e10: 6b 6e 6f 77 20 77 68 61 74 20 79 6f 75 20 61 72  know what you ar
0e20: 65 20 64 6f 69 6e 67 20 62 65 66 6f 72 65 0a 79  e doing before.y
0e30: 6f 75 20 75 6e 64 65 72 74 61 6b 65 20 73 75 63  ou undertake suc
0e40: 68 20 63 68 61 6e 67 65 73 2e 0a 3c 2f 70 3e 0a  h changes..</p>.
0e50: 0a 3c 70 3e 0a 54 68 65 20 62 65 68 61 76 69 6f  .<p>.The behavio
0e60: 72 20 69 6d 70 6c 65 6d 65 6e 74 65 64 20 62 79  r implemented by
0e70: 20 74 68 65 20 41 55 54 4f 49 4e 43 52 45 4d 45   the AUTOINCREME
0e80: 4e 54 20 6b 65 79 77 6f 72 64 20 69 73 20 73 75  NT keyword is su
0e90: 62 74 6c 79 20 64 69 66 66 65 72 65 6e 74 0a 66  btly different.f
0ea0: 72 6f 6d 20 74 68 65 20 64 65 66 61 75 6c 74 20  rom the default 
0eb0: 62 65 68 61 76 69 6f 72 2e 20 20 57 69 74 68 20  behavior.  With 
0ec0: 41 55 54 4f 49 4e 43 52 45 4d 45 4e 54 2c 20 72  AUTOINCREMENT, r
0ed0: 6f 77 73 20 77 69 74 68 20 61 75 74 6f 6d 61 74  ows with automat
0ee0: 69 63 61 6c 6c 79 0a 73 65 6c 65 63 74 65 64 20  ically.selected 
0ef0: 52 4f 57 49 44 73 20 61 72 65 20 67 75 61 72 61  ROWIDs are guara
0f00: 6e 74 65 65 64 20 74 6f 20 68 61 76 65 20 52 4f  nteed to have RO
0f10: 57 49 44 73 20 74 68 61 74 20 68 61 76 65 20 6e  WIDs that have n
0f20: 65 76 65 72 20 62 65 65 6e 20 75 73 65 64 0a 62  ever been used.b
0f30: 65 66 6f 72 65 20 62 79 20 74 68 65 20 73 61 6d  efore by the sam
0f40: 65 20 74 61 62 6c 65 20 69 6e 20 74 68 65 20 73  e table in the s
0f50: 61 6d 65 20 64 61 74 61 62 61 73 65 2e 20 20 41  ame database.  A
0f60: 6e 64 20 74 68 65 20 61 75 74 6f 6d 61 74 69 63  nd the automatic
0f70: 61 6c 6c 79 20 67 65 6e 65 72 61 74 65 64 0a 52  ally generated.R
0f80: 4f 57 49 44 73 20 61 72 65 20 67 75 61 72 61 6e  OWIDs are guaran
0f90: 74 65 65 64 20 74 6f 20 62 65 20 6d 6f 6e 6f 74  teed to be monot
0fa0: 6f 6e 69 63 61 6c 6c 79 20 69 6e 63 72 65 61 73  onically increas
0fb0: 69 6e 67 2e 20 20 54 68 65 73 65 20 61 72 65 20  ing.  These are 
0fc0: 69 6d 70 6f 72 74 61 6e 74 0a 70 72 6f 70 65 72  important.proper
0fd0: 74 69 65 73 20 69 6e 20 63 65 72 74 61 69 6e 20  ties in certain 
0fe0: 61 70 70 6c 69 63 61 74 69 6f 6e 73 2e 20 20 42  applications.  B
0ff0: 75 74 20 69 66 20 79 6f 75 72 20 61 70 70 6c 69  ut if your appli
1000: 63 61 74 69 6f 6e 20 64 6f 65 73 20 6e 6f 74 0a  cation does not.
1010: 6e 65 65 64 20 74 68 65 73 65 20 70 72 6f 70 65  need these prope
1020: 72 74 69 65 73 2c 20 79 6f 75 20 73 68 6f 75 6c  rties, you shoul
1030: 64 20 70 72 6f 62 61 62 6c 79 20 73 74 61 79 20  d probably stay 
1040: 77 69 74 68 20 74 68 65 20 64 65 66 61 75 6c 74  with the default
1050: 20 62 65 68 61 76 69 6f 72 0a 73 69 6e 63 65 20   behavior.since 
1060: 74 68 65 20 75 73 65 20 6f 66 20 41 55 54 4f 49  the use of AUTOI
1070: 4e 43 52 45 4d 45 4e 54 20 72 65 71 75 69 72 65  NCREMENT require
1080: 73 20 61 64 64 69 74 69 6f 6e 61 6c 20 77 6f 72  s additional wor
1090: 6b 20 74 6f 20 62 65 20 64 6f 6e 65 0a 61 73 20  k to be done.as 
10a0: 65 61 63 68 20 72 6f 77 20 69 73 20 69 6e 73 65  each row is inse
10b0: 72 74 65 64 20 61 6e 64 20 74 68 75 73 20 63 61  rted and thus ca
10c0: 75 73 65 73 20 49 4e 53 45 52 54 73 20 74 6f 20  uses INSERTs to 
10d0: 72 75 6e 20 61 20 6c 69 74 74 6c 65 20 73 6c 6f  run a little slo
10e0: 77 65 72 2e 0a 7d 0a 66 6f 6f 74 65 72 20 24 72  wer..}.footer $r
10f0: 63 73 69 64 0a                                   csid.