Documentation Source Text

Hex Artifact Content
Login

Artifact f99fc1c46f490c7c616067d11bdfc456a763ee446bc21455e582538390a53354:


0000: 3c 74 69 74 6c 65 3e 53 51 4c 69 74 65 20 41 72  <title>SQLite Ar
0010: 63 68 69 76 65 20 46 69 6c 65 73 3c 2f 74 69 74  chive Files</tit
0020: 6c 65 3e 0a 3c 74 63 6c 3e 68 64 5f 6b 65 79 77  le>.<tcl>hd_keyw
0030: 6f 72 64 73 20 7b 53 51 4c 41 52 7d 20 7b 53 51  ords {SQLAR} {SQ
0040: 4c 69 74 65 20 41 72 63 68 69 76 65 7d 20 7b 53  Lite Archive} {S
0050: 51 4c 20 41 72 63 68 69 76 65 7d 20 5c 0a 20 20  QL Archive} \.  
0060: 20 20 20 7b 53 51 4c 69 74 65 20 41 72 63 68 69     {SQLite Archi
0070: 76 65 20 66 6f 72 6d 61 74 7d 20 7b 53 51 4c 69  ve format} {SQLi
0080: 74 65 20 41 72 63 68 69 76 65 20 66 69 6c 65 73  te Archive files
0090: 7d 20 3c 2f 74 63 6c 3e 0a 3c 74 61 62 6c 65 5f  } </tcl>.<table_
00a0: 6f 66 5f 63 6f 6e 74 65 6e 74 73 3e 0a 0a 3c 68  of_contents>..<h
00b0: 31 3e 49 6e 74 72 6f 64 75 63 74 69 6f 6e 3c 2f  1>Introduction</
00c0: 68 31 3e 0a 0a 3c 70 3e 0a 41 6e 20 22 53 51 4c  h1>..<p>.An "SQL
00d0: 69 74 65 20 41 72 63 68 69 76 65 22 20 69 73 20  ite Archive" is 
00e0: 61 20 66 69 6c 65 20 63 6f 6e 74 61 69 6e 65 72  a file container
00f0: 20 73 69 6d 69 6c 61 72 20 74 6f 20 61 20 0a 5b   similar to a .[
0100: 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69 70  https://en.wikip
0110: 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 5a 69  edia.org/wiki/Zi
0120: 70 5f 28 66 69 6c 65 5f 66 6f 72 6d 61 74 29 7c  p_(file_format)|
0130: 5a 49 50 20 61 72 63 68 69 76 65 5d 20 6f 72 0a  ZIP archive] or.
0140: 5b 68 74 74 70 73 3a 2f 2f 65 6e 2e 77 69 6b 69  [https://en.wiki
0150: 70 65 64 69 61 2e 6f 72 67 2f 77 69 6b 69 2f 54  pedia.org/wiki/T
0160: 61 72 5f 28 63 6f 6d 70 75 74 69 6e 67 29 7c 54  ar_(computing)|T
0170: 61 72 62 61 6c 6c 5d 20 62 75 74 0a 62 61 73 65  arball] but.base
0180: 64 20 6f 6e 20 61 6e 20 53 51 4c 69 74 65 20 64  d on an SQLite d
0190: 61 74 61 62 61 73 65 2e 0a 0a 3c 70 3e 0a 41 6e  atabase...<p>.An
01a0: 20 53 51 4c 69 74 65 20 41 72 63 68 69 76 65 20   SQLite Archive 
01b0: 69 73 20 61 6e 20 6f 72 64 69 6e 61 72 79 20 53  is an ordinary S
01c0: 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 20 66  QLite database f
01d0: 69 6c 65 20 74 68 61 74 20 63 6f 6e 74 61 69 6e  ile that contain
01e0: 73 20 74 68 65 0a 66 6f 6c 6c 6f 77 69 6e 67 20  s the.following 
01f0: 74 61 62 6c 65 20 61 73 20 70 61 72 74 20 6f 66  table as part of
0200: 20 69 74 73 20 73 63 68 65 6d 61 3a 0a 0a 3c 63   its schema:..<c
0210: 6f 64 65 62 6c 6f 63 6b 3e 0a 43 52 45 41 54 45  odeblock>.CREATE
0220: 20 54 41 42 4c 45 20 73 71 6c 61 72 28 0a 20 20   TABLE sqlar(.  
0230: 6e 61 6d 65 20 54 45 58 54 20 50 52 49 4d 41 52  name TEXT PRIMAR
0240: 59 20 4b 45 59 2c 20 20 2d 2d 20 6e 61 6d 65 20  Y KEY,  -- name 
0250: 6f 66 20 74 68 65 20 66 69 6c 65 0a 20 20 6d 6f  of the file.  mo
0260: 64 65 20 49 4e 54 2c 20 20 20 20 20 20 20 20 20  de INT,         
0270: 20 20 20 20 20 20 2d 2d 20 61 63 63 65 73 73 20        -- access 
0280: 70 65 72 6d 69 73 73 69 6f 6e 73 0a 20 20 6d 74  permissions.  mt
0290: 69 6d 65 20 49 4e 54 2c 20 20 20 20 20 20 20 20  ime INT,        
02a0: 20 20 20 20 20 20 2d 2d 20 6c 61 73 74 20 6d 6f        -- last mo
02b0: 64 69 66 69 63 61 74 69 6f 6e 20 74 69 6d 65 0a  dification time.
02c0: 20 20 73 7a 20 49 4e 54 2c 20 20 20 20 20 20 20    sz INT,       
02d0: 20 20 20 20 20 20 20 20 20 20 2d 2d 20 6f 72 69            -- ori
02e0: 67 69 6e 61 6c 20 66 69 6c 65 20 73 69 7a 65 0a  ginal file size.
02f0: 20 20 64 61 74 61 20 42 4c 4f 42 20 20 20 20 20    data BLOB     
0300: 20 20 20 20 20 20 20 20 20 20 2d 2d 20 63 6f 6d            -- com
0310: 70 72 65 73 73 65 64 20 63 6f 6e 74 65 6e 74 0a  pressed content.
0320: 29 3b 0a 3c 2f 63 6f 64 65 62 6c 6f 63 6b 3e 0a  );.</codeblock>.
0330: 0a 3c 70 3e 0a 45 61 63 68 20 72 6f 77 20 6f 66  .<p>.Each row of
0340: 20 74 68 65 20 53 51 4c 41 52 20 74 61 62 6c 65   the SQLAR table
0350: 20 68 6f 6c 64 73 20 74 68 65 20 63 6f 6e 74 65   holds the conte
0360: 6e 74 20 6f 66 20 61 20 73 69 6e 67 6c 65 20 66  nt of a single f
0370: 69 6c 65 2e 0a 54 68 65 20 66 69 6c 65 6e 61 6d  ile..The filenam
0380: 65 20 28 74 68 65 20 66 75 6c 6c 20 70 61 74 68  e (the full path
0390: 6e 61 6d 65 20 72 65 6c 61 74 69 76 65 20 74 6f  name relative to
03a0: 20 74 68 65 20 72 6f 6f 74 20 6f 66 20 74 68 65   the root of the
03b0: 20 61 72 63 68 69 76 65 29 0a 69 73 20 69 6e 20   archive).is in 
03c0: 74 68 65 20 22 6e 61 6d 65 22 20 66 69 65 6c 64  the "name" field
03d0: 2e 0a 54 68 65 20 22 6d 6f 64 65 22 20 66 69 65  ..The "mode" fie
03e0: 6c 64 20 69 73 20 61 6e 20 69 6e 74 65 67 65 72  ld is an integer
03f0: 20 77 68 69 63 68 20 69 73 20 74 68 65 20 75 6e   which is the un
0400: 69 78 2d 73 74 79 6c 65 20 61 63 63 65 73 73 20  ix-style access 
0410: 70 65 72 6d 69 73 73 69 6f 6e 73 0a 66 6f 72 20  permissions.for 
0420: 74 68 65 20 66 69 6c 65 2e 20 20 22 6d 74 69 6d  the file.  "mtim
0430: 65 22 20 69 73 20 74 68 65 20 6d 6f 64 69 66 69  e" is the modifi
0440: 63 61 74 69 6f 6e 20 74 69 6d 65 20 6f 66 20 74  cation time of t
0450: 68 65 20 66 69 6c 65 20 69 6e 20 73 65 63 6f 6e  he file in secon
0460: 64 73 0a 73 69 6e 63 65 20 31 39 37 30 2e 20 20  ds.since 1970.  
0470: 22 73 7a 22 20 69 73 20 74 68 65 20 6f 72 69 67  "sz" is the orig
0480: 69 6e 61 6c 20 75 6e 63 6f 6d 70 72 65 73 73 65  inal uncompresse
0490: 64 20 73 69 7a 65 20 6f 66 20 74 68 65 20 66 69  d size of the fi
04a0: 6c 65 2e 0a 54 68 65 20 22 64 61 74 61 22 20 66  le..The "data" f
04b0: 69 65 6c 64 20 63 6f 6e 74 61 69 6e 73 20 74 68  ield contains th
04c0: 65 20 66 69 6c 65 20 63 6f 6e 74 65 6e 74 2e 20  e file content. 
04d0: 20 54 68 65 20 63 6f 6e 74 65 6e 74 20 69 73 20   The content is 
04e0: 75 73 75 61 6c 6c 79 0a 63 6f 6d 70 72 65 73 73  usually.compress
04f0: 65 64 20 75 73 69 6e 67 20 5b 68 74 74 70 3a 2f  ed using [http:/
0500: 2f 7a 6c 69 62 2e 6e 65 74 2f 7c 44 65 66 6c 61  /zlib.net/|Defla
0510: 74 65 5d 2c 20 74 68 6f 75 67 68 20 6e 6f 74 20  te], though not 
0520: 61 6c 77 61 79 73 2e 20 20 49 66 20 74 68 65 0a  always.  If the.
0530: 22 73 7a 22 20 66 69 65 6c 64 20 69 73 20 65 71  "sz" field is eq
0540: 75 61 6c 20 74 6f 20 74 68 65 20 73 69 7a 65 20  ual to the size 
0550: 6f 66 20 74 68 65 20 22 64 61 74 61 22 20 66 69  of the "data" fi
0560: 65 6c 64 2c 20 74 68 65 6e 20 74 68 65 20 63 6f  eld, then the co
0570: 6e 74 65 6e 74 0a 69 73 20 73 74 6f 72 65 64 20  ntent.is stored 
0580: 75 6e 63 6f 6d 70 72 65 73 73 65 64 2e 0a 0a 3c  uncompressed...<
0590: 74 63 6c 3e 68 64 5f 66 72 61 67 6d 65 6e 74 20  tcl>hd_fragment 
05a0: 64 62 61 73 6f 62 6a 20 7b 64 61 74 61 62 61 73  dbasobj {databas
05b0: 65 20 61 73 20 6f 62 6a 65 63 74 7d 20 5c 0a 20  e as object} \. 
05c0: 20 20 20 20 7b 64 61 74 61 62 61 73 65 20 61 73      {database as
05d0: 20 63 6f 6e 74 61 69 6e 65 72 20 6f 62 6a 65 63   container objec
05e0: 74 7d 3c 2f 74 63 6c 3e 0a 3c 68 32 3e 44 61 74  t}</tcl>.<h2>Dat
05f0: 61 62 61 73 65 20 41 73 20 43 6f 6e 74 61 69 6e  abase As Contain
0600: 65 72 20 4f 62 6a 65 63 74 3c 2f 68 32 3e 0a 0a  er Object</h2>..
0610: 3c 70 3e 0a 41 6e 20 53 51 4c 69 74 65 20 41 72  <p>.An SQLite Ar
0620: 63 68 69 76 65 20 69 73 20 6f 6e 65 20 65 78 61  chive is one exa
0630: 6d 70 6c 65 20 6f 66 20 61 20 6d 6f 72 65 20 67  mple of a more g
0640: 65 6e 65 72 61 6c 0a 69 64 65 61 20 74 68 61 74  eneral.idea that
0650: 20 61 6e 20 53 51 4c 69 74 65 20 64 61 74 61 62   an SQLite datab
0660: 61 73 65 20 63 61 6e 20 62 65 68 61 76 65 20 61  ase can behave a
0670: 73 20 61 20 63 6f 6e 74 61 69 6e 65 72 20 6f 62  s a container ob
0680: 6a 65 63 74 20 68 6f 6c 64 69 6e 67 0a 6c 6f 74  ject holding.lot
0690: 73 20 6f 66 20 73 6d 61 6c 6c 65 72 20 64 61 74  s of smaller dat
06a0: 61 20 63 6f 6d 70 6f 6e 65 6e 74 73 2e 0a 0a 3c  a components...<
06b0: 70 3e 0a 57 69 74 68 20 63 6c 69 65 6e 74 2f 73  p>.With client/s
06c0: 65 72 76 65 72 20 64 61 74 61 62 61 73 65 73 20  erver databases 
06d0: 6c 69 6b 65 20 50 6f 73 74 67 72 65 53 51 4c 20  like PostgreSQL 
06e0: 6f 72 20 4f 72 61 63 6c 65 2c 20 75 73 65 72 73  or Oracle, users
06f0: 20 61 6e 64 0a 64 65 76 65 6c 6f 70 65 72 73 20   and.developers 
0700: 74 65 6e 64 20 74 6f 20 74 68 69 6e 6b 20 6f 66  tend to think of
0710: 20 74 68 65 20 64 61 74 61 62 61 73 65 20 61 73   the database as
0720: 20 61 20 73 65 72 76 69 63 65 20 6f 72 20 61 20   a service or a 
0730: 22 6e 6f 64 65 22 2c 20 6e 6f 74 0a 61 73 20 61  "node", not.as a
0740: 6e 20 6f 62 6a 65 63 74 2e 20 20 54 68 69 73 20  n object.  This 
0750: 69 73 20 62 65 63 61 75 73 65 20 74 68 65 20 64  is because the d
0760: 61 74 61 62 61 73 65 20 63 6f 6e 74 65 6e 74 20  atabase content 
0770: 69 73 20 73 70 72 65 61 64 20 6f 75 74 20 61 63  is spread out ac
0780: 72 6f 73 73 0a 6d 75 6c 74 69 70 6c 65 20 66 69  ross.multiple fi
0790: 6c 65 73 20 6f 6e 20 74 68 65 20 73 65 72 76 65  les on the serve
07a0: 72 2c 20 6f 72 20 70 6f 73 73 69 62 6c 79 20 61  r, or possibly a
07b0: 63 72 6f 73 73 20 6d 75 6c 74 69 70 6c 65 20 73  cross multiple s
07c0: 65 72 76 65 72 73 20 69 6e 20 61 0a 73 65 72 76  ervers in a.serv
07d0: 69 63 65 20 63 6c 75 73 74 65 72 2e 20 20 4f 6e  ice cluster.  On
07e0: 65 20 63 61 6e 6e 6f 74 20 70 6f 69 6e 74 20 74  e cannot point t
07f0: 6f 20 61 20 73 69 6e 67 6c 65 20 66 69 6c 65 20  o a single file 
0800: 6f 72 20 65 76 65 6e 20 61 20 73 69 6e 67 6c 65  or even a single
0810: 0a 64 69 72 65 63 74 6f 72 79 20 61 6e 64 20 73  .directory and s
0820: 61 79 20 22 74 68 69 73 20 69 73 20 74 68 65 20  ay "this is the 
0830: 64 61 74 61 62 61 73 65 22 2e 0a 0a 3c 70 3e 0a  database"...<p>.
0840: 53 51 4c 69 74 65 2c 20 69 6e 20 63 6f 6e 74 72  SQLite, in contr
0850: 61 73 74 2c 20 73 74 6f 72 65 73 20 61 6c 6c 20  ast, stores all 
0860: 63 6f 6e 74 65 6e 74 20 69 6e 20 61 20 5b 66 69  content in a [fi
0870: 6c 65 20 66 6f 72 6d 61 74 7c 73 69 6e 67 6c 65  le format|single
0880: 20 66 69 6c 65 20 6f 6e 20 64 69 73 6b 5d 2e 0a   file on disk]..
0890: 54 68 61 74 20 73 69 6e 67 6c 65 20 66 69 6c 65  That single file
08a0: 20 69 73 20 73 6f 6d 65 74 68 69 6e 67 20 79 6f   is something yo
08b0: 75 20 63 61 6e 20 70 6f 69 6e 74 20 74 6f 20 61  u can point to a
08c0: 6e 64 20 73 61 79 0a 22 74 68 69 73 20 69 73 20  nd say."this is 
08d0: 74 68 65 20 64 61 74 61 62 61 73 65 22 2e 20 20  the database".  
08e0: 49 74 20 62 65 68 61 76 65 73 20 61 73 20 61 6e  It behaves as an
08f0: 20 6f 62 6a 65 63 74 2e 0a 41 6e 20 53 51 4c 69   object..An SQLi
0900: 74 65 20 64 61 74 61 62 61 73 65 20 66 69 6c 65  te database file
0910: 20 63 61 6e 20 62 65 20 63 6f 70 69 65 64 2c 20   can be copied, 
0920: 72 65 6e 61 6d 65 64 2c 20 73 65 6e 74 20 61 73  renamed, sent as
0930: 20 61 6e 0a 65 6d 61 69 6c 20 61 74 74 61 63 68   an.email attach
0940: 6d 65 6e 74 2c 20 70 61 73 73 65 64 20 61 73 20  ment, passed as 
0950: 74 68 65 20 61 72 67 75 6d 65 6e 74 20 61 20 50  the argument a P
0960: 4f 53 54 20 48 54 54 50 20 72 65 71 75 65 73 74  OST HTTP request
0970: 2c 0a 6f 72 20 6f 74 68 65 72 77 69 73 65 20 74  ,.or otherwise t
0980: 72 65 61 74 65 64 20 61 73 20 6f 74 68 65 72 20  reated as other 
0990: 64 61 74 61 20 6f 62 6a 65 63 74 20 73 75 63 68  data object such
09a0: 20 61 73 20 61 6e 20 69 6d 61 67 65 2c 0a 64 6f   as an image,.do
09b0: 63 75 6d 65 6e 74 2c 20 6f 72 20 6d 65 64 69 61  cument, or media
09c0: 20 66 69 6c 65 2e 0a 0a 3c 70 3e 0a 53 74 75 64   file...<p>.Stud
09d0: 69 65 73 20 73 68 6f 77 20 74 68 61 74 20 6d 61  ies show that ma
09e0: 6e 79 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20  ny applications 
09f0: 61 6c 72 65 61 64 79 20 75 73 65 0a 53 51 4c 69  already use.SQLi
0a00: 74 65 20 61 73 20 61 20 63 6f 6e 74 61 69 6e 65  te as a containe
0a10: 72 20 6f 62 6a 65 63 74 2e 20 20 46 6f 72 20 65  r object.  For e
0a20: 78 61 6d 70 6c 65 2c 0a 5b 68 74 74 70 73 3a 2f  xample,.[https:/
0a30: 2f 6f 64 69 6e 2e 63 73 65 2e 62 75 66 66 61 6c  /odin.cse.buffal
0a40: 6f 2e 65 64 75 2f 70 61 70 65 72 73 2f 32 30 31  o.edu/papers/201
0a50: 35 2f 54 50 43 54 43 2d 73 71 6c 69 74 65 2d 66  5/TPCTC-sqlite-f
0a60: 69 6e 61 6c 2e 70 64 66 7c 4b 65 6e 6e 65 64 79  inal.pdf|Kennedy
0a70: 5d 0a 28 6e 6f 20 72 65 6c 61 74 69 6f 6e 20 74  ].(no relation t
0a80: 6f 20 74 68 65 20 5b 44 61 6e 20 4b 65 6e 6e 65  o the [Dan Kenne
0a90: 64 79 7c 53 51 4c 69 74 65 20 64 65 76 65 6c 6f  dy|SQLite develo
0aa0: 70 65 72 5d 29 20 72 65 70 6f 72 74 73 20 74 68  per]) reports th
0ab0: 61 74 20 31 34 25 20 6f 66 0a 41 6e 64 72 6f 69  at 14% of.Androi
0ac0: 64 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 6e  d applications n
0ad0: 65 76 65 72 20 77 72 69 74 65 20 74 6f 20 74 68  ever write to th
0ae0: 65 69 72 20 53 51 4c 69 74 65 20 64 61 74 61 62  eir SQLite datab
0af0: 61 73 65 73 2e 20 20 49 74 20 69 73 0a 62 65 6c  ases.  It is.bel
0b00: 69 65 76 65 64 20 74 68 61 74 20 74 68 65 73 65  ieved that these
0b10: 20 61 70 70 6c 69 63 61 74 69 6f 6e 73 20 61 72   applications ar
0b20: 65 20 64 6f 77 6e 6c 6f 61 64 69 6e 67 20 65 6e  e downloading en
0b30: 74 69 72 65 20 64 61 74 61 62 61 73 65 73 0a 66  tire databases.f
0b40: 72 6f 6d 20 74 68 65 20 63 6c 6f 75 64 20 61 6e  rom the cloud an
0b50: 64 20 74 68 65 6e 20 75 73 69 6e 67 20 74 68 65  d then using the
0b60: 20 69 6e 66 6f 72 6d 61 74 69 6f 6e 20 6c 6f 63   information loc
0b70: 61 6c 6c 79 20 61 73 20 6e 65 65 64 65 64 2e 20  ally as needed. 
0b80: 20 49 6e 20 6f 74 68 65 72 0a 77 6f 72 64 73 2c   In other.words,
0b90: 20 74 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e   the application
0ba0: 73 20 61 72 65 20 75 73 69 6e 67 20 53 51 4c 69  s are using SQLi
0bb0: 74 65 20 6e 6f 74 20 73 6f 20 6d 75 63 68 20 61  te not so much a
0bc0: 73 20 61 20 64 61 74 61 62 61 73 65 20 62 75 74  s a database but
0bd0: 20 61 73 0a 61 20 71 75 65 72 79 61 62 6c 65 20   as.a queryable 
0be0: 77 69 72 65 2d 74 72 61 6e 73 66 65 72 20 66 6f  wire-transfer fo
0bf0: 72 6d 61 74 2e 0a 0a 3c 68 32 3e 41 70 70 6c 69  rmat...<h2>Appli
0c00: 63 61 74 69 6f 6e 73 20 55 73 69 6e 67 20 53 51  cations Using SQ
0c10: 4c 69 74 65 20 41 72 63 68 69 76 65 73 3c 2f 68  Lite Archives</h
0c20: 32 3e 0a 0a 3c 70 3e 0a 54 68 65 20 5b 68 74 74  2>..<p>.The [htt
0c30: 70 73 3a 2f 2f 66 6f 73 73 69 6c 2d 73 63 6d 2e  ps://fossil-scm.
0c40: 6f 72 67 2f 7c 46 6f 73 73 69 6c 20 44 69 73 74  org/|Fossil Dist
0c50: 72 69 62 75 74 65 64 20 56 65 72 73 69 6f 6e 20  ributed Version 
0c60: 43 6f 6e 74 72 6f 6c 5d 20 73 79 73 74 65 6d 0a  Control] system.
0c70: 70 72 6f 76 69 64 65 73 20 75 73 65 72 73 20 77  provides users w
0c80: 69 74 68 20 74 68 65 20 6f 70 74 69 6f 6e 20 74  ith the option t
0c90: 6f 20 64 6f 77 6e 6c 6f 61 64 20 63 68 65 63 6b  o download check
0ca0: 2d 69 6e 73 20 61 73 20 65 69 74 68 65 72 20 54  -ins as either T
0cb0: 61 72 62 61 6c 6c 73 2c 0a 5a 49 50 20 41 72 63  arballs,.ZIP Arc
0cc0: 68 69 76 65 73 2c 20 6f 72 20 53 51 4c 69 74 65  hives, or SQLite
0cd0: 20 41 72 63 68 69 76 65 73 2e 0a 3c 68 31 3e 41   Archives..<h1>A
0ce0: 64 76 61 6e 74 61 67 65 73 20 4f 66 20 53 51 4c  dvantages Of SQL
0cf0: 69 74 65 20 41 72 63 68 69 76 65 73 3c 2f 68 31  ite Archives</h1
0d00: 3e 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 0a  >..<ol>.<li><p>.
0d10: 41 6e 20 53 51 4c 69 74 65 20 41 72 63 68 69 76  An SQLite Archiv
0d20: 65 20 69 73 20 66 6c 65 78 69 62 6c 65 2e 0a 5a  e is flexible..Z
0d30: 49 50 20 41 72 63 68 69 76 65 73 20 61 6e 64 20  IP Archives and 
0d40: 54 61 72 62 61 6c 6c 73 20 61 72 65 20 6c 69 6d  Tarballs are lim
0d50: 69 74 65 64 20 74 6f 20 73 74 6f 72 69 6e 67 20  ited to storing 
0d60: 6f 6e 6c 79 20 66 69 6c 65 73 2e 20 20 41 6e 0a  only files.  An.
0d70: 53 51 4c 69 74 65 20 41 72 63 68 69 76 65 20 73  SQLite Archive s
0d80: 74 6f 72 65 73 20 66 69 6c 65 73 20 70 6c 75 73  tores files plus
0d90: 20 77 68 61 74 65 76 65 72 20 6f 74 68 65 72 20   whatever other 
0da0: 74 61 62 75 6c 61 72 0a 61 6e 64 2f 6f 72 20 72  tabular.and/or r
0db0: 65 6c 61 74 69 6f 6e 61 6c 20 64 61 74 61 20 73  elational data s
0dc0: 65 65 6d 73 20 75 73 65 66 75 6c 20 74 6f 20 74  eems useful to t
0dd0: 68 65 20 61 70 70 6c 69 63 61 74 69 6f 6e 2e 0a  he application..
0de0: 0a 3c 6c 69 3e 3c 70 3e 0a 41 6e 20 53 51 4c 69  .<li><p>.An SQLi
0df0: 74 65 20 41 72 63 68 69 76 65 20 69 73 20 74 72  te Archive is tr
0e00: 61 6e 73 61 63 74 69 6f 6e 61 6c 2e 0a 55 70 64  ansactional..Upd
0e10: 61 74 65 73 20 61 72 65 20 61 74 6f 6d 69 63 20  ates are atomic 
0e20: 61 6e 64 20 64 75 72 61 62 6c 65 2c 20 65 76 65  and durable, eve
0e30: 6e 20 69 66 20 74 68 65 72 65 20 61 72 65 20 63  n if there are c
0e40: 72 61 73 68 65 73 0a 6f 72 20 70 6f 77 65 72 20  rashes.or power 
0e50: 6c 6f 73 73 65 73 20 69 6e 20 74 68 65 20 6d 69  losses in the mi
0e60: 64 64 6c 65 20 6f 66 20 74 68 65 20 75 70 64 61  ddle of the upda
0e70: 74 65 2e 0a 52 65 61 64 65 72 73 20 73 65 65 20  te..Readers see 
0e80: 61 20 63 6f 6e 73 69 73 74 65 6e 74 20 61 6e 64  a consistent and
0e90: 20 75 6e 63 68 61 6e 67 69 6e 67 20 76 65 72 73   unchanging vers
0ea0: 69 6f 6e 20 6f 66 20 74 68 65 20 63 6f 6e 74 65  ion of the conte
0eb0: 6e 74 20 65 76 65 6e 0a 69 73 20 73 6f 6d 65 20  nt even.is some 
0ec0: 6f 74 68 65 72 20 70 72 6f 63 65 73 73 20 69 73  other process is
0ed0: 20 73 69 6d 75 6c 74 61 6e 65 6f 75 73 6c 79 20   simultaneously 
0ee0: 75 70 64 61 74 69 6e 67 20 74 68 65 20 61 72 63  updating the arc
0ef0: 68 69 76 65 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 41  hive...<li><p>.A
0f00: 6e 20 53 51 4c 69 74 65 20 41 72 63 68 69 76 65  n SQLite Archive
0f10: 20 63 61 6e 20 62 65 20 75 70 64 61 74 65 64 20   can be updated 
0f20: 69 6e 63 72 65 6d 65 6e 74 61 6c 6c 79 2e 0a 49  incrementally..I
0f30: 6e 64 69 76 69 64 75 61 6c 20 66 69 6c 65 73 20  ndividual files 
0f40: 63 61 6e 20 62 65 20 61 64 64 65 64 20 6f 72 20  can be added or 
0f50: 72 65 6d 6f 76 65 64 20 6f 72 20 72 65 70 6c 61  removed or repla
0f60: 63 65 64 20 77 69 74 68 6f 75 74 20 68 61 76 69  ced without havi
0f70: 6e 67 0a 74 6f 20 72 65 77 72 69 74 65 20 74 68  ng.to rewrite th
0f80: 65 20 65 6e 74 69 72 65 20 61 72 63 68 69 76 65  e entire archive
0f90: 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 41 6e 20 53 51  ...<li><p>.An SQ
0fa0: 4c 69 74 65 20 41 72 63 68 69 76 65 20 63 61 6e  Lite Archive can
0fb0: 20 62 65 20 71 75 65 72 69 65 64 20 75 73 69 6e   be queried usin
0fc0: 67 20 61 20 68 69 67 68 2d 6c 65 76 65 6c 20 71  g a high-level q
0fd0: 75 65 72 79 20 6c 61 6e 67 75 61 67 65 20 28 53  uery language (S
0fe0: 51 4c 29 2e 0a 53 6f 6d 65 20 65 78 61 6d 70 6c  QL)..Some exampl
0ff0: 65 73 3a 0a 3c 75 6c 3e 0a 3c 6c 69 3e 20 57 68  es:.<ul>.<li> Wh
1000: 61 74 20 69 73 20 74 68 65 20 74 6f 74 61 6c 20  at is the total 
1010: 73 69 7a 65 20 6f 66 20 61 6c 6c 20 66 69 6c 65  size of all file
1020: 73 20 69 6e 20 74 68 65 20 61 72 63 68 69 76 65  s in the archive
1030: 20 77 68 6f 73 65 20 6e 61 6d 65 73 0a 20 20 20   whose names.   
1040: 20 20 65 6e 64 20 69 6e 20 22 2e 68 22 20 6f 72    end in ".h" or
1050: 20 22 2e 63 70 70 22 3f 0a 3c 6c 69 3e 20 57 68   ".cpp"?.<li> Wh
1060: 61 74 20 70 65 72 63 65 6e 74 61 67 65 20 6f 66  at percentage of
1070: 20 74 68 65 20 66 69 6c 65 73 20 61 72 65 20 63   the files are c
1080: 6f 6d 70 72 65 73 73 65 64 20 62 79 20 6c 65 73  ompressed by les
1090: 73 20 74 68 61 6e 20 32 35 25 3f 0a 3c 6c 69 3e  s than 25%?.<li>
10a0: 20 48 6f 77 20 6d 61 6e 79 20 65 78 65 63 75 74   How many execut
10b0: 61 62 6c 65 20 66 69 6c 65 73 20 61 72 65 20 69  able files are i
10c0: 6e 20 74 68 65 20 61 72 63 68 69 76 65 3f 0a 3c  n the archive?.<
10d0: 2f 75 6c 3e 0a 51 75 65 73 74 69 6f 6e 73 20 6c  /ul>.Questions l
10e0: 69 6b 65 20 74 68 65 73 65 20 28 61 6e 64 20 63  ike these (and c
10f0: 6f 75 6e 74 6c 65 73 73 20 6f 74 68 65 72 73 29  ountless others)
1100: 20 63 61 6e 20 62 65 20 61 6e 73 77 65 72 65 64   can be answered
1110: 20 77 69 74 68 6f 75 74 0a 68 61 76 69 6e 67 20   without.having 
1120: 74 6f 20 75 6e 63 6f 6d 70 72 65 73 73 20 6f 72  to uncompress or
1130: 20 65 78 74 72 61 63 74 20 61 6e 79 20 63 6f 6e   extract any con
1140: 74 65 6e 74 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 41  tent...<li><p>.A
1150: 70 70 6c 69 63 61 74 69 6f 6e 73 20 74 68 61 74  pplications that
1160: 20 61 6c 72 65 61 64 79 20 75 73 65 20 53 51 4c   already use SQL
1170: 69 74 65 20 66 6f 72 20 6f 74 68 65 72 20 70 75  ite for other pu
1180: 72 70 6f 73 65 73 20 63 61 6e 20 65 61 73 69 6c  rposes can easil
1190: 79 0a 61 64 64 20 73 75 70 70 6f 72 74 20 66 6f  y.add support fo
11a0: 72 20 53 51 4c 69 74 65 20 41 72 63 68 69 76 65  r SQLite Archive
11b0: 73 20 75 73 69 6e 67 20 61 20 73 6d 61 6c 6c 20  s using a small 
11c0: 65 78 74 65 6e 73 69 6f 6e 0a 28 5b 68 74 74 70  extension.([http
11d0: 73 3a 2f 2f 73 71 6c 69 74 65 2e 6f 72 67 2f 73  s://sqlite.org/s
11e0: 72 63 2f 66 69 6c 65 2f 65 78 74 2f 6d 69 73 63  rc/file/ext/misc
11f0: 2f 73 71 6c 61 72 2e 63 5d 29 20 74 6f 20 68 61  /sqlar.c]) to ha
1200: 6e 64 6c 65 20 74 68 65 20 63 6f 6d 70 72 65 73  ndle the compres
1210: 73 69 6f 6e 0a 61 6e 64 20 64 65 63 6f 6d 70 72  sion.and decompr
1220: 65 73 73 69 6f 6e 20 6f 66 20 63 6f 6e 74 65 6e  ession of conten
1230: 74 2e 20 20 45 76 65 6e 20 74 68 69 73 20 74 69  t.  Even this ti
1240: 6e 79 20 65 78 74 65 6e 73 69 6f 6e 20 63 61 6e  ny extension can
1250: 20 62 65 20 6f 6d 69 74 74 65 64 0a 69 66 20 74   be omitted.if t
1260: 68 65 20 66 69 6c 65 73 20 69 6e 20 74 68 65 20  he files in the 
1270: 61 72 63 68 69 76 65 20 61 72 65 20 75 6e 63 6f  archive are unco
1280: 6d 70 72 65 73 73 65 64 2e 20 20 49 6e 20 63 6f  mpressed.  In co
1290: 6e 74 72 61 73 74 2c 20 73 75 70 70 6f 72 74 69  ntrast, supporti
12a0: 6e 67 0a 5a 49 50 20 41 72 63 68 69 76 65 73 20  ng.ZIP Archives 
12b0: 61 6e 64 2f 6f 72 20 54 61 72 62 61 6c 6c 73 20  and/or Tarballs 
12c0: 72 65 71 75 69 72 65 73 20 65 69 74 68 65 72 20  requires either 
12d0: 73 65 70 61 72 61 74 65 20 6c 69 62 72 61 72 69  separate librari
12e0: 65 73 20 6f 72 0a 6c 6f 74 73 20 6f 66 20 65 78  es or.lots of ex
12f0: 74 72 61 20 63 75 73 74 6f 6d 20 63 6f 64 65 2c  tra custom code,
1300: 20 6f 72 20 73 6f 6d 65 74 69 6d 65 73 20 62 6f   or sometimes bo
1310: 74 68 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 41 6e 20  th...<li><p>.An 
1320: 53 51 4c 69 74 65 20 41 72 63 68 69 76 65 20 63  SQLite Archive c
1330: 61 6e 20 77 6f 72 6b 20 61 72 6f 75 6e 64 20 66  an work around f
1340: 69 72 65 77 61 6c 6c 2d 69 6d 70 6f 73 65 64 20  irewall-imposed 
1350: 63 65 6e 73 6f 72 73 68 69 70 2e 0a 46 6f 72 20  censorship..For 
1360: 65 78 61 6d 70 6c 65 2c 20 63 65 72 74 61 69 6e  example, certain
1370: 20 66 69 6c 65 20 74 79 70 65 73 20 74 68 61 74   file types that
1380: 20 61 72 65 20 63 6f 6e 73 69 64 65 72 65 64 20   are considered 
1390: 22 64 61 6e 67 65 72 6f 75 73 22 20 0a 28 65 78  "dangerous" .(ex
13a0: 61 6d 70 6c 65 73 3a 20 44 4c 4c 73 29 20 77 69  amples: DLLs) wi
13b0: 6c 6c 20 62 65 0a 5b 68 74 74 70 73 3a 2f 2f 73  ll be.[https://s
13c0: 75 70 70 6f 72 74 2e 67 6f 6f 67 6c 65 2e 63 6f  upport.google.co
13d0: 6d 2f 6d 61 69 6c 2f 61 6e 73 77 65 72 2f 36 35  m/mail/answer/65
13e0: 39 30 7c 62 6c 6f 63 6b 65 64 20 62 79 20 47 6d  90|blocked by Gm
13f0: 61 69 6c 5d 0a 61 6e 64 20 70 72 6f 62 61 62 6c  ail].and probabl
1400: 79 20 6d 61 6e 79 20 6f 74 68 65 72 20 65 6d 61  y many other ema
1410: 69 6c 20 73 65 72 76 69 63 65 73 20 61 6e 64 20  il services and 
1420: 66 69 72 65 77 61 6c 6c 2c 20 65 76 65 6e 20 69  firewall, even i
1430: 66 20 74 68 6f 73 65 0a 66 69 6c 65 73 20 61 72  f those.files ar
1440: 65 20 77 72 61 70 70 65 64 20 69 6e 73 69 64 65  e wrapped inside
1450: 20 61 20 5a 49 50 20 41 72 63 68 69 76 65 20 6f   a ZIP Archive o
1460: 72 20 54 61 72 62 61 6c 6c 2e 0a 42 75 74 20 74  r Tarball..But t
1470: 68 65 73 65 20 66 69 72 65 77 61 6c 6c 20 75 73  hese firewall us
1480: 75 61 6c 6c 79 20 64 6f 20 6e 6f 74 20 63 61 72  ually do not car
1490: 65 20 61 62 6f 75 74 20 53 51 4c 69 74 65 20 41  e about SQLite A
14a0: 72 63 68 69 76 65 73 20 61 6e 64 0a 73 6f 20 63  rchives and.so c
14b0: 6f 6e 74 65 6e 74 20 63 61 6e 20 62 65 20 70 75  ontent can be pu
14c0: 74 20 69 6e 73 69 64 65 20 61 6e 20 53 51 4c 69  t inside an SQLi
14d0: 74 65 20 41 72 63 68 69 76 65 20 74 6f 20 65 76  te Archive to ev
14e0: 61 64 65 20 63 65 6e 73 6f 72 73 68 69 70 2e 0a  ade censorship..
14f0: 3c 2f 6f 6c 3e 0a 0a 3c 68 31 3e 44 69 73 61 64  </ol>..<h1>Disad
1500: 76 61 6e 74 61 67 65 73 20 4f 66 20 53 51 4c 69  vantages Of SQLi
1510: 74 65 20 41 72 63 68 69 76 65 73 3c 2f 68 31 3e  te Archives</h1>
1520: 0a 0a 3c 6f 6c 3e 0a 3c 6c 69 3e 3c 70 3e 0a 54  ..<ol>.<li><p>.T
1530: 68 65 20 53 51 4c 69 74 65 20 41 72 63 68 69 76  he SQLite Archiv
1540: 65 20 69 73 20 61 20 72 65 6c 61 74 69 76 65 6c  e is a relativel
1550: 79 20 6e 65 77 20 66 6f 72 6d 61 74 2e 20 20 49  y new format.  I
1560: 74 20 77 61 73 20 66 69 72 73 74 20 64 65 73 63  t was first desc
1570: 72 69 62 65 64 20 69 6e 0a 69 6e 20 32 30 31 34  ribed in.in 2014
1580: 2e 20 20 5a 49 50 20 41 72 63 68 69 76 65 73 20  .  ZIP Archives 
1590: 61 6e 64 20 54 61 72 62 61 6c 6c 73 2c 20 6f 6e  and Tarballs, on
15a0: 20 74 68 65 20 6f 74 68 65 72 20 68 61 6e 64 2c   the other hand,
15b0: 20 68 61 76 65 20 62 65 65 6e 20 61 72 6f 75 6e   have been aroun
15c0: 64 0a 66 6f 72 20 64 65 63 61 64 65 73 20 61 6e  d.for decades an
15d0: 64 20 61 72 65 20 77 65 6c 6c 2d 65 6e 74 72 65  d are well-entre
15e0: 6e 63 68 65 64 20 61 73 20 73 74 61 6e 64 61 72  nched as standar
15f0: 64 20 66 6f 72 6d 61 74 73 2e 20 20 4d 6f 73 74  d formats.  Most
1600: 20 70 72 6f 67 72 61 6d 6d 65 72 73 0a 6b 6e 6f   programmers.kno
1610: 77 20 77 68 61 74 20 61 20 5a 49 50 20 41 72 63  w what a ZIP Arc
1620: 68 69 76 65 20 6f 72 20 54 61 72 62 61 6c 6c 20  hive or Tarball 
1630: 69 73 2c 20 62 75 74 20 69 66 20 79 6f 75 20 73  is, but if you s
1640: 61 79 20 22 53 51 4c 69 74 65 20 41 72 63 68 69  ay "SQLite Archi
1650: 76 65 22 20 79 6f 75 0a 61 72 65 20 6d 6f 72 65  ve" you.are more
1660: 20 6c 69 6b 65 6c 79 20 74 6f 20 67 65 74 20 61   likely to get a
1670: 20 72 65 70 6c 79 20 6f 66 20 22 57 68 61 74 3f   reply of "What?
1680: 22 20 20 54 6f 6f 6c 69 6e 67 20 74 6f 20 70 72  "  Tooling to pr
1690: 6f 63 65 73 73 20 5a 49 50 20 41 72 63 68 69 76  ocess ZIP Archiv
16a0: 65 73 0a 61 6e 64 20 54 61 72 62 61 6c 6c 73 20  es.and Tarballs 
16b0: 69 73 20 6d 6f 72 65 20 6c 69 6b 65 6c 79 20 74  is more likely t
16c0: 6f 20 62 65 20 69 6e 73 74 61 6c 6c 65 64 20 6f  o be installed o
16d0: 6e 20 73 74 6f 63 6b 20 63 6f 6d 70 75 74 65 72  n stock computer
16e0: 73 2e 0a 0a 3c 6c 69 3e 3c 70 3e 0a 53 69 6e 63  s...<li><p>.Sinc
16f0: 65 20 61 6e 20 53 51 4c 69 74 65 20 64 61 74 61  e an SQLite data
1700: 62 61 73 65 20 69 73 20 61 20 6d 6f 72 65 20 67  base is a more g
1710: 65 6e 65 72 61 6c 20 66 6f 72 6d 61 74 20 28 69  eneral format (i
1720: 74 20 69 73 20 64 65 73 69 67 6e 65 64 20 74 6f  t is designed to
1730: 20 64 6f 0a 6d 75 63 68 20 6d 6f 72 65 20 74 68   do.much more th
1740: 61 6e 20 73 69 6d 70 6c 79 20 73 74 6f 72 65 20  an simply store 
1750: 61 20 62 75 6e 63 68 20 6f 66 20 66 69 6c 65 73  a bunch of files
1760: 29 20 69 74 20 69 73 20 6e 6f 74 20 61 73 20 63  ) it is not as c
1770: 6f 6d 70 61 63 74 20 61 73 20 65 69 74 68 65 72  ompact as either
1780: 0a 74 68 65 20 5a 49 50 20 41 72 63 68 69 76 65  .the ZIP Archive
1790: 20 6f 72 20 54 61 72 62 61 6c 6c 20 66 6f 72 6d   or Tarball form
17a0: 61 74 73 2e 20 20 41 6e 20 53 51 4c 69 74 65 20  ats.  An SQLite 
17b0: 41 72 63 68 69 76 65 20 69 73 20 75 73 75 61 6c  Archive is usual
17c0: 6c 79 20 61 62 6f 75 74 20 31 25 0a 6c 61 72 67  ly about 1%.larg
17d0: 65 72 20 74 68 61 6e 20 74 68 65 20 65 71 75 69  er than the equi
17e0: 76 61 6c 65 6e 74 20 5a 49 50 20 41 72 63 68 69  valent ZIP Archi
17f0: 76 65 2e 20 20 54 61 72 62 61 6c 6c 73 20 61 72  ve.  Tarballs ar
1800: 65 20 63 6f 6d 70 72 65 73 73 65 64 20 61 73 20  e compressed as 
1810: 61 20 73 69 6e 67 6c 65 0a 75 6e 69 74 20 72 61  a single.unit ra
1820: 74 68 65 72 20 74 68 61 6e 20 63 6f 6d 70 72 65  ther than compre
1830: 73 73 69 6e 67 20 65 61 63 68 20 66 69 6c 65 20  ssing each file 
1840: 73 65 70 61 72 61 74 65 6c 79 20 61 73 20 69 73  separately as is
1850: 20 64 6f 6e 65 20 62 79 20 62 6f 74 68 0a 53 51   done by both.SQ
1860: 4c 69 74 65 20 61 6e 64 20 5a 49 50 20 41 72 63  Lite and ZIP Arc
1870: 68 69 76 65 73 2e 20 20 46 6f 72 20 74 68 65 73  hives.  For thes
1880: 65 20 72 65 61 73 6f 6e 2c 20 54 61 72 62 61 6c  e reason, Tarbal
1890: 6c 73 20 74 65 6e 64 20 74 6f 20 62 65 20 73 6d  ls tend to be sm
18a0: 61 6c 6c 65 72 0a 74 68 61 6e 20 65 69 74 68 65  aller.than eithe
18b0: 72 20 5a 49 50 20 6f 72 20 53 51 4c 69 74 65 20  r ZIP or SQLite 
18c0: 41 72 63 68 69 76 65 73 2e 0a 3c 70 3e 0a 41 73  Archives..<p>.As
18d0: 20 61 6e 20 65 78 61 6d 70 6c 65 2c 20 74 68 65   an example, the
18e0: 20 66 6f 6c 6c 6f 77 69 6e 67 20 74 61 62 6c 65   following table
18f0: 20 73 68 6f 77 20 74 68 65 20 72 65 6c 61 74 69   show the relati
1900: 76 65 20 73 69 7a 65 73 20 66 6f 72 20 61 6e 0a  ve sizes for an.
1910: 53 51 4c 69 74 65 20 41 72 63 68 69 76 65 2c 20  SQLite Archive, 
1920: 61 20 5a 49 50 20 41 72 63 68 69 76 65 2c 20 61  a ZIP Archive, a
1930: 6e 64 20 61 20 54 61 72 62 61 6c 6c 20 6f 66 20  nd a Tarball of 
1940: 74 68 65 20 31 2c 37 34 33 20 66 69 6c 65 73 0a  the 1,743 files.
1950: 69 6e 20 74 68 65 20 53 51 4c 69 74 65 20 33 2e  in the SQLite 3.
1960: 32 32 2e 30 20 73 6f 75 72 63 65 20 74 72 65 65  22.0 source tree
1970: 3a 0a 3c 74 61 62 6c 65 20 73 74 72 69 70 65 64  :.<table striped
1980: 3d 31 3e 0a 20 20 3c 74 72 3e 3c 74 64 3e 53 51  =1>.  <tr><td>SQ
1990: 4c 69 74 65 20 41 72 63 68 69 76 65 3c 74 64 3e  Lite Archive<td>
19a0: 31 30 2c 37 35 34 2c 30 34 38 0a 20 20 3c 74 72  10,754,048.  <tr
19b0: 3e 3c 74 64 3e 5a 49 50 20 41 72 63 68 69 76 65  ><td>ZIP Archive
19c0: 20 28 75 73 69 6e 67 20 49 6e 66 6f 2d 5a 49 50   (using Info-ZIP
19d0: 20 33 2e 30 29 3c 74 64 3e 31 30 2c 36 36 32 2c   3.0)<td>10,662,
19e0: 33 36 35 0a 20 20 3c 74 72 3e 3c 74 64 3e 5a 49  365.  <tr><td>ZI
19f0: 50 20 41 72 63 68 69 76 65 20 28 75 73 69 6e 67  P Archive (using
1a00: 20 5b 7a 69 70 66 69 6c 65 5d 29 3c 74 64 3e 31   [zipfile])<td>1
1a10: 30 2c 33 39 30 2c 32 31 35 0a 20 20 3c 74 72 3e  0,390,215.  <tr>
1a20: 3c 74 64 3e 54 61 72 62 61 6c 6c 3c 74 64 3e 26  <td>Tarball<td>&
1a30: 23 78 32 30 30 37 3b 39 2c 37 38 31 2c 31 30 39  #x2007;9,781,109
1a40: 0a 3c 2f 74 61 62 6c 65 3e 0a 0a 3c 6c 69 3e 3c  .</table>..<li><
1a50: 70 3e 0a 41 6e 20 53 51 4c 69 74 65 20 41 72 63  p>.An SQLite Arc
1a60: 68 69 76 65 20 73 75 70 70 6f 72 74 73 20 6f 6e  hive supports on
1a70: 6c 79 20 74 68 65 20 5b 68 74 74 70 73 3a 2f 2f  ly the [https://
1a80: 7a 6c 69 62 2e 6e 65 74 2f 7c 44 65 66 6c 61 74  zlib.net/|Deflat
1a90: 65 5d 20 63 6f 6d 70 72 65 73 73 69 6f 6e 0a 6d  e] compression.m
1aa0: 65 74 68 6f 64 2e 20 20 54 61 72 62 61 6c 6c 73  ethod.  Tarballs
1ab0: 20 61 6e 64 20 5a 49 50 20 41 72 63 68 69 76 65   and ZIP Archive
1ac0: 20 73 75 70 70 6f 72 74 20 61 20 77 69 64 65 72   support a wider
1ad0: 20 61 73 73 6f 72 74 6d 65 6e 74 20 6f 66 0a 63   assortment of.c
1ae0: 6f 6d 70 72 65 73 73 69 6f 6e 20 6d 65 74 68 6f  ompression metho
1af0: 64 73 2e 0a 3c 2f 6f 6c 3e 0a 0a 3c 74 63 6c 3e  ds..</ol>..<tcl>
1b00: 68 64 5f 66 72 61 67 6d 65 6e 74 20 63 6c 74 6f  hd_fragment clto
1b10: 6f 6c 73 20 7b 6d 61 6e 61 67 69 6e 67 20 53 51  ols {managing SQ
1b20: 4c 69 74 65 20 41 72 63 68 69 76 65 73 20 66 72  Lite Archives fr
1b30: 6f 6d 20 74 68 65 20 63 6f 6d 6d 61 6e 64 2d 6c  om the command-l
1b40: 69 6e 65 7d 3c 2f 74 63 6c 3e 0a 3c 68 31 3e 4d  ine}</tcl>.<h1>M
1b50: 61 6e 61 67 69 6e 67 20 41 6e 20 53 51 4c 69 74  anaging An SQLit
1b60: 65 20 41 72 63 68 69 76 65 20 46 72 6f 6d 20 54  e Archive From T
1b70: 68 65 20 43 6f 6d 6d 61 6e 64 2d 4c 69 6e 65 3c  he Command-Line<
1b80: 2f 68 31 3e 0a 0a 3c 70 3e 0a 54 68 65 20 72 65  /h1>..<p>.The re
1b90: 63 6f 6d 6d 65 6e 64 65 64 20 77 61 79 20 6f 66  commended way of
1ba0: 20 63 72 65 61 74 69 6e 67 2c 20 75 70 64 61 74   creating, updat
1bb0: 69 6e 67 2c 20 6c 69 73 74 69 6e 67 2c 20 61 6e  ing, listing, an
1bc0: 64 20 65 78 74 72 61 63 74 69 6e 67 0a 61 6e 20  d extracting.an 
1bd0: 53 51 4c 69 74 65 20 41 72 63 68 69 76 65 20 69  SQLite Archive i
1be0: 73 20 74 6f 20 75 73 65 20 74 68 65 20 5b 73 71  s to use the [sq
1bf0: 6c 69 74 65 33 2e 65 78 65 20 63 6f 6d 6d 61 6e  lite3.exe comman
1c00: 64 2d 6c 69 6e 65 20 73 68 65 6c 6c 5d 20 0a 66  d-line shell] .f
1c10: 6f 72 20 53 51 4c 69 74 65 20 5b 76 65 72 73 69  or SQLite [versi
1c20: 6f 6e 20 33 2e 32 33 2e 30 5d 20 28 5b 64 61 74  on 3.23.0] ([dat
1c30: 65 6f 66 3a 33 2e 32 33 2e 30 5d 29 20 6f 72 20  eof:3.23.0]) or 
1c40: 6c 61 74 65 72 2e 20 20 54 68 69 73 20 43 4c 49  later.  This CLI
1c50: 0a 73 75 70 70 6f 72 74 73 20 74 68 65 20 2d 41  .supports the -A
1c60: 20 63 6f 6d 6d 61 6e 64 2d 6c 69 6e 65 20 6f 70   command-line op
1c70: 74 69 6f 6e 20 74 68 61 74 20 61 6c 6c 6f 77 73  tion that allows
1c80: 20 65 61 73 79 20 6d 61 6e 61 67 65 6d 65 6e 74   easy management
1c90: 0a 6f 66 20 53 51 4c 69 74 65 20 41 72 63 68 69  .of SQLite Archi
1ca0: 76 65 73 2e 0a 54 68 65 20 43 4c 49 20 66 6f 72  ves..The CLI for
1cb0: 20 53 51 4c 69 74 65 20 5b 76 65 72 73 69 6f 6e   SQLite [version
1cc0: 20 33 2e 32 32 2e 30 5d 20 28 5b 64 61 74 65 6f   3.22.0] ([dateo
1cd0: 66 3a 33 2e 32 32 2e 30 5d 29 20 68 61 73 20 74  f:3.22.0]) has t
1ce0: 68 65 0a 5b 2e 61 72 63 68 69 76 65 20 63 6f 6d  he.[.archive com
1cf0: 6d 61 6e 64 5d 20 66 6f 72 20 6d 61 6e 61 67 69  mand] for managi
1d00: 6e 67 20 53 51 4c 69 74 65 20 41 72 63 68 69 76  ng SQLite Archiv
1d10: 65 73 2c 20 62 75 74 20 74 68 61 74 20 72 65 71  es, but that req
1d20: 75 69 72 65 73 0a 69 6e 74 65 72 61 63 74 69 6e  uires.interactin
1d30: 67 20 77 69 74 68 20 74 68 65 20 73 68 65 6c 6c  g with the shell
1d40: 2e 0a 0a 3c 70 3e 0a 54 6f 20 6c 69 73 74 20 61  ...<p>.To list a
1d50: 6c 6c 20 6f 66 20 74 68 65 20 66 69 6c 65 73 20  ll of the files 
1d60: 69 6e 20 61 6e 20 53 51 4c 69 74 65 20 41 72 63  in an SQLite Arc
1d70: 68 69 76 65 20 6e 61 6d 65 64 20 22 65 78 61 6d  hive named "exam
1d80: 70 6c 65 2e 73 71 6c 61 72 22 0a 75 73 69 6e 67  ple.sqlar".using
1d90: 20 6f 6e 65 20 6f 66 20 74 68 65 73 65 20 63 6f   one of these co
1da0: 6d 6d 61 6e 64 73 3a 0a 0a 3c 63 6f 64 65 62 6c  mmands:..<codebl
1db0: 6f 63 6b 3e 0a 73 71 6c 69 74 65 33 20 65 78 61  ock>.sqlite3 exa
1dc0: 6d 70 6c 65 2e 73 71 6c 61 72 20 2d 41 74 0a 73  mple.sqlar -At.s
1dd0: 71 6c 69 74 65 33 20 65 78 61 6d 70 6c 65 2e 73  qlite3 example.s
1de0: 71 6c 61 72 20 2d 41 74 76 0a 3c 2f 63 6f 64 65  qlar -Atv.</code
1df0: 62 6c 6f 63 6b 3e 0a 0a 3c 70 3e 0a 54 6f 20 65  block>..<p>.To e
1e00: 78 74 72 61 63 74 20 61 6c 6c 20 66 69 6c 65 73  xtract all files
1e10: 20 66 72 6f 6d 20 61 6e 20 53 51 4c 69 74 65 20   from an SQLite 
1e20: 41 72 63 68 69 76 65 20 6e 61 6d 65 64 20 22 65  Archive named "e
1e30: 78 61 6d 70 6c 65 2e 73 71 6c 61 72 22 3a 0a 0a  xample.sqlar":..
1e40: 3c 63 6f 64 65 62 6c 6f 63 6b 3e 0a 73 71 6c 69  <codeblock>.sqli
1e50: 74 65 33 20 65 78 61 6d 70 6c 65 2e 73 71 6c 61  te3 example.sqla
1e60: 72 20 2d 41 78 0a 3c 2f 63 6f 64 65 62 6c 6f 63  r -Ax.</codebloc
1e70: 6b 3e 0a 0a 3c 70 3e 0a 54 6f 20 63 72 65 61 74  k>..<p>.To creat
1e80: 65 20 61 20 6e 65 77 20 53 51 4c 69 74 65 20 41  e a new SQLite A
1e90: 72 63 68 69 76 65 20 6e 61 6d 65 64 20 22 61 6c  rchive named "al
1ea0: 6c 74 78 74 2e 73 71 6c 61 72 22 20 63 6f 6e 74  ltxt.sqlar" cont
1eb0: 61 69 6e 69 6e 67 20 61 6c 6c 20 2a 2e 74 78 74  aining all *.txt
1ec0: 0a 66 69 6c 65 73 20 69 6e 20 74 68 65 20 63 75  .files in the cu
1ed0: 72 72 65 6e 74 20 64 69 72 65 63 74 6f 72 79 3a  rrent directory:
1ee0: 0a 0a 3c 63 6f 64 65 62 6c 6f 63 6b 3e 0a 73 71  ..<codeblock>.sq
1ef0: 6c 69 74 65 33 20 61 6c 6c 74 78 74 2e 73 71 6c  lite3 alltxt.sql
1f00: 61 72 20 2d 41 63 20 2a 2e 74 78 74 0a 3c 2f 63  ar -Ac *.txt.</c
1f10: 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c 70 3e 0a 54  odeblock>..<p>.T
1f20: 6f 20 61 64 64 20 6f 72 20 75 70 64 61 74 65 20  o add or update 
1f30: 66 69 6c 65 73 20 69 6e 20 61 6e 20 65 78 69 73  files in an exis
1f40: 74 69 6e 67 20 53 51 4c 69 74 65 20 41 72 63 68  ting SQLite Arch
1f50: 69 76 65 3a 0a 0a 3c 63 6f 64 65 62 6c 6f 63 6b  ive:..<codeblock
1f60: 3e 0a 73 71 6c 69 74 65 33 20 65 78 61 6d 70 6c  >.sqlite3 exampl
1f70: 65 2e 73 71 6c 61 72 20 2d 41 75 20 2a 2e 6d 64  e.sqlar -Au *.md
1f80: 0a 3c 2f 63 6f 64 65 62 6c 6f 63 6b 3e 0a 0a 3c  .</codeblock>..<
1f90: 70 3e 0a 46 6f 72 20 75 73 61 67 65 20 68 69 6e  p>.For usage hin
1fa0: 74 73 20 61 6e 64 20 61 20 73 75 6d 6d 61 72 79  ts and a summary
1fb0: 20 6f 66 20 61 6c 6c 20 6f 70 74 69 6f 6e 73 2c   of all options,
1fc0: 20 73 69 6d 70 6c 79 20 67 69 76 65 20 74 68 65   simply give the
1fd0: 20 5b 43 4c 49 5d 0a 74 68 65 20 2d 41 20 6f 70   [CLI].the -A op
1fe0: 74 69 6f 6e 20 77 69 74 68 20 6e 6f 20 61 64 64  tion with no add
1ff0: 69 74 69 6f 6e 61 6c 20 61 72 67 75 6d 65 6e 74  itional argument
2000: 73 3a 0a 0a 3c 63 6f 64 65 62 6c 6f 63 6b 3e 0a  s:..<codeblock>.
2010: 73 71 6c 69 74 65 33 20 2d 41 0a 3c 2f 63 6f 64  sqlite3 -A.</cod
2020: 65 62 6c 6f 63 6b 3e 0a 0a 3c 70 3e 0a 41 6c 6c  eblock>..<p>.All
2030: 20 6f 66 20 74 68 65 73 65 20 63 6f 6d 6d 61 6e   of these comman
2040: 64 73 20 77 6f 72 6b 20 74 68 65 20 73 61 6d 65  ds work the same
2050: 20 77 61 79 20 69 66 20 74 68 65 20 66 69 6c 65   way if the file
2060: 6e 61 6d 65 20 61 72 67 75 6d 65 6e 74 20 69 73  name argument is
2070: 0a 69 73 20 61 20 5a 49 50 20 41 72 63 68 69 76  .is a ZIP Archiv
2080: 65 20 69 6e 73 74 65 61 64 20 6f 66 20 61 6e 20  e instead of an 
2090: 53 51 4c 69 74 65 20 64 61 74 61 62 61 73 65 2e  SQLite database.
20a0: 0a 0a 3c 68 32 3e 4f 74 68 65 72 20 63 6f 6d 6d  ..<h2>Other comm
20b0: 61 6e 64 2d 6c 69 6e 65 20 74 6f 6f 6c 73 3c 2f  and-line tools</
20c0: 68 32 3e 0a 0a 3c 70 3e 0a 4a 75 73 74 20 61 73  h2>..<p>.Just as
20d0: 20 74 68 65 72 65 20 69 73 20 74 68 65 20 22 7a   there is the "z
20e0: 69 70 22 20 70 72 6f 67 72 61 6d 20 74 6f 20 6d  ip" program to m
20f0: 61 6e 61 67 65 20 5a 49 50 20 41 72 63 68 69 76  anage ZIP Archiv
2100: 65 73 2c 20 61 6e 64 20 74 68 65 0a 22 74 61 72  es, and the."tar
2110: 22 20 70 72 6f 67 72 61 6d 20 74 6f 20 6d 61 6e  " program to man
2120: 61 67 65 20 54 61 72 62 61 6c 6c 73 2c 20 74 68  age Tarballs, th
2130: 65 20 0a 5b 68 74 74 70 73 3a 2f 2f 73 71 6c 69  e .[https://sqli
2140: 74 65 2e 6f 72 67 2f 73 71 6c 61 72 7c 22 73 71  te.org/sqlar|"sq
2150: 6c 61 72 22 20 70 72 6f 67 72 61 6d 5d 20 65 78  lar" program] ex
2160: 69 73 74 73 20 74 6f 20 6d 61 6e 61 67 65 20 53  ists to manage S
2170: 51 4c 20 41 72 63 68 69 76 65 73 2e 0a 54 68 65  QL Archives..The
2180: 20 22 73 71 6c 61 72 22 20 70 72 6f 67 72 61 6d   "sqlar" program
2190: 20 69 73 20 61 62 6c 65 20 74 6f 20 63 72 65 61   is able to crea
21a0: 74 65 20 61 20 6e 65 77 20 53 51 4c 69 74 65 20  te a new SQLite 
21b0: 41 72 63 68 69 76 65 2c 20 6c 69 73 74 20 74 68  Archive, list th
21c0: 65 0a 63 6f 6e 74 65 6e 74 20 6f 66 20 61 6e 20  e.content of an 
21d0: 65 78 69 73 74 69 6e 67 20 61 72 63 68 69 76 65  existing archive
21e0: 2c 20 61 64 64 20 6f 72 20 72 65 6d 6f 76 65 20  , add or remove 
21f0: 66 69 6c 65 73 20 66 72 6f 6d 20 74 68 65 20 61  files from the a
2200: 72 63 68 69 76 65 2c 0a 61 6e 64 2f 6f 72 20 65  rchive,.and/or e
2210: 78 74 72 61 63 74 20 66 69 6c 65 73 20 66 72 6f  xtract files fro
2220: 6d 20 74 68 65 20 61 72 63 68 69 76 65 2e 0a 41  m the archive..A
2230: 20 73 65 70 61 72 61 74 65 20 22 73 71 6c 61 72   separate "sqlar
2240: 66 73 22 20 70 72 6f 67 72 61 6d 20 69 73 20 61  fs" program is a
2250: 62 6c 65 20 74 6f 20 6d 6f 75 6e 74 20 74 68 65  ble to mount the
2260: 20 53 51 4c 69 74 65 20 41 72 63 68 69 76 65 20   SQLite Archive 
2270: 61 73 0a 61 20 5b 68 74 74 70 73 3a 2f 2f 67 69  as.a [https://gi
2280: 74 68 75 62 2e 63 6f 6d 2f 6c 69 62 66 75 73 65  thub.com/libfuse
2290: 2f 6c 69 62 66 75 73 65 7c 46 75 73 65 20 46 69  /libfuse|Fuse Fi
22a0: 6c 65 73 79 73 74 65 6d 5d 2e 0a 0a 3c 68 31 3e  lesystem]...<h1>
22b0: 4d 61 6e 61 67 69 6e 67 20 53 51 4c 69 74 65 20  Managing SQLite 
22c0: 41 72 63 68 69 76 65 73 20 46 72 6f 6d 20 41 70  Archives From Ap
22d0: 70 6c 69 63 61 74 69 6f 6e 20 43 6f 64 65 3c 2f  plication Code</
22e0: 68 31 3e 0a 0a 3c 70 3e 0a 41 70 70 6c 69 63 61  h1>..<p>.Applica
22f0: 74 69 6f 6e 73 20 63 61 6e 20 65 61 73 69 6c 79  tions can easily
2300: 20 72 65 61 64 20 6f 72 20 77 72 69 74 65 20 53   read or write S
2310: 51 4c 69 74 65 20 41 72 63 68 69 76 65 73 20 62  QLite Archives b
2320: 79 20 6c 69 6e 6b 69 6e 67 20 61 67 61 69 6e 73  y linking agains
2330: 74 0a 53 51 4c 69 74 65 20 61 6e 64 20 69 6e 63  t.SQLite and inc
2340: 6c 75 64 69 6e 67 20 74 68 65 20 0a 5b 68 74 74  luding the .[htt
2350: 70 73 3a 2f 2f 73 71 6c 69 74 65 2e 6f 72 67 2f  ps://sqlite.org/
2360: 73 72 63 2f 66 69 6c 65 2f 65 78 74 2f 6d 69 73  src/file/ext/mis
2370: 63 2f 73 71 6c 61 72 2e 63 7c 65 78 74 2f 6d 69  c/sqlar.c|ext/mi
2380: 73 63 2f 73 71 6c 61 72 2e 63 5d 20 65 78 74 65  sc/sqlar.c] exte
2390: 6e 73 69 6f 6e 0a 74 6f 20 68 61 6e 64 6c 65 20  nsion.to handle 
23a0: 74 68 65 20 63 6f 6d 70 72 65 73 73 69 6f 6e 20  the compression 
23b0: 61 6e 64 20 64 65 63 6f 6d 70 72 65 73 73 69 6f  and decompressio
23c0: 6e 2e 20 20 54 68 65 20 73 71 6c 61 72 2e 63 20  n.  The sqlar.c 
23d0: 65 78 74 65 6e 73 69 6f 6e 0a 63 72 65 61 74 65  extension.create
23e0: 73 20 74 77 6f 20 6e 65 77 20 53 51 4c 20 66 75  s two new SQL fu
23f0: 6e 63 74 69 6f 6e 73 2e 0a 0a 3c 64 6c 3e 0a 3c  nctions...<dl>.<
2400: 64 74 3e 3c 62 3e 73 71 6c 61 72 5f 63 6f 6d 70  dt><b>sqlar_comp
2410: 72 65 73 73 28 58 29 3c 2f 62 3e 3c 2f 64 74 3e  ress(X)</b></dt>
2420: 0a 3c 64 64 3e 3c 70 3e 0a 54 68 65 20 73 71 6c  .<dd><p>.The sql
2430: 61 72 5f 63 6f 6d 70 72 65 73 73 28 58 29 20 66  ar_compress(X) f
2440: 75 6e 63 74 69 6f 6e 20 61 74 74 65 6d 70 74 73  unction attempts
2450: 20 74 6f 20 63 6f 6d 70 72 65 73 73 20 61 20 63   to compress a c
2460: 6f 70 79 20 6f 66 20 74 68 65 0a 73 74 72 69 6e  opy of the.strin
2470: 67 20 6f 72 20 62 6c 6f 62 20 58 20 75 73 69 6e  g or blob X usin
2480: 67 20 74 68 65 20 5b 68 74 74 70 73 3a 2f 2f 7a  g the [https://z
2490: 6c 69 62 2e 6e 65 74 2f 7c 44 65 66 61 75 6c 74  lib.net/|Default
24a0: 5d 20 61 6c 67 6f 72 69 74 68 6d 20 61 6e 64 0a  ] algorithm and.
24b0: 72 65 74 75 72 6e 73 20 74 68 65 20 72 65 73 75  returns the resu
24c0: 6c 74 20 61 73 20 61 20 62 6c 6f 62 2e 20 20 49  lt as a blob.  I
24d0: 66 20 74 68 65 20 69 6e 70 75 74 20 58 20 69 73  f the input X is
24e0: 20 69 6e 63 6f 6d 70 72 65 73 73 69 62 6c 65 2c   incompressible,
24f0: 20 74 68 65 6e 0a 61 20 63 6f 70 79 20 6f 66 20   then.a copy of 
2500: 58 20 69 73 20 72 65 74 75 72 6e 65 64 2e 20 20  X is returned.  
2510: 54 68 69 73 20 72 6f 75 74 69 6e 65 20 69 73 20  This routine is 
2520: 75 73 65 64 20 77 68 65 6e 20 69 6e 73 65 72 74  used when insert
2530: 69 6e 67 20 63 6f 6e 74 65 6e 74 0a 69 6e 74 6f  ing content.into
2540: 20 61 6e 20 53 51 4c 69 74 65 20 41 72 63 68 69   an SQLite Archi
2550: 76 65 2e 0a 3c 64 74 3e 3c 62 3e 73 71 6c 61 72  ve..<dt><b>sqlar
2560: 5f 75 6e 63 6f 6d 70 72 65 73 73 28 59 2c 53 5a  _uncompress(Y,SZ
2570: 29 3c 2f 62 3e 3c 2f 64 74 3e 0a 3c 64 64 3e 3c  )</b></dt>.<dd><
2580: 70 3e 0a 54 68 65 20 73 71 6c 61 72 5f 75 6e 63  p>.The sqlar_unc
2590: 6f 6d 70 72 65 73 73 28 59 2c 53 5a 29 20 66 75  ompress(Y,SZ) fu
25a0: 6e 63 74 69 6f 6e 20 77 69 6c 6c 20 75 6e 64 6f  nction will undo
25b0: 20 74 68 65 20 63 6f 6d 70 72 65 73 73 69 6f 6e   the compression
25c0: 20 61 63 63 6f 6d 70 6c 69 73 68 65 64 0a 62 79   accomplished.by
25d0: 20 73 71 6c 61 72 5f 63 6f 6d 70 72 65 73 73 28   sqlar_compress(
25e0: 58 29 2e 20 20 54 68 65 20 59 20 70 61 72 61 6d  X).  The Y param
25f0: 65 74 65 72 20 69 73 20 74 68 65 20 63 6f 6d 70  eter is the comp
2600: 72 65 73 73 65 64 20 63 6f 6e 74 65 6e 74 20 28  ressed content (
2610: 74 68 65 20 6f 75 74 70 75 74 0a 66 72 6f 6d 20  the output.from 
2620: 61 20 70 72 69 6f 72 20 63 61 6c 6c 20 74 6f 20  a prior call to 
2630: 73 71 6c 61 72 5f 63 6f 6d 70 72 65 73 73 28 29  sqlar_compress()
2640: 29 20 61 6e 64 20 53 5a 20 69 73 20 74 68 65 20  ) and SZ is the 
2650: 6f 72 69 67 69 6e 61 6c 20 75 6e 63 6f 6d 70 72  original uncompr
2660: 65 73 73 65 64 0a 73 69 7a 65 20 6f 66 20 74 68  essed.size of th
2670: 65 20 69 6e 70 75 74 20 58 20 74 68 61 74 20 67  e input X that g
2680: 65 6e 65 72 61 74 65 64 20 59 2e 20 20 49 66 20  enerated Y.  If 
2690: 53 5a 20 69 73 20 6c 65 73 73 20 74 68 61 6e 20  SZ is less than 
26a0: 6f 72 20 65 71 75 61 6c 20 74 6f 20 74 68 65 0a  or equal to the.
26b0: 73 69 7a 65 20 6f 66 20 59 2c 20 74 68 61 74 20  size of Y, that 
26c0: 69 6e 64 69 63 61 74 65 73 20 74 68 61 74 20 6e  indicates that n
26d0: 6f 20 63 6f 6d 70 72 65 73 73 69 6f 6e 20 6f 63  o compression oc
26e0: 63 75 72 72 65 64 2c 20 61 6e 64 20 73 6f 0a 73  curred, and so.s
26f0: 71 6c 61 72 5f 75 6e 63 6f 6d 70 72 65 73 73 28  qlar_uncompress(
2700: 59 2c 53 5a 29 20 72 65 74 75 72 6e 73 20 61 20  Y,SZ) returns a 
2710: 63 6f 70 79 20 6f 66 20 59 2e 20 20 4f 74 68 65  copy of Y.  Othe
2720: 72 77 69 73 65 2c 20 73 71 6c 61 72 5f 75 6e 63  rwise, sqlar_unc
2730: 6f 6d 70 72 65 73 73 28 59 2c 53 5a 29 0a 72 75  ompress(Y,SZ).ru
2740: 6e 73 20 74 68 65 20 49 6e 66 6c 61 74 65 20 61  ns the Inflate a
2750: 6c 67 6f 72 69 74 68 6d 20 6f 6e 20 59 20 74 6f  lgorithm on Y to
2760: 20 75 6e 63 6f 6d 70 72 65 73 73 20 69 74 20 61   uncompress it a
2770: 6e 64 20 72 65 73 74 6f 72 65 20 69 74 20 74 6f  nd restore it to
2780: 20 69 74 73 0a 6f 72 69 67 69 6e 61 6c 20 66 6f   its.original fo
2790: 72 6d 20 61 6e 64 20 72 65 74 75 72 6e 73 20 74  rm and returns t
27a0: 68 65 20 75 6e 63 6f 6d 70 72 65 73 73 65 64 20  he uncompressed 
27b0: 63 6f 6e 74 65 6e 74 2e 0a 54 68 69 73 20 72 6f  content..This ro
27c0: 75 74 69 6e 65 20 69 73 20 75 73 65 64 20 77 68  utine is used wh
27d0: 65 6e 20 65 78 74 72 61 63 74 69 6e 67 20 63 6f  en extracting co
27e0: 6e 74 65 6e 74 20 66 72 6f 6d 20 61 6e 20 53 51  ntent from an SQ
27f0: 4c 69 74 65 20 41 72 63 68 69 76 65 2e 0a 3c 2f  Lite Archive..</
2800: 64 6c 3e 0a 0a 3c 70 3e 0a 55 73 69 6e 67 20 74  dl>..<p>.Using t
2810: 68 65 20 74 77 6f 20 72 6f 75 74 69 6e 65 73 20  he two routines 
2820: 61 62 6f 76 65 2c 20 69 74 20 69 73 20 73 69 6d  above, it is sim
2830: 70 6c 65 20 66 6f 72 20 61 70 70 6c 69 63 61 74  ple for applicat
2840: 69 6f 6e 73 20 74 6f 20 69 6e 73 65 72 74 0a 6e  ions to insert.n
2850: 65 77 20 72 65 63 6f 72 64 73 20 69 6e 74 6f 20  ew records into 
2860: 6f 72 20 65 78 74 72 61 63 74 20 65 78 69 73 74  or extract exist
2870: 69 6e 67 20 72 65 63 6f 72 64 73 20 66 72 6f 6d  ing records from
2880: 20 61 6e 20 53 51 4c 69 74 65 20 41 72 63 68 69   an SQLite Archi
2890: 76 65 2e 0a 49 6e 73 65 72 74 20 61 20 6e 65 77  ve..Insert a new
28a0: 20 69 6e 74 6f 20 61 6e 20 53 51 4c 69 74 65 20   into an SQLite 
28b0: 41 72 63 68 69 76 65 20 75 73 69 6e 67 20 63 6f  Archive using co
28c0: 64 65 20 6c 69 6b 65 20 74 68 69 73 3a 0a 0a 3c  de like this:..<
28d0: 63 6f 64 65 62 6c 6f 63 6b 3e 0a 49 4e 53 45 52  codeblock>.INSER
28e0: 54 20 49 4e 54 4f 20 73 71 6c 61 72 28 6e 61 6d  T INTO sqlar(nam
28f0: 65 2c 6d 6f 64 65 2c 6d 74 69 6d 65 2c 73 7a 2c  e,mode,mtime,sz,
2900: 64 61 74 61 29 0a 20 56 41 4c 55 45 53 20 28 24  data). VALUES ($
2910: 6e 61 6d 65 2c 24 6d 6f 64 65 2c 73 74 72 66 74  name,$mode,strft
2920: 69 6d 65 28 27 25 73 27 2c 24 6d 74 69 6d 65 29  ime('%s',$mtime)
2930: 2c 0a 20 20 20 20 20 20 20 20 20 6c 65 6e 67 74  ,.         lengt
2940: 68 28 24 63 6f 6e 74 65 6e 74 29 2c 73 71 6c 61  h($content),sqla
2950: 72 5f 63 6f 6d 70 72 65 73 73 28 24 63 6f 6e 74  r_compress($cont
2960: 65 6e 74 29 29 3b 0a 3c 2f 63 6f 64 65 62 6c 6f  ent));.</codeblo
2970: 63 6b 3e 0a 0a 3c 70 3e 0a 45 78 74 72 61 63 74  ck>..<p>.Extract
2980: 20 61 6e 20 65 6e 74 72 79 20 66 72 6f 6d 20 74   an entry from t
2990: 68 65 20 53 51 4c 69 74 65 20 41 72 63 68 69 76  he SQLite Archiv
29a0: 65 20 75 73 69 6e 67 20 63 6f 64 65 20 6c 69 6b  e using code lik
29b0: 65 20 74 68 69 73 3a 0a 0a 3c 63 6f 64 65 62 6c  e this:..<codebl
29c0: 6f 63 6b 3e 0a 53 45 4c 45 43 54 20 6e 61 6d 65  ock>.SELECT name
29d0: 2c 20 6d 6f 64 65 2c 20 64 61 74 65 74 69 6d 65  , mode, datetime
29e0: 28 6d 74 69 6d 65 2c 27 75 6e 69 78 65 70 6f 63  (mtime,'unixepoc
29f0: 68 27 29 2c 20 73 71 6c 61 72 5f 75 6e 63 6f 6d  h'), sqlar_uncom
2a00: 70 72 65 73 73 28 64 61 74 61 2c 73 7a 29 0a 20  press(data,sz). 
2a10: 20 46 52 4f 4d 20 73 71 6c 61 72 0a 20 57 48 45   FROM sqlar. WHE
2a20: 52 45 20 2e 2e 2e 3b 0a 3c 2f 63 6f 64 65 62 6c  RE ...;.</codebl
2a30: 6f 63 6b 3e 0a 0a 3c 70 3e 0a 54 68 65 20 63 6f  ock>..<p>.The co
2a40: 64 65 20 61 62 6f 76 65 20 69 73 20 66 6f 72 20  de above is for 
2a50: 74 68 65 20 67 65 6e 65 72 61 6c 20 63 61 73 65  the general case
2a60: 2e 20 20 46 6f 72 20 74 68 65 20 73 70 65 63 69  .  For the speci
2a70: 61 6c 20 63 61 73 65 20 6f 66 20 61 6e 0a 53 51  al case of an.SQ
2a80: 4c 69 74 65 20 41 72 63 68 69 76 65 20 74 68 61  Lite Archive tha
2a90: 74 20 6f 6e 6c 79 20 73 74 6f 72 65 73 20 75 6e  t only stores un
2aa0: 63 6f 6d 70 72 65 73 73 65 64 20 6f 72 20 75 6e  compressed or un
2ab0: 63 6f 6d 70 72 65 73 73 69 62 6c 65 20 63 6f 6e  compressible con
2ac0: 74 65 6e 74 0a 28 74 68 69 73 20 6d 69 67 68 74  tent.(this might
2ad0: 20 63 6f 6d 65 20 75 70 2c 20 66 6f 72 20 65 78   come up, for ex
2ae0: 61 6d 70 6c 65 2c 20 69 6e 20 61 6e 20 53 51 4c  ample, in an SQL
2af0: 69 74 65 20 41 72 63 68 69 76 65 20 74 68 61 74  ite Archive that
2b00: 20 73 74 6f 72 65 73 20 6f 6e 6c 79 0a 4a 50 45   stores only.JPE
2b10: 47 2c 20 47 49 46 2c 20 61 6e 64 2f 6f 72 20 50  G, GIF, and/or P
2b20: 4e 47 20 69 6d 61 67 65 73 29 20 74 68 65 6e 20  NG images) then 
2b30: 74 68 65 20 63 6f 6e 74 65 6e 74 20 63 61 6e 20  the content can 
2b40: 62 65 20 69 6e 73 65 72 74 65 64 20 69 6e 74 6f  be inserted into
2b50: 0a 61 6e 64 20 65 78 74 72 61 63 74 65 64 20 66  .and extracted f
2b60: 72 6f 6d 20 74 68 65 20 64 61 74 61 62 61 73 65  rom the database
2b70: 20 77 69 74 68 6f 75 74 20 75 73 69 6e 67 20 74   without using t
2b80: 68 65 20 73 71 6c 61 72 5f 63 6f 6d 70 72 65 73  he sqlar_compres
2b90: 73 28 29 0a 61 6e 64 20 73 71 6c 61 72 5f 75 6e  s().and sqlar_un
2ba0: 63 6f 6d 70 72 65 73 73 28 29 20 66 75 6e 63 74  compress() funct
2bb0: 69 6f 6e 73 2c 20 61 6e 64 20 74 68 65 20 73 71  ions, and the sq
2bc0: 6c 61 72 2e 63 20 65 78 74 65 6e 73 69 6f 6e 20  lar.c extension 
2bd0: 69 73 20 6e 6f 74 0a 72 65 71 75 69 72 65 64 2e  is not.required.
2be0: 0a                                               .